API do Mercado Livre: como conectar o WooCommerce sem programar

As APIs do Mercado Livre são o caminho oficial para que um sistema externo, como a sua loja WooCommerce, publique produtos, atualize estoque e preços e leia pedidos sem que você precise entrar no Mercado Livre. Para conectar sua loja, você não é obrigado a programar em cima dessa API. Dá para desenvolver sua própria integração ou usar uma ferramenta que já resolve isso.

A resposta curta: se você tem uma equipe de desenvolvimento e necessidades muito específicas, programar pode fazer sentido. Se o que você quer é vender nos dois canais sem bagunçar o estoque, um plugin pronto economiza meses de trabalho e de manutenção. A seguir, explicamos o que a API permite, o que envolve construir algo próprio e como conectar sem código.

O que é a API do Mercado Livre

É uma API REST: um conjunto de endereços web (todos partem de api.mercadolibre.com) para os quais um programa pede ou envia dados. Cada recurso tem o seu: anúncios, usuários, categorias, pedidos, perguntas, envios. O programa faz uma requisição, o Mercado Livre responde com dados em formato JSON e o sistema os utiliza.

A documentação está no portal de desenvolvedores do Mercado Livre. Lá você encontra os guias por país, a referência de cada recurso e a seção do Mercado Envios para quem trabalha com a logística. Consulte sempre a versão vigente: o Mercado Livre muda regras, campos e modelos de anúncio com bastante frequência.

O que você pode fazer com a API

De forma geral, tudo o que você faz manualmente na sua conta de vendedor pode ser feito a partir de um sistema:

• Publicar produtos: criar anúncios com categoria, título, fotos, preço, condição e ficha técnica.
• Atualizar estoque e preço: alterar a quantidade disponível ou o preço quando eles mudam na sua loja.
• Pausar, ativar ou finalizar anúncios.
• Ler pedidos: saber o que foi vendido, se está pago e em que etapa do envio está.
• Responder perguntas: trazer as dúvidas que os compradores deixam nos seus anúncios antes de comprar e publicar as respostas a partir do seu próprio sistema, por exemplo com respostas prontas sobre tamanhos, envios ou estoque.
• Gerenciar mensagens de pós-venda: ler a conversa com cada comprador e responder sem abrir o Mercado Livre.
• Consultar categorias e atributos: quais dados cada categoria exige para que você possa anunciar.
• Receber notificações: o Mercado Livre avisa um endereço seu quando algo acontece (uma venda, uma alteração em um anúncio, uma nova pergunta), assim você não precisa ficar consultando o tempo todo.

O que envolve desenvolver sua própria integração

Aqui está a parte que muita gente não enxerga no começo. Conectar com a API não é trabalho de uma tarde. Estas são as frentes que você vai ter que cobrir.

1. Registrar uma aplicação

Antes de fazer qualquer requisição, você precisa criar uma aplicação no portal de desenvolvedores. Lá você obtém as credenciais dela e configura o endereço para onde o Mercado Livre redireciona o vendedor depois da autorização e o endereço onde você vai receber as notificações.

2. Autorização e tokens

O Mercado Livre usa OAuth: o vendedor faz login no Mercado Livre e dá permissão à sua aplicação. Em troca, seu sistema recebe um token de acesso que expira e um token para renová-lo. Sua integração precisa armazená-los com segurança, renová-los a tempo e perceber quando a permissão foi cortada, por exemplo se o vendedor trocou a senha ou revogou o acesso. Se a renovação falhar, tudo para: nada é publicado nem sincronizado. Quanto tempo dura cada token e como ele é renovado, você precisa confirmar na documentação oficial.

3. Limites de uso

A API limita quantas requisições você pode fazer em um período. Se o seu sistema ultrapassar esse limite, o Mercado Livre começa a rejeitar chamadas. Isso obriga a pensar em filas, em novas tentativas e em não fazer consultas desnecessárias. Os números exatos mudam, então confira na ajuda oficial antes de projetar qualquer coisa.

4. Categorias, atributos e rejeições

Cada categoria pede sua própria ficha técnica, e muitas exigem dados como o código universal (GTIN) ou uma tabela de medidas. Sua integração precisa converter os dados da sua loja para o formato de cada categoria e tratar os erros quando o Mercado Livre rejeita um anúncio.

5. Manutenção

É o custo mais subestimado. O Mercado Livre muda campos, regras e até a forma de anunciar: um exemplo recente é a mudança de algumas categorias para anúncios separados por variação, agrupados em «famílias». Cada mudança desse tipo obriga a mexer no código. Por isso, alguém precisa revisar a documentação oficial periodicamente, além de acompanhar os logs, tratar as notificações que não chegaram e corrigir o que ficou dessincronizado.

Programar o primeiro anúncio é a parte fácil. O difícil é a integração continuar funcionando sozinha durante anos, com milhares de produtos, sem vendas acima do estoque.

Como saber qual caminho é melhor para você

Programar em cima da API faz sentido se:

• Você tem um sistema próprio (um ERP, um sistema sob medida) que não é o WooCommerce.
• Você conta com desenvolvedores que vão manter a integração a longo prazo.
• Você precisa de processos muito específicos que nenhuma ferramenta resolve.

Um plugin pronto é melhor para você se:

• Você vende no WooCommerce e no Mercado Livre e quer que estoque e preços fiquem sempre atualizados.
• Você não tem equipe técnica, ou prefere que ela se dedique a outra coisa.
• Você quer começar a vender em dias, não em meses.

Como conectar o WooCommerce ao Mercado Livre sem programar

O WooSync é um plugin de WordPress que faz esse trabalho por você: ele usa a API oficial do Mercado Livre para publicar seus produtos do WooCommerce e sincronizar estoque, preço e status nos dois sentidos. Publicar e sincronizar estoque, preço e status está disponível em todos os planos, inclusive no Free. O que é exclusivo do plano Pro é a sincronização de vendas: fazer com que cada venda do Mercado Livre entre como pedido no seu WooCommerce é função do módulo Vendas, que só vem no Pro (mais abaixo contamos o que cada plano inclui).

O que em uma integração própria você teria que construir, aqui já está resolvido:

• Autorização: a conexão é feita por OAuth, o mecanismo oficial. O WooSync não armazena suas credenciais do Mercado Livre. Os tokens são administrados pelo Hub do WooSync, que é a sua conta em app.woosync.io: lá são gerenciadas as conexões com o Mercado Livre e as licenças. O Hub renova os tokens automaticamente quando expiram.
• Notificações: os avisos do Mercado Livre chegam ao Hub e são processados automaticamente. Quando você vende no Mercado Livre, o estoque é atualizado na sua loja; quando você vende no WooCommerce, ele é atualizado no Mercado Livre.
• Categorias e atributos: os modelos ligam cada categoria do Mercado Livre à sua ficha técnica, e o mapeamento de atributos preenche esses dados com o que você já tem cadastrado no WooCommerce.
• Tarefas em segundo plano: as publicações em massa são processadas em lotes, com novas tentativas automáticas diante de erros temporários.

Passo a passo

1. Instale o plugin. Baixe o .zip na sua conta em app.woosync.io. No WordPress, vá em Plugins → Adicionar novo → Enviar plugin, escolha o arquivo e clique em «Instalar agora» e depois em «Ativar plugin». Não é preciso inserir nenhuma licença: ela é resolvida automaticamente pelo seu domínio. Se você nunca enviou um plugin para o WordPress, siga o guia para instalar o WooSync no WordPress, que leva você do zero.
2. Vincule sua conta do Mercado Livre. A vinculação é feita na sua conta do WooSync, não dentro do WordPress. Acesse app.woosync.io → Conexões, encontre sua loja e clique em «Vincular ML». O Mercado Livre abre na mesma aba: faça login com a conta correta e aceite as permissões. Ao voltar, você verá «Pronto! Sua loja foi vinculada ao Mercado Livre». Também dá para chegar lá pelo plugin: em WooSync → Conexão, o botão «+ Vincular usuário» abre app.woosync.io em outra aba. Os detalhes estão no guia para vincular o WooCommerce ao Mercado Livre.
3. Monte seus modelos. Acesse WooSync → Modelos e clique em «Criar novo». Na busca, digite o produto que você vende e escolha a categoria que melhor o descreve. Confira bem antes de salvar: cada modelo fica ligado a uma categoria, e essa categoria não pode ser alterada depois. Preencha a ficha técnica solicitada e atribua o modelo aos seus produtos.

1. Publique. Acesse WooSync → Publicar no ML. O plugin confere seus produtos em relação ao Mercado Livre e mostra quais estão prontos e o que falta nos demais, agrupado por motivo. Para publicar em quantidade, acesse WooSync → Exportador. Nessa tela, você escolhe quais modelos exportar e clica em «Iniciar exportação»: são publicados todos os produtos que pertencem a esses modelos e têm os dados completos. Por isso, vale atribuir bem cada produto ao seu modelo no passo anterior. Se quiser publicar um único produto, não precisa passar pelo Exportador: você faz isso na página de edição desse produto no WooCommerce. O guia para exportar seu catálogo do WooCommerce para o Mercado Livre explica a publicação em massa em detalhes, e o de publicar no Mercado Livre com modelos, cada etapa do modelo.
2. Escolha o que será sincronizado. Acesse WooSync → Sincronizador e ative ou desative as regras de estoque, preço e status em cada sentido. Se você vende o mesmo produto nos dois canais, deixe o estoque ativado nas duas direções: isso evita vendas acima do estoque. Se você trabalha com preços diferentes por canal, deixe ativa apenas a direção do preço que deve prevalecer. Os detalhes de cada regra estão no guia do Sincronizador.

Se você já vende no Mercado Livre, também pode fazer o caminho inverso. Em WooSync → Importador, você traz seus anúncios para o WooCommerce e eles ficam vinculados, prontos para sincronizar.

O que cada plano inclui

• Free: 50 anúncios vinculados, 500 sincronizações por mês e 1 conta do Mercado Livre, com importador, exportador e sincronização de estoque, preço e status.
• Essencial: o mesmo, sem esses limites de anúncios e sincronizações. Não inclui os módulos avançados.
• Pro: tudo o que o Essencial tem, mais os módulos avançados, que só estão disponíveis neste plano. Entre eles, Vendas (a sincronização de pedidos: cada venda do Mercado Livre entra como pedido no seu WooCommerce), Perguntas, Mensagens e Métricas.

Se você está no Free ou no Essencial, o estoque, o preço e o status são sincronizados do mesmo jeito; o que não aparece na sua loja são esses módulos avançados. Você pode ver como funciona a sincronização de pedidos no guia de Vendas do Mercado Livre no WooCommerce e comparar os planos em Planos, preços e licenças.

Resumindo

A API do Mercado Livre permite automatizar quase tudo: publicar, atualizar estoque e preços, ler pedidos e responder aos compradores. Construir sua própria integração envolve registrar uma aplicação, lidar com tokens que expiram, respeitar limites de uso e manter o código toda vez que o Mercado Livre muda alguma coisa. Se a sua loja está no WooCommerce, você não precisa passar por tudo isso.

E se você já vende no Mercado Livre, pode começar trazendo seus anúncios para a loja: o guia para importar seus anúncios do Mercado Livre para o WooCommerce mostra como deixá-los vinculados e prontos para sincronizar.

Quer ter seus dois canais sincronizados sem escrever uma linha de código? Experimente o WooSync grátis.