Accionistas - Trébol

La sección Accionistas del Diccionario de Variables de Trébol proporciona las herramientas necesarias para gestionar la información relacionada con los accionistas de una empresa en los documentos generados a través de la plataforma. Esta sección incluye la nomenclatura para listar a todos los accionistas, así como las variables necesarias para acceder a los datos específicos de cada uno.

Listado de Accionistas

Para listar todos los accionistas en un documento, se recomienda usar la siguiente nomenclatura, que permite organizar la información de manera clara y estructurada:

Campo	Variable	Descripción
Accionista	`{#shareholders}{name}`	Nombre del accionista.
Acciones	`{total_shares}`	Número total de acciones del accionista.
Valor	`{total_value}`	Valor total de las acciones del accionista.
Porcentaje	`{share_percentage}%`	Porcentaje de participación accionaria.

Ejemplo de Exportar Datos de Accionistas

{#shareholders}{name} - {total_shares} acciones - {total_value} - {share_percentage}% {/shareholders}
TOTAL
{capital_totalShares} acciones - {capital_totalValue} - 100%

Datos Individuales por cada Accionista

Para acceder a la información específica de cada accionista, se utiliza una nomenclatura incremental: shareholder_0, shareholder_1, etc. A continuación se presenta una tabla con las variables disponibles para cada accionista:

Campo	Variable	Descripción
Nombre del accionista	`{shareholder_0_name}`	Nombre del accionista.
Tipo de accionista	`{shareholder_0_type}`	Determina si el accionista es persona física o persona moral.
Nacionalidad del accionista	`{shareholder_0_nationality}`	Nacionalidad del accionista.
Tipo de ID del accionista	`{shareholder_0_id_type}`	Tipo del ID del accionista.
Número de ID del accionista	`{shareholder_0_id_number}`	Número del ID del accionista.
Moneda del capital social	`{shareholder_0_currency}`	Moneda del capital social pagado por el accionista.
Acciones del capital fijo	`{shareholder_0_fixed_shares}`	Número de acciones del capital fijo del accionista.
Monto del capital fijo	`{shareholder_0_fixed_value}`	Monto del capital fijo del accionista.
Acciones del capital variable	`{shareholder_0_variable_shares}`	Número de acciones del capital variable del accionista.
Monto del capital variable	`{shareholder_0_variable_value}`	Monto del capital variable del accionista.
Total de acciones	`{shareholder_0_total_shares}`	Número total de acciones (fijo + variable) del accionista.
Monto total del capital	`{shareholder_0_total_value}`	Monto total del capital (fijo + variable) del accionista.
Porcentaje de participación	`{shareholder_0_share_percentage}`	Porcentaje de participación del accionista en el capital total.

Esta sección permite gestionar el capital social de una persona moral en un documento, utilizando las variables correspondientes para representar la información más reciente disponible en el acta de la empresa.

Campo	Variable	Descripción
Monto del capital fijo	`{capital_fixedValue}`	Monto del capital fijo según el acta más reciente donde se encuentre el capital social.
Acciones del capital fijo	`{capital_fixedShares}`	Acciones o participaciones del capital fijo según el acta más reciente donde se encuentre el capital social.
Monto del capital variable	`{capital_variableValue}`	Monto del capital variable según el acta más reciente donde se encuentre el capital social.
Acciones del capital variable	`{capital_variableShares}`	Acciones o participaciones del capital variable según el acta más reciente donde se encuentre el capital social.
Monto total del capital	`{capital_totalValue}`	Monto total del capital (fijo + variable) según el acta más reciente donde se encuentre el capital social.
Total de acciones	`{capital_totalShares}`	Acciones o participaciones totales del capital (fijo + variable) según el acta más reciente donde se encuentre el capital social.

Tabla de Accionistas de cada Acta

Además de la tabla vigente, cada acta trae su propia tabla de accionistas tal como quedó registrada en esa escritura. Las actas están en dos listas con el mismo contenido:

actaSources: en el orden en que se cargaron. Úsala cuando tu plantilla accede a un acta por su posición (actaSources_0_…).
actaSources_by_date: de la más antigua a la más reciente; las actas sin fecha van al final. Recomendada para listar la historia de la empresa.

Dentro de cada acta están disponibles estas variables (solo funciona en Word, no en PDF):

Campo	Variable	Descripción
Tiene accionistas	`{has_shareholders}`	Condicional: verdadero si el acta registra una tabla de accionistas. Uso: `{#has_shareholders}…{/}`
Accionistas del acta	`{#shareholders}{name}`	Listado de accionistas del acta, con `name`, `type`, `id_type`, `id_number`, `nationality`, `role`, `fixed_shares`, `variable_shares`, `total_shares`, `total_value` y `share_percentage`.
Total de acciones del acta	`{capital_totalShares}`	Total de acciones registradas en el acta.
Capital total del acta	`{capital_totalValue}`	Monto total del capital registrado en el acta.

El porcentaje de cada accionista se calcula sobre el capital de esa acta: por monto, o por número de acciones si el acta no registra montos.

Ejemplo de Tabla de Accionistas por Acta

{#actaSources_by_date}
{type} {documentNumber} - {documentDate}
{#has_shareholders}
{#shareholders}{name} - {total_shares} acciones - {share_percentage}% - ${total_value}{/shareholders}
TOTAL {capital_totalShares} acciones - 100% - ${capital_totalValue}
{/}
{/actaSources_by_date}

En PDF usa la versión numerada: {actaSources_by_date_0_shareholders_0_name}, {actaSources_by_date_0_capital_totalValue}, etc.

Beneficiarios Controladores

ubos_controlling lista a las personas físicas que tienen directamente 25% o más de participación.

Campo	Variable	Descripción
Beneficiario controlador	`{#ubos_controlling}{name}`	Nombre completo del beneficiario controlador.
Nombres	`{names}`	Nombre(s) del beneficiario controlador.
Primer apellido	`{firstSurname}`	Primer apellido del beneficiario controlador.
Segundo apellido	`{secondSurname}`	Segundo apellido del beneficiario controlador.
Porcentaje	`{share_percentage}`	Porcentaje de participación.

En PDF: {ubos_controlling_0_name}, {ubos_controlling_0_share_percentage}, etc.

​Listado de Accionistas

​Ejemplo de Exportar Datos de Accionistas

​Datos Individuales por cada Accionista

​Capital Social de la Persona Moral

​Tabla de Accionistas de cada Acta

​Ejemplo de Tabla de Accionistas por Acta

​Beneficiarios Controladores

Listado de Accionistas

Ejemplo de Exportar Datos de Accionistas

Datos Individuales por cada Accionista

Capital Social de la Persona Moral

Tabla de Accionistas de cada Acta

Ejemplo de Tabla de Accionistas por Acta

Beneficiarios Controladores