Skip to main content

API KYB: Verificación de Accionistas

Este endpoint permite extraer información detallada de los accionistas 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 la estructura accionarial de la entidad.

Campos de Respuesta

Accionistas mas recientes

Trebol dectecta la Lista de accionistas de la empresa en las actas y además condensa la información de las actas con la información de los documentos de personas que se subieron. Los siguientes son los campos que se devuelven:
NombreCampo y TipoDescripción
ID del Accionistaid (integer)Identificador único del accionista utilizado para referenciar internamente
Monedacurrency (string)Moneda en la que se valoran las acciones (ej: “MXN”)
Acciones Fijasfixed_shares (string)Número de acciones que no están sujetas a variaciones
Valor de Acciones Fijasfixed_value (string)Valor monetario de las acciones fijas
Número de Identificaciónid_number (string)Número de identificación fiscal (RFC) del accionista
Tipo de Identificaciónid_type (string)Tipo de documento de identificación utilizado (ej: “RFC”)
Nombrename (string)Nombre completo del accionista
Nacionalidadnationality (string)País de origen del accionista
Total de Accionestotal_shares (string)Cantidad total de acciones en posesión del accionista
Valor Totaltotal_value (string)Valoración económica total de las acciones
Tipo de Accionistatype (string)Categoría del accionista (ej: “Persona”)
Acciones Variablesvariable_shares (string)Número de acciones sujetas a cambios o condiciones
Valor de Acciones Variablesvariable_value (string)Valor monetario de las acciones variables
Porcentaje de Participaciónshare_percentage (integer)Porcentaje de propiedad en la empresa
Estado AMLaml_validation_status (string)Estado de las verificaciones anti-lavado de dinero
Categorías de Riesgo AMLaml_risk_category (array)Lista de categorías de riesgo identificadas
Datos AMLaml_data (array)Información complementaria sobre verificaciones AML
Información de Identidadidentity (object)Datos de identificación oficial del accionista
Información Fiscalfiscal (object)Datos fiscales y tributarios del accionista
Direcciónaddress (object)Datos de ubicación física del accionista

Capital social de la empresa

Información sobre el capital social de la empresa según el acta más reciente.
NombreCampo y TipoDescripción
Valor Fijo del Capitalfixed_value (string)Muestra la parte del capital que está establecida y no sujeta a cambios, ayudando a entender la solidez financiera fija de la empresa
Acciones Fijas del Capitalfixed_shares (string)Cantidad de acciones que representan el capital fijo, esencial para evaluar la distribución establecida del capital
Valor Variable del Capitalvariable_value (string)Indica la parte del capital que puede variar, importante para analizar posibles cambios en la estructura de capital
Acciones Variables del Capitalvariable_shares (string)Cantidad de acciones sujetas a variaciones, crucial para entender posibles diluciones o incrementos en la propiedad
Valor Total del Capitaltotal_value (string)Valor total combinado del capital fijo y variable, fundamental para evaluar la valoración completa de la empresa
Acciones Totales del Capitaltotal_shares (string)Número total de acciones emitidas, importante para calcular el porcentaje de participación accionarial

Fuente de donde se obtuvo la lista de accionistas

Información del documento del que se extrajo la lista de accionistas, siguiendo el esquema V2PublicSource.
NombreCampo y TipoDescripción
ID del Ítemitem_id (string)Referencia única del documento dentro del sistema
Tipo de Ítemitem_type (string)Categoría interna del documento (e.g., "ac_mx")
URL del Documentodocument_url (string)Enlace al documento fuente original
Nombre de la Entidadentity_name (string)Nombre de la entidad o institución que emitió el documento
Fuente de Informacióninformation_source (string)Indica el origen de los datos (e.g., registro público, notaría)
Fecha de Origensource_date (string)Fecha en la que se originó la información en la fuente
Campos Adicionalesextra_fields (object)Metadatos específicos del documento, como acta_city, acta_number, acta_state, folio_number, folio_date, notary_name, notary_number y type

Información de la verificación

Metadatos de la verificación devueltos bajo el objeto meta.verification, siguiendo el esquema V2VerificationMeta.
NombreCampo y TipoDescripción
ID de Verificaciónid (string)Identificador único de la verificación
Etiquetatag (string)Identificador secundario para clasificar y seguir verificaciones específicas
Estadostatus (string)Estado de la verificación (e.g., "finished")

Workflow de Verificación

Para facilitar la comprensión del proceso de verificación de accionistas, a continuación se detalla el flujo de trabajo:

Subir Actas y Documentos

El usuario carga las actas constitutivas, actas de asamblea, comprobantes de domicilio y otros documentos necesarios para el proceso de onboarding de empresas. Este paso implica la recopilación de toda la documentación requerida para iniciar el proceso de verificación, asegurando que se disponen de todos los documentos legales y fiscales necesarios para la evaluación.

Trebol Identifica Accionistas Más Recientes

Utilizando tecnologías de OCR de actas constitutivas, Trebol extrae y actualiza la información de los accionistas más recientes de la empresa. Esto automatiza la extracción de datos clave, mejorando la eficiencia del proceso y garantizando que la información de propiedad está actualizada y es precisa para una evaluación adecuada.

Recibir Notificación Webhook

Una vez completada la identificación y verificación, Trebol envía una notificación a través de un webhook configurado por el usuario. Esto permite la integración con otros sistemas y la automatización de flujos de trabajo posteriores, notificando la finalización del proceso de verificación y permitiendo iniciar la revisión de la información.

Leer Información de Accionistas

El usuario o tu sistema accede a los datos detallados de los accionistas mediante una solicitud al endpoint, obteniendo información actualizada y verificada. Esto facilita la visualización y utilización de los datos para decisiones de negocio y cumplimiento, proporcionando acceso a información detallada para realizar evaluaciones de riesgo y cumplimiento normativo.

Endpoint

GET https://api.gotrebol.com/v2/verifications/{verification_id}/shareholders

Descripción

Obtiene la lista de accionistas de una empresa verificada, incluyendo detalles como porcentaje de acciones, tipo de accionista, información fiscal y de identidad. Este proceso es esencial para el onboarding de persona moral y cumple con las disposiciones CNBV.

Parámetros de Ruta

ParámetroTipoDescripción
verification_idstringIdentificador único de la verificación (UUID).

Query parameters

with_citations
boolean
Si es true, el response incluye data.citations.url con la URL firmada al artifact de coordenadas. Ver Coordenadas de citas.

Campo data.citations

Cuando se pasa ?with_citations=true, el response incluye el objeto citations dentro de data:
{
  "data": {
    "shareholders": [...],
    "capital": {...},
    "source": {...},
    "citations": {
      "url": "https://files.gotrebol.com/{verification_id}/citations/shareholders.json?..."
    }
  }
}
La URL firmada caduca 1 hora después de generarla. Descarga el JSON y persiste su contenido en tu lado si necesitas acceso posterior. Si la URL caduca, vuelve a llamar al endpoint con el flag para obtener una nueva.
Trébol genera el artifact con el evento verification.v2.finished. Los requests anteriores a ese evento no traen la URL de citations.

Respuesta

Devuelve un objeto JSON con la información de los accionistas y el capital social de la empresa verificada.

Ejemplo de Respuesta

{
    "success": true,
    "data": {
        "shareholders": [
            {
                "id": 102345,
                "currency": "MXN",
                "fixed_shares": "60",
                "fixed_value": "60000",
                "id_number": "ELON900101XYZ",
                "id_type": "RFC",
                "name": "ELON MUSK",
                "nationality": "Estadounidense",
                "total_shares": "60",
                "total_value": "60000",
                "type": "Persona",
                "variable_shares": "0",
                "variable_value": "0",
                "share_percentage": 60,
                "aml_validation_status": "no_aml_items",
                "aml_risk_category": [],
                "aml_data": [],
                "identity": {
                    "person_id": {
                        "description": "ine_mx - MUSE900101XYZ123",
                        "address": "CALLE TESLA 100 COL. SILICON VALLEY, CIUDAD DE MÉXICO, CDMX.",
                        "document_date": "2029-10-31",
                        "extra_fields": {
                            "curp": "MUSE900101HDFXLN02"
                        },
                        "validations": [
                            {
                                "source": "ine",
                                "validated_at": "2024-01-10T09:15:00Z",
                                "validation_result": "valid_id"
                            }
                        ],
                        "source": {
                            "item_id": 95001,
                            "document_url": "https://files.ejemplo.com/verification/95001_original_file.pdf",
                            "item_type": "person_id",
                            "document_date": "2029-10-31",
                            "document_number": "MUSE900101XYZ123",
                            "entity_name": "ELON MUSK",
                            "extra_fields": {
                                "idType": "ine_mx"
                            }
                        }
                    },
                    "address_data": {
                        "description": "person - ELON MUSK",
                        "address": "CALLE TESLA 100 COL. SILICON VALLEY CP 01001 CIUDAD DE MÉXICO, CDMX",
                        "document_date": "2024-02-15T00:00:00Z"
                    }
                },
                "fiscal": {
                    "tax_id": "MUSE900101XYZ",
                    "tax_regime": "Persona Física con Actividad Empresarial",
                    "tax_status": "Activo",
                    "validations": [
                        {
                            "source": "sat",
                            "validated_at": "2024-01-10T09:15:00Z",
                            "validation_result": "valid_tax_id"
                        }
                    ]
                },
                "address": {
                    "street": "CALLE TESLA",
                    "exterior_number": "100",
                    "neighborhood": "SILICON VALLEY",
                    "municipality": "CIUDAD DE MÉXICO",
                    "state": "CDMX",
                    "zip_code": "01001",
                    "country": "México"
                }
            },
            {
                "id": 102346,
                "currency": "MXN",
                "fixed_shares": "40",
                "fixed_value": "40000",
                "id_number": "SLHC400128ABC",
                "id_type": "RFC",
                "name": "CARLOS SLIM HELÚ",
                "nationality": "Mexicana",
                "total_shares": "40",
                "total_value": "40000",
                "type": "Persona",
                "variable_shares": "0",
                "variable_value": "0",
                "share_percentage": 40,
                "aml_validation_status": "no_aml_items",
                "aml_risk_category": [],
                "aml_data": [],
                "identity": {
                    "person_id": {
                        "description": "ine_mx - SLHC400128ABC",
                        "address": "AV. REFORMA 1234 COL. LOMAS DE CHAPULTEPEC, CIUDAD DE MÉXICO, CDMX.",
                        "document_date": "2030-12-31",
                        "extra_fields": {
                            "curp": "SLHC400128HDFXLN01",
                            "rfc": "SLHC400128ABC"
                        },
                        "validations": [
                            {
                                "source": "ine",
                                "validated_at": "2024-01-15T10:30:00Z",
                                "validation_result": "valid_id"
                            }
                        ],
                        "source": {
                            "item_id": 95000,
                            "document_url": "https://files.ejemplo.com/verification/95000_original_file.pdf",
                            "item_type": "person_id",
                            "document_date": "2030-12-31",
                            "document_number": "SLHC400128ABC",
                            "entity_name": "CARLOS SLIM HELÚ",
                            "extra_fields": {
                                "idType": "ine_mx"
                            }
                        }
                    },
                    "address_data": {
                        "description": "person - CARLOS SLIM HELÚ",
                        "address": "AV. REFORMA 1234 COL. LOMAS DE CHAPULTEPEC CP 11000 CIUDAD DE MÉXICO, CDMX",
                        "document_date": "2024-02-20T00:00:00Z",
                        "source": {
                            "item_id": 95001,
                            "document_url": "https://files.ejemplo.com/verification/95001_original_file.pdf",
                            "item_type": "proof_address",
                            "document_date": "2024-02-20",
                            "entity_name": "CARLOS SLIM HELÚ"
                        },
                        "service_type": null
                    }
                },
                "fiscal": {
                    "csf_mx": {
                        "status": "ACTIVO",
                        "rfc": "SLHC400128ABC",
                        "curp": "SLHC400128HDFXLN01",
                        "domicilioFiscal": "AV. REFORMA 1234 COL. LOMAS DE CHAPULTEPEC, CIUDAD DE MÉXICO, CDMX 11000",
                        "mainActivity": [
                            {
                                "date": "2021-05-10",
                                "order": 1,
                                "percentage": 80,
                                "economicActivity": "Telecomunicaciones"
                            },
                            {
                                "date": "2021-05-10",
                                "order": 2,
                                "percentage": 20,
                                "economicActivity": "Inversionista"
                            }
                        ],
                        "sourceLines": [
                            "Constancia de Situación Fiscal (validación QR)",
                            "10-05-2024"
                        ],
                        "addressInfo": {
                            "streetType": "AVENIDA",
                            "streetName": "REFORMA",
                            "externalNumber": "1234",
                            "internalNumber": "",
                            "neighborhood": "LOMAS DE CHAPULTEPEC",
                            "city": "CIUDAD DE MÉXICO",
                            "district": "MIGUEL HIDALGO",
                            "state": "CIUDAD DE MÉXICO",
                            "postCode": "11000"
                        },
                        "source": {
                            "item_id": 95002,
                            "document_url": "https://files.ejemplo.com/verification/95002_original_file.pdf",
                            "item_type": "csf_mx",
                            "entity_name": "CLEVELAND TECH SOLUTIONS",
                            "document_date": "2021-05-10",
                            "extra_fields": {
                                "taxIdNumber": "SLHC400128ABC",
                                "qrValidation": true,
                                "qrValidatedAt": "2024-05-10T15:45:00Z"
                            }
                        }
                    }
                },
                "address": {
                    "proof_address": {
                        "description": "person - CARLOS SLIM HELÚ",
                        "address": "AV. REFORMA 1234 COL. LOMAS DE CHAPULTEPEC CP 11000 CIUDAD DE MÉXICO, CDMX",
                        "document_date": "2024-02-20T00:00:00Z",
                        "source": {
                            "item_id": 95001,
                            "item_type": "proof_address",
                            "document_date": "2024-02-20",
                            "entity_name": "CARLOS SLIM HELÚ"
                        },
                        "type": "person",
                        "provider": null,
                        "service_type": null
                    }
                }
            }
        ],
        "capital": {
            "fixed_value": "100000",
            "fixed_shares": "100",
            "fixed_value_currency": "MXN",
            "variable_value": "0",
            "variable_shares": "0",
            "total_value": "100000",
            "total_shares": "100",
            "total_value_currency": "MXN"
        },
        "source": {
            "item_id": 95003,
            "item_type": "ac_mx",
            "document_url": "https://files.ejemplo.com/verification/95003_original_file.pdf",
            "document_date": "2020-06-01",
            "document_number": "56789",
            "entity_name": "CLEVELAND TECH SOLUTIONS",
            "extra_fields": {
                "folio_number": "98765",
                "folio_date": "2020-06-15",
                "notary_name": "MARÍA GONZÁLEZ PÉREZ",
                "notary_number": "45",
                "notary_state": "CIUDAD DE MÉXICO",
                "notary_city": "CIUDAD DE MÉXICO",
                "folio_data_source": {
                    "folio_number_source": "registro_publico",
                    "folio_date_source": "ac_mx"
                }
            },
            "information_source": "acta_constitutiva",
            "source_date": "2020-06-01"
        }
    },
    "meta": {
        "section": "shareholders",
        "verification": {
            "id": "a1b2c3d4-e5f6-7890-1234-56789abcdef0",
            "tag": "kyb-demo-02",
            "status": "finished"
        }
    }
}