CNAB¶
O que é¶
Formato de arquivo de layout fixo (padrão FEBRABAN) usado para trocar informações de cobrança/carteira com bancos e fundos. No ciclo de cessao/retorno-davos aparecem duas variantes:
- CNAB 444 (
.REM) — arquivo de remessa da cessão. Gerado internamente (gerarCNAB444()) ao ceder operações pelo botão "Gerar CNAB", ou recebido da FIDEM e importado pelo botão "Importar CNAB" (parser emapps/api-menos-juros/src/v2/carteira/cessao/cnab-444.parser.ts, que também lê CNAB 400). - CNAB 400 — arquivo de retorno, montado por
buildCnab400ao gerar o retorno DAVOS (retorno-davos), informando ao fundo quais parcelas cedidas foram pagas.
Conciliação na importação¶
Ao importar um CNAB de remessa, a conciliação casa cada linha do arquivo com uma parcela
interna (fluxo_pagamentos) por CPF + número da parcela + valor
(conciliacao-remessa.service.ts). O resultado é dividido em baldes:
- casada — a parcela do arquivo existe no sistema (1 match exato por CPF + nº parcela +
valor). Grava linha em
cnab_remessa_linhase marcaoperacoes.cedido=true. - órfã — a parcela do arquivo não existe no sistema (nenhuma parcela interna com
aquele CPF+parcela+valor). Apenas registra no log de importação (
log_importacao_cessao, payloadorfas); não cria linha, não mexe em nenhuma operação. - empate — a parcela do arquivo casa com mais de uma parcela interna (ambíguo).
Também apenas registra no log (payload
empates), não grava nada — precisa de resolução manual. - atualizadas/protegidas — casos de reimportação de um arquivo já processado antes.
A confirmação é feita via RPC transacional atômica — só as casadas produzem efeito em
cnab_remessa_linhas/operacoes; órfãs e empates só aparecem no log, nunca gravam nada. Ver
cessao-davos para a distinção entre órfã, "não cedida" e "não incluída no retorno".