Hub de integração de marketplace: o que conferir antes de contratar

Para o lojista, isso se traduz em comportamento observável. Um hub que atualiza milhares de anúncios de uma vez precisa de fila e de ritmo, e a demonstração deve mostrar o que aparece na tela quando uma atualização fica retida: se o item entra numa lista de pendências com o motivo, ou se o saldo simplesmente não muda no canal e ninguém é avisado.

Como o hub fica sabendo de cada venda?

Pelas notificações da plataforma. A página de notificações do Mercado Livre informa que o aplicativo deve devolver a confirmação HTTP 200 em 500 milissegundos depois de receber cada aviso; sem isso, os tópicos podem ser desativados, e os avisos do período da desativação não ficam guardados. O texto acrescenta que as novas tentativas de envio ocorrem durante 1 hora, que depois disso o aviso é excluído e que a consulta de avisos perdidos só guarda os de até 2 dias atrás. Há tópicos separados para vendas confirmadas, para mudanças nos itens publicados e para alterações de estoque, entre outros.

O acesso também tem prazo. Segundo a página de autenticação e autorização, o token expira 6 horas depois de solicitado e é renovado com um segundo código, de uso único. O mesmo texto lista quatro eventos que podem derrubar o acesso antes da hora: troca de senha pelo usuário, atualização da chave secreta do aplicativo, revogação da permissão pelo usuário e quatro meses sem nenhuma chamada.

O lojista não precisa conferir nada disso em código. Precisa saber que o hub pode ficar surdo por um período, e perguntar o que ele faz ao voltar: se busca sozinho os pedidos que chegaram enquanto estava fora, em quanto tempo, e como a loja fica sabendo que houve o intervalo. O efeito de um saldo desatualizado sobre a venda sem estoque, e as proteções do lado da loja, estão no roteiro para integrar ERP, marketplaces e loja virtual.

O que a certificação do marketplace diz sobre o fornecedor?

O Mercado Livre mantém um programa de certificação de aplicativos, descrito na página do Developer Partner Program, com três medalhas: Silver, Gold e Platinum. Entre os requisitos para se candidatar, a página lista um volume mínimo de vendas dos vendedores que usam a solução, de US$ 2.500.000 por mês no Brasil, e a aprovação em uma avaliação de segurança com 65% ou mais. A versão lida pelo ConnectWeek, com data de atualização de 6 de outubro de 2026, traz um aviso de que o programa não aceita novas inscrições no último trimestre de 2026, por reestruturação interna.

O que mais interessa ao lojista está na parte da página do Developer Partner Program sobre manutenção da medalha. Quando a plataforma muda ou descontinua um recurso que afeta a operação dos vendedores, a alteração é obrigatória e o prazo de adaptação informado é de 15 dias. O aplicativo que descumpre os prazos entra em quarentena e deixa de aparecer na Central de Parceiros, a vitrine em que o Mercado Livre lista as soluções por categoria e mostra a medalha das que são certificadas. O suporte que o Mercado Livre presta ao integrador também varia: a tabela de benefícios da mesma página indica resposta em 2 dias para Silver, 1 dia para Gold e 3 horas para Platinum, em horário comercial.

Na avaliação do ConnectWeek, a medalha responde a uma pergunta só: se o fornecedor acompanha as mudanças daquele marketplace no ritmo que a plataforma exige. Ela não informa se o hub atende bem o lojista, nem vale para os outros canais. E o volume mínimo exigido deixa de fora, por definição, ferramentas pequenas ou novas, que podem servir a uma operação de nicho. Use a Central de Parceiros para conferir o que o vendedor do hub afirma, e pergunte o mesmo sobre cada canal em que a loja vende.

Que perguntas levar para a demonstração?

A lista abaixo é do ConnectWeek e parte do que as páginas acima permitem cobrar. Peça que cada resposta seja mostrada na tela do sistema, com uma conta de teste, em vez de descrita em apresentação.

1. Cobertura por canal. Para cada marketplace da loja: o hub publica anúncios, atualiza preço e estoque, recebe pedidos, gera etiqueta e trata devolução, ou cobre só uma parte? O recurso de que a loja depende, como variações, kits ou o envio pelo centro de distribuição do marketplace, entra nessa cobertura?
2. Identificação do produto. O hub casa os itens pelo código interno da loja e pelo GTIN, ou cria um cadastro próprio que passa a ser a referência? O cuidado com o código de barras está em EAN e GTIN para marketplace.
3. Quem manda no estoque. O saldo sai de um sistema só, como recomenda o roteiro de integração, ou o hub aceita ajuste manual no próprio painel?
4. Atualização por evento. O saldo é reenviado aos outros canais a cada venda ou em ciclos? De quanto em quanto tempo?
5. Fila e erro visível. Onde aparecem as atualizações recusadas ou retidas, com o motivo, e quem é avisado?
6. Retomada. Depois de uma queda, o hub recupera sozinho os pedidos e os avisos do intervalo?
7. Mensagens ao comprador. O que é enviado automaticamente, e como desligar?
8. Mudança de regra do marketplace. Como o fornecedor comunica a adaptação e onde publica o histórico de versões?
9. Suporte em data de pico. Qual o canal e o horário de atendimento na Black Friday, e o que está escrito no contrato sobre isso?
10. Acesso de pessoas. A equipe da loja entra com usuários individuais e perfis diferentes, e o painel registra quem alterou preço ou saldo?
11. Exportação. A loja baixa, sem depender do fornecedor, o cadastro de produtos com o vínculo de cada anúncio e o histórico de pedidos?
12. Encerramento. O que acontece com os anúncios criados pelo hub quando o contrato termina?

Se a loja ainda decide entre o conector que já vem no sistema de gestão e um hub à parte, a comparação por volume de pedidos e número de canais está em ERP para e-commerce: como escolher. Para ligar dois ou três sistemas simples, sem marketplace no meio, a automação no-code é o caminho descrito em outro artigo do portal.

O que observar no período de teste?

O roteiro de integração já lista os pedidos de teste que toda ligação nova precisa passar: compra em cada canal, cancelamento, devolução, mudança de preço e estoque zerado. No teste de um hub, o ConnectWeek sugere acrescentar o relógio a esses mesmos casos, com poucos produtos reais:

• Da venda ao saldo nos outros canais. Anote a hora da compra em um canal e a hora em que o saldo mudou nos demais. Repita em horários diferentes.
• Do pedido ao sistema de gestão. Quanto tempo o pedido leva para aparecer pronto para separar.
• Do erro ao aviso. Provoque uma recusa, por exemplo um anúncio sem um atributo obrigatório, e veja quando e a quem o hub avisa.
• Do chamado à resposta. Abra um chamado de suporte durante o teste e anote o tempo até a primeira resposta útil.

O portal não indica tempo de referência para nenhuma dessas medidas. O que serve de comparação é o intervalo que a operação aguenta: uma loja com poucas unidades de cada item tolera menos atraso de saldo do que outra com estoque folgado. Uma contagem do estoque antes e depois do teste, como a descrita em inventário cíclico, mostra se as baixas chegaram todas.

Como a loja desliga o hub se precisar trocar?

A autorização dada no início pode ser retirada pelo vendedor, e as duas plataformas documentam isso. No Mercado Livre, a revogação da permissão pelo usuário é um dos eventos que podem invalidar o acesso do aplicativo, segundo a página de autenticação e autorização. Na Amazon, a página sobre revogação de autorizações informa que só o vendedor pode revogar a autorização que concedeu a um aplicativo e descreve o caminho na central do vendedor: o menu de aplicativos e serviços, a página de gerenciamento dos aplicativos e a opção de desativar a autorização. A documentação está em inglês, e os nomes dos menus em português podem diferir.

Desligar o acesso é a parte simples. A parte que exige preparo é o que fica. Pergunte ao fornecedor o que acontece com os anúncios criados pelo hub depois do desligamento e onde está guardado o vínculo entre cada anúncio e o código interno do produto. Se esse vínculo fica no hub, confirme antes de assinar que ele sai em arquivo, e guarde uma exportação recente enquanto o contrato estiver ativo. No dia da troca, o ConnectWeek sugere esta ordem para evitar venda sem estoque: pausar a sincronização do sistema antigo, conferir os saldos, ligar o novo e só então revogar a autorização do anterior, para que dois programas não gravem na mesma conta ao mesmo tempo.