Rastreamento / Ocorrências do Frete em Lote
POST https://freterapido.com/api/external/embarcador/v1/quotes/occurrences/interval?token
Permite consultar todas as ocorrências de rastreio de vários fretes.
As ocorrências são apresentadas por ordem de acontecimento.
Através de um método, basta informar o identificador do frete e o token de integração, conforme estrutura abaixo.
Envio:
Parâmetros da URL:
Nome | Descrição | Formato / Exemplo | Obrigatório |
---|---|---|---|
token | Token de integração | String de 32 caracteres | * |
fretes | Identificador do frete contratado na Frete Rápido. Pode ser utilizado para rastrear o frete. | Array de string com 13 caracteres | * |
*Obrigatório |
Exemplo de envio:
{
"token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"fretes": [
"FR11111111111",
"FR22222222222"
]
}
Resposta:
- Se a requisição obtiver sucesso, será retornado o código de resposta HTTP 200, juntamente com os dados de rastreio do frete informado.
Descrição | Formato / Exemplo | Retornado | |
---|---|---|---|
frete (identificador do frete) | Identificador do frete contratado na Frete Rápido | Array | Sempre |
codigo | Código numérico da ocorrência na Frete Rápido | Numérico (inteiro) | Sempre |
data_ocorrencia | Data da ocorrência | Datetime (YYYY-MM-DD hh:mm:ss) | Sempre |
data_atualizacao | Data de atualização da ocorrência | Datetime (YYYY-MM-DD hh:mm:ss) | Sempre |
data_reentrega | Data em caso de nova tentativa de entrega | Date (YYYY-MM-DD) | Em caso de reentrega |
data_prevista_entrega | Data prevista de entrega calculado no ato da cotação, com base nos dias úteis para entrega. Sendo apenas uma referência, podendo ser diferente a depender das operações de cada transportadora. | Date (YYYY-MM-DD) | Eventual |
prazo_devolucao | Quantidade de dias úteis para devolução da carga/mercadoria | String | Em caso de devolução |
mensagem | Mensagem livre para informação pela transportadora | String até 255 caracteres | Eventual |
razao_social_transportadora | Razão social da transportadora na ocorrência | String até 255 caracteres | Sempre |
descricao_ocorrencia | Descrição da ocorrência na transportadora no momento da atualização | String até 255 caracteres | Eventual |
codigo_ocorrencia | Código da ocorrência na transportadora no momento da atualização | Inteiro | Eventual |
nome_entregador | Nome do entregador responsável pela ocorrência | String até 50 caracteres | Eventual |
cnpj_cpf_entregador | CNPJ/CPF do entregador responsável pela ocorrência | String até 14 caracteres | Eventual |
comprovantes | Comprovantes da ocorrência | Array com nenhum ou vários comprovantes | Eventual |
codigos_redespacho | Códigos de redespacho da ocorrência | Array com nenhum ou vários códigos | Eventual |
nome | Nome da ocorrência | String | Sempre |
Exemplo de resposta:
{
"FR11111111111": [
{
"codigo": 1,
"data_ocorrencia": "",
"data_atualizacao": "",
"data_reentrega": "",
"data_prevista_entrega": "",
"prazo_devolucao": "",
"mensagem": "",
"razao_social_transportadora": "",
"descricao_ocorrencia": "",
"codigo_ocorrencia": 0,
"nome_entregador": "",
"cnpj_cpf_entregador": "",
"comprovantes": [],
"codigos_redespacho": [],
"nome": ""
},
{
"codigo": 2,
"data_ocorrencia": "",
"data_atualizacao": "",
"data_reentrega": "",
"data_prevista_entrega": "",
"prazo_devolucao": "",
"mensagem": "",
"razao_social_transportadora": "",
"descricao_ocorrencia": "",
"codigo_ocorrencia": "",
"nome_entregador": "",
"cnpj_cpf_entregador": "",
"comprovantes": [],
"codigos_redespacho": [],
"nome": ""
}
],
"FR22222222222": [
{
"codigo": 1,
"data_ocorrencia": "",
"data_atualizacao": "",
"data_reentrega": "",
"data_prevista_entrega": "",
"prazo_devolucao": "",
"mensagem": "",
"razao_social_transportadora": "",
"descricao_ocorrencia": "",
"codigo_ocorrencia": "",
"nome_entregador": "",
"cnpj_cpf_entregador": "",
"comprovantes": [],
"codigos_redespacho": [],
"nome": ""
},
{
"codigo": 2,
"data_ocorrencia": "",
"data_atualizacao": "",
"data_reentrega": "",
"data_prevista_entrega": "",
"prazo_devolucao": "",
"mensagem": "",
"razao_social_transportadora": "",
"descricao_ocorrencia": "",
"codigo_ocorrencia": "",
"nome_entregador": "",
"cnpj_cpf_entregador": "",
"comprovantes": [],
"codigos_redespacho": [],
"nome": ""
},
{
"codigo": 3,
"data_ocorrencia": "",
"data_atualizacao": "",
"data_reentrega": "",
"data_prevista_entrega": "",
"prazo_devolucao": "",
"mensagem": "",
"razao_social_transportadora": "",
"descricao_ocorrencia": "",
"codigo_ocorrencia": "",
"nome_entregador": "",
"cnpj_cpf_entregador": "",
"comprovantes": [],
"codigos_redespacho": [],
"nome": ""
}
]
}
- Em caso de erro, será retornado o código estabelecido na lista de códigos desta API.