Respuestas por tipo de ítem
Este documento describe la estructura de respuesta del API para cadaitem_type. Úsalo para validar contratos y mapear las respuestas.
- Ver listado de tipos: Tipos de Ítems
- Cómo leer las respuestas: Leer información vía API
- Estados y flujos: Estados de verificación
Estructura base de un ítem en las respuestas
A nivel superior, todos los ítems comparten la misma estructura.Copy
Ask AI
{
"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": "...",
"advanced_siger": false,
"is_optional": false
},
"original_file_url": "https://..."
}
Nota:item_typees el código del ítem (por ejemplo,ac_mx,csf_mx,siger,ubos). El campoitem_valueusasnake_casey su estructura depende delitem_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
Copy
Ask AI
{
"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
}
}
}
}
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
Copy
Ask AI
{
"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": "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)
Copy
Ask AI
{
"item_type": "person_id",
"item_value": {
"names": "María Guadalupe",
"id_number": "1234567890123456",
"id_type": "ine_mx|passport|residence_mx",
"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_id|invalid_id|failed|error|missing_parameters|maximum_retries_reached|missing_validation_parameters",
"ine_validation_message": "ID succesfully validated.|A problem occured trying to validate the INE information"
}
}
proof_address — Comprobante de domicilio
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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 registrobaja_por_defuncion: Persona fallecidaotro: Otros estadosno_encontrado: CURP no encontrado
curp_validation_result - Resultado de la validación:curp_found: CURP encontrado y válidocurp_not_found: CURP no encontrado
curp_validation_status - Estado de la validación:valid: Validación exitosainvalid: Validación fallida
siger — SIGER (México)
Copy
Ask AI
{
"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)
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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)
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"item_type": "forms",
"item_value": {
"account_id": "acc_123456789",
"form_schema": {},
"ui_schema": {},
"form_values": {},
"aux": {}
}
}
Integraciones
aml_validation
Copy
Ask AI
{
"item_type": "aml_validation",
"item_value": {
"validation_provider": "compliance_check",
"validation_data": [
/* AMLItemValidationData[] */
]
}
}
signatory_validation
Copy
Ask AI
{
"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:
Copy
Ask AI
{
"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.
type):
property_deedlien_certificateproperty_tax_receiptpayroll_receiptcamara_comercio_co_extractortrust_contract_fideicomiso_extractorunion_documents_extractordesignacion_responsable_cumplimiento_extractorregistro_actividades_vulnerables_extractorirs_ein_assignment_letter_extractorcertificate_of_incumbency_extractorcertificate_of_incorporation_extractorfincen_msb_registration_extractor
- La estructura exacta de
payloaddepende deltypey se define en los esquemas del AI Prompter (archivoai-prompter/src/utils/json_schemas.py). - La respuesta pública expone
payloadya “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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"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
Copy
Ask AI
{
"type": "payroll_receipt",
"payload": {
"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"
},
"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
}
}