RPA de Emissão de NF-e em Massa

O problema

E-commerce de volume (1K+ pedidos/dia) enfrenta gargalo fiscal severo: emissão de NF-e leva horas em vez de minutos, e qualquer erro de CFOP, ICMS ou ICMS-ST trava o pedido inteiro.

Causas raiz:

• CFOP varia por UF de destino, tipo de produto, regime tributário
• Substituição tributária (ICMS-ST) tem regras de origem/destino diferentes
• DIFAL precisa ser calculado em vendas interestaduais
• Cada NF gera obrigação fiscal (SPED, EFD, GIA, etc)
• Rejeição da SEFAZ trava pedido e gera reprocessamento manual

Time fiscal trabalha em modo apagar incêndio. Cliente espera 3-7 dias para receber NF anexa. Black Friday vira pesadelo.

A solução

Pipeline de emissão em massa com:

1. CFOP automático por origem/destino/tipo de produto (base de regras + LLM para casos ambíguos)
2. Cálculo de ICMS, ICMS-ST, DIFAL, IPI, PIS, COFINS por UF
3. Validação prévia (cross-check antes de enviar SEFAZ) - reduz rejeições para < 1%
4. Envio paralelo para SEFAZ de cada UF (42 NFs/min sustentado)
5. Retry automático em rejeições temporárias
6. Baixa de estoque no ERP após autorização
7. Distribuição da NF (PDF para cliente, XML para contabilidade)

Métricas em produção

Cliente fashion premium (5K pedidos/dia em pico, 9 estados):

Black Friday 2025: 38K NFs emitidas em 14h sem intervenção humana. Zero pedidos travados.

O que vem incluso

• Pipeline Python + FastAPI com NF-e Express ou Tecnospeed integrados
• Base de regras CFOP versionada por UF + atualizada quando muda legislação
• Calculadora de impostos (ICMS, ICMS-ST, DIFAL, IPI, PIS, COFINS) por UF
• Validador prévio (catch comum de rejeição antes do envio)
• Integração SEFAZ dos 27 estados + DF
• Painel fiscal: NFs emitidas/dia, rejeições por motivo, top produtos
• Reprocessamento automático de rejeições temporárias
• Audit log para fiscalização

Stack

• Python 3.13 + FastAPI + Pydantic v2
• Postgres para histórico + audit
• Redis (filas para SEFAZ por UF)
• n8n para orchestration

Compliance fiscal

• NF-e versão 4.0 (atual)
• MOC 6.0 (manual de orientação ao contribuinte)
• SPED Fiscal + EFD-Contribuições gerados automaticamente
• GIA mensal por UF
• DIFAL EC 87/2015 calculado corretamente
• REINF e DCTFWeb integrados

Tempo de implementação

3-5 semanas:

• Sprint 1: integração com emissor (Tecnospeed/NF-e Express) + ERP
• Sprint 2: base de regras CFOP + calculadora de impostos das top 5 UFs
• Sprint 3: validador prévio + retry de rejeições
• Sprint 4: SEFAZ das UFs restantes + painel
• Sprint 5: stress test (Black Friday simulado) + rollout

FAQ

Quanto custa rodar? Tecnospeed/NF-e Express cobra ~R$ 0,15 por NF. Para 100K NFs/mês: ~R$ 15K. Setup: R$ 55K-120K. Licença anual: R$ 28K-65K. ROI 3-5 meses.

Funciona com qualquer ERP? Adapters prontos para TOTVS, SAP B1, Omie, ContaAzul, Bling, Tiny. ERP custom: 2-4 dias de integração.

E se um produto novo aparece sem CFOP cadastrado? LLM (GPT-4o) sugere CFOP baseado em descrição + NCM + tipo de operação. Cliente revisa antes de aprovar para uso permanente. Próximas NFs do mesmo produto usam o CFOP aprovado.

Suporta venda em marketplace (Mercado Livre, Amazon)? Sim. Identifica origem do pedido + ajusta CFOP automaticamente (ex: CFOP 5102 vs 6102). Algumas plataformas exigem operação intercompany, também suportado.

E DIFAL pra venda interestadual? Calculado automaticamente com base na alíquota interestadual + alíquota interna do destino. Painel mostra DIFAL devido por mês.

Funciona com NF de Serviço (NFS-e)? Suportamos NFS-e dos 50 municípios maiores (cada um tem padrão próprio). Para municípios menores: 2-5 dias de integração.

Como atualiza quando muda legislação? Monitoramos publicações da SEFAZ de cada UF mensalmente. Atualizações de regras vão automaticamente para todos os clientes via deploy.

E rejeição "Schema XSD inválido"? Validador prévio cobre 95% dos casos. Os 5% restantes (raros) são logados, alertam o time fiscal, e o pipeline tenta auto-fix com retry exponential backoff.