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

Brasil 

Características do Requisito

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 certificado.
4. Utilização do método FindRNTRC, para consultar o status do RNTRC no cadastro de fornecedores.
5. Certificado.
6. 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.
7. Utilização do parâmetro MV_TMSXML, para gravar as mensagens integradas entre o SIGATMS e o Pamcard, pelos arquivos .XMLUtilização do método Router, para calcular o valor do pedágio a partir da rota cadastrada na Pamcard.

Procedimento para Utilização

Cadastro do

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 do Pedágio

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 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 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.
   Nota!
   Observação: 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 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

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 campo Tipo CIOT, com a Incluir ou Alterar e no campo Tipo CIOT informe 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 Cod.Opera = '02') e informe um veículo do fornecedor que possua o 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 , 
7. Posicione sobre um dos contratos quitados, e acesse Outras Ações / Encerra CIOT.
8. Preencha os perguntes apresentados.
9. Marque o(s) CIOT(s) desejados e acesse Encerra CIOT.
10. Será enviada a mensagem para a Pamcard solicitando o encerramento do CIOT e caso a Pamcard consiga encerrá-lo o mesmo será encerrado no SIGATMS.

PAMCARD ALTERAÇÃO NO MODELO DE COMUNICAÇÃO - ICP 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:

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 de 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 do certificado.
4. Utilização do método FindRNTRC, para consultar o status do RNTRC no cadastro de fornecedores.
5. Utilização do método Router, para calcular o valor do pedágio a partir da rota cadastrada na Pamcard.

1. e da geração da viagem, efetue o fechamento da viagem.
2. Será gerado um número de CIOT para a viagem e veículo incluídos.
   Nota!
   Como o proprietário do veículo tem em seu Contrato de Fornecedor a opção de CIOT por período, ao gerar uma nova viagem para o mesmo veículo essa receberá o mesmo número do CIOT da viagem anterior.
3. Para simular este processo gere uma nova viagem e efetue os mesmos processos até o fechamento da nova viagem.
   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.
4. 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.
5. 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 gerados com o mesmo número do CIOT.
6. Após pagar o saldo ou liberar todos os Contratos com o mesmo número do CIOT, acesse Outras Ações / Encerra CIOT.
7. Informe os parâmetros solicitados.
8. Selecione os CIOT(s) necessário(s) e clique em Encerra CIOT.
9. 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, 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, clique em Cadastros / Parâmetros.
   
4. Clique em Pesquisar Image Added, informe: MV_TMSXML e selecione a opção Buscar.
5. Clique em Editar Image Added, informe o campo Cont.Por com .T. e clique em Salvar.
6. 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.
   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

Procedimento para Utilização

Cadastro do 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 o cadastro da Operadora Pamcard.
3. Preencha o campo Cod.Operad. com 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. 
   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 ou altere os outros campos necessários para cadastro da Operadora.
Confirme a inclusão ou alteração.
Consulta de um RNTRC no Cadastro de Fornecedor
8. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Cadastros / Fornecedores (MATA020) .
9. Inclua ou altere um fornecedor, onde na pasta TMS informe o número do RNTRC, através do campo RNTRC.
10. Após informar o RNTRC, acesse a opção: Outras Ações / Consulta RNTRC.
11. Informe o código da Operadora Pamcard: 02 e confirme.
Será atualizado o status e a data de vencimento do RNTRC.
Calculo do valor do Pedágio realizado pela Pamcard
12. Em Configurador (SIGACFG), acesse  Ambiente / Cadastros / Parâmetros.
13. Pesquise e configure o parâmetro MV_PAMROTA, com .T. .
14. Agora,  em Gestão de Transportes (SIGATMS), acesse Atualizações / Operadoras de Frota / Operadoras de Frota (TMSAE60).
15. Altere o cadastro da Operadora Pamcard (02) e altere o conteúdo do campo Calc.Pedagio com o caractere : "1".
16. Inclua uma viagem integrada com a Operadora de Frete: Pamcard (02) com uma rota existente na Pamcard.
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 Conta do Favorecido

17. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens.
18. Escolha o Tipo de Viagem que será utilizada.
19. Inclua uma viagem, informando uma rota existente na Pamcard.
20. Acesse a opção: Outras Ações / Comp.Via.
21. Informe o Cod.Operad ( '02') - Pamcard.
22. Informe um veículo para viagem, que exista na Pamcard.
23. Acesse Outras Ações / Mot.Viag. 
24. Informe os dados do motorista cadastrado na Pamcard, como proprietário do veículo informado.
25. No campo Meio Pg.Frt., informe a forma de pagamento do frete.
26. No campo Tp Pgt Pedag, informe quem será o responsável pelo pagamento do pedágio.
Confirme os dados do motorista da viagem.
Inclusão do contrato na Pamcard.
27. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens.
28. Selecione uma viagem que contenha o código da Operadora '02 - Pamcard'.
29. Acesse Outras Ações / Fechamento / Fechar.
Ao realizar o fechamento da viagem, será incluído um contrato na Pamcard e a viagem no SIGATMS será atualizada com o Id.da Operadora, através do campo Id.Ope.Vge.
Observação: 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 na Pamcard.

30. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens.
31. Selecione uma viagem que contenha o código da Operadora '02 - Pamcard'.
32. Acesse Outras Ações / Fechamento / Estornar.
Ao estornar o fechamento da viagem, o contrato será excluído na Pamcard e o conteúdo do campo: Id.Ope.Vge ficará em branco. 
Observação: 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 atualizado no fechamento da viagem.
Parcela de Adiantamento.
33. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens.
34. Escolha o Tipo de Viagem que será utilizada.
35. Inclua uma viagem, informando uma rota existente na Pamcard.
36. Acesse a opção: Outras Ações / Comp.Via.
37. Informe o Cod.Operad ( '02') - Pamcard.
38. Informe um veículo para viagem, que exista na Pamcard.
39. Acesse Outras Ações / Mot.Viag. 
40. Informe os dados do motorista cadastrado na Pamcard, como proprietário do veículo informado.
41. No campo Meio Pg.Frt., informe a forma de pagamento do frete.
42. No campo Tp Pgt Pedag, informe quem será o responsável pelo pagamento do pedágio.
43. Confirme os dados do motorista da viagem.
44. Acesse Outras Ações / Adiantam.Desp e inclua uma despesa que movimente banco.
45. Confirme o lançamento das despesas, complemento da viagem e a viagem.
46. Selecione a viagem incluída e acesse Outras Ações / Manutenção / Fechamento / Fechar.
47. Ao fechar a viagem, será gerado o contrato junto a Pamcard.
48. Acesse Outras Ações / Manutenção / Operações.
49. Efetua o apontamento da operação de saída da viagem, informando a data e hora prevista e realizada.
50. Ao apontar a operação de saída de viagem, será gerada uma parcela de adiantamento na Pamcard.
Caso 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.
51. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato Carret.
    
52. Acesse a opção Por Viagem ou Por Período, preencha os parâmetros com uma viagem integrada com a Pamcard para que seja gerado um novo Contrato de Carreteiro.
53. Confirme os parâmetros e posteriormente acesse a opção OK.
54. Após a geração do contrato de carreteiro, selecione o contrato gerado e acesse Outras Ações / Pagamento de Saldo / Confirmar.
55. Será apresentada a tela do pagamento de saldo, acesse a opção Salvar.
56. Será enviada a parcela do saldo do contrato para a Pamcard.
Caso este pagamento de saldo seja estornado, a parcela será excluída na Pamcard.
Liberação Contrato de Carreteiro - Parâmetro MV_LIBCTC = .T.

57. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato Carret.
    
58. Acesse a opção Por Viagem ou Por Período, preencha os parâmetros com uma viagem integrada com a Pamcard para que seja gerado um novo Contrato de Carreteiro.
59. Confirme os parâmetros e posteriormente acesse a opção OK.
60. Após a geração do contrato de carreteiro, acesse Atualizações / Terceiros / Lib.Contratos
61. Preencha os parâmetros da rotina, para que seja apresentado o contrato de carreteiro gerado.
62. Marque o contrato a ser liberado e acesse a opção Liberar.
63. Será enviada a parcela do saldo do contrato para a Pamcard.
Caso esta liberação de contrato de carreteiro seja estornada, a parcela será excluída na Pamcard.
Geração de CIOT por período
64. Em Gestão de Transportes (SIGATMS, acesse Atualizações / Terceiros / Contrato Fornec.
65. Acesse a opção Incluir ou Alterar para preencher o campo Tipo CIOT, com a opção: "2 - Por Período" e preencha também o campo Prazo CIOT, com  a quantidade de dias que o CIOT deverá ficar ativo.
66. Inclua uma viagem integrado com a Pamcard (campo, Cod.Opera = '02') e informe um veículo do fornecedor que possua o Tipo do CIOT por Período.
67. Ainda na viagem preencha os dados do cartão através da rotina "Motoristas da Viagem".
Apó
68. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato Carret.
    
69. Acesse a opção Por Viagem ou Por Período, preencha os parâmetros com uma viagem integrada com a Pamcard para que seja gerado um novo Contrato de Carreteiro.
70. Confirme os parâmetros e posteriormente acesse a opção OK.
71. Após a geração do contrato de carreteiro, acesse Atualizações / Terceiros / Lib.Contratos
72. Preencha os parâmetros da rotina, para que seja apresentado o contrato de carreteiro gerado.
73. Marque o contrato a ser liberado e acesse a opção Liberar.
74. Será enviada a parcela do saldo do contrato para a Pamcard.
Caso esta liberação de contrato de carreteiro seja estornada, a parcela será excluída na
75. Pamcard.