Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Tempo aproximado para leitura: 20 min

CONTEÚDO

Índice
exclude.*CONTEÚDO
stylenone
separatornone

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 para gravar a troca de informações Json entre o Protheus e a Operadora Repom 

Informações
iconfalse
titleIMPORTANTE!

A integração Repom 2.2 tem como premissa que as informações terão origem no Totvs Protheus SIGATMS, e consequentemente as movimentações devem ser realizadas à partir do SIGATMS pois a Repom não enviará informações, e sim receberá as informações do SIGATMS.

02. CADASTRO DE OPERADORA 

Realize o relacionamento do cadastro da Operadora Repom. O objetivo deste cadastro é 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.  Foram criados dois novos campos nesta aba:
    a. Mom.Quit.Repom(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.

          
           Novos campos Mom.Quit.Repom e Tempo Espera na aba Outros

  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 a operação Repom retornada pela operadora de Frota.

  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. Acesse Outras Ações → Teste Comunicação REPOM  para validar os dados de conexão junto a operadora 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(TMSA060) 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

Informações

Para maiores informações acesse: Operadora X Ações

04. CADASTRO DO FORNECEDOR

O cadastro do fornecedor Protheus é utilizado para criação e atualização dos prestadores Repom na plataforma Repom Frete. Para a troca de informações entre os sistemas, é necessário o preenchimento dos campos abaixo.

Para adequar os campos necessários, acesse a rotina Atualizações -> Cadastro -> Fornecedores (MATA020), e clique no botão INCLUIR  ou ALTERAR. Preencher todos os campos abaixo:

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

Informações

Após a confirmação do processo será criado um Hired na Repom, que é o nome dado para aos contratados.

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. Acesse a opção Outras Ações  → Dados x Operad. para atualizar os dados no sistema Repom Frete.

Informações

Após a confirmação do processo será criado um Vehicle na Repom, que é o nome dado aos veículos dos contratados.

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. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
  13. Confirme a inclusão/atualização cadastral.
  14. Acesse a opção Outras Ações  → Dados x Operad. para atualizar os dados no sistema Repom Frete.

Informações

Após a confirmação do processo será criado um Driver na Repom, que é o nome dado para os motoristas.

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. Preencher todos os campos abaixo
  2. Preencha o campo do grid Operac. Frota(DVG_OPERAC) 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.


    Exemplo de utilização do campo Operac. Frota no contrato do Fornecedor

    Informações

    Esse campo é utilizado para identificar o código e tipo de operação (Operation Identifier) ao criar o Contrato Repom (Fechamento da Viagem). 
    Quando no Contrato do Fornecedor não estiver informada a Operação de Frota através do campo Operac. Frota(DVG_OPERAC) , o sistema buscará a informação no Perfil do Cliente(TMSA480) devedor do Frete do documento relacionado na viagem, através do campo Oper Entrega (DUO_OPEENT). 

  3. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
  4. 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

    Informações

    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 situações onde o Roteiro não existir, a funcionalidade para a solicitação de Roteiro na Repom permanece conforme versão anterior, ou seja, a partir do cadastro de Rotas. 
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.
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. 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
  5. No campo Frota (DEK_FROVEI), selecione a opção desejada. 

    Informações

    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.

  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. Os demais campos da rotina deverão ser preenchidos conforme a necessidade da empresa.
  8. Confirme a inclusão/atualização cadastral.
  9. Após a confirmação de inclusão de Roteiro na Operadora Repom, consulte novamente o Roteiro na mesma rota do TMS para realizar o vínculo entre os sistemas.

   

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 a criação de uma viagem 
Image Modified

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.

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

    b.Veículo
    No Grid das rotinas em questão, vincule o veículo previamente cadastrado e integrado com a Repom através do campo Cod.Veiculo(DTR_CODVEI). 

    c.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).

    d.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).

    e.Valor de Frete
    Preencha um valor de frete a pagar de frete através do campo Frete (DTR_VALFRE).

    f.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).

  1. Viagem Mod. 2

    Exemplo de preenchimento dos dados na aba Complemento de Viagem (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)


    Exemplo de preenchimento dos dados do motorista (Viagem Mod.3)

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

Informações
titleValidações Repom

O cálculo do pedágio e confirmação da viagem TMS dependerá de validações exclusivas da operadora Repom, ao qual irá conferir as informações válidas como Roteiro, Fornecedor, Veículo e Motorista associados na viagem.


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 . É o inicio do controle de um processo para a frota de terceiros, após incluída a viagem Tms x Repom.

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

Image Modified




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

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 no grid da tela, 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 Totvs Logística TMS.
  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 Repom originado de uma viagem do Totvs Logística TMS;
  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) 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 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. Caso ocorra algum erro, será exibida mensagem em tela.

Aviso
titleImportante

Ao interromper o contrato na Repom, será consultado o valor de movimentação que o motorista realizou. O valor de adiantamento será baixado parcialmente, de acordo com o consumo do motorista.
Sendo assim, o título do tipo PA referente aos valores de adiantamento, terão sua baixa parcial. 


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


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

Informações

A emissão automática do contrato de carreteiro dependerá de configurações exclusivas que a integração oferece.
Para maiores informações, acesse a documentação Exemplo de utilização Conciliação Bancária.


14. ENCERRAMENTO DA VIAGEM 

O encerramento da viagem concluirá o processo de viagem Repom.
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 Repom.
O encerramento da viagem só será efetuado mediante as validações padrões do SIGATMS, bem como validações da Operadora Repom em relação ao Contrato de frete emitido. 
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. 

De acordo com a configuração do campo Mom. Quit. Repom (DEG_REPQUI) localizado na aba Outros da rotina Operadoras de Frota(TMSAE60), se configurado com a opção "2-Encerramento da Viagem", o contrato Repom será quitado o contrato na  REPOM 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 Repom.

15. CONTRATO DE CARRETEIRO

O contrato de carreteiro será gerado apenas após o encerramento da viagem quando a configuração de momento de quitação do Contrato Repom no cadastro de Operadoras de Frota Mom. Quit. Repom (DEG_REPQUI)) configurado = 1 - Contrato - Quitação do Contrato Repom pela emissão do Contrato de Carreteiro.

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


EMISSÃO DE CONTRATO DE CARRETEIRO
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.

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 Repom através do método “Shipping/AddMovement".

Aviso
titleAviso - Mudança de comportamento na rotina

Esta rotina poderá ter comportamentos diferentes para o envio da quitação do contrato Repom, mediante a configuração do campo Mom. Quit. Repom (DEG_REPQUI) localizado na aba Outros da rotina Operadoras de Frota e o parâmetro (SX6) MV_IMPCTC.

Caso o campo Mom. Quit. Repom (DEG_REPQUI) esteja configurado =2 - Encerramento da Viagem e o parâmetro MV_IMPCTC=0 - Impostos Calculados Pelo Protheus, a rotina Contrato de Carreteiro realizará seus controles padrões do SIGATMS, porém não comunicará com a Operadora de Frota REPOM na emissão do Contrato de Carreteiro, pois neste processo o Contrato de Carreteiro será uma pré condição para a emissão do Contrato Repom.

Para maiores informações sobre este comportamento, acesse 
Exemplo de Utilização Integração RepomFrete - Impostos calculados Pela REPOM .


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 Repom será através da rotina Liberação de Contratos.  Desta forma, a emissão do Contrato de Carreteiro não irá comunicar com a Repom. 

Portanto, para esta configuração, após emitir o Contrato de Carreteiro de uma viagem TMS x REPOM,  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 REPOM 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 Repom, através do método "Shipping/Payment".

    Informações
    titleCampo Ger.Tit. Fre - Contrato do Fornecedor

    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 Repom, pois nesta configuração o contrato Repom 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 Repom.
Foi criada uma validação especial para o processo de integração TMS x REPOM quando cálculo dos impostos é de responsabilidade do Protheus (MV_IMPCTC=0), e 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


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

  • Autorização de Pagamento Repom (PaymentAuthorization)
    Esta funcionalidade será acionada somente quando no Portal Repom, a empresa configurar o processo de agendamento de pagamentos. Portanto, quando o contrato Repom 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 REPOM, o status do contrato Repom 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 Repom segue regras específicas que podem interferir no seu cancelamento. Caso não seja possível cancelar o contrato na Repom, o cálculo do contrato no SIGATMS também não é cancelado.


16. PARÂMETROS

  • MV_REPTRAC 

  • MV_TMSXML 

  • MV_VSREPOM 

  • MV_TMSOPDG

  • MV_IMPCTC
  • MV_LIBCTC
  • MV_OPREPOM

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

18. ASSUNTOS RELACIONADOS

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