Histórico da Página

01. Disponibilidade

Âncora
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 

Âncora
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. 
    • •  
•  
  • 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.

• • 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 origem 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 

Âncora
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.

• • 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

Âncora
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:

1. 1. Durações fixas
   2. Duração máxima
   3. Duração por peso
   4. 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ção

Âncora
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

Aqui temos a possibilidade de configurar:

1. 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. 

       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 mercado 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 incluir pedidos em viagens rastreadas porém não iniciadas.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
confiaquisição confiaquisição

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. Aquisição ligada: Permite receber integração das entidades como produto, localidade e pedidos desde que os mesmos estejam selecionados (ver item 7 dessa lista).

       2. 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.

       3. Atualização permite inserir: Permite receber requisições de Update na entidade. Ex: inserir um item à um pedido.

       4. 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".

       5. Permite alteração de pedido em viagem liberada: Define o script de política de itens de pedido em viagem. Caso a opção esteja selecionada (KeepTripsOrderItemInTripPolicy), mantém a viagem vigente e apenas altera os itens de pedidos que foram removidos ou atualizados. Caso contrário (RejectUpdateOrderItemInTripPolicyFactory) não deixa que nenhum item de pedido dentro de viagens seja atualizado (ou seja sempre vai rejeitar as atualizações).

       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. Ativa para: aqui você seleciona quais entidades você irá fornecer dados para integração com o sistema (Produto, localidade e pedidos).

c. Publicação 

Âncora
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.

1. 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

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  

Âncora
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 > Concentra alocação de placas entre viagens: O sistema irá priorizar usar a mesma placa nas viagens geradas como resultado da roteirização.

           Estratégia de alocação de placas >Distribui alocação de placas entre viagens: O sistema irá priorizar usar diferentes placas nas viagens geradas como resultado da roteirização.

05. E-mails 

Âncora
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 

Âncora
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 (→) 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.