Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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:

    SIGATMSREPOMDESCRIÇÃO
    MotoristaDriverEste método integra os cadastros de Motoristas do SIGATMS com a base de dados da Repom.
    FornecedorHiredEste método integra os cadastros de Fornecedor do SIGATMS com a base de dados da Repom.
    VeículosVehicleEste método integra os cadastros de Veículos do SIGATMS com a base de dados da Repom.
    Operações da Operadora - Cadastro Operadoras de FrotaOperationNo 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.
    RoteiroRoute / RouteRequestAs 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 ViagemShipping

    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çãoPayment

    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_REPQUI (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 ContratoShipping/StatusProcessing/ByIdentifierApó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 PagamentoPaymentAuthorization

    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.

    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.

    Método RepomMétodo TotvsDescriçã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 /OperationGetOperation()

    Recupera operações

    GET /Operation/ByIdentifier/{operationIdentifier}GetOperById()

    Recupera operações por identificador

    GET /Movement/GetMovementGetMovement()Retorna movimentações dos clientes



    DOCUMENTAÇÕES API REPOM

    Informações
    iconfalse
    titleIMPORTANTE!

    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/#/

...