O pedido entra no Mercado Livre às dez da noite. O estoque do Magento só baixa quando alguém importa a planilha de manhã, e nesse intervalo a última unidade foi vendida de novo na Shopee. Um dos pedidos vai ser cancelado: no Mercado Livre, venda cancelada pelo vendedor pesa na reputação; na Shopee, pedido não enviado no prazo é cancelado e conta na Taxa de Não Envio.
Quase nunca o problema é o marketplace. É a ligação entre ele, a loja e o ERP: token que expirou de madrugada, notificação que ninguém processou, SKU diferente na loja e no anúncio, nota fiscal que não subiu e segurou a etiqueta.
Sou desenvolvedor desde 2010, com Magento desde 2011, e ligo loja Magento 2 ou WooCommerce e ERP aos três canais pela API oficial de cada um, além de cuidar da implantação e otimização da conta. Em outubro de 2026, os três lideravam o ranking de sites de marketplace no Brasil da Similarweb, nesta ordem: Mercado Livre, Amazon e Shopee (só tráfego web).
Cada canal autentica, avisa sobre pedido e recebe nota de um jeito. Resumo da documentação oficial consultada em 22/11/2026:
| Ponto | Mercado Livre | Shopee | Amazon |
|---|---|---|---|
| Autenticação | OAuth 2.0, código de autorização e PKCE opcional | Autorização da loja e assinatura HMAC-SHA256 em toda chamada | Login with Amazon (LWA); app privado se autoriza no Seller Central |
| Access token | 6 horas | 4 horas | 1 hora |
| Renovação | Refresh token de 6 meses, uso único | Refresh token de 30 dias, uso único; loja autoriza por até 365 dias | App público reautoriza todo ano |
| Aviso de pedido | Notificação por tópico; responder HTTP 200 em até 500 ms | Push; responder 2xx com corpo vazio | Notifications API v1 (ORDER_CHANGE) |
| Nota fiscal pela API | Faturador: POST /users/$USER_ID/invoices/orders | upload_invoice_doc (XML modelo 55) | Delivery by Amazon API (DBA e envio próprio); a Invoices API lê as do FBA |
Limite de requisições também muda: o Mercado Livre aplica por aplicação e por endpoint, sem número geral publicado, e responde 429; na Shopee, não encontrei o limite documentado. Toda integração que eu escrevo tem fila e backoff exponencial.
Hub de integração e ERP com conector (Bling, Tiny/Olist, Anymarket, Ideris e outros) são o caminho mais comum e, para a maioria das lojas, o certo. API direta entra quando o hub não cobre a sua regra.
| Critério | Hub ou ERP com conector | Integração direta pela API | Planilha e painel |
|---|---|---|---|
| Quem acompanha as mudanças das APIs | O fornecedor do hub | Quem mantém o código | A sua equipe, à mão |
| Custo | Mensalidade do hub ou ERP | Desenvolvimento e manutenção | Horas da equipe |
| Regra própria (kit, estoque ou preço por canal) | Depende do hub | Escrita para a operação | Manual |
| Atraso entre venda e baixa de estoque | Intervalo de sincronização do hub | Tempo de processar a notificação | Até alguém atualizar |
| Bom para | A maioria das lojas | Volume alto ou regra própria | Poucos SKUs e um canal |
Muitas vezes a resposta mistura as duas primeiras: o ERP segue com o fiscal, e um módulo no Magento 2 ou plugin no WooCommerce faz o que o conector não faz. A Amazon lista Bling, Tray, Anymarket, Ideris, Ambar X e Shopping de Preços como integradores homologados no FBA; se o seu atende, configurar direito vale mais que código novo.
condition obrigatório na Shopee e fim da Orders API v0 da Amazon marcado para 27/03/2027.Projeto que pede time vai pela Agência Buzz, que fundei em 2012 em Londrina. A operação da conta é assunto da Ana Paula, sócia da Buzz, na página de especialista em marketplace.
Um cenário comum: loja em WooCommerce, ERP emitindo nota, Mercado Livre e Shopee com estoque atualizado por planilha uma vez por dia. O pedido de ajuda chega como “vendi o que não tinha”.
O que eu entrego: mapa de SKU entre loja, ERP e os dois canais; estoque de uma fonte só, com margem por canal; pedidos numa fila do Action Scheduler; token renovado sob trava; relatório diário de falhas. Se o ERP já tem conector para os dois canais, basta configurá-lo.
Para a maioria das lojas, um hub ou ERP com conector resolve. Integração direta pela API vale quando há regra que o hub não cobre ou quando o intervalo de sincronização já causa venda sem estoque.
Dá. Os três têm API pública documentada; mudam a autenticação, o aviso de pedido e o envio da nota fiscal. Na Amazon, a conta precisa do Plano Profissional para usar a SP-API.
Depende do desenho. Com a notificação do canal processada em fila, a baixa vem logo depois da venda; com sincronização por intervalo, o atraso é o próprio intervalo. Eu meço isso no diagnóstico antes de prometer número.
A Agência Buzz é a agência que eu fundei em 2012, em Londrina. Integração e ajuste técnico você contrata direto comigo; projeto que precisa de time vai pela Buzz, e eu continuo na parte técnica.