Extraer Apoderados de Actas y Poderes

API KYB: Verificación de Firmantes y Administradores

Este endpoint permite extraer información detallada de los firmantes y administradores de una empresa para el proceso de onboarding de empresas y API KYB. Utiliza OCR de actas constitutivas y otros documentos relevantes para validar la identidad y los roles clave dentro de la entidad.

Estructura de la Respuesta

La respuesta de la API se divide en dos secciones principales:

key_people: Contiene la lista de firmantes y administradores
verification: Incluye los detalles de la verificación realizada

Información de Personas Clave

1. Datos Personales

Nombre Completo	Campo JSON	Descripción
Nombres	`names`	Nombre completo del firmante o administrador
Identificación	`idNumber`	RFC o CURP del firmante o administrador

2. Roles y Poderes

Nombre	Campo JSON	Descripción
Roles	`roles`	Lista de roles asignados dentro de la empresa

3. Documentación Adicional

Nombre	Campo JSON	Descripción
Identificación	`identity`	Datos de identificación oficial
Información Fiscal	`fiscal`	Información fiscal y tributaria
Domicilio	`address`	Datos de domicilio

Detalles de Roles y Poderes

Información del Rol

Cada persona puede tener varios roles, cada rol puede tener varios poderes asociados. La estructura de los roles y poderes es la siguiente:

Nombre	Campo JSON	Descripción
Duración	`duration`	Duración en años (-1 = indefinido)
Evento	`event`	Evento que originó el rol
Nombre del Rol	`role_name`	Nombre del rol (ej: presidente, secretario)
Grupo	`group_name`	Categoría del rol
Líneas Fuente	`sourceLines`	Información del documento fuente
Fuente	`source`	Detalles del documento validador
Poderes	`powers`	Lista de poderes otorgados

Poderes Legales

Este es el objeto que describe los poderes legales del representante legal:

Nombre	Campo JSON	Descripción
Duración	`duration`	Duración del poder (-1 = indefinido)
Tiene Poder	`has_power`	Indica si tiene el poder
Tiene Límites	`has_limits`	Indica si existen limitaciones
Nombre del Poder	`power_name`	Tipo de poder otorgado
Tipo de Firma	`signature_type`	Tipo de firma requerida
Descripción de Límites	`limits_description`	Descripción de limitaciones

Tipos de Poderes

Trebol soporta los siguientes tipos de poderes:

Nombre	Campo JSON	Descripción
Títulos de Crédito	`credit`	Poder para firmar titulos de créditos empresariales
Poder de Dominio	`asset_management`	Poder para otorgar garantías, comproventa de activos, etc
Poder de Administración	`administration`	Poder para la gestión operativa general
Poder de Cuentas Bancarias	`bank_accounts`	Poder para abrir o cerrar cuentas bancarias
Poder de Delegación	`delegation`	Poder que permite delegar poderes
Poder de Pleitos y Cobranzas	`lawsuits_and_collections`	Poder que permite hacer la gestión de pleitos y cobranzas

Grupos de Roles

Ya que las empresas deciden tener distintos nombres para los roles, Trebol estandariza los distintos cargos en los siguientes grupos:

Nombre	Campo JSON	Descripción
Consejo	`board_members`	Son los miembros del consejo
Administradores	`executives`	Es el administrador único o equivalentes
Apoderados	`proxies`	Son los apoderados de la empresa
Vigilancia	`auditors`	Son los comisarios o auditores de la empresa

Información de Identidad

Cuando se sube un documento de identificación, domicilio, o comprobante fiscal, Trebol lo valida y extrae la información relevante.

Datos de Identificación

Nombre	Campo JSON	Descripción
ID Personal	`person_id`	Detalles de ID oficial
Datos de Domicilio	`address_data`	Información domiciliaria
Descripción	`description`	Tipo de identificación
Dirección	`address`	Dirección registrada
Fecha del Documento	`documentDate`	Fecha del documento
Campos Extra	`extraFields`	Datos adicionales
Validaciones	`validations`	Validaciones realizadas
Fuente	`source`	Origen del documento

Información Domiciliaria

Nombre	Campo JSON	Descripción
Descripción	`description`	Descripción del domicilio
Dirección	`address`	Dirección completa
Fecha del Documento	`documentDate`	Fecha del comprobante
Fuente	`source`	Origen de la información
Tipo	`type`	Tipo de registro
Proveedor	`provider`	Proveedor del servicio
Tipo de Servicio	`serviceType`	Tipo de servicio

Información Fiscal

Datos Fiscales

Nombre	Campo JSON	Descripción
Estado	`status`	Estado fiscal actual
RFC	`rfc`	RFC del contribuyente
CURP	`curp`	CURP del contribuyente
Domicilio Fiscal	`domicilioFiscal`	Domicilio fiscal
Líneas Fuente	`sourceLines`	Documentos fuente
Información de Dirección	`addressInfo`	Detalles de dirección
Fuente	`source`	Origen de datos
Actividad Principal	`mainActivity`	Actividades económicas
Fecha	`date`	Fecha de registro
Orden	`order`	Orden de importancia
Porcentaje	`percentage`	Porcentaje de actividad
Actividad Económica	`economicActivity`	Descripción de actividad

Dirección Fiscal

Nombre	Campo JSON	Descripción
Tipo de Vía	`streetType`	Tipo de vía
Nombre de Calle	`streetName`	Nombre de calle
Número Exterior	`externalNumber`	Número exterior
Número Interior	`internalNumber`	Número interior
Colonia	`neighborhood`	Colonia
Ciudad	`city`	Ciudad
Alcaldía/Municipio	`district`	Alcaldía/Municipio
Estado	`state`	Estado
Código Postal	`postCode`	Código postal

Ejemplo de Respuesta

{
    "key_people": [
        {
            "names": "DANIEL SERVITJE",
            "idNumber": "DASJ850405HSPRVN02",
            "roles": [
                {
                    "duration": -1,
                    "event": "addition",
                    "role_name": "presidente",
                    "group_name": "executives",
                    "sourceLines": [
                        "ACTA CONSTITUTIVA MX",
                        "15-06-2015",
                        "10234",
                        "Notaría 45, CIUDAD DE MÉXICO, CDMX"
                    ],
                    "source": {
                        "itemId": 94852,
                        "itemType": "ac_mx",
                        "documentDate": "2015-06-15",
                        "documentNumber": "10234",
                        "entityName": "ACME MEXICO",
                        "extraFields": {
                            "notaryCity": "CIUDAD DE MÉXICO",
                            "notaryState": "CIUDAD DE MÉXICO",
                            "notaryName": "MARÍA LÓPEZ PÉREZ",
                            "notaryNumber": "45",
                            "folioNumber": "52384",
                            "folioDate": "2015-07-10T12:00:00Z",
                            "folioInscriptionDate": "2015-07-10T12:00:00Z",
                            "folioDataSource": {
                                "folioNumberSource": "siger",
                                "folioDateSource": "siger",
                                "folioInscriptionDateSource": "siger"
                            }
                        },
                        "documentUrl": "https://files.gotrebol.com/09786e1d-92b7-4503-b84d-d455375be01d/94852_original_file.pdf"
                    },
                    "powers": [
                        {
                            "duration": -1,
                            "has_power": true,
                            "has_limits": true,
                            "power_name": "credit",
                            "signature_type": "joint",
                            "limits_description": "DEBE FIRMAR CON APODERADOS B POR ENCIMA DE $500M USD"
                        },
                        {
                            "duration": -1,
                            "has_power": true,
                            "has_limits": true,
                            "power_name": "administration",
                            "signature_type": "joint",
                            "limits_description": "DEBE FIRMAR EN CONJUNTO CON TODOS LOS MIEMBROS DEL CONSEJO"
                        },
                        {
                            "duration": -1,
                            "has_power": true,
                            "has_limits": true,
                            "power_name": "bank_accounts",
                            "signature_type": "joint",
                            "limits_description": "DEBE FIRMAR EN CONJUNTO CON TODOS LOS MIEMBROS DEL CONSEJO"
                        },
                        {
                            "duration": -1,
                            "has_power": true,
                            "has_limits": true,
                            "power_name": "delegation",
                            "signature_type": "individual",
                            "limits_description": ""
                        },
                        {
                            "duration": -1,
                            "has_power": true,
                            "has_limits": false,
                            "power_name": "lawsuits_and_collections",
                            "signature_type": "individual",
                            "limits_description": ""
                        }
                    ]
                }
            ],
            "identity": {
                "person_id": {
                    "description": "ine_mx",
                    "address": "CALLE INDUSTRIAL 456 COL. TECNOLOGÍA CIUDAD DE MÉXICO 01234 CDMX.",
                    "documentDate": "2025-12-31",
                    "extraFields": {
                        "curp": "DASJ850405HSPRVN02",
                        "rfc": "DASJ850405HSPRVN02"
                    },
                    "validations": [
                        {
                            "source": "ine",
                            "validatedAt": "2024-03-15T10:00:00Z",
                            "validationResult": "valid_id"
                        }
                    ],
                    "source": {
                        "itemId": 84856,
                        "documentUrl": "https://files.gotrebol.com/09786e1d-92b7-4503-b84d-d455375be01d/84856_original_file.pdf",
                        "itemType": "ine_mx",
                        "documentDate": "2025-12-31",
                        "documentNumber": "DASJ850405HSPRVN02",
                        "entityName": "DANIEL SERVITJE",
                        "extraFields": {
                            "idType": "ine_mx"
                        }
                    }
                },
                "address_data": {
                    "description": "person - DANIEL SERVITJE",
                    "address": "CALLE INDUSTRIAL 456 TECNOLOGÍA CP 01234 CIUDAD DE MÉXICO, CDMX",
                    "documentDate": "2024-04-10T00:00:00Z",
                    "source": {
                        "itemId": 84858,
                        "documentUrl": "https://files.gotrebol.com/09786e1d-92b7-4503-b84d-d455375be01d/84858_original_file.pdf",
                        "itemType": "proof_address",
                        "documentDate": "2024-04-10",
                        "entityName": "DANIEL SERVITJE"
                    },
                    "serviceType": null
                }
            },
            "fiscal": {
                "csf_mx": {
                    "status": "ACTIVO",
                    "rfc": "DASJ850405HSPRVN02",
                    "curp": "DASJ850405HSPRVN02",
                    "domicilioFiscal": "CALLE INDUSTRIAL 456 Col. TECNOLOGÍA, CIUDAD DE MÉXICO, CDMX 01234",
                    "mainActivity": [
                        {
                            "date": "2023-05-22",
                            "order": 1,
                            "percentage": 70,
                            "economicActivity": "Dirección Ejecutiva"
                        },
                        {
                            "date": "2023-05-22",
                            "order": 2,
                            "percentage": 30,
                            "economicActivity": "Socio o accionista"
                        }
                    ],
                    "sourceLines": [
                        "Constancia de Situación Fiscal (validación QR)",
                        "08-06-2024"
                    ],
                    "addressInfo": {
                        "streetType": "CALLE",
                        "streetName": "INDUSTRIAL",
                        "externalNumber": "456",
                        "internalNumber": "",
                        "neighborhood": "TECNOLOGÍA",
                        "city": "CIUDAD DE MÉXICO",
                        "district": "ALCALDÍA AZCAPOTZALCO",
                        "state": "CIUDAD DE MÉXICO",
                        "postCode": "01234"
                    },
                    "source": {
                        "itemId": 84860,
                        "documentUrl": "https://files.gotrebol.com/09786e1d-92b7-4503-b84d-d455375be01d/84860_original_file.pdf",
                        "itemType": "csf_mx",
                        "entityName": "ACME MEXICO",
                        "documentDate": "2023-05-10",
                        "extraFields": {
                            "taxIdNumber": "DASJ850405HSPRVN02",
                            "qrValidation": true,
                            "qrValidatedAt": "2024-06-08T20:27:55.339Z"
                        }
                    }
                }
            },
            "address": {
                "proof_address": {
                    "description": "person - DANIEL SERVITJE",
                    "address": "CALLE INDUSTRIAL 456 TECNOLOGÍA CP 01234 SUBURBANO, CDMX",
                    "documentDate": "2024-04-10T00:00:00Z",
                    "source": {
                        "itemId": 84858,
                        "documentUrl": "https://files.gotrebol.com/09786e1d-92b7-4503-b84d-d455375be01d/84858_original_file.pdf",
                        "itemType": "proof_address",
                        "documentDate": "2024-04-10",
                        "entityName": "DANIEL SERVITJE"
                    },
                    "type": "person",
                    "provider": null,
                    "serviceType": null
                }
            }
        }
    ],
    "verification": {
        "id": "09786e1d-92b7-4503-b84d-d455375be01d",
        "tag": "id-trebol-demo-01",
        "status": "finished",
        "taxId": null,
        "flowId": null,
        "documentsStatus": "partial_upload",
        "onboardingTermsAndConditions": {
            "prospectPermission": {
                "date": "2024-05-29T16:01:03.169Z",
                "email": "",
                "accepted": true,
                "ipAddress": "186.29.32.49"
            },
            "clientPrivacyPolicy": {
                "date": "2024-05-29T16:01:03.169Z",
                "email": "",
                "accepted": true,
                "ipAddress": "186.29.32.49"
            }
        }
    }
}

Intro al API de Trébol

​API KYB: Verificación de Firmantes y Administradores

​Estructura de la Respuesta

​Información de Personas Clave

​1. Datos Personales

​2. Roles y Poderes

​3. Documentación Adicional

​Detalles de Roles y Poderes

​Información del Rol

​Poderes Legales

​Tipos de Poderes

​Grupos de Roles

​Información de Identidad

​Datos de Identificación

​Información Domiciliaria

​Información Fiscal

​Datos Fiscales

​Dirección Fiscal

​Ejemplo de Respuesta