Se você integra um ERP (Bling, Tiny) com o Mercado Livre e o estoque "fura" — você vende o que não tem, leva defeito de pedido e a reputação cai — a primeira reação é culpar a API. Na prática, quase nunca é a API.
Depois de fazer integrações de marketplace e reconciliação em produção, os furos vêm quase sempre de três lugares. Todos têm conserto.
1. Estrutura de variação incompatível
O caso mais comum: o produto tem variações no ERP (cor, tamanho) mas o anúncio no Mercado Livre é simples — ou o contrário. O sincronizador não sabe em qual variação colocar o estoque, então simplesmente não atualiza. Não dá erro visível; o estoque só congela.
Conserto: a estrutura no ERP tem que espelhar a do anúncio, variação por variação. Se o anúncio tem 3 variações, o ERP precisa ter os 3 SKUs correspondentes vinculados.
2. SKU desalinhado
O vínculo entre ERP e anúncio depende do SKU ser idêntico dos dois lados. Um espaço a mais, um zero à esquerda, um SKU trocado — e o sistema atualiza o estoque de outro item, ou de nenhum.
Conserto: auditar os SKUs dos dois lados e alinhar. É chato, mas é onde o dinheiro para de vazar.
3. Sincronização silenciosa (integração própria)
Se você tem integração custom (não o conector pronto), o furo costuma ser a rotina que manda o estoque e ninguém confirma que chegou. O ML rejeita, nada registra, e a divergência fica invisível até virar cancelamento.
Conserto: retry idempotente + um log que mostra cada divergência entre o estoque do ERP e o do marketplace. A regra: nunca confiar que "mandou" é "chegou".
Diagnóstico em 10 minutos
Pegue um SKU que furou e confira três coisas:
- A estrutura de variação bate dos dois lados?
- O SKU é idêntico no ERP e no anúncio?
- Se é integração própria, o último envio de estoque tem confirmação registrada?
Um desses três é o culpado em quase todos os casos.
Eu conserto integrações de marketplace (Mercado Livre, Olist, Bling, Tiny) — estoque, frete e sincronização — 100% por escrito, sem chamadas. Faço integrações de API em produção, incluindo 5 integrações da Selling Partner API da Amazon, validadas publicamente pela equipe deles no GitHub (issue #5353). Se seu estoque está furando: https://claude.ai/code/artifact/c5d6bbbe-23f3-44c2-a4ac-f8f8b3f1b97b
Top comments (0)