NFS-e
A Nota Fiscal de Serviço Eletrônica tem um cenário diferente dos documentos estaduais: em vez de um autorizador por estado, historicamente existe um por município, cada um com o próprio layout, credenciais e comportamento — e agora, além deles, o padrão nacional.
O papel do Conota é oferecer uma interface única, absorvendo as diferenças de comunicação.
Antes de integrar
Você precisa conhecer:
- município do prestador;
- inscrição municipal, quando exigida;
- regime e enquadramentos aplicáveis;
- serviço prestado e o código de tributação;
- alíquota e retenções, quando aplicáveis;
- credenciais exigidas pelo município ou provedor.
Nem todo município oferece ambiente de teste, e os que oferecem nem sempre reproduzem o comportamento da produção. Confirme antes de planejar a validação da integração.
Dois caminhos
| Caminho | Quando | Rota |
|---|---|---|
| Padrão Nacional | municípios no Sistema Nacional NFS-e | POST /v1/nfse/emitir |
| Provedor municipal | municípios em provedor próprio | POST /v1/nfse/govdigital/emitir |
A estrutura do payload muda entre eles: o Padrão Nacional usa a DPS (infDPS), enquanto os
provedores municipais seguem o modelo ABRASF. Ver Provedores e municípios.
Rotas
| Operação | Rota |
|---|---|
| Emitir (Padrão Nacional) | POST /v1/nfse/emitir |
| Emitir (provedor municipal) | POST /v1/nfse/govdigital/emitir |
| Consultar | GET /v1/nfse/consultar/{job_id} |
| Baixar arquivo | GET /v1/nfse/{job_id}/file/{tipo} |
| Cancelar | POST /v1/nfse/cancelar |
| Consultar por RPS | GET /v1/nfse/{cpf_cnpj}/consultar-rps |
| Consultar no ambiente nacional | POST /v1/nfse/consultar-sefaz |
As rotas com {cpf_cnpj} no caminho são anteriores e seguem mantidas por compatibilidade.
Integrações novas devem usar as rotas assíncronas com cpf_cnpj no corpo.