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

# Operaciones

> Comprende las Operaciones como las unidades más pequeñas de actividad del ledger en Midaz: asientos individuales de débito o crédito en una Cuenta, agrupados en Transacciones balanceadas.

Una operación es la unidad más pequeña de una transacción. Cada transacción contiene dos o más operaciones (*Figura 1*). Cada operación registra un cambio en el saldo de una cuenta:

* Una **operación de débito** registra el valor que sale **de** una cuenta (el origen).
* Una **operación de crédito** registra el valor que entra **a** una cuenta (el destino).

El efecto en el saldo almacenado depende de la `direction` del saldo. Una cuenta normal (el caso común) se reduce con un débito y aumenta con un crédito.

Una transacción contiene operaciones que deben sumar cero desde la perspectiva del ledger. Por ejemplo, un pago P2P con una comisión incluye:

* un **débito de \$100** de la cuenta del remitente.
* un **crédito de \$98** a la cuenta del destinatario.
* un **crédito de \$2** a la cuenta de comisión de la plataforma.

Midaz se asegura de que una transacción balancee antes de confirmarla.

Las operaciones también llevan metadatos como marcas de tiempo y referencias a la transacción a la que pertenecen. Creas una transacción a través de la API JSON de Midaz. Para cada transacción, especificas un conjunto de operaciones. Cada operación tiene un monto, un activo y una cuenta de origen o destino.

## Características clave

***

* Cada operación pertenece a una transacción y hace referencia a una cuenta y un activo específicos.
* Las operaciones incluyen metadatos como monto, dirección (débito/crédito), tipo, marcas de tiempo, referencias y más.
* Midaz crea las operaciones cuando empiezas una transacción y las completa con los datos que proporcionas.
* Midaz valida todas las operaciones según las reglas configuradas antes de confirmarlas en el ledger.

<Note>
  Cada operación tiene una **`direction`** (`debit` o `credit`) y un **`type`**. La `direction` es la columna vertebral de partida doble descrita anteriormente. El `type` clasifica el movimiento. Además de los valores estándar `CREDIT` y `DEBIT`, el `type` marca movimientos especiales:

  * `ON_HOLD` y `RELEASE`: reservas de fondos en dos fases.
  * `OVERDRAFT`: operaciones complementarias generadas por el sistema en el saldo interno de sobregiro.
  * `BLOCK` y `UNBLOCK`: la etiqueta aplicada a cada operación de una transacción creada a través de los [endpoints dedicados de bloqueo y desbloqueo](/es/products/midaz/transactions#blocking-and-unblocking-funds). La etiqueta reemplaza solo el `type` de la operación, nunca su dirección ni su monto.

  La `direction` siempre conserva su significado de débito o crédito, sin importar el `type`.
</Note>

## Rutas de Operación

***

Con las Rutas Contables, cada operación se conecta a una lógica de validación estructurada. Esa lógica vive en [Rutas de Operación](/es/products/midaz/transaction-routing-entities).

### ¿Qué es una Ruta de Operación?

Una **Ruta de Operación** es una regla de validación. Define qué tipos de cuenta o cuentas específicas puede usar un componente de la transacción. También establece la dirección contable (origen o destino) y una anotación descriptiva.

Es una capa de validación entre la entrada de la transacción y la estructura del ledger. Cada operación que envías debe cumplir con los requisitos de cuenta y las reglas de negocio.

<Note>
  Las transacciones contienen varias operaciones. Las Rutas de Operación validan cada operación según las reglas de validación configuradas.
</Note>

### Relación Operación > Ruta de Operación

Cuando envías una transacción a Midaz, esta contiene varias **Operaciones**. Con **los Tipos de Cuenta y las Rutas Contables habilitados**, Midaz valida cada operación según las reglas de las Rutas de Operación. Esto garantiza que:

* La cuenta especificada coincide con el tipo de cuenta esperado o con el requisito de cuenta específica.
* La dirección de la operación (débito/crédito) coincide con la definición de la ruta.

<Danger>
  Si las operaciones que envías no coinciden con los requisitos configurados de la Ruta de Operación, Midaz falla la validación y rechaza la transacción.
</Danger>

## Gestión de Operaciones

***

Midaz genera las operaciones automáticamente como parte del flujo de una transacción. No puedes crear una operación directamente. Puedes consultar una operación cuando lo necesites.

* [Listar Operaciones por Cuenta](/es/reference/products/midaz/v2/get-all-operations-by-account): Consulta todas las Operaciones vinculadas a una Cuenta específica.
* [Recuperar una Operación por Cuenta](/es/reference/products/midaz/v2/get-operation-by-account): Obtén los detalles de una Operación específica para esa Cuenta.
