Glossário - Lerian

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.