tms integracao repom fase ii tdyuvj

Boletim Técnico

1 SIGATMS – Integração Repom Fase II

SIGATMS – Integração Repom Fase II

Produto : Microsiga Protheus Gestão de Transportes versão 10

Chamado : TDYUVJ Data da publicação : 19/03/12

País(es) : Brasil Banco(s) de Dados : DBAccess®

Implementada melhoria no módulo Gestão de Transportes (SIGATMS) com a disponibilização da segunda versão da Integração com o Software Repom S.A, que consiste em efetuar alterações na integração com a operadora de Frotas, referente à Frota de Terceiros, de acordo com a legislação 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 rodoviário de cargas ao Transportador Autônomo de Cargas - TAC deverá ser efetuado por meio de crédito em conta de depósitos mantida em instituição bancária ou por outro meio de pagamento regulamentado pela Agência Nacional de Transportes Terrestres - ANTT.

§ 1o A conta de depósitos 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 serviços de transporte rodoviário de cargas, assim como o consignatário e o proprietário da carga, são solidariamente responsáveis pela obrigação 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 Rodoviário de Cargas - ETC que possuir, em sua frota, até 3 (três) veículos registrados no Registro Nacional de Transportadores Rodoviários de Cargas - RNTRC e as Cooperativas de Transporte de Cargas.

§ 4o As Cooperativas de Transporte de Cargas deverão efetuar o pagamento aos seus cooperados na forma do caput deste artigo.

Repom S.A.

A empresa Repom S.A. dispõe de uma ferramenta de Gestão, Controle e Pagamentos, aplicada à contratação de fretes. Seu

objetivo é melhorar a eficiência no controle das operações com frotas terceirizadas e agregadas. No caso de frota terceirizada, a Repom

permite a contratação e gerenciamento de motoristas via internet, eliminando a necessidade de carta-frete nas operações com

motoristas terceirizados. Além disso, facilidades como o fornecimento do vale-pedágio obrigatório (por meio de um sistema único que

proporciona total controle do processo de emissão).

Esta melhoria depende de execução do update de base TMSP10R1/TMS10R168, conforme

Procedimentos para Implementação.

Boletim Técnico


Todas as soluções oferecidas pela Repom utilizam a internet como plataforma de operação, o que torna o sistema confiável,

rápido e flexível. Frotas próprias também podem ter sua gestão realizada pela Repom. Nesses casos, todo gerenciamento referente a

pedágio 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 módulo de Gestão 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 operação da frota é gerenciada pela Repom, porém, todo processo é unificado na interface do Microsiga Protheus;

Eliminação da carta-frete: O processo na Repom é totalmente controlado por meio de cartões magnéticos (chip). Todo o controle referente ao valor devido ao carreteiro é creditado nesse cartão. Com isto, não existe a necessidade de utilizar o recurso da “carta-frete”. Nesse processo, a própria transportadora define o valor disponível para abastecimentos e saques em dinheiro durante a viagem;

Pedágio: O pedágio é obtido automaticamente por meio da integração com a Repom, de acordo com a rota selecionada para viagem, dispensando o cadastro de “Rotas X Rodovias”, em que são inseridos os valores referentes aos pedágios da rota. O Vale-Pedágio Repom é aceito nas praças de pedágio de todo o Brasil;

Segurança Anti-Fraudes: Os valores a serem creditados dependem de autorizações. Podem ser realizados filtros por valor máximo, período ou número de viagens. Não é possível alterar os valores a serem creditados nos cartões;

Internet: Todas as informações são registradas e disponibilizadas em tempo real.

Integração

A integração com a Repom se é realizada por meio da tecnologia de Webservices, dispensando a utilização do site da Repom

integrando os processos diretamente por meio da interface do Microsiga Protheus.

Webservices

Webservice é uma classe publicada em um servidor de aplicação para acesso externo, de forma que um programa de software

client solicita ao server o processamento de uma ação, que pode-se definir como método, enviando o(s) parâmetro(s) por meio de uma

string XML, formatada no padrão SOAP (Simple Object Access Protocol). O método retorna ao client uma string XML de resposta, também

formatada no padrão SOAP.

Neste caso, o Microsiga Protheus será a plataforma denominada client e a Repom a server.

Métodos utilizados para realização da integração

Dentre os métodos disponibilizados pela Repom, os utilizados são:

Integração com o Cadastro Nacional: Este método integra os cadastros de Motoristas, Fornecedores e Veículos do Microsiga Protheus com a base de dados da Repom. Para que os processos da Repom sejam realizados, é necessária a atualização desses dados. Esse método pode ser acionado por meio dos respectivos cadastros e no momento da confirmação da abertura da viagem.

Validação do Cartão: Para que um contrato ou controle de viagem seja criado na Repom, primeiro é necessário verificar a autenticidade e a situação do cartão Repom do motorista. Para isto, é utilizado o método para realização da validação do cartão

Boletim Técnico


do motorista. Esse método pode ser acionado por meio do próprio cadastro do motorista ou no momento da montagem de uma viagem, na tela de complemento de viagem.

Cálculo do Pedágio: O cálculo do pedágio ocorre em tempo real (on-line). Ao informar os dados do complemento de viagem, automaticamente, com base na rota da viagem, é acionado o método para obter o valor do pedágio. No próprio complemento de viagem, no campo “Pedágio” é apresentado o valor.

*Atenção: Quando utilizada a integração com a Repom, não é necessária a realização do cadastro de “Praças de Pedágio” e “Rotas X Rodovias”. Isto porque o valor do pedágio é obtido com base nas informações passadas para Repom.

Operações de Transporte: 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. 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.

Roteiros / Percursos: Assim como a operação de transporte, as informações referentes 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. No Protheus, esse método é acionado no momento do cadastro da rota. Cada rota do Microsiga Protheus é amarrada a um roteiro/percurso da Repom.

Emissão de Contrato (Frota de terceiros): Na Repom, este método é um dos principais componentes da integração, por meio do qual é gerado o contrato no sistema da Repom. No Microsiga Protheus, esse método é acionado no momento da realização do cálculo do contrato de carreteiro.

Cancelamento de Contrato (Frota de terceiros): Quando ocorrer a exclusão do cálculo do contrato de carreteiro no Microsiga Protheus, é 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 cálculo do contrato no Microsiga Protheus também não é cancelado.

Autorização para Quitação do Contrato (Frota de terceiros): A quitação do contrato somente pode ser realizada após ocorrer sua autorização. Esse método será acionado no momento do encerramento da viagem no Microsiga Protheus.

Quitação do Contrato (Frota de terceiros): A quitação do contrato determina o fim do processo de viagem na Repom. Na quitação do contrato são obtidos os dados referentes ao que ocorreu durante a viagem, tais como os valores dos abastecimentos, valores de saques, etc. Esse método será acionado logo após a confirmação da autorização para quitação do contrato, no encerramento da viagem no Microsiga Protheus.

Autorização para pagamento do saldo do contrato (Frota de terceiros): Após a quitação do contrato, o carreteiro somente recebe o saldo do contrato (caso exista) após a autorização do pagamento do saldo. Para isto, é utilizado, no Microsiga Protheus, na rotina de Liberação de Contratos, o método em questão para realização da autorização do pagamento.

Consulta Contrato (Frota de Terceiros): Após a quitação de Contrato no Posto e receber o método de Quitação de Contrato, fazemos a consulta do contrato diretamente por este método para conseguir os valores referentes a impostos, calculados para pessoas físicas.

Movimentações de Valores (Frota de Terceiros): 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, deve ser utilizado esse método (acionado pelo Microsiga Protheus por meio da rotina de movimento de custo de transporte (débitos) e no cálculo do contrato de carreteiro complementar (créditos)).

Mensagens de Retorno

Depois de gerada a viagem, o motorista efetua o transporte efetivo da carga e, durante a viagem, são geradas informações sobre

seus abastecimentos, créditos e débitos e encerramento da viagem. Todas essas informações são geradas na Repom e transmitidas por

meio de arquivos ao cliente. Esses arquivos podem ser classificados como Mensagens. No caso da integração entre Microsiga Protheus –

Boletim Técnico


Repom, este tratamento é realizado através de um webservice preparado para recepcionar essas informações. Para mais detalhes, veja o

tópico Recepção das Mensagens.

As mensagens são classificadas em:

Movimentação de valores: Mensagem enviada para registrar os créditos e débitos feitos no contrato, durante a viagem do motorista. Alguns exemplos: débitos por falha de rastreamento, crédito referente à premiação 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 previsões para pagamento. Quando for registrada uma passagem em um posto credenciado, automaticamente será gerada uma operação de transporte categoria Eventual, indicando a data e hora real da passagem.

Aviso de pagamento de carreteiros: Mensagem enviada após o pagamento do saldo do contrato via TED e informa os valores e a data de pagamento dos saldos de quitação 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 mês. Contém as informações referentes a quanto o cliente abasteceu em cada posto, com sua data de vencimento.

Quitação de contrato: Mensagem enviada toda vez que ocorre uma quitação em um posto credenciado, informando as despesas da viagem e os dados necessários para o encerramento da viagem no Microsiga Protheus.

PROCEDIMENTO PARA IMPLEMENTAÇÃO

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

Antes de executar o compatibilizador TMSP10R1 é imprescindível:

a) Realizar o backup da base de dados do produto que será executado o compatibilizador PROTHEUS_DATA\DATA e dos

dicionários de dados SXs PROTHEUS_DATA\DATA.

b) Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme

o produto instalado na empresa.

c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.

d) Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador,

certifique-se de que estão 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 não 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!

Boletim Técnico


A ativação 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 opção

Integridade/Verificação (APCFG60A).

ii. Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais

cadastradas para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é

necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a

verificação e aplicar normalmente o compatibilizador, conforme instruções.

iii. Se há Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela

Verificação de relacionamento entre tabelas. Confirme a mensagem para que a verificação seja concluída,

ou;

iv. Se há Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas

em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em)

integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada

e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework

para informações quanto a um arquivo que contém essa informação).

v. Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal

integridade, selecionando a opção Integridade/ Desativar (APCFG60D).

vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.

vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido

desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as informações da(s)

empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a

ativação.

Contate o Help Desk Framework EM CASO DE DÚVIDAS!

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

Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 18/01/2012.

2. Clique em OK para continuar.

3. Após a confirmação é apresentada a janela para seleção do compatibilizador. Selecione o programa TMS10R168

4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.

5. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos. É apresentada uma mensagem explicativa na tela.

6. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.

7. Clique em Gravar para salvar o histórico (log) apresentado.

Boletim Técnico


8. Clique em OK para encerrar o processamento.

ATUALIZAÇÕES DO COMPATIBILIZADOR

1. Criação de Campos no arquivo SX3 – Campos:

Tabela DTR -> Complemento de Viagem

Campo DTR_CIOT

Tipo C

Tamanho 17

Decimal 0

Formato @9

Título CIOT

Descrição Cod. Ident. Operac. Transp

Nível 1

Usado Sim

Obrigatório Não

Browse Não

Help Código de identificação de operação de transporte

Tabela DTR -> Tipo Carga

Campo DTR_TIPCRG

Tipo C

Tamanho 1

Decimal 0

Formato @!

Título Tipo de Carga

Descrição Tipo de Carga Transportada

Nível 1

Usado Sim

Obrigatório Não

Browse Não

Help Tipo de Carga Transportada

Tabela SA2 - Fornecedores

Campo A2_LOCQUIT

Tipo C

Boletim Técnico


Tamanho 1

Decimal 0

Formato @!

Título Local Quitac

Descrição Local de Quitação

Nível 1

Usado Sim

Obrigatório Não

Browse Não

Opções 0=Filial, 1= Posto

Val. Sistema Pertence(‘01’)

Help Informa onde será o local de quitação

Tabela DA4 - Motorista

Campo DA4_IDOPE

Tipo C

Tamanho 10

Decimal 0

Formato @!

Título ID. Oper

Descrição ID Operadora

Nível 1

Usado Sim

Obrigatório Não

Browse Não

Help Id da Operadora de Frota

Tabela DTY – Contrato de Carreteiro

Campo DTY_LOCQUI

Tipo C

Tamanho 1

Decimal 0

Formato @!

Título Local Quitação

Descrição Local de Quitação

Boletim Técnico


Nível 1

Usado Sim

Obrigatório Não

Browse Não

Opções 0=Filial, 1= Posto


Help Local de quitação do contrato

Tabela DEG – Operadora de Frota

Campo DEG_BANCO

Tipo C

Tamanho 3

Decimal 0

Formato @!

Título Banco

Descrição Código do Banco

Nível 1

Usado Sim

Obrigatório Não

Browse Não

Help Banco da operadora de Frota

Campo DEG_AGENCI

Tipo C

Tamanho 5

Decimal 0

Formato @!

Título Agência

Descrição Código da Agência

Nível 1

Usado Sim

Obrigatório Não

Browse Não

Help Agência da Operadora de Frota

Boletim Técnico


Campo DEG_NUMCON

Tipo C

Tamanho 10

Decimal 0

Formato @!

Título Cta Corrente

Descrição Conta corrente

Nível 1

Usado Sim

Obrigatório Não

Browse Não

Help Conta corrente da Operadora de Frota

Tabela DUO – Perfil do Cliente

Campo DUO_PGPEDG

Tipo C

Tamanho 1

Decimal 0

Formato @!

Título Pg. Pedágio

Descrição Cliente paga pedágio?

Nível 1

Usado Sim

Obrigatório Não

Browse Não

Opções 1 = sim, 2 = não


Help Cliente paga pedágio

Campo DUO_OPECOL

Tipo C

Tamanho 3

Decimal 0

Boletim Técnico


Formato @!

Título Oper Coleta

Descrição Operação de Coleta

Nível 1

Usado Sim

Obrigatório Não

Browse Não

Help Operação de coleta selecionada para o cliente

Campo DUO_OPEENT

Tipo C

Tamanho 3

Decimal 0

Formato @!

Título Oper Entrega

Descrição Operação de entrega

Nível 1

Usado Sim

Obrigatório Não

Browse Não

Help Operação de entrega selecionada para o cliente

O tamanho dos campos que possuem grupo podem variar conforme ambiente em uso.

2. Criação de Consulta Padrão no arquivo SXB – Consulta Padrão:

Pesquisa DEJ1:

Alias DEJ1

Tipo 1

Sequência 01

Coluna RE

Descrição Operação x Oper

Contém DEJ

Boletim Técnico


Alias DEJ1

Tipo 2

Sequência 01

Coluna 01

Descrição Operação x Oper

Contém TmsOperF3()

Alias DEJ1

Tipo 5

Sequência 01

Coluna 01

Contém VAR_IXB

3. Criação de Gatilhos no arquivo SX7 – Gatilhos:

Tabela DUP – Motorista da Viagem

Campo DUP_CODMOT

Sequência 003

Regra DA4->DA4_IDOPE

Campo Domínio DUP_IDOPE

Tipo P

Posiciona? N

Proprietário S

PROCEDIMENTOS PARA CONFIGURAÇÃO

1. No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie o(s) parâmetro(s) a seguir:

Itens/Pastas Descrição

Informações

Nome MV_VSREPOM

Tipo C

Cont. Por. 0

Descrição

Descrição Versão Repom


Boletim Técnico


Informações

Nome MV_ABAST

Tipo C

Cont. Por.

Descrição

Descrição Código Despesa de Abastecimento


Informações

Nome MV_DESSAQ

Tipo C

Cont. Por.

Descrição

Descrição Código Despesa de Saque


Informações

Nome MV_DESSALD

Tipo C

Cont. Por.

Descrição

Descrição Código Despesa de Saldo


Informações

Nome MV_REFIMP

Tipo L

Cont. Por. .F.

Descrição

Descrição Recusar o recálculo de Impostos pelo Financeiro?


Informações

Nome MV_ENREPOM

Tipo C

Boletim Técnico


Cont. Por. 0

Descrição

Descrição Efetua Encerramento da Viagem na Repom


Informações

Nome MV_DESADF

Tipo C

Cont. Por.

Descrição

Descrição Código da Despesa de Adiantamento

2. No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:


Informações

Nome MV_VSREPOM

Tipo C

Cont. Por. 2

Descrição

Descrição Versão Repom


Informações

Nome MV_REFIMP

Tipo L

Cont. Por. .T.

Descrição

Descrição Recusar o recálculo de Impostos pelo Financeiro?


Informações

Nome MV_ENREPOM

Tipo C

Cont. Por. 1

Descrição

Boletim Técnico


Descrição Efetua Encerramento da Viagem na Repom


Informações

Nome MV_DESADF

Tipo C

Cont. Por.

Descrição

Descrição Código da Despesa de Adiantamento


Informações

Nome MV_DESPDG

Tipo C

Cont. Por.

Descrição

Descrição Código da Despesa de Pedágio


Informações

Nome MV_OCORENT

Tipo C

Cont. Por.

Descrição

Descrição Código da Ocorrência de Entrega


Informações

Nome MV_LIBCTC

Tipo L

Cont. Por. .T.

Descrição

Descrição Controle de liberação de Contrato


Informações

Boletim Técnico


Nome MV_TMSOPDG

Tipo C

Cont. Por. 2

Descrição

Descrição Indica se a integração com a operadora de Frota esta ativa


Informações

Nome MV_TMSXML

Tipo L

Cont. Por. .T.

Descrição

Descrição Indica se os XML da integração devem ser gravados no disco

PROCEDIMENTOS PARA UTILIZAÇÃO

É necessário ter aplicado o compatibilizador TMS10R143 (Criação do campo A2_RNTRC)

Para a implementação é necessário possuir um WebService configurado.

Configure os parâmetros conforme os Procedimentos para Configuração.

Atualização do Client de Serviço do WebService

1. Acesse o WebService (Exemplo http://localhost/ws/).

2. Selecione o método TMSEVENTS.

3. Acesse a DevStudio e crie um novo arquivo.

4. Na pasta Ferramentas, clique na opção Gerar Client WebServices.

5. Preencha com URL do Webservice Configurado acrescentando TMSEVENTS.apw?WSDL(Exemplo http://localhost/ws/TMSEVENTS.apw?WSDL ).

6. Compile o código gerado e reinicie o AppServer.

Cadastros Iniciais

Banco

1. No Financeiro (SIGAFIN) acesse Atualizações / Cadastrar / Banco (MATA070).

2. Cadastre o Banco com o qual a Operadora realizará as transações.

http://localhost/ws/

Boletim Técnico


3. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Operadora de Frota / Operadora de Frota (TMSAE60).

4. Cadastre a Operadora com base nos dados enviados pela Repom para conexão com o Sistema.

5. Clique na opção Operações por Operadora.

6. Cadastre as operações da Operadora, relacionada ao Tipo de transporte e serviço.

7. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Operadoras de Frota / Rotas X Operadora de Frota (OMSA140).

8. 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: Código de Identificação da Operadora de Frota. (TMSAE60)(DEG_IDOPE)

Cod. Acesso: Código de Acesso da Operadora de Frota. (TMSAE60)(DEG_CODACE)

URLWS: Url de acesso ao WebService da Operadora de Frota. (TMSAE60)(DEG_URLWS)

Fornecedores

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Cadastro / Fornecedores (MATA020).

2. Cadastre um novo fornecedor ou utilize um preexistente.

3. Na pasta TMS, preencha o RNTRC e o Local de quitação Filial ou Posto (será detalhada a diferença mais a frente).

4. Se for pessoa física, selecione uma natureza que calcule impostos de IRRF, INSS, SEST (Impostos calculados pela Repom).

5. Após confirmar, clique na opção Dados X Operadora para Atualizar este registro no Sistema da Repom.

Motorista

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Transporte / Motoristas (OMSA040).

2. Cadastre ou utilize um preexistente, sendo este um Terceiro, com o Fornecedor registrado anteriormente.

3. Preencha o campo ID Oper com o código do Cartão do Motorista fornecidos pela Repom.

4. Após confirmar, clique na opção Dados X Operadora para Atualizar este registro no sistema da Repom.

Veículos

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Transporte / Veículos (OMSA060).

2. Cadastre ou utilize um preexistente, sendo este como Frota Terceiro, com o Fornecedor e o Motorista registrados anteriormente.

3. Após confirmar, clique na opção Dados X Operadora para atualizar este registro no sistema da Repom.

Perfil do Cliente

Boletim Técnico


1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Comercial / Perfil do Cliente (TMSA480).

2. Informe no campo Pg. Pedágio se o cliente possui vale pedágio, ou seja, se SIM, a Repom não calcula o pedágio.

3. Oper. Coleta e Oper. Entrega (Informe a operação da Operadora para aquele determinado cliente em seu respectivo Serviço)

Despesas

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Transporte / Despesas (TMSA060).

2. Cadastre as despesas solicitadas nos parâmetros (MV_DESADF / MV_DESCTC / MV_DESPDG / MV_ABAST / MV_DESSAQ / MV_DESSALD).

Natureza

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Cadastros / Natureza (FINA010).

2. Cadastre as naturezas solicitadas nos parâmetros (MV_NATCTC / MV_NATPDG / MV_NATDEB).

Ocorrências

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Ocorrências / Tab. de Ocorrências (TMSA020).

2. Cadastre as ocorrências solicitadas nos parâmetros (MV_OCORENT).

Viagem

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Rodoviário Entrega / Viagem (TMSA144D).

2. Crie uma nova Viagem, selecionando o documento.

3. Clique em Complemento de Viagem.

4. Selecione a Operadora na Pasta Operadora de Frota.

5. Selecione o Veículo. Caso o Vale Pedágio esteja configurado com a opção Não, será chamado o método da Repom para Cálculo de frete.

6. Com isso, o campo de Pedágio é preenchido automaticamente.

7. Preencha o Valor do frete.

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

9. Clique em Confirmar

10. O complemento será chamado no Método de Validação de Abertura de viagem da Repom e após confirmar a montagem será chamado o método de atualização de dados de Fornecedor, Veículo e Motorista.

Cálculo de Pedágio

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Comercial/ Perfil do Cliente (TMSA480).

2. Selecione o cliente tomador.

Boletim Técnico


3. No campo PG. PEDG. Informe as seguintes opções:

Sim : Selecione esta opção caso o cliente tenha vale-pedágio, ou seja, o pedágio não será calculado pela Repom.

Não: Selecione a opção para o cliente que não possua vale-pedágio, ou seja, o pedágio será calculado pela Repom.

4. Durante a montagem de uma viagem de Entrega/Coleta Rodoviária, 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 não o vale-pedágio, 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 quitação que utilize a Operadora de Frota, com os devidos parâmetros 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 começar a enviar mensagens via Webservices, informando a movimentação de valores nos postos. Essa mensagem contém o valor atual do saldo, o valor gasto em abastecimento (MV_ABAST) e o valor referente a saques(MV_DESSAQ).

Com os parâmetros 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 são 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 não exista ou não tenha valor informado, será informado o adiantamento referente apenas as despesas apontadas no Complemento, quem tenha a opção de Movimentação Bancária 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 não atingiram o valor adiantado para a Operadora, o registro será baixado.

Arquivos XML

Com o parâmetro MV_TMSXML = .T. , o Microsiga Protheus armazena no diretório System/tmsxml os arquivos transmitidos e recebidos durantea comunicação com a Operadora de Frota.

OBS: Este arquivos são sobrescritos a cada nova interação.

Para evitar a duplicação de registros de registro por recebimento de arquivos XML iguais são 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, não serão criados novos registros a a partir desse XML.

Quitação de Contrato em Postos: Quando uma quitação em postos chegar, será registrada na tabela DES(Quitação 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 Física, a Repom torna-se responsável por informar, para o Microsiga Protheus, o valor dos seguintes impostos:

IRRF: Imposto de Renda Retido na Fonte

o Código Repom para o imposto: ‘1’ e ‘103’

Boletim Técnico


INSS: Insituto Nacional de Serviço Social


SEST: Serviço Social de Transporte


SENAT: Serviço Nacional de Aprendizagem do Transporte (Somado ao valor do Sest)


Este valores são informado, em uma quitação em Postos, através do método do Microsiga Protheus chamado TmsConsRep (TMSXFUNC), o qual busca o método Repom chamado ConsultaContrato. No caso de uma quitação em Filial, é informado pelo retorno do método Repom QuitaContrato (TMSA251), dentro do node Movimentações.

Processo de Quitação Filial

Só será permitido realizar quitação na filial os fornecedores que estiverem configurados através do campo Local de Quitação = Filial.

Os abastecimentos e saques recebidos antes da quitação são registrados pelo método passagens de postos gerando os sdgs baixados.


2. Realize a geração da Viagem.

3. Em Gestão de Tranportes (SIGATMS) acesse Atualizações / Terceiros / Contrato Carreteiro (TMSA250).

4. Realize a emissão do Contrato Carreteiro.

O Microsiga Protheus chama o método 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 pedágio 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 pedágio fica com status baixado.

O Microsiga Protheus gera o título 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 Movimentação Bancária (SE5);

O Microsiga Protheus gera o título de pedágio no Contas a Pagar (SE2) com o tipo PDG com status de baixado;


Boletim Técnico


Caso a Operadora Repom já tenha realizado o depósito, referente ao adiantamento ou ao pedágio, não será mais possível estornar o contrato, por trava feita durante a verificação do contrato no Sistema da Repom.

5. Aponte saída da viagem em Manutenção no menu Viagem (TMSA350)

6. Aponte ocorrências da viagem (Encerra processo) em Manutenção no menu Viagem (TMSA360 ).

O Microsiga Protheus chama o método QUITA CONTRATO da Repom

O Microsiga Protheus aguarda através do WS (Webservice Server) o retorno do método QUITA CONTRATO RESULT.

Quando o Microsiga Protheus recebe o método QUITA CONTRATO RESULT, verifica se o fornecedor do contrato de carreteiro é pessoa física ou jurídica, se for pessoa jurídica:

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 liberação

Acesse a rotina LIBERA CONTRATO (TMSA251) e realize a liberação do contrato.

O Microsiga Protheus envia o método AUTORIZA PAGAMENTO para REPOM.

O Microsiga Protheus através do método QUITACONTRATO RESULT obtém o valor do saldo e gera o título do saldo a pagar no SE2 com status em aberto.

De acordo com a condição de pagamento do fornecedor o Microsiga Protheus recebe através do WS o método AVISO PAGAMENTO DE CARRETEIRO.

Microsiga Protheus realiza a baixa do título 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 movimentação no Movimentação Bancária (SE5).

7. Quando o Microsiga Protheus recebe o método QUITA CONTRATO RESULT, verifica se o fornecedor do contrato de carreteiro é pessoa física ou jurídica, se for pessoa física:

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 Microsiga Protheus gera o SDG baixado do saldo do contrato;

O status do contrato (DTY) é alterado para aguardando liberação

Acesse a rotina em Atualizações / Terceiro / Libera Contrato (TMSA251) e realize a liberação do contrato.

Boletim Técnico


O Microsiga Protheus envia o método AUTORIZA PAGAMENTO para REPOM.

O Microsiga Protheus através do método QUITACONTRATO RESULT obtém o valor do saldo e gera o título do saldo a pagar no SE2 com status em aberto.

O Microsiga Protheus através do método QUITA CONTRATO RESULT obtém os valores de impostos e gera os títulos de impostos no SE2 com status em aberto.

De acordo com a condição de pagamento do fornecedor o Microsiga Protheus recebe através do WS o método AVISO PAGAMENTO DE CARRETEIRO.

Microsiga Protheus realiza a baixa do título 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 movimentação na movimentação Bancária (SE5).

Processo de Quitação Posto

Só será permitido realizar quitação no posto, os fornecedores que estiverem configurados através do campo Local de Quitação = Posto.

Os abastecimentos e saques recebidos antes da quitação são registrados pelo método passagens de postos gerando os sdgs baixados


2. Realize a geração Viagem.



O Microsiga Protheus chama o método de EMITE CONTRATO da Repom.

O Microsiga Protheus gera o contrato de Carreteiro na Repom.


O Microsiga Protheus gera um SDG de adiantamento, um SDG de pedágio e um SDG com o valor total do Contrato, sendo que os SDGs do pedágio e do adiantamento ficam com status baixado e o SDG do contrato fica com status em aberto.

Gera o título do adiantamento no Contas a Pagar (SE2) com o tipo NCF com status de baixado;

Abate o saldo no banco Repom gerando uma Movimentação Bancária (SE5);

Gera o título de pedágio no Contas a Pagar (SE2) com o tipo PDG com status de baixado;

Abate o saldo no banco Repom gerando uma Movimentação Bancária (SE5);

Caso a Operadora Repom já tenha feito o depósito, referente ao adiantamento ou ao pedágio, não será mais possível estornar o contrato, por trava feita durante a verificação do contrato no Sistema da Repom.

Boletim Técnico


5. Aponte saída da viagem (DTW)

6. Quando o motorista chegar ao posto para realizar a quitação, após o lançamento dos documento no P.O.S. da REPOM o método QUITA CONTRATO é enviado ao WS do Microsiga Protheus.

7. O Microsiga Protheus recebe o método QUITA CONTRATO (TMSA251)

Aponta automaticamente a chegada da viagem (DTW)

Aponta automaticamente as ocorrências 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;


Gera SDG baixado do saldo do contrato de carreteiro;

8. O Microsiga Protheus verifica se o fornecedor do contrato é pessoa física ou jurídica, sendo pessoa jurídica:

O Microsiga Protheus gera o título do saldo no no Contas a Pagar (SE2);

O Microsiga Protheus realiza a baixa do título do saldo no no Contas a Pagar (SE2);

O Microsiga Protheus realiza o abatimento do saldo no banco Repom gerando movimento bancário na movimentação Bancária (SE5);

O Microsiga Protheus realiza a baixa do lançamento do contrato no SDG.

9. O Microsiga Protheus verifica se o fornecedor do contrato é pessoa física ou jurídica, sendo pessoa Física:

O Microsiga Protheus verifica o método: CONSULTA CONTRATO e obtém os valores dos impostos; (TMSXFUNC.PRW)

O Microsiga Protheus atualiza os valores de impostos no contrato de carreteiro (DTY).

O Microsiga Protheus gera os títulos de impostos em aberto na tabela no Contas a Pagar (SE2).

O Microsiga Protheus gera o título do saldo no no Contas a Pagar (SE2);

O Microsiga Protheus realiza a baixa do título do saldo no no Contas a Pagar (SE2);

O Microsiga Protheus realiza o abatimento do saldo no banco Repom gerando movimento bancário na movimentação Bancária (SE5);


Processo de Quitação Baixa Antecipada

Boletim Técnico


Só será permitido realizar quitação baixa antecipada, os fornecedores que estiverem configurados através do campo Local de Quitação = Posto.

Os abastecimentos e saques recebidos antes da quitação são registrados pelo método passagens de postos gerando os SDGs baixados.


2. Realize a geração da Viagem.



O Microsiga Protheus chama o método de EMITE CONTRATO da Repom;

O Microsiga Protheus gera o contrato de Carreteiro na Repom;


O Microsiga Protheus gera um SDG de adiantamento, um SDG de pedágio e um SDG com o valor total do Contrato, sendo que os SDGs do pedágio e do adiantamento ficam com status baixado e o SDG do contrato fica com status em aberto;

O Microsiga Protheus gera o título do adiantamento no Contas a Pagar (SE2) com o tipo NCF com status de baixado;


O Microsiga Protheus gera o título de pedágio no Contas a Pagar (SE2) com o tipo PDG com status de baixado;


Caso a Operadora Repom já tenha feito o depósito, referente ao adiantamento ou ao pedágio, não será mais possível estornar o contrato, por trava feita durante a verificação do contrato no Sistema da Repom.

5. Aponte saída da viagem em Manutenção no menu Viagem (TMSA350)

6. Aponte a chegada da viagem em Manutenção no menu Viagem (TMSA350)

7. Aponte ocorrências da viagem em Manutenção no menu Viagem (TMSA360).

8. Encerre a viagem em Manutenção no menu Viagem (TMS340)

No encerramento da Viagem:

O Microsiga Protheus envia o Método BAIXA ANTECIPADA para REPOM (Neste método constam todos os documentos da ocorrência;

O processo de Quitação é realizado no Posto;

O Microsiga Protheus recebe o método 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;

Boletim Técnico



O Microsiga Protheus gera SDG baixado do saldo do contrato de carreteiro;

O Microsiga Protheus verifica se o fornecedor do contrato é pessoa física ou jurídica, sendo pessoa jurídica:

O Microsiga Protheus gera o título do saldo no Contas a Pagar (SE2);

O Microsiga Protheus realiza a baixa do título do saldo no Contas a Pagar (SE2);

O Microsiga Protheus realiza o abatimento do saldo no banco Repom gerando Movimentação Bancária (SE5);

O Microsiga Protheus realiza a baixa do lançamento do contrato no SDG;

O Microsiga Protheus verifica se o fornecedor do contrato é pessoa física ou jurídica, sendo pessoa Física:

O Microsiga Protheus verifica o método: CONSULTA CONTRATO e obtém os valores dos impostos;

O Microsiga Protheus atualiza os valores de impostos no contrato de carreteiro (DTY);

O Microsiga Protheus gera os títulos de impostos em aberto na tabela Contas a Pagar (SE2);

O Microsiga Protheus gera o título do saldo no Contas a Pagar (SE2);

O Microsiga Protheus realiza a baixa do título do saldo no Contas a Pagar (SE2);

O Microsiga Protheus realiza o abatimento do saldo no banco Repom gerando Movimentação Bancária (SE5);


INFORMAÇÕES TÉCNICAS

Tabelas Utilizadas

SA2 - Fornecedores; DA4 - Motorista; DUO – Perfil do Cliente; DEG – Operadora de Frota; DTY – Contrato de Carreteiro; DEJ – Operações x Operadora; DTR – Complemento de Viagem; SE2 – Contas a Pagar; SE5 – Movimentos Bancários; DES – Quitação 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 – Operações de Transporte; DTQ – Viagem; DTR – Veículos da Viagem; DT2 – Tabela de Ocorrências; DT6 – Documento de Transporte; DUD – Movimento de Viagem

Boletim Técnico


Funções 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; Operação de transporte - TMSA350; Encerramento de viagem - TMSA340; Registro de Ocorrência - 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 títulos a Pagar – FINA080; Compatibilizador Repom – TMS10R168

Sistemas Operacionais Windows/Linux

tms integracao repom fase ii tdyuvj

Documents