Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 05/05/2026
FAQs ME1 / ME2 e frete grátis

ME1 / ME2 e frete grátis


Por que definir shipping.mode = "me1" via API não exibe frete grátis no frontend mesmo com free_shipping:true no item?

Em ME1 o flag free_shipping:true pode existir nos dados, mas o Mercado Livre não o interpreta automaticamente como "frete grátis" no frontend nem aplica os benefícios automáticos do ME2. A visibilidade e os benefícios de "Frete grátis" são projetados para o ME2; para que o frontend exiba o frete grátis com os benefícios automáticos, o item deve estar no modo me2.

Recomendação
Se precisar da exibição e dos benefícios automáticos de frete grátis, verifique que o item esteja no modo ME2 e atenda aos requisitos de elegibilidade do mercado.
Por que ao tentar mudar um item de ME2 para ME1 a API o deixa como not_specified?

Se a conta ou as preferências do usuário têm coexistência priorizada para ME2 (por exemplo, tags como me2_available ou preferências), a plataforma pode impedir a conversão para ME1 e retornar not_specified. A razão costuma ser a configuração da conta e as preferências comerciais; a conversão para ME1 pode exigir intervenção comercial (KAM) para ajustar as preferências de envio.

Recomendação
Revise as preferências comerciais e tags do seller; se a conversão falhar, coordene com a equipe comercial para ajustar a configuração de coexistência.
É obrigatório estar no ME2 para que sejam ativadas automaticamente opções como "frete grátis para todo o país"?

Sim: muitas das regras automáticas de exibição e benefícios (por exemplo, "Frete grátis" com benefícios) se aplicam preferencialmente a itens no modo ME2 e dependem também do limite de preço e outras políticas internas. Não é possível forçar via API o benefício global se essas condições não forem atendidas.

Recomendação
Verifique a elegibilidade para ME2 e os limites exigidos; não tente forçar benefícios via API sem atender às condições do mercado.
É possível forçar via API o frete grátis para todo o país?

Não. A ativação de frete grátis em nível nacional depende de regras automáticas (preço, tipo de logística como ME2) e não pode ser forçada via API sem atender esses requisitos.

Recomendação
Ajuste preços e logística para atender às condições do mercado; não espere conseguir habilitar frete grátis nacional apenas via API.