Endpoint:
• www.jadlog.com.br/embarcador/api/tracking/consultar
Método:
• POST
Header:
• Content-Type: application/json
• Authorization: <token>
[{"key":"Authorization","value":"Bearer eyJBNHciOiJIUzI1NiJ9.eyJqdPOPOiI2KzMLACJ9.fC7XN-f2e7QIppp42aE_nuqQY12phUASY3iPMqH6x0Y","description":""}
TRACKING CONSULTA | ||||||||
# | Campo | Nível | Descrição | Ele | Tipo | Tam | Ocorr. | Observações |
1 | consulta | 0 | Grupo de itens para consulta | GA |
|
| 1-20 |
|
2 | cte | 1 | Numero de rastreamento Jadlog | E | string | 14 | 0-1 |
|
3 | shipmentId | 1 | Numero Jadlog específico para o cliente | E | string | 14 | 0-1 |
|
4 | codigo | 1 | ID da solicitação | E | string | 13 | 0-1 |
|
5 | pedido | 1 | Numero do pedido do cliente | E | string | 20 | 0-1 |
|
6 | df | 1 | Grupo de documentos fiscais | G |
|
| 0-1 |
|
7 | danfe | 2 | Numero da DANFE | E | string | 14 | 0-1 |
|
8 | nf | 2 | Numero da nota fiscal | E | string | 15 | 0-1 |
|
9 | serie | 2 | numero da serie da Nota Fiscal | E | string | 3 | 0-1 | Em conjunto com nf |
10 | tpDocumento | 2 | Tipo Documento fiscal | E | integer | 1 | 1-1 | 0=Declaracao; 1=NF; 2=NFE; 4=CTE; |
11 | cnpjRemetente | 2 | CNPJ do remetente | E | string | 14 | 0-1 | Informar somente se cnpj remetente for diferente do cliente |
Possibilidades de filtros para pesquisa
1. Por cte (número JADLOG gerado na emissão)
{
"consulta" : [
{ "cte" : "18109000000000" },
{ "cte" : "18109000000001" },
{ "cte" : "10080000000001" }
]
}
2. Por shipmentId
{
"consulta" : [
{ "shipmentId" : "00000000000000" },
{ "shipmentId" : "00000000000001" },
{ "shipmentId" : "00000000000011" }
]
}
3. Por código (número JADLOG gerado ao inserir pedido eletrônico)
{
"consulta" : [
{ "codigo" : "12345670" },
{ "codigo" : "12345671" },
{ "codigo" : "12345673" }
]
}
4. Por número do pedido do cliente
{
"consulta" : [
{ "pedido" : "12345670" },
{ "pedido" : "12345671" },
{ "pedido" : "12345673" }
]
}
5. Por nota fiscal do cliente
Para essa consulta existe a possibilidade de se passar um CNPJ, caso a NF pertença a um CNPJ diferente do cadastro do cliente.
a. Por número da DANFE
{
"consulta": [{
"df": {
"danfe": "00000000000000000000000000000000000000000000",
"cnpjRemetente": "00000000000000",
"tpDocumento": 2
}
},
{
"df": {
"danfe": "00000000000000000000000000000000000000000001",
"cnpjRemetente": ”00000000000001”,
"tpDocumento": 2
}
}
]
}
b. Por número de nota fiscal
{
"consulta": [{
"df": {
"nf": "12345",
"cnpjRemetente": "0000000000000”, "
tpDocumento ":1
}
},
{
"df": {
"nf": "12346",
"cnpjRemetente": "00000000000001",
"tpDocumento": 1
}
}
]
}
O retorno acrescentará o grupo “tracking” caso localize o envio ou o grupo “erro”.
TRACKING CONSULTA – RETORNO | ||||||||
# | Campo | Nível | Descrição | Ele | Tipo | Tam | Ocorr. | Observações |
1 | consulta | 0 | Grupo de itens para consulta | GA |
|
| 1-20 |
|
2 | cte | 1 | Numero de rastreamento Jadlog | E | string | 14 | 0-1 |
|
3 | shipmentId | 1 | Numero Jadlog específico para o cliente | E | string | 14 | 0-1 |
|
4 | codigo | 1 | ID da solicitação | E | string | 13 | 0-1 |
|
5 | pedido | 1 | Numero do pedido do cliente | E | string | 20 | 0-1 |
|
6 | df | 1 | Grupo de documentos fiscais | G |
|
| 0-1 |
|
7 | danfe | 2 | Numero da DANFE | E | string | 14 | 0-1 |
|
8 | nf | 2 | Numero da nota fiscal | E | string | 15 | 0-1 |
|
9 | serie | 2 | numero da serie da Nota Fiscal | E | string | 3 | 0-1 | Em conjunto com nf |
10 | tpDocumento | 2 | Tipo Documento fiscal | E | integer | 1 | 1-1 | 0=Declaracao; 1=NF; 2=NFE; 4=CTE; |
11 | cnpjRemeten | 2 | CNPJ do remetente | E | string | 14 | 0-1 | Informar somente se cnpj remetente for diferente do cliente |
12 | tracking | 1 | Grupo com dados do tracking | G |
|
| 0-1 | Preenchido quando tracking localizado |
13 | codigo | 2 | Numero de rastreamento Jadlog após emissão | E | string | 14 | 1-1 |
|
14 | shipmentId | 2 | Numero Jadlog específico para o cliente | E | string | 14 | 1-1 |
|
15 | dacte | 2 | Numero do DACTE | E | string | 44 | 0-1 | Preenchido se existir |
16 | dtEmissao | 2 | Data em que o envio foi emitir | E | string | 10 | 1-1 | Formato: DD/MM/YYYY |
17 | status | 2 | Descrição do status atual | E | string | 30 | 1-1 |
|
18 | valor | 2 | Valor do envio | E | double |
| 1-1 |
|
19 | peso | 2 | Peso taxado | E | double |
| 1-1 |
|
20 | volumes | 2 | Dados dos volumes | E | array[grupovolume] |
| 1-N |
|
21 |
| 2 | Grupo volume | G |
|
|
| Tipo de dado |
22 | altura | 3 | Altura do volume | E | integer |
| 0-1 | Em centímetros (CM) |
23 | comprimento | 3 | Comprimento do volume | E | integer |
| 0-1 | Em centímetros (CM) |
24 | largura | 3 | Largura do volume | E | integer |
| 0-1 | Em centímetros (CM) |
25 | peso | 3 | Peso do volume | E | double |
| 0-1 | Em kilogramas(KG). Exemplo: “peso” : 1.2 |
25 | erro | 0 | Grupo de erro | G |
|
| 0-1 | Preenchido se ocorreu erro |
27 | id | 1 | Código identificador do erro | E | integer |
| 1-1 |
|
28 | descricao | 1 | Descrição do erro | E | string | 200 | 1-1 |
|
29 | detalhe | 1 | Detalhamento do erro | E | string | 1000 | 0-1 |
|
Código de retorno do tracking consulta
{
"consulta": [{
"cte": "1800000000000",
"error": {
"id": -1,
"descricao": "Nao localizado.” }
},
{
"cte": "1800000000001",
"error": {
"id": -1,
"descricao": "Nao localizado."
}
},
{
"cte": "1800000000002",
"tracking": {
"codigo": "1800000000002",
"shipmentId": "00000000000000",
"dacte": "000000000000000000000000000000000000000000000",
"dtEmissao": "19/04/2018",
"status": "EMISSAO",
"valor": 32.75,
"peso": 20,
"eventos": [{
"data": "2018-04-19 20:33:39",
"status": "EMISSAO",
"unidade": "JADLOG SEDE"
}],
"volumes": [{
"peso": 12,
"altura": 0,
"largura": 0,
"comprimento": 0
},
{
"peso": 12,
"altura": 0,
"largura": 0,
"comprimento": 0
}
]
}
}
]
}
}