# Problemas Comuns na Sincronia

O MercadoLivre é muito rigoroso com todos os anúncioscriados, com isto, podem gerar muitos alertas diferentes que requerem atenção.

Antes de consultar o guia abaixo, clique em "**Validação**", este botão faz uma checagem das principais causas de recusa:

<figure><img src="/files/660SCBw3qdluf6kxfSIv" alt=""><figcaption></figcaption></figure>

## 🔷 The attributes \[COLOR, SIZE] are required for category MLBXXXXX. Check the attribute is present in the attributes list or in all variation's attributes\_combination or attributes

Este alerta ocorre quando a categoria atrelada a este produto possui variações obrigatórias.

Podes consultar as variações obrigatórios clicando em "**Produtos -> Departamentos**" e após em "**Consultar Variações**" na coluna "**MercadoLivre**":

![](/files/-Mb3oEFnK6WymbosufIj)

Após clicar neste botão, serão exibidas as variações **PERMITIDAS** e as que são **OBRIGATÓRIAS**:

![](/files/-Mb3oiN_t_xXQB3kUXbN)

Observe que nas variações **obrigatórias**, é exibido "**Obrigatória**" ao *lado do nome*:

![](/files/-Mb3oqFeJpDF18r8EVxG)

Estas variações obrigatórias, precisam estar presentes no produto, caso não estejam o **MercadoLivre rejeita o anúncio**.

Ainda esta com dúvida? Consulte o vídeo tutorial abaixo:

{% embed url="<https://video.bunnycdn.com/play/78964/531dac8f-d107-4e86-8a71-938e1e3a06a7>" %}

## 🔷 You cannot create a variation without attribute\_combinations

Este alerta ocorre quando esta sendo sincronizado um **produto com variações**, porem, o **nome das variações** não condiz com os **nomes aceitos pelo MercadoLivre**.

Podes consultar as variações aceitas clicando em "**Produtos -> Departamentos**" e após em "**Consultar Variações**" na coluna "**MercadoLivre**":

![](/files/-Mb3oEFnK6WymbosufIj)

Após clicar neste botão, serão exibidas as variações "**Permitidas":**

<figure><img src="/files/j3i1FtPuB5Zb1lfxwg1r" alt=""><figcaption></figcaption></figure>

Neste caso, o departamento mapeado permite apenas variações de "**Cor**".

Caso a variação, em seu produto, não tenha o nome "**Cor**" e as cores não estejam na lista permitida, o MercadoLivre ira **recusar o anúncio**.

**Exemplo que será Recusado:**

<figure><img src="/files/7T89bRJgI3SJXuHPc1SJ" alt=""><figcaption></figcaption></figure>

Neste exemplo, as variações estão com o nome "**Estilo**".

Para que sejam aceitar precisa ser alterado para o mesmo nome indicado na janela de "**Departamentos / Variações**":

<figure><img src="/files/cAAlnbzbvyCAlSWSy01s" alt=""><figcaption></figcaption></figure>

Ainda esta com dúvida? Consulte o vídeo tutorial abaixo:

{% embed url="<https://video.bunnycdn.com/play/78964/d7721f4b-7ee7-4c92-b5c7-6b5b2710428e>" %}

## 🔷 Value name of attribute COLOR was not provided and couldn't be resolved from attributes database

Este alerta ocorre quando esta sendo sincronizado um **produto com variações**, porem, a variação não esta na lista de variações permitidas pelo MercadoLivre.

Podes consultar as variações aceitas clicando em "**Produtos -> Departamentos**" e após em "**Consultar Variações**" na coluna "**MercadoLivre**":

![](/files/-Mb3oEFnK6WymbosufIj)

Após clicar neste botão, serão exibidas as variações "**Permitidas":**

<figure><img src="/files/axyBFWj3Dz8EdZacYrcG" alt=""><figcaption></figcaption></figure>

**Exemplo que será Recusado:**

<figure><img src="/files/5LnINafGLjFDUEs41FAG" alt=""><figcaption></figcaption></figure>

Neste exemplo, a cor "**Iogurte**" não esta na lista de cores permitidas pelo MercadoLivre.

Para que sejam aceitar precisa ser alterado para uma das cores aceitas pelo MercadoLivre, como exemplo, "**Rosa**":

<figure><img src="/files/jeJXtsF1n7XdbefUj41T" alt=""><figcaption></figcaption></figure>

Ainda esta com dúvida? Consulte o vídeo tutorial abaixo:

{% embed url="<https://video.bunnycdn.com/play/78964/aee79c91-a418-4aa3-a4f9-110c27e8dcb1>" %}

## 🔷 Item category MLB1620 domain MLB-KITCHEN\_SUPPLIES does not belong to catalog\_product\_id MLB19867989 domain: MLB-WASTE\_BASKETS"

Este aleta ocorre quando o MercadoLivre identifica que a categoria que foi mapeada não é adequada para o produto.

Edite o mapeamento do departamento Principal do produto para um departamnto mais adequado.

Você pode identificar o departamento adequado fazendo uma busca de um produto simular no MercadoLivre, onde será exibido o departameno adequado:

<figure><img src="/files/e5Y2wYd3kbiIw8iZN3VV" alt=""><figcaption></figcaption></figure>

## 🔷 The attributes \[BRAND] are required for category MLB192368 and channel marketplace. Check the attribute is present in the attributes list or in all variation's attributes\_combination or attributes.

Acesse a edição do produto e preencha a **Marca** e **Modelo** nos **atributos do MercadoLivre.**

## 🔷 seller.unable\_to\_list / User is unable to list

Este alerta ocorre quando sua conta MercadoLivre possui alguma informação cadastral que ainda não foi validada.

Para corrigir você pode acessar seu painel do Mercado Livre e cadastrar um produto manualmente.

Ao cadastrar manualmente o primeiro produto no Mercado Livre será necessário confirmar algumas informações de sua conta.

Caso o alerta ainda seja exibido, acese o link abaixo e verifique se alguma das informações estão pendentes:

{% embed url="<https://www.mercadolivre.com.br/hub-engine/hubs/my-profile#menu-user>" %}

## 🔷 Domain\_id, EAN or UPC is required

Este alerta ocorre quando a categoria do produto requer que seja preenchido um GTIN/EAN. Edite o produto e preencha o campo GTIN/EAN.

## 🔷 Validation errorCategory MLBXXXXXX does not support titles greater than 60 characters long

Essa categoria não suporta títulos de anúncios com mais de 60 caracteres.

## 🔷 Cannot update item MLBXXXXXX \[status:closed, has\_bids:true] available\_quantity is not modifiable.

Esse erro aparece quando você tenta alterar o estoque para testar com o anúncio fechado. O API não permite a alteração e o estoque retorna com esse erro.

## 🔷 Category 0 does not exist

## 🔷 Category MLB188670 does not exist.

Ocorre quando o "**Departamento Principal**" do produto **não foi mapeado** com o MercadoLive.

Clique no link abaixo para acessar o tutorial de mapeamento de departamento:

{% content-ref url="/pages/-M8g7r2fQlTu1sAdEQHg" %}
[Departamentos](/marketplaces/mercadolivre/configurando-departamentos.md)
{% endcontent-ref %}

## 🔷 Departamento não Configurado

Este alerta pode ocorrer em algumas situções:

* Departamento ainda não foi mapeado
* Produto esta desativado
* Departamento Principal esta Desativado

## 🔷 Produto sem Estoque

Para que um produto seja sincronizado com o MercadoLivre ele precisa possuir ao menos uma unidade em estoque.

## 🔷 Item without price is not allowed for category MLB9188 and channel marketplace

Ocorre quando o produto esta sem preço configurado, ou esta ativo o "**Preço Diferenciado**" sem que tenha sido preenchido um preço.

## 🔷 The category MLB9188 requires a minimum price of 7

Muitas categorias do MercadoLivre possuem um valor mínimo, neste caso, indica que o valor mínimo para venda é de R$ 7.

## 🔷 Available quantity max. value is 99999 for category MLB371913, condition new and listing type gold\_special

As categorias do MercadoLivre possuem um **estoque máximo**, neste caso, é de **99999**.

Preencha um estoque menor no produto e tente novamente.

## 🔷 Category MLB9188 does not support titles greater than 60 characters long.

Boa parte das categorias possuem uma restrição de produtos com nome com no máximo **60 caracteres**.

Com isto, é necessário reduzir o nome do produto, ou preencher o campo "**Nome Marketplace**" com um nome reduzido:

<figure><img src="/files/g7WtuaPruztX7xvs30z4" alt=""><figcaption></figcaption></figure>

O campo "**Nome Markeplace**" permite indicar um nome que será utilizado apenas nos Marketplaces, incluindo o MercadoLivre.

## 🔷 expired\_token

Esta mensagem ocorre quando a loja não consegue mais se conectar com sua conta MercadoLivre.

Clique em "**Módulos -> MercadoLivre**" e em seguida em "**Configurar**":&#x20;

<figure><img src="/files/80hyzDu3kWTzabLa1Tbe" alt=""><figcaption></figcaption></figure>

Clique em "**Reconectar na Conta MercadoLivre**":

<figure><img src="/files/Q5adVvEraoTGCN4uARFS" alt=""><figcaption></figcaption></figure>

## 🔷 You cannot create a variation without attribute\_combinations

Ocorre quando o departamento mapeado não aceita variações.

Neste caso, é necessário alterar o departamento mapeado ou remover as variações do produto.

## 🔷 Product Identifier \[GTIN] contains values with invalid format: \[9999999999999]

Este alerta ocorre quando o GTIN e/ou EAN são preenchidos com informações inválidas.&#x20;

É necessário corrigir a informação preenchida ou remover a mesma.

## 🔷 Attribute: SELLER\_SKU was dropped because its value\_id and value\_name are null, empty strings or they were not sent

🔷 Ocorre quando o produto não possui um SKU.&#x20;

É necessário preencher o campo SKU na edição do produto.

### 🔷 The photos must have a minimum size of 500 pixels on at least one side.

Ocorre quando um das fotos tem uma largura ou altura menor que 500px.

O Ideal é que as imagens tenham ao menos 1000px de largura/altura para que tenham um Zoom, porem, precisam possuir ao menos 500px para que o anúncio seja aceito.

### 🔷 You should include more main features in the title to differentiate it from other products.

Oorre quando o nome do produto não possui informações suficientes, é necessário editar o nome deixando ele mais completo.

### 🔷 An error occurred while processing the photo. Please upload it again.

Ocorre quando as imagens do produto possuem um formato inválido.

Envie imagen em JPG ou PNG.

### 🔷 You exceeded the {$VALUE} character limit. Shorten the description.

Ocorre quando a descrição é muito grande.

É necessário que a descrição seja editada para uma descrição menor.

### 🔷 Attribute \[SIZE\_GRID\_ID] is missing

Dependendo do departamento, o MercadoLivre pode solicitar que seja informado uma **tabela de medidas**.

**Clique no link** abaixo para conhecer o funcionamento e criar suas tabelas de medidas:

{% content-ref url="/pages/LY5vnGRzudCPQ8nFVDi1" %}
[Tabelas de Medidas](/marketplaces/mercadolivre/tabelas-de-medidas.md)
{% endcontent-ref %}


---

# 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://ajuda.toplojas.com.br/marketplaces/mercadolivre/problemas-comuns-na-sincronia.md?ask=<question>
```

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.
