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

# Glossário

> Glossário de referência do plugin Bank Transfer: BACEN, SPB, STR, ISPB, PSTI, códigos de conta ISO 20022 e tipos de mensagem do JD SPB como o STR0008.

Referência rápida dos termos e siglas usados na documentação do plugin Bank Transfer.

## Termos regulatórios e de infraestrutura

***

| Termo                            | Definição                                                                                                                                                                                                                                                                                                                                                       |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ANBIMA**                       | Associação Brasileira das Entidades dos Mercados Financeiro e de Capitais. Fonte upstream da tabela nacional de feriados bancários consumida pelo atualizador de feriados do plugin para preencher o calendário `bacen_holidays`.                                                                                                                               |
| **BACEN**                        | Banco Central do Brasil. Regula o sistema financeiro e opera o SPB.                                                                                                                                                                                                                                                                                             |
| **SPB**                          | Sistema de Pagamentos Brasileiro — a infraestrutura de todas as liquidações interbancárias.                                                                                                                                                                                                                                                                     |
| **STR**                          | Sistema de Transferência de Reservas — o componente de liquidação em tempo real do SPB.                                                                                                                                                                                                                                                                         |
| **RSFN**                         | Rede do Sistema Financeiro Nacional — a rede financeira nacional segura que conecta o BACEN às instituições financeiras.                                                                                                                                                                                                                                        |
| **PSTI**                         | Provedor de Serviço de Tecnologia da Informação — provedor autorizado pelo BACEN a operar a infraestrutura de conectividade da RSFN. A JD Consultores é um PSTI.                                                                                                                                                                                                |
| **ISPB**                         | Identificador de Sistema de Pagamentos Brasileiro — código de 8 dígitos que identifica de forma única cada instituição financeira no SPB.                                                                                                                                                                                                                       |
| **STR0008**                      | O formato de mensagem do BACEN para iniciar uma transferência TED. Enviado da instituição de origem para o SPB.                                                                                                                                                                                                                                                 |
| **STR0008R2**                    | A mensagem de resposta e confirmação do STR0008. Traz o resultado da liquidação.                                                                                                                                                                                                                                                                                |
| **STR0010R2**                    | O formato de mensagem de chargeback. Enviado quando um TED deve ser devolvido ao banco de origem (por exemplo, destinatário não encontrado).                                                                                                                                                                                                                    |
| **Devolução / `devolutionCode`** | Devolução de um TED. Quando um TED OUT já enviado é devolvido (STR0010R2), o plugin registra a devolução como um TED IN de retorno que carrega o código de motivo do BACEN (`devolutionCode`) e um `originalTransferId` que aponta de volta para o TED OUT original. (Um TED recebido que não pode ser creditado é devolvido ao banco de origem separadamente.) |
| **JD / JD SPB**                  | JD Consultores — o PSTI usado pela Lerian para rotear mensagens de TED até o SPB.                                                                                                                                                                                                                                                                               |
| **Falha de parsing da JD**       | Mensagem recebida da JD que não pôde ser interpretada (XML malformado, tipo de mensagem desconhecido, schema divergente). Persistida em `jd_incoming_parse_failures` para triagem manual. Diferente das transferências não entregáveis e da DLQ de webhooks.                                                                                                    |
| **NumCabSeq**                    | Identificador sequencial de mensagem atribuído pelo JD SPB a cada envio de STR0008. Usado para acompanhar e consultar o status da transferência.                                                                                                                                                                                                                |
| **NumCtrlSTR**                   | Número de controle de compensação do BACEN atribuído pelo STR (Sistema de Transferência de Reservas) quando uma mensagem é aceita no fluxo de compensação do SPB. Persistido na transferência como `clearing_control_number`. Diferente de `NumCabSeq`, que é a sequência de mensagem atribuída pela JD no envio.                                               |

## Códigos de tipo de conta (ISO 20022)

***

| Código   | Tipo de conta                      |
| -------- | ---------------------------------- |
| **CACC** | Conta corrente — o tipo mais comum |
| **CPAY** | Conta de pagamento                 |
| **SLRY** | Conta salário                      |
| **SVGS** | Conta poupança                     |

## Tipos de transferência

***

| Termo       | Definição                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------- |
| **TED OUT** | Transferência de saída — o seu cliente envia fundos para uma conta em outro banco.                                  |
| **TED IN**  | Transferência de entrada — a sua instituição recebe fundos de outro banco, detectados e creditados automaticamente. |
| **P2P**     | Transferência interna — entre duas contas da mesma instituição (mesmo ISPB). Mais rápida e, em geral, sem tarifa.   |
| **D+0**     | Liquidação no mesmo dia — o TED é um instrumento D+0 quando enviado antes das 17:00, horário de Brasília.           |

## Termos específicos do plugin

***

| Termo                            | Definição                                                                                                                                                                                                                                                                                  |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **PaymentInitiation**            | A entidade criada por `POST /v1/transfers/initiate`. Guarda o cálculo da tarifa e expira depois de 24 horas.                                                                                                                                                                               |
| **initiationId**                 | UUID retornado pelo endpoint de iniciação. Obrigatório para confirmar uma transferência por `POST /v1/transfers/process`.                                                                                                                                                                  |
| **X-Idempotency**                | Header obrigatório para novas tentativas seguras. O plugin guarda a resposta em cache sob a chave e a repete por 24 horas. O plugin rejeita uma requisição repetida que reutiliza a chave com um corpo diferente (fingerprint divergente).                                                 |
| **Tarifa de cashin**             | Tarifa descontada do valor recebido em um TED IN. Configurada por organização pelo Fees Engine.                                                                                                                                                                                            |
| **Tarifa de cashout**            | Tarifa somada ao valor de um TED OUT. A conta do remetente é debitada pelo valor + a tarifa.                                                                                                                                                                                               |
| **Conciliação**                  | Processo para casar transferências em estado desconhecido (PROCESSING sem confirmação) com os registros do JD SPB.                                                                                                                                                                         |
| **DLQ**                          | Fila de dead-letter de webhooks — as notificações de webhook de saída que não podem ser entregues depois de todas as novas tentativas são movidas para cá, para revisão manual.                                                                                                            |
| **Artefato de assinatura**       | Payload canônico do TED OUT congelado durante o `POST /v1/transfers/signing/prepare` e persistido em `jd_outbound_signing_artifacts`. Consumido por integrações externas de HSM ou de assinador para produzir uma assinatura destacada sem que o plugin guarde a chave privada.            |
| **Systemplane**                  | Plano administrativo de configuração em tempo de execução, exposto por `/system/:namespace` e `/system/:namespace/:key`. Guarda configurações com hot reload que passam a valer sem um novo deploy. Diferente das variáveis de ambiente de bootstrap, lidas apenas na inicialização.       |
| **Transferência não entregável** | TED de entrada cujo parsing funcionou, mas que não pôde ser creditado (por exemplo, conta do destinatário não encontrada no CRM). Persistida em `undeliverable_incoming_transfers` e pode disparar uma devolução automática. Diferente de uma falha de parsing da JD e da DLQ de webhooks. |
