| Aviso | ||
|---|---|---|
| ||
|
| draw.io Diagram | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
TPR | ||||||
|---|---|---|---|---|---|---|
Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
| orders | TPROrders |
| [] | Sim | Lista de pedidos a serem roteirizados. | - | Tabela abaixo |
| localities |
| TPRLocality[] | Sim |
| Localidades dos pedido. | - | Tabela abaixo |
| Âncora | ||||
|---|---|---|---|---|
|
| TPROrders |
|---|
| , tipo de dado utilizado nas integrações do |
|---|
| Front-End | ||||||
|---|---|---|---|---|---|---|
| Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
| identifier | String | Sim | 4096 | Identificador do pedido. | Texto livre, deve se único dentro da chamada. | "Entrega Carrefour" "PED00133" |
| weight | Double | Não | Peso total os itens do pedido em quilos. | Se preenchido, deve ser maior ou igual a zero; Validado de acordo com o campo "capacityCriteria"; Se não existirem veículos que suportem este pedido sozinho na disponibilidade, ele será rejeitado. | 25000 | |
| volume | Double | Não | Volume total dos itens do pedido em metros cúbicos. | Se preenchido, deve ser maior ou igual a zero; Validado de acordo com o campo "capacityCriteria"; Se não existirem veículos que suportem este pedido sozinho na disponibilidade, ele será rejeitado. | 5000 | |
| pickupTimeWindowStart | Date Time | Sim | Início da janela de carregamento. | Formato ISO8601; PickupStart deve ser anterior a PickupEnd, se ambos forem preenchidos; PickupStart deve ser anterior ou igual a DeliveryStart , se ambos forem preenchidos; PickupStart deve ser anterior a DeliveryEnd e ambos devem ser preenchidos. | "2021-01-21T10:01:00.0-03:00 YYYY-MM-DDThh:mm:ss.sTZD" | |
| pickupTimeWindowEnd | Date Time | Não | Final da janela de carregamento. | Formato ISO8601. | "2021-01-21T10:01:00.0-03:00 YYYY-MM-DDThh:mm:ss.sTZD" | |
| deliveryTimeWindowStart | Date Time | Não | Início da janela de entrega. | Formato ISO8601. | "2021-01-21T10:01:00.0-03:00 YYYY-MM-DDThh:mm:ss.sTZD" | |
| deliveryTimeWindowEnd | Date Time | Sim | Final da janela de entrega. | Formato ISO8601; DeliveryEnd deve vir posterior de DeliveryStart se ambos forem preenchidos; DeliveryEnd deve vir posterior ou igual de PickupEnd se ambos forem preenchidos; DeliveryEnd deve vir posterior de PickupStart e ambos devem ser preenchidos. | "2021-01-21T10:01:00.0-03:00 YYYY-MM-DDThh:mm:ss.sTZD" | |
| serviceLoadDuration | Long | Não | Tempo de carregamento do pedido em milissegundos. | Se preenchido, deve ser maior que zero, em Milissegundos. Se não informado, ou menor que 30 minutos serão considerados 30 minutos de serviço; Se a soma do serviço for maior que 8 horas serão consideradas 8 horas de serviço; | 3600000 [ms] | |
| serviceUnloadDuration | Long | Não | Tempo de descarregamento do pedido em milissegundos. | Se preenchido, deve ser maior que zero, em Milissegundos. | ||
Se não informado, ou menor que 30 minutos serão considerados 30 minutos de serviço; Se a soma do serviço for maior que 8 horas serão consideradas 8 horas de serviço; |
| 3600000 [ms] | |
| origin |
| String | Sim |
| Identificador da localidade de origem do pedido. | - | Tabela abaixo | |
| destination |
| String | Sim |
| Identificador da localidade de destino do pedido. | - | Tabela abaixo |
| Âncora | ||||
|---|---|---|---|---|
|
| TPRLocality, tipo de dado utilizado nas integrações do TPR | ||||||
|---|---|---|---|---|---|---|
| Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
| identifier | String | Sim | 4096 | Identificador da localidade. | Texto livre, deve se único dentro da chamada. | "Carrefour Vila Mariana" |
| operation | 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 | |
| address | TRPAddress | Sim | - | Endereço da localidade. | - | Tabela abaixo |
| Âncora | ||||
|---|---|---|---|---|
|
| TPRAddress, tipo de dado utilizado nas integrações do TPR | ||||||
|---|---|---|---|---|---|---|
| Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
| identifier | String | Sim | 4096 | Identificador | ||
| da localidade. | Texto livre, deve se único dentro da chamada. | " |
| Carrefour Vila Mariana" |
"Carreta"
| country | String |
| Sim |
Se preenchido, deve ser maior ou igual a zero.
Validado de acordo com o campo "capacityCriteria".
Se preenchido, deve ser maior que zero.
Senão, utilizaremos 30 km/h.
Zerado, nulo ou omitido para os cenários de "Frota Ideal".
Se passados valores quebrados apenas a parte inteira será considerada.
Quantidade máxima de paradas de carregamento por viagem.
Se preenchido, deve ser maior que zero;
Se passados valores quebrados apenas a parte inteira será considerada.
Se preenchido, deve ser maior que zero.
Se passados valores quebrados apenas a parte inteira será considerada.
Tabela para validação de campos Boolean.
Verifica se é para contabilizar a distância de retorno a origem na roteirização.
Tabela para validação de campos Bolean.
Se não informado assumiremos "False".
O montante mínimo do tempo de serviço. Caso a soma dos tempos de carregamento e descarregamento não ultrapassem o valor mínimo, este será utilizado.
Valor padrão: 30m
Se preenchido, não pode ser negativo, em Milissegundos.
O montante máximo do tempo de serviço. Caso a soma dos tempos de carregamento e descarregamento ultrapassem o valor máximo, este será utilizado.
Valor padrão: 8h
Se preenchido, não pode ser negativo, em Milissegundos.
Tabela para validação de campos Bolean.
Se não informado assumiremos "False".
TPRMessage: Tipo de dado utilizado nas integrações do TPR
Frota Ideal: A roteirização com a frota ideal, ocorre quando não limitamos as quantidades disponíveis dos veículos que serão utilizados em uma determinada roteirização, definimos apenas os tipos destes, por exemplo:
| 3 | Pais do endereço. | Formato ISO 3166-1 alfa-3 | "BRA" | |||
| state | String | Não | 2 | Estado do endereço. | Quando Brasil valida as 27 opções, se informado | SP |
| city | String | Não | 4096 | Cidade do endereço. | Texto livre | Bauru |
| zipCode | String | Não | 4096 | CEP do endereço. | Valida formato, se informado e se BRA | 17047-001 |
| address | String | Sim | 4096 | Rua, número, Bairro e complemento do endereço. | Texto livre | Gomes de carvalho, 940 |
| latitude | Double | Sim | Latitude do endereço. | Intervalo [-90; 90]. | -23.6114291 | |
| longitude | Double | Sim | Longitude do endereço. | Intervalo [-180; 180]. | -46.6946795 |
Se eu não limito a quantidade disponível de veículos, o sistema roteirizara quatro viagens com Carretas, e esta é a frota ideal para este cenário;
Se eu limito os veículos disponíveis em duas Carretas e vinte Trucks, o sistema roteirizara sete viagens, duas com Carretas e cinco com Trucks e esta é a melhor frota factível para este cenário, porem não é a frota ideal;
Valor recebido
"true"
false
| Anexos | ||
|---|---|---|
|