Versão: 1.9

Documentação

Consulta do tracking

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
                        }
                    ]
                }
            }
        ]
    }
}