Histórico da Página
01. Disponibilidade
de Veículos Âncora DispV DispV
DispV | |
DispV |
O TOTVS Roteirização e Entrega trabalha com dois conceitos de disponibilidade, a disponibilidade de veículos e a disponibilidade de placas. Você pode utilizar apenas a disponibilidade de veículos ou as duas em conjunto.
Essa configuração pode ser feita através de uma planilha de importação ou manualmente após filtrar o veículo desejado.
a. Planilha de Importação ÂncoraPlanilha Planilha
Planilha | |
Planilha |
- Para fazer o cadastro de disponibilidade de veículos e/ou placas através de importação de planilha, clique no menu Configuração > Roteirização > Disponibilidade. No canto direito superior da página, clique no botão Planilha.
- Para fazer o cadastro de disponibilidade de veículos e/ou placas através de importação de planilha, clique no menu Configuração > Roteirização > Disponibilidade. No canto direito superior da página, clique no botão Planilha.
-
- Ao clicar no botão uma caixa de diálogo será aberta
-
- Se você não possui o modelo da planilha, deverá baixa-lo através do botão Gerar Modelo.
-
- Uma planilha será baixada automaticamente com o nome modelo-Disponibilidade de veículo.
-
- Abra a planilha que você acabou de baixar e siga as instruções abaixo para preencher a planilha. Note que cada célula da primeira linha contém a informação que deverá ser preenchida naquela coluna.
-
originSourceid → código externo localidade de origem.
vehicleSourceid → código externo do veículo.
additionalAvailability → Número inteiro que representa a disponibilidade adicional para um conjunto de placas.
plate → Sequência alfanumérica que representa a placa de um veículo.
country → País ao qual a placa pertence.
state → Estado ao qual a placa pertence.
city → Cidade ao qual a placa pertence.
Notas de preenchimento:
- O nome da aba da planilha deve ser R2VehicleAvailability.
- Não é necessário o preenchimento das linhas em ordem de localidade de origem e veículo.
- Deverá ser repetido o valor numérico inteiro para o campo de additionalAvailability para os mesmo(s) par(es) de localidade e origem. Caso haja uma divergência, uma mensagem de erro será exibida e a integração cancelada.
- Todos os campos são obrigatórios, caso uma célula fique em branco de qualquer coluna, uma mensagem de erro será exibida e a integração cancelada.
- Os campos de localidade de origem e veículo devem ser escritos igualmente ao seu cadastro. (Considerar Case-sensitive)
- O campo country deverá ser preenchido com o seu acrônimo.
- Clique novamente no botão Planilha e então sobre o botão Escolher arquivo. Selecione a planilha preenchida de disponibilidade de veículo e clique no botão Importar.
-
- Aguarde um momento até que a operação seja concluída.
- Se nenhum erro for encontrado, uma mensagem de sucesso será exibida.
-
- Para visualizar os novos registros, basta pesquisar na tela de disponibilidade através do botão Pesquisar, selecionando a a origem primeiro primeiro.
- Encontre o veículo que você acabou de cadastrar a disponibilidade e clique no ícone que está na coluna Placas para visualizar as informações.
b.Cadastro manual ÂncoraCmanual Cmanual
Cmanual | |
Cmanual |
- Para fazer o cadastro de disponibilidade de veículos e/ou placas manualmente, clique no menu Configuração > Roteirização > Disponibilidade.
-
- Utilize o filtro por origem para pesquisar os veículos cadastrados naquela localidade.
- Você também pode adicionar novos filtros para serem utilizados na pesquisa.
- , para saber como personalizar os filtros clique aqui.
- Clique em Pesquisar e todos os veículos cadastrados naquela localidade aparecerão para no resultado.
- Encontre o veículo que você deseja cadastrar a disponibilidade e clique no ícone que está na coluna Placas.
- Na caixa de diálogo que abrir você pode, editar a disponibilidade adicional e/ou cadastrar uma nova placa para este veículo.
-
- Para editar a disponibilidade, basta alterar o número no campo Disponibilidade adicional e clicar em Salvar.
- Se você deseja cadastrar uma nova placa, clique no ícone "+" na tabela e uma nova linha será exibida para o preenchimento dos dados. Note que a disponibilidade total também será alterada pois ao adicionar uma placa, você está adicionando mais uma disponibilidade.
- Preencha os dados e clique em Salvar. Note que todos os campos são obrigatório.
- Se nenhum erro for encontrado, uma mensagem de sucesso será exibida.
02. Durações
de carregamento e descarregamento Âncora durações durações
durações | |
durações |
Nesta página você poderá cadastrar algumas opções de duração de carregamento e descarregamento que serão utilizadas como referência durante a roteirização. Caso você informe uma duração diferente em alguma localidade específica o sistema irá considerar a informação da cadastrada na localidade.
Para acessar essas configurações clique em Configuração > Roteirização > Durações e você terá as seguintes opções para o cadastrado das durações de carregamento e descarregamento:
- Durações fixas
- Duração máxima
- Duração por peso
- Duração por quantidade de peças
a. Durações fixas
Aqui você poderá configurar um tempo de duração fixo para o carregamento e descarregamento da sua operação.
b. Duração máxima
A duração máxima é tempo máximo de carregamento/descarregamento que pode ser considerado. É necessário ativar o check box para que a duração seja ativada. Ao ativar essa duração, ela irá sobrepor qualquer outra duração que você configurar nesta página. Por exemplo, se você configurar a duração fixa e a duração máxima, o sistema irá considerar apenas a duração máxima no resultado da roteirização.
c. Duração por peso
Com esta opção você poderá configurar o tempo de duração do carregamento e descarregamento por quilo (kg). É necessário ativar o check box para que a duração seja ativada.
d. Duração por quantidade de peças
Nesta opção você poderá configurar o tempo de duração do carregamento e descarregamento por quantidade de peças. É necessário ativar o check box para que a duração seja ativada.
OBS: O sistema considera todas as configurações adicionadas no calculo da duração do carregamento e descarregamento, exceto se você ativar o tempo de duração máxima pois ao ativar a duração máxima ela se sobrepõe à todas as outras configurações.
03.
IntegraçõesIntegração Âncora Integrações Integrações
Integrações | |
Integrações |
Nesta tela conseguimos realizar configurações e estabelecer regras de integração entre TRE e sistema externo, tanto para entrada quanto para saída dos dados. Para acessá-la clique em Configuração > Roteirização > Integração e você conseguirá configurar as seguintes regras de integração: (a) Geral, (b) Aquisição, (c) Publicação, (d)Serviços para tarefas de integração .
a. Geral Âncora configeral configeral
configeral | |
configeral |
Aqui temos a possibilidade de configurar:
- Formatos de quantidade, unidade de peso e Unidade de volume - Esta configuração não reflete em arquivos importados via excel, apenas integração com sistema externo.
Formato de quantidade: o formato da quantidade pode ser unitário, quantidade total ou quantidade decimal.
Unitário:
- É aceito apenas números inteiros
- A quantidade de itens do pedido sempre será o valor enviado na requisição.
- Divide o valor enviado na requisição pela quantidade de peças.
- O peso sempre será o valor enviado na requisição.
- Calcula volume enviado na requisição
Quantidade total:
- Independente do valor apresentado na requisição, a quantidade de itens do pedido sempre será 1.
- Peso sempre será o valor enviado na requisição.
- Calcula o volume enviado na requisição
Quantidade decimal:
- Independente do valor apresentado na requisição, a quantidade de itens do pedido sempre será 1.
Unidade de peso: calcula o Peso enviado na requisição e pode ser em quilograma, tonelada ou há também a opção desconsiderar peso.
Quilograma:
- Quantidade de quilos sempre será o valor enviado na requisição.
Tonelada:
- Multiplica o Valor enviado na requisição por 1000.
Desconsiderar peso:
- Desconsidera valor enviado na requisição e Considera peso por item igual a 1.
Unidade de Volume: calcula o volume enviado na requisição e pode ser em metro cúbico, litro ou há também a opção desconsiderar volume.
Metro cúbico:
- Calcula a altura, largura e comprimento do item.
Litro:
- Calcula a altura, largura e comprimento do item.
Desconsiderar volume:
- Desconsidera valor enviado na requisição e Considera peso por item igual a 1.
Obs: Tanto Litro quanto Metro cúbico tem o mesmo cálculo (Verificado).
2. Encaixe: Permite encaixar pedidos em uma viagem em execução.
3. Geocodificar primeiro resultado e marcar revisão: Geocodifica o endereço enviado na requisição e deixa marcado que o endereço precisa ser revisado.
- Quando fazemos a geocodificação, enviamos o endereço para o google e o Google pode retornar mais de um resultado de lat/long. Essa configuração faz com que seja selecionado sempre o primeiro lat/long que o google enviou. O revisar na localidade é apenas informativo.
-
4. Validar se pedidos possuem nota fiscal associada: Valida se pedidos possuem nota fiscal associada.
5. Expedição automática de viagens liberadas em que todos os pedidos possuam nota fiscal: Automatiza o processo de liberação de viagens a partir do momento em que toda(s) a(s) notas estejam vinculada(s) ao(s) pedido(s).
6. Permitir encaixe de pedidos não prioritários: Permite encaixar pedidos onde o tipo não esteja selecionado como prioritário
7. Permitir realizar encaixe em monitoráveis não iniciados: Permite que seja realizada a associação do pedido via encaixe em uma viagem que está rastreada e o monitorável ainda não foi iniciado. (Se apenas a flag encaixe e Permitir realizar encaixe em monitoráveis não iniciados estiverem ativas, o tipo de pedido deve ser prioritário)
b. Aquisição
Âncora | ||||
---|---|---|---|---|
|
Nesta sessão você irá configurar os dados que deseja integrar com o TRE e quais ações você realizará com os dados que você está integrando.
Esta configuração não reflete em arquivos importados via excel, apenas integração com sistema externo.
1. Inserção permite atualizar: Permite que sejam enviadas requisições com atualizações para uma requisição enviada anteriormente. Ex: Atualizar a quantidade de um item.
2. Atualização permite inserir: Permite receber requisições de Update na entidade. Ex: inserir um item à um pedido.
3. Permite alteração de pedido em viagem em análise
4. Permite alteração de pedido em viagem liberada
Para ambas as flags de alteração de pedido o comportamento é conforme descrito abaixo:
- Flag ligada:
- Atualiza o pedido e não cancela a viagem
- Flag desligada:
- Retorna com erro/Não atualiza o pedido.
- Flag ligada:
5. Remove itens de pedido omitidos na atualização de pedido: (a)Possibilita remover os itens de pedido, caso o item seja único no pedido, o pedido é removido, (b) Possibilita remover os itens de pedido de uma viagem, caso o pedido seja único a viagem é destruída, exceto se a mesma estiver com o status liberada. Viagens liberadas não serão destruídas e será lançada uma exceção "CannotDestroyReleasedTripLoadedOrderException".
6. Atualização de endereço altera geocodificação: Permite que ao enviar uma atualização de endereço para uma localidade, a geocodificação também seja atualizada.
7. Aquisição ligada para: Permite receber integração das entidades como produto, localidade e pedidos desde que os mesmos estejam selecionados.
c. Publicação Âncora confipublicação confipublicação
confipublicação | |
confipublicação |
Nesta sessão você poderá configurar as publicações que serão enviadas do TRE para o seu sistema externo. Para que essa comunicação aconteça, é necessário configurar as URLs da sessão Serviços para tarefas de integração.
- Permite sincronização de pedido no encaixe: Permite sincronizar com o ERP a informação do pedido associado a viagem via encaixe.
2.Sincronização > Solicitar: Solicita uma ação do sistema externo, significa que o sistema externo precisa enviar um retorno para que a sincronização aconteça com sucesso.
Sincronização > Informar: (a) Falha: Tenta de novo (gera alguma exceção no log), (b) Sucesso: Muda o status da mensagem para processada e muda o status de sincronização da viagem para sincronizado.
3. Permissão > Permitir o cancelamento de viagem sincronizada: Permite que uma viagem que foi sincronizada seja cancelada.
4. Solicitações > Solicitação de cancelamento de viagem ligada: Envia uma solicitação para o sistema externo para que o mesmo aceite o cancelamento de uma viagem.
Solicitações > Solicitação de reprogramação de viagem ligada: Envia uma solicitação para o sistema externo para que o mesmo aceite a requisição de reprogramação de uma viagem.
d. Serviços para tarefas de integração Âncora confitarefasdeintegração confitarefasdeintegração
confitarefasdeintegração | |
confitarefasdeintegração |
Esta sessão identifica para qual URL será enviada as integrações de Sincronização de Viagem, Reprogramação de Viagem, Cancelamento de viagem Sincronizada e Rota. É possível configurar o tempo máximo de espera para retorno da requisição, se o serviço é automático e as credenciais para autenticação na integração de cada uma.
Obs¹: Após configurar todas as regras de integração necessárias, clique em Salvar.
Obs²: O botão "Exibir WSDL" te direciona para uma lista de templates que poderão ser utilizados para criação das integrações no sistema externo.
04. Restrições ÂncoraRestrições Restrições
Restrições | |
Restrições |
Para acessar as configurações de restrições no TRE clique em Configuração > Roteirização > Restrições. Nesta página é possível configurar algumas regras que serão utilizadas no planejamento das viagens.
As regras que poderão ser configuradas são:
1. Política de Quebra:
Quebra por item de Pedido: Com essa configuração selecionada, durante a roteirização é realizada a quebra do item do pedido onde o sistema irá priorizar manter itens de pedido iguais no mesmo veículo.
Quebra por pedido: Ao exceder a capacidade do veículo durante a roteirização, o sistema irá quebrar o pedido em mais viagens.
Sem quebra (impeditivo): Com essa política de quebra não será possível otimizar um pedido parcialmente. Caso você tenha um pedido com alguns itens de pedido e tente otimizar apenas alguns desses itens, o sistema irá gerar uma violação e não seguirá com a otimização.
Sem quebra (não impeditivo): Ao optar por essa política de quebra você poderá otimizar os seus pedidos parcialmente. Caso você tenha um pedido com alguns itens de pedido e tente otimizar apenas alguns desses itens, o sistema irá gerar uma violação informando a quebra mas permitirá que a otimização ocorra caso você selecione "prosseguir operação".
2. Número máximo de paradas por viagem: O sistema considera essa informação ao realizar o planejamento das viagens e não ultrapassa o número máximo configurado.
3. Velocidade (km/h): O sistema considera a velocidade indicada nesse campo para determinar o tempo de trânsito da viagem.
4. Permite carregamento após descarregamento e antes do esvaziamento do veículo: Com essa configuração ativa é possível fazer uma parada de carregamento ao longo da viagem, antes do esvaziamento do veículo.
5. Permite carregamento após esvaziamento do veículo: Essa configuração permite fazer uma parada de carregamento ao longo da viagem, porém após o esvaziamento do veículo.
6. Considerar retorno à primeira parada: Com essa configuração o sistema irá fazer o planejamento da viagem, calcular a distância da última parada até a primeira parada e somar essa distância no total da viagem.
7. Considerar retorno na distância do plano: Ao selecionar essa opção o sistema irá considerar a menor distância no retorno à origem.
8. Gaveta exclusiva por Produto/Tipo de pedido: Ao habilitar essa configuração, o sistema irá separar os produtos do pedido em gavetas diferentes, ou seja uma gaveta por produto (item).
9. Tipo de pedido/Pedido exclusivo por gaveta: Com essa configuração ativa o sistema irá considerar que cada gaveta será para um tipo de pedido/pedido específico, mesmo que ainda tenha espaço na gaveta. Para que essa configuração seja efetivada, é necessário também configurar essa informação dentro do cadastro de tipo de pedido e cadastro de veículo.
10.Tipo de pedido/Pedido ocupa toda a gaveta: Ao habilitar essa configuração, você indica que o pedido deve ocupar toda a gaveta, e para que isso aconteça o pedido deve conter peso e/ou volume de acordo com a capacidade da gaveta, caso exceda o sistema irá retornará uma violação e não criará a viagem.
11. Divide job por zona de transporte/agrupador Operação: Ao ativar essa configuração, o sistema irá realizar as roteirizações por zona de transporte, ou seja na página de otimização (Menu Programação > Otimização) o sistema retornará um ID (job) por zona de transporte, dividindo o tempo de processamento das viagens entre as zonas.
12. Usa a lei do motorista: Ao ativar o uso da lei do motorista, você deverá informar o tempo de descanso, tempo de descanso a cada 24 horas e o tempo de trabalho continuo. Essa informação será considerada no planejamento da viagem.
13. Considerar tempo máximo de viagem: Com essa configuração o sistema irá considerar o tempo máximo de viagem informado e caso exceda esse tempo e haja mais pedidos para serem roteirizados, criará mais viagens.
14. Dias para o início da viagem: Ao configurar esse campo, você irá definir o instante do início das viagens. Ao enviar os pedidos para roteirização, o sistema retornará as viagens com a data de início de acordo com o foi adicionado nesse campo.
Exemplo: se configurado com 2, e os pedidos forem roteirizados no dia 11 então a data de início da viagem será dia 13.
15. Considerar distância máxima entre paradas de descarregamento: O sistema irá considerar a distância máxima informada nessa configuração entre as paradas de descarregamento. Para isso, ative a configuração e inclua o valor máximo de km.
16. Estratégia de alocação de placas >
Estratégia de alocação de placas >Distribui alocação de placas entre viagens:
05. E-mails ÂncoraE-mails E-mails
E-mails | |
E-mails |
No TRE é possiível realizar o envio de e-mails durante o rastreamento e podem ser enviados em duas situações no momento da saída do monitorável e caso ocorra atraso. Para que seja realizado o envio de e-mail é necessário configurar os modelos utilizados para envio no momento da saída do monitorável e no caso de atraso e parametrizar o smtp.
a. Template
Na tela Template (Configuração > E-mails > Template) é possível configurar o corpo da mensagem que será enviada da saída e em caso de atrasos. Nela são exibidas duas abas para definição das mensagens à serem enviadas.
b. Configurações
Na tela Configurações(Configuração > E-mails > Configurações) é realizada a parametrização do smtp
06. Configuração de Transições ÂncoraConfiguração de Transições Configuração de Transições
Configuração de Transições | |
Configuração de Transições |
Aqui é possível configurar quais transições de carregamento e de descarregamento você deseja visualizar o status ao iniciar o monitoramento da viagem. As transições disponíveis são: Chegada, Início do carregamento/descarregamento, Fim do carregamento/descarregamento e Saída.
Para realizar essa configuração clique em Configuração > Roteirização > Configuração de transições e a tela será apresentada como a seguir:
- Para adicionar todas as transições disponíveis no carregamento, clique nas duas setas (→→) da coluna Desabilitadas para que sejam transferidas para a coluna Habilitadas.
- Caso você queira adicionar apenas alguma transição específica no carregamento, clique na transição desejada e depois clique na seta individual que (→) da coluna Desabilitadas.
- Repita esse mesmo processo para as Transições de descarregamento.
- Caso queira desabilitar alguma transição, basta seguir o mesmo processo porém da coluna de Habilitadas para a coluna de Desabilitadas.
- Após realizar as alterações desejadas, clique em Salvar.