Mercado Livre · Shopee · Amazon

Integração com marketplaces: loja e ERP ligados ao Mercado Livre, à Shopee e à Amazon

Integração com marketplace é a ligação, pela API, que mantém estoque, preço, pedido e nota fiscal iguais entre a sua loja Magento 2 ou WooCommerce, o ERP e os canais Mercado Livre, Shopee e Amazon. Eu escrevo essa ligação pela API oficial de cada canal ou configuro o hub que você já usa, com fila, renovação de token e conciliação.

Atualizado em · por Roger Takemiya

O problema

Onde a venda em vários canais costuma quebrar

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).

Lado a lado

Mercado Livre, Shopee e Amazon: o que muda na integração de cada um

Cada canal autentica, avisa sobre pedido e recebe nota de um jeito. Resumo da documentação oficial consultada em 22/11/2026:

Diferenças técnicas entre as três APIs
PontoMercado LivreShopeeAmazon
AutenticaçãoOAuth 2.0, código de autorização e PKCE opcionalAutorização da loja e assinatura HMAC-SHA256 em toda chamadaLogin with Amazon (LWA); app privado se autoriza no Seller Central
Access token6 horas4 horas1 hora
RenovaçãoRefresh token de 6 meses, uso únicoRefresh token de 30 dias, uso único; loja autoriza por até 365 diasApp público reautoriza todo ano
Aviso de pedidoNotificação por tópico; responder HTTP 200 em até 500 msPush; responder 2xx com corpo vazioNotifications API v1 (ORDER_CHANGE)
Nota fiscal pela APIFaturador: POST /users/$USER_ID/invoices/ordersupload_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.

Como escolher

Hub de integração, API direta ou planilha

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.

Três formas de manter loja, ERP e marketplaces sincronizados
CritérioHub ou ERP com conectorIntegração direta pela APIPlanilha e painel
Quem acompanha as mudanças das APIsO fornecedor do hubQuem mantém o códigoA sua equipe, à mão
CustoMensalidade do hub ou ERPDesenvolvimento e manutençãoHoras da equipe
Regra própria (kit, estoque ou preço por canal)Depende do hubEscrita para a operaçãoManual
Atraso entre venda e baixa de estoqueIntervalo de sincronização do hubTempo de processar a notificaçãoAté alguém atualizar
Bom paraA maioria das lojasVolume alto ou regra própriaPoucos 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.

Como eu trabalho

Do diagnóstico à integração no ar

  1. Diagnóstico. Onde está a verdade de cada dado (estoque, preço por canal, emissão da nota) e se o acesso está certo: no Mercado Livre, quem autoriza o app precisa ser administrador; na Amazon, a SP-API exige o Plano Profissional.
  2. Mapa de SKU. Cada produto da loja ligado ao anúncio e à variação no Mercado Livre e na Shopee, e ao ASIN na Amazon. Sem esse mapa, nenhuma sincronização é confiável.
  3. Integração. Token renovado sob trava, notificação respondida na hora e processada em fila, estoque com margem por canal, pedido gravado com o número do marketplace.
  4. Nota e conciliação. A nota sai do ERP ou do emissor do canal e sobe pela API; a tarifa de cada pedido é lida do marketplace, não calculada por fora.
  5. Acompanhamento. Log por chamada, alerta de falha e revisão quando o canal muda regra. Em 2026 mudou nos três: aplicação separada do Mercado Pago no Mercado Livre, campo 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.

Exemplo

Um cenário comum

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.

O que eu não faço

  • Não vendo conector pronto nem assinatura. O projeto usa a API oficial ou o hub que você escolher, e o código fica com você.
  • Não tenho selo de parceiro oficial do Mercado Livre, da Shopee ou da Amazon.
  • Não decido regra fiscal: CFOP, regime, IBS e CBS são com o seu contador.
  • Não escrevo integração para contornar regra do canal, como anúncio duplicado na Shopee.
  • Se o volume é pequeno e o hub ou ERP que você já paga resolve, você não precisa de mim.

Perguntas frequentes

Preciso de integração própria ou um hub de marketplace resolve?

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á para integrar o Magento 2 direto com Mercado Livre, Shopee e Amazon?

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.

Em quanto tempo o estoque atualiza nos canais?

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 e você são a mesma coisa?

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.

Quer que eu olhe o seu caso?

Me conte o que está acontecendo. Respondo pessoalmente, em horário comercial.