Este serviço é utilizado para consultar o status de processamento de uma NF-e enviada anteriormente para processamento pelo método de Emissão de NF-e.
URL
Produção: POST https://nfe.ns.eti.br/nfe/issue/status
Dados de entrada
| Campo | Ocorrência | Descrição |
|---|---|---|
| X-AUTH-TOKEN | 1-1 | Token de acesso do usuário |
| CNPJ | 1-1 | CNPJ do emitente da NF-e |
| nsNRec | 1-1 | Número do protocolo de recebimento |
Exemplo de requisição
Requisição de status de processamento de NF-e
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"X-AUTH-TOKEN":"SEU_TOKEN",
"CNPJ":"07364617000135",
"nsNRec":"123456"
}' \
https://nfe.ns.eti.br/nfe/issue/status
Dados retornados
| Campo | Ocorrência | Observação |
|---|---|---|
| status | Código de status do processamento | |
| motivo | Descrição literal do status de processamento | |
| chNFe | Chave da NF-e | Somente em status = 200 |
| cStat | Código de status do processamento da NF-e 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 NF-e na Sefaz | Somente em cStat = 100 |
| dhRecbto | Data e hora do recebimento da NF-e pela Sefaz | Somente em status = 200 |
| xml | XML de distribuição da NF-e | |
| 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 |
Detalhamento do Objeto erro
| Campo | Descrição |
|---|---|
| cStat | Código de status do erro |
| xMotivo | Descrição literal do erro |
Exemplos de retorno:
Retorno com sucesso
{
"status": 200,
"motivo": "Consulta realizada com sucesso",
"chNFe": "43161107364617000135550000000099461000094833",
"cStat": 100,
"nProt": "143160001491309",
"xMotivo": "Autorizado o uso da NF-e",
"dhRecbto": "2016-11-21T11:19:42",
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><nfeProc versao=\"3.10\" xmlns=\"http://www.portalfiscal.inf.br/nfe\"><NFe>...</NFe><protNFe versao=\"3.10\">...</protNFe></nfeProc>"
}
Retorno com erro
{
"status": -2,
"motivo": "Nao foi possivel carregar o status da NF-e",
"erro": {
"cStat": 0,
"xMotivo": "Documento não localizado em nosso banco de dados"
}
}
Códigos de retorno
| Campo | Descrição |
|---|---|
| 200 | Consulta realizada com sucesso |
| -2 | Não foi possível carregar o status de processamento da NF-e Verifique o objeto erro para maiores informações |
| -6 | Documento já Recebido, porem ainda sem status de processamento, por favor consulte o status de processamento do NSNRec informado". |
| -7 | Documento já Processado anteriormente e Autorizado. |