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

# Iniciar una transferencia

> Crea un nuevo TED Out a través del asistente de iniciación de Bank Transfer en Lerian Console, con validación de destinatario, monto y fecha efectiva.

La página **New Transfer** crea una transferencia en dos pasos. En el paso 1 ingresas los detalles de la transferencia y solicitas una vista previa de las tarifas (**initiate**). En el paso 2 revisas la transferencia y la confirmas (**process**). El Console muestra el paso 1 como un formulario y el paso 2 como una pantalla de revisión. El Console ejecuta la transferencia cuando haces clic en **Confirm Transfer**.

<Note>
  Este asistente siempre crea un **TED Out** (TED saliente). El TED entrante (TED In) llega automáticamente a través del poller de JD, por lo que no tiene un paso de creación manual. Una transferencia P2P usa un flujo separado. No puedes crear una transferencia P2P desde esta página.
</Note>

## Acceder al asistente

***

<Steps>
  <Step title="Abrir la página Transfers">
    En la barra lateral de Midaz Module, expande **Bank Transfer**. Haz clic en **Transfers**.
  </Step>

  <Step title="Iniciar una nueva transferencia">
    Haz clic en **New Transfer** en la parte superior derecha de la página.
  </Step>
</Steps>

El encabezado de la página muestra **New Transfer**. El subtítulo dice *Initiate a new bank transfer in two simple steps*. Un stepper cerca de la parte superior muestra tu lugar en el flujo: el paso 1 es el formulario y el paso 2 es la revisión. La pantalla de éxito aparece después de que el backend completa la transferencia.

## Banner de horario operativo

***

Un banner ámbar **Outside TED Operating Hours** aparece en la parte superior cuando la hora actual está fuera de la ventana operativa TED configurada. El banner indica la ventana operativa: de lunes a viernes, entre las horas de apertura y cierre configuradas, en la zona horaria configurada.

<Warning>
  No envíes una transferencia TED fuera de la ventana operativa. El Console no bloquea el botón, pero el backend rechaza la solicitud con un error `422` (`BTF-0010`). La respuesta informa la próxima vez que abre la ventana operativa. Por defecto, la ventana es de lunes a viernes, 06:30–17:00 (`America/Sao_Paulo`, UTC−3).
</Warning>

<Card title="Configurar horarios operativos" icon="clock" horizontal href="/es/rails/ted/console/bt-configuring-operating-hours">
  Ajusta la ventana operativa en Settings.
</Card>

## Paso 1 — Recopilar detalles e iniciar

***

El formulario tiene tres secciones. El Console marca todos los campos obligatorios. Al hacer clic en **Continue**, el Console llama al endpoint `/initiate` del backend con los valores a continuación. El endpoint `/initiate` calcula las tarifas y devuelve una vista previa para la pantalla de revisión.

### Source Account

* **Sender Account** *(obligatorio)* — elige la cuenta de origen desde el menú desplegable. La lista contiene las cuentas del ledger que permiten envío. Si el ledger no tiene una cuenta remitente elegible, el campo se convierte en una entrada de texto. Entonces escribes el ID de la cuenta directamente.

### Destination Account

* **Recipient Name** *(obligatorio)* — el nombre completo del beneficiario (hasta 100 caracteres).
* **CPF/CNPJ** *(obligatorio)* — el documento del beneficiario. Un CPF tiene 11 dígitos y un CNPJ tiene 14 dígitos.
* **Account Number** *(obligatorio)* — el número de cuenta del beneficiario.
* **Account Type** *(obligatorio)* — **Checking** o **Savings**.
* **ISPB Code** *(obligatorio)* — el ISPB de 8 dígitos del banco del beneficiario.
* **Branch** *(obligatorio)* — el código de sucursal del banco del beneficiario.

<Note>
  **ISPB Code** y **Branch** se aplican a las transferencias TED (TED Out y TED In). Este asistente crea un TED Out, por lo que ambos campos son obligatorios.
</Note>

### Transfer Details

* **Amount** *(obligatorio)* — el monto de la transferencia. El monto debe ser mayor que cero.
* **Currency** *(obligatorio)* — fijo en **BRL**.
* **Description** *(opcional)* — una descripción de texto libre de hasta 140 caracteres.

Haz clic en **Continue** para pasar al paso de revisión. La respuesta de `/initiate` lleva el identificador de iniciación, el desglose de tarifas y la finalización estimada. Estos valores impulsan la siguiente pantalla.

## Paso 2 — Revisar y confirmar

***

El Console construye la pantalla de revisión a partir de la respuesta de `/initiate` del paso 1. El identificador de iniciación, el desglose de tarifas y la finalización estimada se trasladan. Verifica la transferencia antes de ejecutarla. La pantalla muestra:

* **Transfer Type** — siempre **TED Out** en esta página.
* **Sender Account**, **Recipient Name**, **CPF/CNPJ**, **Recipient Account**, **Account Type**, **ISPB**, **Branch**, **Description** — exactamente lo que ingresaste en el paso 1.
* **Amount** — el monto que ingresaste.
* **Fee** — la tarifa total que calcula el plugin.
* **Fee Breakdown** — una línea por entrada de tarifa, con su etiqueta y su monto. Una entrada *Deductible* se descuenta del monto de la transferencia. Las demás entradas se suman a él.
* **Total** — el monto final que el plugin debita del remitente.
* **Estimated Completion** — la marca de tiempo en la que la transferencia debe completarse.

<Note>
  Haz clic en **Back** para regresar al formulario. El Console conserva tus entradas anteriores. Cuando haces clic en **Continue** de nuevo, el Console vuelve a ejecutar `/initiate` para que la vista previa de tarifas coincida con tus cambios.
</Note>

Cuando haces clic en **Confirm Transfer**, el Console envía la transferencia revisada al endpoint `/process` del backend. Esta llamada crea y ejecuta la transferencia a través de la integración JD SPB. El botón muestra *Confirming…* mientras la llamada está en curso. El Console redirige a la pantalla de éxito después de que el backend responde.

## Pantalla de éxito

***

Después de que `/process` retorna correctamente, el Console muestra una pantalla de éxito con:

* **Transfer ID** — el identificador de la transferencia.
* **Confirmation Number** — la referencia que devuelve la integración JD.
* **Status** — el estado después de la confirmación (típicamente **Created**, **Pending**, **Processing** o **Completed**).
* **Fee** y **Total** — los valores aplicados.

La pantalla de éxito ofrece dos acciones:

* **View Transfer** — abre la [página de detalle de transferencia](/es/rails/ted/console/bt-checking-transfer-details) para esta transferencia.
* **New Transfer** — reinicia el asistente con un formulario en blanco.
