> ## 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 uma transferência

> Crie uma TED Saída no Lerian Console com o assistente de dois passos que inicia e confirma. Colete os dados, veja a prévia das tarifas e execute a transferência TED de saída.

A página **Nova Transferência** cria uma transferência em dois passos. No passo 1 você informa os dados da transferência e pede uma prévia da tarifa (**initiate**). No passo 2 você revisa a transferência e a confirma (**process**). O Console mostra o passo 1 como um formulário e o passo 2 como uma tela de revisão. O Console executa a transferência quando você clica em **Confirmar Transferência**.

<Note>
  Esse assistente sempre cria uma **TED Saída** (TED de saída). A TED de entrada (TED Entrada) chega automaticamente pelo poller da JD, então ela não tem passo de criação manual. Uma transferência P2P usa um fluxo separado. Você não pode criar uma transferência P2P nesta página.
</Note>

## Como acessar o assistente

***

<Steps>
  <Step title="Abra a página de Transferências">
    Na barra lateral do módulo Midaz, expanda **Transferência Bancária**. Clique em **Transferências**.
  </Step>

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

O cabeçalho da página mostra **Nova Transferência**. O subtítulo diz *Inicie uma nova transferência bancária em duas etapas simples*. Um indicador de passos perto do topo mostra onde você está no fluxo: o passo 1 é o formulário e o passo 2 é a revisão. A tela de sucesso aparece depois que o backend conclui a transferência.

## Banner de horário de funcionamento

***

Um banner âmbar **Fora do Horário de Funcionamento do TED** aparece no topo quando o horário atual está fora da janela de funcionamento configurada para o TED. O banner informa a janela de funcionamento: de segunda a sexta, entre as horas de abertura e de fechamento configuradas, no fuso horário configurado.

<Warning>
  Não envie uma transferência TED fora da janela de funcionamento. O Console não bloqueia o botão, mas o backend rejeita a requisição com um erro `422` (`BTF-0010`). A resposta informa o próximo horário em que a janela de funcionamento abre. A janela padrão é de segunda a sexta, 06:30–17:00 (`America/Sao_Paulo`, UTC−3).
</Warning>

<Card title="Configurar o horário de funcionamento" icon="clock" horizontal href="/pt/interfaces/ted-jd/console/bt-configuring-operating-hours">
  Ajuste a janela de funcionamento em Configurações.
</Card>

## Passo 1: colete os dados e inicie

***

O formulário tem três seções. O Console marca todos os campos obrigatórios. Quando você clica em **Continuar**, o Console chama o endpoint `/initiate` do backend com os valores abaixo. O endpoint `/initiate` calcula as tarifas e devolve uma prévia para a tela de revisão.

### Conta de origem

* **Conta do Remetente** *(obrigatório)*: escolha a conta de origem na lista suspensa. A lista traz as contas do ledger que permitem envio. Se o ledger não tem conta de remetente elegível, o campo vira uma entrada de texto. Você então digita 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. O CPF tem 11 dígitos e o CNPJ tem 14 dígitos.
* **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>
  O **Código ISPB** e a **Agência** valem para transferências TED (TED Saída e TED Entrada). Esse assistente cria uma TED Saída, então os dois campos são obrigatórios aqui.
</Note>

### Detalhes da transferência

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

Clique em **Continuar** para ir ao passo de revisão. A resposta do `/initiate` traz o identificador de iniciação, o detalhamento das tarifas e a conclusão estimada. Esses valores alimentam a próxima tela.

## Passo 2: revise e confirme

***

O Console monta a tela de revisão a partir da resposta do `/initiate` no passo 1. O identificador de iniciação, o detalhamento das tarifas e a conclusão estimada são levados adiante. Confira a transferência antes de executá-la. A tela mostra:

* **Tipo de Transferência**: sempre **TED Saída** 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 no passo 1.
* **Valor**: o valor que você informou.
* **Taxa**: a tarifa total que o plugin calcula.
* **Detalhamento de Taxas**: uma linha por entrada de tarifa, com o rótulo e o valor dela. Uma entrada *Dedutível* sai do valor da transferência. As outras entradas somam a ele.
* **Total**: o valor final que o plugin debita do remetente.
* **Conclusão Estimada**: o timestamp em que a transferência deve terminar.

<Note>
  Clique em **Voltar** para retornar ao formulário. O Console mantém o que você informou antes. Quando você clica em **Continuar** de novo, o Console executa `/initiate` outra vez, para a prévia da tarifa combinar com as suas mudanças.
</Note>

Quando você clica em **Confirmar Transferência**, o Console envia a transferência revisada ao endpoint `/process` do backend. Essa chamada cria e executa a transferência pela integração JD SPB. O botão mostra *Confirmando…* enquanto a chamada está em andamento. O Console redireciona para a tela de sucesso depois que o backend responde.

## Tela de sucesso

***

Depois que o `/process` retorna com sucesso, o Console mostra uma tela de sucesso com:

* **ID da Transferência**: o identificador da transferência.
* **Número de Confirmação**: a referência que a integração JD devolve.
* **Status**: o status depois da confirmação (normalmente **Criada**, **Pendente**, **Processando** ou **Concluída**).
* **Taxa** e **Total**: os valores aplicados.

A tela de sucesso oferece duas ações:

* **Ver Transferência**: abre a [página de detalhes da transferência](/pt/interfaces/ted-jd/console/bt-checking-transfer-details) desta transferência.
* **Nova Transferência**: reinicia o assistente com um formulário limpo.
