Árvore de páginas

Roteiro

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Supply Chain - Logística

Módulo:

SIGATMS - Gestão de Transportes

Rotina:

Rotina

Nome Técnico

TMSAF10Carga do Roteiro

TMSAF11

Cadastro de Roteiros

TMSAF12

Roteiros da Viagem

TMSAF13

Sugestão de Rota

TMSAF14

Distância entre Clientes

TMSGRIDORD

Cadastro de Rotas

OMSA100

Funções de Reordenação Grid MVC

TMSA140

Geração de Viagens 

TMSA144

Manutenção de Viagem (Mod.2)   

TMSA141

Geração de Viagens de Coleta / Entrega 

TECA250

Contrato de Cliente

TMSA146

Programação de Carregamento

TMSA310

Fechamento de Viagem

TMSXFUNA

Funções Genéricas

MDFESEFAZ

Manifesto Eletrônico da SEFAZ

Rotina(s) envolvida(s)

Nome Técnico

TMSA146

Programação de Carregamento

Cadastros Iniciais:

Cadastro Básico do TMS

Digitação de Notas

Geração do Conhecimento

Parâmetro(s):

MV_EXSGROT - Verifica se exibe sugestão de Rota.

MV_TMALTKM - Permite alterar a Km dos trechos do Roteiro.

Requisito/Story/Issue (informe o requisito relacionado):

LOGTMS01-303

País(es):

Brasil

Banco(s) de Dados:

Todos

Tabelas Utilizadas:

  • DDJ - Roteiros
  • DDO - Distância entre Clientes
  • DIQ - Percurso do MDF-e SEFAZ
  • DJF - Roteiros da Viagem
  • DJG - Cabeçalho do Roteiro
  • DJH - Rota X Roteiro
  • DJJ - Documentos do Trecho
  • DJK - Estados de Passagem do Roteiro
  • DTQ - Viagem

Sistema(s) Operacional(is):

Windows / Linux


Descrição

O objetivo desta funcionalidade é permitir a geração de rotas automáticas a partir de roteiros informados pelo transportador, os quais podem ser informados na inclusão de uma viagem (Coleta e Entrega).

Após a confirmação do roteiro da viagem, o sistema fará uma busca para verificar se este roteiro já existe em alguma rota cadastrada no sistema. Caso exista, o transportador poderá escolher a rota para ser utilizada na viagem, caso contrário, o SIGATMS criará automaticamente uma nova rota com o roteiro informado.

Também existe a opção de cadastrar os roteiros e vinculá-los a uma rota de forma manual pela rotina de Cadastro de Rotas (OMSA100).

Para o uso desta funcionalidade é necessário deixar o campo Rota (DTQ_ROTA) em branco no momento da inclusão da viagem.

Nota!

Esta rotina foi desenvolvida em MVC - ADVPL ®, portanto, existe um conjunto padrão de pontos de entrada.

Verifique o Ponto de Entrada Padrão do MVC.


Funcionalidades

Cadastro de Roteiros

Foi disponibilizada funcionalidade de Cadastro de Roteiro no Gestão de Transportes (SIGATMS), acessando Atualizações / Logística / Roteiros (TMSAF11), onde o usuário poderá Incluir, Alterar e Excluir roteiros. Esta rotina possui validações de forma que só poderão ser modificados ou excluídos os roteiros que não estejam vinculados a Rotas.

Na mesma será possível adicionar clientes em sequências escolhida pelo usuário, permitindo que o mesmo realize a alteração da sequência diretamente pelo campo.  

O campo de descrição do roteiro é o único que poderá ser alterado após o roteiro já estar em uso.

Cadastro de Rotas

Ao abrir o Cadastro de Rotas (OMSA100) e acessar a pasta de roteiros será possível visualizar os roteiros vinculados a rota, vincular roteiros existentes (cadastrados previamente) ou incluir novos roteiros e efetuar seu vínculo com a rota.  Na alteração de uma rota com roteiro, será permitido manipular os roteiros somente se eles não tiverem sido utilizados em viagens.

Também foi disponibilizada a possibilidade de vincular Percursos do MDF-e aos Roteiros. Desta forma, uma vez que a rota possua roteiros, as pastas de Distribuição, Transferência e Percurso do MDF-e da rota, não poderão ser preenchidas e vice-versa.

Ao vincular um roteiro no cadastro de rotas, o mesmo já fará o preenchimento automático dos pontos de passagem de MDF-e, permitindo manipulação do usuário.

Em relação a pasta “Rota x Operadora de Frotas”, os dados devem ser preenchidos manualmente pelo usuário. Este processo também será manual caso a rota seja gerada automaticamente através de uma viagem.

Tela de Roteiro

Após preencher a viagem Modelo 2 e adicionar todos os documentos, o Protheus® realizará um processamento e apresentará a tela de roteiros.

Esta tela possui a seguinte estrutura:

a) Pasta Geral

Contém todos os pontos que o veículo passará em seu percurso de viagem.

    • A mesma permite adicionar novos clientes como ponto de apoio.
    • Realizar o preenchimento da Km caso a mesma esteja vazia.
    • Realizar reordenação entre os trechos.
    • Ao manipular os trechos do roteiro, os estados de passagem serão atualizados automaticamente.

b) Estados de Passagem

Define todos os estados de passagem vinculados ou não com os trechos do roteiro, esta tabela servirá para a geração do manifesto de carga e geração do MDF-e. 

    • A mesma aparece apenas na Pasta "Geral".
    • A mesma permite realizar a inclusão de novos pontos e realizar a reordenação dos pontos que foram incluídos manualmente.

c) Pasta de Clientes 

Contém os clientes de passagem referente a cada cliente pagador de frete, para que se possa definir a Km e os trechos que cada cliente pagador terá.

    • A mesma permite adicionar novos clientes como ponto de apoio.
    • Realizar o preenchimento da Km caso a mesma esteja vazia.
    • Realizar reordenação entre os trechos.

d) Legendas das Pastas

      

e) Legenda - Estados de Passagem


Sugestão de Rota/Roteiro

Ao final da manipulação dos trechos do roteiro e clicar em confirmar, o sistema efetuará a busca do roteiro considerando a ordem dos estados de passagem de forma “exatamente igual” ou, caso não exista, realizará uma busca por “Região inicial e Região final”, e desta forma exibirá uma tela para que o usuário escolha uma rota já existente ou caso necessário inclua uma nova rota vinculando o roteiro selecionado para a pasta.

Esta tela pode não ser apresentada caso o parâmetro MV_EXSGROT esteja configurado como False (.F.) e já existam Rotas cadastradas com o roteiro escolhido. Caso o usuário opte em sempre exibir a tela para os roteiros, o parâmetro MV_EXSGROT deve ficar configurado com True (.T.).

Ao dar duplo clique sobre cada uma das linhas, serão apresentadas as opções de vínculo do roteiro com uma rota existente ou cadastro de nova rota.

Lembrando que caso os roteiros apareçam com status Vermelho (Sem sugestão de rota), a tela de cadastro de rota será aberta ao dar o duplo clique sobre a linha.

Quando todos os roteiros tiverem com status Verde (Rota Cadastrada) e clicar em salvar, o sistema vinculará a Rota relacionada com o roteiro da Pasta Geral na viagem e concluirá o processo de gravação da viagem.

Cadastro de Distância Entre Clientes

Foi disponibilizado um cadastro de distância entre clientes no Gestão de Transportes (SIGATMS), acessando Atualizações / Logística / Distância Entre Clientes (TMSAF14).

Esta tela possibilita um cadastro de Km dos trechos fora da rotina de roteiros, desta forma, o usuário pode realizar a Inclusão, Alteração, Visualização e Exclusão das distâncias entre os trechos para um determinado cliente pagador.

Inclusão / Alteração da Viagem

Na inclusão ou alteração da viagem (respeitadas as validações), o sistema gravará na DTQ - Viagens que utilizarem Rotas com Roteiros, os campos de rota e roteiro original (somente na inclusão), região origem, região destino e quilometragem que poderão ser utilizados no cálculo do contrato de carreteiro.

Na alteração de viagem onde, originalmente a rota utilizada foi por roteiro, se o usuário incluir ou excluir documentos, o sistema executará a tela de Pagadores e de Roteiros e elas terão as suas validações específicas. Especificamente na tela de roteiros, o sistema deverá trazer os roteiros vinculados originalmente à viagem e em seguida os novos trechos adicionados na viagem, ou os trechos deletados e o usuário poderá alterar a ordem dos documentos, incluir pontos de apoio ou excluir pontos desde que respeitadas as validações de cada situação. Por exemplo, caso a viagem esteja com status “Em trânsito”,  não poderá ser alterada a ordem daqueles documentos que porventura já tenham recebido os apontamentos das respectivas operações.

Alteração da Rota de Viagem

Ao alterar uma Viagem por meio da rotina Modelo 2, será possível alterar a Rota já gravada e, neste caso, o campo do roteiro terá seu conteúdo excluído para que seja preenchido conforme a nova rota. Também será possível realizar visualizações somente na opção Visualizar Viagem

Atenção

 Esta funcionalidade não está disponível para a rotina de Viagem Modelo 1.


Procedimento para Configuração

CONFIGURAÇÃO DE PARÂMETROS 

  1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017).
  2. Configure  o(s) parâmetro(s) a seguir:

Itens/Pastas

Descrição

Nome:

MV_EXSGROT

Tipo:

Lógico

Cont. Por.:

.F.

Descrição:

Verifica se exibe sugestão de Rota.

 

Itens/Pastas

Descrição

Nome:

 MV_TMALTKM

Tipo:

Lógico

Cont. Por.:

.F.

Descrição:

Permite alterar a Km dos trechos do Roteiro.


Procedimento para Utilização 

Exemplo

  1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Viagens / Rodoviário Entrega / Viagem Modelo 2 (TMSA144).

  2. Clique em Incluir.

  3. Cadastre uma nova viagem.

  4. No cabeçalho da viagem deixe o campo Rota (DTQ_ROTA) vazio.

  5. Adicione os documentos desejados para a viagem.

  6. Preencha o complemento da viagem.

  7. Clique em Salvar.

  8. A tela de Roteiro é aberta.

  9. Realize as manipulações de Km e de reordenação de sequências nos trechos do roteiro nas diversas pastas.

  10. Realize a manipulação dos Estados de passagem.

  11. Clique em Confirmar.

  12. A tela de sugestão de rota será apresentada.

  13. Se não houver sugestão de rota, ao executar o duplo clique sobre a linha ou clicar em  Outras Ações / Cadastrar,  a tela de cadastro de rotas será aberta automaticamente.

  14. Se houver sugestões, ao executar o duplo clique na linha será aberta uma tela com as opções para selecionar uma rota existente ou cadastrar uma nova rota.

  15. Após vincular todos os roteiros com suas rotas (todas as linha com status verde), clique em Fechar.

  16. O sistema vinculará automaticamente a rota da Pasta Geral na viagem.