Este serviço é utilizado para consultar o status de processamento de um DCe enviado anteriormente para processamento pelo método de Emissão de DCe
URL
Produção: POST https://dce.ns.eti.br/dce/issue/status
Dados de entrada
| Campo | Ocorrência | Tipo | Descrição |
|---|---|---|---|
| X-AUTH-TOKEN | 1-1 | A | Token de acesso da Software House |
| CNPJ | 1-1 | N | CNPJ do emitente do DCe |
| nsNRec | 1-1 | N | Número do protocolo de recebimento |
Exemplo de requisição
Requisição de status de processamento
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"X-AUTH-TOKEN": "SEU_TOKEN",
"CNPJ": "11111111111111",
"nsNRec": 32
}' \
https://dce.ns.eti.br/dce/issue/status
Dados retornados
| Campo | Descrição | Ocorrência | Tipo | Pai | Observação |
|---|---|---|---|---|---|
| Status | Código de status do processamento | 1-1 | N | ||
| Motivo | Descrição literal do status de processamento | 1-1 | A | ||
| chDCe | Chave do DCe | 1-1 | N | ||
| cStat | Código de status do processamento do DCe na Sefaz | 0-1 | N | Somente em status = 200 | |
| xMotivo | Descrição literal do status de processamento na Sefaz | 0-1 | A | Somente em status = 200 | |
| nProt | Número do protocolo de autorização do DCe na Sefaz | 0-1 | N | Somente em cStat = 100 | |
| dhRecbto | Data e hora do recebimento do DCe pela Sefaz | 0-1 | D | Somente em status = 200 | |
| xml | XML de distribuição do DCe | 0-1 | A | Somente em cStat = 100 | |
| Erro | Objeto contendo as informações de erro ocorrido | 0-1 | O | Somente em status diferente de 200 | |
| cStat | Código de status do erro | 1-1 | N | erro | |
| xMotivo | Descrição literal do erro | 1-1 | A | erro |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Consulta realizada com sucesso",
"chDCe": "43260607364617000135990010000000201107907806",
"cStat": "100",
"xMotivo": "Autorizado o uso do DCe",
"nProt": "3432600000024013",
"dhRecbto": "2026-06-16T11:34:50-03:00",
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><dceProc versao=\"1.00\" xmlns=\"http://www.portalfiscal.inf.br/dce\"><DCe><infDCe versao=\"1.00\"
}
Retorno com erro
{
"status": -2,
"motivo": "Nao foi possivel carregar o status da DCe",
"erro": {
"cStat": 997,
"xMotivo": "Documento não Localizado em Nosso Banco de Dados"
}
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Consulta realizada com sucesso |
| -2 | Nao foi possivel carregar o status da DCe |