Respuestas por tipo de ítem

Este documento describe la estructura de respuesta del API para cada item_type. Úsalo para validar contratos y mapear las respuestas.

Estructura base de un ítem en las respuestas

A nivel superior, todos los ítems comparten la misma estructura.
{
  "id": 123,
  "item_order": 1,
  "item_status": "pending|needs-review|complete|error",
  "item_type": "<item_code>",
  "item_internal_status": "...",
  "item_value": {
    /* según el item_type */
  },
  "item_options": {
    "upload_url": "https://...",
    "item_type_guide": "...",
    "item_label": "...",
    "advanced_siger": false,
    "is_optional": false
  },
  "original_file_url": "https://..."
}
Nota: item_type es el código del ítem (por ejemplo, ac_mx, csf_mx, siger, ubos). El campo item_value usa snake_case y su estructura depende del item_type.

Índice rápido

  • Documentos México: ac_mx, aa_mx, fme_mx, pw_mx, csf_mx, person_id, proof_address, bank_statement, curp_item
  • Consultas México: siger, public_sat_signatures
  • Documentos Colombia: cc_co, sc_co, rut_co
  • Consultas Colombia: rues, public_rut_co, public_address_cc_co, cc_co_ops
  • Widgets: ubos, forms
  • Integraciones: aml_validation, signatory_validation
  • Otros: document, doc_classification, public_sat_signatures, unknown, generic, error

México

ac_mx — Acta constitutiva

{
  "item_type": "ac_mx",
  "item_value": {
    "acta_number": "...",
    "acta_date": "2024-01-01",
    "acta_city": "...",
    "acta_state": "...",
    "acta_type": "constitutiva|asamblea|fme|power|...",
    "notary_name": "...",
    "notary_number": "...",
    "business_name": "...",
    "business_name_event": "...",
    "business_type": "...",
    "business_type_event": "...",
    "business_tax_id": "...",
    "business_tax_id_event": "...",
    "business_duration": "...",
    "folio_date": "2024-01-01",
    "folio_number": "...",
    "folio_acta_number": "...",
    "folio_name": "...",
    "folio_inscription_date": "2024-01-01",
    "capital_fixed_value": 0,
    "capital_fixed_shares": 0,
    "capital_fixed_value_per_share": 0,
    "capital_fixed_value_currency": "MXN",
    "capital_variable_value": 0,
    "capital_variable_shares": 0,
    "capital_variable_value_per_share": 0,
    "capital_variable_value_currency": "MXN",
    "capital_total_value": 0,
    "capital_total_shares": 0,
    "capital_total_value_currency": "MXN",
    "shaholders_information_source": "...",
    "shareholders": [
      {
        "name": "...",
        "type": "business|person",
        "id_number": "...",
        "id_type": "rfc|passport|curp",
        "nationality": "...",
        "fixed_value": 0,
        "fixed_shares": 0,
        "variable_value": 0,
        "variable_shares": 0,
        "total_value": 0,
        "total_shares": 0,
        "currency": "MXN"
      }
    ],
    "signatories": [
      {
        "name": "...",
        "type": "business|person",
        "id_number": "...",
        "id_type": "rfc|passport|curp",
        "roles": {}
      }
    ],
    "business_city_address": "...",
    "beta_fields": {},
    "assembly_minute": {}
  }
}

aa_mx — Asamblea

Misma estructura pública que ac_mx.

fme_mx — Folio mercantil electrónico

Misma estructura pública que ac_mx.

pw_mx — Poder notarial

Misma estructura pública que ac_mx.

csf_mx — Constancia de situación fiscal

{
  "item_type": "csf_mx",
  "item_value": {
    "document_date": "2024-01-01",
    "constancia_type": "business|individual",
    "tax_id_number": "...",
    "company_legal_name": "...",
    "society_type": "...",
    "registration_date": "2020-01-01",
    "registration_status": "...",
    "economic_activities_description_1": "...",
    "business_activities": [
      {
        "order": 1,
        "economic_activity": "...",
        "percentage": "...",
        "date": "2024-01-01"
      }
    ],
    "fiscal_obligations": [
      {
        "obligation_description": "...",
        "terms_description": "...",
        "start_date": "2024-01-01",
        "end_date": "2024-12-31"
      }
    ],
    "post_code_fiscal_address": "...",
    "street_type_fiscal_address": "...",
    "street_name_fiscal_address": "...",
    "external_number_fiscal_address": "...",
    "internal_number_fiscal_address": "...",
    "neighborhood_fiscal_address": "...",
    "district_fiscal_address": "...",
    "city_fiscal_address": "...",
    "state_fiscal_address": "...",
    "email_fiscal": "...",
    "land_line_code_fiscal": "...",
    "land_line_fiscal": "...",
    "person_rfc": "...",
    "person_curp": "...",
    "person_name": "...",
    "person_last_name_1": "...",
    "person_last_name_2": "...",
    "regime": "...",
    "qr_validated_at": "2024-01-01T00:00:00Z",
    "qr_validation_data": {
      "data": {
        "rfc": "ABC123456789",
        "curp": "PERE800101HDFXXX01",
        "al": "Miguel Hidalgo",
        "cp": "11560",
        "colonia": "Polanco",
        "regimen": "General de Ley Personas Morales",
        "fecha_de_alta": "2020-01-15",
        "numero_exterior": "123",
        "numero_interior": "A",
        "tipo_de_vialidad": "Avenida",
        "correo_electronico": "[email protected]",
        "entidad_federativa": "Ciudad de México",
        "regimen_de_capital": "Sociedad Anónima",
        "fecha_de_constitucion": "2015-03-20",
        "nombre_de_la_vialidad": "Reforma",
        "municipio_o_delegacion": "Miguel Hidalgo",
        "denominacion_o_razon_social": "EMPRESA EJEMPLO, S.A. DE C.V.",
        "situacion_del_contribuyente": "Activo",
        "fecha_de_inicio_de_operaciones": "2015-04-01",
        "fecha_del_ultimo_cambio_de_situacion": "2023-06-15",
        "nombre": "Juan Carlos",
        "apellido_paterno": "Pérez",
        "apellido_materno": "García"
      }
    },
    "qr_validation_result": "...",
    "qr_validation_status": "...",
    "qr_validation_message": "..."
  }
}

person_id — Identificación oficial (persona)

{
  "item_type": "person_id",
  "item_value": {
    "names": "María Guadalupe",
    "id_number": "1234567890123456",
    "id_type": "ine_mx|passport",
    "issued_date": "2020-01-01",
    "due_date": "2030-01-01",
    "home_address": "Av. Insurgentes Sur 1234, Col. Del Valle, CDMX",
    "ine_validation_data": {
      "data": {
        "cic": "1234567890123456789",
        "numero_ocr": "123456789012345678",
        "ano_de_emision": "2020",
        "distrito_local": "Distrito 15",
        "ano_de_registro": "2020",
        "expiration_date": "2030-01-01",
        "clave_de_elector": "MARG80010115HDFXXX01",
        "distrito_federal": "Distrito Federal 15",
        "numero_de_emision": "123456",
        "fecha_de_actualizacion_de_la_informacion": "2020-01-01"
      }
    },
    "ine_validation_result": "valid",
    "ine_validation_message": "Documento válido"
  }
}

proof_address — Comprobante de domicilio

{
  "item_type": "proof_address",
  "item_value": {
    "provider": "CFE",
    "address": "Av. Reforma 456, Col. Juárez, CDMX",
    "entity_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
    "document_date": "2024-01-01",
    "service_type": "water|electricity|phone|internet|cable|gas|bank_statement|property_tax|lease_agreement|other",
    "type": "business|person",
    "mx_address": {
      "tipo_vialidad": "Avenida",
      "nombre_vialidad": "Reforma",
      "numero_exterior": "456",
      "numero_interior": "Piso 3",
      "tipo_asentamiento": "Colonia",
      "nombre_asentamiento": "Juárez",
      "codigo_postal": "06600",
      "localidad": "Cuauhtémoc",
      "municipio_o_ente_territorial": "Cuauhtémoc",
      "entidad_federativa": "Ciudad de México",
      "pais": "MX"
    }
  }
}

bank_statement — Estado de cuenta bancario

{
  "item_type": "bank_statement",
  "item_value": {
    "address": "Av. Insurgentes Sur 789, Col. Del Valle, CDMX",
    "entity_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
    "document_date": "2024-01-01",
    "type": "business|person",
    "banking_information": {
      "bank_name": "Banco de México",
      "bank_country": "MX",
      "clabe_number": "012180001234567890",
      "bank_account_number": "1234567890",
      "currency": "MXN",
      "rfc": "ABC123456789"
    }
  }
}

curp_item — Consulta/validación CURP

{
  "item_type": "curp_item",
  "item_value": {
    "curp": "XXXX######XXXXXX##",
    "curp_validated_at": "2024-01-01T00:00:00Z",
    "curp_validation_data": {
      "curp": "PERE800101HDFXXX01",
      "curp_status": "alta_normal"|"baja_por_defuncion"|"otro"|"no_encontrado",
      "names": "Juan Carlos",
      "gender": "H",
      "act_number": "123456",
      "birth_date": "1980-01-01",
      "birth_entity": "Hidalgo",
      "nationality": "Mexicana",
      "first_surname": "Pérez",
      "second_surname": "García",
      "register_entity": "Hidalgo",
      "evidentiary_document": "Acta de nacimiento",
      "register_municipality": "Pachuca",
      "curp_file": "https://curp.gob.mx/curp/consultaCurp.jsp"
    },
    "curp_validation_result": "curp_found"|"curp_not_found"
    "curp_validation_status": "curp_found"|"curp_not_found"
    "curp_validation_message": "valid"|"invalid"
  }
}

siger — SIGER (México)

{
  "item_type": "siger",
  "item_value": {
    "legal_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
    "filings": [
      {
        "pre_coded_forms": "Constitución de Sociedad Anónima",
        "act": "Acta constitutiva",
        "act_registration_date": "2024-01-01"
      }
    ],
    "documents": [
      {
        "legal_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
        "fme_number": "FME-2024-001234",
        "fme_status": "Activo",
        "acts": [
          {
            "pre_coded_form": "Constitución de Sociedad Anónima",
            "act": "Acta constitutiva",
            "nci": "NCI-2024-001234",
            "admission_date": "2024-01-01",
            "registration_date": "2024-01-02",
            "document_number": "DOC-2024-001234",
            "mode": "Electrónico",
            "document_url": "https://siger.gob.mx/documentos/acta-constitutiva.pdf",
            "act_details": {
              "acta_city": "Ciudad de México",
              "acta_date": "2024-01-01",
              "acta_state": "Ciudad de México",
              "acta_number": "ACTA-2024-001",
              "notary_number": "123",
              "notary_name": "Lic. María González",
              "business_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
              "business_type": "Sociedad Anónima",
              "business_address": "Av. Reforma 123, Col. Juárez, CDMX",
              "business_address_state": "Ciudad de México",
              "business_address_city": "Cuauhtémoc",
              "business_duration": "99 años",
              "assembly_details": {
                "type": "Asamblea Constitutiva",
                "date": "2024-01-01",
                "general_type": "Ordinaria"
              },
              "assembly_agreement": "Constitución de sociedad anónima",
              "modifications": {}
            }
          }
        ],
        "business_purpose": "Comercio y servicios",
        "business_type": "Sociedad Anónima",
        "business_duration": "99 años",
        "federal_entity": "Ciudad de México",
        "office": "Oficina Central",
        "tax_id_number": "ABC123456789",
        "registration_date": "2024-01-01",
        "city": "Cuauhtémoc",
        "nationality": "Mexicana",
        "address": "Av. Reforma 123, Col. Juárez, CDMX",
        "shareholders": [
          {
            "name": "Juan Pérez García",
            "shares": 1000,
            "total": 1000,
            "value": 1000000
          }
        ],
        "scrapedAt": "2024-01-01T00:00:00Z"
      }
    ]
  }
}

public_sat_signatures — SAT firmas/certificados (México)

{
  "item_type": "public_sat_signatures",
  "item_value": {
    "tax_ids": ["RFC1", "RFC2"],
    "data": {
      "RFC1": {
        /* certificado SAT serializado */
      },
      "RFC2": {
        /* certificado SAT serializado */
      }
    }
  }
}

Colombia

cc_co — Certificado Cámara de Comercio

{
  "item_type": "cc_co",
  "item_value": {
    "nit": "900123456-7"
  }
}

sc_co — Composición accionaria

{
  "item_type": "sc_co",
  "item_value": {
    "business_name": "EMPRESA EJEMPLO COLOMBIA S.A.S.",
    "document_date": "2024-01-01",
    "business_tax_id": "900123456-7",
    "shareholder_people_check": "Completado",
    "shareholders": [
      {
        "name": "Carlos Andrés Rodríguez López",
        "id_type": "CC|CEDULA",
        "id_number": "12345678",
        "percent_ownership": 50
      }
    ],
    "signatories": [
      {
        "name": "Carlos Andrés Rodríguez López",
        "id_type": "CC|CEDULA",
        "id_number": "12345678",
        "role": "Representante Legal"
      }
    ],
    "documents": [
      {
        "label": "Certificado de Cámara de Comercio",
        "url": "https://www.rues.org.co/certificado.pdf"
      }
    ]
  }
}

rut_co — Registro Único Tributario

{
  "item_type": "rut_co",
  "item_value": {
    "nit": "900123456",
    "verification_digit": "7",
    "business_name": "EMPRESA EJEMPLO COLOMBIA S.A.S.",
    "country": "Colombia",
    "department": "Cundinamarca",
    "city": "Bogotá",
    "main_address": "Calle 123 # 45-67, Oficina 901",
    "email_address": "[email protected]",
    "phone_1": "+57 1 2345678",
    "phone_2": "+57 300 1234567",
    "constitution_date": "2020-01-01",
    "registration_date": "2020-01-02",
    "merchant_number": "123456789",
    "activities": [
      { "code": "6201", "description": "Programación de computadoras" }
    ],
    "representatives": [
      {
        "type": "Representante Legal",
        "start_date": "2020-01-01",
        "id_type": "CC",
        "id_number": "12345678",
        "names": "Carlos Andrés Rodríguez López"
      }
    ],
    "responsibilities": [{ "code": 12, "name": "Responsable de IVA" }]
  }
}

rues — Consulta RUES

{
  "item_type": "rues",
  "item_value": {
    "tax_id_number": "900123456-7",
    "tax_id_verification_code": "7",
    "legal_name": "EMPRESA EJEMPLO COLOMBIA S.A.S.",
    "address": "Calle 123 # 45-67, Oficina 901, Bogotá, Cundinamarca",
    "country_registration": "Colombia",
    "state_registration": "Cundinamarca",
    "city_registration": "Bogotá",
    "registration_category": "Sociedad por Acciones Simplificada",
    "registration_status": "Activo",
    "registration_city_chamber": "Cámara de Comercio de Bogotá",
    "registration_id": "CCB-2020-001234",
    "renewal_date": "2024-01-01",
    "registration_date": "2020-01-01",
    "registry_end_date": "2025-01-01",
    "last_update_date": "2024-06-01",
    "cancellation_date": null,
    "cancellation_motive": null,
    "society_type": "Sociedad por Acciones Simplificada",
    "organization_type": "Empresa",
    "business_activities": {},
    "signatory_powers": "Representante Legal",
    "signatories": {},
    "request_id": "RUES-2024-001234",
    "status": "Activo"
  }
}

public_rut_co — RUT fuente pública

{
  "item_type": "public_rut_co",
  "item_value": {
    "nit": "900123456",
    "verification_digit": "7",
    "business_name": "EMPRESA EJEMPLO COLOMBIA S.A.S.",
    "date": "2024-01-01",
    "status": "Activo",
    "message": "RUT válido y activo",
    "rut_validation_result": "valid"
  }
}

public_address_cc_co — Dirección pública Cámara de Comercio

{
  "item_type": "public_address_cc_co",
  "item_value": {
    "legal_name": "EMPRESA EJEMPLO COLOMBIA S.A.S.",
    "organization_type": "Sociedad por Acciones Simplificada",
    "legal_email": "[email protected]",
    "phone": "+57 1 2345678",
    "business_address": {
      "address": "Calle 123 # 45-67, Oficina 901",
      "city": "Bogotá",
      "state": "Cundinamarca",
      "country": "Colombia"
    },
    "request_id": "CC-2024-001234",
    "tax_id_number": "900123456-7"
  }
}

cc_co_ops — Certificado CC (ops)

{
  "item_type": "cc_co_ops",
  "item_value": {
    "tax_id_number": "900123456-7",
    "expedition_date": "2024-01-01",
    "legal_name": "EMPRESA EJEMPLO COLOMBIA S.A.S.",
    "organization_type": "Sociedad por Acciones Simplificada",
    "department": "Cundinamarca",
    "municipality": "Bogotá",
    "legal_email": "[email protected]",
    "phone": "+57 1 2345678",
    "corporate_purpose": "Desarrollo de software y servicios tecnológicos",
    "legal_address": {},
    "business_address": {},
    "equity": {},
    "board_members": {},
    "tax_auditors": {},
    "document_metadata": {},
    "extracted_data": {}
  }
}

Widgets

ubos — Beneficiarios finales

{
  "item_type": "ubos",
  "item_value": {
    "ubos": {
      "data": [
        {
          "currency": "MXN",
          "id_number": "12345678",
          "id_type": "INE",
          "name": "Ana María López Rodríguez",
          "email": "[email protected]",
          "type": "Accionista",
          "share_percentage": 25,
          "documents": [
            { "key": "documento-identidad.pdf", "bucket": "trebol-documents" }
          ],
          "upload_urls": [
            {
              "index": 0,
              "url": "https://s3.amazonaws.com/trebol-documents/documento-identidad.pdf"
            }
          ],
          "external_identities": {
            "curp": {
              "success": true,
              "message": "CURP validado exitosamente",
              "applicant_data": {
                "curp": "LORA800101MDFXXX01",
                "names": "Ana María",
                "gender": "M",
                "birth_date": "1980-01-01",
                "birth_entity": "Distrito Federal",
                "nationality": "Mexicana",
                "first_surname": "López",
                "second_surname": "Rodríguez",
                "evidentiary_document": "Acta de nacimiento"
              },
              "evidentiary_document_data": {
                "act_number": "123456",
                "registry_date": "1980-01-15",
                "register_entity": "Distrito Federal",
                "register_municipality": "Cuauhtémoc"
              },
              "curp_file": "https://curp.gob.mx/curp/consultaCurp.jsp"
            }
          },
          "shareholders": [
            /* estructura anidada de UBO */
          ],
          "aux": {}
        }
      ]
    }
  }
}

forms — Formularios de onboarding

{
  "item_type": "forms",
  "item_value": {
    "account_id": "acc_123456789",
    "form_schema": {},
    "ui_schema": {},
    "form_values": {},
    "aux": {}
  }
}

Integraciones

aml_validation

{
  "item_type": "aml_validation",
  "item_value": {
    "validation_provider": "compliance_check",
    "validation_data": [
      /* AMLItemValidationData[] */
    ]
  }
}

signatory_validation

{
  "item_type": "signatory_validation",
  "item_value": {
    "id_number": "1234567890123456",
    "id_type": "INE",
    "email": "[email protected]",
    "name": "Roberto Carlos Méndez Silva",
    "nationality": "Mexicana",
    "confirmation_date": "2024-01-01T00:00:00Z",
    "confirmation_ip_address": "192.168.1.100",
    "confirmation_check_boxes": {
      "data": [{ "text": "Acepto los términos y condiciones", "checked": true }]
    },
    "validation_date": "2024-01-01T00:00:00Z",
    "validation_result": "valid",
    "validation_name": "Roberto Carlos Méndez Silva",
    "validation_data": {
      "ocr": {
        "name": {
          "full_name": "Roberto Carlos Méndez Silva",
          "paternal_last_name": "Méndez",
          "maternal_last_name": "Silva"
        },
        "document_number": "1234567890123456"
      },
      "scores": { "overall": { "status": "passed", "value": 95 } }
    },
    "name_comparison_result": true
  }
}

Otros

document — Extractor de documentos (genérico)

Este ítem agrupa distintos extractores de documentos bajo un mismo item_type. La forma de la respuesta es:
{
  "item_type": "document",
  "item_value": {
    "type": "<document_type>",
    "payload": {
      /* estructura depende de <document_type> */
    }
  }
}
  • “type”: uno de los tipos soportados.
  • “payload”: objeto JSON con los datos extraídos. La estructura varía por tipo y corresponde a los esquemas JSON del AI Prompter.
Tipos soportados (type):
  • property_deed
  • lien_certificate
  • property_tax_receipt
  • payroll_receipt
  • camara_comercio_co_extractor
  • trust_contract_fideicomiso_extractor
  • union_documents_extractor
  • designacion_responsable_cumplimiento_extractor
  • registro_actividades_vulnerables_extractor
  • irs_ein_assignment_letter_extractor
  • certificate_of_incumbency_extractor
  • certificate_of_incorporation_extractor
  • fincen_msb_registration_extractor
Notas:
  • La estructura exacta de payload depende del type y se define en los esquemas del AI Prompter (archivo ai-prompter/src/utils/json_schemas.py).
  • La respuesta pública expone payload ya “normalizado” como JSON plano según el esquema correspondiente.
Estructuras por type
A continuación se documenta el payload esperado por cada type. Los ejemplos son esqueletos de referencia y pueden contener campos opcionales.
  • property_deed
{
  "type": "property_deed",
  "payload": {
    "tipo_escritura": "...",
    "escritura": {
      "numero_escritura": 0,
      "fecha_escritura": "YYYY-MM-DD",
      "numero_notaria": 0,
      "ciudad_notaria": "...",
      "estado_notaria": "...",
      "nombre_notario": "..."
    },
    "descripcion_propiedad": {
      "descripcion": "...",
      "direccion": {
        "calle": "...",
        "numero_exterior": "...",
        "numero_interior": "...",
        "colonia": "...",
        "municipio": "...",
        "estado": "...",
        "pais": "...",
        "valor_superficie": 0,
        "unidad_superficie": "m2|..."
      },
      "linderos": [{ "orientacion": "...", "metros": 0, "colindancia": "..." }]
    },
    "info_propietarios": {
      "explicacion": "...",
      "propietarios": [
        {
          "nombre": "...",
          "curp": "...",
          "rfc": "...",
          "fecha_nacimiento": "YYYY-MM-DD",
          "nacionalidad": "...",
          "lugar_nacimiento": "...",
          "estado_civil": "...",
          "ocupacion": "...",
          "domicilio": "..."
        }
      ]
    },
    "info_partes": [
      {
        "rol": "...",
        "nombre": "...",
        "curp": "...",
        "rfc": "...",
        "fecha_nacimiento": "YYYY-MM-DD",
        "nacionalidad": "...",
        "lugar_nacimiento": "...",
        "estado_civil": "...",
        "ocupacion": "...",
        "domicilio": "..."
      }
    ],
    "estado_juridico": {
      "resumen": "...",
      "derechos_reales": [
        { "tipo_derecho": "posesion|...", "descripcion": "..." }
      ]
    }
  }
}
  • lien_certificate
{
  "type": "lien_certificate",
  "payload": {
    "descripcion_propiedad": {
      "direccion": {
        "calle": "...",
        "numero_exterior": "...",
        "numero_interior": "...",
        "colonia": "...",
        "municipio": "...",
        "estado": "...",
        "pais": "...",
        "superficie": 0,
        "unidad_superficie": "m2|..."
      },
      "linderos": [{ "orientacion": "...", "metros": 0, "colindancia": "..." }]
    },
    "info_propietarios": [{ "nombre": "...", "curp": "...", "rfc": "..." }],
    "descripcion_gravamen": {
      "fecha_certificado": "YYYY-MM-DD",
      "emisor_certificado": "...",
      "tiene_gravamen": true,
      "explicacion_gravamen": "..."
    }
  }
}
  • property_tax_receipt
{
  "type": "property_tax_receipt",
  "payload": {
    "descripcion_propiedad": {
      "calle": "...",
      "numero_exterior": "...",
      "numero_interior": "...",
      "colonia": "...",
      "municipio": "...",
      "estado": "...",
      "pais": "...",
      "superficie_terreno": 0,
      "superficie_construccion": 0,
      "valor_catastral": 0
    },
    "descripcion_recibo": {
      "fecha_emision": "YYYY-MM-DD",
      "fecha_vencimiento": "YYYY-MM-DD",
      "periodo_pago": "YYYY-MM",
      "folio": "...",
      "subtotal": 0,
      "descuento": 0,
      "total": 0,
      "fecha_pago": "YYYY-MM-DD"
    },
    "descripcion_pagador": {
      "nombre": "...",
      "curp": "...",
      "rfc": "...",
      "domicilio": "..."
    }
  }
}
  • camara_comercio_co_extractor
{
  "type": "camara_comercio_co_extractor",
  "payload": {
    "analisis_detallado": [],
    "representantes_legales": [
      {
        "nombre": "...",
        "rol": "...",
        "identificacion": {
          "tipo": "cc_co|ce_co|nit_co|ti_co|pasaporte|otro",
          "numero": "..."
        },
        "limitaciones": []
      }
    ],
    "limitaciones_empresa": [],
    "facultades_empresa": {
      "obtener_creditos": { "tiene_poder": true, "limitaciones": [] },
      "dar_activos_en_garantia": { "tiene_poder": null, "limitaciones": [] },
      "obligarse_solidariamente": { "tiene_poder": false, "limitaciones": [] }
    }
  }
}
  • trust_contract_fideicomiso_extractor
{
  "type": "trust_contract_fideicomiso_extractor",
  "payload": {
    "numero_contrato": "...",
    "nombre_fideicomiso": "...",
    "tipo_fideicomiso": "administracion|garantia|inversion|fuente_pago|administracion_fuente_pago|otro",
    "fecha_constitucion": "YYYY-MM-DD",
    "fecha_firma": "YYYY-MM-DD",
    "vigencia": "...",
    "objeto_fideicomiso": "...",
    "jurisdiccion": "...",
    "lugar_firma": "...",
    "partes_involucradas": [
      {
        "roles": ["fiduciario|fideicomitente|fideicomisario|..."],
        "nombre_legal": "...",
        "alias": "...",
        "rfc": "...",
        "tipo_entidad": "...",
        "nacionalidad": "...",
        "representante_legal": "...",
        "domicilio": {
          "calle_numero": "...",
          "colonia": "...",
          "municipio": "...",
          "estado": "...",
          "codigo_postal": "...",
          "pais": "...",
          "domicilio_completo": "..."
        },
        "datos_contacto": {
          "telefono": "...",
          "email": ["..."],
          "nombre_contacto": "..."
        },
        "datos_constitucion": {
          "fecha_constitucion": "...",
          "notario": "...",
          "numero_notaria": "...",
          "escritura_publica": "...",
          "folio_mercantil": "..."
        }
      }
    ],
    "estructura_financiera": {
      "moneda_principal": "MXN|USD|...",
      "aportacion_inicial": {
        "monto": 0,
        "moneda": "MXN",
        "descripcion": "..."
      },
      "patrimonio_fideicomitido": "...",
      "estructura_creditos": [
        { "clase": "A", "monto": 0, "moneda": "MXN", "descripcion": "..." }
      ],
      "monto_total_potencial": { "monto": 0, "moneda": "MXN" },
      "honorarios_fiduciario": [{ "monto": 0, "moneda": "MXN" }]
    },
    "contratos_anexos": [
      { "nombre": "...", "anexo": "...", "descripcion": "..." }
    ],
    "garantias": ["..."],
    "indicadores_riesgo": {
      "entidades_extranjeras": [],
      "paraisos_fiscales": [],
      "terminos_riesgo": [],
      "estructuras_complejas": [],
      "conflictos_interes": []
    },
    "flujos_financieros": {
      "cuentas_bancarias": [],
      "flujo_fondos": "...",
      "waterfall_pagos": "..."
    },
    "validaciones": {
      "fechas_inconsistentes": [],
      "montos_inconsistentes": [],
      "informacion_faltante": [],
      "banderas_rojas": []
    }
  }
}
  • union_documents_extractor
{
  "type": "union_documents_extractor",
  "payload": {
    "resumen_general": "...",
    "resumen_ejecutivo": {
      "total_documentos": 0,
      "documentos_completos": 0,
      "documentos_incompletos": 0
    },
    "informacion_general": {
      "denominacion_social": "...",
      "tipo_entidad": "...",
      "fecha_constitucion": "YYYY-MM-DD",
      "fecha_registro": "YYYY-MM-DD",
      "numero_registro": "...",
      "duracion": 0,
      "domicilio": "...",
      "actividad_principal": "...",
      "fuentes": [
        {
          "descripcion_fuente": "...",
          "documento_id": 1,
          "pagina": 1,
          "parrafo": 1,
          "clausula": "..."
        }
      ]
    },
    "documentos": [
      {
        "id_documento": 1,
        "nombre_documento": "...",
        "tipo_documento": "...",
        "resumen": "...",
        "analisis_completitud": {
          "justificacion": "...",
          "paginas_totales": 0,
          "paginas_encontradas": 0,
          "estado": "Completo|Incompleto"
        },
        "datos_extraidos": {
          "informacion_general": [
            {
              "campo": "...",
              "valor": "...",
              "fuente": {
                "descripcion_fuente": "...",
                "documento_id": 1,
                "pagina": 1,
                "parrafo": 1,
                "clausula": "..."
              }
            }
          ],
          "nombramientos_relevantes": [
            {
              "nombre": "...",
              "cargo": "...",
              "tipo_identificacion": "...",
              "numero_identificacion": "...",
              "nacionalidad": "...",
              "domicilio": "...",
              "facultades": "...",
              "vigencia_cargo": "...",
              "fuente": {}
            }
          ],
          "estatutos_sociales": {
            "mencionados": true,
            "incluidos": false,
            "resumen": "...",
            "fuente": {}
          }
        }
      }
    ]
  }
}
  • designacion_responsable_cumplimiento_extractor
{
  "type": "designacion_responsable_cumplimiento_extractor",
  "payload": {
    "document_type": "...",
    "folio_number": "...",
    "document_issue_date": "YYYY-MM-DD",
    "designated_individual": {
      "rfc": "...",
      "curp": "...",
      "first_name": "...",
      "paternal_surname": "...",
      "maternal_surname": "...",
      "full_name": "...",
      "date_of_birth_from_rfc_inference": "YYYY-MM-DD",
      "date_of_birth_on_document": "YYYY-MM-DD",
      "country_of_birth": "...",
      "nationality": "...",
      "contact_information": {
        "lada_code": "...",
        "phone_number": "...",
        "mobile_number": "...",
        "email": "..."
      },
      "address": {
        "postal_code": "...",
        "federal_entity": "...",
        "municipality_delegation": "...",
        "colonia": "...",
        "locality": "...",
        "street_type": "...",
        "street_name": "...",
        "other_references": "..."
      }
    },
    "designating_entity": {
      "rfc": "...",
      "name": "...",
      "designation_status": "...",
      "status_date": "YYYY-MM-DD"
    },
    "red_flags": ["..."]
  }
}
  • registro_actividades_vulnerables_extractor
{
  "type": "registro_actividades_vulnerables_extractor",
  "payload": {
    "document_type": "...",
    "folio_number": "...",
    "document_date": "YYYY-MM-DD",
    "extracted_information": {
      "entity_details": {
        "legal_name": "...",
        "rfc": "...",
        "incorporation_date": "YYYY-MM-DD",
        "country_of_incorporation": "...",
        "nationality_of_entity": "..."
      },
      "contact_information": [
        {
          "area_code": "...",
          "phone_number": "...",
          "mobile_number": "...",
          "email": "..."
        }
      ],
      "vulnerable_activity_details": [
        {
          "activity_code": "...",
          "activity_description": "...",
          "first_operation_date": "YYYY-MM-DD"
        }
      ],
      "reporting_details": [
        {
          "reporting_type": "...",
          "reporting_deadline": "...",
          "legal_basis_for_reporting": "...",
          "registration_date_for_activity": "YYYY-MM-DD"
        }
      ]
    }
  }
}
  • irs_ein_assignment_letter_extractor
{
  "type": "irs_ein_assignment_letter_extractor",
  "payload": {
    "document_type": "...",
    "issuing_authority": {
      "name": "...",
      "department": "...",
      "country": "..."
    },
    "notice_date": "YYYY-MM-DD",
    "entity_details": {
      "legal_name": "...",
      "employer_identification_number_ein": "...",
      "irs_address": {
        "address": "...",
        "street": "...",
        "city": "...",
        "state_province": "...",
        "zip_code": "...",
        "country": "..."
      },
      "name_control": "...",
      "associated_form": "..."
    }
  }
}
  • certificate_of_incumbency_extractor
{
  "type": "certificate_of_incumbency_extractor",
  "payload": {
    "document_type": "...",
    "issuing_entity": "...",
    "certificate_date": "YYYY-MM-DD",
    "corporation_details": {
      "legal_name": "...",
      "registered_office_address": {
        "street": "...",
        "city": "...",
        "state": "...",
        "zip_code": "...",
        "country": "..."
      },
      "incorporation_state": "...",
      "incorporation_date": "YYYY-MM-DD",
      "file_number": "...",
      "legal_standing": "...",
      "authorized_shares": { "maximum": 0, "par_value": 0, "currency": "..." }
    },
    "current_directors": [
      { "name": "...", "appointment_date": "YYYY-MM-DD", "title": "..." }
    ],
    "current_shareholders": [
      {
        "name": "...",
        "shares_held": 0,
        "percentage_ownership": 0,
        "entity_type": "..."
      }
    ],
    "authorized_signatory": {
      "signature_present": true,
      "signatory_name": "...",
      "signatory_title": "...",
      "printed_name_below_signature": "..."
    },
    "language_versions": ["en", "es"]
  }
}
  • certificate_of_incorporation_extractor
{
  "type": "certificate_of_incorporation_extractor",
  "payload": {
    "document_type": "...",
    "issuing_authority": {
      "name": "...",
      "state": "...",
      "country": "...",
      "certifying_officer": "..."
    },
    "entity_details": {
      "legal_name": "...",
      "incorporation_date": "YYYY-MM-DD",
      "file_number": "...",
      "internal_reference_sr": "...",
      "business_purpose": "...",
      "authorized_stock": {
        "total_shares": 0,
        "share_class": "...",
        "par_value_per_share": 0,
        "currency": "..."
      }
    },
    "registered_agent": {
      "name": "...",
      "address": {
        "street": "...",
        "city": "...",
        "county": "...",
        "state": "...",
        "zip_code": "...",
        "country": "..."
      }
    },
    "incorporator": {
      "name": "...",
      "organization": "...",
      "address": {
        "street": "...",
        "city": "...",
        "county": "...",
        "state": "...",
        "zip_code": "...",
        "country": "..."
      },
      "signature_date": "YYYY-MM-DD"
    },
    "certification_details": {
      "authentication_number": "...",
      "certification_date": "YYYY-MM-DD"
    },
    "language_versions": ["en", "es"]
  }
}
  • fincen_msb_registration_extractor
{
  "type": "fincen_msb_registration_extractor",
  "payload": {
    "document_type": "...",
    "issuing_authority": {
      "name": "...",
      "department": "...",
      "country": "..."
    },
    "transcript_date": "YYYY-MM-DD",
    "registration_details": {
      "msb_registration_number": "...",
      "registration_type": "...",
      "legal_name": "...",
      "dba_name": "...",
      "address": {
        "street": "...",
        "city": "...",
        "state": "...",
        "zip_code": "...",
        "country": "..."
      },
      "msb_activities": ["..."],
      "states_of_msb_activities": ["..."],
      "number_of_branches": 0,
      "authorized_signature_date": "YYYY-MM-DD",
      "received_date": "YYYY-MM-DD"
    }
  }
}
  • payroll_receipt
{
  "type": "payroll_receipt",
  "payload": {
    "informacion_emisor": { "nombre_emisor": "...", "id_emisor": "..." },
    "informacion_empleado": {
      "nombre_empleado": "...",
      "id_empleado": "...",
      "tipo_id": "cc_co|rfc_mx|..."
    },
    "informacion_pago": {
      "fecha_emision": "YYYY-MM-DD",
      "periodo": "YYYY-MM",
      "periodo_inicio": "YYYY-MM-DD",
      "periodo_fin": "YYYY-MM-DD",
      "periodicidad": "quincenal|mensual|semanal|otro",
      "moneda": "COP|MXN|USD|EUR|otro"
    },
    "ingresos": {
      "detalle_recurrentes": [{ "concepto": "...", "valor": 0 }],
      "detalle_no_recurrentes": [{ "concepto": "...", "valor": 0 }],
      "total_ingresos": 0
    },
    "creditos": {
      "detalle_creditos": [
        { "entidad": "...", "valor": 0, "cuotas_totales": 0 }
      ]
    },
    "embargos": {
      "detalle_embargos": [
        { "tipo_embargo": "alimentos|civil|fiscal|financiero|otro", "valor": 0 }
      ]
    },
    "descuentos": {
      "salud": 0,
      "pension": 0,
      "retencion_fuente": 0,
      "otros_descuentos": [{ "concepto": "...", "valor": 0 }]
    },
    "ingreso_neto_reportado": 0
  }
}