A NFS-e virou nacional.
Uma única API.
O Padrão Nacional NFS-e é obrigatório em todo o Brasil desde janeiro de 2026. Acabou a era das integrações municipais individuais. engineAPI abstrai o ADN, a DPS e as particularidades de cada prefeitura. Você mantém uma integração só.
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 todas as NFS-e do país. É o "SEFAZ das NFS-e", unificado para todos os municípios. 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 trata os dois modos pela mesma API
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" }Principais capitais já no padrão nacional
A adesão ao Padrão Nacional é decisão de cada município e avança a cada mês. A lista abaixo é uma referência das principais capitais — o status oficial de cada cidade está no portal nacional NFS-e. O que garantimos: assim que um município entra no ambiente nacional, ele fica acessível pela mesma API, sem trabalho novo de integração do seu lado.
Emissão pelo Padrão Nacional (SEFIN). Os municípios entram conforme aderem ao ambiente nacional. Consulte a adesão no portal nacional NFS-e ↗ para o status oficial de cada cidade.
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.