Histórico da Página
CONTEÚDO
Índice | ||||||
---|---|---|---|---|---|---|
|
01. PRÉ-REQUISITOS
- Configure o parâmetro MV_VSREPOM com conteúdo 2.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).
04. CADASTRO DO VEÍCULO
O cadastro do cartão 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).
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).
06. CADASTRO DE ROTA
No Cadastro de Rotas (OMSA100) existe atualmente uma consulta ao roteiro, baseada na região de origem, onde associa-se o Roteiro selecionado à rota.
Assim como a operação de transporte, as informações referente ao roteiro/percurso da viagem devem ser enviadas no momento da emissão de um contrato ou na emissão do controle de viagem na Repom. Cada rota do Microsiga Protheus é amarrada a um roteiro/percurso da Repom.Foi criada uma rotina para a solicitação de Roteiro na Repom a partir do cadastro de Rotas, para as situações onde o Roteiro não existir. Essa rotina contém obrigatoriamente a Origem e o Destino do Roteiro e, opcionalmente, pontos intermediários em que o Roteiro Repom deverá passar.
A partir desta rotina, deverá ser consumido o método “SolicitaRoteiro” da Repom. Esta ação tem, atualmente pela operadora, prazo determinado em até 15 min para ser executada 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.
06. VIAGEM MOD. 3
Foi disponibilizada a opção de realizar a integração com a Repom através do menu Outras Ações > Operadoras de Frota > Repom dentro da viagem modelo 3.
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.
As funcionalidades foram mantidas também na viagem modelo 2, permitindo ao usuário uma alternativa a mais para realizar a integração com a Repom.
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;
06. FECHAMENTO DE VIAGEM
06. CONTRATO DE CARRETEIRO
06. ENCERRAMENTO DE VIAGEM
06. 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() | |
PATCH /PaymentAuthorization/Cancel | AuthCancel() | |
GET /PaymentAuthorization/ByShippingId/{shippingId} | GetPayAutShip() | |
GET /Card/GetActiveCardsByHired/{HiredNationalID} | GetCardHired() | |
GET /Card/GetActiveCardsByDriver/{DriverNationalID} | GetCardDriver() | |
GET /Card/GetActiveCardsByHiredAndByDriver/{HiredNationalID}/{DriverNationalID} | GetCardDvrHrd() | |
GET /VPR/TollList/ByShippingIdentifier/{shippingIdentifier} | GetVPR() | |
GET /ShippingFuelBenefit/GetLinkByCardNumber/{cardNumber} | GetFuelbyCard() | |
GET /Operation | GetOperation() | |
GET /Operation/ByIdentifier/{operationIdentifier} | GetOperById() |
07. PARÂMETROS
MV_REPTRAC
MV_TMSXML
MV_VSREPOM
08. 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.
09. FONTES UTILIZADOS
OMSA040 - Cadastro de Motorista
OMSA060 - Cadastro de Veiculos
OMSA100 - Cadastro de Rotas
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
TMSXFUNX - Funções Genéricas TMS
10. 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> |