Histórico da Página

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. Observe os demais Parâmetros envolvidos na Integração Repom.
   
   

02. CADASTRO DE OPERADORA 

1. Acesse Atualizações > Operadora de Frota > Operadora de Frota (TMSAE60);

2. Efetue o cadastro da Operadora com base nos dados enviados pela Repom para conexão com o sistema.

3. Informe os dados conforme orientação do Help de campo (F1).
4. Acesse a aba Cadastrais:

   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.
5. Acesse a aba Outros:
   
   1. Informe o campo Mom. Quit. Repom (DEG_REPQUI) de acordo com informações do help de campoconforme a configuração mais adequada ao processo da empresa. Opção 1 - Quitação pela emissão do Contrato Carreteiro . Opção 2 - Quitação pelo Encerramento da Viagem.

Informe o campo Tempo Espera (DEG_TMPESP)

1. Acesse a opção Outras Ações → Operac. para incluir as Operações da Operadora de Frota. (DEJ)
   Esse cadastro será utilizado no Contrato do Fornecedor e ou Perfil do Cliente para informar a Operação de Frota.

03. OPERADORA DE FROTA X AÇÕES

1. Acesse Atualizações > Operadora de Frota > Operadora de Frota X Ações (TMSAE65);
2. Informe os dados conforme orientação de Help de Campo (F1).
3. No campo Cod. Operadora (DEM_CODOPE) informe 01 para Repom;
4. No campo Tipo Movto. (DEM_TIPMOV)  informe E-ENVIO para o envio das informações a partir do Protheus;
   
   

04. CADASTRO DO FORNECEDOR

1. Acesse a rotina Atualizações > Cadastro > Fornecedores (MATA020).
2. Informe os dados conforme orientação do Help de campo (F1).
3. Os campos abaixo são utilizados diretamente na integração com a Repom, demais campos devem ser preenchidos conforme necessidade do cliente.
   1. Razão Social(A2_NOME).
   2. N Fantasia(A2_NREDUZ).
   3. País (A2_PAIS) de acordo com orientação do Help de campo (F1) .
   4. Endereço(A2_END) de acordo com orientação do Help de campo (F1) .
   5. Bairro (A2_BAIRRO) de acordo com orientação do Help de campo (F1)..
   6. Complemento(A2_COMPLEM) de acordo com orientação do Help de campo (F1) .
   7. CEP(A2_CEP) de acordo com orientação do Help de campo (F1) .
   8. Data Nasc. (A2_DTNASC) de acordo com orientação do Help de campo (F1) .
   9. Tipo (A2_TIPO) de acordo com orientação do Help de campo (F1) .
   10. CPF/CNPJ (A2_CGC) de acordo com orientação do Help de campo (F1) .
   11. DDD (A2_DDD) de acordo com orientação do Help de campo (F1) e com no máximo 2 caracteres.
   12. Telefone (A2_TEL) de acordo com orientação do Help de campo (F1).Email .
   13. Email ((A2_EMAIL) de acordo com orientação do Help de campo (F1) .
   14. RNTRC (A2_RNTRC) de acordo com orientação do Help de campo (F1) .
   15. Cód. INSS (A2_CODINSS) de acordo com orientação do Help de campo (F1) .
   16. RG/Ced.Estr.(A2_PFISICA) de acordo com orientação do Help de campo (F1) .
   17. Ins. Estad.  (A2_INSCR) de acordo com orientação do Help de campo (F1) .
   18. Ins. Municip (A2_INSCRM) de acordo com orientação do Help de campo (F1)..
   19. Opt Simp Opt Simp Nac (A2_SIMPNAC) de acordo com orientação do Help de campo (F1) .
   20. RG/Ced.Estr.(A2_PFISICA) de acordo com orientação do Help de campo (F1) .
4. Confirme a inclusão/atualização cadastral.
5. Acesse a opção Outras Opções → Dados x Operad. para cadastrar/atualizar os dados no sistema Repom Frete.
   
   

05. CADASTRO DO VEÍCULO

1. Acesse a rotina Atualizações > Transporte > Veículos (OMSA060).
2. Informe os dados conforme orientações do Help de campo (F1).
3. Preencha o campo Placa(DA3_PLACA) de acordo com orientação do Help de campo (F1) .
4. Preencha o campo Tipo de Veículo(DA3_TIPVEI) de acordo com orientação do Help de campo (F1) .
5. Preencha o campo Código/Loja Fornecedor(DA3_CODFOR/DA3_LOJFOR) de acordo com orientação do Help de campo (F1) .
6. Preencha o campo Qtde. Eixos(DA3_QTDEIX) de acordo com orientação do Help de campo (F1)..
7. Confirme Confirme a inclusão/atualização cadastral.
8. Acesse a opção Outras Opções → Dados x Operad. para atualizar os dados no sistema Repom Frete.
   
   

06. CADASTRO DO MOTORISTA

1. Acesse a rotina Atualizações > Transporte > Motorista (OMSA040).
2. Informe os dados conforme orientações do Help de campo (F1).
3. Preencha o campo Nome(DA4_NOME) de acordo com orientação do Help de campo (F1) .
4. Preencha o campo CNPJ/CPF(DA4_CGC ) de acordo com orientação do Help de campo (F1) .
5. Preencha o campo No. CNH(DA4_NUMCNH) de acordo com orientação do Help de campo (F1) .
6. Preencha o campo País(DA4_PAIS) de acordo com orientação do Help de campo (F1) .
7. Preencha o campo Bairro(DA4_BAIRRO) de acordo com orientação do Help de campo (F1) .
8. Preencha o campo Endereço(DA4_END) de acordo com orientação do Help de campo (F1).Preencha o .
9. Preencha o campo campo Telefone(DA4_TEL) de acordo com orientação do Help de campo (F1) .
10. Preencha o campo Data Nascimento(DA4_DATNAS) de acordo com orientação do Help de campo (F1) .
11. Confirme a inclusão/atualização cadastral.
12. Acesse a opção Outras Opções → Dados x Operad. para atualizar os dados no sistema Repom Frete.
    
    

07. CONTRATO DO FORNECEDOR

1. Acesse a rotina Atualizações > Terceiros > Contrato Fornecedores (TMSA800).
2. Informe os dados conforme orientações do Help de campo (F1).
3. Preencha o campo do grid Operac. Frota(DVG_OPERAC) de acordo com orientações do Help de campo (F1).
   
   

08. PERFIL DO CLIENTE

1. Acesse a rotina Atualizações > Comercial > Perfil do Cliente (TMSA480).
2. Informe os dados conforme orientações do Help de campo (F1).
3. Preencha o campo (Operac. Entrega - DUO_OPEENT) de acordo com orientações do Help de campo (F1).
4. Preencha o campo (Operac. Coleta- DUO_OPECOL) de acordo com orientações do Help de campo (F1).
   
   

09. CADASTRO DE ROTA

1. Acesse a rotina Atualizações > Logística > Rotas  (OMSA100).
2. Informe os dados conforme orientações do Help de campo (F1).
3. Acesse a aba Rota X Operadoras de Frota (DEK).
4. Informe os dados conforme orientações do Help de Campo (F1).
5. Os campos Cód. Roteiro (DEK_ROTEIR) e Cód. Perc. (DEK_CODPER) referem-se aos códigos da rota na Repom.
   1. Caso não possua clique em F3 para exibir a tela de cadastro, para que possa enviar uma requisição de rota para a Repom.

Existe a consulta ao Roteiro, baseada obrigatoriamente na região de origem e destino, onde associa-se o Roteiro selecionado à rota. 

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. Nessa nova versão  que diferencia é chamada do método que é através do "POST/RouteRequest" .  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.

A consulta aos roteiros tem que ser utilizada novamente para associação após a inclusão do Roteiro pela Repom.

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

A integração com a Repom está disponível nas funcionalidades viagem modelo 2 e viagem modelo emissão do Contrato Repom será enviado somente no Fechamento de uma viagem de entrega/transporte modelo 2 e Viagem Mod. 3. 

Foi disponibilizada a opção de realizar manualmente, a integração  com a Repom através do menu Outras Ações > Operadoras de Frota > Repom.   

Na opção manual é possível realizar o envio do Contrato, Consultar Status, Atualizar o Status, Interromper o Contrato, Bloquear/Desbloquear o Contrato e Cancelar o Contrato. 

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).
   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.
   
   Operadora de Frota
   Acesse a opção Complemento de Viagem através do botão Outras Ações 
4. Acesse a rotina Atualizações > Viagens > Viagem Mod. 2 (TMSA144) ou Viagem Mod. 3 (TMSAF60) e clique no botão INCLUIR.
5. Informe os dados conforme orientações do Help de campo (F1).
6. Na aba Operadoras de Frota do Complemento da Viagem para Viagem Mod. 2 ou Na aba Recursos > Operadoras de Frota para  para Viagem Mod. 3 informe , acesse a aba Operadoras e informe no campo Cod. Operad. (DTR_CODOPE/DM5_CODOPE), a operadora de frota 01-Repom.
   
7. A rota utilizada deve estar corretamente integrada com a Repom;
8. O veículo e o proprietário do veículo devem estar corretamente integrados com a Repom;
9. O motorista deve estar corretamente integrado com a Repom. 
10. 
    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). 
    
    Motorista
    Informe um motorista Repom previamente integrado para a viagem em Outras Opções → Mot.Viag (Viagem Mod.2) ou aba Motoristas (Viagem Mod. 3).
    
    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

1. selecionada na viagem. Caso o cálculo do pedágio seja efetuado com sucesso pela Repom, será atualizado o campo Pedagio(DTR_VALPDG).
   
   Valor de Frete
   Preencha um valor de frete a pagar de frete através do campo Frete (DTR_VALFRE).
   
   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).

Exemplo de preenchimento dos dados na aba Complemento de Viagem (Viagem Mod.2)
Image Added


Exemplo de preenchimento dos dados na aba Recursos (Viagem Mod. 3)
Image Added

OPÇÕES MANUAIS OPERADORA DE FROTA REPOM (Nova funcionalidade)
Opções exclusivas desta nova integração, foi criada a nova opção através do botão Outras Ações → Repom, cujo objetivo destas ações é um melhor gerenciamento dos processos envolvidos em uma viagem do Totvs Logística TMS x Repom. Ou seja, o usuário poderá realizar estas ações sem a necessidade de acessar o portal Repom para realizar tais atividades. 

Disponível através da Viagem Modelo Mod. 3, ou Viagem Modelo 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.

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;

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

Bloqueia Contrato

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

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

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

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.
   
   

08. FECHAMENTO DE VIAGEM 

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) Emissão de Contrato/Viagem (ShippingCreate). Para realizar o Fechamento da Viagem, é possível realizar o fechamento diretamente pelas rotinas de viagem mod.3 e Viagem Mod.2.  Para ambas rotinas , 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. 
O tempo de espera, definirá o tempo 'em segundos' em que o sistema SIGATMS ficará aguardando a resposta da REPOM, caso não ocorra o retorno no prazo estimado, a viagem não será fechada.

Estorno do Fechamento / Cancelamento do Contrato Repom
Ao efetuar uma operação de estorno do Fechamento da viagem, será acionado o método “ShippingCancel” para cancelamento do Contrato Repom emitido previamente no Fechamento da viagem. 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:

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

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"

De acordo com a parametrização de geração do título (MV_LIBCTC e DUJ_TITFRE), será quitado o contrato Repom, através do método "Shipping/Payment".

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). Quando o contrato 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).

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.

10. CUSTO DE TRANSPORTE

As despesas lançadas na rotina irão complementar o contrato vigente caso a viagem a ser complementada com valores, possuas a integração e o respectivo contrato na Repom. Será acionado o método AddMovement, o qual irá realizar a movimentação de valores no contrato da Repom. 

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".
Para realizar o lançamento de movimentações junto a viagem, acesse Atualizações > Transportes → Movimento Custo Transp. (TMSA070)

11. ENCERRAMENTO DE VIAGEM

 Após apontar todas as Operações da Viagem e apontar Ocorrência para todos os documentos inseridos na viagem, novamente na rotina de Viagem Modelo 3 ou Viagem de Entrega Mod.2 , clique no botão OUTRAS AÇÕES → Manutenção →Encerramento → Encerrar. 

De acordo com a configuração do campo "momento de quitação do contrato na Repom" (DEG_REPQUI), se configurado como "Encerramento da Viagem", o

contrato  será quitado o contrato na  REPOM através do método "Shipping/Payment" quando ocorrer o encerramento da viagem.

12. PARÂMETROS

• MV_REPTRAC

• MV_TMSXML

• MV_VSREPOM

• MV_TMSOPDG=2
• MV_IMPCTC
• MV_LIBCTC
• MV_OPREPOM

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

14. ASSUNTOS RELACIONADOS

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

• Contrato de Carreteiro.

• Viagem Modelo 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
  
  

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