logistica.getveiculositdthr
Este endpoint devolve a situação do veículo na data e hora solicitada.
Dados da requisição
| API | Método |
|---|---|
| api.rule - API principal | GET |
JSON da requisição
{
"resource": "logistica",
"endpoint": "getveiculositdthr",
"versao": "v1",
"taggetveiculositdthr":[
{
"idconsumer":"xxxx",
"placa": "xxxxxxx",
"dthrsituacao": "2020-01-01T12:00:00-03:00"
}
]
}
Especificação das tags
| Tag | N | Obrigatório | Descrição |
|---|---|---|---|
| idconsumer | 1 | N | ID interno para controle do ator |
| placa | 1 | S | Placa do veículo a ser consulta |
| dthrsituacao | 1 | S | Data da situação: formato ISO 8601:2019 com fuso horário |
✅ Resposta de Sucesso
{
"taggetveiculositdthr": [
{
"erromensagemitem": "",
"idconsumer": "yyyy",
"veiculo": {
"id": "x",
"placa": "xxxxxxx",
},
"viagensemcurso": [
{
"tipo": "xx.xx",
"tipodescricao": "xxxxx",
"numero": "x",
"id": "x",
"atd": "2020-01-01T12:00:00-03:00",
"ata": "2020-01-01T12:00:00-03:00",
"condutor": [
{
"id": "xxxx",
"nome": "xxxxxxx",
"docreceita": "11111111100",
"rg": "xxxx",
"cnh": "yyy"
}
],
}
]
}
]
}
Especificação das tags de retorno
| Tag | N | Obrigatório | Descrição |
|---|---|---|---|
| erromensagemitem | 1 | Se possuir conteúdo, a chamada do endpoint não foi bem sucedida, se possuir conteúdo, traz o erro ocorrido 001-Placa não informada 002-Placa não encontrada 003-tag dthrsituacao inválida |
|
| idconsumer | 1 | N | ID interno para controle do ator |
| veiculo | 1 | S | Dados do veículo solicitado |
| id | 2 | S | Identificador interno |
| placa | 2 | S | Placa |
| viagensemcurso | 1 | S | Dados das viagens em curso Lista |
| tipo | 2 | S | Tipo da viagem (Código interno) |
| tipodescricao | 2 | S | Descrição do tipo de viagem |
| numero | 2 | S | Número interno da viagem |
| id | 2 | S | ID dentro do T4ERP |
| atd | 2 | S | Data de início da viagem (Actual Time o Departure) |
| ata | 2 | N | Data de fim da viagem (Actual Time of Arrival) Quando a viagem não estiver encerrada no T4ERP esta tag não será devolvida |
| condutor | 2 | S | Dados do condutor do veículo dentro da viagem Lista |
| nome | 3 | S | Nome |
| docreceita | 3 | S | CPF |
| rg | 3 | S | Número do registro geral (RG) |
| cnh | 3 | S | Número da CNH |
❌ Possíveis Erros
- `400 Bad Request`
- JSON de parâmetros inválido
- `401 Unauthorized` → Credenciais inválidas.
- Header authorization não inciado com "token"
- Token inválido
- `405 Method Not Allowed`
- Tentativa de acesso ao endpoint com método diferente de GET.