Automatizar nota fiscal e conciliação: o que é possível

Dá para automatizar quase toda a operação ao redor da nota fiscal: emissão de NF-e e NFS-e por API, download e leitura do XML, distribuição de DF-e, conferência da nota contra o pedido, geração de boleto e Pix, conciliação do extrato, baixa do título e envio do pacote para a contabilidade. O que não se automatiza é a decisão fiscal: CFOP, CST ou CSOSN, NCM, alíquota, regime tributário e substituição tributária são definições de quem responde tecnicamente pela apuração. O software executa a regra, ele não a inventa.

O que a automação resolve de fato na emissão

Na prática, a emissão automatizada é um encadeamento simples quando o cadastro está correto:

• Gatilho: pedido faturado, contrato assinado, serviço concluído ou vencimento de mensalidade
• Montagem do documento com os dados do cliente, dos itens e da regra fiscal já cadastrada
• Validação prévia de CNPJ, endereço com código de município, NCM e campos obrigatórios
• Envio com chave de idempotência, para o mesmo pedido nunca gerar duas notas
• Tratamento do retorno: autorizada, rejeitada, denegada ou em processamento
• Guarda da chave de acesso, do XML e do protocolo
• Entrega do XML e do DANFE ou do PDF da NFS-e ao cliente

Quem quebra esse fluxo quase nunca é a integração. É cadastro incompleto e regra fiscal que ninguém revisou desde que foi criada.

NFS-e municipal: por que quase todo mundo usa um provedor

A NF-e de mercadoria é estadual e tem um padrão nacional. A nota de serviço é municipal, e historicamente cada prefeitura definiu o próprio layout, o próprio ambiente de homologação e as próprias regras de autenticação. Uma empresa que emite serviço em cinco cidades pode estar lidando com cinco integrações diferentes.

Por isso, integrar direto com a prefeitura costuma ser trabalho jogado fora. O caminho normal é usar um provedor de emissão, que expõe uma API única e absorve a diferença entre municípios. Existe um movimento de padronização nacional da nota de serviço, e ele reduz o problema, mas conviver com os dois modelos durante a transição é exatamente o tipo de manutenção que compensa terceirizar.

Receber nota: distribuição de DF-e e conferência contra o pedido

Do lado da entrada, o ganho é imediato porque substitui digitação. O sistema consulta periodicamente os documentos emitidos contra o CNPJ da empresa (a chamada distribuição de DF-e), baixa o XML, lê os campos e cruza com o pedido de compra.

O cruzamento é o que gera dinheiro:

• Item cobrado que não estava no pedido
• Quantidade acima da combinada
• Preço unitário fora da tabela negociada
• Frete cobrado quando a condição era CIF
• Fornecedor que diverge todo mês, o que é assunto comercial e não de sistema

Divergência não pode ser bloqueio silencioso. Ela vai para uma fila de conferência com o nome de quem precisa decidir, prazo e histórico. Nota que trava sem responsável definido vira problema fiscal depois.

Cobrança: boleto e Pix precisam voltar identificados

Aqui está o erro estrutural mais comum. Muita empresa emite boleto e cobrança Pix sem carregar um identificador próprio do título. Depois tenta descobrir quem pagou olhando valor e data.

O que resolve:

• Boleto com identificador único da empresa no campo de uso livre da carteira, amarrado ao número do título
• Pix com txid gerado por cobrança, nunca reaproveitado, e não uma chave estática comum a todos os clientes
• Registro do retorno guardado bruto, para auditoria posterior, além do dado já interpretado

Com identificador, a baixa é determinística. Sem identificador, ela é adivinhação com boa taxa de acerto até o dia em que dois clientes pagam o mesmo valor.

Conciliação bancária: por que casar valor não funciona

Conciliar por valor e data parece funcionar no teste e falha na operação real. Dois clientes pagam R$ 1.480,00 no mesmo dia. Um pagou com desconto e outro com juros, então nenhum dos dois bate com o valor original. Um pagamento chega parcial. Outro vem com nome de terceiro no extrato.

A conciliação que aguenta produção tem três camadas:

1. Identificador: baixa automática quando o extrato traz o identificador do boleto ou o txid do Pix
2. Regra: baixa automática com tolerância definida para juros, multa, desconto e tarifa, dentro de um limite que a empresa aceita
3. Humano: fila de exceção para o resto, com sugestão de correspondência e um clique para confirmar

A fonte do extrato pode ser arquivo OFX, arquivo de retorno da cobrança registrada ou API do banco via Open Finance. A API é melhor porque elimina o download manual, mas o desenho lógico é o mesmo: identificador primeiro, regra depois, pessoa por último.

Onde a automação para e a responsabilidade fiscal começa

A leitura da tabela é direta: tudo que é transporte de dado, conferência e repetição vai para o software. Tudo que é interpretação de legislação continua com quem tem responsabilidade técnica sobre ela. Vendedor de sistema que promete cuidar da parte fiscal inteira está prometendo algo que não é dele para prometer.

Regra fiscal no banco, nunca no código

A tributação brasileira muda. A reforma em curso altera modelo de cobrança, cria período de convivência entre tributos e vai exigir ajuste de cadastro e de layout de documento por vários anos. Isso tem uma consequência prática de arquitetura.

Regra fiscal deve estar em tabela versionada com vigência, não em if dentro do código. Na prática:

• Cada regra tem data de início e data de fim de vigência
• A nota emitida guarda qual versão da regra foi usada
• Mudança de alíquota é cadastro, feito pelo contador ou por quem ele orienta, sem release de software
• Reemissão de documento antigo usa a regra vigente na data do fato, não a de hoje

Sistema com regra fiscal no código exige um desenvolvedor a cada alteração de legislação, e alteração de legislação não avisa com antecedência confortável. Foi por esse motivo que, nos sistemas que a Retti Tech mantém em produção, a camada fiscal fica sempre separada da camada de negócio: o que muda por lei precisa mudar sem tocar no resto.

O que monitorar depois que estiver rodando

• Notas rejeitadas nas últimas 24 horas, agrupadas por motivo
• Notas presas em processamento há mais de alguns minutos
• Vencimento do certificado digital, com aviso antecipado
• Títulos vencidos sem baixa e sem tentativa de cobrança
• Lançamentos do extrato sem conciliação há mais de dois dias
• Percentual de baixa automática, que é o melhor termômetro da qualidade do identificador

Se o percentual de baixa automática está baixo, o problema quase sempre está na emissão da cobrança, e não na conciliação. Corrigir a origem custa menos do que criar regra em cima de dado que nasceu sem identificação.