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.
02. CADASTRO DE OPERADORA
Em Operadora de Frota, 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 Branch Repom (DEG_BRANCH) de acordo com informações da Repom.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.
03. CADASTRO DO FORNECEDOR
- Em Fornecedores, cadastre um novo fornecedor ou utilize um preexistente.
- 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.
04. CADASTRO DO VEÍCULO
O cadastro do veículo pode ser realizado na rotina Veículos.
- Em Veículos, cadastre ou utilize um preexistente.
- 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.
05. CADASTRO DO MOTORISTA
O cadastro do cartão pode ser realizado na rotina Motoristas.
- Em Motoristas, cadastre ou utilize um preexistente.
- 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.
06. CADASTRO DE ROTA
No Cadastro de Rotas (OMSA100) 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.
07. VIAGEM MOD. 3
A integração com a Repom na viagem modelo 3, está disponível somente para a versão Repom Frete (MV_VSREPOM = 2.2)
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.
Pedagio
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.
Informações |
---|
A integração utiliza a plataforma Repom Frete, através da tecnologia Web API. |
Geração do Contrato na Repom manualmente
- 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;
Atualização do Status
- Acesse a opção Outras Ações > Operadoras de Frota > Atualizar Status;
- Ao clicar nessa opção, será acionado o método GET - /Shipping/StatusProcessing/ByIdentifier;
- 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 DTR_PRCTRA e 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 DEG_TMPESP - Tempo de Espera, no Cadastro de Operadora.
Consulta Status
- 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;
- Será exibida em tela as informações retornadas pelo método;
Interrompe Contrato
- 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;
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;
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 como "Tempo de Espera" 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.
Ao efetuar uma operação de estorno do Fechamento é acionado o método “ShippingCancel”. O cancelamento do contrato na Repom segue regras específicas que podem interferir no seu cancelamento
09. CONTRATO DE CARRETEIRO
O contrato de carreteiro será gerado apenas após o fechamento da 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"
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
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. MÉTODOS
Método Repom | Método Totvs | Descrição |
---|---|---|
GET /AnttTypes/LoadTypes | GetLoadTypes() | Recupera um GetLoadTypes |
POST /token | Auth() | Obtém Token |
POST /Driver | DriverCreate() | Cria um novo driver |
PUT /Driver/{country}/{nationalId} | DriverUpdate() | Atualiza o motorista |
PATCH /Driver/lockUnlock/{country}/{nationalId} | DriverLock() | Atualiza o motorista |
GET /Driver/ByName/{name} | GetDrvrByName() | Recuperar motoristas por nome |
GET /Driver/ByDocument/{country}/{nationalId} | GetDrvrByDoc() | Recupera um motorista por número de identificação de documento |
POST /Hired | HiredCreate() | Cria um novo contratado |
PUT /Hired/{country}/{nationalId} | HiredUpdate() | Atualiza um novo contratado |
PATCH /Hired/lockUnlock/{country}/{nationalId} | HiredLock() | Bloquear ou desbloquear contratado |
GET /Hired/ByName/{name} | GetHrdByName() | Recupera contratados pelo nome |
GET /Hired/ByDocument/{country}/{nationalId} | GetHrdByDoc() | Recupera um contratado por número de identificação de documento |
POST /Vehicle | VehicleCreate() | Cria um novo veículo |
PUT /Vehicle/{country}/{license} | VehicleUpdate() | Atualiza um veículo |
PATCH /Vehicle/{country}/{license} | VehicleLock() | Trancar ou destrancar o veículo |
GET /Vehicle/ByDocument/{country}/{license} | GetVeicByDoc() | Recupera um veículo por licença |
POST /RouteRequest | RouteCreate() | Cria uma solicitação de rota |
GET /Route/ByCEP/{cep}/{toCep}/{vehicleAxles} | GetRtByCEP() | Recupera uma rota |
GET /Route/ByIBGE/{IBGECode}/{toIBGECode}/{vehicleAxles} | GetRtByIBGE() | Recupera uma rota |
GET /Route/ByTraceIdentifier/{traceIdentifier}/{vehicleAxles} | GetRtByTrcId() | Recupera uma rota |
GET /Route/ByRouteCode/{traceCode}/{routeCode}/{vehicleAxles} | GetByRtCode() | Recupera uma rota |
GET /RouteRequest/{traceIdentifier} | GetRtRequest() | Recupera uma solicitação de rota por id |
POST /Shipping | ShippingCreate() | Solicite um novo frete |
PATCH /Shipping/AddDocument/{shippingId} | ShippingDocAdd() | Adicionar documento de envio |
PATCH /Shipping/AddMovement/{shippingId} | ShippingMovAdd() | Adicionar movimento de envio |
PATCH /Shipping/Cancel/{id} | ShippingCancel() | Cancelar frete |
PATCH /Shipping/lockUnlock/{shippingId} | ShippingLock() | Bloquear ou desbloquear um frete |
PATCH /Shipping/Interruption/{id} | ShippingInter() | Interrupção de envio |
GET /Shipping/ByShipping/{shippingId} | GetShipByShip() | Recupera um frete por shippingId |
GET /Shipping/ByIdentifier/{identifier} | GetShipById() | Recupera um frete por identificador |
GET /Shipping/StatusProcessing/ByIdentifier/{id} | GetShipStPrcBy() | Recupera uma lista de embarques por código do cliente |
POST /ShippingPayment | PaymentCreate() | Envio de pagamento |
PATCH /ShippingPayment/Cancel/{shippingID} | PaymentCancel() | Cancelamento de pagamento de envio |
PATCH /ShippingPayment/DocumentLost/{shippingID} | PaymLostDoc() | Documento perdido |
PATCH /ShippingPayment/DocumentReship/{shippingID} | PaymReshipDoc() | Documento de reenvio |
PATCH /ShippingPayment/DocumentDelivered/{shippingID} | PaymDeliverDoc() | Documento entregue |
PATCH /ShippingPayment/DocumentDismissed/{shippingID} | PaymDismisDoc() | Dispensa documento |
GET /ShippingValidation/ByVehicles/{vehicles} | GetShipVeicVld() | Veículos validados para novo envio |
GET /ShippingValidation/ByHiredDocument/{country}/{document} | GetShipHiredVld() | Contratado Validar para novo envio |
POST /PaymentAuthorization | AuthorizationCreate() | Envia uma autorização de pagamento |
PATCH /PaymentAuthorization/Cancel | AuthCancel() | Cancelar uma autorização de pagamento |
GET /PaymentAuthorization/ByShippingId/{shippingId} | GetPayAutShip() | Recupera uma autorização de pagamento por shippingId |
GET /Card/GetActiveCardsByHired/{HiredNationalID} | GetCardHired() | Recupera ActiveCard |
GET /Card/GetActiveCardsByDriver/{DriverNationalID} | GetCardDriver() | Recupera ActiveCard |
GET /Card/GetActiveCardsByHiredAndByDriver/{HiredNationalID}/{DriverNationalID} | GetCardDvrHrd() | Recupera ActiveCard |
GET /VPR/TollList/ByShippingIdentifier/{shippingIdentifier} | GetVPR() | Recupera TollList por shippeingIdentifier |
GET /ShippingFuelBenefit/GetLinkByCardNumber/{cardNumber} | GetFuelbyCard() | Recupera o título do FuelBenefits pelo número do cartão |
GET /Operation | GetOperation() | Recupera operações |
GET /Operation/ByIdentifier/{operationIdentifier} | GetOperById() | Recupera operações por identificador |
GET /Movement/GetMovement | GetMovement() | Retorna movimentações dos clientes |
13. PARÂMETROS
MV_REPTRAC
MV_TMSXML
MV_VSREPOM
- MV_TMSOPDG=2
14. 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.
15. FONTES UTILIZADOS
OMSA040 - Cadastro de Motorista
OMSA060 - Cadastro de Veiculos
OMSA100 - Cadastro de Rotas
TMSA070 - Movimento de Custo de Transporte
TMSA141 - Geração de Viagem
TMSA144 - Viagem Mod. 2
TMSA240 - Complemento de Viagem
TMSA250 - Contrato de Carreteiro
TMSA251 - Liberação de Contrato
TMSA310 - Fechamento de Viagem
TMSA340 - Encerramento de Viagem
TMSA350 - Operações de Transporte
TMSAC15 - Funções Genéricas TMS x Repom
TMSAC15A- Funções Genéricas TMS x Repom
TMSAC15B- Funções Genéricas TMS x Repom
TMSAE60 - Cadastro de Operadoras de Frotas
TMSAE65 - Operadoras de Frotas x Ações
TMSAF64P - Validações para Operadoras de Frota
TMSAF64R - Validações para Operadoras de Frota
TMSREPOM- Funções Genéricas TMS
TMSXFUNA- Funções Genéricas TMS
TMSXFUNB- Funções Genéricas TMS
TMSXFUNC - Funções Genéricas TMS
TMSXFUND - Funções Genéricas TMS
TMSXFUNX - Funções Genéricas TMS
16. 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.
Informações icon false title IMPORTANTE! - Documentação Swagger Repom - http://qa.repom.com.br/Repom.Frete.WebAPI/HelpApi/index#/
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> |