A NFS-e virou nacional.
Uma única API.
O Padrão Nacional NFS-e (SEFIN) unifica a emissão de serviços no país. A emissão do engineAPI está provada em produção em Jandaia/GO, e os municípios que já aderiram ao ambiente nacional usam a mesma API. Confira o provado por município em /cobertura.
O que mudou para sua software house
Antes de 2026, integrar NFS-e em 10 cidades diferentes significava manter 10 integrações diferentes. Isso acabou.
Os 3 termos que você precisa conhecer
O documento intermediário que substitui as antigas "RPS" (Recibo Provisório de Serviços) de cada município. A DPS contém os dados do prestador, tomador, serviço (CNAE), valor e ISS. Você envia a DPS e o ADN converte em NFS-e.
A infraestrutura central operada pela Receita Federal que recebe, valida, processa e armazena as NFS-e do Padrão Nacional. É o "SEFAZ das NFS-e", unificado para os municípios no ambiente nacional. Prefeituras integradas ao ADN não precisam mais de servidor próprio de NFS-e.
Órgão responsável por publicar as Notas Técnicas (NTs), schemas e regras de validação do Padrão Nacional. Toda mudança de layout ou nova obrigatoriedade passa por aqui antes de chegar ao ADN. É o equivalente do ENCAT para NF-e, mas focado em serviços municipais.
Como os municípios se conectam ao padrão
Cada prefeitura participa do padrão nacional por um destes dois modos. Nos dois, o destino é o mesmo ambiente nacional: você envia a DPS e o engineAPI cuida do caminho até a NFS-e autorizada.
Modo 1 · Emissor Nacional
Ambiente nacionalA prefeitura adota o ambiente nacional (Emissor Nacional da NFS-e / SEFIN). Os prestadores emitem direto pelo sistema nacional ou via API, sem sistema municipal próprio.
- Um único ponto de integração
- Schema unificado (DPS → NFS-e)
- Atualizações de layout centralizadas
Modo 2 · Sistema próprio + ADN
Convênio com o ADNA prefeitura mantém o sistema municipal próprio, mas transmite os dados ao ambiente nacional (ADN). Os prestadores usam o portal do município ou a API.
- Mantém particularidades locais (ISS diferenciado, benefícios fiscais)
- Portal próprio para os contribuintes da cidade
- engineAPI atende pela mesma API os municípios no ambiente nacional
Da DPS à NFS-e em 4 etapas
Seu sistema envia a DPS
Declaração de Prestação de Serviços: o documento que descreve o serviço prestado (tomador, prestador, valor, ISS, CNAE).
engineAPI valida e transmite
O motor valida o schema da DPS e a transmite ao ambiente nacional (ADN), com os erros já tratados antes de chegar ao governo.
ADN processa e retorna a NFS-e
O Ambiente de Dados Nacional valida, calcula o ISS e emite a NFS-e com número, código de verificação e PDF. O engineAPI devolve tudo à sua aplicação.
Webhook notifica seu sistema
Eventos em tempo real: NFS-e emitida, cancelada ou substituída. Sem polling manual.
POST /v1/nfse/emit
{
"issuer_id": "iss_abc123",
"service": {
"description": "Desenvolvimento de software customizado",
"cnae": "6201-5/01",
"city_code": "3550308", // ← IBGE São Paulo (roteado automaticamente)
"value": 15000.00,
"iss_rate": 2.0 // ← alíquota do município
},
"taker": {
"document": "12.345.678/0001-90",
"name": "Empresa Tomadora Ltda.",
"address": { "city_code": "3550308", "state": "SP" }
}
}
// Resposta:
// { "nfse_number": "000001234", "verification_code": "ABC-DEF-GHI",
// "pdf_url": "https://...", "xml_url": "https://...",
// "status": "AUTHORIZED" }Onde a emissão está provada
Só aparece como provado o município com emissão autorizada de verdade. Demais municípios no ambiente nacional usam o mesmo contrato e a mesma API, ainda sem emissão real medida. O status oficial de adesão de cada cidade está no portal nacional NFS-e. Detalhe por documento e UF em /cobertura.
Emissão provada em produção em Jandaia/GO. Os demais municípios entram conforme aderem ao ambiente nacional. Consulte a adesão no portal nacional NFS-e ↗ para o status oficial de cada cidade, e o provado pelo engineAPI em /cobertura.
Pare de manter integração
município por município.
Uma DPS, o padrão nacional da NFS-e via engineAPI. Sandbox ativo em 5 minutos, sem reunião comercial.