> For the complete documentation index, see [llms.txt](https://documentacao.aheadsistemas.com.br/ahead-sistemas/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentacao.aheadsistemas.com.br/ahead-sistemas/comercial/integracao-ecommerce.md).

# Integração Ecommerce

{% hint style="info" %}
**Caminho até lá:** ![](/files/IcLVUYoEZpLADqgDwCs6) **Comercial** ➔ **Integração Ecommerce** 
{% endhint %}

![](/files/VeFd8zQsVPJG5cAOW7L3)

### Alguns Conceitos 

Para entender o funcionamento do **Ecommerce** <mark style="color:red;">no AHEAD</mark> é extremamente importante entender alguns conceitos básicos de funcionamento antes.

* O <mark style="color:red;">AHEAD</mark> utiliza o <mark style="color:red;">Tray</mark> para realizar a comunicação e buscar pedidos, clientes e atualizar o estoque de **Produtos Ecommerce**&#x20;
* O <mark style="color:red;">Tray</mark> é um hub de marketplaces que comunica-se com plataformas como **Mercado Livre**, **Magalu**, etc.
* Os códigos dos produtos registrados no <mark style="color:red;">AHEAD</mark> são diferentes do **ID** que ele possui no <mark style="color:red;">Tray</mark>, por isso, é **importante** não alterar o código de um produto no <mark style="color:red;">Tray</mark> após ele ter sido sincronizado com o <mark style="color:red;">AHEAD</mark>&#x20;
* O botão "**Sincronizar**" localizado em **Comercial ➔ Integração Ecommerce ➔ Sincronização** é o meio que o <mark style="color:red;">AHEAD</mark> utiliza para comunicar-se com o <mark style="color:red;">Tray</mark>.

## Lojas

Diferente de uma **loja física**, ter uma variedade de produtos de diferentes tipos, muitas vezes não é conveniente para o <mark style="color:red;">cliente</mark>, visto que, em uma busca online é procurado algo mais **específico** e com objetividade. Por esse motivo, é possível criar diversas <mark style="color:red;">**Lojas**</mark> com diferentes tipos de **produtos** para o <mark style="color:red;">cliente</mark> saber o que encontrará.&#x20;

{% hint style="info" %}
**Caminho até lá:** ![](/files/IcLVUYoEZpLADqgDwCs6) **Comercial ➔ Integração Ecommerce ➔ Lojas**
{% endhint %}

![](/files/a2n6HK8XxBLQ1xDIhvho)

### Criando uma nova Loja&#x20;

{% hint style="danger" %}
Esse processo é realizado por nós da <mark style="color:red;">AHEAD</mark>, ou seja, não é necessário ser feito pelo usuário.
{% endhint %}

**1)** Clicar em "**Novo Registro**"&#x20;

![](/files/81EiKiZ1yZrpcgqBVqAM)

**2)** Preencher os **campos obrigatórios**<mark style="color:red;">\*</mark>&#x20;

![](/files/ukjQ1iQ9r9Oom38p25ja)

{% hint style="info" %}
Os campos <mark style="color:red;">**Consumer Key**</mark> e <mark style="color:red;">**Consumer Secret**</mark> são necessários para o <mark style="color:red;">AHEAD</mark> poder entrar em contato com o <mark style="color:red;">Tray</mark> e buscar as informações de **pedidos.**&#x20;
{% endhint %}

* **Status Buscar Pedido:**

Informa-se nesse campo qual a descrição os produtos terão que ter no <mark style="color:red;">Tray</mark> para o <mark style="color:red;">Ahead</mark> buscar o **Pedido**.

![Informação contida clicando no ](/files/UZXporHw8E8FEITPbd3y)

* **Status Atualizar Pedido:**

Caso alguma informação não esteja de acordo ou tenha sido **alterada**, necessitando assim, **atualizar** algum registro, é possível através desse campo conversar com o <mark style="color:red;">Tray</mark> para que a informação esteja de acordo.

![Informação contida clicando no ](/files/rPWkPkDlY6bqOMZhSnuQ)

* **Status Buscar Pedido Cancelado:**

Quando um **Pedido** é cancelado no <mark style="color:red;">Tray</mark>, é necessário informar nesse campo qual status será buscado para o <mark style="color:red;">Ahead</mark> entender quando ele foi cancelado

* **Status Atualizar Pedido Cancelado:**

Seguindo a mesma lógica de atualizar as informações de um **Pedido**, nesse campo é possível atualizar as informações de um pedido já **cancelado**

* **Status PE ao Faturar Nota:**

Esse campo é utilizado para comunicar-se com o <mark style="color:red;">Tray</mark> para prover a informação de que o **pedido** já foi faturado e emitido a nota.&#x20;

![Informação contida clicando no ](/files/PKIeNeZcV6aaCp736mR6)

## Categorias

Quando trata-se de <mark style="color:red;">**Ecommerce**</mark>, a diversidade de produtos que são trabalhados é grande, então, para isso, existe a **Relação de Categorias de Produtos Ecommerce** na qual é possível classificar e segmentar os produtos comercializados.

{% hint style="info" %}
**Caminho até lá:** ![](/files/IcLVUYoEZpLADqgDwCs6) **Comercial ➔ Integração Ecommerce ➔ Categorias**&#x20;
{% endhint %}

![](/files/x6QR7E823P8UFLIBFDEr)

### Criando uma nova Categoria&#x20;

**1)** Clicar em "**Novo Registro**"&#x20;

![](/files/uiE7Ah2W6oOW6s39zjBb)

**2)** Preencher os **campos obrigatórios**<mark style="color:red;">\*</mark> e informar a qual **Loja** ele pertencerá&#x20;

![](/files/sgq75A5qnHACsHzYdNEa)

{% hint style="warning" %}
O **código** está relacionado a ordem em que aparecerá na listagem
{% endhint %}

## Produtos Ecommerce

Os Produtos cadastrados para Ecommerce possuem características a mais do que a de produtos físicos

{% hint style="info" %}
**Caminho até lá:** ![](/files/IcLVUYoEZpLADqgDwCs6) **Comercial ➔ Integração Ecommerce ➔ Produtos Ecommerce**
{% endhint %}

![](/files/g722K87VmZLlNWkl2TRT)

### Cadastrando um novo Produto Ecommerce&#x20;

{% hint style="info" %}
Apenas criar um <mark style="color:red;">**Produto Ecommerce**</mark> não é o suficiente para avisar o <mark style="color:red;">Tray</mark> que foi criado um novo **produto**! Após concluir todas as etapas, é necessário realizar a "**Sincronização**"
{% endhint %}

**1)** Clicar em "**Novo Registro**"&#x20;

![](/files/evc2qGXrhbW548KLDOyu)

**2)** Existem mais **campos preenchíveis** em comparação com o **Cadastro de Produtos** normal, porém a lógica é parecida, preencha todos os **campos obrigatórios**<mark style="color:red;">**\***</mark> e coloque especificações caso julgue interessante:

![](/files/s9T57UDJWjuGnxUmBsJ8)

![](/files/IFHu4V84FHUScnwnAnpg)

### Cadastro de Kits

Os <mark style="color:red;">**kits**</mark> são muito convencionais quando se trata de **compras online**, o sistema <mark style="color:red;">**Ahead**</mark> não controla o estoque de <mark style="color:red;">**Kits**</mark>**,** somente controla a quantidade de seus componentes. O controle de **kits** é realizado pela plataforma <mark style="color:red;">Tray</mark>.

**➔ Para informar se um produto possui&#x20;**<mark style="color:red;">**kit**</mark>**&#x20;ou não, é necessário seguir os seguintes passos:**

* **Clicar** em  ![](/files/DX3Vq2FgntwZabINhfdl) para editar o <mark style="color:red;">**Produto Ecommerce**</mark>&#x20;

![](/files/SeNRXzfLPTTWBHfRWKuz)

* Em **Cadastro do Produto** é possível visualizar a opção mais abaixo "**Produto possui&#x20;**<mark style="color:red;">**kit**</mark>", ao marcar como "sim" aparecerá o campo "**Componentes**" antes não visto&#x20;

![](/files/MjTQ44iXF6FrPmdgLUZJ)

* Dentro desse campo serão dadas as **informações básicas** dos produtos contidos no <mark style="color:red;">**kit**</mark>, o <mark style="color:red;">AHEAD</mark> levará esses dados para o <mark style="color:red;">Tray</mark> e o mesmo trará novamente ao <mark style="color:red;">AHEAD</mark> por meio da sincronização, atualizando quantidades de estoque.

![](/files/SSBzQUkd10PEvpCgfH0J)

## Sincronização&#x20;

Recapitulando, a <mark style="color:red;">**Sincronização**</mark> é o meio do <mark style="color:red;">AHEAD</mark> comunicar-se com o <mark style="color:red;">Tray</mark> e trazer informações como: **pedidos**, **clientes** e **movimentar estoque**. Por esse motivo, é necessário realizar o uso do botão <mark style="color:red;">**Sincronização**</mark> para atualizar qualquer dado alterado em algum dos sistemas.&#x20;

### Utilizando o botão Sincronização&#x20;

{% hint style="info" %}
**Caminho até lá:** ![](/files/IcLVUYoEZpLADqgDwCs6) **Comercial ➔ Integração Ecommerce  ➔ Sincronização**&#x20;
{% endhint %}

![](/files/NFJ7RvUAN24iLdQcUbQS)

**1) Selecionar** a **Loja** que deseja ser realizada a <mark style="color:red;">**Sincronização**</mark> na aba "**Pedidos**"&#x20;

![](/files/MQNj3B5ed9YAVd9dRMwj)

**2) Clicar** em "<mark style="color:red;">**Sincronizar**</mark>" que, automaticamente, irá ser feita a troca de informações de **pedido** e **estoque**&#x20;

![](/files/jN3OEuSyrMQMzqLYrjuQ)

**3)** **Além disso**, irão ser trazidas informações específicas como, quais foram os <mark style="color:red;">**Produtos de Estoque Atualizados**</mark>, informando qual estoque os mesmos pertencem

![](/files/md4TEj7rPuRiDvANzjLY)

**4)** Também irá ser possível visualizar uma **listagem** com todos os <mark style="color:red;">**erros**</mark> que deram&#x20;

![](/files/fpaq0Arpwru8Pa1Y2rxg)

* Dentro da Aba "**Logs Sincronização**" é possível visualizar com detalhes todas as sincronizações realizadas, exibindo seus **pedidos**, **produtos atualizados**, **pedidos cancelados** e **erros**

![](/files/RG2DAqJhlJIMNBwu9hHg)

{% hint style="info" %}
Quando ocorrer algum erro em uma sincronização o **Log** daquela tentativa estará com a cor **branca**
{% endhint %}

* A Aba "**Nota Fiscal**" exibe todas notas emitidas por meio do <mark style="color:red;">**Ecommerce**</mark>, lá poderão ser visualizadas informações como: **Chave de Acesso**, **Valores** e **Clientes**

![](/files/nGTeGk3MQYl0Rm46Ik1m)

## Pedidos Ecommerce

{% hint style="info" %}
**Caminho até lá:** ![](/files/IcLVUYoEZpLADqgDwCs6) **Comercial ➔ Pedidos ➔ Pedidos**
{% endhint %}

![](/files/d4o9mUZM8WTAZbnzR52g)

Os pedidos realizados por <mark style="color:red;">**Ecommerce**</mark> são filtrados por **Pedidos Web - PEW**, e para realizar a **filtragem** é necessário seguir os seguintes passos:

**1)** Clicar em ![](/files/QzBda51bQ3XaWfVMWoYA) e selecionar **PEW**

![](/files/J3xtwVTRLxXcwJ50yIEG)

**2)** Clicar em "**Filtrar Pedidos**"&#x20;

![](/files/8FFP2xrEYGCJoKRbMkfN)

**➔** Nessa etapa serão exibidos todos os pedidos buscados através da **Sincronização** com o <mark style="color:red;">Tray</mark>

### Faturando Pedidos Ecommerce

Os **Pedidos Web** são faturados da mesma maneira que os pedidos normais. Para faturá-los é necessário seguir os seguintes passos:&#x20;

**1)** Selecionar os **Pedidos** que serão faturados

![](/files/K9t6b9kqtWhj8r2gHPLX)

**2)** Clicar em "**Gerar Notas**"

![](/files/Iz4AKHr0MbqBFrrnbRMK)

**3)** Selecionar "**sim**" e a nota será gerada

![](/files/ke86IyacTIdrk7kLvAiC)

{% hint style="info" %}
Ao marcar como sim o sistema irá comunicar-se com o <mark style="color:red;">**Tray**</mark> enviando o **xml** da **NFe**.
{% endhint %}

**➔** Caso dê algum <mark style="color:red;">erro</mark> na sincronização da nota, há a opção de reenviar ela pela Aba de "**Nota Fiscal**" dentro de <mark style="color:red;">**Sincronização**</mark>

![](/files/63zG3T4Ib1IY8bSgFuCZ)