Histórico da Página
CONTEÚDO
- Visão Geral
- Exemplo de utilização
- Tela Principal da Viagem - Campo Tipo de Operação
- Tela Complemento da Viagem - Campo Frete
- 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:
- Digitação do valor do frete da viagem, campo Valor do Frete (DTR_VALFRE);
- Confirmação do Complemento de Viagem Viagem (TMSA240) ;
- Confirmação da Viagem;
- Fechamento da Viagem (TMSA310D).
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 FindMinimumFreight | Conteúdo enviado através das informações da viagem TMS no Protheus |
---|---|
viagem.contratante.documento.numero | CNPJ da |
Filial TMS contratante junto a Pamcard - Cadastro de Operadora de Frotas; | |
viagem.unidade.documento.tipo | Tag somente enviada neste método caso quando a filial TMS contratante Pamcard é diferente da filial da Viagem TMS; |
viagem.unidade.documento.numero | Tag somente enviada neste método caso quando a filial TMS contratante Pamcard é diferente da filial da Viagem TMS; |
viagem.veiculo.categoria | Categoria do veículo Pamcard inserido na viagem, campo Tipo do Veiculo (DUT_TIPVEI); |
viagem.distancia.km | Informaçã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.bruto | Valor do frete no campo |
Valor do Frete (DTR_VALFRE); | |
viagem.contratacao.tipo | Conteú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.indicador | Conteú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.
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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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
Campo | Descrição |
---|---|
Tp. Oper. Vge | Tipo 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
Campo | Descrição |
---|---|
Frete | Valor do frete a ser pago ao Carreteiro |
Parâmetro | Descrição | Conteúdo Padrão |
---|---|---|
MV_ULTDEST | Define se utiliza o último destino da Coleta/Entrega para o cálculo do frete:
| .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
HTML |
---|
<!-- 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> |