Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 32

changes.mady.by.user Maria Katia Tiemi Makiyama

Gravado em

comparado com

Nova versão 33

changes.mady.by.user Caio Bruno Murakami Y Cruces

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
empo aproximado para leitura: 20 min

CONTEÚDO

Índice
exclude.*CONTEÚDO
stylenone
separatornone

01. PRÉ-REQUISITOS

  1. Configure o parâmetro MV_VSREPOM com conteúdo 2.2 . 
  2. Observe os demais Parâmetros envolvidos na Integração Repom.

02. CADASTRO DE OPERADORA 

  1. Em Operadora de Frota, efetue o cadastro da Operadora com base nos dados enviados pela Repom para conexão com o sistema.

  2. Informe os dados conforme orientação do Help de campo (F1).
  3. Acesse a aba Cadastrais:

    1. Informe o campo Branch Repom (DEG_BRANCH) de acordo com informações da Repom.

    2. Informe o campo Nome Usuário (DEG_USER) de acordo com informações da Repom.

    3. Informe o campo Senha (DEG_SENHA) de acordo com informações da Repom.
    4. Informe o campo URL WS (DEG_URLWS) de acordo com informações da Repom.
  4. Acesse a aba Outros:
    1. Informe o campo Mom. Quit. Repom (DEG_REPQUI) de acordo com informações do help de campo.
    2. Informe o campo Tempo Espera (DEG_TMPESP) de acordo com informações do help de campo.

03. CADASTRO DO FORNECEDOR

  1. Em Fornecedores, cadastre um novo fornecedor ou utilize um preexistente.
  2. Informe os dados conforme orientação do Help de campo (F1).
  3. Preencha o campo Razão Social(A2_NOME) de acordo com orientação do Help de campo (F1).
  4. Preencha o campo N Fantasia(A2_NREDUZ) de acordo com orientação do Help de campo (F1).
  5. Preencha o campo País (A2_PAIS) de acordo com orientação do Help de campo (F1).
  6. Preencha o campo Endereço(A2_END) de acordo com orientação do Help de campo (F1).
  7. Preencha o campo Bairro (A2_BAIRRO) de acordo com orientação do Help de campo (F1).
  8. Preencha o campo Complemento(A2_COMPLEM) de acordo com orientação do Help de campo (F1).
  9. Preencha o campo CEP(A2_CEP) de acordo com orientação do Help de campo (F1).
  10. Preencha o campo Data Nasc. (A2_DTNASC) de acordo com orientação do Help de campo (F1).
  11. Preencha o campo Tipo (A2_TIPO) de acordo com orientação do Help de campo (F1).
  12. Preencha o campo CPF/CNPJ (A2_CGC) de acordo com orientação do Help de campo (F1).
  13. Preencha o campo DDD (A2_DDD) de acordo com orientação do Help de campo (F1) e com no máximo 2 caracteres.
  14. Preencha o campo Telefone (A2_TEL) de acordo com orientação do Help de campo (F1).
  15. Preencha o campo Email (A2_EMAIL) de acordo com orientação do Help de campo (F1).
  16. Preencha o campo RNTRC (A2_RNTRC) de acordo com orientação do Help de campo (F1).
  17. Preencha o campo Cód. INSS (A2_CODINSS) de acordo com orientação do Help de campo (F1).
  18. Preencha o campo RG/Ced.Estr.(A2_PFISICA) de acordo com orientação do Help de campo (F1).
  19. Preencha o campo Ins. Estad.  (A2_INSCR) de acordo com orientação do Help de campo (F1).
  20. Preencha o campo Ins. Municip (A2_INSCRM) de acordo com orientação do Help de campo (F1).
  21. Preencha o campo Opt Simp Nac (A2_SIMPNAC) de acordo com orientação do Help de campo (F1).
  22. 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.

  1. Em Veículos, cadastre ou utilize um preexistente.
  2. Informe os dados conforme orientações do Help de campo (F1).
  3. Preencha o campo Placa(DA3_PLACA) de acordo com orientação do Help de campo (F1).
  4. Preencha o campo Tipo de Veículo(DA3_TIPVEI) de acordo com orientação do Help de campo (F1).
  5. Preencha o campo Código/Loja Fornecedor(DA3_CODFOR/DA3_LOJFOR) de acordo com orientação do Help de campo (F1).
  6. 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.

  1. Em Motoristas, cadastre ou utilize um preexistente.
  2. Informe os dados conforme orientações do Help de campo (F1).
  3. Preencha o campo Nome(DA4_NOME) de acordo com orientação do Help de campo (F1).
  4. Preencha o campo CNPJ/CPF(DA4_CGC ) de acordo com orientação do Help de campo (F1).
  5. Preencha o campo No. CNH(DA4_NUMCNH) de acordo com orientação do Help de campo (F1).
  6. Preencha o campo País(DA4_PAIS) de acordo com orientação do Help de campo (F1).
  7. Preencha o campo Bairro(DA4_BAIRRO) de acordo com orientação do Help de campo (F1).
  8. Preencha o campo Endereço(DA4_END) de acordo com orientação do Help de campo (F1).
  9. Preencha o campo Telefone(DA4_TEL) de acordo com orientação do Help de campo (F1).
  10. 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 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 utilizando a plataforma Repom Frete, que baseia-se na tecnologia Web API, foram implementadas 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

  1. Inclua uma viagem;
  2. Acesse a opção Outras Ações > Operadoras de Frota > Incluir Contrato;
  3. 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

  1. Acesse a opção Outras Ações > Operadoras de Frota > Atualizar Status;
  2. Ao clicar nessa opção, será acionado o método GET - /Shipping/StatusProcessing/ByIdentifier
  3. Após acionar esse método o sistema irá verificar se o Contrato (Shipping) já foi totalmente processado pela Repom;
  4. 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;
  5. 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

  1. Acesse a opção Outras Ações > Operadoras de Frota >Consulta Status;
  2. Ao clicar nessa opção, será acionado o método GET /Shipping/ByShipping;
  3. Será exibida em tela as informações retornadas pelo método;


Interrompe Contrato

  1. Acesse a opção Outras Ações > Operadoras de Frota >Interrompe Contrato;
  2. Ao clicar nessa opção, será acionado o método PATCH /Shipping/Interruption;
  3. Caso ocorra algum erro, será exibida mensagem em tela;


Bloqueia Contrato

  1. Acesse a opção Outras Ações > Operadoras de Frota >Bloqueia Contrato;
  2. Ao clicar nessa opção, será acionado o método PATCH /Shipping/lockUnlock;
  3. Caso ocorra algum erro, será exibida mensagem em tela;


Desbloqueia Contrato

  1. Acesse a opção Outras Ações > Operadoras de Frota >Desbloqueia Contrato;
  2. Ao clicar nessa opção, será acionado o método PATCH /Shipping/lockUnlock;
  3. Caso ocorra algum erro, será exibida mensagem em tela;


Cancela Contrato

  1. Acesse a opção Outras Ações > Operadoras de Frota >Cancela Contrato;
  2. Ao clicar nessa opção, será acionado o método PATCH /Shipping/Cancel;
  3. 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 "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".


12. MÉTODOS

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

13. PARÂMETROS

  • MV_REPTRAC

  • MV_TMSXML

  • MV_VSREPOM

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 - Viagem
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
    iconfalse
    titleIMPORTANTE!


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>