TOTVS Distribuição e Varejo - linha Winthor

Páginas filhas
  • Integração WinThor x Venda Digital - Pluginbot

Versões comparadas

Versão antiga 1

changes.mady.by.user Rafael Pessoa Rodrigues

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Beatriz Silveira das Gracas

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Cadastro de veículos

Dica
titleO que é a Integração MyFrota Winthor x Sofit4Venda digital
A integração
com Sofit View
possibilita a troca de informações entre o sistema de
gestão de frota Sofit View
Venda Digital e o ERP
Winthor.
WinThor para processo B2C

A integração ocorre por meio da API fornecida pela Sofit TOTVS WinThor e consumidas pelo ERPapp de Venda Digital.

Abaixo é apesentado apresentado 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 Removed

São integradas informações referentes a:

Expandir
titleCadastro de produto
Expandir
titleCadastro de cliente
Expandir
titleCadastro de fornecedor
Expandir
titleCadastro de funcionário
Expandir
titleCarregamentos faturados
Expandir
titleTransferência de carregamentos
Expandir
titleNota de vendas vinculadas a carregamentos
Expandir
titleRequisição de material
Expandir
titleDespesas
Expandir
titleRotas de entrega
Expandir
title
Nota
titleATENÇÂOATENÇÃ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 WinThor e ou Banco banco de dados, qualquer tipo de atendimento não poderá ser seguido pela TOTVS.

Hardware - Requisitos de Instalação:

  • Equipamento: Servidor dedicado
  • Sistema Operacional: Windows 7 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
    titlePré-requisitos
    Aviso
    titleATENÇÂO
    • Caso a instalação seja feita em uma estação comum de trabalho ou em servidor compartilhado com outra aplicação, a 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 Myfrota Sofit4.

    Enviar os seguintes dados para gerar o token/chave:

    Dados Banco de Dados:

    IP: 10.0.1.995
    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 Removed

    • 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);

    • O servidor não deverá ter outras aplicações com Tecnologia Talend e\ou ActiveMQ, sendo essas exclusivas para uso da integração Winthor Myfrota.
    • Java(JRE) Ultima versão instalada no server e configurar o JAVA_HOME na biblioteca do Windows.
    • Oracle 12 ou inferior (Versões homologadas)

    Antes de iniciar a implantação, verifique se todos os pré-requisitos foram atendidos:

    Informações
    titleConfiguração e Instalação
    Expandir
    titleConfiguração
    Expandir
    titleQuais serviços são necessários realizar a integração?

    Instale os seguintes serviços para realizar a integração entre o sistema de venda digital e o ERP WinThor.

    • winthor-ferramenta-gateway
    • winthor-pedido-venda
    • winthor-compras-produto
    • winthor-estoque-vtex

    Caso tenha dúvidas de como realizar o processo de instalação dos serviços, segue link abaixo para apoiar neste processo:

    Comece por aqui -> Parametrizações WTA

    Expandir
    titleDepartamento

    Quais DEPARTAMENTOS a empresa deseja realizar a integração? Este levantamento deve ser realizado juntamente ao cliente que está realizando a implantação.

    Após essas informações, para realizar o cadastro das departamentos no venda digital, segue link abaixo para apoiar neste cadastro:

    Lembrando que, para que a integração seja realizada com sucesso, o cadastro de departamentos e o vínculo com o produto é OBRIGATÓRIO!

    Caso esse processo não seja realizado da forma correta, a integração não será realizada!

    Expandir
    titleSeção

    Quais SEÇÕES a empresa deseja realizar a integração? Este levantamento deve ser realizado juntamente ao cliente que está realizando a implantação.

    Após essas informações, para realizar o cadastro das seções no venda digital, segue link abaixo para apoiar neste cadastro:

    Lembrando que, para que a integração seja realizada com sucesso, o cadastro de seções e o vínculo com o produto é OBRIGATÓRIO!

    Caso esse processo não seja realizado da forma correta, a integração não será realizada!

    Expandir
    titleCategoria

    Quais CATEGORIAS a empresa deseja realizar a integração? Este levantamento deve ser realizado juntamente ao cliente que está realizando a implantação.

    Após essas informações, para realizar o cadastro das categorias no venda digital, segue link abaixo para apoiar neste cadastro:

    Lembrando que, para que a integração seja realizada com sucesso, o cadastro de categorias e o vínculo com o produto é OBRIGATÓRIO!

    Caso esse processo não seja realizado da forma correta, a integração não será realizada!

    Expandir
    titleMarcas

    Quais MARCAS a empresa deseja realizar a integração? Este levantamento deve ser realizado juntamente ao cliente que está realizando a implantação.

    Após essas informações, para realizar o cadastro das marcas no venda digital, segue link abaixo para apoiar neste cadastro:

    Lembrando que, para que a integração seja realizada com sucesso, o cadastro de marcas e o vínculo com o produto é OBRIGATÓRIO!

    Caso esse processo não seja realizado da forma correta, a integração não será realizada!

    Expandir
    titleProdutos

    Quais PRODUTOS a empresa deseja realizar a integração? Este levantamento deve ser realizado juntamente ao cliente que está realizando a implantação.

    Após essas informações, para realizar o cadastro dos produtos no venda digital, segue link abaixo para apoiar neste cadastro:

    Caso todos os vínculos informados no link acima não sejam realizados de forma correta, a integração dos produtos não será realizada!

    Expandir
    titleEmbalagem/SKU

    Quais EMBALAGENS a empresa deseja realizar a integração? Este levantamento deve ser realizado juntamente ao cliente que está realizando a implantação.

    Após essas informações, para realizar o cadastro das embalagens no venda digital, segue link abaixo para apoiar neste cadastro:

    Expandir
    titleClientes

    Como é realizado o cadastro de CLIENTES e quais clientes a empresa deseja realizar a integração? Este levantamento deve ser realizado juntamente ao cliente que está realizando a implantação.

    Após essas informações, para realizar o cadastro das clientes no venda digital, segue link abaixo para apoiar neste cadastro:

    Expandir
    titleEstoque

    Como é realizado o funcionamento do ESTOQUE DISPONÍVEL na integração no venda digital? Segue abaixo link para demonstrar e apoiar: 

    Expandir
    titlePreços

    Como é realizado a parametrização dos PREÇOS na integração no venda digital? Segue abaixo link para demonstrar e apoiar: 

    Expandir
    titleDúvidas frequentes
    Expandir
    titleVerificação dos serviços instalados

    Após a instalação dos serviços, verificar através da rotina 812 - Gerenciamento do ambiente WTA se todos os serviços foram instalados de acordo com a versão solicitada durante a instalação.

    Image Added


    Para realizar a pesquisa, informe o serviço instalado no filtro "Pesquisa" e clique no ícone da lupa. 

    Image Added

    A rotina listará o serviço instalado, juntamente com a descrição e sua respectiva versão instalada, além do estado do serviço (online ou offline).

    Image Added


    Expandir
    titleConsulta de logs

    Caso tenha algum tipo de problemas na instalação do serviços, para consultar os logs, acesse a rotina 810 - Gerenciamento de logs, realize o download do log que deseja analisar e verifique o problema ocorrido.

    Image Added


    Para realizar a pesquisa, informe o log desejado no filtro "Pesquisa" e clique no ícone da lupa. 

    Image Added

    A rotina listará os logs gerados e para realizar o download do arquivo para análise, clique no link "Download log".

    Image Added

    O log será salvo na pasta de downloads da máquina do usuário.

    Expandir
    titleBiblioteca das API's

    Baixe aqui a coleção de API's

    View file
    nameLOCAL - 8889.postman_environment.json
    height250
    View file
    nameAPI Integrações OFICIAL.postman_collection.json
    height250

    Como sugestão, utilizamos a ferramenta POSTMAN para realizar as requisições das API's,

    Clique aqui para acessar um manual de como utilizar a ferramenta.

    Aviso

    Caso tenha a necessidade de pesquisar todos os serviços instalados através do POSTMAN, pode utilizar a seguinte requisição abaixo:

    URI: http://{{host}}:{{port}}/winthor/ferramenta/servidor/v1/info/winthor-features/all

    Expandir
    titleGeração de token de autenticação

    Para realizar a geração do token de autenticação e utilizar as API's, segue link para apoio:

    Expandir
    titleComo consultar os pedidos integrados?

    Para verificar se o pedido foi integrado entre venda digital e o ERP WinThor, o usuário pode utilizar as seguintes rotinas:

    Alterar a posição do pedido de venda, segue link abaixo para auxiliar na utilização da rotina:

    Cancelar o pedido de venda realizado, segue link abaixo para auxiliar na utilização da rotina:

    Expandir
    titleComo acessar o WTA - Winthor Anywhere em outras estações?

    Para acessar o Winthor Anywhere em outra estação de trabalho da sua empresa realize os seguintes passos:

    1. Acesse a rotina 132 - Parâmetros da presidência
    2. Obtenha o ID e PORTA do WTA nos parâmetros 2851- IP do Servidor WTA e 2849 - Número da Porta do WTA respectivamente;
    3. Acesse o seu navegador de internet e coloque o IP e a PORTA separados por ":", conforme exemplo: 10.62.46.50:8180
    4. Ao abrir a tela de acesso da ferramenta, utilize o mesmo usuário e senha do WinThor.

    Aviso

    Caso não consiga trafegar pelo navegador da máquina da sua empresa é possível que seja bloqueio por conta de ferramentas como (microtic, Firewall e ou PF Sense), então solicite para o administrador da rede de infraestrutura para fazer a liberação.

    Expandir
    titleExportar XML de NF-e

    Para exportar XML de NF-e emitida na rotina 1452, realize os procedimentos abaixo conforme link:

    Informações
    titleConfiguração e Instalação

    Em Construçã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:

    PCCARREG
    PCCLIENT
    PCEMPR
    PCFORNEC
    PCFORNECSOFITVIEW
    PCINTEGRACAOEXEC
    PCINTEGRACAOWTA
    PCINTEGRACAOWTAPARAMETRO
    PCITENSMYFROTA

    PCLOGTRANSFNFCARREG
    PCNFSAID
    PCPREREQMATCONSUMOC
    PCPREREQMATCONSUMOI
    PCPRODUT
    PCROTAEXP
    PCTIPOFORNECSOFITVIEW
    PCVEICUL

    2. Parametrização:

    O casdastro da integração com Sofit View é realizado na rotina 805 disponível no Winthor Anywhere(WTA).

    Abra a rotina 805 e clique em "Adicionar integração".

    Image Removed

    Solicite o instalador para equipe TOTVS.

    1º Passo: realizar download da pasta compactada:

    Expandir
    titleConfiguração
    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