> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# La licencia de Lerian

> Las licencias de Lerian autorizan el acceso a productos y plugins pagos con tipos de licencia con alcance de organización y globales, además de reglas de activación y validación.

Una **licencia** es una clave que autoriza el acceso a las funciones o los servicios de Lerian bajo condiciones contractuales específicas, generalmente alineadas con los ciclos de facturación (por ejemplo, mensual, anual). Este mecanismo es similar a como productos de software como Microsoft Office o GitHub Enterprise gestionan el acceso mediante claves de activación.

En el ecosistema de Lerian, las licencias:

* Confirman que los clientes estén al día antes de acceder a funciones pagas, como **productos**, **plugins o funciones empresariales**.
* Gestionan qué funciones están disponibles por cliente.
* Permiten que Lerian escale las operaciones de soporte y ventas.

Solo los clientes con licencias válidas, según lo definido en sus contratos, pueden acceder a componentes específicos del software.

<Danger>
  La organización que hace la solicitud debe tener una licencia válida. De lo contrario, se denegará el acceso.
</Danger>

## Tipos de licencia

***

En el ecosistema de Lerian, las licencias pueden tener dos alcances diferentes, según el plugin:

### Licencias específicas de la organización (no globales)

Se aplica a una **sola organización**.

Ejemplo: **Fees Engine**, **Reporter**.

<Tip>
  Puedes usar la licencia con cualquier cantidad de ledgers dentro de esa organización.
</Tip>

### Licencias globales

Válida para **varias organizaciones**.

Ejemplo: **Access Manager.**

## Flujo de uso de la licencia

***

Los siguientes pasos se aplican a ambos tipos de licencia:

<Steps>
  <Step title="Envía una solicitud de licencia a Lerian.">
    * **Para plugins específicos de la organización**: proporciona el `organization_id` que usará la licencia.
    * **Para plugins globales**: informa a Lerian que necesitas una licencia global. No necesitas un `organization_id`.
  </Step>

  <Step title="Generación y activación de la licencia por parte de Lerian">
    El equipo de Lerian sigue el proceso interno para crear y activar la licencia con los datos proporcionados.
  </Step>

  <Step title="Entrega de la clave de licencia">
    Lerian envía la **clave de licencia** (`LICENSE_KEY`) al cliente.
  </Step>

  <Step title="Configuración del entorno">
    Una vez que recibas tu clave de licencia, debes configurar tu archivo `.env` para que el sistema sepa **qué licencia validar** y **a qué organizaciones se aplica**.
  </Step>
</Steps>

<Warning>
  Configura siempre las variables de entorno correctas antes de usar un plugin. Los valores incorrectos o faltantes generarán errores de validación de la licencia.
</Warning>

**Licencias específicas de la organización (no globales)**

Estas licencias se aplican a una sola organización.

<CodeGroup>
  ```bash Bash theme={null}
  # LICENSE
  LICENSE_KEY=<license key>
  ORGANIZATION_IDS=<organization-id1>,<organization-id2>
  ```
</CodeGroup>

* **LICENSE\_KEY**: la clave proporcionada por Lerian.
* **ORGANIZATION\_IDS**: el ID de la organización vinculada a la licencia.

**Licencias globales**

Estas licencias tienen un alcance global y deben usar **siempre** el valor `global` en la variable `ORGANIZATION_IDS`.

<CodeGroup>
  ```bash Bash theme={null}
  # LICENSE
  LICENSE_KEY=<license key>
  ORGANIZATION_IDS=global
  ```
</CodeGroup>

* **LICENSE\_KEY**: la clave proporcionada por Lerian.
* **ORGANIZATION\_IDS**: usa el valor `global` para las licencias globales.

## Errores relacionados con la licencia

***

Para una licencia no válida o expirada, las respuestas de la API o el comportamiento de los plugins pueden devolver uno de estos mensajes de error:

| Code     | Title                                                         | Message                                                                                                                                                                                                                                                                                    |
| :------- | :------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| LCS-0001 | Error interno del servidor                                    | Se produjo un error interno del servidor. Vuelve a intentarlo más tarde o contacta al soporte si el problema persiste.                                                                                                                                                                     |
| LCS-0002 | No hay IDs de organización configurados                       | La aplicación no está configurada con ningún ID de organización.                                                                                                                                                                                                                           |
| LCS-0003 | No se encontraron licencias válidas para ninguna organización | No se encontraron licencias válidas para ninguna de las organizaciones configuradas. Verifica tus claves de licencia y confirma que al menos una organización tenga una licencia válida.                                                                                                   |
| LCS-0010 | Falta el encabezado del ID de organización                    | Falta el encabezado X-Organization-ID. Confirma que el encabezado esté incluido en la solicitud.                                                                                                                                                                                           |
| LCS-0011 | El encabezado del ID de organización es desconocido           | El ID de organización '12345' no se encontró en la lista de organizaciones configuradas. Verifica que estés usando un ID de organización válido.                                                                                                                                           |
| LCS-0012 | No se pudo validar la licencia de la organización             | La validación de la licencia falló para el ID de organización 12345. Esto puede deberse a problemas de red, claves de licencia no válidas o problemas del lado del servidor. Verifica que tu clave de licencia sea correcta y que tengas conectividad de red con el servidor de licencias. |
| LCS-0013 | La licencia de la organización no es válida                   | La licencia para el ID de organización '12345' no es válida y no tiene un período de gracia activo. Renueva tu licencia o contacta al soporte para obtener ayuda.                                                                                                                          |
| LCS-1001 | Error de validación                                           | No se pudo validar la clave de licencia. Vuelve a intentarlo más tarde o contacta a tu administrador del sistema.                                                                                                                                                                          |
| LCS-1002 | Licencia no encontrada                                        | No hay ninguna licencia para esta clave de licencia. Confirma que la clave de licencia sea correcta y vuelve a intentarlo.                                                                                                                                                                 |
| LCS-1003 | Licencia expirada                                             | La clave de licencia expiró. Contacta a tu administrador del sistema para renovar tu licencia.                                                                                                                                                                                             |
| LCS-1004 | Licencia suspendida                                           | La clave de licencia se suspendió por problemas de pago o una acción administrativa. Contacta a tu administrador del sistema.                                                                                                                                                              |
| LCS-1005 | Discrepancia de huella digital                                | La clave de licencia o los IDs de organización no son válidos para esta licencia. Confirma que la clave de licencia y los IDs de organización sean correctos y vuelve a intentarlo.                                                                                                        |
| LCS-1006 | Discrepancia de producto                                      | No hay ninguna licencia para este producto. Confirma que la clave de licencia sea correcta y vuelve a intentarlo.                                                                                                                                                                          |

<Tip>
  Para obtener más información sobre tu licencia o solicitar una actualización, contacta al equipo comercial de Lerian.
</Tip>
