Recursos Cross
Confira os principais recursos das nossas APIs
Documentação
Você pode usar esta documentação para as seguintes unidades de negócio:
Mercado Envios
Modos de envios por país
Cada site possui um conjunto de métodos de envio disponíveis, com diferentes tempos e custos de envio. Além do Mercado Envios 1 e 2, os vendedores podem oferecer Envio Personalizado. Com a seguinte chamada, você pode verificar os modos de envio disponíveis em cada país:
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/shipping_methods
Resposta:
[
{
"id": 502845,
"name": "Retiro en sucursal OCA Prioritario",
"type": "express",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": null,
"company_id": null,
"company_name": null,
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 501045,
"name": "Retiro en OCA",
"type": "standard",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17500240,
"company_name": "OCA",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 501145,
"name": "Estándar",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me1"
],
"company_id": null,
"company_name": null,
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 505545,
"name": "Envío internacional",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me1"
],
"company_id": 17502940,
"company_name": "CBT Argentina",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 505045,
"name": "Retiro en Andreani",
"type": "standard",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17502540,
"company_name": "Andreani",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 504845,
"name": "Seller local",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me1"
],
"company_id": null,
"company_name": null,
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 506245,
"name": "Rápido a domicilio",
"type": "super_express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 0,
"max_time": 24,
"currency_id": "ARS"
},
{
"id": 501146,
"name": "Prioritario",
"type": "express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me1"
],
"company_id": null,
"company_name": null,
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 73330,
"name": "Prioritario a domicilio",
"type": "express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17500240,
"company_name": "OCA",
"min_time": 0,
"max_time": 72,
"currency_id": "ARS"
},
{
"id": 73328,
"name": "Normal a domicilio",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17500240,
"company_name": "OCA",
"min_time": 72,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 504245,
"name": "Normal a domicilio",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17500940,
"company_name": "Reprocesos Carrito",
"min_time": 72,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 510445,
"name": "Prioritario a domicilio",
"type": "next_day",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 24,
"max_time": 24,
"currency_id": "ARS"
},
{
"id": 511545,
"name": "Estándar a domicilio",
"type": "four_days",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 96,
"max_time": 96,
"currency_id": "ARS"
},
{
"id": 510245,
"name": "Devolución Estándar",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17501440,
"company_name": "Correo Argentino",
"min_time": 24,
"max_time": 96,
"currency_id": "ARS"
},
{
"id": 510545,
"name": "Express a domicilio",
"type": "two_days",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 48,
"max_time": 48,
"currency_id": "ARS"
},
{
"id": 510945,
"name": "Estándar a sucursal de correo",
"type": "three_days",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 72,
"max_time": 72,
"currency_id": "ARS"
},
{
"id": 506345,
"name": "Rápido a domicilio",
"type": "super_express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 0,
"max_time": 48,
"currency_id": "ARS"
},
{
"id": 507045,
"name": "Test Flex [NO USAR]",
"type": "super_express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 2160,
"max_time": 2400,
"currency_id": "ARS"
},
{
"id": 506445,
"name": "Rápido a domicilio",
"type": "super_express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 24,
"max_time": 48,
"currency_id": "ARS"
},
{
"id": 513146,
"name": "Proximity Express",
"type": "proximity_express",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 0,
"max_time": 99,
"currency_id": "ARS"
},
{
"id": 503045,
"name": "Retiro en Correo Argentino",
"type": "standard",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17501440,
"company_name": "Correo Argentino",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 512747,
"name": "Prioritario a domicilio",
"type": "same_day",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 1,
"max_time": 1,
"currency_id": "ARS"
},
{
"id": 511546,
"name": "Estándar a sucursal de correo",
"type": "four_days",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 96,
"max_time": 96,
"currency_id": "ARS"
},
{
"id": 510845,
"name": "Express a sucursal de correo",
"type": "two_days",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 48,
"max_time": 48,
"currency_id": "ARS"
},
{
"id": 510645,
"name": "Estándar a domicilio",
"type": "three_days",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 72,
"max_time": 72,
"currency_id": "ARS"
},
{
"id": 510745,
"name": "Prioritario a sucursal de correo",
"type": "next_day",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": null,
"company_name": null,
"min_time": 24,
"max_time": 24,
"currency_id": "ARS"
},
{
"id": 504945,
"name": "Normal a domicilio",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me2"
],
"company_id": 17502540,
"company_name": "Andreani",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 505645,
"name": "Envío internacional",
"type": "standard",
"deliver_to": "address",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": [
"me1"
],
"company_id": 17502940,
"company_name": "CBT Argentina",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
},
{
"id": 504345,
"name": "Retiro en una sucursal",
"type": "standard",
"deliver_to": "agency",
"status": "active",
"site_id": "MLA",
"free_options": null,
"shipping_modes": null,
"company_id": 17500940,
"company_name": "Reprocesos Carrito",
"min_time": null,
"max_time": null,
"currency_id": "ARS"
}
]
Campos de resposta:
id: ID do método de envio é usado ao postar um item com envio.
name: nome do método de envio.
site_id: ID do site ao qual o método de envio pertence.
free_options: opções grátis.
shipping_modes: modos de envio.
- me1: Mercado Envios 1 oferece uma calculadora de envios para obter o custo de envio de cada pedido e o vendedor seleciona o serviço de envio de sua preferência escolhendo uma transportadora. Além disso, estará encarregado de gerenciar o número de rastreamento (tracking number).
- me2: Mercado Envios 2 é o modo mais recomendado, porque oferece uma melhor experiência para vendedores e compradores. O Mercado Livre gera uma etiqueta que o vendedor deve imprimir e um código de rastreamento com uma operadora local pré-definida, ou seja, o vendedor não precisa se preocupar em escolher uma transportadora ou gerenciar o número de rastreamento.
- custom (personalizado): os vendedores podem incluir uma tabela com até 10 custos de envio em um item e o comprador deve fornecer esse número ao concluir e finalizar [checkout] de compra.
- not_specified (não especificado):
- Significa que o vendedor não especificou nenhum preço de frete para seus produtos e o comprador deve entrar em contato com o vendedor para combinar uma opção de envio e o preço.
- Se você não enviar as informações de envio do item, ele será marcado como "not_specified" por padrão. Além disso, se não houver modos que suportem as dimensões do seu item, você deve publicar sob este modo.
- Se a categoria não suportar as dimensões do seu produto, você terá apenas "not_specified" na resposta.
- Por último, se a categoria possuir ME2, as dimensões enviadas serão ignoradas, uma vez que são consideradas as dimensões estabelecidas na categoria.
Modos habilitados segundo a categoria da publicação
Além disso, existem algumas restrições em certas categorias, por isso recomendamos que você consulte os modos habilitados de acordo com a categoria dos produtos.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/categories/$CATEGORY_ID/attributes
Execute um POST incluindo os atributos da publicação.
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' 'x-multichannel: true' 'X-Format-New: true' -H "Content-Type: application/json" -d
{
"buying_mode": "buy_it_now",
"category_id": "MLB437616",
"channels": [
{
"id": "marketplace"
}
],
"condition": "new",
"dimensions": null,
"is_internal": true,
"is_new_listing": false,
"item_currency": "ARS",
"item_id": null,
"item_price": 3500,
"listing_type_id": "gold_special",
"new_format": true,
"sale_terms": [],
"seller_id": 419059118,
"site_id": "MLB",
"source": "",
"title": "Titulo de teste",
"local_pick_up": false,
"to_catalog_internal": false,
"to_modes_internal": false,
"traced": false,
"verbose": false
}
https://api.mercadolibre.com/users/$USER_ID/shipping_modes
Resposta:
{
"channels": {
"marketplace": {
"available_modes": [
{
"mode": "me1",
"logistic_types": [
{
"type": "default",
"default": true,
"attributes": {
"dimensions": "optional",
"costs": "not_allowed",
"adoption": "not_required",
"free_shipping": "optional",
"local_pick_up": "optional",
"tags": []
}
}
],
"shipping_attributes": {
"dimensions": "optional",
"costs": "not_allowed",
"adoption": "not_required",
"free_shipping": "optional",
"local_pick_up": "optional",
"tags": []
}
},
{
"mode": "me2",
"logistic_types": [
{
"type": "cross_docking",
"default": true,
"attributes": {
"dimensions": "clear",
"costs": "not_allowed",
"adoption": "not_required",
"free_shipping": "mandatory",
"local_pick_up": "optional",
"tags": []
}
}
],
"shipping_attributes": {
"dimensions": "clear",
"costs": "not_allowed",
"adoption": "not_required",
"free_shipping": "mandatory",
"local_pick_up": "optional",
"tags": []
}
}
],
"warnings": null,
"channel_id": "marketplace"
}
}
}
Preferências de envio de um usuário
Saiba as preferências de envio de qualquer usuário.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/shipping_preferences
Resposta:
{
"local_pick_up":false,
"modes":[
"custom",
"not_specified",
"me1",
"me2"
],
"trusted_user":true,
"custom_calculator":false,
"picking_type":"cross_docking",
"thermal_printer":null,
"option":"in",
"tags":[
],
"carrier_pickup":false,
"items_combination":"enabled",
"services":[
311,
591,
671,
801,
881,
1181,
1191,
136261
],
"logistics":[
{
"mode":"me1",
"types":[
{
"type":"default",
"carrier_pickup":[
],
"services":[
21,
23,
22,
11
],
"default":true
}
]
},
{
"mode":"me2",
"types":[
{
"type":"cross_docking",
"carrier_pickup":[
17501840
],
"services":[
311,
591,
671,
801,
881,
1181,
1191
],
"default":false
},
{
"type":"self_service",
"carrier_pickup":[
],
"services":[
136261
],
"default":false
}
]
},
{
"mode":"custom",
"types":[
{
"type":"custom",
"carrier_pickup":[
],
"services":null,
"default":true
}
]
},
{
"mode":"not_specified",
"types":[
{
"type":"not_specified",
"carrier_pickup":[
],
"services":null,
"default":true
}
]
}
],
"content_declaration_disabled":false,
"conciliation":{
"type":null
},
"mandatory_invoice_data":false,
"site_id":"MLA",
"free_configurations":[
{
"condition":{
"value":null,
"type":"all"
},
"rule":{
"default":true,
"free_mode":"country",
"value":null
}
}
],
"mandatory_settings":{
}
}
Status de envio
Para determinados modos de envio, no Mercado Livre rastreamos e monitoramos automaticamente os números de rastreamento. Os status são internos e alterados pelo Mercado Libre.
Podem ser:
pending: os envios são criados com este status.
handling: o pagamento do frete já foi recebido.
ready_to_ship: o código de autorização da transportadora foi recebido.
shipped: a transportadora já informou sobre o despacho do item.
delivered: a transportadora já informou sobre a chegada do item.
not_delivered: a transportadora não conseguiu fazer a entrega do pacote.
cancelled: envio foi cancelado.
Para Envio personalizado e outras configurações do Mercado Envios 1, você será responsável pelo envio de um número de rastreamento e pela atualização do status do envio.
Para casos sem Mercado Envios (ou Envios Not_Specified) não existe o shipping_id, então você deve ter o feedback da venda para fechá-la.
Conheça mais sobre Mercado Envios.
Siguiente: Mercado Envios 1.