> For the complete documentation index, see [llms.txt](https://ajuda.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.toplojas.com.br/marketplaces/olist/produtos.md).

# Produtos

## Considerações Iniciais

A Olist possui algumas regras que precisam ser seguidas para que a integração tenha sucesso

1. Todo produto precisa **possuir um EAN** cadastrado, este EAN precisa ser **ÚNICO** entre os produtos e variações (*Ou seja, não pode existir dois produtos com o mesmo EAN* e nem duas variações com o mesmo EAN)<br>

**O cadastro é feito em** (*Para produtos sem variação*):\
![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h03\_10.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-305395da1d433764c87f28da0f3e0c6acb30fb27%2F2.png?alt=media)

**O cadastro é feito em** (*Para produtos com variação*):

![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h03\_34.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-ba72e0b74cdffde55ffd957acccd23b12563c513%2F3.png?alt=media)\
![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h03\_39.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-8bf0bf15e7bed3eb4d20588500621a7b9a90982b%2F20.png?alt=media)

1. O produto deve possuir dimensões e peso cadastrados e deve ter um dimensões mínimas:

Comprimento: 15 cm

Largura: 11 cm

Altura: 2 cm

1. O produto deve possuir uma Marca<br>
2. O produto deve possuir ao menos uma foto<br>
3. O produto deve possuir descrição<br>
4. Caso seja utilizado “**Preço Promocional**” este **NÃO** pode ser menor que **50% do “Preço Normal”**

## Preparação

Antes de começar a sincronizar produtos é necessário selecionar quais departamentos serão sincronizados com a Olist, para isto siga as etapas abaixo:<br>

1. Clique em “**Produtos -> Departamentos**”<br>
2. Clique em um departamento<br>
3. No campo “**Olist - Sincronizar Produto?**” marque “**Sim**”:\
   ![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h08\_55.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-c2910559c6771a6861e1cf947af663940972d0fb%2F5.png?alt=media)<br>
4. Clique em “**Salvar Departamento**” no final da janela

## Enviando um produto para a OList

Após um produto ser cadastrado ele **não é enviado automaticamente para a Olist**, para isto, siga os passos abaixo:

1. Clique em “**Produtos -> Listagem de Produtos**”<br>
2. **Clique no produto** que você deseja enviar para a Olist<br>
3. No campo “**Olist**” clique em “**Cadastrar**”:\
   ![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h12\_10.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-365ef3cb25a685ac54a0ac597524293813f8300b%2F6.png?alt=media)<br>
   1. Caso algum **problema aconteça**,será exibido “**FALHA**” na coluna “**Status**”, e na coluna “**Mensagem**” será exibida a causa das falhas:\
      ![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h14\_14.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-5f1553ebe834d3f6ed7b12511ae42922035cd2c6%2F7.png?alt=media)

      Neste caso, é necessário editar o produto, fazendo as respectivas correções, e voltar a sincronizar
   2. Caso tenha **sucesso**, será exibido “**SUCESSO**” na coluna “**Status**” e a olist irá iniciar a moderação do produto:\
      ![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h14\_58.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-0db7ca9c655fa812aab2b045b8ab369e9a502fcc%2F8.png?alt=media)<br>

## Enviando todos os produtos, dos departamentos liberados, para a Olist

Este recurso permite que você sincronize todos os produtos **que estão nos departamentos onde a integração foi ativada**.

Para isto, siga os passos abaixo:<br>

1. Clique em “**Módulos -> Olist**”<br>
2. Clique em “**Sincronizar Produtos**”:\
   ![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h18\_21.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-ef7513393193584814df12d780e704fd5a54cab3%2F9.png?alt=media)<br>
3. Na janela aberta, clique em “**Iniciar**”\
   ![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h20\_36.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-d3129029b439952d5a13d68820858962f1e627bb%2F10.png?alt=media)<br>
4. Ao clicar neste botão, a sincronia será iniciada em todos os itens, esta rotina **pode levar um tempo considerável** dependendo da quantidade de produtos que serão sincronizados\
   ![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h20\_23.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-16c6d0e729138bd5f346d3c5bfabb1232158eb6e%2F11.png?alt=media)<br>
5. Após a **finalização da rotina**, será exibido o **status de cada produto sincronizado**, indicando os ***possíveis erros*** encontrados\
   ![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h20\_29.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-23eccdeed07bbebaaf2c46a97f576b729edfd2b8%2F12.png?alt=media)<br>

## Entendendo os Status dos Produtos

Após um produto ser enviado para a Olist ele entra no status “**Moderação**”, neste status a Olist verifica se o produto possui algum problema.

Você pode **consultar o status** de um produto em “**Produtos -> Listagem de Produtos -> Clique em um Produto**”, no final da página, na área “**Olist**” será exibido os detalhes da integração:

![](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-20e090a1f0ebb97dd7c5e09cc1c6d5ae312cb18e%2F13.png?alt=media)

É importante observar que apenas produtos com status “**created**” e “**rejected**” **podem ser editados**, em qualquer outra status apenas o **Preço/Estoque** podem ser editados.

Caso a **Olist rejeite o produto**, será indicado a **causa da rejeição**:

![](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-363bd0ff7a9971b0aff5d6d265f2c45ba5021769%2F14.png?alt=media)

Quando o **produto é rejeitado** é necessário **editar** o produto e fazer as respectivas correções, ao fazer as correções e salvar o produto o sistema **automaticamente irá reenviar o produto para a Olist que o colocará em “Moderação” novamente.**

Depois da **Olist aprovar o produto**, este irá entrar no status “**approved**”:

![](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-33690d3eac54cc032c6f1f1631f765412b22b424%2F15.png?alt=media)

Depois deste momento não é mais possível editar o produto, caso seja necessário uma nova edição, será necessário abrir um chamado na Olist solicitando a edição, através do Link:

<https://jira-olist.atlassian.net/servicedesk/customer/user/requests>

Em alguns produtos será exibido o alerta abaixo:

![](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-8170c73a573dc73e3992f712b90353575d1a22d0%2F16.png?alt=media)

Este alerta indica que a O**list já tinha este EAN** cadastrado em sua base de dados e com isto os **dados deste produto não poderão ser alterados** (*a olist irá preencher automaticamente*), podendo ser alterado apenas:

\- Preço

\- Estoque

\- Dimensões

\- Peso

Caso você precise editar algum produto com este aviso, será necessário abrir um chamado na Olist através do link abaixo:

<https://jira-olist.atlassian.net/servicedesk/customer/user/requests>

## Editando produtos já enviados para a Olist

Caso você já tenha enviado um produto para a Olist este pode ser sincronizado **APENAS** caso esteja nos status “**created**” ou “**rejected**”, **qualquer outro status não pode ser editado**.

Ao editar um produto neste status o sistema **automaticamente** envia as alterações para a olist, sem necessidade de nenhuma ação manual.

## Sincronizando estoque de produtos

Quando uma alteração de estoque ocorre, o sistema **automaticamente** envia esta informação para a Olist dentro dos minutos seguintes a alteração.

Porém, você pode forçar um sincronia de estoque, para isto:<br>

1. Clique em “**Produtos -> Listagem de Produtos**”<br>
2. Clique em **um produto** já sincronizado com a Olist<br>
3. Clique em “**Sincronizar Estoque**”:\
   ![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h36\_33.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-f64f59fb00ea6674203b7cd191e03cbea3481c09%2F17.png?alt=media)<br>

**Observações importantes:**

* Apenas produtos com status “**approved**” podem ter o estoque **sincronizado**
* Quando um produto é **aprovado** pela Olist, o sistema automaticamente envia uma atualização de estoque inicial

\
**Você pode também sincronizar o estoque de todos os produtos da loja, para isto, siga as etapas abaixo:**

1. Clique em “**Módulos -> Olist**”<br>
2. Clique em “**Sincronizar Produtos / Estoque**”<br>
3. Clique em “**Iniciar**”

## Sincronizando preço de produtos

Quando uma alteração de preço ocorre, o sistema **automaticamente** envia esta informação para a Olist dentro dos minutos seguintes a alteração.

Porém, você pode forçar um sincronia de preço, para isto:<br>

1. Clique em “**Produtos -> Listagem de Produtos**”<br>
2. Clique em **um produto** já sincronizado com a Olist<br>
3. Clique em “**Sincronizar Preço**”:\
   ![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h40\_27.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-4b121ad173e59ee7ffe9d4a37237f4de967d75ce%2F18.png?alt=media)<br>

**Observações importantes:**

* Apenas produtos com status “**approved**” podem ter o preço sincronizado
* Quando um produto é aprovado pela Olist, o sistema automaticamente envia uma atualização de preço inicial
* Caso o produto tenha “**Preço promocional**”, este **não pode ser menor que 50% do “Preço Normal”** do produto

\
**Você pode também sincronizar o preço de todos os produtos da loja, para isto, siga as etapas abaixo:**

1. Clique em “**Módulos -> Olist**”<br>
2. Clique em “**Sincronizar Produtos / Preço**”<br>
3. Clique em “**Iniciar**”

## Variações

Para a integração cada variação é entendida como um “**produto**” que a Olist agrupa automaticamente.

Com ist&#x6F;**, cada variação precisa possuir um EAN ÚNICO**, **não pode existir duas variações com o mesmo EAN na loja**:

![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h03\_34.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-ba72e0b74cdffde55ffd957acccd23b12563c513%2F3.png?alt=media)\
![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h03\_39.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-8bf0bf15e7bed3eb4d20588500621a7b9a90982b%2F20.png?alt=media)

Quando um produto com variação é sincronizado, o sistema exibe **cada variação separadamente**, permitindo assim que cada variação seja tratada de forma individual:

![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h48\_23.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-b3136e19f2ab954691e333526988e63bbb22b65b%2F21.png?alt=media)

## Dúvidas Frequentes

1. Como visualizar todos os produtos integrados com a Olist?<br>
   1. Clique em “**Modulos -> Olist**”<br>
   2. Clique em “**Consultar Produtos**”<br>
2. Como visualizo o produto na Olist?<br>
   1. Clique em **“Produtos -> Listagem de Produtos**”<br>
   2. Clique em **um dos produtos**<br>
   3. No espaço da **Olist**, clique no **ID** exibido na coluna “**Código Olist**”:\
      ![D:\Dropbox\Prints4\Nova pasta (2)\Screenpresso\2020-01-24\_17h51\_35.png](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-679a3cc224cfaecccf86bb3d0bf3a4283ea313db%2F22.png?alt=media)<br>
3. Não tenho EAN dos meus produtos, o que fazer?<br>
   1. A Olist requer um EAN para o produto, caso você não tenha, pode utilizar o **GTIN** (*Preenhido no campo de EAN*)<br>
   2. Caso não tenha nem o EAN e nem o GTIN **não será possível integrar com a Olist**<br>
4. Enviei meu produto para a Olist, quando tempo fica em moderação?<br>
   1. Não existe um tempo exato, mas normalmente em até **3 dias** a olist retorna uma **aprovação** ou **rejeição**<br>
   2. Caso o produto tenha sido rejeitado, você fez a correção e o produto voltou para moderação, a nova análise ocorre mais rapidamente, normalmente no mesmo dia<br>
5. Meu produto está em moderação mas quero mudar uma informação, é possível?<br>
   1. **Não**, apenas produtos nos status “**created**” e “**rejected**” podem ser editados<br>
6. Meu produto foi Rejeitado, o que fazer?<br>
   1. Nos detalhes dos produtos, consulte a área “**Olist**” para identificar a **causa da rejeição**:

![](https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-95bb4b3ba28b928c7d2649a0ca55c5c214c80e2e%2F23.png?alt=media)

* 1. Edite o produto fazendo as respectivas correções<br>
  2. Aguarde a nova revisão da Olist

## EAN, o que é?

Acesse o link abaixo para obter maiores detalhes sobre o EAN:\
<https://blog.olist.com/ean-e-codigo-de-barras-o-que-e-e-como-utilizar-para-que-serve/>

## Ainda tem dúvidas?<br>

A Olist possui vários artigos úteis sobre seu funcionamento:

<https://blog.olist.com/conteudos/artigos/>

Caso ainda tenha dúvidas nos envie um chamado em:

<http://projetos.web4business.com.br/>

Você pode também abrir um chamado na Olist, através do link abaixo:

<https://jira-olist.atlassian.net/servicedesk/customer/user/requests>
