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

> Crea una nueva Transacción en la Console usando el asistente 1:1 o n:n para mover saldos de Activos entre Cuentas de origen y destino por alias.

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

***

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

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

  <Step>
    Después de 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) 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
      </Step>

      <Step>
        Haz clic en **Next** para continuar 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 agregar varios orígenes o destinos

        <Warning>
          **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](/es/products/midaz/console/editing-account-information).
        </Warning>
      </Step>

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

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

        <Note>
          En las transacciones complejas, la suma de todos los montos de origen debe ser igual a la suma de todos los montos 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 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
  </Step>

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

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

<Tip>
  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.
</Tip>

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

<CardGroup cols={2}>
  <Card title="Crear una Transacción con JSON" icon="code" href="/es/reference/products/midaz/v1/create-transaction-json">
    Crea una Transacción mediante programación con el endpoint JSON.
  </Card>

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