Árvore de páginas

Versões comparadas

Chave

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


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'. Para ativar a gravação de arquivos que registram a troca de mensagens no Protheus, o ambiente deverá configurar o parâmetro MV_TMSXML=T (Ao gerar uma nova viagem integrada com a Pamcard, todas as mensagens integradas serão gravadas na pasta do StartPath indicada no Appserver do ambiente Microsiga Protheus).

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

...

Tags Método FindMinimumFreightConteúdo enviado através das informações da viagem TMS no Protheus
viagem.contratante.documento.numeroCNPJ da Filial TMS contratante junto a Pamcard - Cadastro de Operadora de Frotas
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 (TMSA710 - SIGATMS) e/ou através do Distâncias Por Clientes (TMSA711 - SIGATMS) com base nas informações da viagem TMS em questão
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ária as seguintes configurações dentro do Totvs Logística TMS :

1. Sistema devidamente configurado para atender a integração Totvs Logística TMS x Sistema Pamcard.
2. Possuir configurado os Tipos de Operações através da rotina Tipos de Operações da Viagem (TMSA039 - SIGATMS) 
3. Possuir configurado Distâncias (TMSA710 - SIGATMS) e/ou Distâncias Por Clientes (TMSA711 - SIGATMS), pois desta forma o sistema coletará os dados de quilometragem para a viagem em questão. Atentar a maiores informações nesta documentação para o correto relacionado do KM.
4. Inclua 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 (DTR_VALFRE) na tela de Complemento de Viagem (DTR_VALFRE). 
7. Ao digitar o valor do frete, confirmar a tela de complemento da viagem e/ou confirmar a viagem, o sistema consultará o frete mínimo junto a Pamcard.

...

Aviso
titleMV_ULTDEST

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

...

ParâmetroDescriçãoConteúdo Padrão
MV_ULTDEST

Define se utiliza o último destino da Coleta/Entrega para o cálculo do frete:

  • T (True/Verdadeiro): considera a região destino da última sequência de coleta/entrega.
  • F (False/Falso): a região destino será a mesma da região origem.
.F.



05. TABELAS UTILIZADAS

  • DTQ   - Viagem 
  • DTR   - Complemento da Viagem
  • DUD  - Movimento Operacional do Docto TMS
  • DVA   - Distâncias 
  • DVZ   - Distâncias Por Cliente
  • DEG   - Operadoras de Frota
  • DUN  - Aba Transferência do cadastro de Rotas
  • SM0   - Filiais do Protheus
  • DLO   - Tipo de Operação da Viagem
  • SX6    - Parâmetros

...