Reforma Tributária e NFS-e: o que muda na prática para quem emite via API
IBS, CBS, novos campos no layout, coexistência com o ISS — e o que os sistemas emissores precisam fazer antes de 2027.
Uma API para NFS-e em todo o país
Emita NFS-e em qualquer município do Brasil.
Um endpoint e um JSON, do interior à capital. Sem certificado por prefeitura, sem contrato com cada integrador municipal e sem refazer a integração quando o município troca de sistema.
Token de acesso gratuito por 30 dias, enviado por e-mail.
POST
/nfse
{ "identificacaoEmitente": "60670420000107", "notas": [{ "rps": { "numeroRPS": "99", "serie": "1" }, "destinatario": { "razaoSocial": "Cliente Ltda" }, "servicos": [{ "codigo": "01.01", "valorUnitario": 1 }] }] }
201 Created — nota aceita e encaminhada ao município.
Integradores municipais cobertos pela mesma chamada
Cada município do país usa o sistema de um destes integradores. Você continua enviando o mesmo JSON: a tradução para o padrão de cada um acontece do nosso lado.
- Equiplano
- GovBR
- ArrecadaNet
- Nacional
- Betha
- IPM
- Tinus
- Centi
- Ginfes
- Coplan
- Fiorilli
- WebISS
- IssNetOnline
- Freire
- Saatri
- Agili
+3.000
Municípios cobertos pela integração, verificáveis na lista de homologação.
O que muda no seu backlog
Prefeitura que troca de integrador, layout que muda de versão, certificado que vence: esse trabalho para de chegar até você. A mudança acontece na nossa camada e o contrato da API permanece o mesmo.
Como a emissão acontece
-
01
Envie a DPS em JSON
Só os dados da nota. Emitente, série e certificado ficam configurados no portal e não viajam em cada requisição.
-
02
Acompanhe pelo webhook
A prefeitura processa de forma assíncrona. Você recebe a mudança de status no seu endpoint em vez de ficar consultando.
-
03
Consulte pela mesma API
Emissão e consulta usam o mesmo contrato. O status da nota é o mesmo em todos os municípios, sem mapear código de prefeitura.
Os quatro estados de uma nota
O mesmo vocabulário de status aparece na API, no webhook e no portal. Você não precisa mapear código de prefeitura para status interno.
| Status | O que significa |
|---|---|
| Autorizada | Prefeitura aceitou a nota. XML assinado disponível. |
| Processando | Enviada e aguardando retorno do município. |
| Rejeitada | Recusada com o motivo devolvido pela prefeitura. |
| Cancelada | Cancelamento aceito dentro do prazo do município. |
Perguntas de quem vai integrar
A integração é a mesma para NFS-e municipal e NFS-e Nacional, e já acompanha as mudanças da reforma tributária conforme entram em vigor.
Ver documentaçãoPreciso de certificado digital por município?
Não. O certificado do emitente é cadastrado uma vez no portal e vale para todos os municípios em que ele emite.
O que acontece quando a prefeitura muda de sistema?
A adaptação é feita na nossa camada de tradução. O JSON que você envia e o formato do webhook não mudam.
Como sei se um município está coberto?
A lista de municípios homologados fica publicada na documentação e é atualizada a cada nova homologação.
Como testo antes de contratar?
O cadastro gera um token de acesso gratuito por 30 dias, enviado por e-mail, para integrar e testar a API.
No blog
Ver todos os artigos
Lei de Gestão e Administração do IBS
Projeto de lei complementar que trata de questões específicas relacionadas à gestão e à administração do Imposto sobre Bens e Serviços - IBS.
Tem municípios que ainda não integramos?
Mande a lista das cidades em que seus clientes emitem. Respondemos com a cobertura atual e o prazo de homologação das que faltam.
Falar com o time técnico