Introdução
draw.io Diagram | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
TPRRetorno | ||||||
---|---|---|---|---|---|---|
Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
tripsResults | Sim | Lista de viagens geradas via otimização | Tabela abaixo | |||
rejections | Não | Lista de rejeites geradas via otimização | Tabela abaixo | |||
message | Não | Campo que deve ser exibido pelo sistema externo para o usuário | - | Tabela abaixo |
Âncora | ||||
---|---|---|---|---|
|
TPRTripResults, tipo de dado utilizado nas integrações do TPR | ||||||
---|---|---|---|---|---|---|
Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
tripId | integer | Sim | Índice incremental gerado a cada viagem | 1, 2 ... 99 | ||
distance | double | Sim | Distância total planejada para a viagem em km | 123 [km] | ||
tollValue | double | Sim | Valor do pedágio total da viagem | Depende do campo tollCalculation | 120,32 [R$] | |
numberOfStops | integer | Sim | Quantidade total de paradas (carregamentos e descarregamentos) da viagem | |||
volume | double | Sim | Volume total na viagem, em m³ | 14.32 [m³] | ||
weight | double | Sim | Peso total na viagem, em kg | 12000 [kg] | ||
duration | double | Sim | Duração total planejada para a viagem em milissegundos | Maior que zero em milissegundos | 3600000 [ms] | |
extraTrip | Boolean | Sim | True/Verdadeiro se o veiculo veículo disponível, false/falso se não disponível; | |||
considerReturnDistance | Boolean | Não | Informa se a distancia distância de retorno a origem na roteirização foi contabilizada. | Tabela para validação de campos Boolean. | ||
vehicle | String | Sim | Identificador do veículo selecionado para a viagem | |||
stops | TPRTripStop[] | Sim | Lista de paradas | Tabela abaixo |
Âncora | ||||
---|---|---|---|---|
|
TPRTripStop, tipo de dado utilizado nas integrações do TPR | ||||||
---|---|---|---|---|---|---|
Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
stopSequence | int | Sim | Ordem da parada, iniciando por 1 | 1, 2 ... 99 | ||
stopDistance | double | Sim | Distancia Distância total em km entre uma parada e outra | Maior ou igual a zero | 202 [km] | |
stopType | String | Sim | Categorização da parada podendo ser: LOAD, UNLOAD, BOTH | - | ||
stopTollValue | double | Não | Valor do pedágio da parada anterior para a atual | Depende do campo tollCalculation | 120,32 [R$] | |
locality | TPRRoutingLocality | Sim | Identificador da localidade | Texto Livre | "Carrefour vila Mariana" | |
stopArrivalTime | DateTime | Sim | Horário de chegada no formato ISO 8601 | 2021-01-21T10:01:00.0-03:00 YYYY-MM-DDThh:mm:ss.sTZD | ||
stopDepartureTime | DateTime | Sim | Horário de saída no formato ISO 8601 | 2021-01-21T10:01:00.0-03:00 YYYY-MM-DDThh:mm:ss.sTZD | ||
loadedOrders | TPRRoutedOrder[] | Sim | Lista de pedidos carregados naquela parada | Tabela abaixo | ||
unloadedOrders | TPRRoutedOrder[] | Sim | Lista de pedidos descarregados naquela parada | Tabela abaixo |
Âncora | ||||
---|---|---|---|---|
|
TPRRoutingLocality, tipo de dado utilizado nas integrações do TPR | ||||||
---|---|---|---|---|---|---|
Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
localityidentifier | String | Sim | 4096 | Identificador da localidade | Texto Livre | "Carrefour vila Mariana" |
localitycountry | String | Sim | 3 | País do endereço | Fomato ISO 3166-1 alfa-3 | "BRA" |
localitylatitude | Double | Sim | Latitude | Intervalo [-90; 90] | -23.6114291 | |
localitylongitude | Double | Sim | Longitude | Intervalo [-180; 180] | -46.6946795 | |
localityoperation | String | Sim | Funcionamento simplificado com uma das opções: UNRESTRICTED, BUSINESS_DAYS, MORNING, AFTERNOON | Opções: UNRESTRICTED (00:00-23:59 de Dom-Sab) | BUSINESS_DAYS |
Âncora | ||||
---|---|---|---|---|
|
TPRRoutedOrder, tipo de dado utilizado nas integrações do TPR | ||||||
---|---|---|---|---|---|---|
Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
orderServiceType | String | Sim | A categorização da parada podendo ser: LOAD ou UNLOAD | LOAD | ||
orderIdentifier | String | Sim | 4096 | Identificador do pedido | "Entrega Carrefour" "PED00133" | |
orderWeight | Double | Não | Peso total os dos itens do pedido, em kg | 25.000 | ||
orderVolume | Double | Não | Volume total dos itens do pedido em m³ | 5000 |
Âncora | ||||
---|---|---|---|---|
|
TPRRejection, tipo de dado utilizado nas integrações do TPR (Apenas JSON) | ||||||
---|---|---|---|---|---|---|
Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
message | TPRMessage[] | Sim | 4096 | |||
orders | TROrderRejection[] | Sim |
Âncora | ||||
---|---|---|---|---|
|
TPROrderRejection, tipo de dado utilizado nas integrações do TPR | ||||||
---|---|---|---|---|---|---|
Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
Identifier | String | Sim | 4096 | Identificador do pedido que gerou o rejeite | "Entrega Carrefour" "PED00133" | |
Weight | Double | Não | Quantidade rejeitada de peso em kg | 25.000 | ||
Volume | Double | Não | Quantidade rejeitada de volume em m³ | 5000 |
Âncora | ||||
---|---|---|---|---|
|
TPRMessage: Tipo de dado utilizado nas integrações do TPR (Apenas JSON) | ||||||
Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
messageCode | String | Sim | 4096 | Código de identificação da mensagem | Código existente e valido | TPR0001 |
message | String | Sim | 4096 | Descrição do motivo do rejeite | Texto Livre | "Para finalizar o cadastro acesse seu e-mail e valide o Token" |
Anexos | ||
---|---|---|
|