Recursos Cross

Confira os principais recursos das nossas APIs
circulos azuis em degrade

Documentação

Você pode usar esta documentação para as seguintes unidades de negócio:

Última atualização em 22/06/2023

Frete grátis

Frete grátis ou free shipping em seus produtos garante uma experiência de compra superior para o comprador, é destaque nos resultados da pesquisa e os compradores podem filtrar publicações que oferecem frete grátis.

Consultar os produtos com frete grátis

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

O Campo free_shipping, boolean, indica se o item consultado possui frete grátis ou não.

{
   "shipping":{
  	"mode":"me2",
  	"local_pick_up":true,
  	"free_shipping":true,
  	"free_methods":[
     	},
  	],
  	"dimensions":null
   }
}

Oferece o modo free_shipping para todo o país

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

Exemplo:

{
	"title": "Titulo del item",
[...]
	"shipping": {
		"mode": "me2",
		"local_pick_up": false,
		"free_shipping": true,
	}
}

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

Oferecer free shipping para item com ME1

Para ME1 existem duas formas de oferecer frete grátis:

1. Diretamente via API
2. Regra de frete


Diretamente via API

Esta ação é realizada mudando a TAG “free_shipping” conforme exemplo abaixo:


Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'  -H "Content-Type: application/json" -H "Accept: application/json" -d '{


{
   "shipping": {
     "mode": "me1",
     "methods": [],
     "dimensions": "$alturax$anchurax$longitud,$peso",
     "local_pick_up": false,
     "free_shipping": true,
   }
 }
https://api.mercadolibre.com/items/$ITEM_ID

Resposta:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'  -H "Content-Type: application/json" -H "Accept: application/json" -d '{


{
   "shipping": {
     "mode": "me1",
     "methods": [],
     "dimensions": "10x10x10,1000",
     "local_pick_up": false,
     "free_shipping": true,
   }
 }
https://api.mercadolibre.com/items/MLB2731928768
Nota:
Recordando que, a configuração do envio gratuito realizada por API possui prioridade e sobrepõe as tabelas de frete do seller. Ou seja, ao consultar determinado código postal para uma publicação que possui Free Shipping aplicado, se a tabela do seller possui valor de frete para esse CEP (seja a tabela de contingência ou o Frete dinâmico) será aplicado o envio gratuito prioritariamente.

Adicionar regras de frete grátis

O frete grátis implementado por meio de regra de frete se pode estipular as regiões (Cidade, Estado ou faixa de CEP), por anúncio ou por valor de Nota Fiscal, data de início e fim da campanha, ou seja, o seller possui maior flexibilidade na configuração do frete grátis. Para adicionar esse tipo de regras, é necessário que o seller contate o assessor comercial.


Nota:
Para os casos em que o seller possui frete dinâmico ativado, a regra de frete grátis deve ser implementada dos dois lados (Integradora e contingência). Pois a regra implementada do nosso lado irá refletir somente em caso de contingência.

Próximo: Places (xd_drop_off).