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

> Construye una Ruta Contable con el asistente de la Console para definir cómo se enrutan las Transacciones y sus operaciones entre Cuentas del Ledger.

Creas una Ruta Contable a través de un asistente guiado de 3 pasos. El asistente te lleva por la Ruta de Transacción, las Rutas de Operación con sus escenarios contables y una revisión final.

## Antes de empezar

***

Crea los Tipos de Cuenta y las Cuentas que la ruta valida. Si todavía no has elegido el Operation Type, el Validation Type y los escenarios contables, lee primero [Reglas contables](/es/midaz/console/mc-accounting).

<Warning>
  Si habilitas **Validate Routes** para el Ledger, cada transacción debe coincidir con una ruta existente. No habilites la validación de rutas hasta que las Rutas Contables necesarias estén listas.
</Warning>

## Paso 1: Información básica

***

<Steps>
  <Step>
    Desde la página **Accounting Routes**, haz clic en **New Route**.
  </Step>

  <Step>
    El asistente de creación se abre en el **Paso 1 — Información básica**.
  </Step>

  <Step>
    Completa la información básica:

    * **Title** (obligatorio): un nombre descriptivo para esta Ruta de Transacción. Debes completar este campo para continuar.
    * **Description** (opcional): una descripción del propósito de la ruta. Si la dejas vacía, el asistente envía un valor de descripción vacío.
  </Step>

  <Step>
    Haz clic en **Next** para avanzar al Paso 2.
  </Step>
</Steps>

## Paso 2: Rutas de Operación

***

En este paso, añades y configuras las Rutas de Operación. Las Rutas de Operación definen cómo el ledger valida las cuentas y registra los asientos contables.

<Note>
  Una Ruta de Operación **Bidirectional** actúa como origen y destino. Cuando luego creas una transacción, el ledger considera una ruta bidireccional en **ambos** lados, origen y destino. Una sola ruta puede entonces validar los dos extremos del flujo.
</Note>

<Steps>
  <Step>
    Haz clic en **Add Operation Route** para crear tu primera tarjeta de Ruta de Operación.
  </Step>

  <Step>
    Configura la Ruta de Operación:

    * **Title** (obligatorio): un nombre para esta Ruta de Operación. La Ruta de Operación tiene un único campo de texto obligatorio y ningún campo de descripción separado. No puedes avanzar al siguiente paso hasta que lo completes.
    * **Operation Type**: `Source`, `Destination` o `Bidirectional`.
    * **Validation Type**: Configura opcionalmente `Account Type` o `@Alias` para validar cuentas. Una Ruta de Operación puede omitir la regla de validación de cuentas.
    * **Account Type or Alias**: los valores de Tipo de Cuenta seleccionados o el alias de cuenta específico.
  </Step>

  <Step>
    *(Opcional)* Configura los **Accounting Scenarios** para definir cómo el ledger registra los asientos. Activa los escenarios que necesites:

    <Tabs>
      <Tab title="Direct Transaction">
        Transacción estándar de un solo paso. Define el **Account Code** y la **Description** para:

        * **Debit** — El código de cuenta debitado en la ejecución
        * **Credit** — El código de cuenta acreditado en la ejecución

        <Tip>
          En las Direct Transactions, los lados que aparecen dependen del Operation Type. Las rutas Source muestran solo débito, las rutas Destination muestran solo crédito, y las rutas Bidirectional muestran ambos. Otros escenarios pueden diferir — consulta la pestaña Two-Step Transaction para más detalles.
        </Tip>
      </Tab>

      <Tab title="Two-Step Transaction">
        Transacciones con un ciclo de retención y confirmación. Configura los asientos para cada fase:

        * **Hold (Value Reserve)** — Asientos que registran los fondos reservados
        * **Commit (Reservation Confirmation)** — Asientos que confirman la reserva
        * **Cancel (Reservation Cancellation)** — Asientos que cancelan la reserva. Completa también estos campos: el ledger valida Hold, Commit y Cancel como un grupo atómico y rechaza la ruta cuando falta el mapeo de Cancel.

        Los campos de asiento disponibles varían según el Operation Type:

        * **Source** — Hold y Cancel muestran los campos de débito y crédito. Commit muestra solo débito.
        * **Destination** — Solo aparece la fase Commit, con crédito únicamente. Hold y Cancel no están disponibles.
        * **Bidirectional** — Todas las fases muestran los campos de débito y crédito.
      </Tab>

      <Tab title="Reversal">
        Asientos que registran la reversa de una transacción completada. Define los códigos de cuenta de débito y crédito y las descripciones para los asientos de reversa.

        <Note>
          El escenario Reversal solo está disponible para Rutas de Operación **Bidirectional**.
        </Note>
      </Tab>

      <Tab title="Overdraft">
        Asientos que aplican cuando un débito excede los fondos disponibles de la cuenta y recurre a una línea de sobregiro. Define los códigos de cuenta de débito y crédito y las descripciones para el uso del sobregiro y su posterior reembolso.

        <Note>
          Overdraft está disponible para las Rutas de Operación **Source**, **Destination** y **Bidirectional**. Cuando activas Overdraft, el asistente también activa el escenario Direct, porque el uso del sobregiro se liquida mediante un asiento directo.
        </Note>
      </Tab>

      <Tab title="Block">
        Asientos que registran el bloqueo y desbloqueo de fondos en una cuenta. Configura dos secciones independientes, **Block** y **Unblock**. Cada sección es de todo o nada: déjala vacía para usar los asientos por defecto, o completa el código de cuenta y la descripción de cada lado visible.

        <Note>
          Block está disponible para todos los Operation Types. Las rutas Source muestran solo asientos de débito, las rutas Destination muestran solo asientos de crédito y las rutas Bidirectional muestran ambos.
        </Note>
      </Tab>
    </Tabs>
  </Step>

  <Step>
    *(Opcional)* Haz clic de nuevo en **Add Operation Route** para añadir más Rutas de Operación a esta Ruta Contable.

    <Warning>
      Debes añadir al menos una Ruta de Operación de origen y una de destino, o al menos una ruta bidireccional. El asistente no continuará sin una configuración de ruta válida.
    </Warning>
  </Step>

  <Step>
    Haz clic en **Next** para avanzar al Paso 3.
  </Step>
</Steps>

## Paso 3: Revisión

***

<Steps>
  <Step>
    Revisa la configuración completa:

    * Título y descripción de la Ruta de Transacción
    * Cada Ruta de Operación con su tipo, reglas de validación y asientos contables
    * Accounting Scenarios con asientos de débito y crédito por tipo de transacción
  </Step>

  <Step>
    Para ajustar algo, haz clic en **Previous** para volver atrás.
  </Step>

  <Step>
    Haz clic en **Create Transaction Route** para crear la Ruta Contable.
  </Step>
</Steps>

## Guía de campos

***

### Información básica

| Campo       | Qué introducir                                                                  | Ejemplo                                            |
| ----------- | ------------------------------------------------------------------------------- | -------------------------------------------------- |
| Route Title | Nombre obligatorio de la ruta. Mantenlo breve y específico al flujo de negocio. | `Pix Transfer Route`                               |
| Description | Explicación opcional de lo que la ruta valida o registra.                       | `Handles Pix transfers between customer accounts.` |

### Ruta de Operación

| Campo                 | Qué introducir                                                                                                                                                          | Ejemplo                               |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| Title                 | Nombre obligatorio de esta tarjeta de Ruta de Operación. Debe completarse para avanzar; no hay campo de descripción separado.                                           | `Checking account validation for Pix` |
| Type                  | Lado contable al que aplica esta Ruta de Operación: `Source`, `Destination` o `Bidirectional`. No puede cambiarse tras la creación.                                     | `Bidirectional`                       |
| Validation Type       | Regla opcional de validación de cuentas. Usa `Account Type` para clases de cuenta o `@Alias` para una cuenta específica. Una Ruta de Operación puede omitir esta regla. | `Account Type`                        |
| Account Type or Alias | Tipos de Cuenta o alias aceptados por esta Ruta de Operación.                                                                                                           | `customer`                            |
| Accounting Scenarios  | Escenarios de transacción que esta ruta debe registrar: Direct, Two-Step, Reversal, Overdraft o Block.                                                                  | `Direct Transaction`                  |
| Account Code          | Código contable usado en el asiento de débito o crédito del escenario seleccionado.                                                                                     | `1.1.1.001`                           |
| Entry Description     | Descripción a nivel de asiento mostrada en la configuración del escenario.                                                                                              | `Customer checking - outbound`        |

## Ejemplo rápido

***

<Accordion title="Transferencia Pix con escenarios Direct y Two-Step">
  **Transaction Route**

  | Campo       | Valor                                                     |
  | ----------- | --------------------------------------------------------- |
  | Title       | `Pix Transfer Route`                                      |
  | Description | `Handles Pix instant transfers between checking accounts` |

  **Ruta de Operación 1 — Bidirectional**

  | Campo           | Valor                                 |
  | --------------- | ------------------------------------- |
  | Title           | `Checking account validation for Pix` |
  | Operation Type  | `Bidirectional`                       |
  | Validation Type | `Account Type`                        |
  | Account Types   | `checking`                            |

  **Escenario Direct Transaction**

  | Lado   | Account Code | Descripción                    |
  | ------ | ------------ | ------------------------------ |
  | Debit  | `1.1.1.001`  | `Customer checking — outbound` |
  | Credit | `1.1.1.002`  | `Customer checking — inbound`  |

  **Two-Step Transaction — Hold**

  | Lado   | Account Code | Descripción                   |
  | ------ | ------------ | ----------------------------- |
  | Debit  | `1.1.1.001`  | `Customer checking — reserve` |
  | Credit | `2.1.1.001`  | `Pending settlement — hold`   |

  **Two-Step Transaction — Commit**

  | Lado   | Account Code | Descripción                    |
  | ------ | ------------ | ------------------------------ |
  | Debit  | `2.1.1.001`  | `Pending settlement — release` |
  | Credit | `1.1.1.002`  | `Customer checking — settled`  |
</Accordion>

## Qué hacer a continuación

***

Tras crear la ruta, crea una transacción que coincida con los mismos Tipos de Cuenta, alias y escenario en [Crear una Transacción](/es/midaz/console/creating-a-transaction).

<CardGroup cols={2}>
  <Card title="Create Transaction Route" icon="code" href="/es/reference/midaz/create-transaction-route">
    Crea la ruta a nivel de transacción mediante la API.
  </Card>

  <Card title="Create Operation Route" icon="code" href="/es/reference/midaz/create-an-operation-route">
    Crea reglas de enrutamiento a nivel de operación mediante la API.
  </Card>
</CardGroup>
