Frete grátis

Conteúdos

→Calcule os custos de frete grátis
    ↳Por país e dimensões do produto
    ↳Por usuário e dimensões do produto
    ↳Por item
→Consultar os produtos com frete grátis
→Ofereça frete grátis para todo o país
→Ofereça frete grátis para envios personalizados

Calcular custos de frete grátis

Por país e dimensões do produto

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/shipping_options/free?dimensions=$DIMENSIONS

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLM/shipping_options/free?dimensions=2x11x25,500

Resposta:

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

Por usuário e dimensões do produto

Exemplo:

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

Resposta:

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

Calcule os custos de frete grátis por usuário e item_id

Exemplo:

curl -X GET 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/4422224/shipping_options/free?item_id=MLM531425223

Resposta:

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

Por item

Exemplo:

curl -X GET 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB739217081/shipping_options/free

Resposta:

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

Utilize multiget para calcular o custo do frete grátis para até 50 produtos em uma única chamada de API:

Exemplo:

curl -X GET 'Authorization: Bearer $ACCESS_TOKEN' 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"
			}
		}
	}
}

Consultar os produtos com frete grátis

curl -X GET 'Authorization: Bearer $ACCESS_TOKEN'  https://api.mercadolibre.com/items/$ITEM_ID

No produto, você verá que substituímos a propriedade "methods" por "free_methods" quando "free_shipping" for verdadeiro. De acordo com free_methods, você terá o ID do método e a "regla".
Na seção "regla", você deve especificar se deseja excluir ou não regiões em "free_mode". Se você configurar "free_mode": "exclude_region", deve-se enviar os valores, que por enquanto serão 'BR-NO' e 'BR-NE'.

{
   "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
   }
}

Oferece o modo free_shipping para todo o país

Exemplo:

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

Oferece free_shipping para remessas personalizados

Para os países onde o Mercado Envios está ativo, você só pode adicionar envios personalizados gratuitos em categorias que não aceitam ME.

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

Próximo: Places (xd_drop_off).