> ## 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.
# Extraer Accionistas de Actas
> Consultar los accionistas de una empresa en el onboarding de empresas
## 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:
| Nombre | Campo y Tipo | Descripción |
| --------------------------- | -------------------------------- | -------------------------------------------------------------------------- |
| ID del Accionista | `id` (integer) | Identificador único del accionista utilizado para referenciar internamente |
| Moneda | `currency` (string) | Moneda en la que se valoran las acciones (ej: "MXN") |
| Acciones Fijas | `fixed_shares` (string) | Número de acciones que no están sujetas a variaciones |
| Valor de Acciones Fijas | `fixed_value` (string) | Valor monetario de las acciones fijas |
| Número de Identificación | `id_number` (string) | Número de identificación fiscal (RFC) del accionista |
| Tipo de Identificación | `id_type` (string) | Tipo de documento de identificación utilizado (ej: "RFC") |
| Nombre | `name` (string) | Nombre completo del accionista |
| Nacionalidad | `nationality` (string) | País de origen del accionista |
| Total de Acciones | `total_shares` (string) | Cantidad total de acciones en posesión del accionista |
| Valor Total | `total_value` (string) | Valoración económica total de las acciones |
| Tipo de Accionista | `type` (string) | Categoría del accionista (ej: "Persona") |
| Acciones Variables | `variable_shares` (string) | Número de acciones sujetas a cambios o condiciones |
| Valor de Acciones Variables | `variable_value` (string) | Valor monetario de las acciones variables |
| Porcentaje de Participación | `share_percentage` (integer) | Porcentaje de propiedad en la empresa |
| Estado AML | `aml_validation_status` (string) | Estado de las verificaciones anti-lavado de dinero |
| Categorías de Riesgo AML | `aml_risk_category` (array) | Lista de categorías de riesgo identificadas |
| Datos AML | `aml_data` (array) | Información complementaria sobre verificaciones AML |
| Información de Identidad | `identity` (object) | Datos de identificación oficial del accionista |
| Información Fiscal | `fiscal` (object) | Datos fiscales y tributarios del accionista |
| Dirección | `address` (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.
| Nombre | Campo y Tipo | Descripción |
| ------------------------------ | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Valor Fijo del Capital | `fixed_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 Capital | `fixed_shares` (string) | Cantidad de acciones que representan el capital fijo, esencial para evaluar la distribución establecida del capital |
| Valor Variable del Capital | `variable_value` (string) | Indica la parte del capital que puede variar, importante para analizar posibles cambios en la estructura de capital |
| Acciones Variables del Capital | `variable_shares` (string) | Cantidad de acciones sujetas a variaciones, crucial para entender posibles diluciones o incrementos en la propiedad |
| Valor Total del Capital | `total_value` (string) | Valor total combinado del capital fijo y variable, fundamental para evaluar la valoración completa de la empresa |
| Acciones Totales del Capital | `total_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`.
| Nombre | Campo y Tipo | Descripción |
| --------------------- | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID del Ítem | `item_id` (string) | Referencia única del documento dentro del sistema |
| Tipo de Ítem | `item_type` (string) | Categoría interna del documento (e.g., `"ac_mx"`) |
| URL del Documento | `document_url` (string) | Enlace al documento fuente original |
| Nombre de la Entidad | `entity_name` (string) | Nombre de la entidad o institución que emitió el documento |
| Fuente de Información | `information_source` (string) | Indica el origen de los datos (e.g., registro público, notaría) |
| Fecha de Origen | `source_date` (string) | Fecha en la que se originó la información en la fuente |
| Campos Adicionales | `extra_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`.
| Nombre | Campo y Tipo | Descripción |
| ------------------ | ----------------- | ---------------------------------------------------------------------------- |
| ID de Verificación | `id` (string) | Identificador único de la verificación |
| Etiqueta | `tag` (string) | Identificador secundario para clasificar y seguir verificaciones específicas |
| Estado | `status` (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](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ámetro | Tipo | Descripción |
| ---------------- | ------ | ---------------------------------------------- |
| verification\_id | string | Identificador único de la verificación (UUID). |
### Query parameters
Si es `true`, el response incluye `data.citations.url` con la URL firmada al artifact de coordenadas. Ver [Coordenadas de citas](/docs/guia-devs/referencia/coordenadas-citas).
### Campo `data.citations`
Cuando se pasa `?with_citations=true`, el response incluye el objeto `citations` dentro de `data`:
```json theme={"dark"}
{
"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
```json theme={"dark"}
{
"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"
}
}
}
```