> For the complete documentation index, see [llms.txt](https://wiki.spiritshop.com.br/suporte-admin-3.0/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.spiritshop.com.br/suporte-admin-3.0/integradores/integracao-com-mercado-livre.md).

# Integração com Mercado Livre

* **Índice:**\
  ( 1 ) Criar um app **no Mercado Livre**.\
  ( 2 ) Copiar **ID** e **Secret Key** do app.\
  ( 3 ) Configurar o Módulo do Mercado Livre **na loja SpiritShop.**\
  ( 4 ) Enviar Produtos para o Mercado Livre.

***

* **Resumo:**\
  Antes de Prosseguir, é preciso que o Cliente **crie um app** em sua **conta do Mercado Livre que já esteja autenticada/verificada** e nos encaminhe as informações de **ID** e **chave secret** que será gerada após a criação do app para integração na loja spiritshop;\
  Ajuda do mercado livre -> [![](https://http2.mlstatic.com/ui/navigation/3.0.8/mercadolibre/120x120-precomposed.png)Minha primeira aplicação](https://developers.mercadolivre.com.br/pt_br/minha-primeira-aplicacao)
* **Obrigatório**:\
  -> Em seu Navegador, já esteja **Logado** em sua conta **Mercado Livre**, que já foi **autenticada/verificada** pela **equipe do Mercado Livre**.

***

\
**( 1 )** - **Crie uma nova aplicação em sua conta Mercado Livre**:  <a href="#hardbreak-1-criar-uma-aplicacao" id="hardbreak-1-criar-uma-aplicacao"></a>
---------------------------------------------------------------------------------------------------------------------------------------------------------

visite → <https://developers.mercadolivre.com.br/devcenter/> ou \
<https://developers.mercadolivre.com.br/devcenter/create-app>

<div data-full-width="true"><figure><img src="/files/ncmCnWLJH0Xs89aiinEQ" alt=""><figcaption></figcaption></figure></div>

* Preencha com seus dados de aplicação

<div data-full-width="true"><figure><img src="/files/m6TjnVJVicdMlVtpkEVD" alt=""><figcaption></figcaption></figure></div>

***

* No Próximo passo;
* Você deve ter em mãos a sua **URL de redirect e notificação**;<br>

**A sua URL de redirect e notificação é ->** *<https://www>.<mark style="color:$warning;background-color:$warning;">**nomedominio**</mark>.com.br/admin/mercadolivre.php*\
\
\- ou pode ser solicitada via e-mail: <suporte@spiritshop.com.br> ou diretamente no **Módulo Mercado Livre** em sua loja SpiritShop.\
Ex. → “ *<https://www.**nomedominio**.com.br/admin/mercadolivre.php>* “

* Com a sua URL de redirect e de notificação, continue para próxima tela no Mercado Livre;
* Configure com os dados da sua aplicação SpiritShop e somente as permissões demonstradas abaixo.

<div data-full-width="true"><figure><img src="/files/y3w0wkfQMHuLHuEAW8oE" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/dTnC4g6daOtUXO1zVhGY" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/MmP8chhhDKgAatnqzGaO" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/CyNCcOJCFy7rzbzPOB1e" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/PesMr7RMB8KaWMcdAb0Q" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/74G3w2g3WPoHGYzvRI2P" alt=""><figcaption></figcaption></figure></div>

<div align="center" data-full-width="true"><figure><img src="/files/ZzXco2OZzKGPMCFsvMCi" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/ThFOHS6OMrFqffUF3dob" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="/files/TKuZqxVpCgtuBBsYiXTq" alt=""><figcaption><p>Ex. url de notificação → “ <em>https://www.<strong>nomedominio</strong>.com.br/admin/mercadolivre.php</em> “</p></figcaption></figure></div>

***

## **( 2 ) ID** e **Chave Secreta** da aplicação mercado livre. <a href="#id-2-id-e-chave-secreta-da-aplicacao-mercado-livre" id="id-2-id-e-chave-secreta-da-aplicacao-mercado-livre"></a>

* Pronto, agora é preciso copiar seu o **ID** e **Secret Key** da aplicação mercado livre para **configurar** no **módulo** da **SpiritShop**.

Login -> [![](https://http2.mlstatic.com/ui/navigation/3.0.8/mercadolibre/120x120-precomposed.png)Developers](https://developers.mercadolivre.com.br/)

<div data-full-width="true"><figure><img src="/files/AflvEh4oFfUfwqnLwjmW" alt=""><figcaption></figcaption></figure></div>

->

<div data-full-width="true"><figure><img src="/files/JEQsZIYsFvTLLEeBRl1c" alt=""><figcaption></figcaption></figure></div>

&#x20;

* **Copie** seu **ID** e **Chave** da aplicação spiritshop mercado livre:

<div data-full-width="true"><figure><img src="/files/DHF3HL79YbCqcM6kRmyJ" alt=""><figcaption></figcaption></figure></div>

***

***

***

## **( 3 ) Configurando** o **Módulo** na **loja SpiritShop** <a href="#id-3-configurando-o-modulo-na-loja-spiritshop" id="id-3-configurando-o-modulo-na-loja-spiritshop"></a>

* Configure seu Módulo do Mercado livre no **Admin** da sua **loja SpiritShop.**\
  -> Clique em → **Extensões** → **Módulos**

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

Clique em **Editar** o módulo.

<div data-full-width="true"><figure><img src="/files/JNuGZbDsF60ZuC4sWMVH" alt=""><figcaption></figcaption></figure></div>

&#x20;

* → Em **Configurações,** preencha com seu **ID** e **Chave Secreta** do **Mercado Livre.**

<div data-full-width="true"><figure><img src="/files/m7C5OK3IEcImT9RVrABq" alt=""><figcaption></figcaption></figure></div>

&#x20;

* **Clique** em **Salvar.**

### ( 3.1 ) Atualize o Token do Mercado Livre

* &#x20;Entre **novamente** no Módulo;
* Agora, uma tela irá aparecer pedindo que você atualize seu Token do mercado pago.
* Basta **clicar no link** que aparece no pop-up e **autorizar** o aplicativo estando “logado” no mercado livre.

<div data-full-width="true"><figure><img src="/files/5MHf6bkQGgHi51xbNeSX" alt=""><figcaption></figcaption></figure></div>

* **Clique** em **Permitir**.

<div data-full-width="true"><figure><img src="/files/9ZHnWmv2gWuhGM7jMFrC" alt=""><figcaption></figcaption></figure></div>

**Pronto**! se estiver vendo a mensagem de **Token atualizado,** o módulo já foi configurado, e pode prosseguir para próxima etapa.\ <br>

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

Porem, se a mensagem de erro **Forbidden** aparecer,\ <br>

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

\
\- >basta **repetir** o **ultimo** passo e **permitir** o aplicativo novamente.

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

&#x20;

→ Até a mensagem **Token atualizado** abaixo aparecer;

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

***

***

***

## **( 4 ) Enviar Produtos para o Mercado Livre.**  <a href="#id-4-enviar-produtos-para-o-mercado-livre" id="id-4-enviar-produtos-para-o-mercado-livre"></a>

* Você pode **enviar produtos individuais** para o **Mercado Livre**.
* Basta **entrar no produto** e navegar na aba **Integração ->** **Mercado Livre**
* Clique em **Novo Anúncio,** e preencha todos os campos de **categorias do Mercado Livre obrigatórioas do ML** em que este produto irá ser vinculado e aparecer no mercado livre.
* ( **ATENÇÃO** ) Cada categoria e produtos do Mercado livre exige o preenchimento completo e todos os dados Obrigatórios do Produto que é exigido pelo próprio Mercado livre, portanto **se ocorrerem erros** ao tentar fazer o Sync, o Mercado livre irá retornar uma mensagem de erro exibindo **quais dados do produto ou envio precisam ser ajustados antes de fazer a tentativa de envio novamente do produto** para o Mercado livre.
* Após preencher todos os dados clique no ícone em **azul claro em destaque na imagem**, para **criar/enviar o anúncio** diretamente em sua conta do Mercado Livre.

<div data-full-width="true"><figure><img src="/files/l1jEcWJlkH9t77X7epqE" alt=""><figcaption></figcaption></figure></div>

***

* Pronto! Em sua conta Mercado Livre integrada, você já pode navegar em seus anúncios e conferir os produtos integrados.\
  **Obs.** Após enviar novos produtos para o ML aguarde a publicação/processamento das imagens do novo Anúncio Mercado Livre (de 1 a 15 minutos). &#x20;

<div data-full-width="true"><figure><img src="/files/4QBnsPLaW8IRB29OWpTh" alt=""><figcaption></figcaption></figure></div>

### <mark style="background-color:green;">(</mark> <mark style="background-color:green;"></mark><mark style="background-color:green;">**Atenção )**</mark>**&#x20;- Após o envio de&#x20;**<mark style="color:orange;">**produtos com variações/opções**</mark>**&#x20;para o Mercado Livre,&#x20;**<mark style="background-color:orange;">**Não edite as opções e variações desse produto pelo painel do ML**</mark>**.**  <a href="#id-4.2-enviar-produtos-com-opcoes-para-o-mercado-livre" id="id-4.2-enviar-produtos-com-opcoes-para-o-mercado-livre"></a>

* Se um produto foi enviado pela API ao ML, e for posteriormente editado as suas variações/opções pelo Painel do ML, este irá perder o vínculo das variações e por consequência o sincronismo do estoque das opções no produto Spiritshop.

<div data-full-width="true"><figure><img src="/files/DnSxZNujFPZ2VjZrUaWF" alt=""><figcaption></figcaption></figure></div>

***

### **( 4.1 ) - Mapeamento das Opções ( SpiritShop -> Mercado Livre ) , antes do vínculo da opção no produto Spiritshop e envio ao ML.** <a href="#id-4.2-enviar-produtos-com-opcoes-para-o-mercado-livre" id="id-4.2-enviar-produtos-com-opcoes-para-o-mercado-livre"></a>

* Para que seja possível enviar um produto que tenha opções para o mercado livre, é preciso antes que seja feito o mapeamento ( **De → Para** ) dessas opções na loja Spiritshop antes do envio do produto para o Mercado livre.
* Acesse o **grupo de opções** que está vinculado no produto que deseja enviar.

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

* Neste exemplo faremos o mapeamento **de → para Mercado livre** no grupo de **opções Cor > Editar:**

<div data-full-width="true"><figure><img src="/files/QPbG3tEGdTn0lD4ObAfR" alt=""><figcaption></figcaption></figure></div>

* Vincule o **Grupo de Opções** com a **Categoria** referente do Mercado Livre. ( neste exemplo, utilizamos o Cor para produtos do tipo **Jóias e Bijuterias >  Colares**)
* ( **ATENÇÃO** ) Cada **Grupo de Opção** pode ser vinculado a **apenas 1 tipo de categoria** referente do **Mercado Livre.**
* Após vincular a **Categoria ML** ao **Grupo de Opções** e o ( **De → Para )** de todas as opções do Grupo, basta voltar ao “**passo 4**” e enviar o produto normalmente para o ML.

<div data-full-width="true"><figure><img src="/files/dbCYn6Oi1begOOu4X3ij" alt=""><figcaption></figcaption></figure></div>

***

<div data-full-width="true"><figure><img src="/files/WzXVEvKTZlRGIUBH95iI" alt=""><figcaption></figcaption></figure></div>

***

## **( 3 )&#x20;**<mark style="color:red;background-color:$warning;">**Corrigindo Erros**</mark>**&#x20;referentes a integração com o  Mercado Livre.** <a href="#id-4.1-corrigindo-erros-do-mercado-livre" id="id-4.1-corrigindo-erros-do-mercado-livre"></a>

→ Confira os links de ajuda abaixo:&#x20;

* <https://wiki.spiritshop.com.br/suporte-admin-3.0/integradores/log-de-erros-no-envio-produtos-ao-mercado-livre>
* <https://wiki.spiritshop.com.br/suporte-admin-3.0/integradores/problemas-de-sincronismo-de-estoque-das-variacoes-e-opcoes-em-anuncio-de-produto-no-mercado-livre>

***

## **( 5 ) Opcional (**<mark style="color:red;background-color:$warning;">**não recomendado**</mark>**) - Enviar Categorias de Produtos para o Mercado Livre.**  <a href="#id-5-enviar-categorias-de-produtos-para-o-mercado-livre" id="id-5-enviar-categorias-de-produtos-para-o-mercado-livre"></a>

No Módulo do **Mercado Livre (Módulos > Mercado Livre > Editar)** em sua loja **SpiritShop ,** na aba **Exportar** você pode enviar produtos em massa por categoria.

Basta selecionar a categoria de produtos da loja e marcar para qual categoria irá no Mercado Livre.

ex. Categorias ( De → Para )

* ( **ATENÇÃO** ) Cada categoria e produtos do Mercado livre exige o preenchimento completo e todos os dados Obrigatórios do Produto que é exigido pelo próprio Mercado livre, portanto **se ocorrerem erros** ao tentar fazer o Sync, o Mercado livre irá retornar uma mensagem de erro exibindo **quais dados do produto ou envio precisam ser ajustados antes de fazer a tentativa de envio novamente do produto** para o Mercado livre.

<div data-full-width="true"><figure><img src="/files/TWuBhU2ZRx7uoA5RJodd" alt=""><figcaption></figcaption></figure></div>