Pular para conteúdo

Gerador TXT GFBR

1. Visao geral

  • Slug: gfbr-gerador-txt
  • Grupo (menu): Contabil
  • Pagina: /gfbr-gerador-txt
  • API base (Node): /api/gfbr-gerador-txt
  • API Python: /api/gfbr-gerador-txt/processar
  • Permissao RBAC: tool:gfbr-gerador-txt ou tool:* (ADMIN tambem acessa)
  • Classificacao operacional: vps-compatible

A ferramenta converte o diario GFBR (Excel) e o quadro de movimentacao das aplicacoes Itaú para TXT no layout IOB (C, L, H) usado no fluxo do lotes-txt, gerando obrigatoriamente o arquivo final com nome LOTD0000.txt.

2. Entradas e saidas

Entradas: - arquivo Excel (.xlsx/.xlsm) do diario - nome da aba (opcional) - mapeamento automatico de prefixos de parceiro para conta contabil: TG, SW, DR -> 1.1.2.02.04.01; CL/BF -> 1.1.2.01.01.01; F -> 2.1.1.01.01.01 - PDF Itaú consolidado com o quadro de movimentação - aplicações/resgates antecipados e vencimentos - conta contábil da aplicação 1, da aplicação 2 e da conta corrente de cada PDF - direção dos lançamentos do PDF Itaú: - aplicação: débito na conta da aplicação e crédito na conta corrente - resgate: débito na conta corrente e crédito na conta da aplicação

Saidas: - LOTD0000.txt (layout IOB) - PENDENCIAS_GFBR.csv - EXCLUSOES_GFBR.csv

3. Fluxo tecnico

  1. Front faz upload na pagina public/gfbr-gerador-txt.html.
  2. JS chama POST /api/gfbr-gerador-txt/processar via AuthClient.authFetch.
  3. Router Node salva upload em data/uploads/gfbr-gerador-txt, cria pasta de saida por execucao e chama FastAPI.
  4. Core Python:
  5. le e agrupa lancamentos da planilha;
  6. aplica regras de exclusao (direta + cancelamentos/estornos);
  7. mapeia contas de parceiros para contas contabeis;
  8. lê apenas o quadro de movimentação do PDF Itaú para gerar aplicações, resgates, rendimentos e retenções;
  9. gera partidas no layout IOB e escreve LOTD0000.txt;
  10. gera CSVs de pendencias e exclusoes.
  11. exclui automaticamente lancamentos de renda/rendimento cuja classificacao resolvida comeca com 11102;
  12. Front habilita os botoes de download.

4. Arquivos relacionados

  • Pagina: public/gfbr-gerador-txt.html
  • Script da pagina: public/js/gfbr-gerador-txt.js
  • Router Node: src/routes/tools/gfbr-gerador-txt.routes.js
  • Core Python: api/gfbr_gerador_txt_core.py
  • Endpoint FastAPI: api/integra_api.py

5. Troubleshooting

Sintoma

Erro de cabecalho ao processar o Excel.

Causa provavel

A aba enviada nao possui os campos obrigatorios do diario GFBR (ex.: numero de sequencia, numero de transacao, data, conta e valor).

Solucao

Validar se o arquivo e a aba corretos foram exportados do sistema origem e reenviar.

Sintoma

PDF Itaú enviado sem gerar aplicações ou resgates.

Causa provavel

A conta corrente nao foi informada ou o PDF nao possui o quadro movimentação - aplicações/resgates antecipados e vencimentos.

Solucao

Preencher a conta corrente, confirmar que o PDF e o extrato consolidado correto e reenviar.

Sintoma

TXT gerado com poucas linhas L.

Causa provavel

Lancamentos com itens sem pareamento debito x credito foram enviados para pendencias em vez de compor partida contabil.

Solucao

Baixar PENDENCIAS_GFBR.csv, ajustar dados de origem/mapeamento e processar novamente.

Sintoma

Lancamentos de renda aparecem no LOTD0000.txt mesmo quando a classificacao resolvida comeca com 11102.

Causa provavel

O registro pertence ao grupo de rendimento da aplicacao e nao deve compor o TXT de lancamentos.

Solucao

A ferramenta agora exclui automaticamente esses registros antes de gerar o TXT e registra o motivo exclusao_renda_classificacao_11102 em EXCLUSOES_GFBR.csv.

Sintoma

Aplicações e resgates do PDF Itaú saem com débito e crédito invertidos no LOTD0000.txt.

Causa provavel

A regra de montagem do PDF Itaú foi aplicada no sentido oposto ao esperado para o layout IOB.

Solucao

A ferramenta agora gera aplicação com débito na conta da aplicação e crédito na conta corrente, e resgate no sentido inverso.

Sintoma

Ao enviar o Excel e o PDF juntos, o site retorna erro de upload antes de chamar o Python.

Causa provavel

O limite de arquivos do upload do GFBR estava restrito a apenas um arquivo por requisição.

Solucao

O upload do GFBR agora aceita até 3 arquivos no mesmo envio, cobrindo o diário Excel e os dois PDFs Itaú previstos pela ferramenta.

Sintoma

Ao enviar Excel + PDF Itaú, o site retornava 500 mesmo com os arquivos válidos.

Causa provavel

A API Python ainda não recebia conta_corrente_1 e conta_corrente_2 no contrato do endpoint, então o core rejeitava o processamento do PDF Itaú.

Solucao

O endpoint /api/gfbr-gerador-txt/processar agora aceita e repassa as contas correntes dos PDFs Itaú para o core, alinhando o contrato com a rota Node e com o front.