Consulta de Status do Processamento

Este serviço é utilizado para consultar o status de processamento de um MDF-e enviado anteriormente para processamento pelo método de Emissão de MDF-e.

URL

Produção: POST https://mdfe.ns.eti.br/mdfe/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 MDF-e
nsNRec	1-1	N	Número do protocolo de recebimento

Exemplo de requisição

Requisição de status de processamento de CT-e

curl -X POST \
-H "Content-Type: application/json" \
-d '{
     "X-AUTH-TOKEN":"SEU_TOKEN", 
     "CNPJ": "11111111111111", 
     "nsNRec": 1
     }' \
https://mdfe.ns.eti.br/mdfe/issue/status

Dados retornados

Campo	Descrição	Ocorrência	Tipo	Observação
status	Código de status do processamento	1-1	N
motivo	Descrição literal do status de processamento	1-1	A
chMDFe	Chave do MDF-e	1-1	N
cStat	Código de status do processamento do MDF-e 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 MDF-e na Sefaz	0-1	N	Somente em status = 100
dhRecbto	Data e hora do recebimento do MDF-e pela Sefaz	0-1	D	Somente em status = 200
consultarNSNRec	NSNRec do mesmo documento autorizado ou pendente de consulta	0-1	N	Este campo pode aparecer em status = 200 e cStat = 539, se tivermos um nsNRec pendente de consulta ou do mesmo documento autorizado. Caso recebas este campo, consulte novamente o status de processamento com o valor dele.
xml	XML de distribuição do MDF-e	0-1	A	Somente em cStat = 100
erro	Objeto contendo as informações de erro caso a consulta não possa ser realizada com sucesso Detalhamento no Quadro Abaixo	0-1	O	Somente em status diferente de 200

Detalhamento do Objeto erro

Campo	Descrição	Ocorrência	Tipo	Pai
cStat	Código de status do erro	1-1	N
Motivo	Descrição literal do erro	1-1	A

Exemplos de retorno

Retorno com sucesso

{
    "status": 200,
    "motivo": "Consulta realizada com sucesso",
    "chNFe": "43161107364617000135550000000099461000094833",
    "cStat": 100,
    "nProt": "143160001491309",
    "xMotivo": "Autorizado o uso da MDF-e",
    "dhRecbto": "2016-11-21T11:19:42",
    "xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><mdfeProc versao=\"3.10\" xmlns=\"http://www.portalfiscal.inf.br/mdfe\"><MDFe>...</MDFe><protMDFe versao=\"3.10\">...</protMDFe></mdfeProc>"
}

Retorno com erro

{
    "status": -2,
    "motivo": "Nao foi possivel carregar o status da MDF-e",
    "erro": {
        "cStat": 0,
        "xMotivo": "Documento não localizado em nosso banco de dados"
    }
}

Códigos de retorno

Código	Descrição
200	Consulta realizada com sucesso
-2	Não foi possível carregar o status de processamento do MDF-e Verifique o objeto erro para maiores informações

NS MDFe

URL