Frete grátis
Conteúdos
→Formas de envio →Dimensões e tipos de envios ↳Calcular custos para frete grátis por usuário e dimensões do produto ↳Calcular custos para frete grátis por usuário e item_id ↳Calcular custos para frete grátis por produto →Calcular custos de frete grátis antes de publicar um item →Produtos com frete grátis →Oferecer a forma free_shipping para todo o país →Oferecer free shipping para envios personalizados →Remover envio grátis da publicação
Formas de envio
curl -X GET 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:
{
"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
}]
}
}
Dimensões e tipos de envios
Você pode conhecer, por meio de uma chamada GET, as dimensões padrão da categoria de envios (peso, altura, largura e profundidade) e os tipos de logística disponíveis nessa categoria. Quando as dimensões do produto não são especificadas, você deve executar o cálculo com base nas dimensões padrão.
Chamada:
curl -X GET https://api.mercadolibre.com/categories/$CATEGORY_ID/shipping_preferences
Exemplo:
curl -X GET https://api.mercadolibre.com/categories/MLM165702/shipping_preferences
Resposta:
{
"dimensions": {
"height": 10,
"width": 10,
"length": 15,
"weight": 500
},
"logistics": [
{
"types": [
"default"
],
"mode": "me1"
},
{
"types": [
"drop_off",
"xd_drop_off",
"self_service",
"cross_docking",
"fulfillment"
],
"mode": "me2"
},
{
"types": [
"not_specified"
],
"mode": "not_specified"
},
{
"types": [
"custom"
],
"mode": "custom"
}
],
"restricted": false,
"source": {
"origin": "categories",
"identifier": "MLM165702"
},
"date_created": null,
"last_modified": null,
"category_id": "MLM165702"
}
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 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"
}
}
}
}
Calcular custos de frete grátis antes de publicar um item
Utilize esse recurso para calcular os custos de frete grátis antes da publicação. Para isso, é necessario informar alguns parâmetros:
currency_id: moeda. listing_type_id: tipo da publicação. condition: estado do produto. category_id: ID da categoria que vai publicar. item_price: preço do producto. dimensions: dimensões do produto (altura x largura x profundidade, peso). Caso não os possua, verifique as informações da categoria no recurso /shipping_preferences.
Chamada:
curl -X GET https://api.mercadolibre.com/users/$USER_ID/shipping_options/free?currency_id=$CURRENCY_ID&listing_type_id=$LISTING_TYPE_ID&condition=$CONDITION&category_id=$CATEGORY_ID&item_price=$ITEM_PRICE&verbose=true&dimensions=$DIMENSIONS
Exemplo:
curl -X GET https://api.mercadolibre.com/users/378277780/shipping_options/free?currency_id=BRL&listing_type_id=gold_pro&condition=new&category_id=MLB26426&item_price=80&verbose=true&dimensions=15x30x5,150
Resposta:
{
"coverage": {
"all_country": {
"list_cost": 30.9,
"currency_id": "BRL",
"billable_weight": 150,
"discount": {
"rate": 0,
"type": "none",
"promoted_amount": 0
}
}
}
}
Produtos com frete grátis
No produto, você verá que os “métodos” de propriedade foram substituídos por “free_methods” quando “free_shipping” for verdadeiro.
Para MLB, automaticamente podemos excluir algumas áreas das regiões Norte, Nordeste e outras áreas de risco quando selecionada a opção de "free_mode": "country".
Oferecer a forma 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
}
}]
}
}
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": []
}
Remover envio grátis da publicação
Para remover envio grátis da sua publicação, deverá alterar o valor de "free_shipping" para "false", e enviar o array de "free_methods" vazio, eliminando a configuração de envio que esta aplicada ao item.
Exemplo com ME2:
"shipping": {
"mode": "me2",
"local_pick_up": false,
"free_shipping": false,
"methods": []
}