Rastreamento / Ocorrências do Frete em Lote
POST https://freterapido.com/api/external/embarcador/v1/quotes/occurrences
Permite consultar todas as ocorrências de rastreio de vários fretes.
As ocorrências são apresentadas por ordem de acontecimento.
Limite de 100 fretes por requisição.
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.