Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
PAMCARD ALTERAÇÃO NO MODELO DE COMUNICAÇÃO

Pamcard - Alteração no Modelo de Comunicação - ICP

BRASIL

Brasil 

Características do Requisito

Linha de Produto:

Microsiga Protheus

®

Segmento:

Supply Chain - Logística

Módulo:

SIGATMS - Gestão de Transportes

Rotina:

TMSAE60 - Cadastro de Gerenciadores de Frota

TMSPamcard - Integração Pamcard

PamcardNew - Integração Pamcard ICP-Brasil

WsClient_TmsPamcardNew

.prw

- Client de Integração entre SIGATMS x Pamcard ICP - Brasil

Requisito:

DLOGTMS03-1958

País(es):

Brasil

Banco(s) de Dados:

Todos

Sistema(s) Operacional(is):

Windows

®

e Linux

®


Descrição

  1. Permitir a seleção de um arquivo .pfx no cadastro Cadastro de operadoras Operadoras e fazer com que este arquivo seja ‘quebrado’ em arquivos .pem.

  2. Permitir que os arquivos .crt continuem sendo utilizados na integração.

  3. Definição de qual o método de integração a partir do cadastro Cadastro do certificadoCertificado.
  4. Integração entre SIGATMS x Pamcard, das seguintes funcionalidades:
    1. Cálculo do valor do pedágio;.
    2. Inclusão de Contrato na Pamcard;.
    3. Geração de CIOT;.
    4. Apontamento de Saída da viagem - Liberação da parcela de Adiantamento;.
    5. Pagamento de Saldo e Liberação do Contrato de Carreteiro - Criação da parcela do saldo do frete.
    6. Geração do CIOT por período;.
    7. Encerramento do CIOT.
  5. Utilização do parâmetro MV_TMSXML, para gravar as mensagens integradas entre o SIGATMS e o Pamcard, através de pelos arquivos .xmlXML.


Procedimento para Utilização

Cadastro do

novo modelo

Novo Modelo de Certificado

  1. Em Gestão de Transportes(SIGATMS), acesse Atualizações / Operadoras de Frota / Operadoras de Frota (TMSAE60).

  2. Inclua ou

    Altere

    altere o

    cadastro

    Cadastro da Operadora Pamcard.

  3. Preencha o

    No campo Cod.Operad.

     com a

    , informe a opção "02".

  4. No campo Certif.Dif., informe um certificado com a extensão .pfx.

  5. No campo Cod.Acesso, informe a senha do certificado com a extensão .pfx.

  6. No campo URL WS, informe o endereço da URL da Pamcard.

     


    Nota!

    Observação:

    Vale ressaltar que a URL utilizada para o certificado .pfx é diferente da URL utilizada para o certificado .crt.
    Para obter o endereço correto

    ,

    é necessário entrar em contato com a Pamcard.

  7. Preencha

    Informe ou altere os outros campos necessários para o cadastro da Operadora.

  8. Confirme a inclusão ou alteração.

Consulta de um RNTRC no Cadastro de Fornecedor

  1. Em Gestão de Transportes (SIGATMS), acesseAtualizações / Cadastros / Fornecedores (MATA020) .

  2. Inclua ou altere um fornecedor

    , onde

    e na

    pasta

    pasta TMS, campo RNTRC,informe o número

    do RNTRC, através

    do

    campo

    RNTRC.

  3. Após informar o RNTRC, acesse a opção

    :

    Outras Ações / Consulta RNTRC.

  4. Informe o código da Operadora Pamcard:"02" e confirme.

  5. Será atualizado o

    O status e a data de vencimento do RNTRC serão atualizados.

    Calculo

Cálculo do

valor

Valor do Pedágio

realizado pela

Realizado Pela Pamcard

  1. Em Configurador (SIGACFG), acesse Ambiente / Cadastros / Parâmetros.

  2. Pesquise e configure o parâmetro MV_PAMROTA, com .T. .

  3. Agora, 

    em Gestão

    em Gestão de Transportes (SIGATMS),acesse

     

    Atualizações / Operadoras de Frota / Operadoras de Frota (TMSAE60).

  4. Altere o cadastro da Operadora Pamcard (02) e altere o conteúdo do campo Calc.Pedagio com o caractere : "1".

  5. Inclua uma viagem integrada com a Operadora de Frete: Pamcard (02)

     com

     com uma rota existente na Pamcard.

  6. Ao confirmar o complemento da viagem

    ,

    será realizado o cálculo do pedágio e o campo

    :

    Pedágio será atualizado automaticamente.

Validação do Cartão,

 Favorecido e

 Favorecido e Conta do Favorecido

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações acesse Atualizações / Viagens.
  2. Escolha Selecione o Tipo de Viagem que será utilizadautilizado.
  3. Inclua uma viagem, informando uma rota existente na Pamcard.
  4. Acesse a opção : Outras Ações / Comp.Via.
  5. Informe o Cod.Operad ('02') - Pamcard.
  6. Informe um veículo para viagem, que exista na Pamcard.
  7. Acesse Outras Ações / Mot.Viag. 
  8. Informe os dados do motorista cadastrado na Pamcard, como proprietário do veículo informado.
  9. No campo Meio campo Meio Pg.Frt., informe a forma de pagamento do frete.
  10. No campo Tp Pgt Pedag, informe quem será o responsável pelo pagamento do pedágio.
  11. Confirme os dados do motorista da viagem.

Inclusão do

contrato

Contrato na Pamcard

.

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens.
  2. Selecione uma viagem que contenha o código da Operadora '02 - Pamcard'.
  3. Acesse Outras Ações / Fechamento / Fechar.
  4. Ao realizar o fechamento da viagem , será incluído um contrato Contrato na Pamcard e a viagem no SIGATMS será atualizada com o Id.da Operadora, através do no campo Id.Ope.Vge.
    Observação: Nota!
    Se o veículo utilizado na viagem for um veículo de terceiro, o campo CIOT também será atualizado na viagem. Porém, se for um veículo próprio, este campo continuará em branco.

Exclusão do

contrato

Contrato na Pamcard

.

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens.
  2. Selecione uma viagem que contenha o código da Operadora '02 - Pamcard'.
  3. Acesse Outras Ações / Fechamento / Estornar.
  4. Ao estornar o fechamento da viagem, o contrato Contrato será excluído na Pamcard e o conteúdo do campo: Id.Ope.Vge ficará permanecerá em branco. 
    Observação: Se
    Nota!
    Se o veículo utilizado na viagem for um veículo de terceiro, o campo CIOT também será atualizado com o conteúdo em branco. Porém, se for um veículo próprio, este campo não será atualizado, pois o mesmo não fora foi atualizado no fechamento da viagem.

Parcela de Adiantamento

.

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens.
  2. Escolha o Tipo de Viagem que será utilizada.
  3. Inclua uma viagem, informando uma rota existente na Pamcard.
  4. Acesse a opção: Outras Ações / Comp.Via.
  5. Informe o Cod.Operad ( '02') - Pamcard.
  6. Informe um veículo para viagem , que exista na Pamcard.
  7. Acesse Outras Ações / Mot.Viag. 
  8. Informe os dados do motorista cadastrado na Pamcard, como proprietário do veículo informado.
  9. No campo Meio Pg.Frt., informe a forma de pagamento do frete.
  10. No campo Tp Pgt Pedag, informe quem será o responsável pelo pagamento do pedágio.
  11. Confirme os dados do motorista da viagem.
  12. Acesse Outras Ações / Adiantam.Desp e inclua uma despesa que movimente banco.
  13. Confirme o lançamento das despesas, complemento da viagem e a viagem.
  14. Selecione a viagem incluída e acesse Outras Ações / Manutenção / Fechamento / Fechar.
  15. Ao fechar a viagem, será gerado o contrato Contrato junto a Pamcard.
  16. Acesse Outras Ações / Manutenção / Operações.
  17. Efetua Efetue o apontamento da operação de saída da viagem, informando a data e hora prevista e realizada.
  18. Ao apontar a operação de saída de viagem , será gerada uma parcela de adiantamento na Pamcard.
  19. Caso 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), acesse Atualizações / Terceiros / Contrato Carret.
  2. Acesse a opção Por Viagem ou Por Período, preencha informe os parâmetros com uma viagem integrada com a Pamcard para que seja gerado um novo Contrato de Carreteiro.
  3. Confirme os parâmetros e posteriormente acesse a opção clique em OK.
  4. Após a geração do contrato Contrato de carreteiroCarreteiro, selecione o contrato Contrato gerado e acesse Outras Ações / Pagamento de Saldo / Confirmar.
  5. Será apresentada a Na tela do pagamento Pagamento de saldo, acesse a opção Saldo, clique em Salvar.
  6. Será enviada a parcela do saldo do contrato Contrato para a Pamcard.
  7. Caso este pagamento de saldo seja estornado, a parcela será excluída na Pamcard.

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

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato Carret.
  2. Acesse Selecione a opção Por Viagem ou Por Período ,e preencha informe os parâmetros com uma viagem integrada com a Pamcard para que seja gerado um novo Contrato de Carreteiro.
  3. Confirme os parâmetros e posteriormente acesse a opção clique em OK.
  4. Após a geração do contrato Contrato de carreteiroCarreteiro, acesse Atualizações / Terceiros / Lib.Contratos.
  5. Preencha Informe os parâmetros da rotina, para que seja apresentado o contrato Contrato de carreteiro Carreteiro gerado.
  6. Marque Selecione o contrato Contrato a ser liberado e acesse a opção clique em Liberar.
  7. Será enviada a A parcela do saldo do contrato Contrato será enviada  para a Pamcard.
  8. Caso esta liberação de contrato Contrato de carreteiro Carreteiro seja estornada, a parcela será excluída na Pamcard.

Geração de CIOT

por período

Por Período

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato Fornec.
  2. Acesse Selecione a opção Incluir ou Alterar para preencher o e no campo Tipo CIOT ,informe a com a opção: "2 - Por Período" e preencha também o .
  3. No campo Prazo CIOT, com   informe a quantidade de dias que o CIOT deverá ficar permanecer ativo.
  4. Inclua uma viagem integrado integrada com a Pamcard (campo, Cod.Opera = '02') e informe um veículo do fornecedor que possua o Tipo do CIOT por Período.
  5. Ainda na viagem preencha , informe os dados do cartão através da na rotina "Motoristas da Viagem".
  6. Após a confirmação dos motoristas da viagem e da geração da viagem, efetue o fechamento da viagem.
  7. Será gerado um número de CIOT para a viagem e veículo incluídos.
    Obs.: 
    Nota!
    Como o proprietário do veículo tem em seu contrato Contrato de fornecedor Fornecedor a opção de CIOT por período, ao gerarmos gerar uma nova viagem para o mesmo veículo , essa viagem receberá o mesmo número do CIOT da viagem anterior.
  8. Para simular este processo , gere uma nova viagem e efetue os mesmos processos até o fechamento da nova viagem.
    Obs.: 
    Nota!
    As novas viagens receberão o mesmo número de CIOT , desde que o prazo do CIOT esteja vigente e que o CIOT não tenha sido encerrado manualmente.
  9. Após gerar uma nova viagem para o mesmo veículo e efetuar o fechamento da mesma, esta viagem receberá o mesmo número do CIOT da viagem anterior.
  10. Como comentado anteriormente, o encerramento deste CIOT pode ser realizado manualmente, para isso é necessário efetuar o pagamento de saldo ou efetuar a liberação, de todos os contratos Contratos gerados com o mesmo número do CIOT.
  11. Após pagar o saldo ou liberar todos os contratos Contratos com o mesmo número do CIOT, acesse Outras Ações / Encerra CIOT.
  12. Preencha Informe os parâmetros apresentadossolicitados.
  13. Marque o Selecione os CIOT(s) , necessário(s) e acesse clique em Encerra CIOT.
  14. Será solicitado o encerramento deste CIOT, junto a Pamcard e, em caso deste encerramento ser realizado na Pamcard, o mesmo será encerrado no SIGATMS.

Gravação de XML das

mensagens integradas

Mensagens Integradas,

parâmetro

Parâmetro: MV_TMSXML.

  1. A partir desta atualização será possível gravar os arquivos .xml que são trafegados entre o SIGATMS e o Pamcard.
  2. Para isto, é necessário configurar o parâmetro MV_TMSXML com a opção .T.
  3. Em Configurador, 
  4. acesse 
  5. clique em Cadastros / Parâmetros.
  6. Acesse a opção Pesquisar 
  7. Clique em Pesquisar Image Modified,
  8. digite
  9. informeMV_TMSXML e selecione a opção Buscar.
  10. Acesse a opção
  11. Clique em Editar Image Modified,
  12. preencha
  13. informe o campo Cont.Por com .T. e
  14. acesse a opção
  15. clique em Salvar.
  16. Ao gerar uma nova viagem integrada com a Pamcard, todas as mensagens integradas serão gravadas na pasta do StartPath indicada no
appserver
  1. Appserver do ambiente Microsiga
Protheus®
  1. Protheus.
 Obs.: Recomendamos

  1. Nota!
    Recomendamos que este parâmetro seja habilitado apenas quando houver necessidade de identificar possíveis divergências nos dados enviados pelo SIGATMS com os dados recebidos pela Pamcard.