{"section":"tutorials","requestedLocale":"pt","requestedSlug":"mercado-livre-faq","locale":"pt","slug":"mercado-livre-faq","path":"docs/pt/tutorials/integrações/visão-geral-de-integrações/mercado-livre-faq.md","branch":"main","content":"Este guia tem como objetivo responder as perguntas mais frequentes sobre o Integração com o Mercado Livre. \n\n- [Anúncios/Produtos](#anunciosprodutos)\n  * [Por que não consigo enviar a descrição do meu produto em HTML para o Mercado Livre?](#por-que-nao-consigo-enviar-a-descricao-do-meu-produto-em-html-para-o-mercado-livre)\n  * [Por que meu anúncio foi pausado no Mercado Livre?](#por-que-meu-anuncio-foi-pausado-no-mercado-livre)\n  * [O que significa esse erro \"The attributes [BRAND, MODEL] are required for category MLBXXXX\"?](#o-que-significa-esse-erro-the-attributes-brand-model-are-required-for-category-mlbxxxx)\n  * [Por que meu anúncio está desativado no Mercado Livre?](#por-que-meu-anuncio-esta-desativado-no-mercado-livre)\n  * [Como alterar a imagem de um produto no Mercado Livre?](#como-alterar-a-imagem-de-um-produto-no-mercado-livre)\n  * [Por que o título do meu anúncio aparece cortado no Mercado Livre?](#por-que-o-titulo-do-meu-anuncio-aparece-cortado-no-mercado-livre)\n  * [Como faço para reenviar informações dos produtos para o Mercado Livre?](#como-faco-para-reenviar-informacoes-dos-produtos-para-o-mercado-livre)\n  * [Por que meu produto foi categorizado de forma errada no Mercado Livre?](#por-que-meu-produto-foi-categorizado-de-forma-errada-no-mercado-livre)\n  * [Por que o Mercado Livre retorna erros de atributo após o mapeamento?](#por-que-o-mercado-livre-retorna-erros-de-atributo-apos-o-mapeamento)\n  * [Como identificar o atributo que está faltando ou que é inválido ?](#como-identificar-o-atributo-que-esta-faltando-ou-que-e-invalido-)\n  * [Por que os meus anúncios no Mercado Livre não têm os SKUs agrupados?](#por-que-os-meus-anuncios-no-mercado-livre-nao-tem-os-skus-agrupados)\n  * [Por que as especificações/atributos dos meus SKUs não são enviadas para o Mercado Livre?](#por-que-as-especificacoesatributos-dos-meus-skus-nao-sao-enviadas-para-o-mercado-livre)\n  * [Como apagar um anúncio no Mercado Livre?](#como-apagar-um-anuncio-no-mercado-livre)\n  * [Como reenviar um anúncio para o Mercado Livre?](#como-reenviar-um-anuncio-para-o-mercado-livre)\n  * [Por que não consigo atualizar as informações do meu produto no Mercado Livre?](#por-que-nao-consigo-atualizar-as-informacoes-do-meu-produto-no-mercado-livre)\n  * [Entendendo os erros do Bridge](#entendendo-os-erros-do-bridge)\n- [Logística](#logistica)\n  * [Por que meu pedido com \"Entrega a combinar\" não foi integrado no Bridge?](#por-que-meu-pedido-com-entrega-a-combinar-nao-foi-integrado-no-bridge)\n  * [Por que meu pedidos estão caindo na tabela de contingência em vez do frete VTEX?](#por-que-meu-pedidos-estao-caindo-na-tabela-de-contingencia-em-vez-do-frete-vtex)\n- [Configurações](#configuracoes)\n  * [Por que meus pedidos não integram com o Mercado Livre?](#por-que-meus-pedidos-nao-integram-com-o-mercado-livre)\n\n## Anúncios/Produtos\n\n### Por que não consigo enviar a descrição do meu produto em HTML para o Mercado Livre?\n\nExistem três formas de enviar a descrição do seu produto para o Mercado Livre, são elas:\n\n- Preencher o campo **Descrição do produto**\n- Criar uma especificação de produto\n- Criar template na Central de Mensagens (opcional)\n\n> ℹ️ Leia o artigo do Mercado Livre [“Como descrever os seus produtos”](https://www.mercadolivre.com.br/ajuda/completar_informacao_dos_seus_produtos_3147) para dicas de como descrever seus produtos.\n\n#### Preencher o campo Descrição do produto\n\nAcesse no Admin VTEX *PRODUTOS > Catálogo > Produtos e SKUs* e clique no botão `Alterar`. Depois, preencha o campo **Descrição do produto** com a descrição que desejar para o seu produto.\n\nOu você pode utilizar a rota [PUT Update Product](https://developers.vtex.com/vtex-rest-api/reference/catalog-api-put-product) e preencher o campo **Description** com a descrição que desejar para o seu produto.\n\n#### Criar uma especificação de produto\n\n[Crie uma especificação de produto](/pt/tracks/catalogo-101--5AF0XfnjfWeopIFBgs3LIQ/4fcdmJzQ6QYA9zWf3bLWin) chamada `plaintext_description_meli` e preencha com a descrição que desejar que desejar para o seu produto.\n\nOu você pode utilizar a rota [POST Create Specification](https://developers.vtex.com/vtex-rest-api/reference/catalog-api-post-specification) e preencher o campo **Name** com `plaintext_description_meli` e o campo **Description** com a descrição que desejar para o seu produto.\n\n#### Criar template na Central de Mensagens (opcional)\n\nA [Central de Mensagens](/pt/docs/tutorials/conhecendo-o-message-center) é um módulo responsável por configurar e enviar e-mails na VTEX através de um template de mensagens. A vantagem de criar um template para descrição dos seus produtos, é que se sua loja anunciar muitos produtos no Mercado Livre, eles terão uma descrição padrão e personalizada para todos eles.\n\nAntes de criar o template, é necessário [preencher o campo Descrição do anúncio](#preencher-o-campo-descrição-do-produto). Ele será importante para criar uma descrição exclusiva para o seu produto. Depois de preencher o campo, acesse o Admin VTEX em *CLIENTE > Central de mensagens > Templates* e busque pelo card **Bridge - Integração Mercado Livre**.\n\nAo abrir o template, você deverá preencher o **campo HTML** utilizando a linguagem HTML com para definir o formato da descrição que deseja. Uma vez que você cria um template de descrição, todos os seus produtos anunciados no Mercado Livre terão o mesmo formato de descrição.\n\nNão é necessário preencher os campos relacionados ao e-mail, somente o **campo HTML**. Recomendamos que você crie uma descrição padrão para seus produtos. A descrição preenchida no campo `Descrição do produto` será utilizada dentro do **campo HTML**.\n\nVeja um exemplo de template para a descrição de seus produtos. Os valores entre `[ ]` devem ser substituídos pela descrição que você escolher.\n\n```\n[Loja do Gustavo] < br> \n[Entrega em todo o Brasil] \n[Direto da fábrica]\n{{TÍTULO}} < br>\n{{DESCRIÇÃO}}\n\n< br> [DÚVIDAS FREQUENTES]< br>\n< br> [O PRODUTO É NOVO?] < br>\n< br> [Sim, todos os nossos produtos são novos.] < br>\n```\n\nOs campos `{{TÍTULO}}` e `{{DESCRIÇÃO}}` utilizarão as informações do produto preenchidas nos campos **Nome** e **Descrição** do  produto em Admin VTEX *PRODUTOS > Catálogo > Produtos e SKUs*.\n\nA descrição personalizada do seu anúncio no Mercado Livre será exibida no seguinte formato:\n\nLoja do Gustavo\nEntrega em todo o Brasil\nDireto da fábrica\n\\{\\{TÍTULO\\}\\}\n\\{\\{DESCRIÇÃO\\}\\}\n\nDÚVIDAS FREQUENTES\nO PRODUTO É NOVO?\nSim, todos os nossos produtos são novos.\n\n### Por que meu anúncio foi pausado no Mercado Livre?\n\nA pausa no anúncio do Mercado Livre pode ter ocorrido por dois motivos:\n\n#### 1. Quando o produto é removido da política comercial vinculada ao Mercado Livre ou inativado, o anúncio será pausado.\n\nPara realizar a integração com o Mercado Livre é definir uma política comercial, ou seja, estabelecer uma diferenciação de catálogo e/ou logística entre os diferentes canais de venda de uma loja. [Leia mais](/pt/docs/tracks/configurar-politica-comercial-para-o-mercado-livre)\n\n#### 2. Quando o produto atinge o estoque mínimo cadastrado, o anúncio será pausado. O valor desse estoque mínimo é definido no painel de configuração do Mercado Livre no Bridge da VTEX.\n\nAo cadastrar um produto, é necessário estabelecer uma quantidade mínima para o estoque daquele item. Quando o número de produtos atinge o teto estabelecido, o anúncio é pausado do Mercado Livre. O valor desse estoque mínimo é definido no painel de configuração do Mercado Livre da VTEX.\n\n### O que significa esse erro \"The attributes [BRAND, MODEL] are required for category MLBXXXX\"?\n\nA categoria em questão exige o mapeamento de marca e modelo. Essas informações devem estar presentes na planilha de mapeamento. Formato de exemplo:\n\n![mercadolivre faq erro](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/integrações/visão-geral-de-integrações/mercado-livre-faq_1.JPG)\n\n### Por que meu anúncio está desativado no Mercado Livre?\n\nA VTEX não desativa anúncios no Mercado Livre, somente os pausamos. \n\n### Como alterar a imagem de um produto no Mercado Livre?\n\nO envio das imagens de um produto ocorre apenas uma vez, quando o anúncio é criado no Mercado Livre. Portanto, se o produto tiver sua imagem alterada na VTEX após ter sido integrado com Mercado Livre, esta informação não será atualizada.\n\nUm possível workaround é excluir o anúncio no Mercado Livre e enviar as informações do produto novamente para o Mercado Livre, reindexando o produto na VTEX. No entanto, ao realizar esta ação, você deve saber que todo o histórico deste anúncio será excluído no Mercado Livre. Será criado um novo anúncio, sem nenhuma relação com as informações do anúncio anterior.\n\n### Por que o título do meu anúncio aparece cortado no Mercado Livre?\n\nO Mercado Livre possui uma limitação de 60 caracteres no nome do anúncio. Portanto, quando escolher o formato do Título do anúncio no painel de configuração do Mercado Livre no Bridge da VTEX, fique atento a esta restrição.\n\n### Como faço para reenviar informações dos produtos para o Mercado Livre?\n\nPela regra do Mercado Livre, não é possível reenviar informações dos produtos depois que eles foram anunciados e vendidos. Será necessário excluir o anúncio do produto e alterar as informações desejadas.\n\nCaso o produto não tenha sido vendido ainda, será possível fazer alterações. Se a alteração for no valor da variação/atributo, essa mudança deve ser realizada na [página de mapeamento](/pt/docs/tracks/mapear-categorias-e-atributos-dos-produtos-para-o-mercado-livre-mapper). Se a alteração for no valor da especificação do produto, leia nosso artigo [Cadastrar especificações de produto](/pt/tracks/catalogo-101--5AF0XfnjfWeopIFBgs3LIQ/4fcdmJzQ6QYA9zWf3bLWin).\n\n> ⚠️ Após excluir um produto, não é possível recuperar a relevância do seu anúncio.\n\n### Por que meu produto foi categorizado de forma errada no Mercado Livre?\n\nErro de categorização está relacionado ao nome e o preço do produto. Para a categorização correta dos seus seus produtos é necessário fazer [upload da planilha de mapeamento](https://assets.ctfassets.net/alneenqid6w5/qyDp7OSL5YAGaGKagWiK0/07900f41a952a460185e18f9db190eb1/Planilha_de_Mapeamento_do_Mercado_Livre.xlsx). Essa planilha será utilizada nas etapas de categorização, variação e atributos do seu produto. Para saber mais consulte este [artigo](/pt/tracks/configurar-integracao-do-mercado-livre--2YfvI3Jxe0CGIKoWIGQEIq/5XNeiye4rS4oao2MueSUeA#categorizacao).\n\n### Por que o Mercado Livre retorna erros de atributo após o mapeamento?\n\nCada categoria de produto no Mercado Livre exige atributos diferentes. Por exemplo, para um calçado de adulto, pode ser necessário indicar na planilha de mapeamento os códigos dos atributos **Cor principal** e **Tamanho de calçado para adulto**.\n\nPor outro lado, para cada uma dessas categorias de produto, alguns atributos não são aceitos. Para o mesmo calçado de adulto, por exemplo, não pode ser atribuído um código referente a **Tamanho de cinto**.\n\nA VTEX não consegue indicar exatamente quais atributos têm que ser preenchidos para cada categoria, uma vez que esse é um critério interno ao Mercado Livre.\n\nNo entanto, esses atributos são bastante claros (Cor principal, Cor secundária, Tamanho de calçado para adulto, Tamanho de cinto, Tamanho de roupa para bebês etc.) Devem ser escolhidos os atributos pertinentes a cada produto.\n\nSe algum desses atributos for preenchido incorretamente (por exemplo, se você atribuiu um código referente a Tamanho de cinto para um calçado), o Integrações vai retornar um erro com o seguinte formato:\n\n![mercadolivre faq erro2](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/integrações/visão-geral-de-integrações/mercado-livre-faq_2.JPG)\n\nNeste caso, temos dois exemplos de erros na mesma mensagem.\n\nO primeiro deles indica que o atributo cujo código se inicia com o número `113000` é necessário para a categoria escolhida e não foi inserido na planilha de mapeamento. Veja a planilha abaixo:\n\n![mercadolivre faq erro3](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/integrações/visão-geral-de-integrações/mercado-livre-faq_3.JPG)\n\nO segundo erro indica que o atributo cujo código se inicia com o número `63000`, inserido na última coluna da planilha acima, é inválido para a categoria escolhida.\n\n### Como identificar o atributo que está faltando ou que é inválido ?\n\nOs códigos de cada variação de atributo se iniciam com o mesmo número. Por exemplo, todos os códigos referentes a **Cor principal** começam com 33000 e correspondem ao seguinte formato: 33000_Amarelo_52007. Já os códigos referentes a **Cor secundária** se iniciam com 43000. Exemplos: `43000_Azul claro_52093` e `43000_Rosa_52058`.\n\nPara identificar o atributo indicado na mensagem de erro, consulte o número inicial dos códigos determinados pelo Mercado Livre. Clique no nome do seu país para fazer o download da planilha de referência:\n\n1. [Brasil](https://assets.contentful.com/alneenqid6w5/22NlNdUIBK8qWic8cYw2sg/11c88bb0b439c7c7f8ce5909923af3d6/Brasil.zip)\n2. [Argentina](https://assets.contentful.com/alneenqid6w5/3c61gJrH7GWOywMCGMECg4/dc7a2ce73a99d41345dde2092eb1fec6/Argentina.rar)\n3. [Colômbia](https://assets.contentful.com/alneenqid6w5/5RePTJoKrYi4qA66WCCYKw/33910300057806b554d566210aa2310a/Colombia.rar)\n4. [México](https://assets.contentful.com/alneenqid6w5/3Z3xgpPyvuYEAIO2me4GSG/e4f4198463d8a3ba05124a30031302fa/Mexico.rar)\n\n### Por que os meus anúncios no Mercado Livre não têm os SKUs agrupados?\n\nCom exceção dos produtos de roupa, calçados e bolsas, a integração cria somente um anúncio por SKU. Com isso, os SKUs não ficam agrupados em apenas um anúncio no Mercado Livre.\n\n### Por que as especificações/atributos dos meus SKUs não são enviadas para o Mercado Livre?\n\nCom exceção dos SKUs de roupa, para enviar as variações e atributos dos SKUs de qualquer categoria é necessário montar a planilha de mapeamento. Para mais informações, leia o artigo [Mapeamento de categorias, variações e atributos do Mercado Livre](/pt/docs/tracks/mapear-categorias-e-atributos-dos-produtos-para-o-mercado-livre-mapper).\n\n### Como apagar um anúncio no Mercado Livre?\n\nA finalização de anúncio deve ser realizada diretamente no Mercado Livre. Caso você não deseje que um produto seja enviado novamente para o Mercado Livre, lembre-se de retirá-lo da política comercial vinculada ao Mercado Livre.\n\n### Como reenviar um anúncio para o Mercado Livre?\n\nCaso um anúncio tenha sido finalizado e você deseje reenviá-lo ao Mercado Livre, basta reindexar o produto desejado na VTEX para que as informações sejam reenviadas para o Mercado Livre.\n\n### Por que não consigo atualizar as informações do meu produto no Mercado Livre?\n\nNeste cenário, é possível que estes produtos que não tenham suas informações atualizadas tenham sido criados diretamente no painel do Mercado Livre. Não recomendamos a criação de produtos diretamente no painel do Mercado Livre. Os produtos criados diretamente no Mercado Livre não terão suas informações atualizadas pela VTEX.\n\n### Entendendo os erros do Bridge\n\n`Items in category ML…. cannot exceeds XX pictures.`\n\nExplicação:\nO comportamento da integração é o seguinte:\nExiste o elemento principal do anúncio e ele contém as variações (que são os skus na VTEX). Sempre que um produto possui variações, todas as suas imagens são adicionadas nesse elemento principal.\n\nAcontece que cada categoria tem sua especificação de quantidade de imagens que podem ser adicionadas, para o caso da categoria MLA3697 são somente 12 imagens permitidas para esse elemento principal. Veja [aqui](https://api.mercadolibre.com/categories/MLA3697) as condições dessa categoria. \n\n![mercadolivre faq erro4](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/integrações/visão-geral-de-integrações/mercado-livre-faq_4.JPG)\n\n`Sku não integrado pois o mesmo não possui descrição`\n\nExplicação:\n\nPara os skus novos, ao enviarmos para o Meli a sua descrição o fluxo é:\n\n1. Procurar se ele possui uma especificação de produto chamada `plaintext_description_meli`, se possuir enviamos ela como descrição.\n2. Procurar se ele possui um template de Mercado Livre, se possuir enviamos ele como descrição (para garantir que o template está funcional, verificar se ele aparece no preview).\n3. Procurar se ele possui uma descrição no catálogo, se possuir enviamos ela como descrição.\n4. Caso não possua nenhum dos passos anteriores, logamos o erro no Bridge de \"SKU não integrado pois o mesmo não possui descrição.\"\n\n## Logística \n\n### Por que meu pedido com \"Entrega a combinar\" não foi integrado no Bridge?\n\nNão recomendamos a utilização do tipo de entrega Entrega a combinar. Em pedidos fechados com este tipo de entrega, como não temos a informação do endereço de entrega, o pedido não será integrado com a VTEX.\n\nPara que um pedido seja integrado corretamente, é necessário que o pedido tenha as informações de entrega. Assim, recomendamos sempre a utilização do Mercado Envios para os pedidos realizados no Mercado Livre.\n\n### Por que meu pedidos estão caindo na tabela de contingência em vez do frete VTEX?\n\nAo calcular o frete de um pedido a integração faz uma simulação de fulfillment. Esse retorno demora, geralmente, 200ms. O Mercado Livre possui um limite de tempo de espera de 400ms e se o retorno da simulação ultrapassar esse tempo o frete será através da tabela de contingência. Geralmente, esse tempo é longo quando a operação logística da account é complexa (ex: muitas transportadoras cadastradas).\n\n## Configurações\n\n### Por que meus pedidos não integram com o Mercado Livre?\n\nNo caso do Mercado Livre, quando o token de integração é desativado - seja qual for o motivo - os pedidos realizados no marketplace não são enviados para a plataforma da VTEX. Para resolver esse erro será preciso refazer o processo de integração.\n\nDito isso, o primeiro passo é acessar o cadastro dessa integração:\n\n1. Acesse o módulo __Marketplace__\n2. Clique em __Integrações__\n3. Procure o __painel__ do Mercado Livre\n4. Clique na __engrenagem__ <img class=\"shadow-4\" src=\"https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/integrações/visão-geral-de-integrações/mercado-livre-faq_5.png\" />\n5. Clique em __Editar configuração__\n\nA partir daí, é preciso refazer o processo de integração.\n\n6. Clique no botão __Desativada__ \n7. Clique em __Salvar configuração__\n\nAguarde cerca de 15 minutos. Em seguida, prossiga:\n\n8. Acesse novamente o __cadastro da integração__. Basta repetir os primeiro cinco passos do tutorial\n9. Clique no botão __Ativada__ \n10. Clique em __Salvar configuração__\n\nFeito isso, aguarde mais 15 minutos. Agora começa a etapa mais importante do processo.\n\n11. Acesse o __painel__ do Mercado Livre\n12. Faça o __login__ com a conta que deseja integrar\n13. Refaça o __[processo de autorizaçao](/pt/docs/tracks/autorizar-integracao-do-mercado-livre-no-painel-da-vtex)__\n15. __Salve__ as configurações.\n\nPronto! Desse modo, sua integração voltará a funcionar normalmente dentro de alguns minutos."}