Primeiros Passos para Emisão do DPS no ambiente Nacional

Contribuinte API Nacional Produção Restrita
1

Olá, temos visto muitas dúvidas para emissão da NFS-e, gerando um DPS, muita informação, muita documentação e pouco tempo.

Este tópico apresentará em linhas gerais os primeiros passos, manuais etc para se achar e avançar.

Alguns termos são usados e devem ser citados corretamente, ou todos perdem tempo no fórum.

  1. ”Produção Restrita” é conhecido como ambiente de Testes (Homologação é outro ambiente que usam na Receita e gera confusão, entenda como testes
  2. “Producao” o nome é autoexplicativo.
  3. Emissão NFS-e: entenda que seria o contribuinte enviando um DPS para autorizar e receber uma NFS-e, podendo ser na Sefin (AmbienteNacional) ou Município (responsável pela autorização)
  4. Compartilhamento NFS-e: quem compartilha é o Município (distribuição encaminhando NFS-e), os contribuintes podem acessar documentos no ambiente Naciona (ADN) referida como distribuição documento (obtendo a NFS-e, não encaminhando…)
  5. Fornecedor: quem é o responsável pela autorização do documento, geralmente empresas que fornecem sistema especializado aos Municípios, entre eles, serviços de Emissão

Acertado alguns termos, sejam específicos ao comentar, entenda quem está lendo o fórum acaba por deduzir o que você está fazendo, se você é um EMISSOR ou um FORNECEDOR, seja claro, defina qual o seu papel e o que está fazendo…

Portanto, comece acessando a documentação oficial em (OUT/2025):

Nesta página, você terá acesso a Documentação Atual em produção/produção restrita, endereço das APIs e finalmente RTC, que trata especificamente IBSCBS para entrada em Janeiro de 2026.

O manual “Manual Municípios API ADN - Sistema Nacional NFS-e.pdf“ fornecerá as informações para entender o processo, apesar do LINK no final do PDF estar desatualizado e apontar para o swagger que deixou de ser suportado, mas tem as APIs oficiais publicadas.

Os métodos indicados e a descrição estão OK neste manual PDF, leia e tente gerar sua nota.

O fórum vai tentar ajudar na orientação, mas não no passo a passo pois todos estão atarefados. Leia os fóruns e tente entender o conceito, se seguir o manual vai conseguir enviar.

Você pode gerar um XML do DPS e encaminhar usando PostMan ou SoapUI para simular, mas precisará gerar o XML, assinar, compactar (GZIP) e converter para Base64 para usar as ferramentas…

Ainda terá eventos, mas ao entender o envio e consulta, passará para próxima fase.

Nos links da “API no portal NFSe” você terá “SEFIN NACIONAL” e “DANFSE”, um para enviar Xml DPS e ou outro paraa obter o PDF do documento….

URL DOC https://sefin.producaorestrita.nfse.gov.br/API/SefinNacional/docs/index

    POST    ​/nfse
            Recepciona a DPS e Gera a NFS-e de forma síncrona.
            
    GET     ​/nfse​/{chaveAcesso}
            Retorna a NFS-e a partir da consulta pela chave de acesso correspondente (50 posições).

Você está encaminhando DPS para o ambiente Nacional a fim de obter a NFS-e gerada.

No portal você terá algumas funcionalidades para obter a ChaveAcesso caso tenha enviado e perdido a conexão…

Voce acessa o portal e verifica que a NFSeestá autorizada, como proceder? Via DPS, obtenha a chave e baixe o XML da NFS-e

DPS  
-----------------------------------------------------------------------------
GET     /dps​/{id}
        Retorna a chave de acesso da NFS-e a partir do identificador do DPS.
HEAD    /dps​/{id}
        Verifica se uma NFS-e foi emitida a partir do Id do DPS

Leia sobre eventos, por meio deles que por exemplo, poderá cancelar a NFSe

Eventos
------------------
POST
    ​/nfse​/{chaveAcesso}​/eventos
        Recepciona o Pedido de Registro de Evento e gera Eventos de NFS-e, crédito, débito e apuração.
GET
    ​/nfse​/{chaveAcesso}​/eventos​/{tipoEvento}​/{numSeqEvento}
        Retorna NFS-e e seus eventos relacionados a partir da consulta pela chave de acesso da NFS-e.

São os endpoints básicos e que se você ler o manual vai entender….

Para ajudar a se achar: Identificador NFSE é chamado de “ChaveAcesso” …. veja a tag infNFSe

Identificador DPS é gerado por VOCÊ

Caso tenha enviado e ocorrer algum problema, pode obter a ChaveNFSe usando o ID do DPS que você mesmo gerou.

Na documentação, veja o ANEXO I (excel) tem todos os campos e informações.

FORMATO DA CHAVE NFS-e que é retornado pela SEFIN

NFS 11002052212235678000109000000000000323108594720020
“NFS” +
1100205 Cód.Mun. (7) +
2 Amb.Ger. (1) +
2 Tipo de Inscrição Federal (1) +
12235678000109 Inscrição Federal (14 - CPF completar com 000 à esquerda) +
0000000000003 nNFSe (13) +
2310 AnoMes Emis. (4) +
859472002 Cód.Num. (9) +
0 DV (1)

FORMATO do IDENTIFICADOR do DPS que é o XML que você vai gerar…

110020521223567800010900100000000000000001
“DPS” +
1100205 Cód.Mun. (7) Porto Velho/RO 1100205
2 Tipo de Inscrição Federal (1) +
12235678000109 Inscrição Federal (14 - CPF completar com 000 à esquerda) + 12235678000109
00100 Série DPS (5) + 100 (RPS serie)
000000000000001 Núm. DPS (15) 1 (RPS num)
??? Código Descrição [(1)CNPJ, (2)CPF, (3)CAEPF (Cadastro de Atividade Econômica de Pessoa Física), (4)CNO (Cadastro Nacional de Obra)]

Você pode obter um DPS com erro e um DPS que autorizou está na PASTA COMPARTILHADA do Fórum…

ARQUIVOS COMPARTILHADOS grupo “Integracao ADN”

https://drive.google.com/drive/folders/1AlLg13p2nrH_yTaw8HocyNfgl7oPBpjD

Com esta introdução, você pode se achar e ganhar tempo.

Boa Sorte

Emir Toktar

1 curtida