CONTEÚDO

01. PRÉ-REQUISITOS

1. Configure o parâmetro MV_TMSPBLG com conteúdo .T. para habilitar a gravação de Logs durante o processo de Integração, ou .F. para não permitir a gravação de Logs durante o processo. 
2. Configure o parâmetro MV_TMSOPDG com conteúdo 2.

Fluxo completo da troca de informações TMS x PagBem

02. CADASTRO DE OPERADORA 

Realize o relacionamento do cadastro da Operadora PagBem. O objetivo deste cadastro é a combinação de dados da configuração de comunicação entre os sistemas, bem como a configuração de processos.

1. Acesse Atualizações -> Operadora de Frota -> Operadora de Frota (TMSAE60) e clique no botão INCLUIR ou ALTERAR.
2. Acesse a aba Cadastrais. Estes dados serão fornecidos pela própria PagBem. São eles:
   
   1. Informe o campo Id. Operad. (DEG_IDOPE) de acordo com informações da PagBem.

1. Acesse a aba Comunicação Api. Estes dados serão fornecidos pela própria PagBem. São eles:
   1. Informe o campo Nome Usuário (DEG_USER) de acordo com informações da PagBem.
   2. Informe o campo Senha (DEG_SENHA) de acordo com informações da PagBem.
   3. Informe o campo URL WS (DEG_URLWS) de acordo com informações da PagBem.
   4. Informe o campo Contr. Pdg. PB (DEG_CONPDG) de acordo com o as configurações da PagBem, se vai ou não utilizar a geração de contrato avulso de pedágio.
       

1. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
2. Confirme a inclusão/alteração dos dados.
   
3. Retorne na tela inicial da rotina, e acesse Outras Ações → Teste Comunicação PagBem  para validar os dados de conexão junto a operadora PagBem.
   
          
          Nova opção Teste Comunicação PagBem
    
        
         Exemplo Teste de Comunicação PagBem

03. CADASTRO DO FORNECEDOR

O cadastro do fornecedor Protheus é utilizado para criação e atualização dos prestadores na plataforma PagBem. Os campos abaixo são obrigatórios para a troca de informações durante a integração TMS x PagBem. São eles:

1. Acesse a rotina Atualizações -> Cadastro -> Fornecedores (MATA020), e clique no botão INCLUIR  ou ALTERAR. Preencher todos os campos abaixo:

2. Razão Social(A2_NOME) utilizado para relacionar o nome do prestador no portal PagBem.
3. Fantasia(A2_NREDUZ).
4. País (A2_PAIS).
5. Endereço(A2_END).
6. Bairro (A2_BAIRRO) .
7. Complemento(A2_COMPLEM).
8. CEP(A2_CEP) .
9. Data Nasc. (A2_DTNASC) .
10. Tipo (A2_TIPO) - O tipo do Fornecedor irá influenciar no cálculo de impostos.
11. CPF/CNPJ (A2_CGC) - Preencha o CPF/CNPJ dos prestadores
12. DDD (A2_DDD). 
13. Telefone (A2_TEL) - Caso preenchido número  fixo ou móvel, será cadastrado/atualizado na plataforma PagBem. 
14. Email (A2_EMAIL).
15. Aba TMS → Cód. INSS (A2_CODINSS) .
16. RG/Ced.Estr.(A2_PFISICA) .
17. Ins. Estad.  (A2_INSCR) .
18. Ins. Municip (A2_INSCRM) .
19. Opt Simp Nac (A2_SIMPNAC) .
20. RG/Ced.Estr.(A2_PFISICA) .
21. Aba TMS → RNTRC (A2_RNTRC) do prestador.
22. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
23. Confirme a inclusão/atualização cadastral.
24. Retorne na tela principal da rotina e acesse a opção Outras Ações  → Dados x Operad. para cadastrar/atualizar os dados no sistema PagBem Frete.
    
    
    
    
    Telas de exemplo de preenchimento de um fornecedor PagBem 
    
    
    

04. CADASTRO DO VEÍCULO

Realize a associação dos veículos para os prestadores em questão. Os campos abaixo são obrigatórios para a troca de informações durante a integração  TMS x PagBem.

São eles:

1. Acesse a rotina Atualizações -> Transporte -> Veículos (OMSA060) e clique no botão INCLUIR  ou ALTERAR. Preencher todos os campos abaixo.
2. Preencha o campo Placa (DA3_PLACA).
3. Preencha o campo Descrição (DA3_DESC).
4. Preencha o campo Tipo de Veículo (DA3_TIPVEI).
5. Preencha o campo Código/Loja Fornecedor (DA3_CODFOR/DA3_LOJFOR).
6. Preencha o campo Qtde. Eixos (DA3_QTDEIX).
7. Preencha o campo Marca (DA3_MARVEI).
8. Preencha o campo Cor (DA3_CORVEI).
9. Preencha o campo Ano Fabric. (DA3_ANOFAB).
10. Preencha o campo Ano Modelo (DA3_ANOMOD).
11. Preencha o campo Tipo Veiculo (DA3_TIPVEI).
12. Preencha o campo Cd.Municipio (DA3_CODMUN).
13. Preencha o campo Estado Placa (DA3_ESTPLA).
14. Preencha o campo Cod. Renavam (DA3_RENAVA).
15. Preencha o campo Chassi (DA3_CHASSI).
16. Preencha o campo Eixo/Rodagem (DA3_RODAGE).
17. Preencha o campo Integra Ope? (DA3_INTOPE).
18. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
19. Confirme a inclusão/atualização cadastral.
    
20. Retorne na tela principal da rotina e acesse a opção Outras Ações  → Dados x Operad. para atualizar os dados no sistema PagBem Frete.
    
    

 Exemplo de preenchimento de um veículo PagBem 

05. CADASTRO DO MOTORISTAS

Realize a associação dos motoristas para os prestadores em questão. Os campos abaixo são obrigatórios para a troca de informações durante a integração  TMS x PagBem. São eles: 

1. Acesse a rotina Atualizações -> Transporte -> Motoristas (OMSA040) e clique no botão INCLUIR  ou ALTERAR. Preencher todos os campos abaixo
2. Preencha o campo Nome (DA4_NOME).
3. Preencha o campo CNPJ/CPF (DA4_CGC ).
4. Preencha o campo No. CNH (DA4_NUMCNH).
5. Preencha o campo País (DA4_PAIS).
6. Preencha o campo Bairro (DA4_BAIRRO).
7. Preencha o campo Endereço (DA4_END).
8. Preencha o campo Telefone (DA4_TEL).
9. Preencha o campo Data Nascimento (DA4_DATNAS).
10. Preencha o campo Mãe (DA4_MAE).
11. Preencha o campo Estado (DA4_EST).
12. Preencha o campo CEP (DA4_CEP).
13. Preencha o campo Cd.Municipio (DA4_CODMUN).
14. Preencha o campo Municipio (DA4_MUN).
15. Preencha o campo DDD (DA4_DDD).
16. Preencha o campo RG (DA4_RG).
17. Preencha o campo Estado RG (DA4_RGEST).
18. Preencha o campo Cat.CNH (DA4_CATCNH).
19. Preencha o campo No.CNH (DA4_NUMCNH).
20. Preencha o campo Dt.Venct.CNH (DA4_DTVCNH).
21. Na aba Motorista x Operadora de Frota, preencha o campo Cod.Operad.(DEL_CODOPE) =03 - PagBem.
22. Na aba Motorista x Operadora de Frota, preencha o campo Id.Motorista (DEL_IDOPE) com o número do cartão PagBem a ser pago junto ao motorista.
23. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
24. Confirme a inclusão/atualização cadastral.
25. Retorne na tela principal da rotina e acesse a opção Outras Ações  → Dados x Operad. para atualizar os dados no sistema PagBem Frete.
    
    

       Telas de exemplo de preenchimento de um motorista PagBem

06. REGRA DE QUITAÇÃO DE FRETE PAGBEM

Para realizar a quitação do frete o Sistema PagBem necessita de algumas informações durante a integração TMS x PagBem, por este motivo criamos o cadastro de Regra de Quitação de Frete PagBem.

A partir deste cadastro o Sistema TMS Protheus envia informações dos dados abaixo:

1. Acesse a rotina Atualizações → Operadora de Frotas → Regras Quitação PagBem (TMSAC28) e clique no Botão INCLUIR ou ALTERAR. Preencher todos os campos abaixo.
   1. Exemplo de utilização do campo Operac. Frota no contrato do Fornecedor
2. Confirme a inclusão/atualização cadastral.

07. CONTRATO DO FORNECEDOR

Para a troca de informações durante a integração TMS x PagBem, o sistema busca informações dos dados abaixo:

1. Acesse a rotina Atualizações -> Terceiros -> Contrato Fornecedores (TMSA800) e clique no botão INCLUIR  ou ALTERAR. Preencher todos os campos abaixo
2. No item do Contrato, preencha o campo Cod. Regra (DVG_CODREG) pressione F3 do teclado ou clique no ícone da lupa. O sistema consultará as informações previamente cadastradas na rotina Regras (TMSAE60).
   
   Exemplo de utilização do campo Cod. Regra no contrato do Fornecedor
   
   
3. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
4. Confirme a inclusão/atualização cadastral.
   
   

08. CADASTRO DE ROTA

O cadastro de Rotas é utilizado para associar uma Rota do TMS à um Roteiro do sistema PagBem.

Cada rota no SIGATMS é amarrada a um roteiro/percurso da PagBem.

Para a troca de informações entre os sistemas, torna-se imprescindível realizar os passos abaixo:

1. Acesse a rotina Atualizações -> Logística -> Rotas  (OMSA100), e clique no botão INCLUIR  ou ALTERAR. Preencher todos os campos abaixo:
2. Acesse a aba Rota X Operadoras de Frota (DEK).
3. Preencha o campo Cod.Operad. (DEK_CODOPE) com o conteúdo 03 - PagBem.

4. No campo Frota (DEK_FROVEI), selecione a opção desejada.
   

5. Os campos Cód. Roteiro (DEK_ROTEIR) e Cód. Perc. (DEK_CODPER) pressione F3 do teclado ou clique no ícone da lupa. O sistema abrirá a tela Consulta Roteiro.

Exemplo de consulta do Roteiro PagBem

1. Consulta Roteiro.
   1. Para situações onde o Roteiro PagBem não existir, a funcionalidade para a solicitação de Roteiro na plataforma PagBem pode ser acionada nesta mesma tela, através do botão Outras Ações → Incluir Roteiro
   2. Para inclusão de um novo Roteiro, é preciso que os campos campos UF, ORIGEM e os campos UF,DESTINO com as cidades de Origem e Destino estejam preenchidos.
      
   3. Confira os dados na tela de Inclusão do Roteiro e clique no botão Salvar.

Exemplo de campos preenchidos na tela de Inclusão do Roteiro

1. Confirme a inclusão/atualização cadastral da Rota TMS.

2. Após a confirmação do cadastro da Rota, verifique se o Roteiro foi efetivado pela operadora PagBem.

3. Caso tenha sido efetivado pela operadora, altere a rota criada e realize novamente as ações da aba Rota x Operadora, conforme detalhes desta orientação para confirmar o relacionamento do Roteiro PagBem com a Rota TMS.

09. CRIAÇÃO DE VIAGEM PAGBEM (VIAGEM MOD. 3)

A emissão do Contrato PagBem será enviado somente no Fechamento de uma viagem de entrega/transporte Viagem Mod. 3 previamente criada e relacionada com dados PagBem (Operadora de Frota, Veículos e Motoristas). 

Fluxograma da troca de informações TMS x PagBem durante os processos de viagem 

Para criar uma viagem integrada junto a Plataforma PagBem Frete, realize os passos abaixo:

1. Acesse a rotina Atualizações → Viagens→ Viagem Mod. 3→ Viagem Mod. 3 (TMSAF60) e clique no botão INCLUIR.
2. Na aba Principal da tela de inclusão de ambas rotinas, preencha o campo Rota* (DTQ_ROTA) com uma Rota vinculada a um Roteiro PagBem.
   
3. Recursos (Viagem Mod. 3).
4. Nesta opção, a viagem receberá os demais dados que serão integrados junto a PagBem, como: Operadora de Frota, Veículo, Motorista, Valor de Frete, Valor de Pedágio, Valor de Adiantamento de Frete
   .
   
   1. Operadora de Frota
      Acesse a opção na aba Recursos para Viagem Mod. 3 , acesse a aba Operadoras e informe no campo Cod. Operad. (DTR_CODOPE/DM5_CODOPE), a operadora de frota 03-PagBem.
      
      
   2. Veículo
      No item das rotinas em questão, vincule o veículo previamente cadastrado e integrado com a PagBem através do campo Cod.Veiculo (DTR_CODVEI). 
      
      
   3. Motorista
      Informe um motorista PagBem previamente integrado para a viagem na aba Motoristas (Viagem Mod. 3). Também deverá ser preenchido o campo Cartão do motorista através do campo Id.Motorista (DUP_IDOPE).
      
      
   4. Valor de Pedágio
      Depois de informado o Código da Operadora, ao informar o veículo da viagem, será acionado o método "GetToll" para o cálculo automático do Pedágio referente à rota selecionada na viagem. Caso o cálculo do pedágio seja efetuado com sucesso pela PagBem, será atualizado o campo Pedágio (DTR_VALPDG).
      
      
   5. Valor de Frete
      Preencha um valor de frete a pagar de frete através do campo Frete (DTR_VALFRE).
      
      
   6. Valor de Adiantamento de Frete
      Para lançar um valor de adiantamento de Frete, acesse a aba Despesas (Viagem Mod. 3) e realize o lançamento de uma despesa do tipo Movimenta Banco (DT7_MOVBCO =1).

   1. 
      Exemplos de preenchimento:
      
      Viagem Modelo 3 
      
      Exemplo de preenchimento dos dados na aba Recursos (Viagem Mod. 3)
      
      

   
   

5. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
6. Confirme a inclusão/alteração dos dados.

10. FECHAMENTO DE VIAGEM 

Através do Fechamento da Viagem que ocorrerá a emissão do contrato na PagBem. A emissão do Contrato PagBem é o inicio do controle de um processo quando se utiliza  frota de terceiros.

EMISSÃO DO CONTRATO PAGBEM
No SIGATMS, a emissão do contrato na PagBem será processada no Fechamento da viagem, em que será acionado automaticamente o método Emissão de Contrato/Viagem.

Fluxo da troca de informações entre o SIGATMS x PagBem para emissão do Contrato PagBem






Para realizar o Fechamento da Viagem, é possível chamar a funcionalidade através das opções abaixo:

1. Através do botão FECHAR pela rotina de Atualizações → Viagens → Rodoviário Entrega → Fechamento (TMSA310) ou ;
   
   
2. Acesse Atualizações → Viagens → Viagem Modelo 3 → Viagem Mod.3.
   Para ambas rotinas de viagem , posicione na viagem desejada e acesse Outras Ações → Manutenção → Fechamento → Fechar .

A confirmação de que a viagem foi incluída na PagBem  tem um tempo para ser executada, pois é o momento que a PagBem valida as informações enviadas, gerando o numero do Contrato de Frete e preenchendo no campo N.o Proc. Transp. (DTR_PRCTRA) e ao gerar o Contrato de Pedágio preencherá o campo ID.Vge.Pdg (DTR_IDPDG).

Portanto este tempo de execução ou seja, tempo do processamento e retorno da PagBem, pode ser configurado através do campo Tempo de Espera(DEG_TEMPESP) , localizado na rotina Operadora de Frotas. Caso não ocorra o retorno no prazo estimado, a viagem não será fechada.

ESTORNO DO FECHAMENTO/ EXCLUSÃO CONTRATO PAGBEM
Ao efetuar uma operação de estorno do Fechamento da viagem, será acionado o método  Cancelamento de Contrato/Viagem PagBem (“DelTravel”) para cancelamento do Contrato PagBem emitido previamente no Fechamento da viagem. Para cancelar um contrato PagBem, posicione na viagem desejada e acesse Outras Ações → Manutenção → Fechamento → Estornar.

O cancelamento do contrato na PagBem segue regras específicas que podem interferir no seu cancelamento, e neste caso, podem ser exibidas uma ou mais mensagens de validação do SIGATMS e/ou da parceira PagBem.

11. OPERAÇÕES

Depois que o contrato é emitido na PagBem, será necessário realizar a liberação dos contratos de Frete e Pedágio.

Ao realizarmos o apontamento de Saída da Viagem os contratos serão Liberados.

Ao realizarmos o estorno do apontamento de Saída da Viagem os contratos serão Bloqueados.

Ao realizarmos novamente o apontamento de Saída da Viagem os contratos serão Desbloqueados.

12.  CONTRATO DE CARRETEIRO******

O contrato de carreteiro faz parte dos processos TMS x PagBem.
Para a configuração de momento de quitação do Contrato PagBem no cadastro de Operadoras de Frota Mom. Quit. PagBem (DEG_REPQUI) = 1 - Emissão, e o parâmetro MV_IMPCTC=1 - Impostos pela Operadora,  a Quitação do Contrato PagBem será através da emissão do Contrato de Carreteiro.

Caso a quitação estiver configurada, e o parâmetro MV_IMPCTC = 0 (ERP); os valores de impostos serão aglutinados e enviados novamente ao Contrato PagBem através do método AddTaxes, fazendo com que os impostos sejam atualizados antes de realizar a Quitação do Contrato PagBem. 

Fluxo do processo completo da rotina Contrato de Carreteiro durante a integração TMS x PagBem

EMISSÃO DE CONTRATO DE CARRETEIRO
Para realizar a emissão do Contrato de Carreteiro de uma viagem PagBem, realize os passos abaixo:

1. Acesse a rotina Atualizações → Terceiros → Contrato de Carreteiro
2. Clique no botão Por Viagem e relacione a Filial Origem e Número da Viagem PagBem preencha as perguntas e confirme a emissão do Contrato de Carreteiro para esta viagem.

Quando o contrato de carreteiro for gerado, ele calculará a diferença entre o valor previsto enviado no fechamento de viagem e o total do frete (considerando valor com ou sem impostos, de acordo com o parâmetro MV_IMPCTC), atualizando o valor do contrato PagBem através do método “Shipping/AddMovement".

LIBERAÇÃO DE CONTRATOS  (MV_LIBCTC =T)
Quando o parâmetro MV_LIBCTC está ativo e o campo Get.Tit.Fre (DUJ_TITFRE) localizado na rotina Contrato de Fornecedor- TMSA800 ) está = 2- Não, o momento de envio de quitação do contrato PagBem será através da rotina Liberação de Contratos.  Desta forma, a emissão do Contrato de Carreteiro não irá comunicar com a PagBem. 

Portanto, para esta configuração, após emitir o Contrato de Carreteiro de uma viagem TMS x PagBem,  realize os passos abaixo:

1. Em Atualizações → Terceiros → Lib. Contratos (TMSA251) ;
2. Clique no botão PARÂMETROS;
3. Relacione a Filial Origem e Número da Viagem PagBem e preencha as demais perguntas e confirme a abertura da rotina;
4. Marque o contrato de carreteiro em questão a Liberar.

5. Caso a liberação do contrato de carreteiro tenha sido efetuada com sucesso, será quitado o contrato PagBem, através do método "Shipping/Payment".
   
   

   Caso o campo campo Get.Tit.Fre (DUJ_TITFRE) localizado na rotina Contrato de Fornecedor- TMSA800 ) esteja com conteúdo =1 - Sim, e o parâmeto MV_LIBCTC esteja ativo (MV_LIBCTC=T), o Momento de Quitação será na própria emissão do Contrato de Carreteiro, e neste caso em particular, a rotina de Liberação de Contratos (TMSA251) continuará a ser utilizada apenas nos processos do TMS, porém não comunicará com a PagBem, pois nesta configuração o contrato PagBem já será quitado na emissão do Contrato de Carreteiro!

EXCLUSÃO DE CONTRATO DE CARRETEIRO
O estorno do Contrato Carreteiro dependerá de validações exclusivas tanto dos processos padrões do SIGATMS como a situação atual do Contrato PagBem.
Foi criada uma validação especial para o processo de integração TMS x PagBem quando o cálculo dos impostos é de responsabilidade do Protheus (MV_IMPCTC=0), e caso o contrato PagBem já tenha sido previamente emitido, não será possível excluir o Contrato de Carreteiro. Será exibida a mensagem abaixo:

"Como a viagem está integrada com a PagBem, o contrato não poderá ser excluído, pois os impostos já foram enviados enviados à Operadora."


Exemplo da mensagem em tela


AGENDAMENTO DE PAGAMENTO PAGBEM
Quando esta funcionalidade está configurada no portal PagBem Frete, o TMS realizará mais duas funcionalidades:

• Autorização de Pagamento PagBem (PaymentAuthorization)
  Esta funcionalidade será acionada somente quando no Portal PagBem, a empresa configurar o processo de agendamento de pagamentos. Portanto, quando o contrato PagBem possuir status  Quitado(Cleared) ,o SIGATMS executará o método Autorização de Pagamento (PaymentAuthorization). Uma vez autorizado, o status será alterado para Pago(Paid) e o crédito do saldo de pagamento será transferido no cartão do motorista.
  
  Se a Transportadora optar por não utilizar o Agendamento/Autorização de Pagamento na PagBem, o status do contrato PagBem ficará como Pago(Paid), caso contrário como Quitado(Cleared).
  
  

• Estorno de Autorização de Pagamento (PaymentAuthorization/Cancel).
  Esta funcionalidade será acionada no caso de estorno do Contrato Carreteiro, ou no estorno da Liberação do Contrato de Carreteiro.

   O estorno da Autorização de Pagamento é efetuado através do método Cancelar Autorização (PaymentAuthorization/Cancel). O cancelamento do contrato na PagBem segue regras específicas que podem interferir no seu cancelamento. Caso não seja possível cancelar o contrato na PagBem, o cálculo do contrato no SIGATMS também não é cancelado.

BAIXA DO CONTRATO CARRETEIRO / COMPENSAÇÕES FINANCEIRAS

Quando o Contrato de Carreteiro estiver vinculado a uma viagem TMS x PagBem, não será possível realizar o pagamento do Contrato de Carreteiro de forma manual.
A quitação do Contrato de Carreteiro e suas baixas financeiras somente ocorrerão mediante o processo de configuração do processo Conciliação Bancária.

15. PARÂMETROS

• MV_TMSPBLG

16. TABELAS UTILIZADAS

• SA2 – Fornecedores
• DA4 – Motorista
• DEG – Operadora de Frota
• DTY – Contrato de Carreteiro
• DTR – Complemento de Viagem
• DTQ – Viagem
• DEL – Motorista x Operadora
• DUP – Motoristas da Viagem
• DA3 - Motoristas.
• DA8 - Cadastro de Rotas.
• DEK - Rota x Operadora 
• DMZ - Regras de Quitação PagBem
• DVG - Contrato Fornecedor
• SDG - Movimento de Custo de Transporte.
• DEM - Operadora de Frota X Ações 

17. ASSUNTOS RELACIONADOS

• Cadastro de Fornecedor.
• Cadastro de Rotas.
• Cadastro de Veículos
• Cadastro de Motoristas.
• Viagem Mod. 3

• Contrato de Carreteiro.

• Fechamento da Viagem.

• DT DLOGTMS02-20494 Integração SIGATMS x Pagbem (CIOT por período)

• DT DLOGTMS02-20481 Geração do Contrato de Pedágio integração SIGATMS x PagBem
• DT DLOGTMS02-20616 Gravação dos ID's de integração na DTR

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>