> ## Documentation Index
> Fetch the complete documentation index at: https://gotrebol.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Items de documentos — KYB México
> Documentos cargables en verificaciones KYB de México: descripciones, campos extraídos y estructura de respuesta.
Este documento describe los items de tipo **documento** aplicables a verificaciones KYB en México. Para cada item se incluye su descripción y estructura de respuesta.
Para consultas públicas (SIGER, SAT, CURP), consulta [Items de consultas públicas — KYB México](/docs/guia-devs/uso-kyb/mexico/items-consultas-publicas).
Para documentos generales (comprobantes de domicilio, estados de cuenta, identificaciones personales) y otros items que aplican en múltiples países, consulta [Tipos de documentos y consultas](/docs/guia-devs/tipos-item) y [Respuestas por tipo de ítem](/docs/guia-devs/respuestas-por-tipo-de-item).
## Tabla resumen
Estos ítems son soportados por Trébol para el proceso de onboarding de empresas y validación de documentos en México. En el proceso de onboarding, se recomienda crear cada item con el tipo `generic` para que Trébol clasifique el documento al tipo específico correspondiente.
| Ítem | Descripción |
| ------------------------------------------------ | --------------------------------------------------------------------------------------- |
| `aa_mx` | Actas de asamblea. |
| `fme_mx` | Folio mercantil electrónico del Registro Público de la Propiedad y de Comercio (RPPyC). |
| `csf_mx` | Constancia de situación fiscal. |
| `pw_mx` | Poder notarial. |
| `ac_mx` | Acta constitutiva. |
| `designacion_responsable_cumplimiento_extractor` | Designación de responsable de cumplimiento. |
| `issste_unified_record` | Expediente electrónico único del ISSSTE. |
| `tax_payment_compliance` | Opinión de cumplimiento. |
***
## `ac_mx` — Acta constitutiva
```json theme={"dark"}
{
"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](/docs/guia-devs/uso-kyb/mexico/firmantes)
### Resumen de cambios identificados (`assembly_minute`)
El campo `item_value.assembly_minute` contiene el análisis estructurado de los cambios identificados en el acta. Está disponible en los ítems `ac_mx`, `aa_mx` y `pw_mx`.
Cada acta agrupa sus cambios en seis bloques de eventos. Dentro de cada bloque:
* Los **subeventos** son banderas con valor `1` cuando el evento ocurrió en el acta y `0` cuando no se identificó.
* El campo `explicacion` contiene un resumen en lenguaje natural, generado por IA, sobre lo identificado en ese bloque para esa acta.
Para construir un resumen del acta (por ejemplo, dentro de un dictamen legal), recorre los seis bloques y reporta únicamente los subeventos con valor `1`, acompañándolos del `explicacion` correspondiente.
Cambios en los estatutos de la empresa: denominación social, tipo societario, duración, domicilio y objeto social.
**Subeventos** (`1` = ocurrió, `0` = no se identificó):
* `denominacion_social`
* `tipo_sociedad`
* `duracion`
* `domicilio`
* `objeto_social`
El bloque anidado `estatutos` repite estas mismas banderas para tener mayor granularidad sobre lo que cambió específicamente en el apartado de estatutos.
`explicacion` resume los estatutos identificados en el acta.
Indica si se encontraron las personas que se solicitaron buscar como firmantes con nombres específicos.
**Campos:**
* `firmantes`: lista de firmantes coincidentes.
* `explicacion`: detalle del análisis de coincidencias.
Cambios identificados sobre el cuerpo de apoderados (adiciones, remociones y modificaciones de poderes).
**Subeventos** (`1` = ocurrió, `0` = no se identificó):
* `nombramiento_apoderados`
* `remocion_apoderados`
* `renovacion_apoderados`
* `modificacion_apoderados`
`explicacion` describe los apoderados y los poderes otorgados o modificados.
Cambios en el órgano de vigilancia (por ejemplo, designación o remoción del comisario).
**Subeventos** (`1` = ocurrió, `0` = no se identificó):
* `modificacion`
`explicacion` describe el cambio identificado en el órgano de vigilancia.
Eventos relacionados con los accionistas y el capital social.
**Subeventos** (`1` = ocurrió, `0` = no se identificó):
* `lista_asistencia`
* `modificacion_capital`
* `compra_venta_acciones`
`explicacion` describe a los accionistas mencionados y los movimientos de capital identificados.
Cambios en el órgano de administración (por ejemplo, consejo de administración o administrador único).
**Subeventos** (`1` = ocurrió, `0` = no se identificó):
* `adicion`
* `remocion`
* `cambio_tipo_organo`
* `renovacion_reeleccion`
`explicacion` describe el cambio identificado en el órgano de administración.
**Cómo armar un resumen tipo dictamen legal:** lee la verificación con [`GET /verifications/{verification-id}`](https://docs.gotrebol.com/api-reference/leer-información-de-la-empresa/obtener-una-verificación-por-su-id) y, para cada ítem `ac_mx`, `aa_mx` o `pw_mx`, recorre `item_value.assembly_minute` reportando los subeventos con valor `1` junto al `explicacion` de cada bloque.
## `aa_mx` — Acta de 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
```json theme={"dark"}
{
"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": "..."
}
}
```
## `designacion_responsable_cumplimiento_extractor`
```json theme={"dark"}
{
"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`
```json theme={"dark"}
{
"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"
}
]
}
}
}
```