Fluxo correto para emissão de NFSe

Documentos Fiscais
1

Bom dia

Gostaria de confirmar o fluxo correto para emissão de uma NFSe.

Realizei a geração de uma nota com o endpoint:
https://api.nuvemfiscal.com.br/nfse/dps

Após tentei baixar o PDF com o endpoint:
https://api.nuvemfiscal.com.br/nfse/nfs_3a1df60feb18495ca453c77b74da719f/pdf
(já com o ID retornada na geração)

Porém, recebo a mensagem:

{
“error”: {
“code”: “NfseXmlNotFound”,
“message”: “Xml não encontrado.”
}

Agora pergunto: depois de gerar a nota e receber o ID, preciso fazer algum outro processamento antes de conseguir baixar o PDF ?

2

Bom dia, @wagner. Seja bem-vindo à Nuvem Fiscal.

A emissão de NFS-e via API ocorre de forma assíncrona. Isso significa que, depois de enviar o pedido de emissão (POST /nfse/dps), a nota ainda estará em processamento.

Para prosseguir, é necessário consultar o status da NFS-e utilizando o id retornado na criação (GET /nfse/{id}). Assim que a prefeitura autorizar a nota, o XML e o PDF serão gerados e ficarão disponíveis para download.

3

Consegui progredir um pouco…
Agora, mesmo tendo colocado o usuário e senha que usamos no acesso ao site da prefeitura na emissão de notas fiscais (NOVO HAMBURGO - RS) estou recebendo a mensagem abaixo ao consultar a nota fiscal:

{
“id”: “nfs_3a1df6d54bff4cce884ccf6a4cb88c36”,
“created_at”: “2025-12-02T14:40:36.304Z”,
“status”: “erro”,
“ambiente”: “homologacao”,
“referencia”: “000001”,
“DPS”: {
“serie”: “2”,
“nDPS”: “517”
},
“mensagens”: [
{
“codigo”: “401”,
“descricao”: “Acesso Negado!”
},
{
“codigo”: “HTTP 401”,
“descricao”: “<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?>\nAcesso Negado!EST401\n”
}
]
}

Será que existe alguma coisa que estou esquecendo?

4

@wagner

Verifique com a prefeitura se as credenciais de acesso para emissão via integração (webservice) estão corretas. É possível que não seja a mesma para acesso via portal.