Histórico da Página

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
Image Removed
*** Alterar para o Mapa Final. Image Added

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ágioPedagio na Operadora Pagbem.
      
      Exemplo de preenchimento da aba "Comunicação API', no cadastro Operadora de Frota (TMSAE60)
      
      
      Exemplo de preenchimento do campo Contr.PDG.PB, na  aba "Comunicação API', no cadastro Operadora de Frota (TMSAE60) 

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, gerando o Token de comunicação.

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 PagBem, as configurações serão coletadas através da nova rotina Regra de Quitação de Frete PagBem.

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

(TMSAC28)

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

Image Added

Exemplo de inclusão cadastral na nova rotina Regras de Quitação de Frete Pagbem (TMSAC28)

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 de Quitação de Frete Pagbem (TMSAE60TMSAC28).
   
   Exemplo de utilização do campo novo campo Cod. Regra no contrato do Fornecedor, para que seja associada a Regra de Quitação previamente cadastrada.
   
   
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.

Image Removed
Exemplo de consulta do Roteiro PagBemde preenchimento aba Rota x Operadora de Frota, vinculando um Roteiro cadastrado na operadora Pagbem.

Image Added

Exemplo de consulta do Roteiro PagBem, onde nesta tela são retornados por parte da operadora de frota, todos os roteiros cadastrados no sistema da operadora 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 

Image Added

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. Posicione na aba 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 ao informar o veículo da viagem, será acionado o método "Route/ByRouteCode" para o cálculo automático do Pedágio ocorrerá 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 Pedagiocampo 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 Mod. 2
      Image Removed
      Exemplo de preenchimento dos dados na aba Complemento de
      Viagem (Viagem Mod.2)
      Image Removed
      Exemplo de preenchimento dos dados do motorista (Viagem Mod.2)
      Viagem Modelo 3 
      Image RemovedImage Added
      Exemplo de preenchimento dos dados na aba Recursos (Viagem Mod. 3)
      Image Removed
      Exemplo de preenchimento dos dados do motorista (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 das rotinas Viagens Mod. 3 e Viagem Mod.2  da Viagem que ocorrerá a emissão do contrato de frete e o Contrato de Pedágio(mediante configuração do campo Contr. PDG no cadastro de Operadora de Frota). O contrato de pedágio é gerado como liberado junto a PAGBEM.  

FECHAMENTO DA VIAGEM / EMISSÃO DO CONTRATO PAGBEM 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 (ShippingCreate).
Fluxo .

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




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 Acesse Atualizações → Viagens → Rodoviário Entrega → Fechamento (TMSA310) ou ;
   Acesse Atualizações → Viagens → Rodoviário Entrega → Viagem Mod. 2 ou Atualizações → Viagens → Viagem Modelo 3 → Viagem Mod.3 .
   Para ambas rotinas de viagem e , posicione na viagem desejada;
2. Acesse e acesse Outras Ações → Manutenção → Fechamento → Fechar .

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

A confirmação de fechamento da viagem Tms x PagBem dependerá de validações de regras de negócio tanto a operadora Pagbem, quanto validações padrões do TMS Protheus.  Ao fechar a viagem, a operadora Pagbem retornará:

• Número do Contrato de Frete, através do campo N.o Proc. Transp. (DTR_PRCTRA

• );
• Número do CIOT (DTR_CIOT)

Image Removed

12. CUSTO DE TRANSPORTE

Depois que o contrato é emitido na PagBem, todos os tipos de créditos e débitos que poderão ocorrer durante a viagem recebem o nome de “Movimentações de Valores”.

• ;
• Número do Contrato de Pedágio, através do campo ID.Vge.Pdg (DTR_IDPDG)  - preenchimento mediante configuração do campo Contr. PDG Pgb no cadastro de Operadora de Frota (TMSAE60).

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  emitido previamente no Fechamento da viagem.

Desta forma, para cancelar um contrato PagBem, posicione na viagem desejada, realize os passos abaixo:

1. Acesse Atualizações → Viagens → Viagem Modelo 3 → Viagem Mod.3 e , posicione na viagem desejada;

2. Acesse Outras Ações → Manutenção → Fechamento → Estornar.
   
   

   Informações
   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 DA VIAGEM

Depois que o contrato é emitido na PagBem, será necessário realizar a liberação dos contratos de Frete. Ao realizarmos o apontamento de Saída da Viagem os contratos serão Liberados.

APONTAMENTO DE OPERAÇÃO DE SAÍDA / LIBERAÇÃO CONTRATO PAGBEM

Para liberar um contrato Pagbem, realize os passos abaixo:

1. Acesse Atualizações → Viagens → Viagem Modelo 3 → Viagem Mod.3 e , posicione na viagem desejada;
2. Acesse Outras Ações → Manutenção → Operaçoes , selecione a operação de saída;
3. Clique em APONTAR e digite os dados na tela;
4. Clique em CONFIRMAR para apontar a operação de saída e enviar a liberação do valor de adiantamento nos contratos Pagbem. 

Ao realizarmos o estorno do apontamento de Saída da Viagem as liberações nos contratos Pagbem serão estornados.

Ao realizarmos novamente o apontamento de Saída da Viagem, a liberação ocorrerá.

12.  CONTRATO DE CARRETEIRO

A rotina Contrato de Carreteiro (TMSA250) será utilizada para enviar junto a operadora de Frota, a quitação do Contrato Pagbem. Quando emitido o Contrato de Carreteiro de uma viagem integrada a Operadora Pagbem, o mesmo receberá as informações do Contrato Pagbem para que seja possível a comunicação com o sistema parceiro, no objetivo de atualizar o Contrato Pagbem.

Há duas opções para quitação do contrato Pagbem: 

1. PAGAMENTO DE SALDO
   É através desta rotina que o serão enviadas as movimentações finais no contrato Pagbem. 
   Para realizar uma quitação de contrato Pagbem, realize os passos abaixo:
            a. Acesse Atualizeções → Terceiros → Contrato de Carreteiro;
            b. Posicione no Contrato de Carreteiro previamente emitido - garanta que o mesmo esteja liberado para pagamento;
           c. Acesse Outra Ações → Pagto Saldo → Pagar
           d. Aguarde a baixa do Contrato Pagbem  / baixa financeira do Contrato de Carreteiro. 
   
   

   Informações
   Caso tenha sido realizado o lançamento de Acréscimos ou Decréscimos no Contrato de Carreteiro, será criada antes da Quitação do contrato Pagbem, uma movimentação financeira no Contrato Pagbem com o devido valor lançado na emissão do Contrato Carreteiro.  Para maiores informações, acesse Exemplo de utilização Ajuste Financeiro Pagbem

   
   
   

2. PAGAMENTO DE SALDO EM LOTE  (Nova opção)
   Nova opção exclusiva para pagamento de múltiplos Contratos de Carreteiro integrados junto a Operadora Pagbem.
   Através desta opção, o usuário pode selecionar múltiplos contratos de carreteiro e envia-los de uma só vez junto a Operadora de Frota Pagbem, processo geralmente utilizado para quitação de contratos com CIOT Agregado junto a operadora.

         a. Acesse Atualizeções → Terceiros → Contrato de Carreteiro;
         b. Posicione no Contrato de Carreteiro previamente emitido - garanta que o mesmo esteja liberado para pagamento;
        c. Acesse Outra Ações → Pagto Saldo → Pg Sld Lote
        d. Já na nova tela, clique no botão Param.
        e. Preencha as perguntas abaixo para realizar o filtro dos contratos de carreteiro em questão que serão pagos:
                Contrato De?
                Contrato Até?
                Da Data?
                Até a Data?
                Proprietário De?
                Loja De?
                Proprietário Ate?
                Loja Ate?
                Filial Origem De?
                Viagem De?
                Filial Origem Ate?
                Viagem Ate?
                Filtrar Contratos? = Ambos

        f. Será aberta a nova tela Pagto Saldo em Lotes;
       g. Marque os Contratos de Carreteiro que deseja marcar;
       h. Clique em +Pagar Saldos e aguarde o processamento completo tanto da operadora Pagbem, quando as baixas financeiras do Contrato Carreteiro.

Image Added
Nova tela Pagamento do Saldo do Contrato Carreteiro em Lotes, exclusivo para integração TMS x Operadora de Frota Pagbem 

13. CIOT POR PERIODO

Está disponível nesta integração a opção de emitir o CIOT Por Período e utilização da rotina Encerra Ciot, para encerramento de CIOT junto a ANTT.
Para maiores informações sobre como utilizar o processo, acesse Exemplo de utilização Encerra Ciot (TMSA256-SIGATMS) com Integração Pagbem .  

 14. PARÂMETROS

• MV_TMSPBLG

• MV_TMSOPDG

15

Image Removed

1. Acesse Atualizações -> Transportes → Movimento Custo Transp. (TMSA070) e clique em INCLUIR.
2. No Campo Cod. Despesa(DG_CODDES), relacione a despesa previamente vinculada na rotina Ações x Operadora.
3. No campo Veículo(DG_CODVEI), relacione o veículo vinculado ao prestador que será pago via PagBem.
4. No campo Fil.Origem (DG_FILORI), pressione F3 do teclado ou clique no ícone da lupa para preencher as perguntas de filtro das viagens relacionadas. Selecione a viagem desejada para o lançamento.
5. No campo Custo Moeda1 (DG_CUSTO1) , digite o valor da movimentação a ser lançada no contrato PagBem
6. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
7. Confirme a inclusão. Neste momento, o sistema enviará as movimentações no contrato PagBem conforme lançamento realizado.

13. NOVAS OPÇÕES OPERADORA DE FROTA PAGBEM

Opção exclusiva desta integração, foram desenvolvidas novas funcionalidades que permitem maior flexibilidade na gestão dos dados integrados junto a PagBem. As opções disponíveis podem ser acionados pela nova opção do botão Outras Ações → Operadora de Frota → PagBem nas rotinas Viagem Mod.3 ou Viagem Mod. 2.  Para todas as opções, é necessário que o usuário selecione a viagem desejada para realizar as ações.

Image Removed

• Gera Contrato
  

1. Inclua uma viagem;
2. Acesse a opção Outras Ações -> Operadoras de Frota -> Gera Contrato;
3. Ao clicar nessa opção, será acionado o método Post - Shipping da PagBem, permitindo que seja realizada a inclusão do contrato PagBem manualmente.

• Atualiza Status
  Utilizado para consultar e atualizar o status de processamento do contrato PagBem originado de uma viagem do SIGATMS.
  

1. Acesse a opção Outras Ações -> Operadoras de Frota -> Atualiza Status;
2. Ao clicar nessa opção, será acionado o método GET - /Shipping/StatusProcessing/ByIdentifier para consultar e atualizar o status de processamento do contrato na PagBem e atualizar os dados no SIGATMS;
3. Após acionar esse método o sistema irá verificar se o Contrato (Shipping) já foi totalmente processado pela PagBem;
4. Caso seja processado corretamente iremos atualizar os campos N.o Proc. Transp.(DTR_PRCTRA/DM5_PRCTRA) e CIOT(DTR_CIOT) e Id.Ope.Vge.(DTY_IDOPE)com as respectivas informações: Shipping Id e Número do CIOT;
5. Caso contrário o sistema irá tentar até o limite do tempo de espera informado no campo Tempo Espera (DEG_TMPESP), localizado no Cadastro de Operadora.

• Consulta Status
  Utilizado para viagens já integradas junto a PagBem, esta opção tem a finalidade de consultar a situação atual do contrato PagBem vinculado a viagem.

1. Acesse a opção Outras Ações -> Operadoras de Frota ->Consulta Status;
2. Ao clicar nessa opção, será acionado o método GET /Shipping/ByShipping para apenas realizar uma consulta do Contrato PagBem ;
3. Será exibida em tela as informações retornadas pelo método.

• Interrompe Contrato
  Esta opção possui a finalidade de interromper um contrato já emitido, quando houver situações operacionais não previstas. É recomendado utilizar esta opção para casos onde a viagem atual necessitar ser cancelada/encerrada previamente por motivos não previstos no planejamento da viagem.

• Bloqueia Contrato
  Esta opção é utilizada para bloquear temporariamente novas movimentações em um contrato PagBem previamente emitido.

1. Acesse a opção Outras Ações -> Operadoras de Frota ->Bloqueia Contrato;

2. Ao clicar nessa opção, será acionado o método PATCH /Shipping/lockUnlock;
3. Caso ocorra algum erro, será exibida mensagem em tela;

• Desbloqueia Contrato
  Esta opção é utilizada para desbloquear contratos PagBem os quais foram bloqueados previamente. 

1. Acesse a opção Outras Ações -> Operadoras de Frota ->Desbloqueia Contrato;
2. Ao clicar nessa opção, será acionado o método PATCH /Shipping/lockUnlock;
3. Caso ocorra algum erro, será exibida mensagem em tela;

• Cancela Contrato
  Esta opção é utilizada para cancelar manualmente um contrato PagBem previamente emitido.

• Consulta Quitação
  Esta opção é utilizada para consultar os dados de um contrato PagBem previamente quitado.

• Conciliação Financeira
  Caso o contrato PagBem já esteja Pago/Quitado, esta funcionalidade pode ser acionada manualmente para realizar a baixa das informações no SIGATMS como Quitação do Contrato de Carreteiro TMS + Realização de Baixas e compensações financeiras relacionadas ao contrato.

14. ENCERRAMENTO DA VIAGEM 

De acordo com a configuração do campo Mom. Quit. Rep (DEG_REPQUI) localizado na aba Outros da rotina Operadoras de Frota(TMSAE60), se configurado com a opção "2-Encerramento da Viagem", o contrato PagBem será quitado o contrato na  PagBem através do método "Shipping/Payment" quando ocorrer o encerramento da viagem.

Caso o campo esteja com conteúdo =1 -Emissão Contrato Carreteiro, o encerramento da viagem não se comunicará com a PagBem.

Portanto, é importante verificar se todas as ações já foram realizadas na viagem antes de proceder com o encerramento da viagem/ Quitação do Contrato PagBem.
O encerramento da viagem só será efetuado mediante as validações padrões do SIGATMS, bem como validações da Operadora PagBem em relação ao Contrato de frete emitido. 

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

1. Acesse Atualizações → Viagens → Viagem Mod.3
2. Posicione na viagem desejada
3. Clique no botão OUTRAS AÇÕES → Manutenção →Encerramento → Encerrar. 

15. 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
Image Removed

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.

Image Removed

• 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.

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.

16. PARÂMETROS

• MV_TMSPBLG

. 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çõesAções 

16. ASSUNTOS RELACIONADOS

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

• Contrato de Carreteiro.

• Fechamento da Viagem.

  Operadora X Ações
• Regras de Quitação de Frete Pagbem (TMSAC28)
• Exemplo de utilização Ajuste Financeiro Pagbem
• Exemplo de utilização Conciliação BancáriaEncerra Ciot (TMSA256-SIGATMS) com Integração Pagbem
• DLOGTMS02-21024 DT Integração TMS x Pagbem

<!-- 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>