Histórico da Página
Introdução
| draw.io Diagram | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Sistemas Envolvidos
TPR:
TOTVS Planejamento de Rotas.
Sistema Externo:
Todos os ERPs que se conectam ou pretendem se conectar com os produtos de planejamento logístico TOTVS.
Integração
- Formato de entrada/saída: JSON
Pré-requisitos instalação/implantação/utilização
- Para clientes Protheus versão xxxxxx;
- Para clientes Datasul versão xxxxxx;
- Para todos os clientes, contratação do trial via TOTVS Store.
Layout de Requisição
TPRRouting: Integração rest, Assíncrona Path: .../v1/ , Método: POST | ||||||
|---|---|---|---|---|---|---|
| Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
| dateCall | Date Time | Sim | Data da criação da chamada no sistema externo | Formato ISO8601 | 2021-01-21T10:01:00.0-03:00 YYYY-MM-DDThh:mm:ss.sTZD | |
| system | String | Não | 4096 | Identificador do sistema que fez a chamada | Texto Livre | Protheus |
| version | String | Não | 4096 | Versão do sistema externo | Texto Livre | 12.36.1 |
| qualifiers | Object | Não | 4096 | String chave valor | Formato JSON | {"Usuário": "Pedro de Alcântara", "Perfil": "Analista"} |
| callbackURL | String | Sim | 4096 | URL de Callback | Início com "https://" | |
| callbackAuthenticationType | String | Sim | 4096 | Tipos de autenticação: BASIC, NONE | Opções: BASIC, NONE | NONE |
| callbackAuthenticationValue | String | Não | 4096 | Texto de acordo com formato indicado | Texto Livre | QWxhZGRpbjpvcGVuIHNlc2FtZQ== |
| capacityCriteria | String | Sim | 4096 | Tipos de roteirização: WEIGHT, VOLUME ou BOTH | Opções: WEIGHT, VOLUME ou BOTH | "PESO" |
| routingInstantType | String | Não | 4096 | Define o instante em que a viagens podem ser expedidas. Valor default D+1 "Now" considera a saída como hora do servidor no momento da roteirização + 1 hora "D+1" Primeiro horário factível na origem de acordo com o funcionamento da mesma | Valores: "D+1", "NOW" | "NOW" |
| orders | TPRRoutingOrders[] | Sim | Lista de pedidos a serem roteirizados | Tabela abaixo | ||
| vehicles | TPRRoutingVehicles[] | Sim | Lista de veículos disponíveis para a roteirização | Tabela abaixo | ||
| restrictions | TRPRoutingRestrictions[] | Sim | Restrições de roteirização | Tabela abaixo | ||
| Âncora | ||||
|---|---|---|---|---|
|
| TPRRoutingOrders, 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 | Texto livre; Único dentro da chamada. | "Entrega Carrefour" "PED00133" |
| weight | Double | Não | Peso total os itens do pedido em quilos | Maior que zero, se informado; | 25000 | |
| volume | Double | Não | Volume total dos itens do pedido em metros cúbicos | Maior que zero, se informado; | 5000 | |
| pickupTimeWindowStart | Date Time | Não | Início da janela de carregamento | Formato ISO8601 PickupStart deve ser anterior a PickupEnd, se ambos 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 PickupEnd deve ser posterior de PickupStart, se ambos preenchidos | "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 | Não | Final da janela de entrega | Formato ISO8601 DeliveryEnd deve vir posterior de DeliveryStart | "2021-01-21T10:01:00.0-03:00 YYYY-MM-DDThh:mm:ss.sTZD" | |
| serviceLoadDuration | Long | Não | Se não informado, será considerado um serviço de 30 minutos | Maior que zero, em Milissegundos | 3600000 [ms] | |
| serviceUnloadDuration | Long | Não | Se não informado, será considerado um de 30 minutos | Maior que zero, em Milissegundos | 3600000 [ms] | |
| origin | TPRRoutingLocality | Sim | Localidade de origem do pedido | Tabela abaixo | ||
| destination | TPRRoutingLocality | Sim | Localidade de destino do pedido | - | Tabela abaixo | |
| Âncora | ||||
|---|---|---|---|---|
|
| TPRRoutingLocality, 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 | "Carrefour vila Mariana" |
| country | String | Sim | 3 | País do endereço | Fomato ISO 3166-1 alfa-3 | "BRA" |
| latitude | Double | Sim | Latitude | Intervalo [-90; 90] | -23.6114291 | |
| longitude | Double | Sim | Longitude | Intervalo [-180; 180] | -46.6946795 | |
| operation | String | Sim | Funcionamento simplificado | Opções: UNRESTRICTED, BUSINESS_DAYS, MORNING, AFTERNOON | BUSINESS_DAYS | |
| Âncora | ||||
|---|---|---|---|---|
|
| TPRRoutingVehicles, 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 tipo do veículo; Quando a disponibilidade for insuficiente, podemos retornar novas instâncias deste veículo marcados como viagem extra; Sempre será escolhido para as viagens extras os veículos que minimizem o número de viagens. | Texto livre | "Truck" "Carreta" |
| weightCapacity | Double | Sim | Capacidade do veículo em quilos | Validado de acordo com o campo "capacityCriteria" | 25000 | |
| volumeCapacity | Double | Sim | Capacidade do veículo em metros cúbicos | Validado de acordo com o campo "capacityCriteria" | 5000 | |
| quantity | Int | Não | Quantidade de veículos, semelhantes a este, disponíveis | Maior que zero, se informado; Omitido para os cenários de "Frota Ideal". | ||
| Âncora | ||||
|---|---|---|---|---|
|
| TPRRoutingRestrictions, tipo de dado utilizado nas integrações do TPR | ||||||
|---|---|---|---|---|---|---|
| Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
| maxLoadingStops | Int | Não | Quantidade máxima de paradas de carregamento por viagem. | Maior que zero | 1 | |
| maxUnloadingStops | Int | Não | Quantidade máxima de paradas de descarregamento por viagem. | Maior que zero | 15 | |
| allowInterleaving | Boolean | Não | Permite carregamento após descarregamento na mesma viagem. Default: false | |||
| maxDistanceBetweenLoadStops | Double | Não | Máxima distância, em km, entre paradas de carregamento; | Se preenchido, deve ser maior ou igual a zero. | 100 | |
| maxDistanceBetweenUnloadStops | Double | Não | Máxima distância, em km, entre paradas de descarregamento; | Se preenchido, deve ser maior ou igual a zero. | 100 | |
Âncora TPRRoutingResponse TPRRoutingResponse
| TPRRoutingResponse | |
| TPRRoutingResponse |
Layout de Resposta
| TPRRoutingResponse, tipo de dado utilizado nas integrações do TPR | ||||||
|---|---|---|---|---|---|---|
| Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
| responseDate | Date Time | Sim | Data do envio da resposta no TPR | - | 2021-01-21T10:01:00.0-03:00 YYYY-MM-DDThh:mm:ss.sTZD | |
| version | String | Sim | 4096 | Versão do TPR que executou a resposta | - | 0.0.0.1 |
| success | Boolean | Sim | True se sucesso, false se falha | Se uma única validação falhar, todo o pacote falha. | True | |
| message | TPRMessage[] | Sim | Lista de mensagens a serem exibidas pelo sistema externo para o usuário | - | ||
Âncora TPRMessage TPRMessage
| TPRMessage | |
| TPRMessage |
TPRMessage: Tipo de dado utilizado nas integrações do TPR | ||||||
| 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 válido | TPR0001 |
| message | String | Sim | 4096 | Mensagem escrita | Texto Livre | "Para finalizar o cadastro, acesse seu e-mail e valide o Token" |
Âncora TPRCatMsg TPRCatMsg
| TPRCatMsg | |
| TPRCatMsg |
Catálogo de Mensagens
| Código | Mensagem | Descrição | ||
|---|---|---|---|---|
| TPRRT0000 | Sucesso | Sucesso | ||
| TPRRT0001 | O input é nulo | Ao enviar um payload válidonula | ||
| TPRRT0002 | O input é vazio | Ao enviar um payload vazio | ||
| TPRRT0003 | Data de criação está nula | Ao enviar campo "dataCall" nula | ||
| TPRRT0004 | A versão [VERSÃO_ENVIADA] possui mais de 4096 caracteres | Ao enviar o campo "version" com mais de 4096 caracteres | ||
| TPRRT0005 | O qualifiers está nulo | Ao enviar o campo "qualifiers" null | ||
| TPRRT0006 | O identificador do sistema externo [IDENTIFICADOR_EXTERNO_ENVIADO] possui mais de 4096 caracteres | Ao enviar o campo "system" com mais de 4096 caracteres | ||
| TPRRT0007 | A url de callback está nula | Ao enviar o campo "callbackUrl" nula | ||
| TPRRT0008 | A url de callback está inválida | Ao enviar o campo "callbackUrl" inválida | ||
| TPRRT0009 | O tipo da callback [URL_CALLBACK_ENVIADO] possui mais de 4096 caracteres | Ao enviar o campo "callbackUrl" com mais de 4096 caracteres | ||
| TPRRT0008TPRRT0010 | O tipo da callback está nula | Ao enviar o campo "callbackAuthenticationType" nulo | ||
| TPRRT0009TPRRT0011 | O tipo valor da callback [TIPO_CALLBACK_ENVIADO] possui mais de 4096 caracteres | Ao enviar o campo "callbackAuthenticationType" com mais de 4096 caracteres | ||
| TPRRT0010TPRRT0012 | O tipo da callback callback [TIPO_CALLBACK_ENVIADO] está inválido. Os valores esperados são 'BASIC' e 'NONE'" | Ao enviar o campo "callbackAuthenticationType" com valores inválidosinválido | ||
| TPRRT0011TPRRT0013 | O valor da callback callback [VALORTIPO_CALLBACK_ENVIADO] possui mais de 4096 caracteres | Ao enviar o campo "callbackAuthenticationVeluecallbackAuthenticationType" com mais de 4096 caracteres | ||
| TPRRT0012TPRRT0014 | O tipo A url de roterização callback está nulonula | Ao enviar o campo "capacityCriteria" nulonula | ||
| TPRRT0013TPRRT0015 | O tipo de roterização [TIPO_CALLBACK_ENVIADOROTERIZÇÃO] possui mais de 4096 caracteres | Ao enviar o campo "capacityCriteria" com mais de 4096 caracteres | ||
| TPRRT0014TPRRT0016 | O tipo de roterizaçãoroterização [TIPO_ROTERIZAÇÃO_ENVIADO] está inválido. Os valores possíveis são 'WEGHT', 'VOLUME' e 'BOTH' | Ao enviar o campo "capacityCriteria" com valores inválidos | ||
| TPRRT0015 | A url de callback está nula | Ao enviar o campo "callbackUrl" nula | ||
| TPRRT0016 | A url de callback está inválida | Ao enviar o campo "callBackUrl" sem domínio, protocolo ou com caracteres especiais | ||
| diferentes de WEIGHT, VOLUME E BOTH | ||||
| TPRRT0017 | O instante de expedição [INSTANTE_ROTERIZAÇÃO_ | TPRRT0017 | O instante de expedição [INSTANTE_ROTERIZAÇÃO_ENVIADO] possui mais de 4096 caracteres | Ao enviar o campo "routingInstantType" com mais de 4096 caracteres |
| TPRRT0018 | A restrição está nula | Ao enviar o campos campo "restriçõesrestriction" nulonula | ||
| TPRRT0019 | A localidade está nula | Ao enviar alguma localidade nula | ||
| TPRRT0020 | O identificador da localidade está inválido | Ao enviar o Identificador da Localidade vazio ou nulo | ||
| TPRRT0021 | A latitude da localidade está nula | Ao enviar a latitude da localidade nula | ||
| TPRRT0022 | A longitude da localidade está nula | Ao enviar a longitude da localidade nula | ||
| TPRRT0023 | A operação da localidade está nula | Ao enviar o funcionamento da localidade nula | ||
| TPRRT0024 | País da localidade com o identificador [IDENTIFICADOR_LOCALIDADE] está nulo | Ao enviar o campo "country" da localidade nulo | ||
| TPRRT0025 | O identificador da localidade [IDENTIFICADOR_LOCALIDADE] possuí mais de 4096 caracteres | Ao enviar o campo "identifier" da localidade com mais de 4096 caracteres | ||
| TPRRT0026 | O pais [PAIS_ENVIADO] está inválido. O mesmo deve seguir o formato ISO 3166-1 alfa-3 | Ao enviar o campo "country" com mais de 3 caracteres | ||
| TPRRT0027 | Latitude O pais [LATITUDEPAIS_ENVIADO] não está cadastrado | Ao enviar o campo "country" que não está informado no TPRCountry | ||
| TPRRT0028 | Latitude [LATITUDE_ENVIADO] está inválido está inválido a mesma precisa estar dentro do intervalo [-90; 90] | Ao enviar o campo "latitude" não seguindo o padrão [-90; 90] | ||
| TPRRT0028TPRRT0029 | Longitude [LONGITUDE_ENVIADO] está inválido a mesma precisa estar dentro do intervalo [-180; 180] | Ao enviar o campo "longitude" não seguindo o padrão [-180; 180] | ||
| TPRRT0029TPRRT0030 | Quantidade de veículos deve ser maior que 0 | Ao enviar a quantidade de veículos menor que 0 | ||
| TPRRT0030TPRRT0031 | O pedido está nulo | Ao enviar algum pedido nulo | ||
| TPRRT0032 | Pedidos inválidos | Ao enviar o campo pedido vazio | ||
| TPRRT0033TPRRT0031 | O identificador do pedido está inválidoé obrigatório | Ao enviar o identificador do pedido vazio ou nulo | ||
| TPRRT0032TPRRT0034 | O peso do pedido está inválidocom identificador [PESO_ENVIADO] é obrigatório | Ao enviar o campo "weight" nulo ou menor que 0. Caso peso do pedido nulo, caso o campo "capacityCriteria" do input seja "WEIGHT" ou "BOTH" | ||
| TPRRT0033TPRRT0035 | O volume peso do pedido está inválidocom identificador [PESO_ENVIADO] deve ser maior que 0 | Ao enviar o campo "volume" nulo ou peso do pedido que seja menor que 0. Caso , caso o campo "capacityCriteria" do input seja "WEIGHT" ou "VOLUMEBOTH" | ||
| TPRRT0034 | Pedidos inválidos | Ao enviar uma lista vazia de pedidos | ||
| TPRRT0035 | A localidade de origem do pedido [IDENTIFICADOR_PEDIDO] está nulo | Ao enviar a localidade de origem do pedido nula | ||
| TPRRT0036 | A localidade de destino do pedido [IDENTIFICADOR_PEDIDO] está nulo | Ao enviar a localidade de destino do pedido nula | ||
| TPRRT0037 | O identificador do pedido [IDENTIFICADOR_PEDIDO] possuí mais de 4096 caracteres | O campo "identifier" com mais de 4096 | ||
| TPRRT0038 | Duração de serviço de carregamento não pode ser menos que 0 | O campo "serviceLoadDuration" não pode ser menor que 0 | ||
| TPRRT0039 | Duração de serviço de descarregamento não pode ser menos que 0 | O campo "serviceUnloadDuration" não pode ser menor que 0 | ||
| TPRRT0040 | O veículo está nulo | Ao enviar algum veículo nulo | ||
| TPRRT0041 | Veículos inválidos | Ao enviar veículos vazios ou nulos | ||
| TPRRT0042 | O identificador do veículo está inválido | Ao enviar o identificador de veículo vazio ou nulo | ||
| TPRRT0043 | A capacidade de volume do veículo está nulo | Ao enviar a capacidade de volume do veículo negativa ou nula | ||
| TPRRT0044 | A capacidade de peso do veículo está nulo | Ao enviar a capacidade de peso do veículo negativa ou nula | ||
| TPRRT0036 | O volume do pedido com identificador [VOLUME_ENVIADO] é obrigatório | Ao enviar o campo "volume" menor que 0, caso o campo "capacityCriteria" do input seja "VOLUME" ou 'BOTH" | ||
| TPRRT0037 | O volume do pedido com identificador [VOLUME_ENVIADO] deve ser maior que 0" | Ao enviar o campo "volume" menor que 0. caso o campo "capacityCriteria" do input seja "VOLUME" | ||
| TPRRT0034 | Pedidos inválidos | Ao enviar uma lista vazia de pedidos | ||
| TPRRT0035 | A localidade de origem do pedido [IDENTIFICADOR_PEDIDO] está nulo | Ao enviar a localidade de origem do pedido nula | ||
| TPRRT0036 | A localidade de destino do pedido [IDENTIFICADOR_PEDIDO] está nulo | Ao enviar a localidade de destino do pedido nula | ||
| TPRRT0037 | O identificador do pedido [IDENTIFICADOR_PEDIDO] possuí mais de 4096 caracteres | O campo "identifier" do pedido com mais de 4096 | ||
| TPRRT0038 | A localidade de origem do pedido [IDENTIFICADOR_PEDIDO] está nulo | Ao enviar um pedido com a localidade de origem nula | ||
| TPRRT0039 | A localidade de destino do pedido [IDENTIFICADOR_PEDIDO] está nulo | Ao enviar um pedido com a localidade de origem nula | ||
| TPRRT0040 | O identificador do pedido [IDENTIFICADOR_PEDIDO] possuí mais de 4096 caracteres | O campo "identifier" do pedido com mais de 4096 | ||
| TPRRT0041 | Duração de serviço de carregamento não pode ser menos que 0 | Ao enviar o campo "serviceLoadDuration" menor que 0 | ||
| TPRRT0042 | Duração de serviço de descarregamento não pode ser menos que 0 | Ao enviar o campo "serviceUnloadDuration" menor que 0 | ||
| TPRRT0043 | O veículo está nulo | Ao enviar o campo "vehicles" nulo | ||
| TPRRT0044 | Veículos inválidos | Ao enviar o campo "vehicles" vazio | ||
| TPRRT0045 | O identificador do veículo está inválido | Ao enviar o campo "identifier" do veiculo nulo ou vazio | ||
| TPRRT0046 | A capacidade de volume do veículo com identificador [IDENTIFICADOR_ENVIADO] é obrigatório | Ao enviar o capo "volumeCapacity" do veículo nula, quando o capacityCriteria é igual a VOLUME ou BOTH | ||
| TPRRT0047 | A capacidade de volume do veículo com identificador [VOLUME_ENVIADO] deve ser maior que 0 | Ao enviar o capo "volumeCapacity" do veículo é menor que 0, quando o capacityCriteria é igual a VOLUME ou BOTH | ||
| TPRRT0048 | A capacidade de peso do veículo com identificador [WEIGHT_ENVIADO] é obrigatório | Ao enviar o capo "weightCapacity" do veículo nula, quando o capacityCriteria é igual a WEIGHT ou BOTH | ||
| TPRRT0049 | A capacidade de peso do veículo com identificador [WEIGHT_ENVIADO] deve ser maior que 0 | Ao enviar o capo "weightCapacity" do veículo é menor que 0, quando o capacityCriteria é igual a WEIGHT ou BOTH | ||
| TPRRT0050TPRRT0045 | O identificador do veículo [IDENTIFICADOR_ENVIADO] possuí mais de 4096 caracteres | Ao enviar o identificador de veículo com mais de 4096 caracteres | ||
| TPRRT0046TPRRT0051 | A quantidade de veículos se informada deve ser maior que 0 | O Ao enviar o campo "quantidadequantity" está menor que 0 | ||
| TPRRT0047TPRRT0052 | O identificador do pedido pedido [IDENTIFICADOR_ENVIADO] está está duplicado | Ao enviar dois pedidos com o mesmo identificadoridentifier | ||
| TPRRT0048TPRRT0053 | A localidade de origem e destino são iguais" | Ao enviar localidades iguais como uma localidade de origem e de destino com o mesmo identifier | ||
| TPRRT0049TPRRT0054 | O identificador da localidade [IDENTIFICADOR_ENVIADO] está está duplicado em outras localidades | Ao enviar duas localidades com identificadores iguais, mas atributos diferentesquaisquer com o mesmo identifier | ||
| TPRRT0050 | O identificador do veículo veículo [IDENTIFICADOR_ENVIADO] está duplicado em outros veículo | Ao enviar veículos com identificadores iguais, mas atributos diferentes |
Documentações relacionadas
| Âncora | ||||
|---|---|---|---|---|
|
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:
Dada uma cesta de pedidos com vinte pedidos de 5.000 kg sem janela de coleta ou entrega e os veículos disponíveis são Carretas com capacidade de 25.000 kg e Trucks com capacidade de 10.000 kg:
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; |
Anexos
| Anexos | ||
|---|---|---|
|
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas