CONTEÚDO

  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',  e as informações coletadas no sistema e adicionadas no XML serão desmembradas em tags conforme relação abaixo:
      

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


   

02. EXEMPLO DE UTILIZAÇÃO


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/ou Cadastro de Distâncias por Cliente
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.
5. Digitar o valor do frete na tela de Complemento de Viagem (DTR_VALFRE)


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

Uma das informações imprescindíveis para o processo, é o o sistema obter o KM.


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


Para os processos de coleta e entrega,  o parâmetro MV_ULTDEST tem influência no envio do KM para consulta do frete mínimo. Caso o parâmetro esteja desabilitado (.F.), a quilometragem será dobrada, tendo em vista que o sistema considera este tipo de configuração como  ida e volta do veículo para realização da entrega.


03. TELA PRINCIPAL DA VIAGEM- CAMPO TIPO DE OPERAÇÃO DA VIAGEM

Disponível em: 
Atualizações / Viagens / Rodoviário Coleta / Viagens Mod.2 (TMSA144) 

Atualizações / Viagens / Rodoviário Entrega / Viagens Mod.2 (TMSA144) 
Atualizações / Viagens / Rodoviário Transporte / Viagens Mod.2 (TMSA144)

Incluir / Alterar / Visualizar 

CampoDescrição
Tp. Oper. VgeTipo de Operação da Viagem

04. TELA COMPLEMENTO DE VIAGEM - CAMPO VALOR DO FRETE

Disponível em: 
Atualizações / Viagens / Rodoviário Coleta / Viagens Mod.2 (TMSA144) 
Atualizações / Viagens / Rodoviário Entrega / Viagens Mod.2 (TMSA144) 
Atualizações / Viagens / Rodoviário Transporte / Viagens Mod.2 (TMSA144)


Principais Campos e Parâmetros

CampoDescrição
Frete

Valor do frete a ser pago ao Carreteiro


05. TABELAS UTILIZADAS

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>