Integração WMS com Mercado Livre, Shopee e marketplaces

Cada marketplace define suas próprias regras de prazo, etiqueta e modalidade logística, mas o armazém não pode ter um processo de picking diferente para cada canal. A integração precisa normalizar essas diferenças antes de chegar ao WMS e devolver eventos que cada plataforma reconheça no formato esperado.

Resposta rápida

WMS integra com marketplaces por conexão direta, hub, ERP ou OMS, que normaliza pedidos e particularidades de cada canal antes de chegar ao armazém. O contrato interno deve preservar canal, loja, pedido, item, prazo, modalidade logística (como Full, Flex ou envio próprio) e documentos fiscais. Publique estoque por SKU com cotas ou buffer por canal, trate etiqueta e expedição por modalidade e use idempotência para não duplicar pedido em reenvios.

Como integrar marketplaces ao WMS?

Marketplaces podem ser conectados diretamente pela API de cada plataforma, por hub de integração, ERP ou OMS. A camada escolhida normaliza pedidos e particularidades de cada canal antes do WMS. O contrato interno deve preservar canal, loja, pedido, item, prazo, modalidade logística e documentos, mesmo quando o formato original de cada marketplace é diferente.

A decisão deve ser registrada em um desenho de integração com origem, destino, gatilho, contrato, SLA e responsável. Consulte integrações WMS para a arquitetura completa.

Como integrar WMS com Mercado Livre?

O Mercado Livre expõe API própria (Mercado Livre Developers) com autenticação OAuth, notificações de pedido e modalidades logísticas distintas — como Mercado Envios Full (estoque no CD do marketplace), Flex (entrega própria em janela curta) e envio padrão. A integração precisa identificar qual modalidade se aplica a cada pedido: pedidos Full normalmente não passam pelo WMS do vendedor, enquanto Flex e envio próprio exigem separação e expedição no prazo definido pela plataforma.

Como integrar WMS com Shopee?

A Shopee tem sua própria Open Platform, com autenticação, webhooks de pedido e regras de etiqueta e prazo específicas, incluindo programas de logística própria da plataforma. Assim como no Mercado Livre, o WMS só deve receber pedidos cuja execução física é responsabilidade do vendedor — a integração precisa filtrar e mapear a modalidade antes de gerar tarefa de picking.

Sincronização de estoque

Calcule disponibilidade por SKU e origem, deduzindo reservas e bloqueios do saldo físico. Cotas ou buffers podem proteger canais em momentos de latência ou pico de venda. Atualização por evento reduz atraso; uma varredura reconciliadora periódica verifica se todos os anúncios receberam o saldo esperado, já que cada marketplace pode ter limites de chamada e atraso próprio de propagação.

Etiquetas, packing e expedição

A origem da etiqueta depende da modalidade: alguns fluxos usam etiqueta gerada pelo próprio marketplace, outros dependem da transportadora contratada pelo vendedor. O WMS associa etiqueta, pedido e volume, valida itens no packing e confirma a expedição no momento acordado com cada plataforma. Reimpressões devem ser auditadas e não podem gerar um segundo volume lógico associado ao mesmo pedido.

Falhas e governança

Use idempotência, filas, retentativas limitadas e dead letter queue para mensagens que falham repetidamente. Trate cancelamento tardio, pedido duplicado, SKU não mapeado, mudança de prazo e indisponibilidade do canal como fluxos previstos, não exceções ad hoc. Indicadores por marketplace revelam atraso de importação, erro de publicação, cancelamento e expedição fora do SLA — cada canal deve ser medido separadamente, porque volume e exigência variam muito entre eles.

Passo a passo recomendado

1. Mapeie processos, sistemas e autoridades de dados por canal.
2. Defina contratos, IDs, estados e regras de transformação por marketplace.
3. Implemente autenticação, idempotência, filas e auditoria.
4. Homologue o fluxo normal e todas as exceções relevantes de cada plataforma.
5. Monitore latência, erros, backlog e divergências por canal.
6. Faça reconciliação e ensaie a recuperação antes da produção.

Erros comuns

• Tratar todos os marketplaces com o mesmo contrato de integração.
• Confundir modalidade logística (Full, Flex, envio próprio) e gerar tarefa de picking indevida.
• Atualizar o mesmo dado nos dois lados sem autoridade definida.
• Ignorar limites de chamada, versões e eventos fora de ordem de cada plataforma.
• Não preservar os identificadores de origem do pedido.
• Entrar em produção sem painel, alerta e procedimento de replay por canal.

Exemplo prático

Um pedido do Mercado Livre chega com modalidade Flex e prazo de duas horas para coleta. A integração valida que o item pertence ao estoque do vendedor (não é Full), cria a reserva no WMS com o mesmo identificador do pedido e aguarda separação. O WMS confirma packing e expedição; a integração devolve o código de rastreio no formato esperado pela plataforma. Se o Mercado Livre estiver indisponível no momento da confirmação, o evento fica em fila e é reenviado com a mesma chave idempotente até ser reconhecido.

Perguntas frequentes

Pedidos Full passam pelo WMS do vendedor?

Normalmente não. No Mercado Envios Full, o estoque fica armazenado no centro do próprio marketplace, que executa separação e expedição. O WMS do vendedor só participa do reabastecimento desse estoque, não da execução do pedido final.

É possível usar o mesmo fluxo para Mercado Livre e Shopee?

O desenho de integração (contrato interno, idempotência, filas) pode ser reaproveitado, mas a tradução de campos, modalidades e eventos precisa de um adaptador específico para cada plataforma, já que APIs, autenticação e regras de prazo são diferentes.

Como evitar vender o mesmo item em dois marketplaces?

Publicando estoque vendável centralizado — descontado de reservas e buffer — e não o saldo físico bruto em cada canal separadamente. Veja como evitar estoque negativo para o desenho de reserva atômica que sustenta isso.

Conclusão

Integrar WMS a marketplaces como Mercado Livre e Shopee exige normalizar modalidades logísticas diferentes antes de chegar ao armazém, publicar estoque vendável por canal e tratar cada plataforma com seu próprio contrato de eventos. Idempotência, filas e indicadores por marketplace mantêm pedido, estoque e expedição coerentes mesmo quando um canal falha.