Neste endpoint é possível consultar o retorno do processamento de uma NFSe utilizando o nsNRec de uma emissão bem sucedida, bem como obter o XML e link para impressão.
URL
Produção: POST https://nfsenacional.ns.eti.br/nfse/issue/status
Dados de entrada
| Campo | Ocorrência | Descrição | Tipo | Tamanho | Observação |
|---|---|---|---|---|---|
| X-AUTH-TOKEN | 1-1 | Token de acesso do usuário | String | Pode ser enviado no header | |
| CNPJ | 1-1 | CNPJ do emitente da NFSe | String | 14 | |
| nsNRec | 1-1 | Número do protocolo de recebimento | Inteiro |
Exemplo de requisição
Requisição de status de processamento da NFSe
curl -X POST
\-H "Content-Type: application/json"
\-d '{"X-AUTH-TOKEN":"SEU_TOKEN","CNPJ":"99999999999999", "nsNRec":"123456"}'
\https://nfsenacional.ns.eti.br/nfse/issue/status
Dados retornados
| Campo | Ocorrência | Observação |
|---|---|---|
| status | Código de status do processamento | |
| motivo | Descrição literal do status de processamento | |
| chDPS | Chave da DPS | Somente em status = 200 |
| chNFSe | Chave da NFSe | Somente em status = 200 |
| cStat | Código de status do processamento da NFSe na Sefaz | Somente em status = 200 |
| xMotivo | Descrição literal do status de processamento na Sefaz | Somente em status = 200 |
| nProt | Número do protocolo de autorização da NFSe na Sefaz | Somente em cStat = 100 |
| dhRecbto | Data e hora do recebimento da NFSe pela Sefaz | Somente em status = 200 |
| xml | XML de distribuição da NFSe | |
| erro | Objeto contendo as informações de erro caso a consulta não possa ser realizada com sucesso Detalhamento no Quadro Abaixo | Somente em status diferente de 200 |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Consulta realizada com sucesso",
"chDPS": "310620021327800500012200001000000000000015",
"chNFSe": "31062002213278005000122000000000001525126902998045",
"cStat": "100",
"xMotivo": "Autorizado o Uso do Documento",
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><NFSe versao=\"1.01\" xmlns=\"http://www.sped.fazenda.gov.br/nfse\"...
}
Retorno com erro
{
"status": 200,
"motivo": "Consulta realizada com sucesso",
"chDPS": "310620021327800500012200001000000000000010",
"chNFSe": "null",
"cStat": "-1",
"xMotivo": "Erro HTTP 400: {"tipoAmbiente":2,"versaoAplicativo":"SefinNac_Pre_1.4.0","dataHoraProcessamento":"2025-12-12T16:37:23.9098645-03:00","idDPS":"DPS310620021327800500012200001000000000000010","erros":[{"Codigo":"E0014","Descricao":"Conjunto de Série, Número, Código do Município Emissor e CNPJ/CPF informado nesta DPS já existe em uma NFS-e gerada a partir de uma DPS enviada anteriormente."}]}"
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | NFSe recebida com sucesso e enviada para Sefaz |
| -2 | Nao foi possivel carregar o status da NFS-e Verifique o campo xMotivo para identificar os campos incorretos |
| -400 | Campos obrigatórios não informados: {CAMPOS} |