O que é o Mercado Livre
O Mercado Livre é o maior marketplace da América Latina e, para muitas operações, o canal de maior volume. Tem regras próprias de anúncio, prazo de envio, atendimento e reputação — e a reputação determina posição na vitrine.
Integrar aqui não é só sincronizar dado: é sustentar prazo e evitar cancelamento, porque cada falha operacional custa posição e posição custa receita.
O que a API entrega
API REST com OAuth 2 e renovação de token, cobrindo anúncio, pedido, estoque, perguntas, mensagens e envio. É uma das APIs mais completas do mercado brasileiro.
Notificações são enviadas por evento e é o caminho recomendado — consulta periódica em catálogo grande é inviável pelo volume. Como sempre, a notificação chega repetida e às vezes fora de ordem.
As regras de negócio do canal (prazo de envio, tipo de logística, categoria) mudam com frequência e afetam a integração. É o ponto que mais exige manutenção continuada.
Fluxos que construímos
Publicação e atualização de anúncio
Cadastro do ERP virando anúncio com atributo de categoria correto, e atualização de preço e saldo com a frequência que o canal aceita.
Pedido para o ERP
Venda aprovada entrando no ERP com a informação de logística preservada, para a expedição cumprir o prazo prometido.
Perguntas e mensagens
Pergunta do anúncio chegando ao canal de atendimento que o time já usa, porque tempo de resposta conta para a reputação.
Conciliação de repasse
Extrato cruzado com pedidos, aplicando comissão, frete e taxa. É onde costuma aparecer diferença acumulada que ninguém tinha visto.
O que costuma quebrar
Anúncio ativo sem estoque
Cancelamento por falta custa reputação, e reputação custa vitrine. A regra de saldo precisa ser conservadora neste canal, mais do que nos próprios.
Notificação fora de ordem
Um evento antigo chegando depois de um novo pode sobrescrever o estado correto. O consumo precisa comparar versão, não confiar na ordem de chegada.
Atributo de categoria incompleto
Anúncio publicado com atributo faltando perde exposição sem gerar erro. É falha silenciosa e só aparece na queda de visita.
Estorno depois do repasse
Devolução chega semanas depois. Se o modelo tratou o repasse como consumado, não há de onde tirar o valor de volta.
Prazo típico
- 3 a 6
- semanas para anúncio, estoque e pedido
- +2
- semanas para conciliação de repasse
- contínua
- manutenção, porque as regras do canal mudam
Perguntas frequentes
Um hub de marketplace não resolve?
Resolve o caminho padrão, e se atende, use. Construir vale quando existe regra própria que o hub não modela ou quando o volume torna o custo por pedido relevante.
Como evitar cancelamento por estoque?
Com colchão de segurança calculado pela velocidade de venda do item, e não um percentual único para o catálogo. Em canal onde cancelamento custa reputação, ser conservador sai mais barato que vender mais um.
Vale integrar perguntas e mensagens?
Vale, e é subestimado. Tempo de resposta entra na reputação, e responder de dentro do canal de atendimento que o time já usa é o que torna isso sustentável em volume.
A integração quebra quando o canal muda as regras?
Pode quebrar, e por isso este é o cluster que mais exige sustentação. Monitoramento de erro por tipo e alerta quando um endpoint começa a recusar é o que transforma quebra em incidente de horas em vez de semanas.