Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  1. Visão Geral
  2. Exemplo de utilização
  3. Tela Principal da Viagem  - Campo Tipo de Operação
  4. Tela Complemento da Viagem - Campo Frete 
  5. Tabelas utilizadas


01. VISÃO GERAL


Esta documentação visa orientar ao usuário quais informações o sistema coleta para realizar a consulta de frete mínimo, baseada nas informações de viagens originadas do Totvs Logística TMS junto ao sistema Pamcard. O objetivo desta funcionalidade é verificar se a previsão de frete estabelecida do TMS, confere com os valores e informações pré-estabelecidos conforme a tabela de frete mínimo estabelecida pela ANTT.

A consulta do frete mínimo se dará através da troca de mensagens via Web Service entre os programas Totvs Logística TMS Protheus x Sistema de pagamentos Pamcard, cuja mensagem se chama 'FindMinimumFreight'

...

. A consulta das informações ocorrerão sempre com uma viagem do TMS associada, e poderá ocorrer nos momentos abaixo:

  • Digitação do valor do frete da viagem (DTR_VALFRE)
  • Confirmação do Complemento de Viagem 
  • Confirmação da Viagem




Ao digitar o valor do frete, confirmar a tela de complemento da viagem, confirmar a viagem ou realizar o fechamento da viagem, o sistema consultará o frete mínimo junto a Pamcard.



Tags Método FindMinimumFreightConteúdo enviado através das informações da viagem TMS no Protheus
viagem.contratante.documento.numeroCNPJ da contratante TMS
viagem.unidade.documento.tipoTag somente enviada neste método caso quando a filial TMS contratante Pamcard é diferente da filial da Viagem TMS
viagem.unidade.documento.numeroTag somente enviada neste método caso quando a filial TMS contratante Pamcard é diferente da filial da Viagem TMS
viagem.veiculo.categoriaCategoria do veículo Pamcard inserido na viagem (DUT_TIPVEI)
viagem.distancia.kmInformação de KM buscada diretamente do cadastro de Distâncias ou através do Cadastro de Distâncias por Cliente , onde o sisetma irá coletar o KM das regiões pertinentes as informações da viagem em questão do TMS
viagem.frete.origem.brutoValor do frete no campo Vlr Frete (DTR_VALFRE)
viagem.contratacao.tipoConteúdo 1 -  Para viagens cuja frota é própria e há apenas um documento na viagem. 
Conteúdo 2 - Para viagens cuja frota de veículo é de propriedade de terceiro ou agregado
viagem.veiculo.altodesempenho.indicadorConteúdo S -  Para viagens cuja frota é própria e há apenas um documento na viagem. 
Conteúdo N - Para viagens cuja frota de veículo é de propriedade de terceiro ou agregado

...


Para realizar a consulta do frete mínimo junto ao sistema Pamcard, se faz necessário realizar as seguintes ações dentro da viagem Modelo 2 do Totvs Logistica TMS integrada junto ao sistema Pamcard:

1. Sistema devidamente configurado para atender a integração Totvs Logistica TMS x Sistema Pamcard.
2. Possuir configurado os Tipos de Operações através da rotina Tipos de Operações da Viagem (TMSA039 - SIGATMS) e o TMS devidamente configurado para respeitar tal configuração (apreciar documentação conforme link).
3. Possuir o cadastro de Distânciase e/ou Cadastro de Distâncias por Cliente para o sistema obter a quilometragem para a viagem em questão.
4. Preencher o campo Tp. Oper. Vge (DTQ_TPOPVG) na tela  principal da viagem ao incluir uma viagem Rodoviário Entrega Mod. 2 , Rodoviário Transporte Mod.2 ou Rodoviário Coleta Mod. 2.
5Inclua uma viagem em Atualizações / Viagens / Rodoviário Coleta/ Viagens Mod.2 (TMSA144)  ou  Atualizações / Viagens / Rodoviário Entrega/ Viagens Mod.2 (TMSA144) ou Atualizações / Viagens / Rodoviário Transporte / Viagens Mod.2 (TMSA144) 
5. No campo Tp. Oper. Vge (DTQ_TPOPVG) informe ou selecione, pela tecla F3, um Tipo de Operação.
6. Digitar o valor do frete na tela de Complemento de Viagem (DTR_VALFRE)
7. Ao digitar o valor do frete, confirmar a tela de complemento da viagem, confirmar a viagem ou realizar o fechamento da viagem, o sistema consultará o frete mínimo junto a Pamcard.


Com estas configurações acima, ao preencher o valor de frete (DTR_VALFRE), confirmar o complemento da viagem ou a viagem, o sistema irá realizar a coleta interna de informações para consultar o frete mínimo junto a ao sistema Pamcard Pamcard. 

Informações

Uma das informações imprescindíveis para o processo, é o o sistema obter o KM da viagem em questão.


Após calcular a quilometragem da viagem, o TMS Protheus consultará o sistema Pamcard para verificar o valor do frete mínimo da viagem e caso o valor do frete informado no complemento da viagem (TMS) seja menor que o valor retornado pelo Pamcard, o transportador será avisado sobre esta divergência, porém a viagem será gravada.

Abaixo o detalhamento de busca das informações de KM para as viagens do TMS. A partir de tais informações, será verificado o cadastro de distâncias e ao encontrar uma distância para a região de origem x região de destino, a quilometragem (KM) desta distância será considerada na viagem.

VIAGEM DE COLETA
Origem da viagem: Região do remetente ou do solicitante (dependendo do local de coleta, campo DT5_LOCCOL) ou a a sequencia de endereço quando for informada na solicitação de coleta(DT5_SEQEND)do último documento da viagem(maior DUD_SEQUEN).
Destino da viagem: Região Região da filial da coleta, tendo em vista que a viagem de coleta é finalizada ao chegar na filial.
A partir disto, será verificado o cadastro de distâncias e ao encontrar uma distância para a região de origem x região de destino, a quilometragem (KM) desta distância será considerada na viagem.


VIAGEM DE ENTREGA
Origem da viagem: Região de origem da Rota da viagem (DA8_CDRORI) ou Região de Origem (DTQ_CDRORI) da tela de inclusão da Viagem
Destino da viagem: Região do destinatário do último documento da viagem  (maior DUD_SEQUEN)


VIAGEM DE TRANSPORTE
Origem da viagem: Filial de Origem da viagem.
Destino da viagem: Região da última filial de descarga da viagem, com base nos documentos relacionados para tal viagem. 


...