Recursos Cross
Confira os principais recursos das nossas APIsDocumentação do
Você pode usar esta documentação para as seguintes unidades de negócio:
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:
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 |
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:
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 |
mode | string | Método de envio: CrossDocking = “cross_docking” DropShipping = “drop_off” Fulfillment = “fulfillment” XdDropOff = “xd_drop_off” Flex = “self_service” |
self_service |
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 |
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. |
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.
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).