Integração via API com o Emissor Nacional da NFS-e no ERP: Assinatura XML com Certificado A1 e Automação Fiscal

Como estruturar o microsserviço de assinatura XML, autenticação mTLS com certificado e-CNPJ A1 (.pfx) e filas assíncronas para emissão de NFS-e no padrão nacional.

Com a obrigatoriedade do Emissor Nacional da NFS-e (Ambiente de Dados Nacional — ADN) para milhares de municípios brasileiros e a transição para os leiautes da Reforma Tributária (IBS e CBS), empresas de médio porte e plataformas SaaS B2B precisam substituir o lançamento manual no portal gov.br por uma esteira 100% automatizada via API REST e autenticação mTLS.

1. Requisitos Técnicos da API do Emissor Nacional (mTLS e Assinatura XML)

A comunicação direta entre o ERP da empresa e os endpoints da Sefin Nacional exige autenticação mútua TLS (mTLS) utilizando um Certificado Digital ICP-Brasil do tipo A1 (arquivo .pfx ou .p12) vinculado ao CNPJ emissor.

Para que o serviço em nuvem assine a Declaração de Prestação de Serviços (DPS) sem intervenção humana, o certificado digital precisa ser do modelo A1 em arquivo — que pode ser emitido ou renovado em 10 minutos por videoconferência através do Meu Certificado Fácil.

  • Armazenamento criptografado do arquivo .pfx e da passphrase em cofre de segredos (AWS Secrets Manager / HashiCorp Vault).
  • Geração e assinatura digital XMLDSig (SHA-256) da DPS antes da compressão GZip/Base64 exigida pelo endpoint nacional.
  • Fila de retentativa com backoff exponencial (BullMQ / RabbitMQ) para absorver oscilações de disponibilidade dos servidores governamentais.
  • Monitoramento proativo de vencimento do certificado A1 com alerta automático 30 dias antes da expiração.
Automatizar a emissão de NFS-e direto na baixa do pagamento (PIX/Cartão/Boleto) elimina 100% do retrabalho operacional do financeiro.

2. Conciliação Contábil e Segregação Tributária Automatizada

Além de transmitir o XML, nossa arquitetura valida os códigos de tributação nacional (cTribNac / NBS), retenções na fonte (ISS, IRRF, CSRF e INSS) e exporta os lotes fechados diretamente para a contabilidade consultiva da empresa, como a Uphold Contabilidade.

Conclusão

Integrar seu ERP ou plataforma SaaS diretamente ao Emissor Nacional da NFS-e com assinatura A1 automatizada garante escala operacional, conformidade fiscal e zero atraso no faturamento.

Artigos e Implementações Relacionadas