Items de documentos — KYB México

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. 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 y Respuestas por tipo de ítem.

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

{
  "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

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.

eventos_empresa — Estatutos de la empresa

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.

eventos_firmantes — Coincidencias con firmantes solicitados

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.

eventos_apoderados — Cambios en apoderados

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.

eventos_vigilancia — Órgano de vigilancia

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_accionistas — Accionistas y capital

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.

eventos_administracion — Órgano de administración

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} 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

{
  "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`

{
  "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"
        }
      ]
    }
  }
}

Intro al API de Trébol

Guías por caso de uso

Items de documentos — KYB México

Tabla resumen

`ac_mx` — Acta constitutiva

Resumen de cambios identificados (`assembly_minute`)

`aa_mx` — Acta de asamblea

`fme_mx` — Folio mercantil electrónico

`pw_mx` — Poder notarial

`csf_mx` — Constancia de situación fiscal

`designacion_responsable_cumplimiento_extractor`

`registro_actividades_vulnerables_extractor`

​Tabla resumen

​ac_mx — Acta constitutiva

​Resumen de cambios identificados (assembly_minute)

​aa_mx — Acta de asamblea

​fme_mx — Folio mercantil electrónico

​pw_mx — Poder notarial

​csf_mx — Constancia de situación fiscal

​designacion_responsable_cumplimiento_extractor

​registro_actividades_vulnerables_extractor

Tabla resumen

`ac_mx` — Acta constitutiva

Resumen de cambios identificados (`assembly_minute`)

`aa_mx` — Acta de asamblea

`fme_mx` — Folio mercantil electrónico

`pw_mx` — Poder notarial

`csf_mx` — Constancia de situación fiscal

`designacion_responsable_cumplimiento_extractor`

`registro_actividades_vulnerables_extractor`