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 Description para la transacción
(Opcional) Especifica un Accounting route group para clasificación
Ingresa el Value (monto) a transferir
Selecciona el Asset para la transacción

Haz clic en Next para continuar al paso de selección de cuentas.

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 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 Next 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 descripciones y metadatos opcionales

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

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 enviarla y ver los detalles de 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 abre la página de detalles de la transacción con el resumen, los datos y el estado 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`
Accounting route group	Clasificación de ruta opcional cuando tu configuración usa validación o agrupación de rutas.	`Pix Transfer Group`
Transaction Route	Selecciona la Ruta de transacción asociada con 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`

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`
Chart of accounts	Nombre opcional del Plan de cuentas al que pertenece la operación.	`Pix debit - source`
Operation Route	Ruta de operación opcional para 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 pestaña 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.