Mercado Livre: integração NF-e, PIX e Mercado Envios em 2026

API do Mercado Livre — o que você precisa

A API REST do Mercado Livre é gratuita e bem documentada (developers.mercadolivre.com.br). Para integrar como seller, você precisa: (1) criar um app no Painel do Desenvolvedor (~5 minutos); (2) gerar tokens OAuth (com refresh a cada 6 horas); (3) configurar webhook URL para receber notificações de pedidos, perguntas e mensagens; (4) implementar as rotas /orders, /shipments, /messages, /questions. O 4b2b cobre esses passos out-of-the-box, mas é útil entender o funcionamento.

NF-e automática por pedido — fluxo recomendado

Quando um pedido entra (notificação "orders_v2"), o fluxo deve ser:

• Receber a notificação, buscar o pedido via /orders/{id} e o pagamento via /payments/{id}
• Verificar se o pagamento está "approved" — só então proceder
• Buscar dados completos do comprador (CPF/CNPJ, endereço, estado de destino)
• Gerar NF-e na SEFAZ-estadual do seller, com ICMS calculado conforme estado do comprador
• Anexar o DANFE em PDF na mensagem do ML para o comprador via /messages
• Atualizar o status do pedido para "shipped" quando a etiqueta for impressa

Mercado Pago — conciliação fiscal

O Mercado Pago retém a comissão (8-16% conforme categoria + 5% se for venda parcelada) antes de repassar para o seller. A nota fiscal deve ser emitida com o valor BRUTO da venda (não líquido) — a comissão do ML não é abatimento de receita, é despesa operacional (Lucro Presumido) ou crédito sobre PIS/COFINS (Lucro Real). Erros comuns: emitir NF-e com valor líquido (gera passivo fiscal) ou esquecer a base de cálculo do ICMS quando o destino é interestadual.

Mercado Envios — etiqueta e tracking

Mercado Envios é o serviço de logística unificado do ML, com três modalidades: Full (fulfillment terceirizado, o seller envia o estoque para o galpão do ML); Flex (seller cuida do envio e o ML supervisiona); Próprio (seller usa transportadora própria fora do ML). Em todos os casos, a etiqueta deve ser impressa e o código de rastreio atualizado no pedido para o ranking do anúncio não ser penalizado. O 4b2b puxa a etiqueta do ML automaticamente e envia tracking via WhatsApp.

O ranking do anúncio — o que importa para o algoritmo

O algoritmo do ML prioriza anúncios com: (1) reputação verde (poucos cancelamentos, poucas reclamações abertas); (2) NF-e emitida em até 24h após o pagamento aprovado; (3) tempo de envio reduzido (Flex ou Full > Próprio); (4) responsividade às perguntas em até 1 hora; (5) baixa taxa de reembolso. Automação técnica é essencial — sellers que dependem de processo manual chegam a tempo médio de NF-e de 36h e perdem ranking.

4invoices.net + 4shopy.net é a integração nativa para Mercado Livre, Magalu, Shopee e Amazon BR: pedido entra como webhook, NF-e sai na SEFAZ correta, DANFE anexado ao chat, conciliação Mercado Pago automática, tracking via WhatsApp. Tempo médio do pedido pago à NF-e emitida: 30 segundos. Suporte a NFC-e para retirada em loja física.