O método de download do CT-e é responsável por retornar o XML e o DACTE ( Documento Auxiliar de Conhecimento de Transporte Eletrônico ) a partir do fornecimento de uma chave de acesso de um CT-e autorizado.
URL
Versão 3.00
Produção: POST https://cte.ns.eti.br/cte/get/300
Dados de entrada
| Campo | Ocorrência | Descrição |
|---|---|---|
| X-AUTH-TOKEN | 1-1 | Token de acesso do usuário |
| chCTe | 1-1 | Chave de acesso do CT-e |
| tpAmb | 1-1 | Tipo do ambiente de autorização do CT-e: 1 - Produção, 2 - Homologação |
| CNPJ | 1-1 | CNPJ do emitente |
| tpDown | 1-1 | Tipo do download: "X" - XML, "J" - JSON, "P" - PDF, "XP" - XML e PDF, "JP" - JSON e PDF |
| printInfTribFed | 0-1 | True - Possibilita a impressão dos valores de INSS, PIS, COFINS, IR e CSLL. False - Valor Padrão |
| tpImp | 0-1 | Preencher com: 1 - Retrato; 2 - Paisagem. |
Exemplo de requisição
Requisição de download de CT-e
curl -X POST
\-H "Content-Type: application/json"
\-d '{
"X-AUTH-TOKEN":"...",
"chCTe":"44444444444444444444444444444444444444444444",
"CNPJ": "11111111111111",
"tpAmb": "2",
"tpDown":"XP"
}' \
https://cte.ns.eti.br/cte/get/300
Dados retornados
| Campo | Descrição | Observação |
|---|---|---|
| status | Código do status de processamento | |
| motivo | Descrição literal do status de processamento | |
| chCTe | Chave de acesso do CT-e | |
| xml | XML de distribuição do CT-e autorizado | Somente quando tpDown = "X" ( ou "XP" ) e com status = 200 |
| cteProc | Objeto JSON com os dados de distribuição do CT-e autorizado | Somente quando tpDown = "J" ( ou "JP" ) e com status = 200 |
| DACTE | Base64 do PDF do DACTE Somente quando tpDown = "P" ( ou "JP" ou "XP" ) e status = 200 |
|
| erro | Objeto contendo informações de erro ao realizar o download do CT-e | Apenas com status = -6 |
| cStat | Código do status de erro | |
| xMotivo | Descrição literal do erro |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Consulta realizada com sucesso",
"chCTe": "44444444444444444444444444444444444444444444",
"xml": "<cteProc>...</cteProc>",
"pdf: "JVBERi0xLjQKJeLjz..."
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Download realizado com sucesso |
| -2 | Campos obrigatórios na requisição não informados |
| -3 | Tipo de download inválido Obs.: Quando o tipo for diferente "X", "P", "XP" ou "J", "JP, |
| -4 | Chave de acesso inválida |
| -5 | CT-e não encontrado com a chave informada |
| -6 | Erro ao carregar o CT-e |
| -400 | Campos obrigatórios na requisição não informados |