Frete grátis

Os vendedores que utilizam o módulo de fretes Mercado Envios, no modo 1 ou modo 2, podem publicar produtos e oferecer um dos métodos de frete grátis.
Esta forma de envio tem alguns benefícios: é uma experiência de compra superior para o comprador, aparece em destaque nos resultados de busca e os compradores podem filtrar publicações que ofereçam frete grátis.
Foram implantadas recentemente algumas mudanças na API e na estrutura JSON dos produtos, adicionando a possibilidade de configurar “Regras” na opção free_shipping. Agora, os vendedores brasileiros com ME que incluem free_shipping em seus produtos podem excluir as regiões norte e nordeste, se assim desejarem. Isso é possível graças à regra “exclude_regions”. Outros sites somente podem usar a regra “país”, isto é, se estiverem incluindo frete grátis em seus produtos, isso será aplicado a todo o país.

Assuntos

Formas de envio

 curl https://api.mercadolibre.com/users/{user_id}/shipping_modes?category_id={category_id}

Esse recurso retornará a configuração de envio disponibilizada ao vendedor para uma categoria específica.

Resposta:

 http://developers.mercadolibre.com/free-shipping/
{
"mode": "me2",
 "shipping_attributes": {
   "costs": "not_allowed",
   "dimensions": "clear",
   "free": {
      "methods": "optional",
      "accepted_methods": [100009,182],
      "rules": [{
         "free_mode":"exclude_region",
         "value": [’BR-NO’, ’BR-NE’],
         "default": true,
         "free_shipping_flag": false
      },{
         "free_mode":"country",
         "value": null,
         "default": false,
         "free_shipping_flag": true
      }]
   }
}

Calcular o custo do frete grátis

Sites

Calcular custos para o frete grátis por site e dimensões do produto
Exemplo:

curl -X GET https://api.mercadolibre.com/sites/MLM/shipping_options/free?dimensions=2x11x25,500

Resposta:

{
"coverage": {
"all_country": {
"list_cost": 97,
"currency_id": "MXN"
}
}
}

Usuários e produtos

No México, o ML oferece aos vendedores a opção da tarifa fixa única. Quando as dimensões do produto não são especificadas, o cálculo é realizado com base nas dimensões padrão da categoria.

Saiba quais são as dimensões padrão de uma determinada categoria

Exemplo:

curl -X GET https://api.mercadolibre.com/categories/MLM165702/shipping

Resposta:

{
  "category_id": "MLM1055",
  "height": 10,
  "width": 10,
  "length": 15,
  "weight": 500
}

Calcular custos para frete grátis por usuário e dimensões do produto

Exemplo:

curl -X GET https://api.mercadolibre.com/users/4422224/shipping_options/free?dimensions=10x10x10,500

Resposta:

{
"coverage": {
"all_country": {
"list_cost": 97,
"currency_id": "MXN"
}
}
}

Calcular custos para frete grátis por usuário e item_id

Exemplo:

curl -X GET https://api.mercadolibre.com/users/4422224/shipping_options/free?item_id=MLM531425223
{
"coverage": {
"all_country": {
"list_cost": 97,
"currency_id": "MXN"
}
}
}

Calcular custos para frete grátis por produto

Exemplo:

curl -X GET https://api.mercadolibre.com/items/MLB739217081/shipping_options/free

Resposta:

{
"coverage": {
"all_country": {
"list_cost": 14.02,
"currency_id": "BRL"
}
}
}

Para calcular o custo do frete grátis de até 50 produtos, utilize multiget fazendo uma só chamada à API:
Exemplo:

curl -X GET curl -X GET https://api.mercadolibre.com/items/shipping_options/free?ids=MLM531425223,MLM537956425,MLM537955922

Resposta:

{
"MLM537955922": {
"coverage": {
"all_country": {
"list_cost": 140,
"currency_id": "MXN"
}
}
},
"MLM531425223": {
"coverage": {
"all_country": {
"list_cost": 97,
"currency_id": "MXN"
}
}
},
"MLM537956425": {
"coverage": {
"all_country": {
"list_cost": 105,
"currency_id": "MXN"
}
}
}
}

Produtos com frete grátis

curl https://api.mercadolibre.com/items/{item_id}

No produto, você verá que os “métodos” de propriedade foram substituídos por “free_methods” quando “free_shipping” for verdadeiro. Em free_methods, você obterá o ID do método e a “regra”.
Em “regras”, você deverá especificar se vai querer, ou não, excluir regiões no “free_mode”. Ao configurar “free_mode”: ”exclude_region”, você deverá enviar os valores, que, por enquanto, serão ‘BR-NO’ e ‘BR-NE’.
● ACESSAR frete artigo

{
   "shipping":{
      "mode":"me2",
      "local_pick_up":true,
      "free_shipping":true,
      "free_methods":[
         {
            "id":182,
            "rule":{
                "free_mode":"exclude_region",
                "value":[’BR-NO’, ’BR-NE’]
             }
         },
      ],
      "dimensions":null
   }
}

NOTA: embora o benefício, atualmente, só seja disponibilizado no MLB, a estrutura do JSON será atualizada em cada país com Mercado Envios. A partir da data da ativação, você terá um prazo de dois meses para adaptar-se a essas mudanças, ou seja, a API aceitará os dois tipos de JSON durante esse período, até finalizar o prazo – dois meses a partir de 30 de junho – data a partir da qual o JSON original não terá mais validade. Os produtos que tiverem a configuração anterior serão mantidos sem alterações, com exceção das novas publicações.

Oferecer a forma free_shipping “país”

Exemplo:

{
"title": "Titulo del item",
...
"shipping": {
    "mode": "me2",
    "local_pick_up": false,
    "free_methods": [
        {
            "id": 100009,
            "rule": {
                "free_mode": "country",
                "value": null
            }
        }
    ]
}
}

Oferecer free_shipping excluindo regiões

Exemplo:

{
    "shipping": {
        "free_methods": [
            {
                "id": 182,
                "rule": {
                    "free_mode": "exclude_region",
                    "value": [
                        "BR-NO",
                        "BR-NE"
                    ]
                }
            }
        }
    ],
    
}

Oferecer free shipping para envios personalizados

Para países onde Mercado Envíos encontra-se ativo só poderá adicionar envios custom grátis em categorias que não aceitem ME.

"shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": true,
        "methods": [],
        "costs": []
    }

Qualifique entre 1 e 5