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

La página **New Transfer** te guía a través de la creación de una transferencia en dos pasos que reflejan el flujo del backend: recopilas los detalles de la transferencia y solicitas una vista previa de las tarifas (**initiate**), luego revisas y confirmas para ejecutar la transferencia (**process**). La interfaz muestra el paso 1 como un formulario y el paso 2 como una pantalla de revisión; la transferencia se ejecuta cuando haces clic en **Confirm Transfer**.

<Note>
  El asistente de iniciación siempre crea un **TED Out** (TED saliente). El TED entrante (TED In) llega automáticamente a través del poller de JD y no tiene un paso de creación manual. Las transferencias P2P se manejan en un flujo separado y no se crean desde esta página.
</Note>

## Acceder al asistente

***

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

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

El encabezado de la página muestra **New Transfer** con el subtítulo *Initiate a new bank transfer in two simple steps*. Un stepper cerca de la parte superior indica dónde te encuentras en el flujo (paso 1, el formulario; paso 2, la revisión), seguido por la pantalla de éxito una vez que el backend completa el procesamiento.

## Banner de horario operativo

***

Si la hora actual está fuera de la ventana operativa TED configurada para tu plugin, aparece un banner ámbar **Outside TED Operating Hours** en la parte superior. Indica que las transferencias TED se procesan de lunes a viernes, entre las horas de apertura y cierre configuradas, en la zona horaria configurada.

<Warning>
  El banner no bloquea el envío en la Consola. Una transferencia TED enviada fuera de la ventana operativa se **pone en cola y se procesa el siguiente día hábil** — no es rechazada. 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. Todos los campos obligatorios están marcados en la interfaz. Al hacer clic en **Continue**, el Console llama al endpoint `/initiate` del backend con los valores a continuación para calcular las tarifas y devolver una vista previa que alimenta la pantalla de revisión.

### Source Account

* **Sender Account** *(obligatorio)* — elige la cuenta de origen desde el menú desplegable. La lista se completa con las cuentas existentes del ledger que permiten envío. Si el ledger no tiene cuentas remitentes elegibles, el campo se convierte en una entrada de texto donde puedes escribir 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 (11 a 14 caracteres).
* **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). Como este asistente crea un TED Out, ambos son obligatorios aquí.
</Note>

### Transfer Details

* **Amount** *(obligatorio)* — el monto de la transferencia; 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 que impulsan la siguiente pantalla.

## Paso 2 — Revisar y confirmar

***

La pantalla de revisión se construye a partir de la respuesta de `/initiate` devuelta en el paso 1 — el identificador de iniciación, el desglose de tarifas y la finalización estimada se trasladan para que puedas verificar la transferencia antes de confirmar. Resume todo antes de ejecutar:

* **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 calculada por el plugin.
* **Fee Breakdown** — una línea por entrada de tarifa, con su etiqueta y monto. Las entradas marcadas como *Deductible* se descontarán del monto de la transferencia en lugar de sumarse por encima.
* **Total** — el monto final a debitar del remitente.
* **Estimated Completion** — la marca de tiempo en la que se espera que se complete la transferencia.

<Note>
  Haz clic en **Back** para regresar al formulario y ajustar cualquier valor. Tus entradas anteriores se conservan; al hacer clic en **Continue** nuevamente, el Console vuelve a ejecutar `/initiate` para que la vista previa de tarifas permanezca sincronizada con lo que cambiaste.
</Note>

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

## Pantalla de éxito

***

Una vez que `/process` retorna correctamente, una pantalla de éxito muestra:

* **Transfer ID** — el identificador asignado a la transferencia.
* **Confirmation Number** — la referencia devuelta por 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.

Dos acciones están disponibles:

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