Frete grátis

Consultar produtos com frete grátis

Este endpoint permite consultar quais produtos são oferecidos com frete grátis.

Chamada:

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

Exemplo:

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

Resposta com free shipping optional:

"shipping": {
	"mode": "me2",
	"methods": [],
	"tags": [
		"self_service_in"
	],
	"dimensions": null,
	"local_pick_up": false,
	"free_shipping": true,
	"logistic_type": "cross_docking",
	"store_pick_up": false
}

Resposta com free shipping mandatory:

"shipping": {
	"mode": "me2",
	"methods": [],
	"tags": [
		"mandatory_free_shipping"
	],
	"dimensions": null,
	"local_pick_up": true,
	"free_shipping": true,
	"logistic_type": "xd_drop_off",
	"store_pick_up": false
}

Resposta com free shipping fora de me2:

"shipping": {
	"mode": "not_specified",
	"methods": [],
	"tags": [],
	"dimensions": null,
	"local_pick_up": true,
	"free_shipping": true,
	"logistic_type": "not_specified",
	"store_pick_up": false
}

"shipping": {
	"mode": "me1",
	"methods": [],
	"tags": [
		"optional_me1_chosen"
	],
	"dimensions": "56x190x140,59250",
	"local_pick_up": false,
	"free_shipping": true,
	"logistic_type": "default",
	"store_pick_up": false
}

Parâmetros de resposta:

• shipping.mode: modalidade de envio configurado para o item.
• shipping.tags: etiquetas de envio do item.

• Se indica "mandatory_free_shipping" é porque o item superou o limite estabelecido pelo Mercado Livre. Para estes produtos, o envio gratuito é uma obrigação. Os vendedores devem oferecer frete grátis ou descontos importantes no envio.
• Por outro lado, para produtos com preço abaixo deste limite, o frete grátis é opcional.

• shipping.dimensions: dimensões do produto no formato: altura x espessura x largura, peso.
• shipping.local_pick_up: indicador booleano que mostra se a opção de retirar pessoalmente está disponível.
• shipping.free_shipping: indicador booleano que mostra se o frete é grátis.
• shipping.logistic_type: tipo de logística do envio.
• shipping.store_pick_up: indicador booleano que mostra se a opção de coletar na loja está disponível.

Para ter uma visão mais detalhada sobre os preços para frete grátis, consulte as seguintes páginas:

Consultar custos de envios

Este endpoint permite conhecer o preço que o vendedor vai pagar pelo envio de um determinado item.
Pode ser usado também para simular custos de envios no momento de anunciar ou editar um item.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/users/$USER_ID/shipping_options/free?dimensions=$DIMENSIONES&verbose=$VERBOSE&item_price=$ITEM_PRICE&listing_type_id=$LISTING_TYPE&mode=$MODE&condition=$CONDITION&logistic_type=$LOGISTIC_TYPE

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/users/244878077/shipping_options/free?dimensions=9x17x22,462&verbose=true&item_price=300&listing_type_id=gold_pro&mode=me2&condition=new&logistic_type=drop_off

Parâmetros de consulta aceitáveis:

Resposta:

"{
    "coverage": {
        "all_country": {
            "list_cost": 2369.99,
            "currency_id": "ARS",
            "billable_weight": 462,
            "discount": {
                "rate": 0,
                "type": "none",
                "promoted_amount": 0
            }
        }
    }
}"

Parâmetros de resposta:

• coverage: representa a cobertura de envio, e contém informação sobre os custo e a moeda utilizada para o envio.
• coverage.all_country: dentro de "coverage", "all_country" especifica que a informação é aplicável para envitos em todo o país.
• coverage.all_country.list_cost: custo de envio oferecido pelo vendedor.
• coverage.all_country.currency_id: moeda utilizada para o custo de envio.
• coverage.all_country.billable_weight: peso faturável do envio.
• coverage.discount: informação sobre descontos aplicados ao envio.
• coverage.discount.rate: taxa de desconto aplicada.
• coverage.discount.type: descreve o tipo de desconto.
• coverage.discount.promoted_amount: soma ou valor base sobre o qual será aplicado uma certa porcentagem de desconto. Por exemplo, se temos um custo de envio de R$ 200 e o desconto é de 40%, na resposta final obteremos: list_cost = 120, rate: 0.4 e promoted_amount = 200.

Códigos de estado de resposta:

Em relação a Mshops, é importante destacar que atualmente não contamos com uma API específica para consultar os custos de envio. No entanto, queremos oferecer informações valiosas relacionadas com as regras de negócio que são aplicáveis, assim como as somas ou limites estabelecidos para oferecer frete grátis.

Próxima: Places (xd_drop_off).