Una Transacción mueve valor entre Cuentas en un Ledger. Créala solo cuando el Activo, la cuenta de origen, la cuenta de destino y cualquier Ruta Contable requerida estén listos.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.
Antes de empezar
Confirma que:
- Las Cuentas de origen y destino existen en el Ledger seleccionado.
- Ambas Cuentas usan el Activo seleccionado para la Transacción.
- Conoces el alias de cada Cuenta, incluido el prefijo
@. - Las cuentas de origen permiten enviar y las cuentas de destino permiten recibir.
- Si Validate Routes está habilitado, la Transacción coincide con una Ruta Contable existente.
Crear la Transacción
Se abrirá el modal New Transaction. Selecciona el tipo de transacción que quieres crear:
- Simple 1:1 - Transacciones con un origen y un destino
- Complex n:n - Transacciones con más de un origen o destino
Tras seleccionar el tipo de transacción, se abre la página New Transaction con un formulario paso a paso:
Transaction Data
Completa la información básica de la transacción:
- (Opcional) Añade una Description para la transacción
- (Opcional) Especifica un Accounting route group para clasificación
- Introduce el Value (importe) a transferir
- Selecciona el Asset que se usará en la transacción
Source and Destination
Especifica las cuentas involucradas:
- Busca la cuenta de origen por alias y selecciónala
- Busca la cuenta de destino por alias y selecciónala
- Para transacciones complejas, puedes añadir múltiples orígenes y/o destinos
Operations
Revisa y ajusta los detalles de la operación:
- En transacciones simples (1:1), los importes se completan automáticamente
- En transacciones complejas (n:n), especifica el importe para cada origen (débito) y destino (crédito)
- Expande cada operación para añadir descripciones y metadatos opcionales
En las transacciones complejas, la suma de todos los importes de origen debe ser igual a la suma de todos los importes de destino.
Se mostrará una página de revisión con un resumen de toda la información de la transacción:
- Valor y Activo de la transacción
- Cuentas de origen y destino
- Operaciones individuales de débito y crédito
- Registros de metadatos (si los hay)
Revisa la información cuidadosamente. Si todo es correcto:
- Haz clic en Send Transaction para enviar y ver los detalles de la transacción
- Haz clic en Send and Create another para enviar e iniciar inmediatamente una nueva transacción
Guía de campos
| Campo | Qué introducir | Ejemplo |
|---|---|---|
| Transaction type | Elige Simple 1:1 para un origen y un destino, o Complex n:n para múltiples orígenes o destinos. | Simple 1:1 |
| Description | Descripción de negocio opcional del movimiento. | Customer payment to merchant |
| Accounting route group | Clasificación opcional de ruta cuando tu configuración usa validación o agrupación de rutas. | Pix Transfer Route |
| Value | Importe total a mover. En transacciones complejas, los totales de origen deben ser iguales a los de destino. | 100.00 |
| Asset | Activo usado por la Transacción. Debe coincidir con las Cuentas seleccionadas. | BRL |
| Source account | Alias de la cuenta que será debitada. Incluye el prefijo @. | @customer_123 |
| Destination account | Alias de la cuenta que será acreditada. Incluye el prefijo @. | @merchant_456 |
| Operation amount | Importe asignado a cada operación de origen o destino. Requerido en transacciones complejas. | 100.00 |
| Metadata Key | Nombre opcional de campo para clasificación o integración. | externalReference |
| Metadata Value | Valor para la clave de metadatos. | order_98765 |
Tipos de transacción explicados
Simple Transaction (1:1)
Úsala para transferencias directas entre dos cuentas:- Una cuenta de origen (débito)
- Una cuenta de destino (crédito)
- Mismo importe debitado y acreditado
Complex Transaction (n:n)
Úsala para transacciones que involucran múltiples partes:- Múltiples cuentas de origen (débitos) y/o múltiples cuentas de destino (créditos)
- Los importes pueden distribuirse entre cuentas
- El total de débitos debe ser igual al total de créditos
- Pago con tarifas:
- El cliente paga $103
- El comercio recibe $100
- La cuenta de tarifas recibe $3
- Pago consolidado: Múltiples clientes financian un único pago a proveedor
Qué hacer a continuación
Tras enviar la Transacción, revisa la página de detalles y confirma el estado, la operación de origen, la operación de destino y los saldos de las cuentas.
Crear una Transaction con JSON
Crea una Transacción programáticamente con el endpoint JSON.
Recuperar una Transaction
Inspecciona el estado y las operaciones de la Transacción mediante la API.