Árvore de páginas

Versões comparadas

Chave

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

...

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:


Abaixo a relação entre as tags do método de Frete mínimo (FindMinimumFreight) do sistema Pamcard, ao qual o TMS envia através das informações relativas a viagem. São elas:


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, campo Tipo do Veiculo (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
Valor do 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

...

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.

Caso o valor de frete informado no TMS seja inferior ao valor de frete consultado pelo método Frete Mínimo, o usuário receberá a mensagem "Valor Mínimo de Frete não atende tabela ANTT. "//--" Valor ANTT:  XXXXXX" ,  porém a mensagem não é impeditiva para confirmação da viagem e a viagem será gravada.

Informações
titleImportante!

Uma das informações imprescindíveis consulta do Frete Mínimo junto a operadora Pamcard, é o sistema obter o KM da viagem em questão. Com base nas informações a seguir, é que deverão ser cadastradas as informações de quilometragem nas rotinas  Distâncias (TMSA710 - SIGATMS) e/ou Distâncias Por Clientes (TMSA711 - SIGATMS).

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.


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. 

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.

...