# Vhsys

O sistema de gestão feito para a pequena empresa ganhar tempo e aumentar as vendas.

#### Quer saber mais sobre a Vhsys?

* Website: <https://www.vhsys.com.br/>
* Instagram: <https://www.instagram.com/vhsys_>
* Linkedin: <https://www.linkedin.com/company/vhsys/>

***

### Recursos da Integração

Esta integração tem como principal intuito a sincronização de **produtos** e **pedidos** entre ambas plataformas. Abaixo, segue a lista de recursos disponibilizados:

| Ação                                                                                               | Descrição                                                                                                                |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| [Importação de produtos](#importacao-de-produtos)                                                  | Permite importar produtos cadastrados na **Vhsys** para sua loja virtual                                                 |
| [Mapeamento de categorias](#mapeamento-de-categorias)                                              | Permite mapear uma categoria da **Vhsys** com uma ou mais categorias da loja virtual                                     |
| [Atualização automática de preços e estoques da loja virtual](#atualizacao-automatica-de-produtos) | Permite sincronizar, automaticamente, o estoque e preço dos produtos de sua loja virtual com base nos dados da **Vhsys** |
| [Atualização manual de preços e estoques da loja virtual](#atualizacao-manual-de-produtos)         | Permite sincronizar, manualmente, o estoque e preço dos produtos de sua loja virtual com base nos dados da **Vhsys**     |
| [ ](#exportacao-de-pedidos)[Envio de pedidos para Vhsys](#exportacao-de-pedidos)                   | Permite enviar, automaticamente, os pedidos de sua loja virtual para **Vhsys**                                           |

### :wrench: Configurando a Integração

Antes de começar a realizar esta integração é necessário que você tenha uma conta ativa na **Vhsys** com o aplicativo [Integração via API](https://www.vhsys.com.br/integracoes/api-vhsys) já instalado e tenha em mãos os seguintes dados: **Access-Token** e **Secret-Access-Token.**

<figure><img src="https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FsEWtK6nJ4HgsbLpcjpXh%2Fimage.png?alt=media&#x26;token=65cbe8cb-592a-46a3-bd11-5a15847722c4" alt=""><figcaption><p>Tokens de acesso a API <strong>Vhsys</strong></p></figcaption></figure>

{% hint style="info" %}
**Como gerar os tokens de acesso?**

Caso o aplicativo "Integração via API" não esteja já instalado, você precisará gerar um novo token para que **Access-Token** e o **Secret-Access-Token** sejam exibidos.\
\
Para isso, basta abrir a página do aplicativo de integração via API na **Vhsys** e clicar no botão: ![](https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FwKoC5x1olFLYmU11zaC7%2Fimage.png?alt=media\&token=b3906684-4146-4153-b561-b3622e3b54e2)\
\
Feito isso, as chaves serão geradas e você já poderá seguir o processo de integração :smile:
{% endhint %}

#### Com tudo em mãos, vamos lá!

&#x20;<mark style="background-color:blue;">**PASSO 1:**</mark> <mark style="background-color:blue;"></mark><mark style="background-color:blue;">Instalar o aplicativo da Vhsys</mark> \
\
Acesse o painel administrativo da Get Commerce, e vá ao menu **Sistema, Central de Instalações, Integrações**. Identifique a aba "Sistemas de Gestão ERP" e clique em Instalar no aplicativo da Vhsys.

Pronto! Agora clique em "***Configurar*****"** para acessar a aba de configurações.\
Ou se preferir, acesse as configurações diretamente pelo menu ***Sistema, Configurações da loja*** e identifique a aba ***Integrações, Sistemas de Gestão ERP***.

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5c6c14cf042863543ccd2b00/images/6373dd68bedde91b3d8c92a3/file-FKSipsn7Ni.png)

&#x20;<mark style="background-color:blue;">**PASSO 2:**</mark> <mark style="background-color:blue;"></mark><mark style="background-color:blue;">Configurar a Integração</mark> <br>

A configuração da integração é realizada por seções, onde cada seção possui seus campos específicos de configuração. Abaixo, segue o detalhamento de cada uma delas:

<details>

<summary>Geral</summary>

Nesta seção são tratadas as configurações gerais da integração, que afetam todas suas funcionalidades.\
\
:gear: **Atributos**

* `Habilitado` -> Permite habilitar/desabilitar todas as funcionalidades da integração.

</details>

<details>

<summary>Autorização</summary>

Nesta seção são tratadas as configurações de autorização. Ou seja, as informações que serão enviadas para autorizar as trocas de informação entre a loja virtual e a **Vhsys.** \
\
:gear: **Atributos**

* `Access Token` -> Adquirido na **Vhsys** anteriormente;
* `Secret Access Token` -> Adquirido na **Vhsys** anteriormente.

</details>

<details>

<summary>Produtos</summary>

Nesta seção são tratadas as configurações relativas aos produtos.\
\
:gear: **Atributos**

* `Atualizar automaticamente` -> Permite habilitar/desabilitar a atualização automática de produtos;
* `Atributos` -> Define quais atributos dos produtos da loja virtual serão atualizados com base nos dados puxados da **Vhsys;** \
  \
  Ex.: Se "Preço" e "Estoque" estiverem marcados, o estoque e preço dos produtos da **Get Commerce** serão atualizados com base nos dados dos respectivos produtos na **Vhsys**;
* `Margem de preço (%)` -> Margem de preço, em porcentagem (sem o "%") que será aplicada a atualizações de preço e na importação de produtos da **Vhsys**;

</details>

<details>

<summary>Pedidos</summary>

Nesta seção são tratadas as configurações relativas aos pedidos.\
\
:gear: **Atributos**

* `Exportar automaticamente` -> Permite habilitar/desabilitar a exportação automática de pedidos da **Get Commerce** para **Vhsys;**\
  \
  Obs.: Apenas pedidos com status **Processando** ou **Completo** serão automaticamente exportados.
  * `Exportar após` -> Apenas exportará os pedidos realizados após a data acima.

</details>

Após as configurações serem feitas, a integração já estará pronta para uso!

***

### **Utilizando os Recursos da Integração**

Abaixo, segue informações detalhadas de como utilizar/como funcionam os recursos desta integração.

***

#### :arrow\_down: **Importação de Produtos**

Com este recurso você conseguirá importar produtos cadastrados na **Vhsys** para sua loja virtual de maneira muito simples! Segue abaixo o tutorial:<br>

&#x20;<mark style="background-color:blue;">**PASSO 1**</mark><mark style="background-color:blue;">: Abrindo a tela de importação</mark>&#x20;

Em sua loja virtual, acesse a aba **Catálogo, Gerenciar Produtos**. Você ira notar um novo botão no canto superior direito da tela: ![](https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FW5PzApKs94rtAutPagsD%2Fimage.png?alt=media\&token=12ba558f-5b28-4718-bd37-4960c4bb4f50)

Clique no mesmo para abrir a página de importação de produtos da **Vhsys**.

{% hint style="info" %}
**Tela de Carregamento**

Assim que a página for aberta, o carregamento de produtos será iniciado. Permaneça na página até que o carregamento chegue ao fim.\
\
Após finalizar, os produtos serão salvos em cache, fazendo com que o próximo acesso à página seja praticamente instantâneo.
{% endhint %}

&#x20;<mark style="background-color:blue;">**PASSO 2:**</mark> <mark style="background-color:blue;"></mark><mark style="background-color:blue;">Configurando a importação</mark>&#x20;

Com os produtos já carregados, agora basta selecionar os produtos que deseja importar, selecionar a ação `Importar` e clicar em: <img src="https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FRneAa2BmHjb77d2ME0vF%2Fimage.png?alt=media&#x26;token=17c49de9-7d2d-4ee9-8098-32c4cc3c01bb" alt="" data-size="original">

<figure><img src="https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2Fn6QFZqlzPmmi8dxCfwNF%2Fimage.png?alt=media&#x26;token=9aa0f7b9-755f-4594-b898-aff3598a4718" alt=""><figcaption><p>Configuração da importação de produtos da <strong>Vhsys</strong></p></figcaption></figure>

Feito isso, um processo será agendado e, dentro de 10\~20 minutos, a importação será realizada automaticamente! Fácil, né? :smile:\
\
Você pode acompanhar o status do processo na aba **Configurações, Processos Agendados** de sua plataforma **Get Commerce**.

<figure><img src="https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FLI6namPxq8JBDEejZju3%2Fimage.png?alt=media&#x26;token=2cfb1a44-3845-49ff-8ee0-69a28cb2fc6f" alt=""><figcaption><p>Processo de importação <strong>Vhsys</strong> agendado </p></figcaption></figure>

{% hint style="warning" %}
**Produtos novos não são listados?**

Como os produtos são salvos em cache para agilizar o acesso aos mesmos, é possível que produtos recentemente cadastrados na **Vhsys** não sejam listados na página de importação.\
\
Para resolver isto é bem simples: basta clicar no botão: ![](https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FHsfc9cm8i2McwaQe7SOD%2Fimage.png?alt=media\&token=ff56fa39-184b-460c-8420-860457de55fc) presente nesta página. Assim, os produtos serão recarregados e os novos produtos serão listados :smile:
{% endhint %}

***

#### :map: Mapeamento de Categorias

Este recurso permite mapear uma categoria da **Vhsys** com uma ou mais categorias da loja virtual.

Assim, ao importar um produto da **Vhsys**, este será associado a categoria da **Get Commerce** mapeada à categoria da **Vhsys** que o produto em questão faz parte. \
\
\* Caso não haja nenhuma categoria **Get Commerce** associada à categoria **Vhsys** do produto, será criada uma nova categoria com o nome desta categoria.

<figure><img src="https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2F99ipcngtApD5cMTCLRmn%2Fimage.png?alt=media&#x26;token=3278d74e-9cc6-45b0-ab0d-82393ce8e7f7" alt=""><figcaption><p>Campo de cateogrias no painel <strong>Vhsys</strong></p></figcaption></figure>

Para criar um mapeamento, basta seguir o passo a passo abaixo:

&#x20;<mark style="background-color:blue;">**PASSO 1:**</mark> <mark style="background-color:blue;"></mark><mark style="background-color:blue;">Acessando a página de mapeamento de categorias</mark>&#x20;

Em seu painel **Get Commerce**, acesse a aba **Configurações -> Minhas Integrações -> Vhsys -> Mapear Categorias.**

&#x20;<mark style="background-color:blue;">**PASSO 2:**</mark> <mark style="background-color:blue;"></mark><mark style="background-color:blue;">Criando um mapeamento</mark>&#x20;

Com a página aberta, selecione uma categoria da **Get Commerce** (campo `ID`) que será mapeada a uma categoria da **Vhsys** (campo `ID Externo`). Após escolher, basta clicar em: ![](https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FqmvtYi9FVmbhKcer7Vbl%2Fimage.png?alt=media\&token=0b902002-8223-4e9a-a0a0-156cebbe7aa4) para efetuar o mapeamento.

<figure><img src="https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2Fu7fEHzNWNU225mAl740p%2Fimage.png?alt=media&#x26;token=7d231b13-4935-4c9d-be03-24e320f986d6" alt=""><figcaption><p>Mapeamento da categoria <strong>Get Commerce</strong> "Catálogo" para categoria <strong>Vhsys</strong> "Categoria Exemplo"</p></figcaption></figure>

***

#### :arrow\_heading\_down: **Atualização Automática de Produtos**

Este recurso permite a sincronização de produtos da sua loja virtual com base nas informações puxadas da **Vhsys**. As sincronizações são performadas automaticamente várias vezes ao dia em horários estratégicos para não afetarem a performance da loja.

Os atributos a serem atualizados são aqueles definidos em [Configurações -> Produtos -> Atributos](#produtos)**.** Ou seja, se as opções "Preço" e "Estoque" forem marcadas, o estoque e preço dos produtos da <mark style="background-color:blue;">**Get Commerce**</mark> serão atualizados com base nos dados dos respectivos produtos na <mark style="background-color:orange;">**Vhsys**</mark>.

{% hint style="warning" %}
**Vínculo de Produtos**

Para que os produtos da loja virtual sejam automaticamente atualizados é **obrigatório** que seus SKUs sejam **idênticos** ao **ID do Produto** na **Vhsys**.\
\
\* O ID dos produtos pode ser adquirido nas planilhas de exportação na plataforma **Vhsys.**
{% endhint %}

{% hint style="info" %}
**Margem de Preço**

É possível definir uma margem de preço (em %) através das configurações da integração ([Configurações -> Produtos -> Margem de Preço (%)](#produtos)). Esta margem será aplicada a produtos importados da **Vhsys** e em atualizações automáticas.\
\
Ex.: Caso o campo esteja configurado com o valor `200`, um produto que tem preço R$ 100,00 na **Vhsys** será importado (ou atualizado, caso já exista em sua plataforma **Get Commerce**) com preço igual a R$ 200,00 (200%).
{% endhint %}

***

#### :arrow\_heading\_down: Atualização Manual de Produtos

Este recurso permite a atualização manual de produtos da sua loja virtual. Este recurso é útil em casos de urgência, onde você precisa atualizar as informações de um ou mais produtos da sua loja virtual o mais rápido possível.&#x20;

Para realizar este processo basta acessar a aba **Catálogo, Gerenciar Produtos** em sua loja virtual, selecionar o(s) produto(s) que deseja atualizar e enviar a ação **\[Vhsys] Atualizar**:

<figure><img src="https://2206415355-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc5NHXi3gnF78PHsX87v1%2Fuploads%2FVsAE66Y4tQPrKqvDTqFB%2Fimage.png?alt=media&#x26;token=d5bb7bc0-7ca2-40ac-b8f8-b1a574555b32" alt=""><figcaption><p>Passo a passo para atualização manual de produtos</p></figcaption></figure>

Feito isso, um processo será agendado e rodado automaticamente dentro de alguns minutos.&#x20;

***

#### :arrow\_up: Exportação de Pedidos

Este recurso possibilita a exportação **automática** de pedidos realizados em sua loja virtual para a **Vhsys.** Algumas considerações importantes sobre a exportação:

* Apenas pedidos com status **Processando** ou **Completo** (já faturados) são exportados para **Vhsys;**