Histórico da Página
Pamcard - Alteração no Modelo de Comunicação - ICP
BRASILBrasil
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 Cadastro de operadoras 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 Cadastro do certificadoCertificado.
- 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, através de pelos arquivos .xmlXML.
Procedimento para Utilização
Cadastro do
novo modeloNovo Modelo de Certificado
Em Gestão de Transportes(SIGATMS), acesse Atualizações / Operadoras de Frota / Operadoras de Frota (TMSAE60).
Inclua ou
Alterealtere o
cadastroCadastro da Operadora Pamcard.
- Preencha o
No campo Cod.Operad.
com a, 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.
Observação:
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.
- Preencha
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
, ondee na
pastapasta TMS, campo RNTRC,informe o número
do RNTRC, atravésdo
campoRNTRC.
Após informar o RNTRC, acesse a opção
:Outras Ações / Consulta RNTRC.
Informe o código da Operadora Pamcard:"02" e confirme.
- Será atualizado o
O status e a data de vencimento do RNTRC serão atualizados.
Calculo
Cálculo do
valorValor do Pedágio
realizado pelaRealizado Pela Pamcard
Em Configurador (SIGACFG), acesse Ambiente / Cadastros / Parâmetros.
Pesquise e configure o parâmetro MV_PAMROTA, com .T. .
Agora,
em Gestãoem Gestão de Transportes (SIGATMS),acesse
Atualizaçõ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)
comcom 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 eFavorecido e Conta do Favorecido
- Em Gestão de Transportes (SIGATMS), acesse Atualizações acesse Atualizações / Viagens.
- Escolha Selecione o Tipo de Viagem que será utilizadautilizado.
- 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 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
contratoContrato 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 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
contratoContrato 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 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
.- 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 Contrato junto a Pamcard.
- Acesse Outras Ações / Manutenção / Operações.
- Efetua 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.
- 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.
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato Carret.
- 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.
- Confirme os parâmetros e posteriormente acesse a opção clique em OK.
- Após a geração do contrato Contrato de carreteiroCarreteiro, selecione o contrato Contrato gerado e acesse Outras Ações / Pagamento de Saldo / Confirmar.
- Será apresentada a Na tela do pagamento Pagamento de saldo, acesse a opção Saldo, clique em Salvar.
- Será enviada a parcela do saldo do contrato 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.
- 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.
- Confirme os parâmetros e posteriormente acesse a opção clique em OK.
- Após a geração do contrato Contrato de carreteiroCarreteiro, acesse Atualizações / Terceiros / Lib.Contratos.
- Preencha Informe os parâmetros da rotina, para que seja apresentado o contrato Contrato de carreteiro Carreteiro gerado.
- Marque Selecione o contrato Contrato a ser liberado e acesse a opção clique em Liberar.
- Será enviada a A parcela do saldo do contrato Contrato será enviada para a Pamcard.
- 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íodoPor Período
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato Fornec.
- 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 .
- No campo Prazo CIOT, com informe a quantidade de dias que o CIOT deverá ficar permanecer ativo.
- 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.
- Ainda na viagem preencha , informe os dados do cartão através da 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.
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. - 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. - 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 Contratos gerados com o mesmo número do CIOT.
- Após pagar o saldo ou liberar todos os contratos Contratos com o mesmo número do CIOT, acesse Outras Ações / Encerra CIOT.
- Preencha Informe os parâmetros apresentadossolicitados.
- Marque o Selecione os CIOT(s) , necessário(s) e acesse 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, acesse
- clique em Cadastros / Parâmetros.
- Clique em Pesquisar , digite
- informe: MV_TMSXML e selecione a opção Buscar. Acesse a opção
- Clique em Editar , preencha
- informe o campo Cont.Por com .T. e acesse a opção
- 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.