O método de download do DCe é responsável por retornar o JSON, XML e o DACE a partir do fornecimento da chave de acesso de um DCe autorizado pela NS DCe API.
URL
Produção: POST https://dce.ns.eti.br/dce/get
Dados de entrada
| Campo | Ocorrência | Descrição |
|---|---|---|
| X-AUTH-TOKEN | 1-1 | Token de acesso do usuário |
| chDCe | 1-1 | Chave de acesso do DCe |
| tpDown | 1-1 | Tipo do download: X - XML J - JSON P - PDF XP - XML e PDF JP - JSON e PDF |
| tpAmb | 1-1 | Tipo de Ambiente: 1 - Produção 2 - Homologação |
Exemplo de requisição
Requisição de download
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"X-AUTH-TOKEN":"SEU_TOKEN",
"chDCe":"44444444444444444444444444444444444444444444",
"tpDown":"XP",
"tpAmb":"2"
}' \
https://dce.ns.eti.br/dce/get
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 | 0-1 | N | ||
| xml | XML de distribuição do DCe autorizado | 0-1 | A | Somente em quando tipo = X ou XP Apenas com status = 200 | |
| nfeProc | Objeto JSON com os dados de distribuição do DCe autorizada | 0-1 | A | Somente em quando tipo = J ou JP Apenas com status = 200 | |
| PDF da DACE | 0-1 | A | Base64 do PDF do DACE Somente em quando tipo = P, JP ou XP Apenas com status = 200 | ||
| Erro | Objeto contendo informações de erro ao carregar o DCe | 0-1 | O | Apenas com status diferente de 200 | |
| cStat | Código do status de 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",
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><dceProc versao=\"1.00\" xmlns=\"http://www.portalfiscal.inf.br/dce\"><DCe>
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Download realizado com sucesso |
| -2 | Tipo de download inválido Obs.: Quando o tipo for diferente X, P, XP ou PX (case-insensitive). |
| -3 | Chave de acesso inválida |
| -4 | DCe não encontrado com a chave de acesso informada |