Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 24

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

Gravado em

comparado com

Nova versão 25

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

  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;


06. FECHAMENTO DE VIAGEM


06. CONTRATO DE CARRETEIRO


06. ENCERRAMENTO DE VIAGEM


06. MÉTODOS

Método RepomMétodo Totvs

GET /AnttTypes/LoadTypes

GetLoadTypes() 

POST /token 

Auth() 

POST /Driver

DriverCreate()

PUT /Driver/{country}/{nationalId}

DriverUpdate() 

PATCH /Driver/lockUnlock/{country}/{nationalId}

DriverLock() 

GET /Driver/ByName/{name}

GetDrvrByName()

GET /Driver/ByDocument/{country}/{nationalId}

GetDrvrByDoc()

POST /Hired

HiredCreate()

PUT /Hired/{country}/{nationalId}

HiredUpdate()

PATCH /Hired/lockUnlock/{country}/{nationalId}

HiredLock()  

GET /Hired/ByName/{name}

GetHrdByName()

GET /Hired/ByDocument/{country}/{nationalId}

GetHrdByDoc()

POST /Vehicle

VehicleCreate() 

PUT /Vehicle/{country}/{license}

VehicleUpdate()

PATCH /Vehicle/{country}/{license}

VehicleLock() 

GET /Vehicle/ByDocument/{country}/{license} 

GetVeicByDoc() 

POST /RouteRequest

RouteCreate()  

GET /Route/ByCEP/{cep}/{toCep}/{vehicleAxles}

GetRtByCEP()  

GET /Route/ByIBGE/{IBGECode}/{toIBGECode}/{vehicleAxles}

GetRtByIBGE()

GET /Route/ByTraceIdentifier/{traceIdentifier}/{vehicleAxles} 

GetRtByTrcId()

GET /Route/ByRouteCode/{traceCode}/{routeCode}/{vehicleAxles}GetByRtCode()

GET /RouteRequest/{traceIdentifier}

GetRtRequest() 

POST /Shipping

ShippingCreate()

PATCH /Shipping/AddDocument/{shippingId}

ShippingDocAdd() 

PATCH /Shipping/AddMovement/{shippingId}

ShippingMovAdd()

PATCH /Shipping/Cancel/{id}

ShippingCancel()

PATCH /Shipping/lockUnlock/{shippingId}ShippingLock()
PATCH /Shipping/Interruption/{id}ShippingInter()

GET /Shipping/ByShipping/{shippingId} 

GetShipByShip()

GET /Shipping/ByIdentifier/{identifier}GetShipById()
GET /Shipping/StatusProcessing/ByIdentifier/{id}GetShipStPrcBy()

POST /ShippingPayment

PaymentCreate()

PATCH /ShippingPayment/Cancel/{shippingID}

PaymentCancel() 

PATCH /ShippingPayment/DocumentLost/{shippingID}

PaymLostDoc() 

PATCH /ShippingPayment/DocumentReship/{shippingID}

PaymReshipDoc() 

PATCH /ShippingPayment/DocumentDelivered/{shippingID}

PaymDeliverDoc()

PATCH /ShippingPayment/DocumentDismissed/{shippingID}  

PaymDismisDoc()

GET /ShippingValidation/ByVehicles/{vehicles}

GetShipVeicVld()

GET /ShippingValidation/ByHiredDocument/{country}/{document}

GetShipHiredVld() 

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 /OperationGetOperation()
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
    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>