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