# Mercado Livre

### **O que é o Mercado Livre?**

O Mercado Livre é um dos maiores marketplaces da América Latina. Integrar sua loja virtual com o Mercado Livre permite que você crie novos anúncios diretamente a partir dos produtos já cadastrados em seu sistema.

**Funcionalidades da Integração com o Mercado Livre:**

1. **Criação de Anúncios:**
   * Ao criar um anúncio no Mercado Livre a partir de um produto da sua loja virtual, todos os dados do produto serão carregados automaticamente. Você terá a liberdade de editar esses dados, como título e descrição, para personalizar o anúncio conforme desejar.
2. **Controle de Anúncios:**
   * Através da plataforma, você pode gerenciar o status dos seus anúncios no Mercado Livre. As opções incluem pausar, finalizar ou re-listar um anúncio conforme necessário.
3. **Gestão de Estoque:**
   * A integração permite que você monitore quantas unidades de um determinado produto estão disponíveis para venda no Mercado Livre, além de acompanhar quantas unidades já foram vendidas.

### **Pré-requisitos necessários para a integração**

Para **integrar com o Mercado Livre**, primeiro é necessário ter um **cadastro.** Para isso, acesse [esse link ](https://vendedores.mercadolivre.com.br/como-vender-no-mercado-livre/)para saber detalhadamente **como começar a vender no Mercado Livre.**

### **Como integrar com o Mercado Livre**

Para administrar seus anúncios e para integrar sua loja virtual ao Mercado Livre, siga os passos abaixo:

\
1- Acesse o painel de controle da sua loja virtual.

2- Clique em **Marketplace >> Hubs**.

**Atenção:** este tutorial requer a ativação do modo Especialista em seu painel de controle. Caso você não saiba como ativar o modo Especialista, é só clicar [aqui](https://ajuda.iset.com.br/inicio/minha-loja/outros/alternar-entre-os-modos-foco-e-especialista) e acessar nosso tutorial.

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

3- Em seguida, clique na opção **Novo Hub**

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

4- Selecione o **Tipo de Integrador** Mercado Livre.

<figure><img src="/files/9UMYdGSjtA27OyEG8B4G" alt=""><figcaption></figcaption></figure>

5- No campo **Nome**, preencha com o nome que desejar.

<figure><img src="/files/2yJRWWw4JARSA1CPQINy" alt=""><figcaption></figcaption></figure>

**6- Autorize as credenciais** clicando no botão amarelo Autorizar o aplicativo no Mercado Livre. Você será direcionado para o site deles.&#x20;

Se já estiver cadastrado insira seu login e senha do **Mercado Livre** e clique em **Entrar,** caso contrário, realize seu cadastro para prosseguir.

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

7- Após efetuar o login, clique em **Permitir** para autorizar que o sistema de **loja virtual** controla-se sua conta do **Mercado Livre**.

8- Por fim, clique no botão verde **Inserir.**

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

9- Após realizar os passos informados anteriormente, vá em **Marketplaces** >> **Hubs** para mapear categorias e atributos de produtos.

10- Depois de mapear atributos e categorias, vá em **Marketplaces** >> **Catálogos** dentro do painel administrativo da loja virtual e crie um catálogo com os produtos que deseja enviar para o **Mercado Livre.**

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

### **Principais erros de conexão Mercado Livre e como ajustar seus produtos**

Entenda os principais erros de conexão com o Mercado Livre e saiba como corrigir seus produtos:

1. **User Unable to List:**
   * **Descrição:** Este erro indica que o usuário cadastrado no Mercado Livre não está habilitado para vender no marketplace.
   * **Possíveis Causas e Soluções:**
     * **Conta de Vendedor:** Verifique se a opção de vendedor está ativada na sua conta do Mercado Livre.
     * **Dados Incompletos:** Confirme que todas as informações necessárias foram inseridas corretamente na sua conta do Mercado Livre. Verifique se o cadastro está completo.
     * **Tipo de Conta:** Certifique-se de que sua conta é de pessoa jurídica, conforme exigido pelo Mercado Livre.

![](/files/Ty7utfTxXVgYo315Ds1v)

2. **Estoque do Produto Deve Ser Maior que Zero:**

   * **Descrição:** não é possível conectar itens sem estoque no marketplace.
   * **Solução:** certifique-se de que o item possui estoque disponível antes de tentar gerar o anúncio no Mercado Livre.

3. **The fields \[category\_id] are required for requested call:**
   * **Descrição:** o item não possui uma categoria atribuída.
   * **Soluções:**

     * **Vincular Categoria:** atribua uma categoria ao item no seu ERP ou plataforma e sincronize com a SkyHub.
     * **Revisar Mapeamentos:** verifique e revise os mapeamentos de categoria para garantir que estão corretos antes de tentar reconectar o item.

4. **Invalid value \[length] for attribute. Maximum \[length] is X:**
   * **Descrição:** o comprimento do item está fora do padrão aceito pelo marketplace ou o campo está em branco.
   * **Soluções:**

     * **Ajustar Comprimento:** verifique e ajuste o valor do comprimento para que esteja dentro do limite permitido.
     * **Verificar Outros Atributos:** mensagens semelhantes podem aparecer para altura, largura e peso. Verifique e corrija esses valores conforme necessário.

5. **Shipping method ids \[182] are not allowed for shipping mode \[me2]:**

   * **Descrição:** o método de envio selecionado não é aceito pelo marketplace.
   * **Solução:** altere o método de envio para um permitido pelo Mercado Livre e reenvie o item.

6. **Attribute \_\_\_\_\_ has an invalid value (null). Allowed values are \[242084, 242085]:**

   * **Descrição:** Este erro indica que um atributo precisa ser mapeado corretamente.
   * **Solução:** Verifique e ajuste os "mapeamentos de atributos por categoria" para garantir que todos os atributos exigidos estejam corretamente configurados.

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

   * **Descrição:** O produto pode não ter SKU e nome preenchidos, ou esses atributos não estão mapeados corretamente.
   * **Solução:** Certifique-se de que o SKU e o nome do produto estão preenchidos corretamente e que esses atributos estão mapeados corretamente na plataforma.

8. **Associação não encontrada para esse produto:**

   * **Descrição:** Ocorre quando não é encontrada uma associação no banco de dados local para o produto, possivelmente devido a divergências entre os dados locais e os do Mercado Livre.
   * **Solução:** Verifique se as especificações do produto e os filtros definidos correspondem corretamente aos dados armazenados localmente e no Mercado Livre, corrigindo quaisquer divergências.

9. **Não é possível remover o frete grátis (a tag ‘mandatory\_free\_shipping’ está presente):**
   * **Descrição:** Este erro ocorre quando se tenta remover o frete grátis de um anúncio que exige frete grátis (anúncios ME2).
   * **Solução:** Ajuste o anúncio para manter o frete grátis ou modifique as configurações do anúncio conforme necessário para cumprir os requisitos do Mercado Livre.

Essas soluções ajudam a identificar e resolver problemas comuns de conexão com o Mercado Livre, assegurando que seus produtos sejam listados corretamente e sem interrupções.&#x20;

Se precisar de mais assistência ou desejar revisar outros conteúdos, estou à disposição para ajudar!

\
Ficou com alguma dúvida? Entre em contato conosco pelo chat online!


---

# 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.iset.com.br/inicio/minha-loja/marketplaces/mercado-livre.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.
