Mercado Livre e Magalu na loja Magento: hub integrador ou integração direta?

Hub de marketplace ou integração direta: o que cada um é

Um hub de marketplace é um serviço de terceiro que fica no meio: conecta na loja Magento de um lado e em vários canais do outro, com painel próprio para anúncios, pedidos e estoque. A integração direta é código feito para a sua loja, em módulo ou serviço, que conversa com a API de cada marketplace sem intermediário.

Os dois publicam produto, sincronizam preço e estoque, trazem o pedido para o Magento e devolvem nota fiscal e rastreio. A diferença está em quem mantém tudo funcionando quando o marketplace troca a API, o ERP muda de versão ou o Magento recebe patch. A pergunta que eu faço primeiro: quantos canais você vai operar nos próximos 12 meses e quem vai atender quando um pedido não descer?

Integração direta com a API do Mercado Livre e da Magalu: o que elas exigem

É este o trabalho que o hub faz por você ou que o seu fornecedor vai ter de manter, segundo a documentação oficial de cada canal.

Mercado Livre

• Token que expira: o access token vale 6 horas. A renovação usa um refresh token de uso único: só o último gerado funciona e ele expira em 6 meses. Troca de senha do vendedor ou revogação da autorização invalida os tokens.
• Notificação com prazo: o Mercado Livre espera HTTP 200 em até 500 milissegundos. Sem isso, a mensagem é reenviada durante 1 hora e depois descartada, e os tópicos podem ser desativados.
• Notificação só avisa: ela indica o recurso que mudou e o detalhe vem de uma consulta à API. A documentação recomenda confirmar na hora e processar numa fila.

Magalu

• OAuth 2.0 com consentimento do seller: a aplicação é criada no ID Magalu e o seller autoriza com as credenciais da loja. O código de autorização vale 10 minutos e é de uso único.
• Validade informada na resposta: o campo expires_in traz a validade do access token (a documentação usa 7200 segundos como exemplo), renovado com o refresh token.
• Webhooks: avisam que um registro mudou para o sistema buscar o dado na API. Na versão v1, a URL precisa ser HTTPS e cada notificação chega assinada com HMAC-SHA256.

O custo não está em fazer, e sim em manter: token que falha de madrugada, fila que acumula no pico, versão nova de API.

Vender no Mercado Livre com o estoque do Magento sem vender o que não tem

O erro mais caro que eu vejo nessa integração é enviar o número errado de estoque. No Magento com o Inventory Management, vale a quantidade vendável: a soma das fontes, descontado o limite de fora de estoque, menos as reservas dos pedidos ainda não enviados. A API REST expõe esse número em GET /V1/inventory/get-product-salable-quantity/:sku/:stockId, rota que eu conferi no código da 2.4.8-p4.

• Enviar a quantidade física da fonte ignora o que já foi vendido e ainda está no depósito: o marketplace vende de novo a mesma unidade.
• Consumidor de reservas parado também quebra a conta. A Adobe avisa que as reservas dependem do consumidor inventory.reservations.updateSalabilityStatus rodando continuamente.

Toda sincronização tem atraso. Para a margem de segurança, eu uso esta conta:

margem de segurança = vendas por minuto do SKU no pico x intervalo de sincronização em minutos

Exemplo ilustrativo: um SKU que vende 0,2 unidade por minuto no pico, somando todos os canais, com sincronização a cada 15 minutos, precisa de 0,2 x 15 = 3 unidades de folga. Com atualização a cada 2 minutos, a folga cai para menos de 1 unidade. Intervalo de sincronização é critério de contrato.

Hub de marketplace para Magento ou integração direta: 8 critérios

A regra de decisão que eu aplico: três canais ou mais, sem equipe técnica e com catálogo padrão, vão de hub. Um ou dois canais, catálogo com regra própria (kit, variação fora do padrão, preço calculado por canal) e alguém para manter o código, vão de integração direta. Na dúvida, começo pelo hub no canal que mais vende e reavalio em 12 meses.

Custo de integrar marketplace no Magento: como comparar as propostas

Não existe preço de tabela que sirva para a sua loja, e hub e desenvolvimento cobram de jeitos diferentes. Para comparar, coloque as duas propostas no mesmo horizonte:

custo do hub em N meses    = implantação + (mensalidade x N) + (taxa por pedido x pedidos em N meses)
custo da direta em N meses = desenvolvimento + (manutenção mensal x N) + adaptações de API previstas

Inclua a taxa por pedido ou por anúncio, se houver, e o custo de adaptar a integração direta quando a API mudar. Rode a conta em 12, 24 e 36 meses: se o hub só fica mais caro depois do terceiro ano e você não sabe se continuará nos mesmos canais, a flexibilidade dele vale dinheiro.

Perguntas para fazer ao hub ou ao desenvolvedor antes de assinar

1. O estoque enviado é a quantidade vendável do Magento? Com que intervalo?
2. Quando o marketplace muda a API, quem adapta, em quanto tempo e com custo de quem?
3. Onde eu vejo o log de cada chamada, com horário e resposta?
4. Se eu cancelar, em que formato recebo pedidos, anúncios e vínculos de SKU?
5. Quem garante que nota fiscal e rastreio cheguem ao marketplace: hub, ERP ou loja?

Quando a integração parar, siga o dado elo por elo, como no artigo sobre integração entre Magento e ERP que parou. Integração com Mercado Livre, Magalu e Amazon está entre o que cobre o suporte Magento 2.