Guia de Acesso ao Sistema Nacional da NFS-e

:blue_book: Guia de Acesso ao Sistema Nacional da NFS-e

Este guia reúne os principais links oficiais do Sistema Nacional da Nota Fiscal de Serviço Eletrônica (NFS-e).
Está dividido em grupos de acesso para Contribuintes e Prefeituras / Fisco, contemplando os ambientes de Produção Restrita (testes) e Produção (oficial).


:globe_showing_europe_africa: Ambientes Disponíveis

Ambiente Finalidade
Produção Restrita (Testes) Homologação de sistemas e emissão de notas fictícias
Produção (Oficial) Emissão e fiscalização de NFS-e com validade jurídica

:bust_in_silhouette: Contribuintes

Produção Restrita (Testes)


Produção (Oficial)


:classical_building: Prefeituras / Fisco

Produção Restrita (Testes)

  • Painel Municipal
    Acessar – Gestão de municípios conveniados, cadastros e fiscalização em ambiente de testes.

  • Painel Nacional
    Acessar – Consulta e administração de convênios em homologação.

  • Swagger Fisco (APIs)
    Acessar – Documentação técnica da API destinada a municípios e órgãos fiscais.


Produção (Oficial)

  • Painel Municipal
    Acessar – Administração oficial dos municípios conveniados.

  • Painel Nacional
    Acessar – Administração nacional e integração com a RFB.

  • Swagger Fisco (APIs)
    Acessar – API oficial de fiscalização e controle para municípios e Receita Federal.


:link: Endpoints de Distribuição (Produção)

  • O serviço de distribuição é o meio de o município buscar os documentos fiscais que se encontram no Ambiente da Dados Nacional (ADN). São duas as formas de buscar os documentos:

  • Municípios Conveniados
    Inclui todas as notas (MEI ou não).

    https://adn.nfse.gov.br/municipios/dfe/0?tipoNSU=DISTRIBUICAO&lote=true
    
  • Municípios Não Conveniados (apenas MEI)

    https://adn.nfse.gov.br/municipio/DFe/0?tipoNSU=MEI&lote=true
    

:memo: Primeiro Acesso

  1. Acesse o Painel Nacional (produção restrira (teste) ou produção).
  2. Clique em “Acesso com gov.br”.
  3. Utilize conta gov.br nível prata ou ouro.
    • Empresas / MEI: e-CNPJ ou conta vinculada ao CNPJ.
    • Municípios: o gestor deve estar previamente cadastrado no convênio.
  4. Aceite os termos e configure as permissões.

:warning: Considerações Importantes

  • Sempre utilize primeiro o ambiente de testes para homologação.
  • Municípios precisam formalizar convênio para acessar os endpoints completos.
  • O Swagger Fisco é obrigatório para quem integra do lado do município / fiscalização.
  • A Consulta Pública pode ser feita sem login.
1 curtida

:warning: [AVISO] Endpoint do DANFSe atualizado — Swagger desatualizado

:pushpin: O endpoint da API de DANFSe no Swagger do ambiente de Produção Restrita (Contribuinte) foi alterado recentemente, e a imagem/documentação atual está desatualizada.


:repeat_button: Mudança no endpoint

Situação URL
:cross_mark: https://sefin.producaorestrita.nfse.gov.br/SefinNacional/danfse/{chaveAcesso}
:white_check_mark: https://adn.producaorestrita.nfse.gov.br/danfse/{chaveAcesso}

:camera: A imagem abaixo mostra o print antigo do Swagger:

url da documentação apenas do método DANFSe

https://adn.producaorestrita.nfse.gov.br/contribuintes/docs/index.html

:warning: [AVISO] Endpoint do Parâmetros Municipais atualizado — Swagger desatualizado

:pushpin: O endpoint da API de Parâmetros Municipais Swagger do ambiente de Produção Restrita (Contribuinte) foi alterado recentemente, e a imagem/documentação atual está desatualizada.


:repeat_button: Mudança no endpoint

Situação URL
:cross_mark: https://sefin.producaorestrita.nfse.gov.br/SefinNacional/parametros_municipais/{codigoMunicipio}/convenio
:white_check_mark: https://adn.producaorestrita.nfse.gov.br/parametrizacao/{codigoMunicipio}/convenio

:camera: A imagem abaixo mostra o print antigo do Swagger:

url da documentação apenas do método Parâmetros Municipais

https://adn.producaorestrita.nfse.gov.br/parametrizacao/docs/index.html

Boa tarde! Não estou conseguindo fazer login usando certificado digital ou conta gov no produção restrita, sabe dizer se essas opções estão operacionais? O certificado digital retorna o erro 403 - Forbidden, e o acesso com a conta gov cai em uma página de erro comum (o site redireciona para o link localhost).

Desde já, muito obrigado.

Qual endereço você está tentando acessar?

Elisabete, boa tarde! Estou tentando pelo NFS-e | Portal Contribuinte . Pelo NFS-e | Portal Contribuinte também dá o mesmo erro.