Resposta rápida: para adequar um ERP à NFS-e Nacional, a software house precisa gerar a DPS no leiaute nacional, assinar e enviar pela API com o certificado de cada cliente, mapear os serviços para o Código de Tributação Nacional, tratar retornos e eventos, e manter fila, log e monitoramento. A decisão principal é se o time vai construir e manter essa camada internamente ou usar uma API pronta e focar no produto.
O padrão nacional simplifica a vida de quem atendia dezenas de prefeituras com layouts diferentes. Mas, para uma software house, a migração tem um peso extra: são muitos clientes, com certificados, municípios e regras de tributação diferentes, todos precisando emitir sem interrupção. Este checklist ajuda a planejar a adequação sem surpresas.
Checklist de adequação do ERP
- Geração da DPS no leiaute nacional, validada contra o XSD da versão vigente, incluindo os grupos de IBS e CBS.
- Gestão de certificados por cliente: upload seguro do A1, armazenamento criptografado, alerta de vencimento e troca sem parar a emissão.
- Assinatura e envio com mTLS usando o certificado do cliente certo em cada requisição.
- Mapeamento de serviços: de-para entre os serviços cadastrados no ERP e o Código de Tributação Nacional e a NBS.
- Regras de tributação por município e regime: alíquota, retenção de ISS, Simples Nacional, regimes especiais.
- Controle de numeração no servidor, por cliente e série, com proteção contra duplicidade.
- Fila e retentativa idempotente para quando o serviço nacional estiver instável.
- Tratamento de retornos: armazenar XML da NFS-e, chave de acesso e DANFSe, e mostrar ao usuário o motivo da rejeição em linguagem clara.
- Eventos: cancelamento e substituição de nota pela API.
- Log e auditoria de cada requisição e resposta, com busca por cliente e por nota.
- Ambiente de testes apontando para a Produção Restrita, para validar cenários de cada cliente antes da virada.
- Plano de migração dos clientes em ondas, começando pelos de menor risco, com comunicação e suporte reforçado na virada.
Construir internamente ou usar uma API pronta?
As duas escolhas funcionam. O que muda é onde o seu time vai gastar energia.
Construir internamente faz sentido quando
- O time já domina assinatura XML, certificados e mTLS.
- Há gente disponível para acompanhar notas técnicas e mudanças de leiaute de forma contínua.
- A emissão fiscal é parte central do diferencial do produto.
Usar uma API pronta faz sentido quando
- O prazo é curto e o time está ocupado com o roadmap do produto.
- Você ainda atende municípios fora do padrão nacional (ABRASF e webservices próprios) e quer uma integração única para todos.
- A Reforma Tributária vai exigir novas mudanças de leiaute nos próximos anos e você não quer manter isso sozinho.
Erros que mais atrasam a migração
- Deixar o certificado do cliente na máquina do usuário em vez do servidor.
- Emitir de forma síncrona na tela, sem fila: quando o serviço oscila, o usuário clica de novo e duplica a nota.
- Permitir que o usuário digite alíquotas e códigos livremente na emissão.
- Migrar todos os clientes de uma vez, sem piloto.
- Não guardar o XML enviado: sem ele, cada rejeição vira uma investigação.
Perguntas frequentes
O ERP precisa de um certificado próprio?
Não. A emissão é feita com o certificado de cada prestador, ou seja, de cada cliente do ERP. A software house precisa armazenar e usar esses certificados com segurança.
Clientes em municípios que não usam o padrão nacional continuam no layout antigo?
Depende do município e do enquadramento do cliente. Por isso, muitas software houses mantêm uma camada que fala tanto com o padrão nacional quanto com os webservices municipais, atrás de uma interface única.
Quanto custa adequar o ERP?
Varia com o número de clientes, municípios e cenários de tributação. O caminho mais seguro é um diagnóstico do sistema atual antes de fechar escopo e prazo.
A iLAB4 integra ERPs e sistemas de software houses à NFS-e Nacional e às prefeituras, com API REST documentada, homologação e suporte na virada. Conheça a integração de NFS-e ou peça um diagnóstico gratuito.
