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 Âncoraconfigeral 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 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 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 rastreada. Somente viagens rastreadas podem realizar a operação de encaixe.em execução.
3. Geocodificar primeiro resultado e marcar revisão: Geocodifica o endereço enviado na requisição e deixa mercado 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 incluir pedidos na rota desde que seja realizada a associação do pedido via encaixe em uma viagem não tenha sido iniciada.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.
- 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).
Esta configuração não reflete em arquivos importados via excel, apenas integração com sistema externo.
1
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.
32. 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)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".
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çãoNesta 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çãoEsta 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.
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 Âncora Restriçõ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:
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çõesPara 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-mailsNo 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.
05. E-mails Âncora E-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 (→) 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.