Cobertura Municipal & Engines NFS-e
A Notaas roteia automaticamente emissões de NFS-e entre 39 famílias de engines (40 identificadores de roteamento), cobrindo 4.782 municípios (85,84% do país) em produção. As particularidades podem estar no payload da nota ou no cadastro do projeto; consulte a matriz antes de emitir.
Snapshot gerado em 17/09/2026 a partir de ibge_municipalities (PostgreSQL): 4.782 ativos, 132 com provedor identificado (aguardando homologação) e 657 sem webservice público — estes dois últimos grupos têm cobertura via SNNFSE quando o prestador é MEI (ver regra abaixo).
Prestadores enquadrados como MEI (regime_tributario = "2") são redirecionados para o Ambiente Nacional da NFS-e, inclusive quando o município possui engine própria. O roteamento é automático, mas o payload continua sujeito às validações fiscais do SNNFSE.
Engines e Sistemas Suportados (39 famílias / 40 identificadores)
Padrão nacional para municípios aderentes e para prestadores MEI
Sistema próprio da Prefeitura de SP — código de serviço municipal
NFSe Nacional SPED v1.00 via SOAP
RPS posicional V4.4 via SOAP e mTLS
ABRASF v2.04 com campos da Reforma Tributária
ABRASF v2.04 via SOAP e mTLS
ABRASF v2.04 (Intersol) via SOAP assíncrono
ABRASF v2.01 com credenciais no XML
ABRASF v2.03 via REST e Basic Auth
ABRASF v2.04 via SOAP e Basic Auth
ABRASF v2.02 via SOAP, XMLDSig e mTLS
Actuar/GINFES via SOAP RPC/literal, XMLDSig e mTLS
NFSe Tributário v1.01 via SOAP e mTLS
ABRASF v2.03 via SOAP e mTLS
ABRASF v1.0 customizado com correlação RTC automática
ISSNet Online do Distrito Federal via SOAP e mTLS
ABRASF v2.04 via SOAP e mTLS
ABRASF v2.03 próprio via SOAP e mTLS
ABRASF v2.04 via SOAP RPC/literal assíncrono
SOAP com XML em CDATA e credenciais municipais
DPS via SOAP, XMLDSig e mTLS
ABRASF via SOAP e Basic Auth
ABRASF v2.03 via SOAP, XMLDSig e mTLS
Proxy REST do padrão nacional com autenticidade municipal
ABRASF SimplISS via SOAP 1.1 + XMLDSig + pParam
ABRASF v2.02 via SOAP 1.1 e XMLDSig — MG/PR/SC
ABRASF v2.0x via SOAP 1.1 e XMLDSig — GO/TO/AP
ABRASF v2.03 via SOAP 1.1 e XMLDSig — AL/PB/PE
ABRASF v2.02 via SOAP 1.1 e XMLDSig — MG
ABRASF v2.02 via SOAP 1.1 e XMLDSig — BA/PI
ABRASF v2.01 via WCF SOAP BasicHttpBinding — BA/SC
ABRASF v2.01 via SOAP 1.1 ASMX (NFSeWS) — RS
API REST JSON própria com Authorization Bearer — CE/MA/PA/RN
Layout próprio esnfs via SOAP 1.1 WCF e XMLDSig — PR
API REST com XML ABRASF v2.03 no body + headers — PB/PE/RN
ABRASF v2.02 via SOAP 1.1, XMLDSig e mTLS — MG/SP
API REST com XML próprio (nfse_v_1.00) + ChaveDigital — AL/MT/RO/PA
ABRASF v2.02 via SOAP 1.1 e XMLDSig — RS
SOAP 1.1 GeneXus (ws_nfe) com Login no body — SP
Matriz de Requisitos de Payload por Engine
“Payload padrão” significa usar os campos documentados em POST /api/v1/emitir. Credenciais, IM, CNAE e certificados pertencem ao cadastro do projeto e não devem ser enviados em cada nota.
| Engine / Provedor | Particularidade no request | Configuração do projeto | Transporte |
|---|---|---|---|
| SNNFSE Federal | servico.codigo; servico.nbs é opcional | Certificado A1 e dados fiscais | REST + GZip + mTLS |
| São Paulo (SP) | servico.codigoServico (ou padrão do projeto) | CCM e certificado A1 | SOAP + XMLDSig + mTLS |
| TBW / SIL | servico.nbs (9 dígitos) | Endereço completo do emitente | SOAP sem mTLS |
| Barueri (SP) | servico.codigoTributacaoMunicipal quando aplicável; RTC é derivado | IM e certificado A1 | SOAP + mTLS |
| GISSOnline / Eicon | servico.nbs recomendado; servico.codigoServico e código municipal quando aplicável | IM e certificado A1 | SOAP + XMLDSig + mTLS |
| EL / Elotech | Endereço do tomador obrigatório; código tributário municipal quando exigido | IM e certificado A1 | SOAP + mTLS |
| SpeedGov | Payload padrão da API | IM e certificado A1 | SOAP sem mTLS |
| Fiorilli / ISSWeb | Payload padrão da API | IM, usuário e senha municipais | SOAP sem mTLS |
| Centi | Payload padrão da API | IM, usuário e senha municipais | REST + Basic Auth |
| AtendeNet / IPM | servico.cnae, servico.nbs e servico.documentoReferencia opcionais | IM, usuário e senha municipais | SOAP + Basic Auth |
| WebISS | Payload padrão da API | IM e certificado A1; CNAE é opcional | SOAP + XMLDSig + mTLS |
| GINFES | servico.nbs opcional; demais campos seguem o payload padrão | IM, CNAE principal e certificado A1 | SOAP + XMLDSig + mTLS |
| COPLAN | servico.nbs opcional; demais campos seguem o payload padrão | Certificado A1 | SOAP + mTLS |
| TINUS | Payload padrão da API | IM e certificado A1 | SOAP + mTLS |
| Salvador (BA) | Payload padrão; RTC é derivado pela Notaas | IM e certificado A1 | SOAP |
| Brasília (DF) | Payload padrão da API | CNAE principal e certificado A1 | SOAP + mTLS |
| ISSNet / Thema | servico.nbs e servico.codigoTributacaoMunicipal opcionais; tomador.inscricaoMunicipal para retenção | CNAE principal e certificado A1 | SOAP + mTLS |
| Campo Grande (MS) | Payload padrão da API (ou servico.CNAE) | IM, CNAE principal (9 dígitos) e certificado A1 | SOAP + mTLS |
| DBSeller | servico.nbs e valores.pisCofins.cst opcionais | IM e certificado A1 | SOAP RPC/literal sem mTLS |
| SIGEP / BSIT | Payload padrão da API | IM, usuário, senha e chave privada | SOAP + CDATA + mTLS |
| Betha | servico.nbs (9 dígitos) | Certificado A1 e cadastro do emitente | SOAP + XMLDSig + mTLS |
| HM2 | Payload padrão da API | IM, usuário e senha municipais | SOAP + Basic Auth |
| DSF | Payload padrão; código municipal quando aplicável | IM, CNAE principal e certificado A1 | SOAP + XMLDSig + mTLS |
| Pronim / Cidade360 | Payload padrão da API / servico.codigoServico e servico.codigoTributacaoMunicipal opcionais | Certificado A1 e cadastro municipal | REST + GZip |
| SimplISS | servico.codigo (LC 116), servico.cnae, servico.nbs (opcional) | IM, usuário e senha web service SimplISS cadastrados nas configurações; Certificado digital A1 ICP-Brasil para assinatura XMLDSig RSA-SHA1 | SOAP 1.1 + XMLDSig + Credenciais (pParam) |
| Futurize | Payload padrão da API | IM e certificado A1 | SOAP 1.1 + XMLDSig + mTLS |
| MegaSoft | Payload padrão da API | IM e certificado A1 | SOAP 1.1 + XMLDSig |
| Tributus | Payload padrão da API | IM e certificado A1 | SOAP 1.1 + XMLDSig + mTLS |
| Síntese | Payload padrão da API | IM e certificado A1 | SOAP 1.1 + XMLDSig + mTLS |
| Fisco | Payload padrão da API | IM e certificado A1 | SOAP 1.1 + XMLDSig + mTLS |
| Saatri | Payload padrão da API | IM e certificado A1 | SOAP WCF + XMLDSig + mTLS |
| ABase | Payload padrão da API | IM e certificado A1 (usado apenas na assinatura XMLDSig — o transporte é HTTPS simples) | SOAP 1.1 + XMLDSig (sem mTLS) |
| Aspec | Payload padrão da API | Chave de autorização do prestador (enviada como Authorization: Bearer) cadastrada nas credenciais municipais | REST JSON + Bearer |
| Equiplano | Payload padrão da API | IM e certificado A1 (assinatura XMLDSig; transporte HTTPS simples nas portas 8444/9443 do esnfs) | SOAP WCF + XMLDSig (sem mTLS) |
| PublicSoft | Payload padrão da API | Token de acesso (header token) e credencial da prefeitura (header codigoCidade) nas credenciais municipais, além do certificado A1 para o XMLDSig | REST XML + Headers (codigoCidade/token) |
| GovDigital | Payload padrão da API | IM e certificado A1 — obrigatório também no handshake TLS (o host rejeita conexões sem certificado cliente) | SOAP 1.1 + XMLDSig + mTLS |
| Agili | Payload padrão da API | ChaveDigital (token de 32 caracteres) nas credenciais municipais e certificado A1 para o XMLDSig | REST XML + ChaveDigital/XMLDSig |
| Tecnos | Payload padrão da API | IM e certificado A1; Endpoint do webservice municipal configurado no projeto (precedência absoluta sobre o mapa padrão) | SOAP 1.1 + XMLDSig + mTLS |
| Conam | Payload padrão da API | CodigoUsuario e CodigoContribuinte (bloco Login do GeneXus) cadastrados nas credenciais municipais | SOAP 1.1 Document/Literal + Login |
Desdobro Municipal (cTribMun) — SNNFSE
Alguns municípios aderentes ao SNNFSE exigem que, além do código nacional (cTribNac), seja informado um desdobro municipal de 3 dígitos (cTribMun) que identifica o serviço no catálogo local da prefeitura.
✅ Resolução Automática (padrão)
A Notaas resolve o cTribMun automaticamente — você não precisa fazer nada. O sistema consulta a tabela de correlação do município e injeta o primeiro desdobro encontrado no XML antes de enviar ao SNNFSE.
🔧 Override Manual (opcional)
Se um cTribNac possui múltiplos desdobros e você precisa selecionar um específico, informe servico.codigoTributacaoMunicipal no request. O valor informado será usado no lugar do automático. Exemplo:
"servico": {
"codigo": "170601",
"codigoTributacaoMunicipal": "002",
"descricao": "Agenciamento de veiculação"
}Consultar Desdobros por cTribNac
Informe um cTribNac para verificar os desdobros disponíveis nos municípios de referência.
Informe o cTribNac (6 dígitos) para consultar os desdobros disponíveis neste município. O primeiro desdobro é usado automaticamente; informe servico.codigoTributacaoMunicipal para override.
GET /api/v1/codigos?codigo=170601&ibge=3106200Busca de Cobertura por Município
Busque qualquer um dos 5.571 municípios brasileiros para ver o status de cobertura, a engine responsável, os campos específicos e um payload de exemplo já customizado para a cidade selecionada.
Digite ao menos 2 caracteres do nome do município (acentos são ignorados) ou o código IBGE de 7 dígitos, ou clique em um atalho acima.
GET /api/v1/cobertura/cidades?q=guarulhos