Histórico da Página
CONTEÚDO
Índice | ||||||
---|---|---|---|---|---|---|
|
01. PRÉ-REQUISITOS
- Configure o parâmetro MV_VSREPOM com conteúdo 2.2 .
- Configure o parâmetro MV_TMSOPDG com conteúdo 2.
- Observe os demais Parâmetros envolvidos na Integração Repom.
Informações | ||||
---|---|---|---|---|
| ||||
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
- Acesse Atualizações > Operadora de Frota > Operadora de Frota (TMSAE60);
Efetue o cadastro da Operadora com base nos dados enviados pela Repom para conexão com o sistema.
- Informe os dados conforme orientação do Help de campo (F1).
- Acesse a aba Cadastrais:
Informe o campo Nome Usuário (DEG_USER) de acordo com informações da Repom.
- Informe o campo Senha (DEG_SENHA) de acordo com informações da Repom.
- Informe o campo URL WS (DEG_URLWS) de acordo com informações da Repom.
- Acesse a aba Outros:
- Informe o campo Mom. Quit. Repom (DEG_REPQUI) de acordo com informações do help de campo.
- Informe o campo Tempo Espera (DEG_TMPESP) de acordo com informações do help de campo.
- 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
- Acesse Atualizações > Operadora de Frota > Operadora de Frota X Ações (TMSAE65);
- Informe os dados conforme orientação de Help de Campo (F1).
- No campo Cod. Operadora (DEM_CODOPE) informe 01 para Repom;
- 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. |
04. CADASTRO DO FORNECEDOR
- Acesse a rotina Atualizações > Cadastro > Fornecedores (MATA020).
- Informe os dados conforme orientação do Help de campo (F1).
- Preencha o campo Razão Social(A2_NOME) de acordo com orientação do Help de campo (F1).
- Preencha o campo N Fantasia(A2_NREDUZ) de acordo com orientação do Help de campo (F1).
- Preencha o campo País (A2_PAIS) de acordo com orientação do Help de campo (F1).
- Preencha o campo Endereço(A2_END) de acordo com orientação do Help de campo (F1).
- Preencha o campo Bairro (A2_BAIRRO) de acordo com orientação do Help de campo (F1).
- Preencha o campo Complemento(A2_COMPLEM) de acordo com orientação do Help de campo (F1).
- Preencha o campo CEP(A2_CEP) de acordo com orientação do Help de campo (F1).
- Preencha o campo Data Nasc. (A2_DTNASC) de acordo com orientação do Help de campo (F1).
- Preencha o campo Tipo (A2_TIPO) de acordo com orientação do Help de campo (F1).
- Preencha o campo CPF/CNPJ (A2_CGC) de acordo com orientação do Help de campo (F1).
- Preencha o campo DDD (A2_DDD) de acordo com orientação do Help de campo (F1) e com no máximo 2 caracteres.
- Preencha o campo Telefone (A2_TEL) de acordo com orientação do Help de campo (F1).
- Preencha o campo Email (A2_EMAIL) de acordo com orientação do Help de campo (F1).
- Preencha o campo RNTRC (A2_RNTRC) de acordo com orientação do Help de campo (F1).
- Preencha o campo Cód. INSS (A2_CODINSS) de acordo com orientação do Help de campo (F1).
- Preencha o campo RG/Ced.Estr.(A2_PFISICA) de acordo com orientação do Help de campo (F1).
- Preencha o campo Ins. Estad. (A2_INSCR) de acordo com orientação do Help de campo (F1).
- Preencha o campo Ins. Municip (A2_INSCRM) de acordo com orientação do Help de campo (F1).
- Preencha o campo Opt Simp Nac (A2_SIMPNAC) de acordo com orientação do Help de campo (F1).
- Preencha o campo RG/Ced.Estr.(A2_PFISICA) de acordo com orientação do Help de campo (F1).
- Confirme a inclusão/atualização cadastral.
- 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
- Acesse a rotina Atualizações > Transporte > Veículos (OMSA060).
- Informe os dados conforme orientações do Help de campo (F1).
- Preencha o campo Placa(DA3_PLACA) de acordo com orientação do Help de campo (F1).
- Preencha o campo Tipo de Veículo(DA3_TIPVEI) de acordo com orientação do Help de campo (F1).
- Preencha o campo Código/Loja Fornecedor(DA3_CODFOR/DA3_LOJFOR) de acordo com orientação do Help de campo (F1).
- Preencha o campo Qtde. Eixos(DA3_QTDEIX) de acordo com orientação do Help de campo (F1).
- Confirme a inclusão/atualização cadastral.
- 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
- Acesse a rotina Atualizações > Transporte > Motorista (OMSA040).
- Informe os dados conforme orientações do Help de campo (F1).
- Preencha o campo Nome(DA4_NOME) de acordo com orientação do Help de campo (F1).
- Preencha o campo CNPJ/CPF(DA4_CGC ) de acordo com orientação do Help de campo (F1).
- Preencha o campo No. CNH(DA4_NUMCNH) de acordo com orientação do Help de campo (F1).
- Preencha o campo País(DA4_PAIS) de acordo com orientação do Help de campo (F1).
- Preencha o campo Bairro(DA4_BAIRRO) de acordo com orientação do Help de campo (F1).
- Preencha o campo Endereço(DA4_END) de acordo com orientação do Help de campo (F1).
- Preencha o campo Telefone(DA4_TEL) de acordo com orientação do Help de campo (F1).
- Preencha o campo Data Nascimento(DA4_DATNAS) de acordo com orientação do Help de campo (F1).
- Confirme a inclusão/atualização cadastral.
- 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
- Acesse a rotina Atualizações > Terceiros > Contrato Fornecedores (TMSA800).
- Informe os dados conforme orientações do Help de campo (F1).
- 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). |
08. PERFIL DO CLIENTE
- Acesse a rotina Atualizações > Comercial > Perfil do Cliente (TMSA480).
- Informe os dados conforme orientações do Help de campo (F1).
- Preencha o campo (Operac. Entrega - DUO_OPEENT) de acordo com orientações do Help de campo (F1).
- Preencha o campo (Operac. Coleta- DUO_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
- Acesse a rotina Atualizações > Logística > Rotas (OMSA100).
- Informe os dados conforme orientações do Help de campo (F1).
- Acesse a aba Rota X Operadoras de Frota (DEK).
- Informe os dados conforme orientações do Help de Campo (F1).
- Os campos Cód. Roteiro (DEK_ROTEIR) e Cód. Perc. (DEK_CODPER) referem-se aos códigos da rota na Repom.
- Caso não possua clique em F3 para exibir a tela de cadastro, para que possa enviar uma requisiçao 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.
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.
- Acesse a rotina Atualizações > Viagens > Viagem Mod. 2 (TMSA144) ou Viagem Mod. 3 (TMSAF60) e clique no botão INCLUIR.
- Informe os dados conforme orientações do Help de campo (F1).
- 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.
- A rota utilizada deve estar corretamente integrada com a Repom;
- O veículo e o proprietário do veículo devem estar corretamente integrados com a Repom;
- O motorista deve estar corretamente integrado com a Repom.
Pedágio
Depois de informado o Código da Operadora na Aba 'Recursos", ao 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 na viagem.
Geração do Contrato na Repom manualmente
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 3, ou Viagem Modelo 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
- Inclua uma viagem;
- Acesse a opção Outras Ações > Operadoras de Frota > Gera
- Inclua uma viagem;
- Acesse a opção Outras Ações > Operadoras de Frota > Incluir Contrato;
- 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 Atualização do Status
- Acesse a opção Outras Ações > Operadoras de Frota > Atualizar Atualiza Status;
- 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;
- Após acionar esse método o sistema irá verificar se o Contrato (Shipping) já foi totalmente processado pela Repom;
- 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;
- 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
- , 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.
- Acesse a opção Outras Ações > Operadoras de Frota >Consulta Status;
- Ao clicar nessa opção, será acionado o método GET /Shipping/ByShipping para apenas realizar uma consulta do Contrato Repom ;
- 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.
- Acesse a opção Outras Ações > Operadoras de Frota >Interrompe Contrato;
- Ao clicar nessa opção, será acionado o método PATCH /Shipping/Interruption;
Caso ocorra algum erro, será exibida mensagem em tela;
Informações | ||||
---|---|---|---|---|
| ||||
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. Demais processos devem ser realizados manualmente. |
Bloqueia Contrato
Acesse a opção Outras Ações > Operadoras de Frota >Bloqueia Contrato;
- Ao clicar nessa opção, será acionado o método PATCH /Shipping/lockUnlock;
- Caso ocorra algum erro, será exibida mensagem em tela;
Desbloqueia Contrato
- Acesse a opção Outras Ações > Operadoras de Frota >Desbloqueia Contrato;
- Ao clicar nessa opção, será acionado o método PATCH /Shipping/lockUnlock;
- Caso ocorra algum erro, será exibida mensagem em tela;
Cancela Contrato
- Acesse a opção Outras Ações > Operadoras de Frota >Cancela Contrato;
- Ao clicar nessa opção, será acionado o método PATCH /Shipping/Cancel;
- Caso ocorra algum erro, será exibida mensagem em tela;
Conciliação Financeira
- Acesse a opção Outras Ações > Operadoras de Frota >Conciliação Financeira;
- 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 | ||||
---|---|---|---|---|
| ||||
Também é possível configurar esta opção para execução de forma automática. A emissão automática do contrato de carreteiro dependerá de configurações exclusivas que a integração oferece. |
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”Emissão de Contrato/Viagem (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 o numero do Contrato e preenchendo no campo N.o Proc. Transp. (DTR_PRCTRA/DM5_PRCTRA) e o numero 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. 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. RepQuit. Qui Repom (DEG_REPQUI)) está 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 na contrato Repom ficará como "Pago(Paid"), caso contrário como "Quitado(Cleared"). Estando Quando o contrato com status "Cleared" o possuir status Quitado(Cleared) o SIGATMS executará o método "PaymentAuthorization" Autorização de Pagamento (PaymentAuthorization). Uma vez autorizado, o status será alterado para "Paid"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.
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. |
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 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
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 3
Contrato de Carreteiro.
Viagem Modelo 2.
Fechamento da Viagem.
- Operadora X Ações
- Exemplo de Utilização Integração RepomFrete - Impostos calculados Pelo Protheus
- Exemplo de utilização Conciliação Bancária
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> |