DOC // AIQ-NDB-001REV / A

●SOLUÇÃOFOLHA 10 / NOTAS DE DÉBITO

§ Solução · Contabilidade & tesouraria

Do extrato bancário ao arquivo SAP, automático/

"O extrato entra por e-mail. Saem o arquivo de carga SAP e o relatório de auditoria — classificados, totalizados, prontos para contabilizar."

Automação end-to-end de geração de notas de débito bancárias para SAP. O processo recebe extratos por e-mail, os estrutura com IA, os cruza contra catálogos contábeis e entrega dois arquivos no Google Drive: o arquivo de carga SAP e a listagem classificada para auditoria.

~30 s

Por extrato

Antes: 30 a 45 minutos de classificação manual e montagem do arquivo. Agora: do e-mail ao Drive, em segundos.

Regras de negócio auditáveis

Da identificação do banco até o split 67/33 e o totalizador, cada regra documentada e rastreável.

100%

Sem intervenção

Sem intervenção humana entre o envio do e-mail e a disponibilização dos arquivos no Drive. Log auditável por execução.

§01 · O problema

Classificar à mão todos os meses

As empresas que migram para SAP costumam herdar um processo manual recorrente: classificar cada movimentação bancária, identificar conceitos sujeitos a lançamento contábil e montar o arquivo de carga. Uma pessoa abre o CSV, percorre as linhas, cruza contra uma planilha de critérios, divide valores segundo regras internas, monta cabeçalho e totalizador, e sobe o arquivo no sistema.

Dimensão	Antes (manual)	Depois (automatizado)
Tempo por extrato	30 a 45 minutos	~30 segundos
Rastreabilidade	Manual / planilha Excel	Log + arquivos versionados
Escalabilidade	1 banco por operador	N bancos em paralelo
Risco de erro	Alto — classificação manual	Baixo — regras auditáveis

§02 · Como funciona

O fluxo, em 7 passos

O processo roda toda vez que um extrato chega por e-mail em uma caixa dedicada. Sem intervenção humana entre o envio do e-mail e os arquivos finais no Drive.

RECEPÇÃO

Mailhook recebe o extrato

Um mailhook detecta o e-mail recebido com o extrato bancário anexado em formato CSV. O gatilho é imediato.

▼

ESTRUTURAÇÃO

Gemini interpreta o CSV

gemini-2.5-pro recebe o CSV e devolve um objeto JSON com o cabeçalho do extrato e um array de movimentações.

▼

BANCO

Identificação contra catálogo BCRA

O número da conta é cruzado contra o catálogo de Entidades BCRA. Se houver correspondência, obtêm-se o código BCRA e a denominação oficial do banco.

▼

CRITÉRIOS

Classificação contábil

Para cada movimentação, busca-se o critério no catálogo de Critérios usando como chave o código de operação bancária. Obtêm-se conta contábil, indicador de imposto, centro de custo, sentido e categoria (GST− / GST+).

▼

REGRAS

Aplicação de regras de negócio

As movimentações GST− são incluídas no arquivo SAP. As contas especiais recebem split 67% despesa / 33% ativo computável. As movimentações sem critério são marcadas SEM CLASSIFICAÇÃO.

▼

CONSTRUÇÃO

Montagem dos dois arquivos

Constroem-se o ND_SAP (cabeçalho + detalhe filtrado + totalizador) e o UMSATZ (todas as movimentações classificadas, para auditoria).

▼

ENTREGA

Upload para o Google Drive

Ambos os arquivos são enviados automaticamente para a pasta de destino, com timestamp no nome. Prontos para a equipe contábil coletar.

§03 · Stack tecnológica

Componentes e arquitetura

A automação é implementada sobre o Make.com, que orquestra os serviços externos. Sem servidores para administrar, sem código para manter, sem lock-in: se amanhã mudar um critério contábil ou um código BCRA, tudo está visível e editável.

Plataforma	Make.com — orquestração e motor de execução
Inteligência artificial	Google Gemini 2.5 Pro — estruturação do extrato
Dados de referência	Google Sheets — catálogos Entidades BCRA e Critérios
Gatilho	E-mail (mailhook customizado) — recepção do extrato anexado
Armazenamento	Google Drive — repositório de saídas com timestamp
Saída SAP	Texto simples (.txt) delimitado por pipe (│)
Saída auditoria	CSV — 17 colunas

Make.com Gemini 2.5 Pro Google Sheets Google Drive Pronto para SAP Sem servidores Sem lock-in

§04 · Regras de negócio

Oito regras, todas auditáveis

Cada regra está documentada de forma unívoca. Qualquer modificação funcional parte de atualizar esta seção — não de mexer no código.

RN-01

Identificação do banco emissor

Cada extrato é identificado cruzando o campo Cuenta_Banco do cabeçalho contra o catálogo Entidades BCRA. Correspondência por igualdade exata. Se o banco não estiver no catálogo, a execução continua com cabeçalho incompleto — o catálogo deve ser mantido atualizado.

RN-02

Cálculo de campos derivados

A partir do código BCRA e da data do extrato, calculam-se os campos de cabeçalho: Codigo_Proveedor (400000000 + BCRA com padding), N_Factura, Folio, Ejercicio, Periodo e a data no formato DDMMYY.

RN-03

Classificação contábil

Para cada movimentação, busca-se seu critério no catálogo Critérios, usando Cod_Op_Bco como chave. Devolve: categoria, chave, conta contábil, denominação, indicador de imposto, CECO e sentido.

RN-04

Filtro de inclusão no SAP

Somente as movimentações com categoria GST− são incluídas no arquivo SAP. As GST+ e as sem classificação são excluídas do SAP, mas aparecem no arquivo UMSATZ de auditoria.

RN-05

Split 67% / 33% em contas especiais

Se a conta contábil estiver marcada como "split" no catálogo, a movimentação é dividida em duas linhas: 67% despesa na conta original, 33% ativo computável na conta de ativo. Arredondamento a 2 decimais por linha — diferença ±0,01 aceita.

RN-06

Tratamento de SEM CLASSIFICAÇÃO

Movimentações cujo Cod_Op_Bco não tem correspondência em Critérios são rotuladas SEM CLASSIFICAÇÃO nas sete colunas contábeis do UMSATZ. Não afetam o SAP (são excluídas pela RN-04). Sinal operacional de que o catálogo deve ser ampliado.

RN-07

Totalizador do arquivo SAP

O SAP termina com uma linha F que contém a soma algébrica dos valores originais de todas as movimentações GST−. O sinal é preservado (os débitos são negativos). A soma é calculada sobre o valor original — não sobre os componentes parciais do split.

RN-08

Constantes operacionais

Cada cliente define suas constantes: CUIT receptor, moeda, código do documento, conta de ativo computável para o split, e catálogos próprios de bancos e critérios. Tudo configurável a partir do Google Sheets — alterá-los não requer mexer no cenário.

§05 · Saídas

Os dois arquivos gerados

Cada execução produz dois arquivos versionados com timestamp no nome. O primeiro alimenta o SAP; o segundo é para auditoria.

ND_SAP_<banco>_<timestamp>.txt

Arquivo de carga SAP

Texto simples delimitado por pipe. Três blocos: uma linha de cabeçalho H, N linhas de detalhe (uma por movimentação GST−, ou duas em caso de split), e uma linha de totalizador F. CRLF ao final de cada linha.

UMSATZ_<banco>_<timestamp>.csv

Arquivo de auditoria

CSV com a totalidade das movimentações do extrato, classificadas ou SEM CLASSIFICAÇÃO. Cabeçalho na primeira linha. 17 colunas: código do banco, data, comprovante, valor, descrição, código de operação, data de download, categoria, chave, conta contábil, conceito, indicador de imposto, CECO, sentido e duas colunas reservadas.

Codigo_Banco, Fecha, Comprobante, Importe, Descripcion, Cod_Op_Bco, Fecha_Descarga, COD_2, Clave, COD_2, Cuenta_Contable, Concepto, Indicador_Impuesto, CECO, Sentido, Col16, Col17

§06 · Operação & manutenção

Como se opera no dia a dia

DIA A DIA

100% sem intervenção

Você manda o CSV para o e-mail configurado. Espera ~30 segundos. Coleta os dois arquivos no Drive. Não há intervenção humana no meio do caminho.

CATÁLOGO BCRA

Adicionar um banco

Você adiciona uma linha por conta operacional: código BCRA, denominação oficial e número de conta exatamente como aparece no extrato. Testa com um extrato real antes de produção.

CATÁLOGO CRITÉRIOS

Adicionar um critério

Quando aparece SEM CLASSIFICAÇÃO no UMSATZ, você identifica o código de operação, define com a contabilidade a categoria (GST−/GST+), conta, indicador e CECO, e adiciona uma linha ao catálogo.

Monitoramento

O Make.com mantém log auditável de cada execução: e-mail recebido e anexos, resposta do modelo de IA, bundles processados por módulo, arquivos enviados ao Drive, erros e novas tentativas. Cada execução pode ser auditada individualmente a partir do console.

§07 · Escopo & premissas

O que cobre e o que não cobre

§ PREMISSAS● BASE

→ Os extratos chegam em formato CSV com estrutura estável.
→ Cada e-mail contém um único extrato de um único banco.
→ A estrutura de contas não muda entre extratos do mesmo banco.
→ Os catálogos BCRA e Critérios são mantidos atualizados.

§ FORA DE ESCOPO (v1)● ROADMAP

→ Notificação automática à equipe contábil ao finalizar.
→ Detecção de duplicados (reenvio gera duas execuções).
→ Interrupção explícita se o banco não estiver registrado.
→ Processamento em lote (vários extratos no mesmo e-mail).
→ Dashboard de acompanhamento (Looker Studio).

§08 · Próximo passo● ACTION

Migrando para SAP ou lançando notas à mão?

Se sua equipe contábil monta arquivos de carga à mão todo mês, agende uma chamada. A primeira conversa é para entender seu plano de contas, seus catálogos e seus critérios — e enviar uma proposta concreta.

Agende uma chamada → Peça um orçamento