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

# Iniciando uma Transferência

> Crie uma nova TED Out através do assistente de iniciação do Bank Transfer.

A página **Nova Transferência** guia você na criação de uma transferência em duas etapas que espelham o fluxo do backend: você coleta os dados da transferência e solicita uma prévia de taxas (**initiate**), depois revisa e confirma para executar a transferência (**process**). A interface mostra a etapa 1 como um formulário e a etapa 2 como uma tela de revisão; a transferência é executada quando você clica em **Confirmar Transferência**.

<Note>
  O assistente de iniciação sempre cria uma **TED Out** (TED de saída). A TED de entrada (TED In) chega automaticamente pelo poller do JD e não tem etapa de criação manual. Transferências P2P são tratadas em um fluxo separado e não são criadas a partir desta página.
</Note>

## Acessando o assistente

***

<Steps>
  <Step title="Abra a página Transferências">
    Na barra lateral do Módulo Midaz, expanda **Bank Transfer** e clique em **Transferências**.
  </Step>

  <Step title="Inicie uma nova transferência">
    Clique no botão **Nova Transferência** no canto superior direito da página.
  </Step>
</Steps>

O cabeçalho da página mostra **Nova Transferência** com o subtítulo *Inicie uma nova transferência bancária em duas etapas simples*. Um indicador de progresso próximo ao topo mostra em que ponto do fluxo você está (etapa 1, o formulário; etapa 2, a revisão), seguido pela tela de sucesso quando o backend conclui o processamento.

## Banner de horário de funcionamento

***

Se o horário atual estiver fora da janela de operação TED configurada para o seu plugin, um banner âmbar **Fora do Horário de Funcionamento do TED** aparece no topo. Ele indica que transferências TED são processadas de segunda a sexta, entre os horários de abertura e fechamento configurados, no fuso configurado.

<Warning>
  O banner não bloqueia o envio no Console. Uma transferência TED enviada fora da janela operacional é **enfileirada e processada no próximo dia útil** — não é rejeitada. Por padrão a janela é de segunda a sexta, 06:30–17:00 (`America/Sao_Paulo`, UTC−3).
</Warning>

<Card title="Configurando Horário de Funcionamento" icon="clock" horizontal href="/pt/rails/ted/console/bt-configuring-operating-hours">
  Ajuste a janela de operação em Configurações.
</Card>

## Etapa 1 — Coletar dados e iniciar

***

O formulário tem três seções. Todos os campos obrigatórios estão marcados na interface. Ao clicar em **Continuar**, o Console chama o endpoint `/initiate` do backend com os valores abaixo para calcular as taxas e retornar uma prévia que alimenta a tela de revisão.

### Conta de Origem

* **Conta do Remetente** *(obrigatório)* — escolha a conta de origem no dropdown. A lista é preenchida com as contas existentes do ledger que permitem envio. Se o ledger não tiver contas de remetente elegíveis, o campo se torna uma entrada de texto livre na qual você pode digitar o ID da conta diretamente.

### Conta de Destino

* **Nome do Destinatário** *(obrigatório)* — o nome completo do beneficiário (até 100 caracteres).
* **CPF/CNPJ** *(obrigatório)* — o documento do beneficiário (11 a 14 caracteres).
* **Número da Conta** *(obrigatório)* — o número da conta do beneficiário.
* **Tipo de Conta** *(obrigatório)* — **Corrente** ou **Poupança**.
* **Código ISPB** *(obrigatório)* — o ISPB de 8 dígitos do banco do beneficiário.
* **Agência** *(obrigatório)* — o código da agência do banco do beneficiário.

<Note>
  **Código ISPB** e **Agência** se aplicam a transferências TED (TED Out e TED In). Como este assistente cria uma TED Out, ambos são obrigatórios aqui.
</Note>

### Detalhes da Transferência

* **Valor** *(obrigatório)* — o valor da transferência; deve ser maior que zero.
* **Moeda** *(obrigatório)* — fixa em **BRL**.
* **Descrição** *(opcional)* — uma descrição livre de até 140 caracteres.

Clique em **Continuar** para avançar para a etapa de revisão. A resposta de `/initiate` traz o identificador da iniciação, o detalhamento da taxa e a conclusão estimada que alimentam a próxima tela.

## Etapa 2 — Revisar e confirmar

***

A tela de revisão é construída a partir da resposta de `/initiate` retornada na etapa 1 — o identificador de iniciação, o detalhamento da taxa e a conclusão estimada são reaproveitados para que você possa conferir a transferência antes de confirmar. Ela resume tudo antes da execução:

* **Tipo de Transferência** — sempre **TED Out** nesta página.
* **Conta do Remetente**, **Nome do Destinatário**, **CPF/CNPJ**, **Conta do Destinatário**, **Tipo de Conta**, **ISPB**, **Agência**, **Descrição** — exatamente o que você informou na etapa 1.
* **Valor** — o valor que você informou.
* **Taxa** — a taxa total calculada pelo plugin.
* **Detalhamento de Taxas** — uma linha por item de taxa, com o rótulo e o valor. Itens marcados como *Dedutível* serão descontados do valor da transferência em vez de somados.
* **Total** — o valor final a ser debitado do remetente.
* **Conclusão Estimada** — o carimbo de tempo em que a transferência deve ser concluída.

<Note>
  Clique em **Voltar** para retornar ao formulário e ajustar qualquer valor. Suas informações anteriores são preservadas; ao clicar em **Continuar** novamente, o Console executa novamente `/initiate` para que a prévia de taxas permaneça em sincronia com o que você alterou.
</Note>

Ao clicar em **Confirmar Transferência**, o Console envia a transferência revisada para o endpoint `/process` do backend. É essa chamada que cria e executa a transferência por meio da integração JD SPB. Enquanto a chamada está em andamento, o botão exibe *Confirmando…*; assim que o backend responde, o Console redireciona para a tela de sucesso.

## Tela de sucesso

***

Após `/process` retornar com sucesso, a tela de sucesso exibe:

* **ID da Transferência** — o identificador atribuído à transferência.
* **Número de Confirmação** — a referência retornada pela integração JD.
* **Status** — o status após a confirmação (tipicamente **Created**, **Pending**, **Processing** ou **Completed**).
* **Taxa** e **Total** — os valores aplicados.

Duas ações estão disponíveis:

* **Ver Transferência** — abre a [página de Detalhes da Transferência](/pt/rails/ted/console/bt-checking-transfer-details) para esta transferência.
* **Nova Transferência** — reinicia o assistente com um formulário limpo.
