CustomShopifyVTEXMagentoAutomation
RPA de Emissão de NF-e em Massa
Emite 2.500+ NFs/dia com CFOP correto por UF, baixa estoque, envia ao SEFAZ. 100% conforme legislação fiscal de cada estado.
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:
- CFOP automático por origem/destino/tipo de produto (base de regras + LLM para casos ambíguos)
- Cálculo de ICMS, ICMS-ST, DIFAL, IPI, PIS, COFINS por UF
- Validação prévia (cross-check antes de enviar SEFAZ) - reduz rejeições para < 1%
- Envio paralelo para SEFAZ de cada UF (42 NFs/min sustentado)
- Retry automático em rejeições temporárias
- Baixa de estoque no ERP após autorização
- 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):
| Indicador | Antes | Depois |
|---|---|---|
| Tempo de emissão (1K NFs) | 4-6 horas | 24 minutos |
| Taxa de rejeição SEFAZ | 12% | 0.4% |
| Pedidos parados por NF | 8-15% | 0% |
| Tempo entre pedido e NF | 24-72h | 90 segundos |
| Headcount fiscal | 6 FTEs | 2 FTEs |
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
Perguntas frequentes