> ## 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.
# Licencia de Lerian
> Las licencias autorizan el acceso a productos y plugins pagos de Lerian, con tipos de licencia por organización y globales.
Una **licencia** es una clave que autoriza el acceso a características o servicios de Lerian bajo condiciones contractuales específicas, típicamente alineadas con ciclos de facturación (por ejemplo, mensual, anual). Este mecanismo es similar a cómo los productos de software como Microsoft Office o GitHub Enterprise gestionan el acceso a través de claves de activación.
En el ecosistema de Lerian, las licencias juegan un papel crítico en:
* Asegurar que los clientes estén al día antes de acceder a características de pago, como **productos**, **plugins o características empresariales**.
* Gestionar qué características están disponibles por cliente.
* Permitir que Lerian escale las operaciones de soporte y ventas de manera segura y eficiente.
En resumen, solo los clientes con licencias válidas, según lo definido en sus contratos, pueden acceder a componentes de software específicos.
Una licencia válida debe estar asociada con la organización que realiza la solicitud. De lo contrario, el acceso será denegado.
## Tipos de licencia
***
En el ecosistema de Lerian, las licencias pueden tener dos alcances diferentes, dependiendo del plugin:
### Licencias específicas de organización (no globales)
Se aplica a una **única organización**.
Ejemplo: **Fees Engine**, **CRM**, **Reporter**.
Puedes usar la licencia con cualquier número de ledgers dentro de esa organización.
### Licencias globales
Válidas para **múltiples organizaciones**.
Ejemplo: **Access Manager.**
## Flujo de uso de licencias
***
Los pasos a continuación se aplican a ambos tipos de licencia:
* **Para plugins específicos de organización**: proporciona el `organization_id` que utilizará la licencia.
* **Para plugins globales**: informa a Lerian que necesitas una licencia global; no se requiere `organization_id`.
El equipo de Lerian sigue el proceso interno para crear y activar la licencia utilizando los detalles proporcionados.
Lerian envía la **Clave de Licencia** (`LICENSE_KEY`) al cliente.
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**.
Siempre configura las variables de entorno correctas antes de usar un plugin. Valores incorrectos o faltantes resultarán en errores de validación de licencia.
**Licencias específicas de organización (no globales)**
Estas licencias se aplican solo a una organización.
```bash Bash theme={null}
# LICENSE
LICENSE_KEY=
ORGANIZATION_IDS=,
```
* **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`.
```bash Bash theme={null}
# LICENSE
LICENSE_KEY=
ORGANIZATION_IDS=global
```
* **LICENSE\_KEY**: La clave proporcionada por Lerian.
* **ORGANIZATION\_IDS**: Debe establecerse como `global` para licencias globales.
## Errores relacionados con licencias
***
Cuando una licencia es inválida o ha expirado, las respuestas de la API o comportamientos de plugins pueden devolver uno de los siguientes mensajes de error específicos:
| Código | Título | Mensaje |
| :------- | :------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| LCS-0001 | Internal server error | An internal server error occurred. Please try again later or contact support if the problem persists. |
| LCS-0002 | No organization IDs configured | The application is not configured with any organization IDs. |
| LCS-0003 | No valid licenses found for any organization | No valid licenses were found for any of the configured organizations. Please check your license keys and ensure at least one organization has a valid license. |
| LCS-0010 | Organization ID header is missing | The X-Organization-ID header is missing. Please ensure the header is included in the request. |
| LCS-0011 | Organization ID header is unknown | The organization ID '12345' was not found in the list of configured organizations. Please verify you are using a valid organization ID. |
| LCS-0012 | Failed to validate organization license | License validation failed for organization ID 12345. This could be due to network issues, invalid license keys, or server-side problems. Please verify your license key is correct and that you have network connectivity to the license server. |
| LCS-0013 | Organization license is invalid | The license for organization ID '12345' is not valid and has no grace period active. Please renew your license or contact support for assistance. |
| LCS-1001 | Validation error | Could not validate license key. Please try again later or contact your system administrator. |
| LCS-1002 | License not found | There is no license for this license key. |
| LCS-1003 | License expired | The license key has expired. |
| LCS-1004 | License suspended | The license key has been suspended due to payment issues or administrative action. |
| LCS-1005 | Fingerprint mismatch | The license key or organization ID are not valid for this license. |
| LCS-1006 | Product mismatch | There is no license for this product. |
Para más información sobre tu licencia o para solicitar una actualización, por favor contacta al equipo comercial de Lerian.