Como sincronizar o estoque entre Shopify e Mercado Livre
Como funciona a sincronização de estoque entre Shopify e Mercado Livre: que estoque enviar, locais, armazéns, Full, vendas sem pagamento e o que revisar.
Em resumo
Para sincronizar o estoque entre a Shopify e o Mercado Livre, deixe a Shopify mandar e faça cada anúncio receber um número calculado: o estoque dos locais que atendem suas vendas, menos um estoque de segurança e as unidades de vendas que ainda não são pedidos na Shopify, sem passar de um máximo. Esse número deve ser atualizado a cada aviso de mudança e com uma revisão completa periódica. O estoque do Full é controlado pelo Mercado Livre, e os anúncios de um mesmo produto compartilham o estoque.
Sincronizar o estoque entre a Shopify e o Mercado Livre significa que cada anúncio ofereça as unidades que você realmente pode vender, e que esse número mude quando o seu estoque muda. Isso não depende de uma ferramenta específica: todas precisam responder às mesmas perguntas.
Este guia explica como funciona: que número cada anúncio deve receber, o que acontece com vários locais e armazéns, com o Full e com as vendas que ainda não foram pagas, quando atualizar e o que revisar quando um número não bate. Se você quer entender por que vende peças que já não tem, comece por como evitar vender sem estoque.
Uma só fonte de verdade
O seu estoque precisa ficar em um só lugar. O mais comum é que seja a Shopify: ali você registra compras, ajustes, devoluções e as vendas de todos os seus canais, e o Mercado Livre recebe um número calculado a partir dali.
Isso tem uma consequência prática: se você mudar o estoque manualmente no Mercado Livre, a próxima atualização vai sobrescrevê-lo. Os ajustes são feitos na Shopify.
A exceção é o Full. Esse estoque fica nos armazéns do Mercado Livre e quem o controla é o Mercado Livre, não a sua loja. Falamos dele mais abaixo.
Que número cada anúncio deve receber
O número que você publica não é o seu estoque total. É esta conta:
Estoque publicado = estoque nos locais que contam − estoque de segurança − unidades de vendas que ainda não são pedidos na Shopify, sem passar de um máximo e nunca menor que zero.
- Locais que contam. Só os que atendem suas vendas do Mercado Livre.
- Estoque de segurança. Algumas unidades que você não publica, para absorver duas compras quase ao mesmo tempo em dois canais.
- Unidades de vendas que ainda não chegaram à Shopify. Enquanto uma venda não é um pedido na Shopify, o seu estoque da Shopify não a desconta. Se você não subtrair essas unidades, volta a oferecer peças que já vendeu.
- Máximo. Um teto opcional, para não expor todo o seu estoque em um só canal.
Exemplo. Você tem 10 unidades no seu armazém e 4 na sua loja física, que vende no balcão. Você conta só o armazém (10), guarda 2 de estoque de segurança (8) e há uma venda em outro canal que ainda não entrou na Shopify (7). Se o seu máximo é 6, você publica 6.
Vários locais na Shopify
A Shopify controla o estoque por local: o cartão de estoque de cada variante mostra quantas unidades há em cada armazém ou loja ativa.
Conte só os locais de onde você envia suas vendas do Mercado Livre. Uma loja física que vende no balcão pode ficar sem peças antes que o seu anúncio fique sabendo.
Se um local ficar negativo, conte-o como zero. Isso pode acontecer com vendas no balcão: segundo a ajuda da Shopify, no Shopify POS a equipe pode continuar vendendo quando o estoque disponível chega a zero ou menos.
Contas com vários armazéns no Mercado Livre
O Mercado Livre permite que algumas contas distribuam o estoque de um mesmo produto entre vários armazéns próprios; ele chama isso de estoque multiorigem. Segundo a documentação para desenvolvedores, nem toda conta tem esse recurso: o Mercado Livre o ativa conforme critérios como a logística que você usa ou os endereços de onde você envia. Os armazéns só podem ser criados pela sua conta do Mercado Livre e, no Brasil, só no mesmo estado do CNPJ do vendedor.
Em uma conta assim, o estoque é gerenciado por armazém. A sua sincronização precisa saber para qual armazém mandar o seu estoque da Shopify: normalmente, o que atende essas vendas. Os outros mantêm o que você definir no Mercado Livre.
Um detalhe da mesma documentação: em uma conta com vários armazéns, uma mudança de estoque enviada pelo caminho de sempre pode responder que deu tudo certo sem mudar nada. Se o seu número não se mexe, revise este caso primeiro.
Full e Full + Flex
Com o Full, sua mercadoria fica nos armazéns do Mercado Livre e o Mercado Livre envia cada venda. Segundo a documentação para desenvolvedores, você manda a mercadoria ao armazém pela sua conta, e pela API esse estoque só pode ser consultado.
Por isso uma sincronização nunca deve escrever o estoque do Full nem somá-lo ao estoque que você publica a partir da Shopify.
Um anúncio pode ter Full e Flex ao mesmo tempo. Como o estoque se divide depende do seu país e da sua conta: segundo a documentação do Mercado Livre, na Argentina e no Chile o estoque do Flex pode ser gerenciado à parte; no México, pelo gerenciamento por armazéns; e no Brasil essa opção em geral está bloqueada. Explicamos isso em Mercado Livre Full e o estoque da Shopify.
Um produto por trás de vários anúncios
No modelo de User Products do Mercado Livre, um mesmo produto (na verdade, uma variante) pode estar por trás de vários anúncios, por exemplo um Clássico e um Premium. Segundo a documentação, um produto admite até 30 anúncios, e quando você muda o estoque de um, o Mercado Livre copia a mudança para todos os outros.
Para a sua sincronização, isso significa duas coisas:
- O estoque é escrito uma vez por produto. Não adianta mandar 5 para o Clássico e 3 para o Premium: os dois terminam com o mesmo número.
- Todos apontam para a mesma variante da Shopify. Não é um conflito: é o mesmo produto com outras condições de venda.
Antes do User Products, cada anúncio tinha o seu próprio estoque. Se você ainda tem anúncios assim, a sua ferramenta precisa atualizar cada um. E para que cada anúncio encontre a sua variante, você precisa de SKUs organizados; explicamos isso em SKUs e variações.
Vendas sem pagamento: o caso do dinheiro no OXXO
No Mercado Libre México, um comprador pode pagar em dinheiro com um ticket do OXXO, uma rede mexicana de lojas de conveniência. Até ele pagar, a compra existe, mas não está paga.
Segundo a documentação para desenvolvedores do Mercado Livre, uma compra assim pode ser cancelada por dois motivos: o pagamento não chega dentro de certo prazo, ou o pagamento precisava ser aprovado para descontar o estoque e, nesse meio-tempo, o anúncio foi pausado ou finalizado por falta de estoque. Nesse caso, o Mercado Livre devolve o dinheiro ao comprador. A documentação descreve essas regras de forma geral, para qualquer compra cujo pagamento ainda espera aprovação.
Para o seu estoque, isso deixa duas regras:
- No Mercado Livre, não é preciso reter essas unidades. Se elas acabarem antes da aprovação do pagamento, o Mercado Livre cancela a compra.
- Nos seus outros canais, sim. Essa venda ainda não é um pedido na Shopify, então a sua loja continuaria oferecendo a peça. Se ela for vendida ali e depois o comprador pagar, você terá duas vendas para uma só peça e precisará cancelar uma.
Reter essas unidades tem um custo: enquanto o pagamento não chega, seus outros canais não as oferecem. Se a compra for cancelada, elas voltam a ser oferecidas.
Por que os pedidos precisam chegar à Shopify
A Shopify desconta o estoque quando o pedido existe. Segundo a ajuda da Shopify, as unidades de um pedido feito e ainda não processado passam para o estado Committed (comprometido) e deixam de estar disponíveis.
Se uma venda do Mercado Livre nunca chega à Shopify como pedido, o seu estoque da Shopify não baixa. Na próxima vez que a sua ferramenta mandar o estoque, ela vai oferecer de novo a peça que você já vendeu.
Por isso sincronizar o estoque e importar os pedidos andam juntos. E enquanto um pedido não é criado na Shopify (porque falhou, porque está em espera ou porque está sendo criado), as unidades dele são subtraídas do estoque que você publica.
Os pedidos do Full são diferentes: devem chegar à Shopify para os seus registros, mas sem baixar o estoque dos seus locais, porque saem do armazém do Mercado Livre.
Quando o estoque deve ser atualizado
O ideal combina duas coisas:
- Uma atualização a cada mudança. A Shopify avisa os apps sobre as mudanças na sua loja (webhooks), e o Mercado Livre manda notificações quando muda um anúncio, uma venda ou o estoque de um produto. Assim o número se mexe quando o seu estoque se mexe, não de tempos em tempos.
- Uma revisão completa periódica. Os dois reconhecem que um aviso pode se perder. A Shopify avisa que a entrega dos seus avisos nem sempre está assegurada e recomenda consultar os dados de novo periodicamente. O Mercado Livre considera perdida uma notificação que o seu app não confirma depois de oito novas tentativas, em uma hora.
Recalcule também quando mudar suas regras (locais, estoque de segurança ou máximo) e quando outro canal retiver ou liberar unidades.
O que revisar quando um número não bate
Antes de corrigir manualmente, procure a causa. Estas são as mais comuns:
- O anúncio aponta para outra variante. Um SKU repetido ou digitado errado o vincula ao produto errado.
- A diferença é proposital. O estoque de segurança, o máximo e as unidades retidas baixam o número que você publica.
- Um local não conta, ou está negativo. Revise quais locais somam.
- Há vendas que não chegaram à Shopify. Um pedido com erro ou em espera não baixa o seu estoque da Shopify.
- É estoque do Full. Em um anúncio com Full, o número que você vê pode ser o do armazém do Mercado Livre, não o seu.
- A sua conta tem vários armazéns. Revise qual recebe o seu estoque da Shopify e se a mudança foi aplicada de verdade.
- O produto tem vários anúncios. Com User Products, eles compartilham estoque; antes, cada um tinha o seu.
- Você pausou o anúncio, ou ele está finalizado. Segundo o Mercado Livre, um anúncio que você mesmo pausou não é reativado sozinho, mesmo que receba estoque, e um finalizado não pode ser reativado, só republicado. Se o Mercado Livre o migrou para User Products, o antigo fica fechado e há um novo.
- A variante não controla estoque na Shopify. Se o acompanhamento da quantidade estiver desativado, não há número para copiar.
- O último envio falhou. O Mercado Livre limita quantas chamadas aceita por minuto. Revise o registro da sua ferramenta.
Para comparar, exporte o seu estoque da Shopify por local (em Produtos > Estoque, com Exportar) e coloque-o ao lado do estoque dos seus anúncios.
Passos para sincronizar o seu estoque
- Decida a fonte de verdade. Normalmente, a Shopify. A partir daí, ninguém ajusta o estoque manualmente no Mercado Livre.
- Organize seus SKUs. Um SKU único por variante, o mesmo nos dois canais.
- Escolha os locais que contam. Só os que atendem suas vendas do Mercado Livre.
- Defina seu estoque de segurança e, se precisar, um máximo. Para começar, 1 ou 2 unidades de estoque de segurança costumam bastar.
- Separe o Full. A sua sincronização não deve escrevê-lo nem somá-lo.
- Escolha o armazém que recebe o seu estoque, se a sua conta do Mercado Livre tiver vários.
- Importe seus pedidos para a Shopify. Sem pedidos, o seu estoque da Shopify não baixa.
- Retenha nos seus outros canais as vendas sem pagamento. E libere-as se a compra for cancelada.
- Teste com poucos produtos. Mude o estoque de 3 a 5 produtos na Shopify e confira cada um dos anúncios deles.
- Compare uma vez por dia durante a primeira semana. Exporte o seu estoque da Shopify por local e confira se cada anúncio tem o número esperado.
Perguntas frequentes
Shopify ou Mercado Livre: qual deve mandar no estoque?
Só um, e normalmente a Shopify, porque é ali que você registra as compras, os ajustes e as vendas de todos os seus canais. A exceção é o Full: esse estoque é controlado pelo Mercado Livre.
Por que o meu anúncio mostra menos unidades que a Shopify?
Quase sempre é proposital: o estoque de segurança, o máximo, os locais que não contam e as unidades retidas para vendas que ainda não chegaram à Shopify baixam o número que você publica.
O que acontece com uma compra que ainda espera o pagamento?
Ela espera o pagamento, como uma compra no Mercado Libre México paga em dinheiro no OXXO. Enquanto isso, convém reter as unidades dela nos seus outros canais. No Mercado Livre não é preciso: segundo a documentação, se o anúncio ficar sem estoque antes da aprovação do pagamento, o Mercado Livre cancela a compra.
Basta a minha ferramenta reagir aos avisos?
Não totalmente. A Shopify e o Mercado Livre avisam cada mudança, mas os dois reconhecem que um aviso pode se perder. Uma revisão completa de tempos em tempos encontra o que escapou.
Posso ajustar o estoque diretamente no Mercado Livre?
Se a Shopify manda, não: a próxima atualização sobrescreve a sua mudança. Faça o ajuste na Shopify. O estoque do Full é à parte: você o aumenta mandando mercadoria ao armazém do Mercado Livre.
Sobre o Toldo
O Toldo é um app para a Shopify feito por nós; está em implantação por etapas, com um grupo pequeno de sócios fundadores. Começamos pelo Mercado Libre México: a tela de conexão também aceita contas do Mercado Livre Brasil, mas alguns recursos ainda funcionam só no México, e o Toldo não emite notas fiscais brasileiras (NF-e) (Notas fiscais no Brasil). Ele calcula o estoque de cada anúncio com a conta deste guia: o estoque dos locais da Shopify que você escolher, menos as suas Unidades de reserva (um único número por conta conectada) e as unidades retidas de pedidos que ainda não estão na Shopify, sem passar do máximo que você definir e nunca abaixo de zero. Ele recalcula assim que a Shopify avisa da mudança e quando outro canal retém ou libera unidades, revisa todos os seus anúncios vinculados a cada 6 horas e registra cada envio na Atividade da conta, com o motivo em linguagem clara se algo falhar. Também deixa você escolher o armazém que recebe o seu estoque, se tiver vários, nunca modifica o estoque do Full e não envia estoque sem criar também na Shopify os seus pedidos do Mercado Livre (Regras de estoque). O Toldo cobra um preço fixo por mês, sem comissão por venda. Durante a implantação, ativamos cada função por etapas.
Mercado Livre, Shopify e OXXO são marcas de seus respectivos donos. O Toldo é um app independente; não é afiliado nem endossado por eles.
Fontes
Consultadas em 16 de novembro de 2026, salvo indicação de outra data.
- Mercado Livre para desenvolvedores, publicar e sincronizar (atualizada em 21/10/2026): https://developers.mercadolibre.com.ar/en_us/products-sync-listings
- Mercado Livre para desenvolvedores, User Products (atualizada em 19/12/2025): https://developers.mercadolibre.com.ar/en_us/user-products
- Mercado Livre para desenvolvedores, preço por variação (atualizada em 13/08/2026): https://developers.mercadolibre.com.ar/en_us/price-per-variation
- Mercado Livre para desenvolvedores, estoque multiorigem (atualizada em 20/04/2026): https://developers.mercadolibre.com.ar/en_us/multi-origin-stock
- Mercado Livre para desenvolvedores, perguntas frequentes sobre estoque multiorigem (atualizada em 05/05/2026): https://developers.mercadolibre.com.ar/en_us/multi-origin-stock-management-user-products
- Mercado Livre para desenvolvedores, estoque distribuído (atualizada em 22/04/2026): https://developers.mercadolibre.com.ar/en_us/distributed-stock
- Mercado Livre para desenvolvedores, Full (atualizada em 19/02/2026): https://developers.mercadolibre.com.ar/en_us/fulfillment
- Mercado Livre para desenvolvedores, vendas e status de uma venda (atualizada em 24/06/2026): https://developers.mercadolibre.com.ar/en_us/manage-sales
- Mercado Livre para desenvolvedores, notificações (atualizada em 23/06/2026): https://developers.mercadolibre.com.ar/en_us/products-receive-notifications
- Mercado Libre México, como pagar a sua compra (dinheiro com ticket do OXXO): https://www.mercadolibre.com.mx/ayuda/Como-pagar-tu-compra_923
- Central de Ajuda da Shopify, estados do estoque: https://help.shopify.com/en/manual/products/inventory/managing-inventory-quantities/inventory-states
- Central de Ajuda da Shopify, configurar o estoque pela primeira vez (vendas no Shopify POS sem estoque): https://help.shopify.com/en/manual/products/inventory/getting-started-with-inventory/set-up-inventory-tracking
- Central de Ajuda da Shopify, exportar e importar o estoque com um arquivo CSV: https://help.shopify.com/en/manual/products/inventory/setup/inventory-csv
- Shopify para desenvolvedores, webhooks: https://shopify.dev/docs/apps/build/webhooks