Á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 - 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 - 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 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. 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, pelos arquivos .XML.


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. No campo Cod.Operad., 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!
    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. 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 e na pasta TMS, campo RNTRC,informe o número do 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. O status e a data de vencimento do RNTRC serão atualizados.

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 de Transportes (SIGATMS),acesseAtualizaçõ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 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 / Viagens.
  2. Selecione o Tipo de Viagem que será utilizado.
  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.

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 na Pamcard e a viagem no SIGATMS será atualizada com o Id.da Operadora, no campo Id.Ope.Vge.
    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 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 será excluído na Pamcard e o campo Id.Ope.Vge permanecerá em branco.
    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 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
,
  1. que exista na Pamcard.
  2. Acesse Outras Ações / Mot.Viag. 
  3. Informe os dados do motorista cadastrado na Pamcard, como proprietário do veículo informado.
  4. No campo Meio Pg.Frt., informe a forma de pagamento do frete.
  5. No campo Tp Pgt Pedag, informe quem será o responsável pelo pagamento do pedágio.
  6. Confirme os dados do motorista da viagem.
  7. Acesse Outras Ações / Adiantam.Desp e inclua uma despesa que movimente banco.
  8. Confirme o lançamento das despesas, complemento da viagem e a viagem.
  9. Selecione a viagem incluída e acesse Outras Ações / Manutenção / Fechamento / Fechar.
  10. Ao fechar a viagem, será gerado o
contrato
  1. Contrato junto a Pamcard.
  2. Acesse Outras Ações / Manutenção / Operações.
Efetua
  1. Efetue o apontamento da operação de saída da viagem, informando a data e hora prevista e realizada.
  2. Ao apontar a operação de saída de viagem
,
  1. será gerada uma parcela de adiantamento na Pamcard.
Caso
  1. 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
  1. informe os parâmetros com uma viagem integrada com a Pamcard para que seja gerado um novo Contrato de Carreteiro.
  2. Confirme os parâmetros e
posteriormente acesse a opção 
  1. clique em OK.
  2. Após a geração do
contrato
  1. Contrato de
carreteiro
  1. Carreteiro, selecione o
contrato
  1. Contrato gerado e acesse Outras Ações / Pagamento de Saldo / Confirmar.
Será apresentada a
  1. Na tela do
pagamento
  1. Pagamento de
saldo, acesse a opção
  1. Saldo, clique em Salvar.
  2. Será enviada a parcela do saldo do
contrato
  1. Contrato para a Pamcard.
  2. 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.
Acesse
  1. Selecione a opção Por Viagem ou Por Período
,
  1. e 
preencha
  1. informe os parâmetros com uma viagem integrada com a Pamcard para que seja gerado um novo Contrato de Carreteiro.
  2. Confirme os parâmetros
e posteriormente acesse a opção 
  1. clique em OK.
  2. Após a geração do
contrato
  1. Contrato de
carreteiro
  1. Carreteiro, acesse Atualizações / Terceiros / Lib.Contratos.
Preencha
  1. Informe os parâmetros da rotina, para que seja apresentado o
contrato
  1. Contrato de
carreteiro
  1. Carreteiro gerado.
Marque
  1. Selecione o
contrato
  1. Contrato a ser liberado e
acesse a opção 
  1. clique em Liberar.
Será enviada a
  1. A parcela do saldo do
contrato
  1. Contrato será enviada  para a Pamcard.
  2. Caso esta liberação de
contrato
  1. Contrato de
carreteiro
  1. 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.
Acesse
  1. Selecione a opção Incluir ou Alterar 
para preencher o
  1. e no campo Tipo CIOT
,
  1. informe a 
com a
  1. opção: "2 - Por Período"
e preencha também o
  1. .
  2. No campo Prazo CIOT,
 com 
  1.  informe a quantidade de dias que o CIOT deverá
ficar
  1. permanecer ativo.
  2. Inclua uma viagem
integrado
  1. integrada com a Pamcard (campo, Cod.Opera = '02') e informe um veículo do fornecedor que possua o Tipo do CIOT por Período.
  2. Ainda na viagem
preencha
  1. , informe os dados do cartão
através da
  1. na rotina 
"
  1. Motoristas da Viagem
"
  1. .
  2. Após a confirmação dos motoristas da viagem e da geração da viagem, efetue o fechamento da viagem.
  3. Será gerado um número de CIOT para a viagem e veículo incluídos.
Obs.: 
  1. Nota!
    Como o proprietário do veículo tem em seu
contrato
  1. Contrato de
fornecedor
  1. Fornecedor a opção de CIOT por período, ao
gerarmos
  1. gerar uma nova viagem para o mesmo veículo
,
  1. essa
viagem
  1. receberá o mesmo número do CIOT da viagem anterior.
  2. Para simular este processo
,
  1. gere uma nova viagem e efetue os mesmos processos até o fechamento da nova viagem.
Obs.: 
  1. Nota!
    As novas viagens receberão o mesmo número de CIOT
,
  1. desde que o prazo do CIOT esteja vigente e que o CIOT não tenha sido encerrado manualmente.
  2. 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.
  3. 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
  1. Contratos gerados com o mesmo número do CIOT.
  2. Após pagar o saldo ou liberar todos os
contratos
  1. Contratos com o mesmo número do CIOT, acesse Outras Ações / Encerra CIOT.
Preencha
  1. Informe os parâmetros
apresentados
  1. solicitados.
Marque o
  1. Selecione os CIOT(s)
,
  1. necessário(s) e
acesse 
  1. clique em Encerra CIOT.
  2. 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, 
acesse 
  1. clique em Cadastros / Parâmetros.
Acesse a opção Pesquisar 
  1. Clique em Pesquisar Image Modified,
digite
  1. informeMV_TMSXML e selecione a opção Buscar.
Acesse a opção
  1. Clique em Editar Image Modified,
preencha
  1. informe o campo Cont.Por com .T. e
acesse a opção
  1. clique em Salvar.
  2. 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.
 

  1. Nota!
    Recomendamos
Obs.: Recomendamos
  1. 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.