Histórico da Página
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
Permitir a seleção de um arquivo .pfx no Cadastro de Operadoras e fazer com que este arquivo seja ‘quebrado’ em arquivos .pem.
Permitir que os arquivos .crt continuem sendo utilizados na integração.
- Definição de qual o método de integração a partir do Cadastro do Certificado.
- Integração entre SIGATMS x Pamcard, das seguintes funcionalidades:
- Cálculo do valor do pedágio.
- Inclusão de Contrato na Pamcard.
- Geração de CIOT.
- Apontamento de Saída da viagem - Liberação da parcela de Adiantamento.
- Pagamento de Saldo e Liberação do Contrato de Carreteiro - Criação da parcela do saldo do frete.
- Geração do CIOT por período.
- Encerramento do CIOT.
- 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
Em Gestão de Transportes(SIGATMS), acesse Atualizações / Operadoras de Frota / Operadoras de Frota (TMSAE60).
Inclua ou altere o Cadastro da Operadora Pamcard.
No campo Cod.Operad., informe a opção "02".
No campo Certif.Dif., informe um certificado com a extensão .pfx.
No campo Cod.Acesso, informe a senha do certificado com a extensão .pfx.
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.Informe ou altere os outros campos necessários para o cadastro da Operadora.
Confirme a inclusão ou alteração.
Consulta de um RNTRC no Cadastro de Fornecedor
Em Gestão de Transportes (SIGATMS), acesseAtualizações / Cadastros / Fornecedores (MATA020) .
Inclua ou altere um fornecedor e na pasta TMS, campo RNTRC,informe o número do RNTRC.
Após informar o RNTRC, acesse a opção Outras Ações / Consulta RNTRC.
Informe o código da Operadora Pamcard: "02" e confirme.
O status e a data de vencimento do RNTRC serão atualizados.
Cálculo do Valor do Pedágio Realizado Pela Pamcard
Em Configurador (SIGACFG), acesse Ambiente / Cadastros / Parâmetros.
Pesquise e configure o parâmetro MV_PAMROTA, com .T. .
Agora, em Gestão de Transportes (SIGATMS),acesseAtualizações / Operadoras de Frota / Operadoras de Frota (TMSAE60).
Altere o cadastro da Operadora Pamcard (02) e altere o conteúdo do campo Calc.Pedagio com o caractere : "1".
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
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens.
- Selecione o Tipo de Viagem que será utilizado.
- Inclua uma viagem, informando uma rota existente na Pamcard.
- Acesse a opção Outras Ações / Comp.Via.
- Informe o Cod.Operad ('02') - Pamcard.
- Informe um veículo para viagem, que exista na Pamcard.
- Acesse Outras Ações / Mot.Viag.
- Informe os dados do motorista cadastrado na Pamcard, como proprietário do veículo informado.
- No campo Meio Pg.Frt., informe a forma de pagamento do frete.
- 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
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens.
- Selecione uma viagem que contenha o código da Operadora '02 - Pamcard'.
- 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, 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
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens.
- Selecione uma viagem que contenha o código da Operadora '02 - Pamcard'.
- Acesse Outras Ações / Fechamento / Estornar.
- 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
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens.
- Escolha o Tipo de Viagem que será utilizada.
- Inclua uma viagem, informando uma rota existente na Pamcard.
- Acesse a opção: Outras Ações / Comp.Via.
- Informe o Cod.Operad ( '02') - Pamcard.
- Informe um veículo para viagem
- que exista na Pamcard.
- Acesse Outras Ações / Mot.Viag.
- Informe os dados do motorista cadastrado na Pamcard, como proprietário do veículo informado.
- No campo Meio Pg.Frt., informe a forma de pagamento do frete.
- No campo Tp Pgt Pedag, informe quem será o responsável pelo pagamento do pedágio.
- Confirme os dados do motorista da viagem.
- Acesse Outras Ações / Adiantam.Desp e inclua uma despesa que movimente banco.
- Confirme o lançamento das despesas, complemento da viagem e a viagem.
- Selecione a viagem incluída e acesse Outras Ações / Manutenção / Fechamento / Fechar.
- Ao fechar a viagem, será gerado o
- Contrato junto a Pamcard.
- Acesse Outras Ações / Manutenção / Operações.
- Efetue o apontamento da operação de saída da viagem, informando a data e hora prevista e realizada.
- Ao apontar a operação de saída de viagem
- será gerada uma parcela de adiantamento na Pamcard.
- 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.
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato Carret.
- Acesse a opção Por Viagem ou Por Período,
- informe os parâmetros com uma viagem integrada com a Pamcard para que seja gerado um novo Contrato de Carreteiro.
- Confirme os parâmetros e
- clique em OK.
- Após a geração do
- Contrato de
- Carreteiro, selecione o
- Contrato gerado e acesse Outras Ações / Pagamento de Saldo / Confirmar.
- Na tela do
- Pagamento de
- Saldo, clique em Salvar.
- 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.
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato Carret.
- Selecione a opção Por Viagem ou Por Período
- e
- informe os parâmetros com uma viagem integrada com a Pamcard para que seja gerado um novo Contrato de Carreteiro.
- Confirme os parâmetros
- clique em OK.
- Após a geração do
- Contrato de
- Carreteiro, acesse Atualizações / Terceiros / Lib.Contratos.
- Informe os parâmetros da rotina, para que seja apresentado o
- Contrato de
- Carreteiro gerado.
- Selecione o
- Contrato a ser liberado e
- clique em Liberar.
- A parcela do saldo do
- Contrato será enviada 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íodoPor Período
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato Fornec.
- Selecione a opção Incluir ou Alterar
- e no campo Tipo CIOT
- informe a
- opção: "2 - Por Período"
- .
- No campo Prazo CIOT,
- informe a quantidade de dias que o CIOT deverá
- permanecer ativo.
- Inclua uma viagem
- integrada com a Pamcard (campo, Cod.Opera = '02') e informe um veículo do fornecedor que possua o Tipo do CIOT por Período.
- Ainda na viagem
- , informe os dados do cartão
- na rotina
- Motoristas da Viagem
- .
- Após a confirmação dos motoristas da viagem e da geração da viagem, efetue o fechamento da viagem.
- 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.
- 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.
- 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.
- 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.
- Após pagar o saldo ou liberar todos os
- Contratos com o mesmo número do CIOT, acesse Outras Ações / Encerra CIOT.
- Informe os parâmetros
- solicitados.
- Selecione os CIOT(s)
- necessário(s) e
- clique em Encerra CIOT.
- 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 integradasMensagens Integradas,
parâmetroParâmetro: MV_TMSXML.
- A partir desta atualização será possível gravar os arquivos .xml que são trafegados entre o SIGATMS e o Pamcard.
- Para isto, é necessário configurar o parâmetro MV_TMSXML com a opção .T.
- Em Configurador,
- clique em Cadastros / Parâmetros.
- Clique em Pesquisar ,
- informe: MV_TMSXML e selecione a opção Buscar.
- Clique em Editar ,
- informe o campo Cont.Por com .T. e
- clique em Salvar.
- 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 Pamcard.