Recursos Cross

Confira os principais recursos das nossas APIs
circulos azuis em degrade

Documentação do

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

Última atualização em 11/01/2024

Frete Grátis

Importante:
Atualmente a funcionalidade está disponível para os países MLB, MLA, MLM, MLC, MCO, MPE, MLU e MEC.

A funcionalidade de Frete Grátis é uma ferramente poderosa para melhorar as vendas em linha. Com esta característica, é possível oferecer produtos a compradores sem custo de envio e receber subsídios como vendedor conforme o preço do produto. Isto não só atrai apenas mais compradores, como também oferece informação detalhada sobre cada produto.

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:

País Marketplace
Brasil Custos de venda
Argentina Custos de venda
México Custos de venda
Chile Custos de venda
Colômbia Custos de venda
Peru Custos de venda
Uruguai Custos de venda
Equador Custos de venda
Notas:
  • E alguns casos, o Mercado Livre solicita aos vendedores que ofereçam Frete Grátis para alguns anúncios. Quanto o MELI impõe esta condição, a plataforma subsidia uma parte dos custos de envio.
  • Certifique-se de que compreende os requisitos e as políticas do MELI relacionadas com o Frete Grátis para poder implementar esta funcionalidade de maneira efetiva em sua plataforma de venda.
  • Caso não tenha o "mandatory_free_shipping", o requisito é obrigatório. Quando a API lança esse parâmetro, é fundamental aproveitá-lo para garantir o bom funcionamento de nossos aplicativos.

Consultar custos de envios

Este endpoint permite conhecer o preço que o vendedor vai pagar pelo envio de um determinado 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:

Nome Tipo Descrição Exemplo
item_id string ID do item. MLB23332
dimensions string Dimensões do item (altura x espessura x largura, peso). 60x364x63,661
item_price number Preço unitário do item. 123
verbose bool O verbose determina se o desconto para o envio está incluso ou não na resposta. TRUE
condition string Condição do item pode ser usado ou novo. new
currency_id string Tipo de moeda oferecido para o item. ARS
category_id string Categoria do item. MLB23332
listing_type_id string Nível de publicação del item, determina nível de exposição e determinados benefícios. gold_special
variation_id Number Variação do item. 123213
seller_status string Nível das lojas Líderes (Platinum, Gold, Silver). gold
seller_type string Indica se é uma loja oficial ou não. normal
reputation string Indica a reputação do vendedor (Red, Orange, Yellow, Light_green, green). green
mmode string Método de envio (me2, me1, custom y not specified). me2
logistic_type string Tipo de logística (Flex, Drop Shipping, Cross Docking o Fulfillment). flex
tags string Etiquetas de informação geral do item. Permite determinar se o item tem Flex como logística. self_service
state_id string ID do estado de origem do envio. BRL
city_id string Cidade de origem do envio. TUxDQ1BVRWRiYjBh
zipe_code number O CEP de origem do envio. 35519000
Nota:
Dentro de todos los parâmetros de consulta para utilizar este endpoint, é importante destacar que os obrigatórios são ITEM_ID ou DIMENSIONS. Isto significa que ao usar este recurso, é essencial proporcionar ao menos um destes parâmetros na solicitação para que a API possa processar corretamente

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:

Código Mensagem Descrição Recomendação
200 - OK - Obtido corretamente na consulta. -
400 - Bad Request seller_id must have a value! O usuário não existe. Validar o valor do seller_id.
404 - Not Found Item with id {itemID} not found Item não encontrado. Validar o valor do item_id.
Nota:
  • É importante destacar que o array 'discount' estará presente apenas na resposta se for oferecido algum desconto. Caso contrário, é possível que este array não apareça na resposta.
  • Este endpoint tem um propósito específico e está desenhado para operar unicamente com anúncios disponíveis no Marketplace de nossa plataforma.

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 proporcionar a você informações importantes relacionadas com as regras de negócio que são aplicáveis, assim como as somas ou limites estabelecidos para oferecer Frete Grátis.


País Mshops
Brasil Custos por oferecer Frete Grátis.
Argentina Custos por oferecer Frete Grátis.
México Custos por oferecer Frete Grátis.
Chile Custos por oferecer Frete Grátis.
Colômbia Custos por oferecer Frete Grátis.
Peru -
Uruguai -
Equador -

Próxima: Places (xd_drop_off).