ER Integração Repom

Informações Gerais 

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo 

Atualizar a integração entre TMS e Repom utilizando modelos denominados pela Repom como Integração Financeiro e Contábil.

Definição da Regra de Negócio 

Para atender o objetivo acima, será necessária a revisão de métodos utilizados na atual integração. Os pontos de integração entre os sistemas também serão revistos.

O atual serviço de WebService Protheus (TmsEventos, no fonte wstmse65), que a Repom alimenta será descontinuado (serviço de envio da Repom executado por software de transmissão de dados - “BizTalk”). As informações pessoais que eram enviadas pela Repom neste serviço, não serão mais integradas no sistema – tais como, detalhes de saque e compras do cartão creditado no contrato e passagens em postos.

Em substituição ao serviço de envio da Repom ao WebService Protheus, novos métodos de integração desenvolvidos pela Repom, serão consultados com o novo layout de movimentações que foram denominados como financeiro e contábil.

Nestes layout’s poderão ser verificados os dados de encerramento de viagens em postos. Este serviço disponibilizado pela Repom será disponibilizado apenas no dia seguinte ao efetivo ato no posto conveniado.

A seguir, segue mapa mental representando os pontos de integração entre os dois sistemas:

Cadastro de Fornecedor (MATA020) 

O fornecedor do Protheus integra-se como “Contratado” à Repom. O método em que se atualiza esta informação deverá ser alterado para que passe a utilizar o método “IntegraDadosCadastroNacionalANTT”.

No Cadastro de Fornecedores (MATA020) foi disponibilizado o botão “DadosxOper.”, para permitir a integração on-line do fornecedor com a Repom.

Contrato do Fornecedor (TMSA800) 

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. Durante a emissão do contrato na base da Repom, é necessário enviar junto dos dados da viagem, qual operação deseja utilizar.

No cadastro de Contratos de Fornecedores (TMSA800), deverá ser associado a operação Repom a que o fornecedor irá utilizar na integração. Esta operação, se indicada, irá sobrepor a atual indicação que até hoje era indicada no perfil do cliente (devedor do frete na viagem).

As operações devem estar previamente cadastradas na operadora Repom, pois não há integração para inclusão ou manutenção destas – apenas a indicação de qual operação interna Repom será utilizada em cada contrato.

Cadastro de Motoristas (OMSA040)

No Cadastro de Motoristas foi disponibilizado o botão “DadosxOperad.” que permite realizar on-line a integração dos dados do motorista com a Repom. O método em que se atualiza esta informação deverá ser alterado para que passe a utilizar o método “IntegraDadosCadastroNacionalANTT”.

Esta integração também pode ser configurada para ocorrer de maneira automática, por meio da tecla <F12> disponível no browse. Caso a integração seja ativada de forma automática, a cada novo cadastro ou alteração dos dados do motorista, a integração com a Repom será iniciada.

No Cadastro de Motoristas também está disponível o botão “Mot.xOper.”, na barra de ferramentas, permitindo amarrar um cartão ao motorista.

Cadastro de Veículos (OMSA060)

Os veículos do Protheus integram-se como “veículo” ou “carreta” na Repom. O TMS Protheus enviará à Repom como tipo “carreta” aqueles veículos cuja a categoria do tipo de veículo a qual ele pertence esteja como 3-Carreta. As demais categorias serão enviadas como “veículo” à Repom.

No Cadastro de Veículos foi disponibilizado o botão “DadosxOperad.” para realização da integração dos dados com a Repom. O método em que se atualiza esta informação deverá ser alterado para que passe a utilizar o método “IntegraDadosCadastroNacionalANTT”.

Também é possível fazer com que a integração ocorra de forma automática, bastando definir, por meio da tecla <F12>, o parâmetro “Atualizar dados com Operadora” igual a “Sim”.

 
Cadastro de Rotas (OMSA100)

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.

No Cadastro de Rotas existe atualmente uma consulta ao roteiro, baseada na região de origem, onde associa-se o Roteiro selecionado à rota.

Será criada uma tela para a solicitação de Roteiro na Repom a partir do cadastro de Rotas, para as situações onde o Roteiro não existir. A tela deverá conter obrigatoriamente a Origem e o Destino do Roteiro (já sugeridos, se possível, a partir da rota) e, opcionalmente, pontos intermediários em que o Roteiro Repom deverá passar.

A partir desta tela, deverá ser consumido o método “SolicitaRoteiro” da Repom. Esta ação tem até 15min para ser executada pela Repom atualmente e a confirmação da solicitação não significará 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 3.

Exemplo de uso do método “SolicitaRoteiro”

<solicita_roteiros>
<roteiro>
<roteiro_codigo_cliente>abc123</roteiro_codigo_cliente> <!-- Código Cliente --/>
<cidade_origem_ibge>2637</cidade_origem_ibge>
<cidade_origem_cep />
<estado_origem>MT</estado_origem>
<cidade_destino_ibge>18701</cidade_destino_ibge>
<cidade_destino_cep />
<estado_destino>SP</estado_destino>
<tipo_processo_transporte>0</tipo_processo_transporte>
<tempo_previsto_viagem />
<tipo_local_quitacao />
<codigo_local_quitacao />
<ida_volta>0</ida_volta>
<altera_roteiro />
<observacao />
<vias> <!-- OPCIONAL (A TAG PODE SER MANDADA FECHADA "<vias />" -->
<via>
<via_descricao>CAMPO NOVO DO PARECIS-MT</via_descricao>
<via_descricao>CUIABA-MT</via_descricao>
<via_descricao>RONDONOPOLIS-MT</via_descricao>
<via_descricao>SAO JOSE DO RIO PRETO-SP</via_descricao>
</via>
</vias>
</roteiro>
</solicita_roteiros>

Complemento da Viagem (TMSA240) / Abertura da Viagem (TMSA140/141/144) 

Depois de informado o código da operadora no complemento de viagem, ao informar o veículo da viagem, automaticamente será calculado o pedágio referente à rota selecionada na tela de viagem.

O cálculo do pedágio ocorre de maneira on-line e o valor retornado é passado pela Repom:

Exemplo de XML de consulta de pedágio à Repom:

                <roteiro>

                               <roteiro_codigo>23293</roteiro_codigo>

                               <percurso_codigo>4</percurso_codigo>

                               <roteiro_cliente_codigo></roteiro_cliente_codigo>

                               <numero_eixos>3</numero_eixos>

                </roteiro>

Para completar os dados da integração, deve-se informar ainda o número do cartão que o motorista portará durante a viagem. Esse número pode ser obtido automaticamente por meio da amarração entre motorista x cartão.

Mesmo que o número do cartão seja obtido automaticamente, pode-se alterá-lo pelo botão “Mot.Viag.”

Após o preenchimento dos dados do complemento de viagem, esta será gravada. Na gravação, ao utilizar os recursos da integração, serão sincronizados os dados de fornecedores, motoristas e veículos com a base de dados da Repom.

O método de validação do cartão Repom deverá ser retirado desta rotina, pois será utilizado o método “ValidaAbertura”

Exemplo de uso do método “ValidaAberturaContrato” a ser enviado na abertura da viagem:

Destaca-se aqui que a tag “trechos”, que deve ser enviada fechada, para que não solicite novo Roteiro à Repom. 

Fechamento da Viagem (TMSA310) 

A integração dos dados do Protheus com a Repom ocorrerá por viagem, isto é, pode-se definir, a cada viagem, se haverá ou não integração com a Repom.

A emissão do contrato na Repom é o inicio do controle de um processo quando se utiliza frota de terceiros.

No Protheus, a emissão do contrato na Repom será acionada no fechamento da viagem, em que será acionado automaticamente o método “EmiteContrato”.

Esse método processa as informações enviadas com base nos cálculos realizados no Protheus e devolve as informações referente aos pontos de apoio (passagens em postos) e os dados preliminares da quitação do contrato.

A operação de estorno do fechamento deverá chamar o método “CancelaContrato”. 

Segue um exemplo de XML de Emissão de contrato com valor previsto (nova funcionalidade) de R$ 1,00 (um real), sem adiantamento:
 
 <processo_transporte>
       <dados_operacionais>
             <operacao_codigo>1</operacao_codigo>
             <roteiro_codigo>23293</roteiro_codigo>
             <percurso_codigo>4</percurso_codigo>
             <solicitacao_roteiro_codigo></solicitacao_roteiro_codigo>
             <roteiro_cliente_codigo></roteiro_cliente_codigo>
             <roteiro_ida_volta>0</roteiro_ida_volta>
             <filial_codigo_cliente>01</filial_codigo_cliente>
             <processo_cliente_codigo>V-001</processo_cliente_codigo>
             <cartao_codigo>600801097</cartao_codigo>
             <usuario>vlademir</usuario>
       </dados_operacionais>
       <configuracoes_viagem>
             <data_saida>07/11/2016</data_saida>
             <hora_saida>18:00</hora_saida>
       </configuracoes_viagem>
       <documentos_integrados>
             <conhecimentos>
                    <conhecimento>
                           <ctrc_codigo>9990001</ctrc_codigo>
                           <ctrc_serie>1</ctrc_serie>
                           <ctrc_filial_codigo_cliente>01</ctrc_filial_codigo_cliente>
                           <documento_tipo>0</documento_tipo>
                           <nfs>
                                  <nf>
                                        <nf_codigo>320736</nf_codigo>
                                        <nf_serie>10</nf_serie>
                                        <nf_remetente_cnpj>70940994008277</nf_remetente_cnpj>
                                        <nf_remetente_razao>PANDURATA ALIMENTOS LTDA</nf_remetente_razao>
                                        <nf_destinatario_cnpj>75315333016293</nf_destinatario_cnpj>
                                        <nf_destinatario_razao>ATACADAO S.A.</nf_destinatario_razao>
                                  </nf>
                           </nfs>
                    </conhecimento>
             </conhecimentos>
       </documentos_integrados>
       <dados_contratado>
             <contratado_cnpj_cpf>57813639634</contratado_cnpj_cpf>
             <motorista_cpf>29973825802</motorista_cpf>
             <cavalo_placa>IBB5648</cavalo_placa>
             <carreta_placa></carreta_placa>
             <carreta_rntrc></carreta_rntrc>
             <carreta_numero_eixos></carreta_numero_eixos>
       </dados_contratado>
       <dados_carga>
              <antt_ncm_codigo_classificacao_mercadoria>0001</antt_ncm_codigo_classificacao_mercadoria>
             <carga_peso>4998</carga_peso>
             <carga_volume></carga_volume>
             <carga_valor>50449</carga_valor>
             <carga_destinatario_cpf_cnpj>75315333016293</carga_destinatario_cpf_cnpj>
             <carga_destinatario_nome_razao_social>ATACADAO S.A.</carga_destinatario_nome_razao_social>
             <carga_unidade_codigo></carga_unidade_codigo>
       </dados_carga>
       <dados_frete>
             <valor_frete>1</valor_frete>
             <valor_adiantamento>0</valor_adiantamento>
       </dados_frete>
       <movimentos></movimentos>
</processo_transporte>  

Contrato de Carreteiro (TMSA250) 

A geração do Contrato de Carreteiro, que era obrigatória antes do fechamento da viagem, deixará de sê-lo. Na nova integração o contrato de carreteiro será gerado apenas após o fechamento da viagem.

Quando o contrato de carreteiro for gerado, ele calculará a diferença entre o valor previsto enviado no fechamento de viagem e o total do frete (considerando valor com ou sem impostos, de acordo com o parâmetro MV_IMPCTC), atualizando o valor do contrato Repom por meio do método “IncluiMovimento”.

De acordo com a parametrização de geração do título (MV_LIBCTC e DUJ_TITFRE), será quitado o contrato.

Caso o ERP utilizado seja o Protheus, haverá possibilidade de autorizar o pagamento pela rotina “Pagamento de Saldo”, caso seja outro ERP, não há esta possibilidade e a configuração da Repom será de quitação automática ou deve utilizar parametrização que utilize a autorização de pagamento (Liberação de Contrato).

Exemplo de XML de inclusão de movimento: 

                <movimento>

                               <cliente_codigo>0773</cliente_codigo>

                               <processo_transporte_codigo>31</processo_transporte_codigo>

                               <movimento_codigo />

                               <movimento_cliente_codigo>19</movimento_cliente_codigo>

                               <valor>499.00</valor>

                               <tipo_operacao />

                </movimento>

Contrato de Carreteiro Complementar (TMSA250)           

Quando há necessidade de acrescentar valores ao contrato Repom e o contrato de carreteiro já fora gerado, poderá ser gerado o Contrato de Carreteiro Complementar.

O método para a inclusão de valores será o “IncluiMovimento” e seu funcionamento atual está correto.

Liberação para Pagamento do Contrato de Carreteiro (TMSA251) 

Para o fechamento do saldo do contrato Repom, considerados os movimentos de saldo final e também créditos e/ou débitos decorrentes da viagem (seja um contrato complementar ou não), será utilizado o método “QuitaContrato”.

Após o processamento da quitação do contrato de carreteiro, é possível apurar o valor final que é devido ao carreteiro.

Para que o valor final seja creditado na conta corrente do carreteiro, deve-se acionar o método “Autoriza Pagamentos”. Esse método é acionado a partir da Liberação do Contrato de Carreteiro. Ao confirmar a liberação, automaticamente será solicitada a autorização para pagamento do saldo do contrato.