Integração Repom Frete (Integrações - SIGATMS)

CONTEÚDO

01. PRÉ-REQUISITOS

1. Configure o parâmetro MV_VSREPOM com conteúdo 2.2 . 
2. Configure o parâmetro MV_TMSOPDG com conteúdo 2.
   
3. Configure o parâmetro MV_REPTRAC  com conteúdo T para gravar a troca de informações Json entre o Protheus e a Operadora Repom
   
   Fluxo completo da troca de informações TMS x REPOM
   
   
   
   

02. CADASTRO DE OPERADORA 

Realize o relacionamento do cadastro da Operadora Repom. 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. Foram criados os novos campos abaixo, os quais serão os dados para conexão junto ao sistema Repom Frete. Estes dados serão fornecidos pela própria Repom. São eles:
   
   1. Informe o campo Nome Usuário (DEG_USER) de acordo com informações da Repom.
   2. Informe o campo Senha (DEG_SENHA) de acordo com informações da Repom.
   3. Informe o campo URL WS (DEG_URLWS) de acordo com informações da Repom.
      
      
          Novos campos para comunicação com a operadora Repom 

   
   

3. Acesse a aba Outros e configure os campos abaixo:
   a. Mom.Quit.Rep(DEG_REPQUI) ao qual substitui a funcionalidade do parâmetro MV_ENREPOM. Este campo possui a finalidade de definir o momento de quitação do contrato Repom.
   b.Tempo Espera (DEG_TMPESP) para definir o tempo de resposta entre os sistemas. O tempo de espera, definirá o tempo 'em segundos' em que o sistema SIGATMS ficará aguardando a resposta da REPOM.
   c. Também informe o campo já existente Calc Pedagio (DEG_CALPDG) com o conteúdo 1 - Operadora.
   d. No campo Ger Carreteir (DEG_GERCTC) configure se deseja que o sistema gere automaticamente o contrato carreteiro no fechamento da viagem. Opções disponíveis : 0 - Não gera; 1- Fechamento da Viagem
   e. Configure o campo Usa Agenda (DEG_USAAGE) para equiparar a configuração de Agenda Financeira realizada na Repom. Opções disponíveis: 1 -Sim ; 2 Não.
   f. Configure o campo Aut Pagto (DEG_AUTPAG) para equiparar a configuração de Autorização de Pagamento realizada na Repom. Opções disponíveis: 1 -Sim ; 2 Não.
   
   
   Exemplo de preenchimento dos campos na aba Outros, rotina Operadora de Frota
   
   
   
4. Acesse a opção Outras Ações → Operac. para incluir as Operações da Operadora de Frota. Preencha os campos:
   a. Informe o campo Serv Trans.(DEJ_SERTMS) com o serviço de transporte TMS desejado.
   b. Informe o campo Tipo Transp.(DEJ_TIPRA) com o tipo de transporte TMS desejado.
   c. Informe o campo Operação (DEJ_OPERAC) com o código da operação Repom cadastrada no portal Repom Frete.
   
            
             Exemplo de preenchimento da tela Operac - Operações da Operadora
   
   
5. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
   
6. Confirme a inclusão/alteração dos dados.
   
7. Retorne na tela inicial da rotina, e acesse Outras Ações → Teste Comunicação REPOM  para validar os dados de conexão junto a operadora REPOM.
   
          
          Nova opção Teste Comunicação Repom
    
         
         Exemplo Teste de Comunicação Repom

03. OPERADORA DE FROTA X AÇÕES

Este cadastro será utilizado posteriormente para o envio de movimentações de Débito e Crédito, em contratos Repom previamente emitidos no TMS.
Para cadastrar as movimentações Repom desejadas, realize os passos abaixo:

1. Acesse Atualizações → Transportes → Despesas(TMSA60) e realize cadastros de despesas para relacionar com os movimentos Repom.
2. Acesse Atualizações →  Operadora de Frota →  Operadora de Frota X Ações (TMSAE65) e clique no botão INCLUIR ou ALTERAR.
3. No campo Cod. Operadora (DEM_CODOPE) informe 01 para Repom;
4. No campo Cod. Movto. (DEM_CODMOV), pressione F3 do teclado ou clique no ícone da lupa. O sistema consultará a plataforma Repom Frete para obter as movimentações disponíveis para uso;
5. No campo Serv. Transp (DEM_SERTMS) relacione os serviços TMS habilitados a realizar tais movimentações;
6. No campo Tipo Movto. (DEM_TIPMOV) selecione a opção 'E'-ENVIO para o envio das informações a partir do Protheus;
7. No campo Ação (DEM_ACAO) selecione a opção 02 - MOVTO. CUSTO DE TRANSPORTE;
8. No campo Form.Ação (DEM_FORMUL)  relacione em aspas simples o código da despesa TMS.
   
   
   Exemplo de relacionamento dos campos em questão, devidamente vinculados a operações Repom
   
   

04. CADASTRO DO FORNECEDOR

O cadastro do fornecedor Protheus é utilizado para criação e atualização dos prestadores Repom na plataforma Repom Frete. Os campos abaixo são obrigatórios para a troca de informações durante a integração  TMS x Repom. 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 Repom.
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 Repom. 
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 Repom Frete.
    
    
    
    
    Telas de exemplo de preenchimento de um fornecedor Repom 
    
    
    

05. 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 Repom. 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 Tipo de Veículo(DA3_TIPVEI) .
4. Preencha o campo Código/Loja Fornecedor(DA3_CODFOR/DA3_LOJFOR) .
5. Preencha o campo Qtde. Eixos(DA3_QTDEIX) .
6. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
7. Confirme a inclusão/atualização cadastral.
   
8. Retorne na tela principal da rotina e acesse a opção Outras Ações  → Dados x Operad. para atualizar os dados no sistema Repom Frete.
   
   
    Exemplo de preenchimento de um veículo Repom 
   
   
   

06. CADASTRO DO MOTORISTA

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 Repom. 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. Na aba Motorista x Operadora de Frota, preencha o campo Cod.Operad.(DEL_CODOPE) =01 - Repom.
11. Na aba Motorista x Operadora de Frota, preencha o campo Id.Motorista (DEL_IDOPE) com o número do cartão Repom a ser pago junto ao motorista.
12. Na aba Motorista x Operadora de Frota, preencha o campo Flex. Repom (DEL_FLEXID) com o número do cartão de Vale Abastecimento Repom/Ticket Log.
13. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
14. Confirme a inclusão/atualização cadastral.
15. Retorne na tela principal da rotina e acesse a opção Outras Ações  → Dados x Operad. para atualizar os dados no sistema Repom Frete.
    
    

07. CONTRATO DO FORNECEDOR

Para a troca de informações durante a integração TMS x Repom, 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. 
2. No campo ID Propriet (DUJ_IDOPE) caso o fornecedor possua um cartão cadastrado na REPOM, realize a associação do cartão pressionando F3 ou clicando no ícone de pesquisa
3. No campo Resp. Frt. Rep (DUJ_REPFRT), determine para qual cartão será pago o Frete via integração Repom. Opção 2 - Cartão do Motorista; Opção  1- Cartão do Fornecedor.
4. No campo Grv. His. Excl (DUJ_GRVHIS), determine se a cada exclusão de contrato carreteiro será gravado o controle na rotina Contratos de Carreteiro Cancelados (TMSA250B)
   
   Exemplo de utilização dos campos Id Propriet , Resp. Frt Rep e o campo Grava Histórico
   
   
   
5. No item do Contrato, preencha o campo Operac. Frota(DVG_OPERAC) pressione F3 do teclado ou clique no ícone da lupa. O sistema consultará as informações previamente cadastradas na rotina Operadoras de Frota (TMSAE60).
   
   Exemplo de utilização do campo Operac. Frota no contrato do Fornecedor
   
   
6. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
7. Confirme a inclusão/atualização cadastral.
   
   

08. PERFIL DO CLIENTE

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

1. Acesse a rotina Atualizações -> Comercial -> Perfil do Cliente (TMSA480) e clique no botão INCLUIR  ou ALTERAR. Preencher todos os campos abaixo:
2. Preencha o campo Operac. Entrega (DUO_OPEENT) pressione F3 do teclado ou clique no ícone da lupa. O sistema consultará a plataforma Repom Frete para obter as operações disponíveis para uso

3. Preencha o campo Operac. Coleta (DUO_OPECOL) pressione F3 do teclado ou clique no ícone da lupa. O sistema consultará a plataforma Repom Frete para obter as operações disponíveis para uso
   

   Esse campo é utilizado para identificar o código e tipo de operação (Operation Identifier) ao criar o Contrato na Repom (Fechamento da Viagem). 
   O código e tipo de operação (Operation Identifier) também pode ser configurado no parâmetro MV_OPREPOM e será utilizado apenas para viagens do tipo 3=Vazia.

4. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
5. Confirme a inclusão/atualização cadastral.

09. CADASTRO DE ROTA
O cadastro de Rotas é utilizado para associar uma Rota do TMS à um Roteiro do sistema Repom. Cada rota no SIGATMS é amarrada a um roteiro/percurso da Repom.
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 01 - Repom.

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

   A opção configurada no campo Frota pode interferir na troca de informações junto a plataforma Repom.
   Caso o campo seja configurado com a opção diferente do conteúdo 0 - Todos, somente serão aceitos na plataforma Repom, veículos cuja a frota do veículo (DA3_FROVEI) seja exatamente a mesma configurada no campo da Rota (1- Propria, 2 - Terceiro ou 3 - Agregado). 
   Por este motivo, recomendamos a configuração deste campo com a opção 0 - Todos.

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.

6. Na tela Consulta Roteiro, confirme o conteúdo dos campos UF, ORIGEM e os campos UF,DESTINO com as cidades de Origem e Destino que farão parte do trajeto de viagem.
   
   
   Exemplo de consulta do Roteiro Repom
   
   
7. Para situações onde o Roteiro Repom não existir, a funcionalidade para a solicitação de Roteiro na plataforma Repom pode ser acionada nesta mesma tela, através do botão Outras Ações → Incluir Roteiro
8. 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. 
   
   
   Exemplo de campos preenchidos na tela de Inclusão do Roteiro
   
   
9. Confira os dados na tela de Inclusão do Roteiro e clique no botão Salvar.
   

   
   

   Criação de novo Roteiro

   A confirmação de criação de um novo Roteiro na plataforma Repom necessita de aprovação da Operadora. 
   Esta ação tem um tempo para ser executada na Repom e a confirmação da solicitação do roteiro não significará, portanto, que um Roteiro fora incluído.

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

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

12. 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 Repom com a Rota TMS.

10. CRIAÇÃO DE VIAGEM REPOM (VIAGEM MOD. 2 e VIAGEM MOD. 3)

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

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


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

1. Acesse a rotina Atualizações →  Viagens →  Viagem Mod. 2 (TMSA144) ou 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 Repom.
   
3. Complemento da Viagem  (Viagem Mod.2) / Recursos (Viagem Mod. 3).
4. Nesta opção, a viagem receberá os demais dados que serão integrados junto a Repom, como: Operadora de Frota, Veículo, Motorista, Valor de Frete, Valor de Pedágio, Valor de Adiantamento de Frete, e valor de Adiantamento Flexível (caso o motorista tenha o Cartão).
   
   1. Operadora de Frota
      Acesse a opção Complemento de Viagem através do botão Outras Ações para Viagem Mod. 2 ou 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 01-Repom.
      
      
   2. Veículo
      No item das rotinas em questão, vincule o veículo previamente cadastrado e integrado com a Repom através do campo Cod.Veiculo(DTR_CODVEI). 
      
      
   3. Motorista
      Informe um motorista Repom previamente integrado para a viagem em Outras Ações → Mot.Viag (Viagem Mod.2) ou 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 "Route/ByRouteCode" 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 Repom, será atualizado o campo Pedagio(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 Outras Ações → Adiantamento/Desp (Viagem Mod. 2) ou aba Despesas (Viagem Mod. 2) e realize o lançamento de uma despesa do tipo Movimenta Banco (DT7_MOVBCO =1).
      
      
   7. Cartão e Valor de Adiantamento Flexível Repom (Vale Abastecimento)
      No grid da tela, vincule o cartão (DTR_ADIFLEX) para Adiantamento Flexível Repom (Vale Abastecimento) crédito, bem como preencha o valor de Adiantamento Flexível a ser creditado. Este valor é configurado no portal Repom, onde é definido um percentual de valor que pode ser creditado nesta cartão de vale-abastecimento. O Valor digitado não pode ultrapassar o valor de adiantamento ou de frete da viagem.

   1. 
      Exemplos de preenchimento:
      
      Viagem Mod. 2
      
      Exemplo de preenchimento dos dados na aba Complemento de Viagem (Viagem Mod.2)
      
      
      Exemplo preenchimento Adto Flexível Repom (Vale Abastecimento) - Viagem Mod.2
      
      
      
      
      Exemplo de preenchimento dos dados do motorista (Viagem Mod.2)
      
      
      Viagem Modelo 3 
      
      Exemplo de preenchimento dos dados na aba Recursos (Viagem Mod. 3)
      
      

   2.                 Exemplo preenchimento Adto Flexivel Repom (Vale Abastecimento - Viagem Mod.3

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

11. FECHAMENTO DE VIAGEM 

Através do Fechamento das rotinas Viagens Mod. 3 e Viagem Mod.2  que ocorrerá a emissão do contrato na Repom . A emissão do Contrato Repom é o inicio do controle de um processo quando se utiliza  frota de terceiros

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

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






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 → Rodoviário Entrega → Viagem Mod. 2 ou 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 REPOM  tem um tempo para ser executada, pois é o momento que a REPOM valida as informações enviadas, gerando o numero do Contrato e preenchendo no campo N.o Proc. Transp. (DTR_PRCTRA/DM5_PRCTRA)  e o número do CIOT (DTR_CIOT). Esta informações gravadas no TMS dependem exclusivamente da configuração de operação Repom vinculada a viagem!

Portanto este tempo de execução ou seja, tempo do processamento e retorno da REPOM, 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 REPOM
Ao efetuar uma operação de estorno do Fechamento da viagem, será acionado o método  Cancelamento de Contrato/Viagem Repom (“ShippingCancel”) para cancelamento do Contrato Repom emitido previamente no Fechamento da viagem. Para cancelar um contrato Repom, o acesso será o mesmo tanto na rotina Viagem Mod. 3 , como Viagem Mod. 2. Para ambas rotinas , posicione na viagem desejada e acesse Outras Ações → Manutenção → Fechamento → Estornar.

O cancelamento do contrato na Repom 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 Repom.

Em referência as validações realizadas pelo SIGATMS, o sistema continuará validando as situações do processo padrão viagem, como Status da viagem, entre outros.  Já a regra específica para estorno da viagem no que refere exclusividade dos processos SIGATMS integrados junto a Repom, se houver movimentações de débito ou crédito integradas junto ao contrato Repom, o TMS não permitirá estorno do fechamento e exibirá a seguinte mensagem:

"Verifique os dados...
Existem Despesas para essa viagem integradas com a Repom. Efetue o estorno da despesa pelo Movto de Custo de Transporte.
Depesa: Código do documento de despesa (SDG) relacionado a viagem - Cod. Despesa: Código da despesa vinculada ao documento de despesa (SDG)- Item: número do Item da Despesa lançado no documento em questão - Total: Valor da Despesa"


Exemplo de mensagem em tela

12. CUSTO DE TRANSPORTE

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

Para que uma movimentação seja inserida dentro do contrato, é utilizado o método "Shipping/AddMovement".  

Fluxo da troca de informações entre o SIGATMS x REPOM para o envio de Movimentos no Contrato Repom


Desta forma, para realizar o lançamento de movimentações junto a viagem previamente integrada junto a Repom, os lançamentos serão feitos através da rotina Movimento de Custo de Transporte (TMSA070), porém se faz necessário antecipadamente relacionar os cadastros de Despesas(TMSA060) e Operadora x Ações(TMSAE65).

Para lançar os movimentos no contrato Repom, realize os passos abaixo:

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 REPOM.
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 REPOM
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 Repom conforme lançamento realizado.

13. NOVAS OPÇÕES OPERADORA DE FROTA REPOM

Opção exclusiva desta integração, foram desenvolvidas novas funcionalidades que permitem maior flexibilidade na gestão dos dados integrados junto a Repom. As opções disponíveis podem ser acionados pela nova opção do botão Outras Ações → Operadora de Frota → Repom 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.

Exemplo de acesso das novas funcionalidades

Segue abaixo opções disponíveis:

• 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 Repom, permitindo que seja realizada a inclusão do contrato Repom manualmente.

• Atualiza Status
  Utilizado para consultar e atualizar o status de processamento do contrato Repom 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 Repom 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 Repom;
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. Esta informações gravadas no TMS dependem exclusivamente da configuração de operação Repom vinculada a viagem!
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 Repom, esta opção tem a finalidade de consultar a situação atual do contrato Repom 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 Repom ;
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.

1. Acesse a opção Outras Ações -> Operadoras de Frota ->Interrompe Contrato;
2. Ao clicar nessa opção, será acionado o método PATCH /Shipping/Interruption para cancelar/interromper um contrato Repom com status 'Em Trânsito';
3. Não é possível interromper um contrato Repom quando o contrato de carreteiro TMS está ativo no sistema. Exclua-o se possível

4. Caso ocorra algum erro, será exibida mensagem em tela.
   
   

• Bloqueia Contrato
  Esta opção é utilizada para bloquear temporariamente novas movimentações em um contrato Repom 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 Repom 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 Repom previamente emitido.

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

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

1. Acesse a opção Outras Ações -> Operadoras de Frota ->Cancela Contrato;
2. Ao clicar nessa opção, será acionado o método GET/Shipping/ByIdentifier; - O sistema consultará especificamente a sessão 'ShippingPayment' desta consulta.
3. Caso ocorra algum erro, será exibida mensagem em tela
   
   

• Conciliação Financeira
  Caso o contrato Repom 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.

1. Acesse a opção Outras Ações -> Operadoras de Frota ->Conciliação Financeira
2. Ao clicar nessa opção, será acionado a geração automática do contrato de carreteiro, bem como será acionada a conciliação financeira e baixa automática dos títulos e quitação do Contrato Carreteiro TMS.
   
   

14. ENCERRAMENTO DA VIAGEM 

Fluxo da troca de informações entre o SIGATMS x REPOM para Quitação do Contrato Repom

De acordo com a configuração do campo Mom. Quit. Rep (DEG_REPQUI) localizado na aba Outros da rotina Operadoras de Frota(TMSAE60), e o parâmetro MV_IMPCTC, será definido o momento de quitação do contrato na operadora Repom dentro dos processos do TMS Protheus.

A configuração do campo  Mom. Quit. Rep (DEG_REPQUI)  =1 -Emissão Contrato Carreteiro é de uso exclusivo do parâmetro MV_IMPCTC=1. Neste modelo de configuração, o encerramento da viagem não se comunicará com a Repom. 

Para uso do parâmetro MV_IMPCTC=0,  a opção disponível no campo  Mom. Quit. Rep (DEG_REPQUI) é opção 2 - Encerramento da viagem. Porém esta opção também está disponível para uso do MV_IMPCTC=1. 

Para encerrar uma viagem, realize os passos abaixo:

1. Acesse Atualizações → Viagens → Viagem Mod.2  ou Viagem Mod.3
2. Posicione na viagem desejada
3. Clique no botão OUTRAS AÇÕES → Manutenção →Encerramento → Encerrar. 
4. Caso a configuração do campo  Mom. Quit. Rep (DEG_REPQUI) = 2 - Encerramento da viagem, será enviado neste momento o envio da quitação do contrato Repom (A quitação depende de validações exclusivas da operadora Repom).

15. CONTRATO DE CARRETEIRO 

Para a configuração de momento de quitação do Contrato Repom no cadastro de Operadoras de Frota Mom. Quit. Repom (DEG_REPQUI) = 1 - Emissão, e o parâmetro MV_IMPCTC=1 - Impostos pela Operadora,  a Quitação do Contrato Repom será através da emissão do Contrato de Carreteiro.

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

15.1 EMISSÃO DE CONTRATO DE CARRETEIRO / ATUALIZAÇÕES CONTRATO REPOM (MV_IMPCTC=1)

Para realizar a emissão do Contrato de Carreteiro de uma viagem Repom, 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 REPOM preencha as perguntas e confirme a emissão do Contrato de Carreteiro para esta viagem.
3. Confirme a inclusão do contrato de carreteiro.
4. Caso a configuração do parâmetro MV_IMPCTC=1 e o campo  Mom. Quit. Rep (DEG_REPQUI) = 1 - Emissão do Contrato, será enviada a quitação do contrato na operadora Repom (Enviado o método ShippingPayment)

15.2 ENVIO DE NOVOS MOVIMENTOS DE VALORES NO CONTRATO REPOM  ATRAVÉS DE EMISSÃO DE CONTRATO DE CARRETEIRO COMPLEMENTAR TMS PROTHEUS

Após possuir uma viagem integrada junto a Repom, é possível realizar o envio de movimentos Repom no mesmo contrato emitido, através da emissão do contrato complementar de carreteiro. Trata-se de um fluxo adicional no processo, sendo necessário avaliar a necessidade de utilização desta funcionalidade.

Para realizar esta ação, confira os passos abaixo:

1. Previamente, se faz necessário configurar um lançamento de movimento Repom, para o processo de Contrato de Carreteiro Complementar. Confira o passo 3 desta documentação para a verificar a devida configuração.
2. Acesse a rotina Contrato de Carreteiros e posicione no contrato pertinente a viagem integrada junto a Repom;
3. Clique no botão Complemento;
4. No campo Frete (DTY_FFRETE), preencha o valor que deseja complementar no contrato;
5. Preencha o campo Cod. Movto (DTY_CODMOV) com o código de movimentação Repom à realizar no contrato junto a operadora
6. Confirme os dados e Salve o complemento
7. Neste momento serão enviados os valores calculados do Contrato Complementar, fazendo o envio de movimentos junto ao contrato Repom através do método Add Movements, pelo mesmo Id de Contrato Repom relacionado com a viagem TMS em questão. 

15.3 EXCLUSÃO DE CONTRATO DE CARRETEIRO

A exclusão do contrato de carreteiro de uma viagem integrada a operadora de frota Repom pode ter comportamentos diferentes, dada as duas formas de integração hoje disponibilizadas. Vejamos a seguir o comportamento em cada configuração:

IMPOSTOS CALCULADOS PELA REPOM (MV_IMPCTC=1)

Caso o parâmetro MV_IMPCTC=1 e no cadastro Operadora de Frotas   Mom. Quit. Rep (DEG_REPQUI) = 1 - Emissão do Contrato, a exclusão do contrato carreteiro terá comunicação junto a operadora Repom, para viabilizar o cancelamento da Quitação do Contrato Repom. Esta ação dependerá de validações de cancelamento do pagamento do Contrato na operadora Repom.

IMPOSTOS CALCULADOS PELO PROTHEUS (MV_IMPCTC=0)

Caso o parâmetro MV_IMPCTC=0, caso o contrato Repom 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 Repom, o contrato não poderá ser excluído, pois os impostos já foram enviados enviados à Operadora."


Exemplo da mensagem em tela

15.4 PAGAMENTO DE SALDO DO CONTRATO CARRETEIRO

16. LIBERAÇÃO DE CONTRATOS

A rotina Liberação de Contratos (TMSA251) pode ter ou não conexão com a operadora Repom.  É também nesta rotina que será enviado o processo de Autorização de Pagamento no contrato Repom, caso o sistema esteja configurado. 

16.1 LIBERAÇÃO DE CONTRATO COM AUTORIZAÇÃO DE PAGAMENTO REPOM (PAYMENT AUTHORIZATION)

Para utilizar esta funcionalidade, é necessário previamente que esta configuração esteja ativa na conta Repom Frete da transportadora junto a Repom.  No TMS Protheus, deve-se replicar a configuração deste processo através do campo Aut Pagto (DEG_AUTPAG) = 1- SIM 

Há diferenças de utilização da rotina de acordo com a configuração do parâmetro MV_IMPCTC, ao qual veremos abaixo:

Uso da rotina com o parâmetro MV_IMPCTC=0

• Botão Liberar -  Não realiza comunicações com a Repom, efetivando apenas o processo padrão TMS Protheus 
• Botão Estornar Lib - Não realiza comunicações com a Repom, efetivando apenas o processo padrão TMS Protheus

Uso da rotina com o parâmetro MV_IMPCTC=1 + Aut Pagto (DEG_AUTPAG) = 1- SIM

• Botão Liberar -  No momento de liberar o Contrato de Carreteiro, envia uma quitação. Caso esteja configurado Autorização de Pagamento no Protheus e junto a operadora Repom, é enviado no contrato Repom a autorização de pagamento - (envio do método PaymentAuthorization);
  
  
• Botão Estornar Lib - No momento de estornar a Liberação do Contrato Carreteiro, envia estorno de quitação. . Caso esteja configurado Autorização de Pagamento  no Protheus e junto a operadora Repom, será feito o estorno da autorização de pagamento no contrato Repom (PaymentAuthorization/Cancel).

16.2 LIBERAÇÃO DE CONTRATO COM AGENDA FINANCEIRA REPOM

Esta é uma configuração exclusiva da operadora Repom, onde trata-se de um fluxo interno da operadora frente ao repasse do valores de saldo do frete junto ao motorista em janela de pagamentos.

Caso esta configuração esteja ativa nas operações da conta Repom Frete da Transportadora, é necessário no TMS Protheus acessar a rotina Operadora de Frota (TMSAE60) e configurar o campo Usa Agenda(DEG_USAAGE) = 1- Sim

17. PARÂMETROS

• MV_REPTRAC 

• MV_TMSXML 

• MV_VSREPOM = 2.2

• MV_TMSOPDG = 2

• MV_IMPCTC
• MV_LIBCTC
• MV_OPREPOM

18. 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.
• SDG - Movimento de Custo de Transporte.
• DEM - Operadora de Frota X Ações
• DNH - Contratos de Carreteiro Cancelados

19. ASSUNTOS RELACIONADOS

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

• Contrato de Carreteiro.

• Viagem Mod. 2.

• Fechamento da Viagem.

• Operadora X Ações

• Exemplo de Utilização Integração RepomFrete - Impostos calculados Pela REPOM

• Exemplo de Utilização Integração RepomFrete - Impostos calculados Pelo Protheus
• Exemplo de utilização Conciliação Bancária
• Contratos de Carreteiro Cancelados (TMSA250B - SIGATMS)