Crear un Ledger

Configura un nuevo Ledger dentro de tu Organización desde la Console para registrar otro flujo de Transacciones con segregación total de saldos y datos.

Un Ledger aísla Activos, Cuentas, Rutas y Transacciones en un mismo espacio de trabajo contable. Crea un nuevo Ledger cuando necesites un dominio de saldos, una línea de producto, un entorno o un modelo contable separado.

​

Antes de comenzar

---

Necesitas una Organización existente. Si es la primera configuración, crea primero la Organización en Crear una Organización.

Define qué representa el límite del Ledger antes de crearlo. No uses un mismo Ledger para productos no relacionados que requieran estructuras de cuentas, rutas o controles operativos distintos.

​

Crear el Ledger

---

1. Desde la página Ledgers, haz clic en el botón New Ledger en la esquina superior derecha.

2. Aparece el formulario New Ledger.

3. En la pestaña Ledger Details, ingresa el nombre del Ledger en el campo Ledger Name.

4. (Opcional) Para incluir metadatos, selecciona la pestaña Metadata. Esta pestaña muestra dos campos: Key y Value.

   • Para añadir más metadatos, haz clic en el icono de más (+) junto a la primera fila.
5. (Opcional) Selecciona la pestaña Settings para configurar las reglas de validación de este Ledger.

   • Activa Validate Account Type si las Cuentas deben usar Tipos de Cuenta registrados.
   • Activa Validate Routes si las Transacciones deben seguir Rutas Contables preconfiguradas.
6. Después de completar el formulario, haz clic en Save.

7. Aparece un mensaje de éxito en la esquina superior derecha. La página principal de Ledgers ahora muestra el nuevo Ledger.

​

Guía de campos

---

Campo	Qué ingresar	Ejemplo
Ledger Name	Un nombre claro para el espacio de trabajo contable. Usa un nombre que refleje el producto, país, entorno o límite de negocio.	Brazil Payments Ledger
Metadata Key	Nombre opcional de campo para clasificación o integración.	environment
Metadata Value	Valor para la clave de metadato.	production
Validate Account Type	Configuración opcional. Actívala cuando cada Cuenta no externa en este Ledger deba usar un Tipo de Cuenta previamente registrado. Déjala desactivada si aún no clasificarás las Cuentas por tipo.	Enabled
Validate Routes	Configuración opcional. Actívala solo después de planificar o configurar las Rutas Contables de este Ledger, porque cuando está habilitada las Transacciones deben coincidir con una ruta válida.	Disabled

Los campos de la pestaña Metadata son abiertos. La pestaña no tiene claves ni valores predefinidos. Usa nombres de clave consistentes en toda tu Organización, como environment, businessLine o region, para poder filtrar y auditar Ledgers más adelante.

​

Configuración del Ledger

---

La pestaña Settings controla las reglas de validación de este Ledger.

​

Validate Account Type

Cuando activas esta configuración, cada nueva Cuenta no externa debe usar un Tipo de Cuenta registrado para este Ledger. Actívala cuando quieras que los operadores clasifiquen las Cuentas de forma consistente, por ejemplo: customer, merchant, treasury o fee.

Después de que actives Validate Account Type, el Ledger rechaza cualquier Cuenta no externa sin un Tipo de Cuenta válido.

​

Validate Routes

Cuando activas esta configuración, las Transacciones deben coincidir con las Rutas Contables configuradas para este Ledger. Actívala solo después de planificar o configurar tu modelo de rutas.

Si activas Validate Routes antes de que existan rutas, cualquier Transacción sin una ruta coincidente no supera la validación.

​

Próximos pasos

---

Después de crear el Ledger:

1. Verifica si Validate Account Type y Validate Routes son adecuados para este Ledger.
2. Crea al menos un Activo siguiendo Crear un Activo.
3. Si necesitas cambiar las reglas de validación más adelante, usa la pestaña Settings descrita en Gestionar Ledgers.

Equivalente en la API

Endpoint Create a Ledger