> ## 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.

# Apoderados

> Guía detallada sobre cómo utilizar las variables de apoderados en Trébol, incluyendo la implementación de bucles, listas, y condicionales para personalizar la documentación.

La sección **Apoderados** del Diccionario de Variables de Trébol proporciona una guía completa para implementar y gestionar las variables relacionadas con los apoderados o representantes legales en los documentos generados a través de la plataforma de Trébol. Esta guía incluye la utilización de bucles (listas) y condicionales mediante la librería de manipulación de plantillas implementada en la interfaz de usuario de Trébol.

### Representante legal

Se pueden agregar múltiples apoderados utilizando una nomenclatura incremental: `{key_person_1}`, `{key_person_2}`, etc. Los usuarios asignan valores específicos a cada "key person" directamente en la web app de Trébol.

#### Variables Disponibles para Representantes Legales

| **Campo**                          | **Variable**                                              | **Descripción**                                                                                            |
| ---------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Nombre del apoderado               | `{key_person_1}`                                          | Nombre del apoderado o representante legal.                                                                |
| RFC del apoderado                  | `{key_person_1_tax_id}`                                   | RFC del apoderado o representante legal.                                                                   |
| Primeros nombres del apoderado     | `{key_person_1_external_identities_names}`                | Primeros nombres del apoderado o representante legal.                                                      |
| Apellido paterno del apoderado     | `{key_person_1_external_identities_firstSurname}`         | Apellido paterno del apoderado o representante legal.                                                      |
| Apellido materno del apoderado     | `{key_person_1_external_identities_secondSurname}`        | Apellido materno del apoderado o representante legal.                                                      |
| Género del apoderado               | `{key_person_1_external_identities_gender}`               | Género del apoderado o representante legal.                                                                |
| Fecha de nacimiento del apoderado  | `{key_person_1_external_identities_birthDate}`            | Fecha de nacimiento del apoderado o representante legal.                                                   |
| Nacionalidad del apoderado         | `{key_person_1_external_identities_nationality}`          | Nacionalidad del apoderado o representante legal.                                                          |
| Ciudad de nacimiento del apoderado | `{key_person_1_external_identities_birthEntity}`          | Ciudad de nacimiento del apoderado o representante legal.                                                  |
| Ciudad de registro del CURP        | `{key_person_1_external_identities_registerEntity}`       | Ciudad de registro del CURP del apoderado o representante legal.                                           |
| Municipio de registro del CURP     | `{key_person_1_external_identities_registerMunicipality}` | Municipio de registro del CURP del apoderado o representante legal.                                        |
| Rol del apoderado                  | `{key_person_1_role_name}`                                | Rol del apoderado o representante legal.                                                                   |
| Número del apoderado               | `{key_person_1_id}`                                       | Número del apoderado o representante legal.                                                                |
| Lista de poderes del apoderado     | `{key_person_1_powers[]}`                                 | Lista de poderes del apoderado, incluyendo duración, tipo de firma, límites, y descripción de los poderes. |

### Ejemplo de Exportar de Lista de Poderes

Para listar todos los poderes de un apoderado, se puede utilizar la siguiente sintaxis en tu documento para mostrar el nombre del poder y el tipo de firma. Esta lista solo funciona en Word, no en PDF.

```
{#key_person_1_powers}{power_name}: {signature_type}, {/key_person_1_powers}
```

Esto generará una salida como:

```
COBRANZA: INDIVIDUAL, ADMIN: INDIVIDUAL, DOMINIO: CONJUNTO, CRÉDITO: CONJUNTO, BANCARIO: CONJUNTO.
```

#### Exportar a Datos de RENAPO de Representantes Legales

Mediante la variable `key_person_external_identities`, puedes acceder a todos los datos extraídos de la búsqueda en RENAPO para el apoderado seleccionado:

| **Campo**                        | **Variable**                                              | **Descripción**                                |
| -------------------------------- | --------------------------------------------------------- | ---------------------------------------------- |
| Número de acto                   | `{key_person_1_external_identities_actNumber}`            | Número de acto registrado en RENAPO.           |
| Fecha de nacimiento              | `{key_person_1_external_identities_birthDate}`            | Fecha de nacimiento del apoderado.             |
| Entidad federativa de nacimiento | `{key_person_1_external_identities_birthEntity}`          | Entidad federativa donde nació el apoderado.   |
| Número de CURP                   | `{key_person_1_external_identities_curp}`                 | Número de CURP del apoderado.                  |
| Tipo de documento de evidencia   | `{key_person_1_external_identities_evidentiaryDocument}`  | Tipo de documento de evidencia presentado.     |
| Primer apellido                  | `{key_person_1_external_identities_firstSurname}`         | Primer apellido del apoderado.                 |
| Segundo apellido                 | `{key_person_1_external_identities_secondSurname}`        | Segundo apellido del apoderado.                |
| Género                           | `{key_person_1_external_identities_gender}`               | Género del apoderado.                          |
| Nombres                          | `{key_person_1_external_identities_names}`                | Nombres del apoderado.                         |
| Nacionalidad                     | `{key_person_1_external_identities_nationality}`          | Nacionalidad del apoderado.                    |
| Entidad federativa de registro   | `{key_person_1_external_identities_registerEntity}`       | Entidad federativa de registro del CURP.       |
| Municipalidad de registro        | `{key_person_1_external_identities_registerMunicipality}` | Municipalidad de registro del CURP.            |
| Fecha de registro                | `{key_person_1_external_identities_registryDate}`         | Fecha de registro de la información en RENAPO. |

Con estas herramientas y variables, Trébol permite una gestión eficiente y precisa de la información de los apoderados en todos los documentos generados a través de su plataforma.

#### Acta o Poder de Donde se Capturan los Poderes

| **Campo**                         | **Variable**                         | **Descripción**                                                                                   |
| --------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------- |
| Tipo de documento                 | `{key_person_1_source_type}`         | Tipo de documento de donde se capturó el poder de la persona.                                     |
| Número del acta                   | `{key_person_1_source_number}`       | Número del acta de donde se captura el poder de la persona.                                       |
| Fecha de protocolización del acta | `{key_person_1_source_date}`         | Fecha de protocolización del acta de donde se captura el poder de la persona.                     |
| Nombre del notario                | `{key_person_1_source_notaryName}`   | Nombre del notario que protocolizó el acta de donde se captura el poder de la persona.            |
| Número de notaría                 | `{key_person_1_source_notaryNumber}` | Número de notaría que protocolizó el acta de donde se captura el poder de la persona.             |
| Ciudad de la notaría              | `{key_person_1_source_notaryCity}`   | Ciudad de la notaría en la que se protocolizó el acta de donde se captura el poder de la persona. |
| Estado de la notaría              | `{key_person_1_source_notaryState}`  | Estado de la notaría en la que se protocolizó el acta de donde se captura el poder de la persona. |
| Número de registro en el RPPYC    | `{key_person_1_source_folioNumber}`  | Número de registro en el RPPYC del acta de donde se captura el poder de la persona.               |
| Fecha de inscripción en el RPPYC  | `{key_person_1_source_folioDate}`    | Fecha de inscripción en el RPPYC del acta de donde se captura el poder de la persona.             |

#### Facultad de Pleitos y Cobranza

| **Variable**                                                     | **Descripción**                                                                                                                             |
| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `key_person_1_power_lawsuits_and_collections_power_name`         | Nombre del poder de pleitos y cobranzas.                                                                                                    |
| `key_person_1_power_lawsuits_and_collections_has_power`          | Indica si la persona tiene el poder de pleitos y cobranzas.                                                                                 |
| `key_person_1_power_lawsuits_and_collections_duration`           | Duración del poder de pleitos y cobranzas.                                                                                                  |
| `key_person_1_power_lawsuits_and_collections_signature_type`     | Indica el tipo de firma: `"joint"` para firma mancomunada o `"individual"` para firma individual del poder de pleitos y cobranzas.          |
| `key_person_1_power_lawsuits_and_collections_has_limits`         | Indica si tiene límites el poder de pleitos y cobranzas.                                                                                    |
| `key_person_1_power_lawsuits_and_collections_limits_description` | Descripción del límite del poder de pleitos y cobranzas.                                                                                    |
| `key_person_1_power_lawsuits_and_collections_is_joint`           | Condicional para renderizar contenido si el tipo de firma es conjunta: `{#key_person_1_power_lawsuits_and_collections_is_joint}M{/}`        |
| `key_person_1_power_lawsuits_and_collections_is_individual`      | Condicional para renderizar contenido si el tipo de firma es individual: `{#key_person_1_power_lawsuits_and_collections_is_individual}I{/}` |

#### Facultad de Actos de Administración

| **Campo**                          | **Variable**                                             | **Descripción**                                                                                                                        |
| ---------------------------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Nombre del poder de administración | `{key_person_1_power_administration_power_name}`         | Nombre del poder de actos de administración.                                                                                           |
| Tiene poder de administración      | `{key_person_1_power_administration_has_power}`          | Indica si la persona tiene el poder de actos de administración.                                                                        |
| Duración del poder                 | `{key_person_1_power_administration_duration}`           | Duración del poder de actos de administración.                                                                                         |
| Tipo de firma                      | `{key_person_1_power_administration_signature_type}`     | Indica el tipo de firma: `"joint"` para firma mancomunada o `"individual"` para firma individual del poder de actos de administración. |
| Límites del poder                  | `{key_person_1_power_administration_has_limits}`         | Indica si tiene límites el poder de actos de administración.                                                                           |
| Descripción de los límites         | `{key_person_1_power_administration_limits_description}` | Descripción del límite del poder de actos de administración.                                                                           |
| Condicional de firma conjunta      | `{key_person_1_power_administration_is_joint}`           | Condicional para renderizar contenido si el tipo de firma es conjunta: `{#key_person_1_power_administration_is_joint}M{/}`             |
| Condicional de firma individual    | `{key_person_1_power_administration_is_individual}`      | Condicional para renderizar contenido si el tipo de firma es individual: `{#key_person_1_power_administration_is_individual}I{/}`      |

#### Facultad de Actos de Dominio

| **Campo**                            | **Variable**                                                | **Descripción**                                                                                                                      |
| ------------------------------------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Nombre del poder de actos de dominio | `{key_person_1_power_assets_management_name}`               | Nombre del poder de actos de dominio.                                                                                                |
| Tiene poder de actos de dominio      | `{key_person_1_power_assets_management_has_power}`          | Indica si la persona tiene el poder de actos de dominio.                                                                             |
| Duración del poder                   | `{key_person_1_power_assets_management_duration}`           | Duración del poder de actos de dominio.                                                                                              |
| Tipo de firma                        | `{key_person_1_power_assets_management_signature_type}`     | Indica el tipo de firma: `"joint"` para firma mancomunada o `"individual"` para firma individual del poder de actos de dominio.      |
| Límites del poder                    | `{key_person_1_power_assets_management_has_limits}`         | Indica si tiene límites el poder de actos de dominio.                                                                                |
| Descripción de los límites           | `{key_person_1_power_assets_management_limits_description}` | Descripción del límite del poder de actos de dominio.                                                                                |
| Condicional de firma conjunta        | `{key_person_1_power_assets_management_is_joint}`           | Condicional para renderizar contenido si el tipo de firma es conjunta: `{#key_person_1_power_assets_management_is_joint}M{/}`        |
| Condicional de firma individual      | `{key_person_1_power_assets_management_is_individual}`      | Condicional para renderizar contenido si el tipo de firma es individual: `{#key_person_1_power_assets_management_is_individual}I{/}` |

#### Facultad para Otorgar Títulos de Crédito

| **Campo**                                        | **Variable**                                    | **Descripción**                                                                                                                             |
| ------------------------------------------------ | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Nombre del poder para otorgar títulos de crédito | `{key_person_1_power_loans_power_name}`         | Nombre del poder para otorgar títulos de crédito.                                                                                           |
| Tiene poder para otorgar títulos de crédito      | `{key_person_1_power_loans_has_power}`          | Indica si la persona tiene el poder para otorgar títulos de crédito.                                                                        |
| Duración del poder                               | `{key_person_1_power_loans_duration}`           | Duración del poder para otorgar títulos de crédito.                                                                                         |
| Tipo de firma                                    | `{key_person_1_power_loans_signature_type}`     | Indica el tipo de firma: `"joint"` para firma mancomunada o `"individual"` para firma individual del poder para otorgar títulos de crédito. |
| Límites del poder                                | `{key_person_1_power_loans_has_limits}`         | Indica si tiene límites el poder para otorgar títulos de crédito.                                                                           |
| Descripción de los límites                       | `{key_person_1_power_loans_limits_description}` | Descripción del límite del poder para otorgar títulos de crédito.                                                                           |
| Condicional de firma conjunta                    | `{key_person_1_power_loans_is_joint}`           | Condicional para renderizar contenido si el tipo de firma es conjunta: `{#key_person_1_power_loans_is_joint}M{/}`                           |
| Condicional de firma individual                  | `{key_person_1_power_loans_is_individual}`      | Condicional para renderizar contenido si el tipo de firma es individual: `{#key_person_1_power_loans_is_individual}I{/}`                    |

#### Facultad para Abrir o Cerrar Cuentas Bancarias

| **Campo**                                              | **Variable**                                            | **Descripción**                                                                                                                                   |
| ------------------------------------------------------ | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nombre del poder para abrir o cerrar cuentas bancarias | `{key_person_1_power_bank_accounts_power_name}`         | Nombre del poder para abrir o cerrar cuentas bancarias.                                                                                           |
| Tiene poder para abrir o cerrar cuentas bancarias      | `{key_person_1_power_bank_accounts_has_power}`          | Indica si la persona tiene el poder para abrir o cerrar cuentas bancarias.                                                                        |
| Duración del poder                                     | `{key_person_1_power_bank_accounts_duration}`           | Duración del poder para abrir o cerrar cuentas bancarias.                                                                                         |
| Tipo de firma                                          | `{key_person_1_power_bank_accounts_signature_type}`     | Indica el tipo de firma: `"joint"` para firma mancomunada o `"individual"` para firma individual del poder para abrir o cerrar cuentas bancarias. |
| Límites del poder                                      | `{key_person_1_power_bank_accounts_has_limits}`         | Indica si tiene límites el poder para abrir o cerrar cuentas bancarias.                                                                           |
| Descripción de los límites                             | `{key_person_1_power_bank_accounts_limits_description}` | Descripción del límite del poder para abrir o cerrar cuentas bancarias.                                                                           |
| Condicional de firma conjunta                          | `{key_person_1_power_bank_accounts_is_joint}`           | Condicional para renderizar contenido si el tipo de firma es conjunta: `{#key_person_1_power_bank_accounts_is_joint}M{/}`                         |
| Condicional de firma individual                        | `{key_person_1_power_bank_accounts_is_individual}`      | Condicional para renderizar contenido si el tipo de firma es individual: `{#key_person_1_power_bank_accounts_is_individual}I{/}`                  |

#### Información de Estado de Cuenta Bancario del Apoderado

| **Campo**               | **Variable**                          | **Descripción**                                                                            |
| ----------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------ |
| Nombre del banco        | `{key_person_1_source_bankName}`      | Nombre del banco del cual se cargó el estado de cuenta bancaria del apoderado.             |
| Número de cuenta        | `{key_person_1_source_accountNumber}` | Número de cuenta extraído de la carátula bancaria del apoderado.                           |
| Número de CLABE         | `{key_person_1_source_clabeNumber}`   | Número de CLABE extraído de la carátula bancaria del apoderado.                            |
| Tipo de moneda          | `{key_person_1_source_currency}`      | Tipo de moneda extraído de la carátula bancaria del apoderado.                             |
| RFC                     | `{key_person_1_source_rfc}`           | Número de RFC extraído de la carátula bancaria del apoderado.                              |
| Dirección del apoderado | `{key_person_1_bankAddress}`          | Dirección del apoderado de la carátula bancaria más reciente de donde se capturó el valor. |

#### Domicilio del Representante Legal

| **Campo**                                     | **Variable**                                        | **Descripción**                                                                                                       |
| --------------------------------------------- | --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Dirección comercial                           | `{key_person_1_comercialAddress}`                   | Dirección comercial del apoderado capturada del comprobante de domicilio (facturas de servicios o carátula bancaria). |
| Fecha de expedición de la dirección comercial | `{key_person_1_comercialAddress_source_date}`       | Fecha de expedición o fecha final del periodo de facturación del comprobante de domicilio o carátula bancaria.        |
| Día de la fecha de expedición                 | `{key_person_1_comercialAddress_source_date_day}`   | Día de la fecha de expedición de la dirección comercial.                                                              |
| Mes de la fecha de expedición                 | `{key_person_1_comercialAddress_source_date_month}` | Mes de la fecha de expedición de la dirección comercial.                                                              |
| Año de la fecha de expedición                 | `{key_person_1_comercialAddress_source_date_year}`  | Año de la fecha de expedición de la dirección comercial.                                                              |
| Dirección fiscal                              | `{key_person_1_fiscalAddress}`                      | Dirección fiscal del apoderado capturada del QR de la constancia de situación fiscal o del documento de la CSF.       |
| Fecha de expedición de la dirección fiscal    | `{key_person_1_fiscalAddress_source_date}`          | Fecha de expedición de la constancia de situación fiscal más actualizada.                                             |
| Día de la fecha de expedición de la fiscal    | `{key_person_1_fiscalAddress_source_date_day}`      | Día de la fecha de expedición de la constancia de situación fiscal.                                                   |
| Mes de la fecha de expedición de la fiscal    | `{key_person_1_fiscalAddress_source_date_month}`    | Mes de la fecha de expedición de la constancia de situación fiscal.                                                   |
| Año de la fecha de expedición de la fiscal    | `{key_person_1_fiscalAddress_source_date_year}`     | Año de la fecha de expedición de la constancia de situación fiscal.                                                   |