01. DADOS GERAIS
Produto: | |
---|---|
Linha de Produto: | |
Segmento: | |
Módulo: | TOTVS Logística TMS |
Função: | OMSA040 - Cadastro de Motorista |
Ticket: | Não se aplica |
Requisito/Story/Issue (informe o requisito relacionado) : | DLOGTMS02-13230 |
Implementar melhoria no processo de integração entre o módulo SIGATMS e Repom, utilizando a plataforma Repom Frete, que baseia-se na tecnologia Web API* em arquitetura RestFul.
A API de integração da Repom permite a realização de diversas operações contidas no Repom Frete, como manipulação de cadastros (Contratados, Motoristas e Veículos), Roteiros, Viagens e Pagamento.
* Web APÌ - Solução utilizada na integração de sistemas e na comunicação entre diferentes aplicações, utilizando a linguagem universal JSON para tráfego de dados, proporciona a sistemas desenvolvidos em plataformas distintas sejam compatíveis.
Implementado a integração TMS com a Repom Frete, que estará disponível a partir da configuração dos parâmetros "MV_VSREPOM = 2.2" e MV_TMSOPDG = 2.
As alterações de dicionário de dados estarão disponíveis a partir do release 12.1.33. |
Nesta versão houve algumas mudanças de configuração:
Os processos de interface utilizados são:
SIGATMS | REPOM | DESCRIÇÃO |
Motorista | Driver | Este método integra os cadastros de Motoristas do SIGATMS com a base de dados da Repom. |
Fornecedor | Hired | Este método integra os cadastros de Fornecedor do SIGATMS com a base de dados da Repom. |
Veículos | Vehicle | Este método integra os cadastros de Veículos do SIGATMS com a base de dados da Repom. |
Operações da Operadora - Cadastro Operadoras de Frota | Operation | No sistema da Repom, as operações de transporte são um conjunto de configurações para que o sistema se comporte de maneira distinta, de forma a atender aos diferentes tipos de operações. Por exemplo, há operações que contemplam a quebra de peso e quebra de frete. No SIGATMS, esta configuração está disponível no botão Outras Opções → Operac. ,na rotina Operadora de Frota. Esse método é utilizado, pois durante a emissão do contrato na base da Repom, é necessário enviar junto dos dados da viagem, qual a operação deseja utilizar. |
Roteiro | Route / RouteRequest | As informações referente ao Roteiro/Percurso da viagem são enviadas no momento da emissão de um contrato na Repom. No SIGATMS, esse método é acionado no momento do Cadastro da Rota. Cada rota do SIGATMS é amarrada a um roteiro/percurso da Repom. |
Emitir Viagem | Shipping | Na Repom, este método é um dos principais componentes da integração, por meio do qual é gerado o contrato no sistema da Repom. No SIGATMS, esse método é acionado no momento do Fechamento da Viagem. |
Quitação | Payment | A quitação do contrato determina o fim do processo de viagem na Repom. Obs: Na versão 2.2 (RepomFrete) não existe o método de "Autorização de Quitação do contrato" conforme versões anteriores. |
Consulta Contrato | Shipping/StatusProcessing/ByIdentifier | Após a quitação do contrato na Repom, realizamos a consulta do contrato diretamente por este método para conseguir os valores referente a impostos, calculados para pessoas físicas. |
Autorização de Pagamento | PaymentAuthorization | O processo de autorização é configurado no Sistema REPOM. Portanto, o TMS somente enviará a autorização quando o Status do Contrato na REPOM estiver como 'CLEARED' |
Cálculo de Pedágio | Route/ByRouteCode | Ao informar os Recursos da Viagem (Operadora de Frota e Veículo) automaticamente, com base na rota da viagem, é acionado esse método para obter o valor do pedágio. Na Viagem Modelo 3, na Aba Recursos, no campo “Pedágio” é apresentado o valor. |
Movimentação de Valores | Shipping/AddMovement | 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”. Esse método é utilizado para que uma movimentação seja inserida e ou excluída dentro do contrato na Repom. |
Abaixo segue todos os métodos desenvolvidos para troca de informações entre o Totvs Logistica TMS x Repom ambiente Repom Frete.
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 |
DOCUMENTAÇÕES API REPOM
Documentação Swagger Repom Frete - http://qa.repom.com.br/Repom.Frete.WebAPI/HelpApi/index#/ Documentação Swagger Repom Relatórios - https://qa.repom.com.br/Repom.Relatorio.WebApi/HelpApi/#/ |
Para uso desta funcionalidade, deve ser utilizado:
Configuração:
|
DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS
|
<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-pane.l { margin-left: 0px !important; } .aui-header-primary .aui-nav { margin-left: 0px !important; } .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { background: #FF9900; !important } .menu-item.active-tab { border-bottom: none !important; } </style> |