Crear una Transacción

Una Transacción mueve valor entre Cuentas de un Ledger. Créala solo después de que el Activo, la cuenta de origen, la cuenta de destino y cualquier Ruta contable requerida estén listos.

Antes de empezar

Confirma lo siguiente:

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. Un @ inicial es una convención común, no un requisito.
Las cuentas de origen permiten enviar y las cuentas de destino permiten recibir.
Si Validate Routes está activado, la Transacción debe coincidir con una Ruta contable existente.

Crea la Transacción

Desde la página Transactions, haz clic en el botón New Transaction.

Se abrirá la ventana modal New Transaction. Selecciona el tipo de transacción que deseas crear:

Simple 1:1 - Transacciones que usan un origen y un destino
Complex n:n - Transacciones que usan más de un origen o destino

Después de 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) Agrega una Transaction description
Si Validate Routes está activado, selecciona la Transaction Route
Ingresa el Value (monto) a transferir
Selecciona el Asset para la transacción
(Opcional) Activa Skip fees para registrar la transacción sin ejecutar el Fees Engine. El interruptor aparece solo cuando el Ledger permite omitir tarifas

Haz clic en Continue to the next step para continuar al paso de selección de cuentas.

Source / 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 agregar varios orígenes o destinos

Debes usar el alias de la cuenta para hacer transacciones. Confirma que lo guardas cuando creas tu cuenta.Si olvidas tu alias, puedes encontrarlo editando la información de la cuenta.

Haz clic en Continue to the next step para continuar al paso de operaciones.

Operations

Revisa y ajusta los detalles de la operación:

Para transacciones simples (1:1), la Console completa los montos automáticamente
Para transacciones complejas (n:n), especifica el monto de cada origen (débito) y destino (crédito)
Expande cada operación para agregar una Operation description opcional. Si Validate Routes está activado, selecciona su Operation Route. El selector marca las rutas de operación opcionales con una insignia Optional
Agrega metadatos en la sección Transaction Metadata

En las transacciones complejas, la suma de todos los montos de origen debe ser igual a la suma de todos los montos de destino.

Si Validate Routes está activado, la Console verifica la Ruta de transacción en Go to Review. Verifica la ruta de nuevo al enviar. Selecciona cada ruta de operación obligatoria con asientos Direct Transaction en al menos una operación de su lado. Una ruta Bidirectional puede estar en cualquier lado.

Cuando toda la información sea correcta, haz clic en el botón Go to Review.

La Console muestra 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 con cuidado. Si todo es correcto:

Haz clic en Send Transaction para enviar la transacción
Haz clic en Send and Create another para enviarla y empezar de inmediato una nueva transacción

Si la operación es exitosa, la Console muestra Transaction created con las operaciones que el Ledger registró. Haz clic en View Transaction para abrir la página de detalles de la transacción.

Guía de campos

Transaction Data

Campo	Qué ingresar	Ejemplo
Transaction description	Descripción de negocio opcional del movimiento.	`Customer payment to merchant`
Transaction Route	Aparece cuando Validate Routes está activado. Selecciona la Ruta de transacción con la que debe coincidir la Transacción.	`Pix Transfer Route`
Asset	Activo usado por la Transacción. Debe coincidir con las Cuentas seleccionadas.	`BRL`
Value	Monto total a mover. En las transacciones complejas, los totales de origen deben ser iguales a los totales de destino.	`100.00`
Skip fees	Aparece cuando el Ledger permite omitir tarifas. Actívalo para registrar la Transacción sin ejecutar el Fees Engine.	`Disabled`

Source / Destination

Campo	Qué ingresar	Ejemplo
Source	Alias de la cuenta que será debitada.	`@customer_123`
Destination	Alias de la cuenta que será acreditada.	`@merchant_456`

Operations

Campo	Qué ingresar	Ejemplo
Operation description	Descripción opcional de la operación.	`Debit for the source account`
Operation Route	Aparece cuando Validate Routes está activado. Selecciona la Ruta de operación con la que debe coincidir este tramo de la transacción.	`Checking account validation for Pix`
Metadata Key	Nombre de campo opcional para clasificación o integración.	`externalReference`
Metadata Value	Valor para la clave de metadatos.	`order_98765`

Tipos de Transacción explicados

Transacción simple (1:1)

Úsala para transferencias directas entre dos cuentas:

Una cuenta de origen (débito)
Una cuenta de destino (crédito)
El mismo monto debitado y acreditado

Ejemplo: Transfiere $100 del Cliente A al Comercio B.

Transacción compleja (n:n)

Úsala para transacciones que involucran a varias partes:

Varias cuentas de origen (débitos) o varias cuentas de destino (créditos)
Puedes distribuir los montos entre las cuentas
El total de los débitos debe ser igual al total de los créditos

Ejemplos:

Pago con comisión:
- El cliente paga $103
- El comercio recibe $100
- La cuenta de comisión recibe $3
Pago consolidado: varios clientes financian un pago único a un proveedor

Los campos de la sección Transaction Metadata son abiertos. No hay claves ni valores predeterminados. Usa nombres de clave consistentes en toda tu Organización, como externalReference, orderId o channel, para vincular las Transacciones con los sistemas de origen para conciliación y auditoría.

Qué hacer a continuación

Después de 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.