> ## 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 Out ou P2P 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.

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]
>
> O assistente não pede um tipo de transferência. O plugin cria uma **P2P** quando o **Código ISPB** é o ISPB da sua instituição, e uma **TED Out** para qualquer outro ISPB. A TED de entrada (TED In) chega da JD, então ela não tem passo de criação manual.

## Como acessar o assistente

***

**1. Abra a página de Transferências**

Na barra lateral do módulo Midaz, expanda **Transferência Bancária**. Clique em **Transferências**.

**2. Comece uma nova transferência**

Clique em **Nova Transferência** no canto superior direito da página.

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 quando o plugin aceita a transferência para processamento.

## 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 operação configurada para o TED. O banner informa a janela de operação: de segunda a sexta, entre as horas de abertura e de fechamento configuradas, no fuso horário configurado. Um banner **Janela de Funcionamento do TED Fechada** aparece quando a janela armazenada fecha todos os dias, e um banner **Janela de Funcionamento do TED Inválida** quando o plugin não aceita a janela armazenada.

> [!WARNING]
>
> Não envie uma TED Out fora da janela de operação ou em um feriado do BACEN. O Console não bloqueia o botão, mas o plugin rejeita a requisição com um erro `422` (`BTF-0010`). A resposta informa o próximo horário em que a janela de operação abre. A janela padrão é de segunda a sexta, 06:30–17:00 (`America/Sao_Paulo`, UTC−3). Transferências P2P ignoram a janela.

> [card] [Configurar o horário de funcionamento](https://docs.lerian.studio/pt/interfaces/ted-jd/console/bt-configuring-operating-hours.md)
>
> Ajuste a janela de operação em Configurações.

## 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é 200 bytes. Um caractere acentuado conta como dois.
* **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**, **Poupança**, **Pagamento** ou **Salário**.
* **Código ISPB** *(obrigatório)*: o ISPB de 8 dígitos do banco do beneficiário.
* **Agência**: o código da agência do banco do beneficiário, de 1 a 4 dígitos. O plugin aceita uma TED sem agência.

### Detalhes da transferência

* **Valor** *(obrigatório)*: o valor da transferência, de 0,01 a 999.999,99, com no máximo duas casas decimais.
* **Moeda** *(obrigatório)*: fixa em **BRL**.
* **Finalidade (código SPB)** *(obrigatório)*: o código de finalidade SPB, de 1 a 4 dígitos. `10` é crédito em conta.
* **Descrição** *(opcional)*: uma descrição em texto livre de até 140 bytes. Um caractere acentuado conta como dois.

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:

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

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 quando o plugin aceita a transferência. Caso contrário, mostra uma destas mensagens:

* *Não foi possível confirmar o resultado com o banco.*: os valores continuam retidos e a transferência aguarda na fila de conciliação. Não envie a transferência de novo.
* *Janela de confirmação expirada* ou *Os dados de assinatura não correspondem mais*: nada foi enviado. Clique em **Recomeçar**.
* *Transferência já enviada*: clique em **Ver transferências** para encontrá-la.

## 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](https://docs.lerian.studio/pt/interfaces/ted-jd/console/bt-checking-transfer-details.md) desta transferência.
* **Nova Transferência**: abre o assistente de novo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.