# Integração Ecommerce
{% hint style="info" %}
**Caminho até lá:**  **Comercial** ➔ **Integração Ecommerce**
{% endhint %}
### Alguns Conceitos
Para entender o funcionamento do **Ecommerce** no AHEAD é extremamente importante entender alguns conceitos básicos de funcionamento antes.
* O AHEAD utiliza o Tray para realizar a comunicação e buscar pedidos, clientes e atualizar o estoque de **Produtos Ecommerce**
* O Tray é um hub de marketplaces que comunica-se com plataformas como **Mercado Livre**, **Magalu**, etc.
* Os códigos dos produtos registrados no AHEAD são diferentes do **ID** que ele possui no Tray, por isso, é **importante** não alterar o código de um produto no Tray após ele ter sido sincronizado com o AHEAD
* O botão "**Sincronizar**" localizado em **Comercial ➔ Integração Ecommerce ➔ Sincronização** é o meio que o AHEAD utiliza para comunicar-se com o Tray.
## Lojas
Diferente de uma **loja física**, ter uma variedade de produtos de diferentes tipos, muitas vezes não é conveniente para o cliente, visto que, em uma busca online é procurado algo mais **específico** e com objetividade. Por esse motivo, é possível criar diversas **Lojas** com diferentes tipos de **produtos** para o cliente saber o que encontrará.
{% hint style="info" %}
**Caminho até lá:**  **Comercial ➔ Integração Ecommerce ➔ Lojas**
{% endhint %}
### Criando uma nova Loja
{% hint style="danger" %}
Esse processo é realizado por nós da AHEAD, ou seja, não é necessário ser feito pelo usuário.
{% endhint %}
**1)** Clicar em "**Novo Registro**"
**2)** Preencher os **campos obrigatórios**\*
{% hint style="info" %}
Os campos **Consumer Key** e **Consumer Secret** são necessários para o AHEAD poder entrar em contato com o Tray e buscar as informações de **pedidos.**
{% endhint %}
* **Status Buscar Pedido:**
Informa-se nesse campo qual a descrição os produtos terão que ter no Tray para o Ahead buscar o **Pedido**.
* **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 Tray para que a informação esteja de acordo.
* **Status Buscar Pedido Cancelado:**
Quando um **Pedido** é cancelado no Tray, é necessário informar nesse campo qual status será buscado para o Ahead 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 Tray para prover a informação de que o **pedido** já foi faturado e emitido a nota.
## Categorias
Quando trata-se de **Ecommerce**, 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á:**  **Comercial ➔ Integração Ecommerce ➔ Categorias**
{% endhint %}
### Criando uma nova Categoria
**1)** Clicar em "**Novo Registro**"
**2)** Preencher os **campos obrigatórios**\* e informar a qual **Loja** ele pertencerá
{% 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á:**  **Comercial ➔ Integração Ecommerce ➔ Produtos Ecommerce**
{% endhint %}
### Cadastrando um novo Produto Ecommerce
{% hint style="info" %}
Apenas criar um **Produto Ecommerce** não é o suficiente para avisar o Tray que foi criado um novo **produto**! Após concluir todas as etapas, é necessário realizar a "**Sincronização**"
{% endhint %}
**1)** Clicar em "**Novo Registro**"
**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****\*** e coloque especificações caso julgue interessante:
### Cadastro de Kits
Os **kits** são muito convencionais quando se trata de **compras online**, o sistema **Ahead** não controla o estoque de **Kits****,** somente controla a quantidade de seus componentes. O controle de **kits** é realizado pela plataforma Tray.
**➔ Para informar se um produto possui ****kit**** ou não, é necessário seguir os seguintes passos:**
* **Clicar** em  para editar o **Produto Ecommerce**
* Em **Cadastro do Produto** é possível visualizar a opção mais abaixo "**Produto possui ****kit**", ao marcar como "sim" aparecerá o campo "**Componentes**" antes não visto
* Dentro desse campo serão dadas as **informações básicas** dos produtos contidos no **kit**, o AHEAD levará esses dados para o Tray e o mesmo trará novamente ao AHEAD por meio da sincronização, atualizando quantidades de estoque.
## Sincronização
Recapitulando, a **Sincronização** é o meio do AHEAD comunicar-se com o Tray e trazer informações como: **pedidos**, **clientes** e **movimentar estoque**. Por esse motivo, é necessário realizar o uso do botão **Sincronização** para atualizar qualquer dado alterado em algum dos sistemas.
### Utilizando o botão Sincronização
{% hint style="info" %}
**Caminho até lá:**  **Comercial ➔ Integração Ecommerce ➔ Sincronização**
{% endhint %}
**1) Selecionar** a **Loja** que deseja ser realizada a **Sincronização** na aba "**Pedidos**"
**2) Clicar** em "**Sincronizar**" que, automaticamente, irá ser feita a troca de informações de **pedido** e **estoque**
**3)** **Além disso**, irão ser trazidas informações específicas como, quais foram os **Produtos de Estoque Atualizados**, informando qual estoque os mesmos pertencem
**4)** Também irá ser possível visualizar uma **listagem** com todos os **erros** que deram
* 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**
{% 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 **Ecommerce**, lá poderão ser visualizadas informações como: **Chave de Acesso**, **Valores** e **Clientes**
## Pedidos Ecommerce
{% hint style="info" %}
**Caminho até lá:**  **Comercial ➔ Pedidos ➔ Pedidos**
{% endhint %}
Os pedidos realizados por **Ecommerce** são filtrados por **Pedidos Web - PEW**, e para realizar a **filtragem** é necessário seguir os seguintes passos:
**1)** Clicar em  e selecionar **PEW**
**2)** Clicar em "**Filtrar Pedidos**"
**➔** Nessa etapa serão exibidos todos os pedidos buscados através da **Sincronização** com o Tray
### 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:
**1)** Selecionar os **Pedidos** que serão faturados
**2)** Clicar em "**Gerar Notas**"
**3)** Selecionar "**sim**" e a nota será gerada
{% hint style="info" %}
Ao marcar como sim o sistema irá comunicar-se com o **Tray** enviando o **xml** da **NFe**.
{% endhint %}
**➔** Caso dê algum erro na sincronização da nota, há a opção de reenviar ela pela Aba de "**Nota Fiscal**" dentro de **Sincronização**
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://documentacao.aheadsistemas.com.br/ahead-sistemas/comercial/integracao-ecommerce.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.