> ## 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.

# Crear una Transacción

> Registra una nueva Transacción en la Console para mover saldos de Activo entre Cuentas del Ledger cumpliendo partida doble y las Rutas Contables activas.

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.

## 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.
* 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.

## Crear la Transacción

***

<Steps>
  <Step>
    Desde la página **Transactions**, haz clic en el botón **New Transaction**.
  </Step>

  <Step>
    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
  </Step>

  <Step>
    Tras seleccionar el tipo de transacción, se abre la página **New Transaction** con un formulario paso a paso:

    <Steps>
      <Step title="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** para la transacción
      </Step>

      <Step>
        Haz clic en **Next** para avanzar al paso de selección de cuentas.
      </Step>

      <Step title="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

        <Warning>
          **Debes** usar el alias de la cuenta para realizar transacciones. Guárdalo al crear la cuenta.

          Si lo olvidas, puedes encontrarlo [editando la información de la cuenta](/es/midaz/console/editing-account-information).
        </Warning>
      </Step>

      <Step>
        Haz clic en **Next** para avanzar al paso de operaciones.
      </Step>

      <Step title="Operations">
        Revisa y ajusta los detalles de la operación:

        * En transacciones simples (1:1), la Console completa los importes 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

        <Note>
          En las transacciones complejas, la suma de todos los importes de origen debe ser igual a la suma de todos los importes de destino.
        </Note>
      </Step>
    </Steps>
  </Step>

  <Step>
    Cuando toda la información sea correcta, haz clic en el botón **Go to Review**.
  </Step>

  <Step>
    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)
  </Step>

  <Step>
    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
  </Step>

  <Step>
    En caso de éxito, la Console abre la página de detalles de la transacción con el resumen, los datos y el estado.
  </Step>
</Steps>

## Guía de campos

***

**Transaction Data**

| Campo                   | Qué introducir                                                                                               | Ejemplo                        |
| ----------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------ |
| Transaction 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 Group`           |
| Transaction Route       | Selecciona la Transaction Route asociada con la transacción.                                                 | `Pix Transfer Route`           |
| Asset                   | Activo usado por la Transacción. Debe coincidir con las Cuentas seleccionadas.                               | `BRL`                          |
| Value                   | Importe total a mover. En transacciones complejas, los totales de origen deben ser iguales a los de destino. | `100.00`                       |

**Source/Destination**

| Campo       | Qué introducir                          | Ejemplo        |
| ----------- | --------------------------------------- | -------------- |
| Source      | Alias de la cuenta que será debitada.   | `customer_123` |
| Destination | Alias de la cuenta que será acreditada. | `merchant_456` |

**Operations**

| Campo                 | Qué introducir                                                     | Ejemplo                               |
| --------------------- | ------------------------------------------------------------------ | ------------------------------------- |
| Operation description | Descripción opcional para 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 esta parte de la transacción.      | `Checking account validation for Pix` |
| 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

**Ejemplo**: Transferir \$100 del Customer A al Merchant B.

### 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)
* Puedes distribuir los importes entre cuentas
* El total de débitos debe ser igual al total de créditos

**Ejemplos**:

* 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

<Tip>
  Los campos en la pestaña Metadata son abiertos. No hay claves ni valores predeterminados. Usa nombres de claves 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.
</Tip>

## 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.

<CardGroup cols={2}>
  <Card title="Crear una Transaction con JSON" icon="code" href="/es/reference/midaz/create-a-transaction-using-json">
    Crea una Transacción programáticamente con el endpoint JSON.
  </Card>

  <Card title="Recuperar una Transaction" icon="file-search" href="/es/reference/midaz/retrieve-a-transaction">
    Inspecciona el estado y las operaciones de la Transacción mediante la API.
  </Card>
</CardGroup>