Árvore de páginas

Pamcard - Mais de um Cartão na Viagem

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Supply Chain - Logística

Módulo:

SIGATMS - Gestão de Transportes

Rotina:

Rotina

Nome Técnico

TMSA240

Complemento de Viagem

TMSA250Contrato de Carreteiro
TMSA251Liberação do Contrato Carreteiro
TMSA310Fechamento da Viagem
TMSXFUNPFunção Genérica
TMSPAMCARDPamcard
PAMCARDNEWPamcard
TMSA140Geração de Viagem de Transferência
TMSA141Geração de Viagens de Coleta/Entrega

Cadastros Iniciais:

Configuração Pamcard

Requisito/Story/Issue:

DLOGTMS03-902

País(es):

Brasil

Banco(s) de Dados:

Todos

Tabelas Utilizadas:

DA3- Veiculos

DA4- Motoristas

SA2 - Fornecedores

DT6- Documento de Transporte

DTQ - Viagem

DTR - Complemento de Viagem

DUP - Motoristas da Viagem

DLD - Formas de Pagamento

DEL - Motorista x Operadora de Frotas

Sistema(s) Operacional(is):

Windows / Linux


Descrição

Neste requisito foram implementadas as seguintes melhorias:

  • Nova funcionalidade na viagem com operadora de frotas Pamcard, permitindo a inclusão de mais de um cartão para pagamento do Pedágio, do Adiantamento e do Saldo do Frete.
  • Inclusão do Código e da Loja do Favorecido no momento da Inclusão da Viagem, para que este favorecido seja utilizado no momento da gravação do titulo a pagar. O objetivo é fazer com que seja respeitado o favorecido no momento da geração da viagem, evitando que uma alteração no Cadastro do Fornecedor/Veículo permita que um título seja gravado para outro favorecido.

Mais de um Cartão na Viagem

Nessa funcionalidade foram efetuadas as seguintes alterações:

  • Complemento da Viagem (TMSA240)

Na aba Operadora de Frotas foram criados campos referentes ao Tipo de Pagamento do Pedágio  (DTR_TPSDPG),  Quantidade de Saque (DTR_QTDSAQ) e Quantidade de Transferencia (DTR_QTDTRA). 

Disponibilizada uma nova opção 'Formas de Pagto',  tecla de atalho F2, que permite informar os cartões para pagamento do Adiantamento, Saldo do Frete e Pedágio. Essas informações serão armazenadas na tabela DLD - Formas de Pagamento.

O campo Id.Motorista (DUP_IDOPE ) não será desativado neste momento, porém o sistema ira se comportar da seguinte forma:

    • Na inclusão de uma viagem, se informado o campo Id. Motorista (DUP_IDOPE) e não houver nenhuma interação na tela de Formas de Pagamento, ao salvar a viagem  o sistema irá gerar automaticamente os registros na tabela DLD- Formas de Pagamento com base dos campos: Id.Motorista (DUP_IDOPE ),  Meio Pg.Frt.(DUP_FORPAG), Meio Pg.Adto (DUP_FORADT) , conforme exemplo abaixo:

      Exemplo 1:
      Meio Pagamento de Frete (DUP_FORPAG) igual 0- Não Utiliza, será gerado um registro na Tabela DLD, sendo:

      Tabela DLDMotorista da Viagem (Tabela DUP)
      DLD_IDOPEDUP_IDOPE
      DLD_FORPAG1- Cartão
      DLD_TIPPAR2- Saldo do Frete

      DLD_RECEB

      1- Proprietário
      DLD_CODFAVFavorecido do Veiculo / Fornecedor
      DLD_LOJFAVLoja do Favorecido do Veiculo / Fornecedor


      Exemplo 2:
      Meio de Pagamento de Adiantamento (DUP_FORADT), será gerado um registro na Tabela DLD somente se houver um valor de adiantamento de frete (DTR_ADIFRE) sendo:

      Tabela DLDMotorista da Viagem (Tabela DUP)
      DLD_IDOPEDUP_IDOPE
      DLD_FORPAGDUP_FORADT
      DLD_TIPPAR1- Adiantamento
      DLD_RECEB1- Proprietário


      Exemplo 3:
      Meio Pagamento de Frete (DUP_FORPAG) diferente de 0-Não Utiliza

      Tabela DLDMotorista da Viagem (Tabela DUP)
      DLD_IDOPEDUP_IDOPE
      DLD_FORPAGDUP_FORPAG
      DLD_TIPPAR2- Saldo do Frete
      DLD_RECEB1- Proprietário
      DLD_CODFAVFavorecido do Veiculo / Fornecedor
      DLD_LOJFAVLoja do Favorecido do Veiculo / Fornecedor


    • Na inclusão/alteração de uma viagem, se informado o campo Id. Motorista (DUP_IDOPE) e houver uma interação na tela de Formas de Pagamento, ao salvar a viagem  o sistema gravará os dados na tabela DLD- Formas de Pagamento e os campos referentes ao Motorista da Viagem,  Id.Motorista (DUP_IDOPE ),  Meio Pg.Frt.(DUP_FORPAG), Meio Pg.Adto (DUP_FORADT)  serão ignorados e bloqueados para edição. Dessa forma, a alteração dos dados de operadora deverá ser realizada apenas pela funcionalidade Formas de Pagamento.

      Importante!

      Devido as regras da Operadora Pamcard não é permitido utilizar o Tipo de Parcela 'Pedágio', quando houver mais de um Recebedor de Frete (Motorista e Proprietário ou Proprietário com Favorecido)

  • Fechamento da Viagem (TMSA310)

No fechamento da viagem os dados da tabela DLD - Formas de Pagamento serão considerados para o envio dos favorecidos do Contrato da Pamcard.

Quando a tabela DLD - Formas de Pagamento não possuir registros para a viagem serão considerados os dados da tabela DUP - Motoristas da Viagem para o envio das informações para a Pamcard.

O proprietário do veículo da viagem (DTR_CODFOR+DTR_LOJFOR) sempre será enviado como contratado para Pamcard, independente do mesmo ser recebedor de parcelas do frete.

O favorecido e o motorista serão enviados como favorecido para Pamcard, caso sejam recebedores de parcela do frete.

Abaixo exemplos de envio dos favorecidos para a Pamcard.

Exemplo 1:
Proprietário Recebedor do adiantamento e saldo do frete, sendo a mesma forma de pagamento


    1. Contratado - Proprietário
    2. Sub-Contratante - Não será enviado
    3. Motorista - Não será enviado

Exemplo2:
Proprietário Recebedor do adiantamento e saldo do frete, formas de pagamento diferente


    1. Contratado - Proprietário com forma de pagamento da parcela de adiantamento
    2. Sub-Contratante - Proprietário com forma de pagamento da parcela de saldo
    3. Motorista - Não será enviado

Exemplo 3
Motorista recebedor do adiantamento e Proprietário recebedor do saldo


    1. Contratado - Proprietário com forma de pagamento da parcela de saldo
    2. Sub-Contratante - Não será enviado
    3. Motorista - Motorista com a forma de pagamento da parcela de adiantamento

Exemplo 4:
Motorista Recebedor do adiantamento e saldo do frete, sendo a mesma forma de pagamento

    1. Contratado - Proprietário com forma de pagamento depósito em conta 
    2. Sub-Contratante - Não será enviado
    3. Motorista - Motorista com a forma de pagamento da parcela de saldo

Exemplo 5:
Motorista Recebedor do adiantamento e saldo do frete, formas de pagamento diferente


    1. Contratado - Proprietário com forma de pagamento depósito em conta 
    2. Sub-Contratante -  Motorista com a forma de pagamento da parcela de adiantamento
    3. Motorista - Motorista com a forma de pagamento da parcela de saldo

Exemplo 6:
Proprietário Recebedor do adiantamento e saldo do frete, sendo a mesma forma de pagamento com favorecido

    1. Contratado - Proprietário com forma de pagamento depósito em conta 
    2. Sub-Contratante -  Favorecido com a forma de pagamento da parcela de saldo
    3. Motorista - Não será enviado

Exemplo 7:
Proprietário Recebedor do adiantamento e saldo do frete, formas de pagamento diferente com favorecido

    1. Contratado - Proprietário com forma de pagamento depósito em conta 
    2. Sub-Contratante -  Favorecido com a forma de pagamento da parcela de adiantamento
    3. Motorista  -  Favorecido com a forma de pagamento da parcela de saldo
  • Cartão de Pedágio

Para informar um  cartão específico para pagamento do Pedágio deve-se informar a parcela de pedágio, sendo que a mesma somente pode ser informada se no Contrato com a Pamcard não existir o Sub-Contrante e o Motorista, ou seja, quando o Proprietário for recebedor do adiantamento e saldo e a forma de pagamento das parcelas forem iguais.

Abaixo exemplo:

Quando não informada a parcela de pedágio o sistema considerará o cartão da parcela de saldo para envio do pedágio, se a parcela de saldo não possuir cartão o pedágio será creditado no cartão da parcela de adiantamento. 

Se a viagem possuir pedágio e na tabela DLD - Formas de Pagamento não existir cartão o sistema exibirá um alerta e não permitirá a confirmação da viagem.

No caso de CIOT por período o cartão de pedágio será incluído na viagem da Pamcard.

  • Parcela de Adiantamento

Quando na tabela DLD - Formas de Pagamento existir a parcela de adiantamento o Recebedor informado será considerado no envio da parcela para Pamcard.

Quando não informada a parcela de adiantamento será enviado o Recebedor da parcela de saldo.

  • Pagamento de Saldo (TMSA250) 

No pagamento de saldo do Contrato o sistema verificará o recebedor da parcela de saldo para envio do favorecido da parcela para Pamcard.

  • Liberação do Contrato (TMSA251)  

Na liberação do Contrato o sistema verificará o recebedor da parcela de saldo para envio do favorecido da parcela para Pamcard.

Favorecido na Viagem

Nessa funcionalidade foram efetuadas as seguintes alterações:

  • Complemento da Viagem (TMSA240)

No Cadastro de Veículo e Fornecedor é possivel informar um outro Fornecedor como Favorecido, sendo que este Favorecido será o recebedor dos títulos a pagar, referente  ao Fornecedor/Veículo da viagem.

Na rotina de Complemento de Viagem foram criados os campos:  Codigo Favorecido (DTR_CODFAV), Loja Favorecido (DTR_LOJAV) e Nome Favorecido (DTR_NOMFAV), que serão preenchidos automaticamente após a informação do Veiculo da viagem, de acordo com os dados do Cadastro do Veiculo e Fornecedor (Favorecido).

  • Fechamento da Viagem (TMSA310)

Ajuste nessa rotina para que seja considerado o Favorecido informado na Viagem (DTR_CODFAV e DTR_LOJFAV)  e, caso não tenha sido preenchido, buscará o Favorecido no Cadastro do Veiculo /  Fornecedor.

  • Contrato de Carreteiro (TMSA250)

Alterada a função T250BscFav() - Retorna o Favorecido do Fornecedor ou Veiculo, incluindo nos parâmetros, a Filial da Viagem e Número da Viagem.

Essa função irá considerar o Favorecido informado na Viagem (DTR_CODFAV e DTR_LOJFAV)  e, caso não tenha sido preenchido , buscará o Favorecido no Cadastro do Veiculo /  Fornecedor.

  • Funções Genéricas (TMSXFUNP e TMSPAMCARD)

Ajuste na rotina para considerar o Favorecido informado na Viagem (DTR_CODFAV e DTR_LOJFAV)  e, caso não tenha sido preenchido, buscará o Favorecido no Cadastro do Veiculo /  Fornecedor.


Procedimento para Implantação

Aplique o patch do chamado e execute a atualização do pacote de dicionário de dados para a criação dos novos campos.

O pacote de dicionário de dados estará disponível apenas no release 12.1.23.


Atualizações do Compatibilizador

1.   Criação de tabela no arquivo SX2– Tabelas:

Chave

Nome

Modo

PYME

DLD

Pagamento da ViagemCN


2.  Criação de Campos no arquivo SX3 – Campos:

  • Tabela DLD - Pagamento da Viagem

Campo

DLD_FILIAL

Tipo

Caractere

Tamanho

2

Decimal


Formato

@!

Título

Filial

Descrição

Filial do Sistema

Usado

N

Obrigatório

S

Browse

S

Grupo

033

Help

Filial do Sistema

Campo

DLD_FILORI

Tipo

Caractere

Tamanho

2

Decimal


Formato

@!

Título

Fil.Origem

Descrição

Filial de Origem

Usado

S

Obrigatório

S

Browse

S

Grupo

033

Help

Filial de Origem da Viagem


Campo

DLD_VIAGEM

Tipo

Caractere

Tamanho

6

Decimal


Formato

@!

Título

Viagem

Descrição

Numero da Viagem

Usado

S

Obrigatório

S

Browse

S

Grupo

Numero da Viagem

Help

Filial de Origem da Viagem

Campo

DLD_ITEDTR

Tipo

Caractere

Tamanho

2

Decimal


Formato

@!

Título

It.Comp.Viag

Descrição

Item Complemento Viagem

Usado

S

Obrigatório

S

Browse

S

Grupo


Help

Item Complemento Viagem

Campo

DLD_CODVEI

Tipo

Caractere

Tamanho

8

Decimal


Formato

@!

Título

Cod.Veiculo

Descrição

Codigo do Veiculo

Usado

S

Obrigatório

S

Browse

S

Val.Sistema

Vazio() .Or. ((ExistCpo('DA3') .And. TMSA240Vld())

Help

Veiculo da Viagem


Campo

DLD_FORPAG

Tipo

Caractere

Tamanho

1

Decimal


Formato

@!

Título

Forma Pagto

Descrição

Forma de Pagamento

Usado

S

Obrigatório

S

Browse

S

Val.Sistema

Pertence('12')

Opção

1=Cartão;2=Deposito

Help

Indica a forma de pagamento que será efetuado ao Motorista

Campo

DLD_TIPPAR

Tipo

Caractere

Tamanho

1

Decimal


Formato

@!

Título

Tipo Parcela

Descrição

Tipo da Parcela

Usado

S

Obrigatório

S

Browse

S

Val.Sistema

Pertence('123')

Opção

1=Adiantamento;2=Saldo Frete;3=Pedagio

Help

Indica se o pagamento da parcela se refere a Adiantamento, Saldo de Frete ou Pedágio

Campo

DLD_RECEB 

Tipo

Caractere

Tamanho

1

Decimal


Formato

@!

Título

Recebedor

Descrição

Recebedor

Usado

S

Obrigatório

S

Browse

S

Val.Sistema

Pertence('12') .And. TMSA240Vld()

Opção

1=Proprietario;2=Motorista

Help

Indica o Recebedor do Frete

Campo

DLD_IDOPE

Tipo

Caractere

Tamanho

20

Decimal


Formato

@!

Título

Id. Cartão

Descrição

Id. Cartão

Usado

S

Obrigatório

S

Browse

S

Help

Id do Cartão junto a Operadora de Frota


Campo

DLD_CARCAN

Tipo

Caractere

Tamanho

20

Decimal

0

Formato

@!

Título

N.Car.Cancel

Descrição

N. Cartão Cancelado      

Usado

S

Obrigatório

S

Browse

S

Help

Número do cartão cancelado junto a operadora de frete.


Campo

DLD_CODFAV

Tipo

Caractere

Tamanho

6

Decimal

0

Formato

@!

Título

Cod.Favorec 

Descrição

Codigo do Favorecido     

Usado

S

Obrigatório

S

Browse

S

Help

Indica se o Fornecedor possui favorecido.

Caso possuir, as parcelas do Fornecedor serão para o Favorecido.

Campo

DLD_LOJFAV

Tipo

Caractere

Tamanho

2

Decimal

0

Formato

@!

Título

Loja.Favorec 

Descrição

Loja do Favorecido     

Usado

S

Obrigatório

S

Browse

S

Help

Indica se o Fornecedor possui favorecido.Caso possuir, as parcelas do Fornecedor serão para o Favorecido.

Campo

DLD_NOMFAV

Tipo

Caractere

Tamanho

40

Decimal

0

Formato

@!

Título

Favorecido

Descrição

Favorecido

Usado

S

Obrigatório

S

Browse

S

Help

Indica se o Fornecedor possui favorecido.

Caso possuir, as parcelas do Fornecedor serão para o Favorecido.


  • Tabela DTR - Complemento da Viagem

Campo

DTR_TPSPDG

Tipo

Caractere

Tamanho

1

Decimal

0

Formato

@!

Título

Tp Pgt Pedag

Descrição

Tipo Pagamento Pedagio   

Usado

S

Obrigatório

N

Browse

S

Help

Campo para integração com o sistema Pamcard.

Informar quem será o responsável pelo pagamento do pedágio, se for através do sistema Pamcard, informe a opção

“5=Pamcard”.

Campo

DTR_QTDSAQ

Tipo

Numérico

Tamanho

2

Decimal

0

Formato

99

Título

Qtd. Saque  

Descrição

Qtd. Saque   

Usado

S

Obrigatório

N

Browse

S

Help

Quantidade de saque que será enviada a operadora de frota, paga pela transportadora, conforme legislação vigente, mínimo exigido por lei e 4.

Campo

DTR_QTDTRA

Tipo

Numerico

Tamanho

2

Decimal

0

Formato

99

Título

Qtd. Transfe

Descrição

Qtd. Transferência       

Usado

S

Obrigatório

N

Browse

S

Help

Quantidade de transferência que será enviada a operadora de frota, paga pela transportadora, conforme legislação vigente, mínimo exigido por lei e 4.

Campo

DTR_CODFAV

Tipo

Caractere

Tamanho

6

Decimal

0

Formato

@!

Título

Cod.Favorec

Descrição

Codigo do Favorecido

Usado

S

Obrigatório

N

Browse

S

Help

Código do Favorecido da Viagem que será o Recebedor dos Ti tulos a Pagar.

Campo

DTR_LOJFAV

Tipo

Caractere

Tamanho

2

Decimal

0

Formato

@!

Título

Loja.Favorec

Descrição

Loja do Favorecido

Usado

S

Obrigatório

N

Browse

S

Help

Código/Loja do Favorecido da Viagem que será o Recebedor dos Ti tulos a Pagar.

Campo

DTR_NOMFAV

Tipo

Caractere

Tamanho

40

Decimal

0

Formato

@!

Título

Favorecido

Descrição

Favorecido

Usado

S

Obrigatório

N

Browse

S

Help

Nome do Favorecido da Viagem

Nota!

O tamanho dos campos que possuem grupo pode variar conforme o ambiente em uso.


3.  Criação de Índices no arquivo SIX – Índices:

Índice

DLD

Ordem

1

Chave

DLD_FILIAL+DLD_FILORI+DLD_VIAGEM+DLD_ITEDTR+DLD_CODVEI+DLD_TIPPAR+DLD_RECEB+DLD_FORPAG 

Descrição

Filial+Fil.Origem+Viagem+It.Comp.Viag+Cod.Veiculo+Tipo Parcela+Recebedor+Forma Pagto

Proprietário

S


Procedimento para Utilização

Inclusão da Viagem

  1. Em Gestão de Transportes (SIGATMS), clique em Atualizações / Viagens.
  2. Selecione o Tipo de Viagem que será utilizado.
  3. Inclua uma viagem, informando uma rota existente na Pamcard.
  4. Clique na opção: Outras Ações / Comp.Via.
  5. Informe o Cod.Operad ( '02') - Pamcard.
  6. No campo Qtd.Saque (DTR_QTDSAQ), informe a quantidade de saque
  7. No campo Qtd.Transfe (DTR_QTDTRA), informe a quantidade de transferência.
  8. No campo Tp Pgt Pedag (DTR_TPSPDG), informe quem será o responsável pelo pagamento do pedágio.
  9. Informe um veículo para viagem, que exista na Pamcard.
  10. Clique em Outras Ações / Mot.Viag. 
  11. Informe os dados do motorista cadastrado na Pamcard, como proprietário do veículo informado, sem informar o campo Id.Motorista (DUP_IDOPE)
  12. Confirme os dados do motorista da viagem.
  13. Clique em Outras Ações / Formas de Pagto.
  14. Informe os dados da Forma de Pagamento da viagem
  15. No campo Forma Pagto (DLD_FORPAG), informe a forma de Pagamento (Cartão ou Deposito)
  16. No campo Tipo Parcela (DLD_TIPPAR), informe o tipo de Parcela (Adiantamento, Saldo Frete, Pedagio)
  17. No campo Recebedor (DLD_RECEB), informe o recebedor do frete (Proprietario ou Motorista)
  18. No campo Id.Motorista (DLD_IDOPE), informe o Id. do Motorista junto com a Operadora de Frotas
  19. O campo Cod/Loja Favorec (DLD_CODFAV e DLD_LOJAV) é preenchido automaticamente, quando o Recebedor do Frete (DLD_RECEB) é o Proprietário.
    O sistema primeiramente verifica o Fornecedor do Veiculo (DA3_CODFAV), caso não encontre, verifica o Favorecido do Proprietário do Veiculo (A2_CODFAV).
  20. Confirme a tela de formas de pagamento, complemento da viagem e a viagem.

Inclusão do Contrato na Pamcard

  1. Em Gestão de Transportes (SIGATMS), clique em Atualizações / Viagens.

  2. Selecione a viagem incluída e clique em Outras Ações / Fechamento / Fechar.

  3. Ao realizar o fechamento da viagem será incluído um Contrato na Pamcard considerando os recebedores de frete para envio dos favorecidos do Contrato e a viagem no SIGATMS será atualizada com o Id.da Operadora, no campo Id.Ope.Vge.
    Notas!
    1. Se o veículo utilizado na viagem for um veículo de terceiro, o campo CIOT também será atualizado na viagem. Contudo, se for um veículo próprio, este campo continuará em branco.
    2. Em caso de CIOT por período, o sistema incluíra uma viagem na Pamcard para pagamento do valor do pedágio, sendo considerada a parcela de pedágio da tabela de formas de pagamento para o envio do cartão.

Liberação Parcela de Adiantamento

  1. Em Gestão de Transportes (SIGATMS), clique em Atualizações / Viagens.

  2. Selecione a viagem incluída e clique em Outras Ações / Manutenção / Operações.

  3. Efetue o apontamento da operação de saída da viagem, informando a data e hora prevista e realizada.

  4. Ao apontar a operação de saída de viagem será liberada a parcela de adiantamento na Pamcard.

  5. Se houver estorno deste apontamento de saída da viagem, a parcela de adiantamento será bloqueada na Pamcard.

Pagamento de Saldo - Parâmetro MV_LIBCTC = .F.

  1. Em Gestão de Transportes (SIGATMS), clique em Atualizações / Terceiros / Contrato Carret.
  2. Clique na opção Por Viagem ou Por Período e informe os parâmetros com a viagem incluída para que seja gerado um novo Contrato de Carreteiro.
  3. Confirme os parâmetros e clique em OK.
  4. Após a geração do Contrato de Carreteiro, selecione o Contrato gerado e clique em Outras Ações / Pagamento de Saldo / Confirmar.
  5. Na tela do Pagamento de Saldo, clique em Salvar.
  6. A parcela do saldo do Contrato será enviada para a Pamcard, considerando o recebedor da parcela de saldo informado na tabela de Formas de Pagamento.
  7. Se este pagamento de saldo for estornado, a parcela será excluída na Pamcard.

Liberação do Contrato de Carreteiro - Parâmetro MV_LIBCTC = .T.

  1. Em Gestão de Transportes (SIGATMS), clique em Atualizações / Terceiros / Contrato Carret.
  2. Clique na opção Por Viagem ou Por Período, informe os parâmetros com a viagem incluída para que seja gerado um novo Contrato de Carreteiro.
  3. Confirme os parâmetros e clique em OK.
  4. Após a geração do Contrato de Carreteiro, clique em Atualizações / Terceiros / Lib. Contratos.
  5. Informe os parâmetros da rotina, para que seja apresentado o Contrato de Carreteiro gerado.
  6. Marque o Contrato a ser liberado e clique na opção Liberar.
  7. A parcela do saldo do Contrato Será enviada para a Pamcard, considerando o recebedor da parcela de saldo informado na tabela de Formas de Pagamento.
  8. Se esta liberação de Contrato de Carreteiro for  estornada, a parcela será excluída na Pamcard.