Skip to main content

​
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_error": "password_protected_pdf|get_input_file_info_failed",
  "item_value": {
    /* según el item_type */
  },
  "item_options": {
    "upload_url": "https://...",
    "item_type_guide": "...",
    "item_label": "...",
    "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.
item_error: Campo opcional que indica errores públicos relacionados con el procesamiento del ítem. Valores permitidos:
  • password_protected_pdf: El PDF subido está protegido con contraseña y no puede ser procesado.
  • get_input_file_info_failed: Falló la obtención de información del archivo de entrada.

​
Í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: 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": "-1(si es indefinido)|99(años)",
    "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",
        "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": [
          {
            "id": "uuid",
            "role_name": "administrador unico|comisario|presidente|secretario|tesorero|vocal",
            "group_name": "executives|auditors|board_members|proxies",
            "event": "addition|removal|renewal|mentioned",
            "duration": 99,
            "necessary_match": false,
            "powers": [
              {
                "power_name": "administration|lawsuits_and_collections|assets_management|loans|bank_accounts|delegate",
                "duration": 99,
                "has_power": true,
                "signature_type": "individual|joint",
                "has_limits": false,
                "limits_description": "..."
              }
            ]
          }
        ]
      }
    ],
    "business_city_address": "...",
    "assembly_minute": {
      "eventos_empresa": {
        "duracion": 0,
        "domicilio": 0,
        "estatutos": {
          "duracion": 0,
          "domicilio": 0,
          "explicacion": "...",
          "objeto_social": 0,
          "tipo_sociedad": 0
          "denominacion_social": 0
        },
        "explicacion": "...",
        "objeto_social": 0,
        "tipo_sociedad": 0,
        "parrafos_duracion": [],
        "parrafos_domicilio": [],
        "denominacion_social": 0
      },
      "eventos_firmantes": {
        "firmantes": [],
        "explicacion": "..."
      },
      "eventos_vigilancia": {
        "explicacion": "...",
        "modificacion": 0
      },
      "eventos_accionistas": {
        "explicacion": "...",
        "lista_asistencia": 0,
        "modificacion_capital": 0,
        "compra_venta_acciones": 0
      },
      "eventos_administracion": {
        "adicion": 0,
        "remocion": 0,
        "explicacion": "...",
        "cambio_tipo_organo": 0,
        "renovacion_reeleccion": 0
      },
      "eventos_apoderados": {
        "explicacion": "...",
        "nombramiento_apoderados": 0,
        "remocion_apoderados": 0,
        "renovacion_apoderados": 0,
        "modificacion_apoderados": 0
      }
    }
  }
}
Información detallada sobre roles y firmantes:Para obtener información más detallada sobre la estructura de roles, poderes y firmantes, consulta la guía completa: Extraer Apoderados de Actas y Poderes

​
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": "contacto@empresa.com",
        "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": "ACTIVO|INACTIVO|SUSPENDIDO|FAILED|INVALID_QR|INVALID_URL_FORMAT|null",
    "qr_validation_status": "processing|completed|null",
    "qr_validation_message": "Validation Succesfull.|Page returned invalid.|Page returned invalid format.|null",
    "qr_url": "..."
  }
}

​
person_id — Identificación oficial (persona)

  • ine_mx: Identificación oficial mexicana (INE).
  • passport: Pasaporte (documento oficial de viaje).
  • residence_mx: Tarjeta/documento de residencia en México (para no mexicanos).
  • cc: Cédula de ciudadanía colombiana.
{
  "item_type": "person_id",
  "item_value": {
    "names": "María Guadalupe",
    "id_number": "1234567890123456",
    "id_type": "ine_mx|passport|residence_mx|cc",
    "issued_date": "2020-01-01",
    "birth_city": "Guadalajara, Jalisco",
    "nationality": "mexicana", 
    "birth_country": "México",
    "place_of_issue": "Ciudad de México"|null,
    "due_date": "2030-01-01"|null,
    "sex": "female"|"male"|null,
    "home_address": "Av. Insurgentes Sur 1234, Col. Del Valle, CDMX"| null,
    "numero_id_nacional": "LOFM900115MDFXRN08"|null,
    "curp": "LOFM900115MDFXRN08"|null,
    "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"
      }
    }|null,
    "ine_validation_result": "valid_id|invalid_id|failed|error|missing_parameters|maximum_retries_reached|missing_validation_parameters"|null,
    "ine_validation_message": "ID succesfully validated.|A problem occured trying to validate the INE information|null"
  }
}
Los keys due_date, place_of_issue, sex, numero_id_nacional y curp pueden ser null porque son campos opcionales y su presencia depende del tipo de person_id y de si el documento los incluye explícitamente (por ejemplo, curp solo aplica para documentos mexicanos; place_of_issue aplica para la cédula de ciudadanía colombiana).
Validación del INE
Para un item de tipo person_id, si su tipo es ine_mx, se realiza una validación del INE. Los datos de esta validación se encuentran dentro de item_value bajo la clave ine_validation_data. El estado de este proceso se puede identificar mediante dos claves: ine_validation_result y ine_validation_message. Estructura de ine_validation_data: El objeto ine_validation_data.data contiene la siguiente información extraída del INE:
  • cic (string): Clave de Identificación Ciudadana (CIC).
  • numero_ocr (string): Número OCR del documento.
  • ano_de_emision (string): Año de emisión del documento.
  • distrito_local (string): Distrito local electoral.
  • ano_de_registro (string): Año de registro del documento.
  • expiration_date (string): Fecha de expiración del documento.
  • clave_de_elector (string): Clave de elector.
  • distrito_federal (string): Distrito federal electoral.
  • numero_de_emision (string): Número de emisión del documento.
  • fecha_de_actualizacion_de_la_informacion (string): Fecha de actualización de la información.
Valores de ine_validation_result:
  • valid_id: Indica que la validación del INE fue exitosa.
  • invalid_id: Indica que el INE es inválido.
  • failed: Indica que la validación falló, lo cual puede ser temporal o debido a datos incorrectos.
  • error: Indica que ocurrió una excepción durante el proceso de validación.
  • missing_parameters: Indica que faltan parámetros específicos requeridos para la validación.
  • maximum_retries_reached: Indica que se alcanzó el número máximo de reintentos para la validación.
  • missing_validation_parameters: Indica que el item no puede ser validado debido a la configuración (por ejemplo, no es un INE).
Valores de ine_validation_message:
  • ID succesfully validated: Indica que la identificación fue validada exitosamente.
  • A problem occured trying to validate the INE information: Indica que ocurrió un problema durante el intento de validar la información del INE.
La validación del INE solo se realiza cuando el id_type del item person_id es ine_mx. Para otros tipos de identificación (como passport, residence_mx o cc), estos campos vendrán en null.
Ejemplo de salida para cédula de ciudadanía colombiana
{
  "item_type": "person_id",
  "item_value": {
    "names": "Laura Fernanda Gómez Pérez",
    "id_number": "1032456789",
    "id_type": "cc",
    "issued_date": "2018-07-28",
    "birth_city": "Medellín, Antioquia",
    "nationality": "colombiana",
    "birth_country": "Colombia",
    "place_of_issue": "Bogotá D.C.",
    "sex": "female",
    "due_date": null,
    "home_address": null,
    "numero_id_nacional": null,
    "curp": null,
    "ine_validation_data": null,
    "ine_validation_result": null,
    "ine_validation_message": null
  }
}
Ejemplo de salida para pasaporte
{
  "item_type": "person_id",
  "item_value": {
        "due_date": "2034-11-04T00:00:00Z",
        "id_number": "N71096495",
        "id_type": "passport",
        "issued_date": "2024-11-04T00:00:00Z",
        "names": "DANIEL GOMEZ HURTADO",
        "birth_city": "MIGUEL HIDALGO, DISTRITO FEDERAL",
        "nationality": "mexicana",
        "birth_country": "México",
        "place_of_issue": "",
        "sex": "male",
        "national_id_number": "GALD640615HDUPPA07",
        "curp": "GALD640615HDUPPA07",
        "home_address": null,
        "ine_validation_data": null,
        "ine_validation_result": "missing_validation_parameters",
        "ine_validation_message": null
    }
}

​
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": "energia_electrica|impuesto_predial|agua|telefono|gas_natural|contrato_de_arrendamiento|internet|cable|otros",
    "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": "valid"|"invalid",
    "curp_validation_message": "curp_found"|"curp_not_found"
  }
}
Información detallada sobre el tipo curp_item:curp_validation_data - Datos extraídos de la consulta CURP:
  • curp_status: Estado del CURP en el registro:
    • alta_normal: Persona activa en el registro
    • baja_por_defuncion: Persona fallecida
    • otro: Otros estados
    • no_encontrado: CURP no encontrado
curp_validation_result - Resultado de la validación:
  • curp_found: CURP encontrado y válido
  • curp_not_found: CURP no encontrado
curp_validation_status - Estado de la validación:
  • valid: Validación exitosa
  • invalid: Validación fallida

​
siger — SIGER (México)

{
  "item_type": "siger",
  "item_value": {
    "legal_name": "EMPRESA EJEMPLO, S.A. DE C.V.",
    "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": {}
            },
            "fme_assembly_minute_extractor": [
              {
                "event_group_name": "company_events",
                "explanation": "Se protocolizó la constitución de la sociedad.",
                "events": [
                  "constitucion_modificacion_denominacion_social",
                  "constitucion_modificacion_tipo_sociedad",
                  "constitucion_modificacion_duracion",
                  "constitucion_modificacion_domicilio",
                  "constitucion_modificacion_objeto_social"
                ]
              },
              {
                "event_group_name": "shareholders_events",
                "explanation": "Se estableció la estructura accionaria inicial.",
                "events": [
                  "nombramiento_accionistas",
                  "modificacion_capital"
                ]
              },
              {
                "event_group_name": "administration_events",
                "explanation": "Se designó el órgano de administración.",
                "events": [
                  "adicion_administracion",
                  "establecimiento_cambio_tipo_organo_administracion"
                ]
              }
            ]
          }
        ],
        "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"
      }
    ]
  }
}
Análisis automático de minutas (FME)
El campo fme_assembly_minute_extractor contiene el análisis automático mediante IA de los eventos relevantes identificados en cada acto. Este análisis intenta procesar todos los actos independientemente de la configuración de flags, pero tiene un límite de tiempo de 13 minutos por razones de seguridad y confiabilidad. Los actos se procesan en orden cronológico inverso (más recientes primero), asegurando que los documentos más relevantes se analicen primero. Estructura del campo: Cada acto incluye un array de grupos de eventos con la siguiente información:
  • event_group_name: Nombre del grupo de eventos (company_events, shareholders_events, administration_events, supervision_events, signatories_holders_events)
  • explanation: Descripción generada por IA sobre los eventos encontrados en el acto
  • events: Array de eventos identificados en el acto
Grupos de eventos analizados:
  1. company_events: Eventos relacionados con la empresa (nombre, tipo societario, duración, domicilio, objeto social)
  2. shareholders_events: Eventos de accionistas (adiciones, transferencias, modificaciones de capital)
  3. administration_events: Eventos de administración (cambios en órganos de administración)
  4. supervision_events: Eventos de vigilancia (cambios en órganos de vigilancia)
  5. signatories_holders_events: Eventos de firmantes (adiciones, remociones, modificaciones de poderes)
El análisis FME se almacena en el ítem SIGER para los actos procesados y está disponible para consulta incluso si no se crearon items de tipo acta automáticamente.
Límite de tiempo: El proceso de análisis FME tiene un límite de 13 minutos. Si hay muchos actos, algunos pueden no ser procesados. El sistema prioriza los actos más recientes para asegurar que los documentos más relevantes se analicen primero. Si se alcanza el límite, los datos procesados hasta ese momento se persisten.
Creación automática de items de tipo acta
Cuando el flag siger_data_extraction está activado, el sistema analiza los eventos extraídos y crea automáticamente items de tipo acta para aquellos actos que contienen eventos relevantes. Estos items aparecerán como items adicionales en la verificación con:
  • item_type: Puede ser ac_mx (acta constitutiva), aa_mx (acta de asamblea), o fme_mx (folio mercantil)
  • file_source_info: Contiene información sobre el acto de SIGER del que proviene el item
    • item_type: “siger”
    • item_id: ID del item SIGER fuente
Los items de tipo acta creados automáticamente desde SIGER pasan por el mismo flujo de extracción que los items subidos manualmente, por lo que incluirán toda la información extraída del documento (firmantes, accionistas, poderes, etc.).
Error en la consulta SIGER
Cuando el ítem siger tiene "item_internal_status": "siger_error", es porque se presentó algún error relacionado al mal funcionamiento de la página o comportamientos inesperados.
Si el item_internal_status es "siger_error", la consulta no pudo completarse debido a problemas técnicos con el portal SIGER. En estos casos, el item_value puede estar vacío o incompleto.

​
siger_shareholders — Empresas relacionadas por accionistas (México)

Este ítem permite buscar en SIGER empresas relacionadas a una lista de accionistas (personas físicas). Por cada accionista, retorna una lista de coincidencias. Puedes obtener este ítem de dos formas:
  • Creación manual (sin item siger): si ya tienes una lista de accionistas, puedes crear el ítem siger_shareholders directamente en el POST /verifications con options.shareholders.
  • Creación automática (desde item siger): si estás consultando una empresa en SIGER y quieres buscar los mismos accionistas detectados para esa empresa, no crees este ítem manualmente. En su lugar, envía el flag search_related_companies_siger: true en el ítem siger y el sistema creará siger_shareholders automáticamente.
Si usas el flujo automático (search_related_companies_siger: true en el ítem siger), no agregues siger_shareholders manualmente al payload.
Límite: Solo 1 accionista por ítem siger_shareholders.
{
  "item_type": "siger_shareholders",
  "item_value": {
    "shareholders": [
      {
        "name": "LUIS",
        "paternal_surname": "BUITRAGO",
        "maternal_surname": "LEON"
      }
    ],
    "data": [
      {
        "shareholder": {
          "name": "LUIS",
          "paternal_surname": "BUITRAGO",
          "maternal_surname": "LEON"
        },
        "related_companies": [
          {
            "name": "4321 TREBOL, SOCIEDAD ANÓNIMA DE CAPITAL VARIABLE",
            "fme": "N-2024038395"
          }
        ]
      }
    ],
    "scraped_at": "2026-02-26T20:23:24Z"
  }
}
Campos principales:
  • shareholders: Lista de accionistas de la empresa consultada
    • name: Nombre del accionista
    • paternal_surname: Apellido paterno
    • maternal_surname: Apellido materno
  • data: Detalle de empresas relacionadas por cada accionista
    • shareholder: Información del accionista
    • related_companies: Array de empresas donde participa el accionista
      • name: Nombre de la empresa relacionada
      • fme: Folio mercantil electrónico de la empresa
Si no hay coincidencias para un accionista, related_companies puede venir como un arreglo vacío.
  • scraped_at: Fecha y hora en que se realizó la consulta
Este ítem es útil para análisis de beneficiarios finales (UBOs) y para identificar estructuras corporativas relacionadas en procesos de due diligence.

​
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

​
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": "contacto@empresa-ejemplo.com.co",
    "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": "legal@empresa-ejemplo.com.co",
    "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": "legal@empresa-ejemplo.com.co",
    "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": "ana.lopez@email.com",
          "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": "firmante@empresa.com",
    "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": {
    "deed_type": "...",
    "deed_description": {
      "deed_number": 0,
      "deed_date": "YYYY-MM-DD",
      "notary_number": 0,
      "notary_city": "...",
      "notary_state": "...",
      "notary_name": "..."
    },
    "property_description": {
      "description": "...",
      "address": {
        "street": "...",
        "exterior_number": "...",
        "interior_number": "...",
        "neighborhood": "...",
        "city": "...",
        "state": "...",
        "country": "...",
        "surface_value": 0,
        "surface_unit": "..."
      },
      "linders": [{ "orientation": "...", "meters": 0, "colindancy": "..." } ]
    },
    "owners_description": {
      "explanation": "...",
      "owners": [
        {
          "name": "...",
          "curp": null,
          "rfc": "...",
          "birth_date": "YYYY-MM-DD",
          "nationality": "...",
          "birth_place": "...",
          "civil_status": "...",
          "occupation": "...",
          "domicile": "..."
        }
      ]
    },
    "parts_description": [
      {
        "role": "...",
        "name": "...",
        "curp": "...",
        "rfc": "...",
        "birth_date": "YYYY-MM-DD",
        "nationality": "...",
        "birth_place": "...",
        "civil_status": "...",
        "occupation": "...",
        "domicile": "..."
      }
    ],
    "estado_juridico": {
      "resumen": "...",
      "derechos_reales": [
        { "tipo_derecho": "posesion|uso_y_disfrute|administracion|exclusion|disposicion|usufructo|servidumbre|derecho_superficie|hipoteca", 
        "descripcion": "..." }
      ]
    }
  }
}
  • lien_certificate
{
  "type": "lien_certificate",
  "payload": {
    "property_description": {
      "address": {
        "street": "...",
        "exterior_number": "...",
        "interior_number": "...",
        "neighborhood": "...",
        "city": "...",
        "state": "...",
        "country": "...",
        "surface": 0,
        "surface_unit": "..."
      },
      "linders": [{ "orientation": "...", "meters": 0, "colindancy": "..." }]
    },
    "owners_description": [
      { "name": "...",
        "curp": "...", 
        "rfc": "..." }
      ],
    "lien_description": {
      "certificate_date": "YYYY-MM-DD",
      "certificate_issuer": "...",
      "has_lien": true|false,
      "lien_explanation": "..."
    }
  }
}
  • property_tax_receipt
{
  "type": "property_tax_receipt",
  "payload": {
    "property_description": {
      "street": "...",
      "exterior_number": "...",
      "interior_number": "...",
      "neighborhood": "...",
      "city": "...",
      "state": "...",
      "country": "...",
      "terrain_surface": 0,
      "construction_surface": 0,
      "cadastral_value": 0
    },
    "receipt_description": {
      "issue_date": "YYYY-MM-DD",
      "expiration_date": "YYYY-MM-DD",
      "payment_period": "YYYY-MM",
      "folio": "...",
      "subtotal": 0,
      "discount": 0,
      "total": 0,
      "payment_date": "YYYY-MM-DD"
    },
    "payer_description": {
      "name": "...",
      "curp": "...",
      "rfc": "...",
      "domicile": "..."
    }
  }
}
  • camara_comercio_co_extractor
{
  "type": "camara_comercio_co_extractor",
  "payload": {
    "analisis_detallado": [],
    "representantes_legales": [
      {
        "name": "...",
        "role": "...",
        "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": {
    "contract_number": "...",
    "trust_name": "...",
    "trust_type": "administracion|garantia|inversion|fuente_pago|administracion_fuente_pago|otro",
    "constitution_date": "YYYY-MM-DD",
    "signature_date": "YYYY-MM-DD",
    "duration": "...",
    "trust_purpose": "...",
    "jurisdiction": "...",
    "signature_place": "...",
    "involved_parties": [
      {
        "roles": ["fiduciario|fideicomitente|fideicomisario|fideicomisario_primer_lugar|fideicomisario_segundo_lugar|administrador_primario|administrador_maestro|garante|otro"],
        "legal_name": "...",
        "alias": "...",
        "rfc": "...",
        "entity_type": "persona_fisica|persona_moral|entidad_extranjera|institucion_financiera|gobierno|otro",
        "nationality": "...",
        "legal_representative": "...",
        "address": {
          "street_number": "...",
          "neighborhood": "...",
          "municipality": "...",
          "state": "...",
          "postal_code": "...",
          "country": "...",
          "full_address": "..."
        },
        "contact_data": {
          "phone": "...",
          "email": ["..."],
          "contact_name": "..."
        },
        "constitution_data": {
          "constitution_date": "...",
          "notary_city": "...",
          "notary_number": "...",
          "public_deed": "...",
          "commercial_folio": "..."
        }
      }
    ],
    "financial_structure": {
      "main_currency": "MXN|USD|EUR|CAD|GBP|JPY|otra",
      "initial_contribution": {
        "amount": 0,
        "currency": "MXN|USD|EUR|CAD|GBP|JPY|otra",
        "descripcion": "..."
      },
      "trust_assets": "...",
      "credit_structure": [
        { "class": "A", "amount": 0, "currency": "MXN|USD|EUR|CAD|GBP|JPY|otra", "descripcion": "..." }
      ],
      "total_potential_amount": { "amount": 0, "currency": "MXN|USD|EUR|CAD|GBP|JPY|otra" },
      "trustee_fees": [{ "amount": 0, "currency": "MXN|USD|EUR|CAD|GBP|JPY|otra" }]
    },
    "related_contracts": [
      { "nombre": "...", "annex": "...", "descripcion": "..." }
    ],
    "guarantees": ["..."],
    "risk_indicators": {
      "foreign_entities": [],
      "tax_havens": [],
      "risk_terms": [],
      "complex_structures": [],
      "conflicts_of_interest": []
    },
    "financial_flows": {
      "bank_accounts": [],
      "fund_flow": "...",
      "payment_waterfall": "..."
    },
    "validations": {
      "inconsistent_dates": [],
      "inconsistent_amounts": [],
      "missing_information": [],
      "red_flags": []
    }
  }
}
  • union_documents_extractor
{
  "type": "union_documents_extractor",
  "payload": {
    "general_summary": "...",
    "executive_summary": {
      "total_documents": 0,
      "complete_documents": 0,
      "incomplete_documents": 0
    },
    "general_information": {
      "denominacion_social": "...",
      "entity_type": "Organizacion sindical|Sindicato nacional|Sindicato empresarial|Sindicato gremial|Federacion sindical|Confederacion sindical|Otro",
      "constitution_date": "YYYY-MM-DD",
      "registration_date": "YYYY-MM-DD",
      "registration_number": "...",
      "duration": 0,
      "address": "...",
      "main_activity": "...",
      "sources": [
        {
          "source_description": "...",
          "document_id": 1,
          "page": 1,
          "paragraph": 1,
          "clause": "..."
        }
      ]
    },
    "documents": [
      {
        "document_id": 1,
        "document_name": "...",
        "document_type": "Resolución de registro|Solicitud de registro|Acta de constitución|Acta de asamblea|Estatutos sociales|Modificación de directiva|Certificación de copias|Padrón de socios|Otro",
        "summary": "...",
        "completeness_analysis": {
          "justification": "...",
          "total_pages": 0,
          "found_pages": 0,
          "status": "Completo|Incompleto"
        },
        "extracted_data": {
          "general_information": [
            {
              "field": "...",
              "value": "...",
              "source": {
                "source_description": "...",
                "document_id": 1,
                "page": 1,
                "paragraph": 1,
                "clause": "..."
              }
            }
          ],
          "relevant_appointments": [
            {
              "name": "...",
              "position": "Secretario General|Secretario de Organización|Secretario de Actas|Secretario del Interior|Secretario de Conflictos y Trabajo|Secretario Tesorero|Secretario de Prensa|Presidente|Vicepresidente|Tesorero|Vocal|Representante Legal|Apoderado|Otro",
              "identification_type": "RFC|CURP|NSS|Pasaporte|Cédula profesional|Otro",
              "identification_number": "...",
              "nationality": "...",
              "address": "...",
              "powers": "...",
              "position_validity": "...",
              "source": {}
            }
          ],
          "social_statutes": {
            "mentioned": true|false,
            "included": true|false,
            "summary": "...",
            "source": {}
          }
        }
      }
    ]
  }
}
  • designacion_responsable_cumplimiento_extractor
{
  "type": "designacion_responsable_cumplimiento_extractor",
  "payload": {
    "document_type": "DESIGNACIÓN DE RESPONSABLE DE CUMPLIMIENTO",
    "folio_number": null,
    "document_issue_date": "2021-07-27",
    "designated_individual": {
      "rfc": null,
      "curp": null,
      "first_name": "MARIA",
      "paternal_surname": "GARCIA",
      "maternal_surname": "LOPEZ",
      "full_name": "LIC. MARIA GARCIA LOPEZ",
      "date_of_birth_from_rfc_inference": null,
      "date_of_birth_on_document": null,
      "country_of_birth": null,
      "nationality": null,
      "contact_information": {
        "lada_code": null,
        "phone_number": null,
        "mobile_number": null,
        "email": null
      },
      "address": {
        "postal_code": null,
        "federal_entity": null,
        "municipality_delegation": null,
        "neighborhood": null,
        "locality": null,
        "street_type": null,
        "street_name": null,
        "other_references": null
      }
    },
    "designating_entity": {
      "rfc": null,
      "name": "TREBOL Servicios Petroleros S. A. de C. V.",
      "designation_status": "ACEPTADO",
      "status_date": "2021-07-27"
    },
    "red_flags": [
      "Información personal sensible faltante para los responsables designados: RFC, CURP, fecha de nacimiento, país de nacimiento, nacionalidad, información de contacto y domicilio.",
      "RFC de la entidad designante no presente en el documento."
    ],
    "others": {
      "designated_individual": [
        {
          "rfc": null,
          "curp": null,
          "first_name": "JUAN CARLOS",
          "paternal_surname": "RODRIGUEZ",
          "maternal_surname": "MORALES",
          "full_name": "LIC. JUAN CARLOS RODRIGUEZ MORALES",
          "date_of_birth_from_rfc_inference": null,
          "date_of_birth_on_document": null,
          "country_of_birth": null,
          "nationality": null,
          "contact_information": {
            "lada_code": null,
            "phone_number": null,
            "mobile_number": null,
            "email": null
          },
          "address": {
            "postal_code": null,
            "federal_entity": null,
            "municipality_delegation": null,
            "neighborhood": null,
            "locality": null,
            "street_type": null,
            "street_name": null,
            "other_references": null
          }
        }
      ]
    }
  }
}
  • 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": {
    "tipo_comprobante": "desprendible_pago|resolucion_pension|ninguno",
    "tipo_pension": "invalidez|vejez|sustitucion|otro",
    "informacion_emisor": { "nombre_emisor": "...", "id_emisor": "..." },
    "informacion_empleado": {
      "nombre_empleado": "...",
      "id_empleado": "...",
      "tipo_id": "cc_co|ce_co|nit_co|ti_co|pasaporte|rfc_mx|curp_mx|nss_mx|otro",
      "numero_afiliacion": "..."
    },
    "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
  }
}