Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Dica
titleO que é a Integração MyFrota Winthor x Sofit4

A integração com Sofit View possibilita a troca de informações entre o sistema de gestão de frota Sofit View e o ERP Winthor.

A integração ocorre por meio da API fornecida pela Sofit e consumidas pelo ERP.


Abaixo é apesentado o fluxo de informações que pode ser realizado por meio da integração com o sistema de gestão de Frotas Sofit View.

Image Added


Para um maior detalhamento de todas as integrações e suas respectivas consultas de dados para envio e recebimento acesse : Myfrota - Fluxo de Integração


Expandir
titleConfigurações iniciais

Rodar as atualizações da rotina 2500;

Em triggers atualize conforme imagem opção 80 e 81:

Image Added




São integradas informações referentes a:

Expandir
titleCadastro de produto


Expandir
titleCadastro de cliente


Expandir
titleCadastro de fornecedor


Expandir
titleCadastro de funcionário

Como integrar um funcionário com o MyFrota?

          

            (aviso) Verifique na plataforma Sofit se existe cadastrada em "Funções de Colaborador" chamada "Motorista"  Obs: Se atente a letra Maiúscula inicial

          


Para integrar um funcionário com o MyFrota, acesse a rotina 528 - Cadastrar Funcionário/Setor, defina o código do Setor e o campo Usa My Frota como Sim.

Se os dois campos não forem definidos, o serviço irá ignorar este funcionário e a integração não ocorrerá. 

mceclip0.pngImage Added

Observação: Existe dois parâmetros na rotina 132 que essa API vai verificar quando for montar a consulta de dados para envio, e caso esses parâmetros não esteja sendo usado a API envia todos os funcionários no qual seu setor esta marcado para uso do myfrota na 528.

  • Para que esses parâmetros funcione a tabela PCPARAMFILIAL precisa está atualizada na ultima versão fazendo essa atualização através da rotina 814.
  • Para que esses parâmetros funcione o job PcJobSofitViewEmployee_2.0 precisa está atualizada na ultima versão.
  • Caso o parâmetro 'MYFROTA_ENVIA_MOTORISTA' esteja ativo será enviado para o myfrota somente funcionário do tipo motorista configurado na rotina 5
  • Image Added
  • Caso o parâmetro 'MYFROTA_MOTORISTA_FUNC' esteja ativo será enviado para o myfrota somente motorista do tipo funcionário configurado na rotina 929.
  • Image Added
Expandir
titleCarregamentos faturados


Expandir
titleTransferência de carregamentos

Myfrota - Fluxo de Integração

Expandir
titleNota de vendas vinculadas a carregamentos


Expandir
titleRequisição de material


Expandir
titleDespesas


Expandir
titleRotas de entrega


Expandir
titleCadastro de veículos




Nota
titleATENÇÂO

A TOTVS não se responsabiliza por aplicações de terceiros instaladas no servidor.

Caso seja encontrada aplicações de terceiros nos diretórios de instalação padrão Winthor e ou Banco de dados, qualquer tipo de atendimento não poderá ser seguido pela TOTVS.

Aviso
titlePré-requisitos
  • Hardware - Requisitos de Instalação:

    • Equipamento: Servidor dedicado
    • Sistema Operacional: Windows 7 10 ou Superior 64bits;
    • Processador: De 4+ núcleos e 2ghz+ de processamento;
    • Memória RAM: mínimo de 8GB (recomendado 16GB);
    • Conexão com Internet.
    • Espaço em Disco: Mínimo de 20gb disponíveis;
    • Conexão com o banco de dados do WinThor;


      Aviso
      titleATENÇÂO
      • Caso a instalação seja feita em uma estação comum de trabalho ou em servidor compartilhado com outra aplicaçãoa performance pode ser seriamente afetada
      • O compartilhamento de recursos pode não só deixar lento quanto também travar a aplicação. Isso acontece porque quando não há recursos suficientes para o processamento da JVM, a sua instancia é fechada, paralisando todos processos dependentes. Desse modo, não poderemos garantir a perfeita execução da aplicação conforme é planejado para ser.


  • Para instalação é preciso de uma chave de acesso que pode ser obtida com o time de produtos ou serviços.

Para isso basta abrir um chamado solicitando chave/Token para integração 2696 Myfrota Sofit4.

Enviar os seguintes dados para gerar o token/chave:

Dados Banco de Dados:

IP: 10.100.1.999995
Porta: 1521
Schema: WINT
Usuário: XXXXX
Senha: YYYYY

Observação: utilizar a consulta select value from v$parameter where name='service_names' para conferir se o Schema está correto.

Anexar arquivos Winthor.ini e TNSNames.ini da maquina onde será instalada a aplicação.


Atenção → Deve estar habilitado o TNS_ADMIN no servidor.

Caso não saiba como fazer seguir o procedimento do link Criando variáveis de ambiente no servidor

Image Added


  • Liberar a porta 61616 (padrão do ActiveMQ) com protocolo TCP para entrada e saída de dados e conexão com a mensageria

          Obs:. Essa liberação é somente para acesso LOCAL e no Firewall, não externo (localhost);

  • Liberar a porta 8040(padrão) com protocolo TCP para entrada e saída de dados e conexão com a API

          Obs: . Essa liberação é somente para acesso LOCAL e no Firewall, não externo (localhost);

  • Liberar uma porta por exemplo: 9001 com protocolo TCP(Externo IP Público) para entrada e saída de dados direcionando as requisições externas para a porta Localhost 8040 API de integração da rotina 2696;
    Atenção! Essa porta pode ser de acordo com a necessidade, não necessariamente a 9001 (Exceto 8040).


  • O servidor não deverá ter outras aplicações com Tecnologia Talend e\ou ActiveMQ, sendo essas exclusivas para uso da integração Winthor 2696Myfrota.


  • Java(JRE) Ultima versão instalada no server e configurar o JAVA_HOME na biblioteca do Windows.


  • Oracle 12 ou inferior (Versões homologadas)
Informações
titleConfiguração e Instalação

Solicite o instalador para equipe TOTVS.

1º Passo: realizar download da pasta compactada:

Image Removed

Image Removed

2º Passo: Descompactar e acessar a pasta INSTALADOR_WINTHOR_ESB\2-INSTALL_CONTAINER\4-SETUP_CONTAINER, executar o arquivo WinThorESB-win_x64-6.5.1.exe

Image Removed

3º Passo: Descompactar e acessar a pasta INSTALADOR_WINTHOR_ESB\3-INSTALL_BUNDLES\1-DEPLOY_BUNDLES, executar o arquivo Install_PrjIntB2bUnilever-4.0.0.jar

Image Removed

Image Removed

Image Removed

Caso os itens selecionados na caixa vermelha não se apresentem selecionados, significa que os arquivos não foram encontrados no servidor em que está sendo instalado.

Image Removed

Image Removed

Iniciando a Instalação do primeiro componente: JDK

Image Removed

Image Removed

Image Removed

Image Removed

Image Removed

Iniciando a instalação do segundo componente: Container

Image Removed

Image Removed

Image Removed

Image Removed

Finalizada a instalação dos componentes, conclui-se a instalação do serviço:

Image Removed

Image Removed

Observação: ao executar os instaladores, será apresentado menu de instalação, basta selecionar next,next,...,next,finish!

4º Passo:  Verificar se o diretório abaixo existe e está acessível:C:\Windows\System32\config\systemprofile\.m2\repository\org\apache\ws\xmlschema\xmlschema-core\2.2.1

Image Removed

Verifique se os arquivos abaixo estão no diretório:

xmlschema-core-2.2.1.jar

xmlschema-core-2.2.1.jar.sha1

Caso não existam os arquivos citados acima, acessar o link abaixo, baixar e salvar no diretório
hps://drive.google.com/file/d/1EF5U_Gb_l__TDSX59wYPQE6rZ2y5Qi0_/view?usp=sharing

5º Passo:  Após realizada a instalação do serviço de integração. todo o diretório abaixo será criado,

sendo necessária atualização dos jobs (pasta jobs) e kars (pasta deploy) disponíveis em

http://servicos.pcinformatica.com.br/autoservico/instaladores/OUTROS_/SERVICOUNILEVER/ 

(Baixar o arquivo FULL_SERVICOUNILEVER.zip)

Diretório da aplicação: C:\pcsist\produtos\integracao\container

Image Removed

6º Passo:  Configurar o IP externo para acesso da Infracommerce:

acessar C:\pcsist\produtos\integracao\container\etc

abrir o arquivo org.ops4j.pax.web.cfg e editar a linha abaixo:

org.osgi.service.http.port.secure=[porta do endereço externo]

7º Passo:  Instalar ActiveMQ .

8º Passo: Configurar Chave Token de banco de dados.

Em posse da chave/Token que foi enviado pelo time de desenvolvimento acessar a pasta: 

C:\pcsist\produtos\integracao\container\config\

Edite o arquivo DataSourcesUnilever.xml com permissão de ADMIN

Altere a chave DataSourceInfo a partir da chave "dbconnection="

conforme imagem a seguir:

Image Removed

Reinicie o serviço para as alterações surgirem efeito.

9º Configuração do SSL no WebService 

9.1 - Configurar as variaveis de ambiente para a JDK.

9.2 -  Criar pasta "keystores" em 
C:\pcsist\produtos\integracao\container\etc e cole na nova pasta seu certificado com formato .pfx

9.3 - Gerar codigo com a senha criptografada, execute o seguinte comando via CMD no local 
C:\pcsist\produtos\integracao\container\etc\keystores.

java -cp lib\jetty-util-9.4.2.v20170220.jar org.eclipse.jetty.util.security.Password 2696 [senha do certificado]

Caso o ocorra erro: (baixe o arquivo jetty-util-9.4.2.v20170220.jar em 
http://www.java2s.com/example/jar/j/download-jettyutil942v20170220jar-file.html crie uma pasta chamada lib em 
C:\pcsist\produtos\integracao\container\etc\keystores e coloque
nesse local o arquivo)

Exemplo de resposta:
 
OBF:19iy19j019j219j419j619j8
MD5:e10adc3949ba59abbe56e057f20f883e
CRYPT:wtk6GOlrfgOJE

9.4 - Execute o seguinte comando via CMD no C:\pcsist\produtos\integracao\container\etc\keystores para gerar 
jks (o formato JKS para armazenar chaves e certificados criptográficos.) 

keytool -importkeystore -srckeystore [nome empresa].pfx -destkeystore [nome empresa].jks -srcstoretype PKCS12 -deststoretype JKS

9.5 - Configure o jetty.xml  que está no diretório /etc/ do Karaf. Adicione as seguintes configurações dentro da tag de <configure>:

    <New id="tlsHttpConfig" class="org.eclipse.jetty.server.HttpConfiguration">
       <Arg>
          <New id="httpConfig" class="org.eclipse.jetty.server.HttpConfiguration">
             <!-- This says... Redirect to https://host:8040 if server returns "NOT SECURE" error -->
             <Set name="secureScheme">https</Set>
             <Set name="securePort">8040</Set>
          </New>
       </Arg>
       <Call name="addCustomizer">
          <Arg>
             <New class="org.eclipse.jetty.server.SecureRequestCustomizer" />
          </Arg>
       </Call>
    </New>
    <!-- This is your HTTP connector, you should have another one for HTTPS -->
    <New class="org.eclipse.jetty.server.ServerConnector">
       <Arg name="server">
          <Ref refid="MyServer" />
       </Arg>
       <Arg name="factories">
          <Array type="org.eclipse.jetty.server.ConnectionFactory">
             <Item>
                <New class="org.eclipse.jetty.server.HttpConnectionFactory">
                   <Arg name="config">
                      <!-- defined above -->
                      <Ref refid="tlsHttpConfig" />
                   </Arg>
                </New>
             </Item>
          </Array>
       </Arg>
       <Set name="host">localhost</Set>
       <Set name="port">8181</Set>
    </New>    

9.6 - Para ativar a conexão por SSL no Karaf, utilize da configuração do Pax Web através do arquivo de configuração 
web do Karaf disponível na pasta /etc/ chamado org.ops4j.pax.web.cfg. Nele, adicione a configuração SSL da keystore 
e password, deixando de acordo com o seguinte:

# Configuração SSL a ser adicionada
org.osgi.service.http.secure.enabled = true
org.ops4j.pax.web.ssl.keystore=${karaf.base}/etc/keystores/[nome do arquivo gerado].jks
org.ops4j.pax.web.ssl.password = OBF:19iy19j019j219j419j619j8 [chave gerada no item 2]
org.ops4j.pax.web.ssl.keypassword = OBF:19iy19j019j219j419j619j8 [chave gerada no item 2]

9.7 - Por fim, iniciar o serviço.

Expandir
titlePasso a passo
Configuração

1. Procedimentos iniciais:

Antes de iniciar o uso da integração com Sofit View, atualize as rotinas:
560 – Atualizar Banco de dados
805 – Central de Integrações
Acesse a rotina 560 – Atualizar Banco de Dados(para versões mais novas do ERP executar na rotina 814) e execute a atualização das seguintes tabelas:


PCINTEGRACAOWTAC
PCINTEGRACAOWTAI
PCCARREG
PCCLIENT
PCEMPR
PCFORNEC
PCFORNECSOFITVIEW
PCINTEGRACAOEXEC
PCINTEGRACAOWTA
PCINTEGRACAOWTAPARAMETRO
PCITENSMYFROTA
PCLOGTRANSFNFCARREG
PCNFSAID
PCPREREQMATCONSUMOC
PCPREREQMATCONSUMOI
PCPRODUT
PCROTAEXP
PCTIPOFORNECSOFITVIEW
PCVEICUL


Solicite o instalador para equipe TOTVS.


Outra Opção de instalação:

Myfrota - Instalação manual do serviço das API


Myfrota - Fluxo de Integração



Expandir
titleImplantação da integração de cliente que já utilizou Myfrota com base nova na Sofit

Ao realizar implantação da integração de cliente que já utilizou Myfrota e já integrou dados com uma nova base Sofit  também será necessário realizar a limpeza dos registros já integrados na base do Winthor conforme a necessidade.


Avalie os registros antigos integrados e realize a limpeza no Winthor conforme a necessidade:


Abaixo exemplo de comandos para realizar a limpeza da integração Myfrota:

Bloco de código
languagesql
--COSTUMER
UPDATE PCCLIENT SET IDSOFITVIEW = NULL, DTULTALTERSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;

--EMPLOYEE
UPDATE PCEMPR SET IDSOFITVIEW = NULL, DTULTALTERSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;

--ITEM
UPDATE PCPRODUT SET IDSOFITVIEW = NULL, DTULTALTERSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;

--ROUTE
UPDATE PCROTAEXP SET IDSOFITVIEW = NULL, DTULTALTERSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;

--SUPPLIER
UPDATE PCFORNEC SET IDSOFITVIEW = NULL, DTULTALTERSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;

--TRIP
UPDATE PCCARREG SET IDSOFITVIEW = NULL, DTULTALTERSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;
UPDATE PCLOGTRANSFNFCARREG SET IDSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;
UPDATE PCNFSAID SET IDSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;

--ORDERSERVICE
UPDATE PCPREREQMATCONSUMOC SET IDSOFITVIEW = NULL, DTULTALTERSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;
UPDATE PCPREREQMATCONSUMOI SET IDSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;

--VEHICLE
UPDATE PCVEICUL SET IDSOFITVIEW = NULL, DTULTALTERSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;

--EXPENSE
UPDATE PCITENSMYFROTA SET IDSOFITVIEW = NULL, DTULTALTERSOFITVIEW = NULL WHERE IDSOFITVIEW IS NOT NULL;
DELETE FROM PCPARCELADESPESAMYFROTA;










Expandir
titleRestaurar IDINTEGRACAOMYFROTA

Ao realizar implantação e o cliente excluiu ou fez migração de dados e não tem o campo IDINTEGRACAOMYFROTA nas tabelas, pode-se criar um novo ID com o comando abaixo:


Avalie os registros antigos integrados e realize a atualização no Winthor conforme a necessidade:


Abaixo exemplo de comandos para realizar a criação:

Bloco de código
languagesql
-- Altere  a tabela conforma a necessidade : COSTUMER ,EMPLOYEE, etc

UPDATE TABELA SET IDINTEGRACAOMYFROTA = SYS_GUID() WHERE IDINTEGRACAOMYFROTA IS NULL ;
Expandir
titlePrincipais dúvidas

Não consigo gerar token para integração o que fazer?

R: Verifique se o serviço esta instalado e ligado, verifique se o usuario e senha informados na rotina 805 estão corretos e verifique se a integração está ativa na 805.

Image Added

Expandir
titlePrincipais dúvidas e conflitos
  • Falta do JAVA impede a instalação e funcionamento da integração?
    Sim, sem os itens marcados abaixo a instalação não conclui e o processo de instalação é interrompido.
    Image Removed
  • O que pode interferir, mesmo que a instalação seja finalizada?
    Forma incorreta de criação das pastas ou pastas duplicadas:
    OBS: geralmente ocorre em criação e restauração de pastas de BKP. Causa conflito e o serviço não encontra os jobs para processamento de dados na integração.
    Image Removed
    Forma correta de criação das pastas:
    Image Removed