Histórico da Página
...
| 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 |
...
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, proporcionando para que 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 do parâmetro dos parâmetros "MV_VSREPOM = 2.2" e MV_TMSOPDG = 2.
| Informações | ||
|---|---|---|
| ||
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:
- Parâmetro MV_ENREPOM descontinuado não será utilizado para esta integração junto a plataforma Repom Frete da Repom, porém o Fechamento da viagem continua o "start" (Abertura do Contrato) entre a integração Protheus TMS e Repom.
- No cadastro de Operadora de Frotas foram criados novos campos:
- Momento da Quitação (DEG_REPQUI): Utilizado para definir o Momento da Quitação do Contrato na Repom;
- Tempo de Espera (DEG_TMPESP): Utilizado para definir o tempo de espera do processamento da inclusão do Contrato na Repom, onde ocorre o retorno do Código do Contrato (DTR_PRCTRA/DM5_PRCTRA) e o Código do CIOT (DTR_CIOT);
Os processos de interface utilizados são:
OperaçãoSIGATMS 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.
. EsseOperaçõ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
roteiro. 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
percursoRoteiro/
cadastroPercurso da viagem são enviadas no momento da emissão de um contrato na Repom. No SIGATMS, esse método é acionado no momento do
rotaCadastro da
REQUIRota. 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.
Quando ocorrer o estorno do Fechamento da Viagem, é acionado automaticamente o método para cancelamento do contrato na Repom. 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 estorno do fechamento da viagem não será realizado.Quitação Payment A quitação do contrato determina o fim do processo de viagem na Repom.
Esse método será acionado conforme a configuração do campo DEG_
VeiculoREPQUI (Momento Quitação) do Cadastro de Operadoras de Frotas (Contrato de Carreteiro, conforme configuração do MV_LIBCTC e/ou no Encerramento da Viagem)
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
viagem modeloVeí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. MÉTODOS REPOM
Abaixo segue todos os métodos desenvolvidos para troca de informações entre o Totvs Logistica TMS x Repom ambiente Repom Frete.
...
| title | Importante |
|---|
...
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 REPOMInformações icon false title IMPORTANTE! 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/#/
04. DEMAIS INFORMAÇÕES
Para uso desta funcionalidade, deve ser utilizado:
...
| Informações | ||
|---|---|---|
| ||
Configuração:
|
DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS
| Totvs custom tabs box | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Tabela DA4 (Motorista):
|
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas