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

  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 campo.
    2. Informe o campo Tempo Espera (DEG_TMPESP) de acordo com informações do help de campo.
  6. 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;

Informações

Esse cadastro será utilizado para vincular o código de movimento Repom com o código de movimento Protheus durante uma inclusão de movimentos de crédito ou débito. 
Para maiores informações acesse: Operadora X Ações.

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. Preencha o campo Razão Social(A2_NOME) de acordo com orientação do Help de campo (F1).
  4. Preencha o campo N Fantasia(A2_NREDUZ) de acordo com orientação do Help de campo (F1).
  5. Preencha o campo País (A2_PAIS) de acordo com orientação do Help de campo (F1).
  6. Preencha o campo Endereço(A2_END) de acordo com orientação do Help de campo (F1).
  7. Preencha o campo Bairro (A2_BAIRRO) de acordo com orientação do Help de campo (F1).
  8. Preencha o campo Complemento(A2_COMPLEM) de acordo com orientação do Help de campo (F1).
  9. Preencha o campo CEP(A2_CEP) de acordo com orientação do Help de campo (F1).
  10. Preencha o campo Data Nasc. (A2_DTNASC) de acordo com orientação do Help de campo (F1).
  11. Preencha o campo Tipo (A2_TIPO) de acordo com orientação do Help de campo (F1).
  12. Preencha o campo CPF/CNPJ (A2_CGC) de acordo com orientação do Help de campo (F1).
  13. Preencha o campo DDD (A2_DDD) de acordo com orientação do Help de campo (F1) e com no máximo 2 caracteres.
  14. Preencha o campo Telefone (A2_TEL) de acordo com orientação do Help de campo (F1).
  15. Preencha o campo Email (A2_EMAIL) de acordo com orientação do Help de campo (F1).
  16. Preencha o campo RNTRC (A2_RNTRC) de acordo com orientação do Help de campo (F1).
  17. Preencha o campo Cód. INSS (A2_CODINSS) de acordo com orientação do Help de campo (F1).
  18. Preencha o campo RG/Ced.Estr.(A2_PFISICA) de acordo com orientação do Help de campo (F1).
  19. Preencha o campo Ins. Estad.  (A2_INSCR) de acordo com orientação do Help de campo (F1).
  20. Preencha o campo Ins. Municip (A2_INSCRM) de acordo com orientação do Help de campo (F1).
  21. Preencha o campo Opt Simp Nac (A2_SIMPNAC) de acordo com orientação do Help de campo (F1).
  22. Preencha o campo RG/Ced.Estr.(A2_PFISICA) de acordo com orientação do Help de campo (F1).
  23. Confirme a inclusão/atualização cadastral.
  24. Acesse a opção Outras Opçõ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

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

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

  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).
  9. Preencha o 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.

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

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

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

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. ColetaDUO_OPECOL) de acordo com orientações do Help de campo (F1).

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 para viagens do tipo 3=Vazia.


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çao 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. 

        Assim como a operação de transporte, as informações referente ao Roteiro/Percurso da viagem são enviadas no momento da emissão de um contrato e no cálculo do pedágio na 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. 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. VIAGEM MOD. 2 e VIAGEM MOD. 3

A integração com a Repom está disponível nas funcionalidades viagem modelo 2 e viagem modelo 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. 


  1. Acesse a rotina Atualizações > Viagens > Viagem Mod. 2 (TMSA144) ou Viagem Mod. 3 (TMSAF60).
  2. Informe os dados conforme orientações do Help de campo (F1).
  3. Na aba Operadoras de Frota do Complemento da Viagem para Viagem Mod. 2 ou Na aba Recursos > Operadoras de Frota para Viagem Mod. 3 informe a operadora de frota 01-Repom.
  4. A rota utilizada deve estar corretamente integrada com a Repom;
  5. O veículo e o proprietário do veículo devem estar corretamente integrados com a Repom;
  6. O motorista deve estar corretamente integrado com a Repom. 


Pedágio
Depois de informado o Código da Operadora na Aba 'Recursos", ao informar o veículo da viagem, será acionado o método "Route/ByRouteCode" para o cálculo do Pedágio referente à rota selecionada na  viagem.


Geração do Contrato na Repom manualmente

  1. Inclua uma viagem;
  2. Acesse a opção Outras Ações > Operadoras de Frota > Incluir 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;


Atualização do Status

  1. Acesse a opção Outras Ações > Operadoras de Frota > Atualizar Status;
  2. Ao clicar nessa opção, será acionado o método GET - /Shipping/StatusProcessing/ByIdentifier;
  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

  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;
  3. Será exibida em tela as informações retornadas pelo método;


Interrompe Contrato

  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;

Informações
iconfalse
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. Demais processos devem ser realizados manualmente.



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.

Informações
iconfalse
titleIMPORTANTE!

Também é possível configurar esta opção para execução de forma automática. Para maiores informações, acesse a documentação Exemplo de utilização Conciliação Bancária.


08.
FECHAMENTO DE VIAGEM 

A emissão do contrato na Repom é o inicio do controle de um processo para a frota de terceiros.

No SIGATMS, a emissão do contrato na Repom será processada no Fechamento da viagem, em que será acionado automaticamente o método “ShippingCreate”.  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 (DTR_PRCTRA/DM5_PRCTRA)  e o numero 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. 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 fechamento da viagemencerramento da viagem quando a configuração de momento de quitação do Contrato Repom no cadastro de Operadoras de Frota Mom.Rep.Qui (DEG_REPQUI) está configurado = 1 - Contrato.

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, 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 na Repom ficará como "Paid", caso contrário como "Cleared". Estando o contrato com status  "Cleared" o SIGATMS executará o método "PaymentAuthorization". Uma vez autorizado, o status será alterado para "Paid".

O estorno da Autorização de Pagamento é efetuado através do método "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. MOVIMENTAÇÕES


Aviso

Esta rotina poderá ter comportamentos diferentes, mediamente 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 esteja configurado =2 - Encerramento da Viagem e o parâmetro MV_IMPCTC=0 - Impostos Calculados Pelo Protheus, a rotina Contrato de Carreteiro não comunicará com a Operadora de Frota, pois neste processo o Contrato de Carreteiro passará a ser uma pré condição para a emissão do Contrato Repom. Para maiores informações sobre, acesse Exemplo de Utilização Integração RepomFrete - Impostos calculados Pela REPOM .




10. MOVIMENTAÇÕES

Depois que o contrato é emitido na Repom, todos os tipos de créditos e débitos que poderão ocorrer durante a 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".


11. ENCERRAMENTO DE VIAGEM

        De acordo com a configuração do campo "momento de quitação do contrato na Repom" (DEG_REPQUI), se configurado como "Encerramento da Viagem" e o parâmetro MV_LIBCTC = .F. , 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


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>