Você está na página 1de 25

Boletim Tcnico

SIGATMS Integrao Repom Fase II


Produto Chamado Pas(es) : : : Microsiga Protheus Gesto de Transportes verso 10 TDYUVJ Brasil Data da publicao Banco(s) de Dados : : 19/03/12 DBAccess

Esta melhoria depende de execuo do update de base TMSP10R1/TMS10R168, conforme Procedimentos para Implementao.

Implementada melhoria no mdulo Gesto de Transportes (SIGATMS) com a disponibilizao da segunda verso da Integrao com o Software Repom S.A, que consiste em efetuar alteraes na integrao com a operadora de Frotas, referente Frota de Terceiros, de acordo com a legislao descrita abaixo:

A Lei (do transporte) n 11.442, de 5 de janeiro de 2007, passa a vigorar acrescida do seguinte art. 5o-A: Art. 5o-A. O pagamento do frete do transporte rodovirio de cargas ao Transportador Autnomo de Cargas - TAC dever ser efetuado por meio de crdito em conta de depsitos mantida em instituio bancria ou por outro meio de pagamento regulamentado pela Agncia Nacional de Transportes Terrestres - ANTT. 1o A conta de depsitos ou o outro meio de pagamento dever ser de titularidade do TAC e identificado no conhecimento de transporte. 2o O contratante e o sub-contratante dos servios de transporte rodovirio de cargas, assim como o consignatrio e o proprietrio da carga, so solidariamente responsveis pela obrigao prevista no caput deste artigo, resguardado o direito de regresso destes contra os primeiros. 3o Para os fins deste artigo, equiparam-se ao TAC a Empresa de Transporte Rodovirio de Cargas - ETC que possuir, em sua frota, at 3 (trs) veculos registrados no Registro Nacional de Transportadores Rodovirios de Cargas - RNTRC e as Cooperativas de Transporte de Cargas. 4o As Cooperativas de Transporte de Cargas devero efetuar o pagamento aos seus cooperados na forma do caput deste artigo.

Repom S.A.
A empresa Repom S.A. dispe de uma ferramenta de Gesto, Controle e Pagamentos, aplicada contratao de fretes. Seu objetivo melhorar a eficincia no controle das operaes com frotas terceirizadas e agregadas. No caso de frota terceirizada, a Repom permite a contratao e gerenciamento de motoristas via internet, eliminando a necessidade de carta-frete nas operaes com motoristas terceirizados. Alm disso, facilidades como o fornecimento do vale-pedgio obrigatrio (por meio de um sistema nico que proporciona total controle do processo de emisso).

SIGATMS Integrao Repom Fase II

Boletim Tcnico

Todas as solues oferecidas pela Repom utilizam a internet como plataforma de operao, o que torna o sistema confivel, rpido e flexvel. Frotas prprias tambm podem ter sua gesto realizada pela Repom. Nesses casos, todo gerenciamento referente a pedgio e pontos de apoio ser realizado pela Repom.

Parceria: TOTVS Repom


Visando agregar valores aos dois sistemas, a TOTVS e a Repom se uniram nesta parceria. A partir dela, todos os controles realizados pelo mdulo de Gesto de Transportes podem ser integrados aos processos da Repom.

Principais vantagens
Dois processos em um: O controle da viagem realizado no Microsiga Protheus e a operao da frota gerenciada pela Repom, porm, todo processo unificado na interface do Microsiga Protheus; Eliminao da carta-frete: O processo na Repom totalmente controlado por meio de cartes magnticos (chip). Todo o controle referente ao valor devido ao carreteiro creditado nesse carto. Com isto, no existe a necessidade de utilizar o recurso da cartafrete. Nesse processo, a prpria transportadora define o valor disponvel para abastecimentos e saques em dinheiro durante a viagem; Pedgio: O pedgio obtido automaticamente por meio da integrao com a Repom, de acordo com a rota selecionada para viagem, dispensando o cadastro de Rotas X Rodovias, em que so inseridos os valores referentes aos pedgios da rota. O Vale-Pedgio Repom aceito nas praas de pedgio de todo o Brasil; Segurana Anti-Fraudes: Os valores a serem creditados dependem de autorizaes. Podem ser realizados filtros por valor mximo, perodo ou nmero de viagens. No possvel alterar os valores a serem creditados nos cartes; Internet: Todas as informaes so registradas e disponibilizadas em tempo real.

Integrao
A integrao com a Repom se realizada por meio da tecnologia de Webservices, dispensando a utilizao do site da Repom integrando os processos diretamente por meio da interface do Microsiga Protheus.

Webservices
Webservice uma classe publicada em um servidor de aplicao para acesso externo, de forma que um programa de software client solicita ao server o processamento de uma ao, que pode-se definir como mtodo, enviando o(s) parmetro(s) por meio de uma string XML, formatada no padro SOAP (Simple Object Access Protocol). O mtodo retorna ao client uma string XML de resposta, tambm formatada no padro SOAP. Neste caso, o Microsiga Protheus ser a plataforma denominada client e a Repom a server.

Mtodos utilizados para realizao da integrao


Dentre os mtodos disponibilizados pela Repom, os utilizados so: Integrao com o Cadastro Nacional: Este mtodo integra os cadastros de Motoristas, Fornecedores e Veculos do Microsiga Protheus com a base de dados da Repom. Para que os processos da Repom sejam realizados, necessria a atualizao desses dados. Esse mtodo pode ser acionado por meio dos respectivos cadastros e no momento da confirmao da abertura da viagem. Validao do Carto: Para que um contrato ou controle de viagem seja criado na Repom, primeiro necessrio verificar a autenticidade e a situao do carto Repom do motorista. Para isto, utilizado o mtodo para realizao da validao do carto

SIGATMS Integrao Repom Fase II

Boletim Tcnico

do motorista. Esse mtodo pode ser acionado por meio do prprio cadastro do motorista ou no momento da montagem de uma viagem, na tela de complemento de viagem. Clculo do Pedgio: O clculo do pedgio ocorre em tempo real (on-line). Ao informar os dados do complemento de viagem, automaticamente, com base na rota da viagem, acionado o mtodo para obter o valor do pedgio. No prprio complemento de viagem, no campo Pedgio apresentado o valor. *Ateno: Quando utilizada a integrao com a Repom, no necessria a realizao do cadastro de Praas de Pedgio e Rotas X Rodovias. Isto porque o valor do pedgio obtido com base nas informaes passadas para Repom. Operaes de Transporte: No sistema da Repom, as operaes de transporte so um conjunto de configuraes para que o sistema se comporte de maneira distinta, de forma a atender aos diferentes tipos de operaes. Por exemplo, h operaes que contemplam a quebra de peso e quebra de frete. Esse mtodo utilizado, pois durante a emisso do contrato na base da Repom, necessrio enviar junto dos dados da viagem, qual a operao deseja utilizar. Roteiros / Percursos: Assim como a operao de transporte, as informaes referentes ao roteiro/percurso da viagem devem ser enviadas no momento da emisso de um contrato ou na emisso do controle de viagem na Repom. No Protheus, esse mtodo acionado no momento do cadastro da rota. Cada rota do Microsiga Protheus amarrada a um roteiro/percurso da Repom. Emisso de Contrato (Frota de terceiros): Na Repom, este mtodo um dos principais componentes da integrao, por meio do qual gerado o contrato no sistema da Repom. No Microsiga Protheus, esse mtodo acionado no momento da realizao do clculo do contrato de carreteiro. Cancelamento de Contrato (Frota de terceiros): Quando ocorrer a excluso do clculo do contrato de carreteiro no Microsiga Protheus, acionado automaticamente o mtodo para cancelamento do contrato na Repom. O cancelamento do contrato na Repom segue regras especficas que podem interferir no seu cancelamento. Caso no seja possvel cancelar o contrato na Repom, o clculo do contrato no Microsiga Protheus tambm no cancelado. Autorizao para Quitao do Contrato (Frota de terceiros): A quitao do contrato somente pode ser realizada aps ocorrer sua autorizao. Esse mtodo ser acionado no momento do encerramento da viagem no Microsiga Protheus. Quitao do Contrato (Frota de terceiros): A quitao do contrato determina o fim do processo de viagem na Repom. Na quitao do contrato so obtidos os dados referentes ao que ocorreu durante a viagem, tais como os valores dos abastecimentos, valores de saques, etc. Esse mtodo ser acionado logo aps a confirmao da autorizao para quitao do contrato, no encerramento da viagem no Microsiga Protheus. Autorizao para pagamento do saldo do contrato (Frota de terceiros): Aps a quitao do contrato, o carreteiro somente recebe o saldo do contrato (caso exista) aps a autorizao do pagamento do saldo. Para isto, utilizado, no Microsiga Protheus, na rotina de Liberao de Contratos, o mtodo em questo para realizao da autorizao do pagamento. Consulta Contrato (Frota de Terceiros): Aps a quitao de Contrato no Posto e receber o mtodo de Quitao de Contrato, fazemos a consulta do contrato diretamente por este mtodo para conseguir os valores referentes a impostos, calculados para pessoas fsicas. Movimentaes de Valores (Frota de Terceiros): Depois que o contrato emitido na Repom, todos os tipos de crditos e dbitos que podero ocorrer durante a viagem recebem o nome de Movimentaes de Valores. Para que uma movimentao seja inserida dentro do contrato, deve ser utilizado esse mtodo (acionado pelo Microsiga Protheus por meio da rotina de movimento de custo de transporte (dbitos) e no clculo do contrato de carreteiro complementar (crditos)).

Mensagens de Retorno
Depois de gerada a viagem, o motorista efetua o transporte efetivo da carga e, durante a viagem, so geradas informaes sobre seus abastecimentos, crditos e dbitos e encerramento da viagem. Todas essas informaes so geradas na Repom e transmitidas por meio de arquivos ao cliente. Esses arquivos podem ser classificados como Mensagens. No caso da integrao entre Microsiga Protheus

SIGATMS Integrao Repom Fase II

Boletim Tcnico

Repom, este tratamento realizado atravs de um webservice preparado para recepcionar essas informaes. Para mais detalhes, veja o tpico Recepo das Mensagens. As mensagens so classificadas em: Movimentao de valores: Mensagem enviada para registrar os crditos e dbitos feitos no contrato, durante a viagem do motorista. Alguns exemplos: dbitos por falha de rastreamento, crdito referente premiao ao motorista, etc. Essa mensagem somente processada quando frota de terceiros. Passagem em postos credenciados: Mensagem enviada para registrar a passagem do motorista em postos credenciados Repom. Apresentam os dados do posto credenciado, data e hora da passagem e os valores referentes a saques e consumos, junto s suas previses para pagamento. Quando for registrada uma passagem em um posto credenciado, automaticamente ser gerada uma operao de transporte categoria Eventual, indicando a data e hora real da passagem. Aviso de pagamento de carreteiros: Mensagem enviada aps o pagamento do saldo do contrato via TED e informa os valores e a data de pagamento dos saldos de quitao do motorista (mensagem somente processada quando frota de terceiros). Aviso de pagamento de postos: Mensagem enviada uma vez por semana e todos os dias 1 de cada ms. Contm as informaes referentes a quanto o cliente abasteceu em cada posto, com sua data de vencimento. Quitao de contrato: Mensagem enviada toda vez que ocorre uma quitao em um posto credenciado, informando as despesas da viagem e os dados necessrios para o encerramento da viagem no Microsiga Protheus.

PROCEDIMENTO PARA IMPLEMENTAO


O sistema atualizado logo aps a aplicao do pacote de atualizaes (Patch) deste chamado.

Antes de executar o compatibilizador TMSP10R1 imprescindvel: a) Realizar o backup da base de dados do produto que ser executado o compatibilizador PROTHEUS_DATA\DATA e dos dicionrios de dados SXs PROTHEUS_DATA\DATA. b) Os diretrios acima mencionados correspondem instalao padro do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa. c) d) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usurio deve estar utilizando o sistema. Se os dicionrios de dados possurem ndices personalizados (criados pelo usurio), antes de executar o compatibilizador, certifique-se de que esto identificados pelo nickname. Caso o compatibilizador necessite criar ndices, ir adicion-los a partir da ordem original instalada pelo Protheus, o que poder sobrescrever ndices personalizados, caso no estejam identificados pelo nickname. e) O compatibilizador deve ser executado com a Integridade Referencial desativada*.

O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

SIGATMS Integrao Repom Fase II

Boletim Tcnico

A ativao indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no banco de dados. Portanto, antes de utiliz-la, observe atentamente os procedimentos a seguir: i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opo Integridade/Verificao (APCFG60A). ii. Se no h Integridade Referencial ativa, so relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e nenhuma delas estar selecionada. Neste caso, E SOMENTE NESTE, no necessrio qualquer outro procedimento de ativao ou desativao de integridade, basta finalizar a verificao e aplicar normalmente o compatibilizador, conforme instrues. iii. Se h Integridade Referencial ativa em todas as empresas e filiais, exibida uma mensagem na janela Verificao de relacionamento entre tabelas. Confirme a mensagem para que a verificao seja concluda, ou; iv. Se h Integridade Referencial ativa em uma ou mais empresas, que no na sua totalidade, so relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em) integridade est(aro) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta anotao para posterior consulta na reativao (ou ainda, contate nosso Help Desk Framework para informaes quanto a um arquivo que contm essa informao). v. Nestes casos descritos nos itens iii ou iv, E SOMENTE NESTES CASOS, necessrio desativar tal integridade, selecionando a opo Integridade/ Desativar (APCFG60D). vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instrues. vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido desativada, atravs da opo Integridade/Ativar (APCFG60). Para isso, tenha em mos as informaes da(s) empresa(s) e/ou filial(is) que possua(m) ativao da integridade, selecione-a(s) novamente e confirme a ativao.

Contate o Help Desk Framework EM CASO DE DVIDAS!

1.

Em Microsiga Protheus TOTVS Smart Client, digite TMSP10R1 no campo Programa Inicial

Para a correta atualizao do dicionrio de dados, certifique-se que a data do compatibilizador seja igual ou superior a 18/01/2012. 2. 3. 4. Clique em OK para continuar. Aps a confirmao apresentada a janela para seleo do compatibilizador. Selecione o programa TMS10R168 Ao confirmar exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo em modo exclusivo. Clique em Processar para iniciar o processamento. O primeiro passo da execuo a preparao dos arquivos. apresentada uma mensagem explicativa na tela. Em seguida, exibida a janela Atualizao concluda com o histrico (log) de todas as atualizaes processadas. Nesse log de atualizao so apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda no existem no dicionrio de dados. Clique em Gravar para salvar o histrico (log) apresentado. SIGATMS Integrao Repom Fase II 5

5.

6.

7.

Boletim Tcnico

8.

Clique em OK para encerrar o processamento.

ATUALIZAES DO COMPATIBILIZADOR
1. Criao de Campos no arquivo SX3 Campos: Tabela DTR -> Complemento de Viagem Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help Tabela DTR -> Tipo Carga Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help Tabela SA2 - Fornecedores Campo Tipo A2_LOCQUIT C DTR_TIPCRG C 1 0 @! Tipo de Carga Tipo de Carga Transportada 1 Sim No No Tipo de Carga Transportada DTR_CIOT C 17 0 @9 CIOT Cod. Ident. Operac. Transp 1 Sim No No Cdigo de identificao de operao de transporte

SIGATMS Integrao Repom Fase II

Boletim Tcnico

Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Opes Val. Sistema Help Tabela DA4 - Motorista Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help

1 0 @! Local Quitac Local de Quitao 1 Sim No No 0=Filial, 1= Posto Pertence(01) Informa onde ser o local de quitao

DA4_IDOPE C 10 0 @! ID. Oper ID Operadora 1 Sim No No Id da Operadora de Frota

Tabela DTY Contrato de Carreteiro Campo Tipo Tamanho Decimal Formato Ttulo Descrio DTY_LOCQUI C 1 0 @! Local Quitao Local de Quitao

SIGATMS Integrao Repom Fase II

Boletim Tcnico

Nvel Usado Obrigatrio Browse Opes Val. Sistema Help

1 Sim No No 0=Filial, 1= Posto Pertence(01) Local de quitao do contrato

Tabela DEG Operadora de Frota Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help DEG_BANCO C 3 0 @! Banco Cdigo do Banco 1 Sim No No Banco da operadora de Frota

Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help

DEG_AGENCI C 5 0 @! Agncia Cdigo da Agncia 1 Sim No No Agncia da Operadora de Frota

SIGATMS Integrao Repom Fase II

Boletim Tcnico

Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help Tabela DUO Perfil do Cliente Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Opes Val. Sistema Help

DEG_NUMCON C 10 0 @! Cta Corrente Conta corrente 1 Sim No No Conta corrente da Operadora de Frota

DUO_PGPEDG C 1 0 @! Pg. Pedgio Cliente paga pedgio? 1 Sim No No 1 = sim, 2 = no Pertence(12) Cliente paga pedgio

Campo Tipo Tamanho Decimal

DUO_OPECOL C 3 0

SIGATMS Integrao Repom Fase II

Boletim Tcnico

Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help

@! Oper Coleta Operao de Coleta 1 Sim No No Operao de coleta selecionada para o cliente

Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help

DUO_OPEENT C 3 0 @! Oper Entrega Operao de entrega 1 Sim No No Operao de entrega selecionada para o cliente

O tamanho dos campos que possuem grupo podem variar conforme ambiente em uso. 2. Criao de Consulta Padro no arquivo SXB Consulta Padro: Pesquisa DEJ1: Alias Tipo Sequncia Coluna Descrio Contm DEJ1 1 01 RE Operao x Oper DEJ

10

SIGATMS Integrao Repom Fase II

Boletim Tcnico

Alias Tipo Sequncia Coluna Descrio Contm

DEJ1 2 01 01 Operao x Oper TmsOperF3()

Alias Tipo Sequncia Coluna Contm

DEJ1 5 01 01 VAR_IXB

3. Criao de Gatilhos no arquivo SX7 Gatilhos: Tabela DUP Motorista da Viagem Campo Sequncia Regra Campo Domnio Tipo Posiciona? Proprietrio DUP_CODMOT 003 DA4->DA4_IDOPE DUP_IDOPE P N S

PROCEDIMENTOS PARA CONFIGURAO


1. No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parmetros (CFGX017). Crie o(s) parmetro(s) a seguir: Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio Itens/Pastas Verso Repom Descrio MV_VSREPOM C 0 Descrio

SIGATMS Integrao Repom Fase II

11

Boletim Tcnico

Informaes Nome Tipo Cont. Por. Descrio Descrio Cdigo Despesa de Abastecimento MV_ABAST C

Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio Itens/Pastas Informaes Nome Tipo

Descrio

MV_DESSAQ C

Cdigo Despesa de Saque Descrio

MV_DESSALD C

Cdigo Despesa de Saldo Descrio

MV_REFIMP L .F.

Recusar o reclculo de Impostos pelo Financeiro? Descrio

MV_ENREPOM C

12

SIGATMS Integrao Repom Fase II

Boletim Tcnico

Cont. Por. Descrio Descrio Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio 2.

Efetua Encerramento da Viagem na Repom Descrio

MV_DESADF C

Cdigo da Despesa de Adiantamento

No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parmetros (CFGX017). Configure o(s) parmetro(s) a seguir: Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio MV_ENREPOM C 1 Recusar o reclculo de Impostos pelo Financeiro? Descrio MV_REFIMP L .T. Verso Repom Descrio MV_VSREPOM C 2 Descrio

SIGATMS Integrao Repom Fase II

13

Boletim Tcnico

Descrio Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio Itens/Pastas Informaes

Efetua Encerramento da Viagem na Repom Descrio

MV_DESADF C

Cdigo da Despesa de Adiantamento Descrio

MV_DESPDG C

Cdigo da Despesa de Pedgio Descrio

MV_OCORENT C

Cdigo da Ocorrncia de Entrega Descrio

MV_LIBCTC L .T.

Controle de liberao de Contrato Descrio

14

SIGATMS Integrao Repom Fase II

Boletim Tcnico

Nome Tipo Cont. Por. Descrio Descrio Itens/Pastas Informaes Nome Tipo Cont. Por. Descrio Descrio

MV_TMSOPDG C 2

Indica se a integrao com a operadora de Frota esta ativa Descrio

MV_TMSXML L .T.

Indica se os XML da integrao devem ser gravados no disco

PROCEDIMENTOS PARA UTILIZAO

necessrio ter aplicado o compatibilizador TMS10R143 (Criao do campo A2_RNTRC) Para a implementao necessrio possuir um WebService configurado. Configure os parmetros conforme os Procedimentos para Configurao.

Atualizao do Client de Servio do WebService 1. 2. 3. 4. 5. Acesse o WebService (Exemplo http://localhost/ws/). Selecione o mtodo TMSEVENTS. Acesse a DevStudio e crie um novo arquivo. Na pasta Ferramentas, clique na opo Gerar Client WebServices. Preencha com URL do Webservice http://localhost/ws/TMSEVENTS.apw?WSDL ). Compile o cdigo gerado e reinicie o AppServer. Configurado acrescentando TMSEVENTS.apw?WSDL(Exemplo

6.

Cadastros Iniciais Banco 1. 2. No Financeiro (SIGAFIN) acesse Atualizaes / Cadastrar / Banco (MATA070). Cadastre o Banco com o qual a Operadora realizar as transaes. SIGATMS Integrao Repom Fase II 15

Boletim Tcnico

3. 4. 5. 6. 7. 8.

Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Operadora de Frota / Operadora de Frota (TMSAE60). Cadastre a Operadora com base nos dados enviados pela Repom para conexo com o Sistema. Clique na opo Operaes por Operadora. Cadastre as operaes da Operadora, relacionada ao Tipo de transporte e servio. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Operadoras de Frota / Rotas X Operadora de Frota (OMSA140). Cadastre as Rotas com base nas rotas fornecidas pela Repom.

responsabilidade da Operadora de Frota Repom, informar os valores para o preenchimento dos seguintes campos: Id. Operadora: Cdigo de Identificao da Operadora de Frota. (TMSAE60)(DEG_IDOPE) Cod. Acesso: Cdigo de Acesso da Operadora de Frota. (TMSAE60)(DEG_CODACE) URLWS: Url de acesso ao WebService da Operadora de Frota. (TMSAE60)(DEG_URLWS) Fornecedores 1. 2. 3. 4. 5. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Cadastro / Fornecedores (MATA020). Cadastre um novo fornecedor ou utilize um preexistente. Na pasta TMS, preencha o RNTRC e o Local de quitao Filial ou Posto (ser detalhada a diferena mais a frente). Se for pessoa fsica, selecione uma natureza que calcule impostos de IRRF, INSS, SEST (Impostos calculados pela Repom). Aps confirmar, clique na opo Dados X Operadora para Atualizar este registro no Sistema da Repom.

Motorista 1. 2. 3. 4. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Transporte / Motoristas (OMSA040). Cadastre ou utilize um preexistente, sendo este um Terceiro, com o Fornecedor registrado anteriormente. Preencha o campo ID Oper com o cdigo do Carto do Motorista fornecidos pela Repom. Aps confirmar, clique na opo Dados X Operadora para Atualizar este registro no sistema da Repom.

Veculos 1. 2. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Transporte / Veculos (OMSA060). Cadastre ou utilize um preexistente, sendo este como Frota Terceiro, com o Fornecedor e o Motorista registrados anteriormente. Aps confirmar, clique na opo Dados X Operadora para atualizar este registro no sistema da Repom.

3.

Perfil do Cliente 16 SIGATMS Integrao Repom Fase II

Boletim Tcnico

1. 2. 3.

Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Comercial / Perfil do Cliente (TMSA480). Informe no campo Pg. Pedgio se o cliente possui vale pedgio, ou seja, se SIM, a Repom no calcula o pedgio. Oper. Coleta e Oper. Entrega (Informe a operao da Operadora para aquele determinado cliente em seu respectivo Servio)

Despesas 1. 2. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Transporte / Despesas (TMSA060). Cadastre as despesas solicitadas nos parmetros (MV_DESADF / MV_DESCTC / MV_DESPDG / MV_ABAST / MV_DESSAQ / MV_DESSALD).

Natureza 1. 2. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Cadastros / Natureza (FINA010). Cadastre as naturezas solicitadas nos parmetros (MV_NATCTC / MV_NATPDG / MV_NATDEB).

Ocorrncias 1. 2. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Ocorrncias / Tab. de Ocorrncias (TMSA020). Cadastre as ocorrncias solicitadas nos parmetros (MV_OCORENT).

Viagem 1. 2. 3. 4. 5. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Rodovirio Entrega / Viagem (TMSA144D). Crie uma nova Viagem, selecionando o documento. Clique em Complemento de Viagem. Selecione a Operadora na Pasta Operadora de Frota. Selecione o Veculo. Caso o Vale Pedgio esteja configurado com a opo No, ser chamado o mtodo da Repom para Clculo de frete. Com isso, o campo de Pedgio preenchido automaticamente. Preencha o Valor do frete. Para Acrescentar um adiantamento para a Operadora, preencha a porcentagem no campo % Adi Frete, o qual calcula uma porcentagem sobre o valor do frete informado. Clique em Confirmar

6. 7. 8.

9.

10. O complemento ser chamado no Mtodo de Validao de Abertura de viagem da Repom e aps confirmar a montagem ser chamado o mtodo de atualizao de dados de Fornecedor, Veculo e Motorista. Clculo de Pedgio 1. 2. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Comercial/ Perfil do Cliente (TMSA480). Selecione o cliente tomador.

SIGATMS Integrao Repom Fase II

17

Boletim Tcnico

3. 4.

No campo PG. PEDG. Informe as seguintes opes: Sim : Selecione esta opo caso o cliente tenha vale-pedgio, ou seja, o pedgio no ser calculado pela Repom. No: Selecione a opo para o cliente que no possua vale-pedgio, ou seja, o pedgio ser calculado pela Repom. Durante a montagem de uma viagem de Entrega/Coleta Rodoviria, selecione o documento da viagem, antes de preencher o Complemento. Com isso o Microsiga Protheus identifica se algum cliente tomador dos documentos selecionados possui ou no o vale-pedgio, para que o Sistema calcule o valor referente a essa despesa.

Passagem em Postos O Processo de Passagem Em Postos pode ocorrer em qualquer processo de quitao que utilize a Operadora de Frota, com os devidos parmetros MV_VSREPOM e MV_TMSOPDG configurados com 2. A partir do momento em que o contrato foi gerado e est cadastrado na operadora Repom, a mesma pode comear a enviar mensagens via Webservices, informando a movimentao de valores nos postos. Essa mensagem contm o valor atual do saldo, o valor gasto em abastecimento (MV_ABAST) e o valor referente a saques(MV_DESSAQ). Com os parmetros preenchidos com as respectivas despesas (DT7), a cada mensagem de passagem de postos recebida, caso seja informado um valor maior que zero, gerado um movimento de custo de transporte (SDG) para essa despesa. Estas despesas so sempre abatidas do valor do Adiantamento gerado no Contrato(TMSA250). Este valor pode ser informado no Complemento da viagem(TMSA240) pelo campo Percentual de Adiantamento de Frete (DTR_PERADI). Caso esse campo no exista ou no tenha valor informado, ser informado o adiantamento referente apenas as despesas apontadas no Complemento, quem tenha a opo de Movimentao Bancria Ativada(DT7). Originalmente o SDG (Movimento de custo de Transporte) do adiantamento gerado em aberto ea cada nova despesa de saque ou abastecimento baixada desse registro. Dessa forma, o SDG fica baixado parcialmente. No fim do processo, caso exista ainda algum valor em aberto, ou seja, as despesas somadas no atingiram o valor adiantado para a Operadora, o registro ser baixado.

Arquivos XML Com o parmetro MV_TMSXML = .T. , o Microsiga Protheus armazena no diretrio System/tmsxml os arquivos transmitidos e recebidos durantea comunicao com a Operadora de Frota. OBS: Este arquivos so sobrescritos a cada nova interao. Para evitar a duplicao de registros de registro por recebimento de arquivos XML iguais so verificados os seguintes itens: Passagem de Postos: A tag <codigo_documento_passagem> utilizada como chave nica, e gravada no campo DEP_CODPAS (Log De Trans X Oper De Frotas). Caso exista algum registro com um valor igual, no sero criados novos registros a a partir desse XML. Quitao de Contrato em Postos: Quando uma quitao em postos chegar, ser registrada na tabela DES(Quitao de Contrato), com seu campo DES_STATUS = 2 (Quitado). Caso chegue um novo XML referente a uma viagem j quitada, esse campo ser verificado, evitando que ela seja quitada novamente, criando assim registros duplicados.

Impostos Quando o Fornecedor for Pessoa Fsica, a Repom torna-se responsvel por informar, para o Microsiga Protheus, o valor dos seguintes impostos: IRRF: Imposto de Renda Retido na Fonte o 18 Cdigo Repom para o imposto: 1 e 103

SIGATMS Integrao Repom Fase II

Boletim Tcnico

INSS: Insituto Nacional de Servio Social o Cdigo Repom para o imposto: 100 e 116

SEST: Servio Social de Transporte o Cdigo Repom para o imposto: 2 e 108

SENAT: Servio Nacional de Aprendizagem do Transporte (Somado ao valor do Sest) o Cdigo Repom para o imposto: 3 e 109

Este valores so informado, em uma quitao em Postos, atravs do mtodo do Microsiga Protheus chamado TmsConsRep (TMSXFUNC), o qual busca o mtodo Repom chamado ConsultaContrato. No caso de uma quitao em Filial, informado pelo retorno do mtodo Repom QuitaContrato (TMSA251), dentro do node Movimentaes.

Processo de Quitao Filial

S ser permitido realizar quitao na filial os fornecedores que estiverem configurados atravs do campo Local de Quitao = Filial. Os abastecimentos e saques recebidos antes da quitao so registrados pelo mtodo passagens de postos gerando os sdgs baixados. 1. 2. 3. 4. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Rodovirio Entrega / Viagem (TMSA144D). Realize a gerao da Viagem. Em Gesto de Tranportes (SIGATMS) acesse Atualizaes / Terceiros / Contrato Carreteiro (TMSA250). Realize a emisso do Contrato Carreteiro. O Microsiga Protheus chama o mtodo de EMITE CONTRATO da Repom O Microsiga Protheus gera o contrato de Carreteiro na Repom. O Microsiga Protheus grava o CIOT, informado pela Repom, no Complemento de Viagem(TMSA240). O Microsiga Protheus gera um SDG (Movimento de custo de Transporte) de adiantamento, um SDG de pedgio e um SDG com o valor total do Contrato, sendo que os SDGs do contrato e do adiantamento ficam com status em aberto e o SDG do pedgio fica com status baixado. O Microsiga Protheus gera o ttulo do adiantamento no Contas a Pagar (SE2) com o tipo NCF com status de baixado; O Microsiga Protheus abate o saldo no banco Repom gerando uma Movimentao Bancria (SE5); O Microsiga Protheus gera o ttulo de pedgio no Contas a Pagar (SE2) com o tipo PDG com status de baixado; O Microsiga Protheus abate o saldo no banco Repom gerando uma Movimentao Bancria (SE5);

SIGATMS Integrao Repom Fase II

19

Boletim Tcnico

Caso a Operadora Repom j tenha realizado o depsito, referente ao adiantamento ou ao pedgio, no ser mais possvel estornar o contrato, por trava feita durante a verificao do contrato no Sistema da Repom. 5. 6. Aponte sada da viagem em Manuteno no menu Viagem (TMSA350) Aponte ocorrncias da viagem (Encerra processo) em Manuteno no menu Viagem (TMSA360 ). O Microsiga Protheus chama o mtodo QUITA CONTRATO da Repom O Microsiga Protheus aguarda atravs do WS (Webservice Server) o retorno do mtodo QUITA CONTRATO RESULT. Quando o Microsiga Protheus recebe o mtodo QUITA CONTRATO RESULT, verifica se o fornecedor do contrato de carreteiro pessoa fsica ou jurdica, se for pessoa jurdica: Gera o SDG (Movimento de custo de Transporte) baixado dos abastecimentos, caso este seja informado; (TMSA070) Gera o SDG (Movimento de custo de Transporte) baixado dos saques, caso este seja informado; O SDG (Movimento de custo de Transporte) de adiantamento baixado parcialmente para cada despesa informada; Gera o SDG baixado do saldo do contrato; O status do contrato (DTY) alterado para aguardando liberao Acesse a rotina LIBERA CONTRATO (TMSA251) e realize a liberao do contrato. O Microsiga Protheus envia o mtodo AUTORIZA PAGAMENTO para REPOM. O Microsiga Protheus atravs do mtodo QUITACONTRATO RESULT obtm o valor do saldo e gera o ttulo do saldo a pagar no SE2 com status em aberto. De acordo com a condio de pagamento do fornecedor o Microsiga Protheus recebe atravs do WS o mtodo AVISO PAGAMENTO DE CARRETEIRO. Microsiga Protheus realiza a baixa do ttulo do saldo do contrato no Contas a Pagar (SE2). Microsiga Protheus realiza a baixa do SDG (Movimento de custo de Transporte) do contrato. Microsiga Protheus realiza o abatimento do saldo do banco Repom gerando movimentao no Movimentao Bancria (SE5). Quando o Microsiga Protheus recebe o mtodo QUITA CONTRATO RESULT, verifica se o fornecedor do contrato de carreteiro pessoa fsica ou jurdica, se for pessoa fsica: O Microsiga Protheus gera o SDG (Movimento de custo de Transporte) baixado dos abastecimentos, caso este seja informado; (TMSA070) O Microsiga Protheus gera o SDG (Movimento de custo de Transporte) baixado dos saques, caso este seja informado; O SDG (Movimento de custo de Transporte) de adiantamento baixado parcialmente para cada despesa informada; O Microsiga Protheus gera o SDG baixado do saldo do contrato; O status do contrato (DTY) alterado para aguardando liberao Acesse a rotina em Atualizaes / Terceiro / Libera Contrato (TMSA251) e realize a liberao do contrato.

7.

20

SIGATMS Integrao Repom Fase II

Boletim Tcnico

O Microsiga Protheus envia o mtodo AUTORIZA PAGAMENTO para REPOM. O Microsiga Protheus atravs do mtodo QUITACONTRATO RESULT obtm o valor do saldo e gera o ttulo do saldo a pagar no SE2 com status em aberto. O Microsiga Protheus atravs do mtodo QUITA CONTRATO RESULT obtm os valores de impostos e gera os ttulos de impostos no SE2 com status em aberto. De acordo com a condio de pagamento do fornecedor o Microsiga Protheus recebe atravs do WS o mtodo AVISO PAGAMENTO DE CARRETEIRO. Microsiga Protheus realiza a baixa do ttulo do saldo do contrato no Contas a Pagar (SE2). Microsiga Protheus realiza a baixa do SDG (Movimento de custo de Transporte) do contrato. Microsiga Protheus realiza o abatimento do saldo do banco Repom gerando movimentao na movimentao Bancria (SE5).

Processo de Quitao Posto

S ser permitido realizar quitao no posto, os fornecedores que estiverem configurados atravs do campo Local de Quitao = Posto. Os abastecimentos e saques recebidos antes da quitao so registrados pelo mtodo passagens de postos gerando os sdgs baixados 1. 2. 3. 4. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Rodovirio Entrega / Viagem (TMSA144D). Realize a gerao Viagem. Em Gesto de Tranportes (SIGATMS) acesse Atualizaes / Terceiros / Contrato Carreteiro (TMSA250). Realize a emisso do Contrato Carreteiro. O Microsiga Protheus chama o mtodo de EMITE CONTRATO da Repom. O Microsiga Protheus gera o contrato de Carreteiro na Repom. O Microsiga Protheus grava o CIOT, informado pela Repom, no Complemento de Viagem(TMSA240). O Microsiga Protheus gera um SDG de adiantamento, um SDG de pedgio e um SDG com o valor total do Contrato, sendo que os SDGs do pedgio e do adiantamento ficam com status baixado e o SDG do contrato fica com status em aberto. Gera o ttulo do adiantamento no Contas a Pagar (SE2) com o tipo NCF com status de baixado; Abate o saldo no banco Repom gerando uma Movimentao Bancria (SE5); Gera o ttulo de pedgio no Contas a Pagar (SE2) com o tipo PDG com status de baixado; Abate o saldo no banco Repom gerando uma Movimentao Bancria (SE5);

Caso a Operadora Repom j tenha feito o depsito, referente ao adiantamento ou ao pedgio, no ser mais possvel estornar o contrato, por trava feita durante a verificao do contrato no Sistema da Repom.

SIGATMS Integrao Repom Fase II

21

Boletim Tcnico

5. 6.

Aponte sada da viagem (DTW) Quando o motorista chegar ao posto para realizar a quitao, aps o lanamento dos documento no P.O.S. da REPOM o mtodo QUITA CONTRATO enviado ao WS do Microsiga Protheus. O Microsiga Protheus recebe o mtodo QUITA CONTRATO (TMSA251) Aponta automaticamente a chegada da viagem (DTW) Aponta automaticamente as ocorrncias da viagem (DUA) Encerra a viagem automaticamente. Gera o SDG (Movimento de custo de Transporte) baixado dos abastecimentos, caso este seja informado; (TMSA070) Gera o SDG (Movimento de custo de Transporte) baixado dos saques, caso este seja informado; O SDG (Movimento de custo de Transporte) de adiantamento baixado parcialmente para cada despesa informada; Gera SDG baixado do saldo do contrato de carreteiro; O Microsiga Protheus verifica se o fornecedor do contrato pessoa fsica ou jurdica, sendo pessoa jurdica: O Microsiga Protheus gera o ttulo do saldo no no Contas a Pagar (SE2); O Microsiga Protheus realiza a baixa do ttulo do saldo no no Contas a Pagar (SE2); O Microsiga Protheus realiza o abatimento do saldo no banco Repom gerando movimento bancrio na movimentao Bancria (SE5); O Microsiga Protheus realiza a baixa do lanamento do contrato no SDG. O Microsiga Protheus verifica se o fornecedor do contrato pessoa fsica ou jurdica, sendo pessoa Fsica: O Microsiga Protheus verifica o mtodo: CONSULTA CONTRATO e obtm os valores dos impostos; (TMSXFUNC.PRW) O Microsiga Protheus atualiza os valores de impostos no contrato de carreteiro (DTY). O Microsiga Protheus gera os ttulos de impostos em aberto na tabela no Contas a Pagar (SE2). O Microsiga Protheus gera o ttulo do saldo no no Contas a Pagar (SE2); O Microsiga Protheus realiza a baixa do ttulo do saldo no no Contas a Pagar (SE2); O Microsiga Protheus realiza o abatimento do saldo no banco Repom gerando movimento bancrio na movimentao Bancria (SE5); O Microsiga Protheus realiza a baixa do lanamento do contrato no SDG.

7.

8.

9.

Processo de Quitao Baixa Antecipada

22

SIGATMS Integrao Repom Fase II

Boletim Tcnico

S ser permitido realizar quitao baixa antecipada, os fornecedores que estiverem configurados atravs do campo Local de Quitao = Posto. Os abastecimentos e saques recebidos antes da quitao so registrados pelo mtodo passagens de postos gerando os SDGs baixados. 1. 2. 3. 4. Em Gesto de Transportes (SIGATMS) acesse Atualizaes / Rodovirio Entrega / Viagem (TMSA144D). Realize a gerao da Viagem. Em Gesto de Tranportes (SIGATMS) acesse Atualizaes / Terceiros / Contrato Carreteiro (TMSA250). Realize a emisso do Contrato Carreteiro. O Microsiga Protheus chama o mtodo de EMITE CONTRATO da Repom; O Microsiga Protheus gera o contrato de Carreteiro na Repom; O Microsiga Protheus grava o CIOT, informado pela Repom, no Complemento de Viagem(TMSA240). O Microsiga Protheus gera um SDG de adiantamento, um SDG de pedgio e um SDG com o valor total do Contrato, sendo que os SDGs do pedgio e do adiantamento ficam com status baixado e o SDG do contrato fica com status em aberto; O Microsiga Protheus gera o ttulo do adiantamento no Contas a Pagar (SE2) com o tipo NCF com status de baixado; O Microsiga Protheus abate o saldo no banco Repom gerando uma Movimentao Bancria (SE5); O Microsiga Protheus gera o ttulo de pedgio no Contas a Pagar (SE2) com o tipo PDG com status de baixado; O Microsiga Protheus abate o saldo no banco Repom gerando uma Movimentao Bancria (SE5);

Caso a Operadora Repom j tenha feito o depsito, referente ao adiantamento ou ao pedgio, no ser mais possvel estornar o contrato, por trava feita durante a verificao do contrato no Sistema da Repom. 5. 6. 7. 8. Aponte sada da viagem em Manuteno no menu Viagem (TMSA350) Aponte a chegada da viagem em Manuteno no menu Viagem (TMSA350) Aponte ocorrncias da viagem em Manuteno no menu Viagem (TMSA360). Encerre a viagem em Manuteno no menu Viagem (TMS340) No encerramento da Viagem: O Microsiga Protheus envia o Mtodo BAIXA ANTECIPADA para REPOM (Neste mtodo constam todos os documentos da ocorrncia; O processo de Quitao realizado no Posto; O Microsiga Protheus recebe o mtodo QUITA CONTRATO; O Microsiga Protheus gera o SDG (Movimento de custo de Transporte) baixado dos abastecimentos, caso este seja informado; (TMSA070) O Microsiga Protheus gera o SDG (Movimento de custo de Transporte) baixado dos saques, caso este seja informado; SIGATMS Integrao Repom Fase II 23

Boletim Tcnico

O SDG (Movimento de custo de Transporte) de adiantamento baixado parcialmente para cada despesa informada; O Microsiga Protheus gera SDG baixado do saldo do contrato de carreteiro; O Microsiga Protheus verifica se o fornecedor do contrato pessoa fsica ou jurdica, sendo pessoa jurdica: O Microsiga Protheus gera o ttulo do saldo no Contas a Pagar (SE2); O Microsiga Protheus realiza a baixa do ttulo do saldo no Contas a Pagar (SE2); O Microsiga Protheus realiza o abatimento do saldo no banco Repom gerando Movimentao Bancria (SE5); O Microsiga Protheus realiza a baixa do lanamento do contrato no SDG; O Microsiga Protheus verifica se o fornecedor do contrato pessoa fsica ou jurdica, sendo pessoa Fsica: O Microsiga Protheus verifica o mtodo: CONSULTA CONTRATO e obtm os valores dos impostos; O Microsiga Protheus atualiza os valores de impostos no contrato de carreteiro (DTY); O Microsiga Protheus gera os ttulos de impostos em aberto na tabela Contas a Pagar (SE2); O Microsiga Protheus gera o ttulo do saldo no Contas a Pagar (SE2); O Microsiga Protheus realiza a baixa do ttulo do saldo no Contas a Pagar (SE2); O Microsiga Protheus realiza o abatimento do saldo no banco Repom gerando Movimentao Bancria (SE5); O Microsiga Protheus realiza a baixa do lanamento do contrato no SDG.

INFORMAES TCNICAS

Tabelas Utilizadas

SA2 - Fornecedores; DA4 - Motorista; DUO Perfil do Cliente; DEG Operadora de Frota; DTY Contrato de Carreteiro; DEJ Operaes x Operadora; DTR Complemento de Viagem; SE2 Contas a Pagar; SE5 Movimentos Bancrios; DES Quitao de Contrato; DEP Lod de Trans X oper de Frota; DEN Passage em Postos; DEO Log X Operadora de Frota; DER Aviso Pagamento Carreteiros; DTW Operaes de Transporte; DTQ Viagem; DTR Veculos da Viagem; DT2 Tabela de Ocorrncias; DT6 Documento de Transporte; DUD Movimento de Viagem

24

SIGATMS Integrao Repom Fase II

Boletim Tcnico

Funes Envolvidas

Viagem - TMSA144D; Perfil do Cliente - TMSA480; Fornecedores MATA020; Motoristas - OMSA040; Operadora de Frota - TMSAE60; Contrato Carreteiro - TMSA250; Despesas - TMSA060; TMSXFUNC; TMSXFUNA; Complemento Viagem - TMSA240; Fechamento de Viagem - TMSA310; Operao de transporte - TMSA350; Encerramento de viagem - TMSA340; Registro de Ocorrncia TMSA360; Libera Contrato TMSA251; Movimento de custo de Transporte - TMSA070; Geracao de Viagens de Coleta / Entrega TMSA141; Geracao de Viagens TMSA140; Cadastro de Gerenciadores de Frota X Acoes TMSAE65; Retorno da Operadora WSTMSE65; Contas a Pagar FINA050; Baixa de ttulos a Pagar FINA080; Compatibilizador Repom TMS10R168 Windows/Linux

Sistemas Operacionais

SIGATMS Integrao Repom Fase II

25