Documentos IA — API Reference

Copiar{
  "Fecha escritura": "2023-11-15",
  "Número escritura": "5021",
  "actos": [
    {
      "tipo_de_acto": "LIQUIDACION DE LA COMUNIDAD",
      "resumen": {
        "pagina": "3",
        "texto": "Se procede a liquidar la comunidad entre..."
      },
      "cuantias": [
        { "pagina": 1, "valor": "500000000" }
      ],
      "intervinientes": {
        "otorgantes": [
          {
            "nivel": 1,
            "nombre": "JUAN PÉREZ GARCÍA",
            "numero_identificacion": "79123456",
            "pagina": "[1, 5, 8]"
          }
        ],
        "beneficiarios": []
      }
    }
  ],
  "matriculas": [
    {
      "numero": "370-123456",
      "pagina": "[1, 9, 10, 11, 15]"
    }
  ],
  "_metadata": {
    "account": "Notaría Central",
    "quota_used": 51,
    "quota_total": 100,
    "pages_total": 15,
    "pages_scanned": 5,
    "llm_usage": {
      "prompt_tokens": 2500,
      "completion_tokens": 1200,
      "total_tokens": 3700
    },
    "estimated_cost_usd": 0.000891,
    "ocr_time_s": 2.5,
    "extraction_time_s": 3.1,
    "total_time_s": 5.6
  }
}

Copiar[
  {
    "key": "nombre_del_campo",
    "description": "Descripción de qué buscar en el documento y dónde"
  }
]

Regla principal: mientras más específica sea la description (mencionando la etiqueta exacta del documento), más precisa es la extracción.

Copiar[
  { "key": "numero_cedula",    "description": "Numero de cedula de ciudadania, retornar solo digitos sin puntos" },
  { "key": "nombre_completo",  "description": "Nombres del titular sin apellidos, buscar cerca de la etiqueta NOMBRES" },
  { "key": "apellidos",        "description": "Apellidos del titular, buscar cerca de la etiqueta APELLIDOS. El OCR puede fragmentar el texto, combina las lineas" },
  { "key": "fecha_nacimiento", "description": "Fecha de nacimiento en formato DD/MM/AAAA" },
  { "key": "lugar_nacimiento", "description": "Municipio exacto de nacimiento, no el departamento" },
  { "key": "fecha_expedicion", "description": "Fecha de expedicion del documento" },
  { "key": "lugar_expedicion", "description": "Municipio donde fue expedida la cedula" },
  { "key": "sexo",             "description": "Sexo del titular: M o F. Buscar cerca de la etiqueta SEXO o en el codigo MRZ del reverso" },
  { "key": "grupo_sanguineo",  "description": "Grupo sanguineo con RH del titular, ej: O+ A- B+ AB+. Buscar en reverso o inicio del codigo MRZ" }
]

Copiar[
  { "key": "numero_escritura",   "description": "Numero de escritura publica, solo digitos" },
  { "key": "notaria",            "description": "Numero y ciudad de la notaria donde se otorgo" },
  { "key": "fecha_otorgamiento", "description": "Fecha en que fue otorgada la escritura" },
  { "key": "acto_juridico",      "description": "Tipo de acto: compraventa, hipoteca, donacion, etc." },
  { "key": "vendedor",           "description": "Nombre completo del vendedor o enajenante" },
  { "key": "comprador",          "description": "Nombre completo del comprador o adquirente" },
  { "key": "matricula",          "description": "Numero de matricula inmobiliaria del inmueble" },
  { "key": "valor_venta",        "description": "Valor o precio de venta en pesos colombianos" }
]

Copiar[
  { "key": "nit",                 "description": "NIT de la empresa, solo digitos sin guion ni digito de verificacion" },
  { "key": "razon_social",        "description": "Razon social o nombre de la empresa tal como aparece en el RUT" },
  { "key": "actividad_economica", "description": "Codigo CIIU y descripcion de la actividad economica principal" },
  { "key": "representante_legal", "description": "Nombre completo del representante legal" },
  { "key": "direccion",           "description": "Direccion principal del establecimiento o empresa" },
  { "key": "municipio",           "description": "Municipio o ciudad donde esta registrada la empresa" }
]

Copiar[
  { "key": "matricula",      "description": "Numero de matricula inmobiliaria" },
  { "key": "titular",        "description": "Nombre del propietario actual del predio" },
  { "key": "descripcion",    "description": "Descripcion del inmueble: tipo, area, direccion" },
  { "key": "municipio",      "description": "Municipio donde esta ubicado el inmueble" },
  { "key": "gravamenes",     "description": "Hipotecas, embargos, afectaciones o limitaciones vigentes" },
  { "key": "fecha_consulta", "description": "Fecha de expedicion del certificado" }
]

Copiar{
  "fields": {
    "numero_cedula":    "1144070039",
    "nombre_completo":  "ALVARO JOSE",
    "apellidos":        "TORRES BARANDICA",
    "fecha_nacimiento": "02/05/1994",
    "lugar_nacimiento": "CALI",
    "fecha_expedicion": "03/05/2012",
    "lugar_expedicion": "CALI",
    "sexo":             "M",
    "grupo_sanguineo":  "A-"
  },
  "_metadata": {
    "total_time_s":     5.2,
    "ocr_time_s":      4.1,
    "llm_time_s":      1.1,
    "pages_total":     2,
    "pages_scanned":   2,
    "llm_usage": {
      "prompt_tokens":     850,
      "completion_tokens": 110,
      "total_tokens":      960
    },
    "account":           "Mi Cuenta",
    "filename":          "cedula.pdf",
    "fields_requested":  ["numero_cedula", "nombre_completo", "..."]
  }
}