> ## 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 en tu Ledger.

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, 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

***

<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** que se usará en 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. Asegúrate de guardarlo al crear la cuenta.

          Si lo olvidas, puedes encontrarlo [editando la información de la cuenta](/es/lerian-console/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), 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

        <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>
    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)
  </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>
    Al tener éxito, serás redirigido a la página de detalles de la transacción mostrando 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. Incluye el prefijo `@`.   | `@customer_123` |
| Destination | Alias de la cuenta que será acreditada. Incluye el prefijo `@`. | `@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)
* Los importes pueden distribuirse 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 predefinidos. 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>
