Saltar al contenido principal
Un Ledger es el espacio de trabajo contable donde se aíslan Activos, Cuentas, Rutas y Transacciones. 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. Evita usar un mismo Ledger para productos no relacionados si requieren 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
Aparecerá 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. Se mostrarán 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
Aparecerá un mensaje de éxito en la esquina superior derecha de la pantalla, y el nuevo Ledger se agregará a la lista en la página principal de Ledgers.

​
Guía de campos

Los campos de la pestaña Metadata son abiertos. No hay 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 del Ledger que estás creando.

​
Validate Account Type

Cuando esta configuración está habilitada, cada nueva Cuenta en este Ledger debe usar un Tipo de Cuenta previamente registrado para el Ledger. Actívala cuando quieras que los operadores clasifiquen las Cuentas de forma consistente, por ejemplo: customer, merchant, treasury o fee.
Una vez habilitado Validate Account Type, las Cuentas sin un Tipo de Cuenta válido serán rechazadas.

​
Validate Routes

Cuando esta configuración está habilitada, las Transacciones deben coincidir con las Rutas Contables configuradas para este Ledger. Actívala solo cuando el modelo de rutas ya esté planificado o configurado.
Si Validate Routes se habilita antes de que existan rutas, las Transacciones que no coincidan con una ruta disponible no superarán 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