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": []
    }