Recursos Cross
Explora los recursos principales de nuestras APIs
Documentación
Puedes usar esta documentación para las siguientes unidades de negocio:
Última actualización 24/08/2023
Mercado Envíos 1
Publicar un ítem nuevo con ME1
Al momento de realizar el POST, informa el modo de envío y las dimensiones. Para esto, debes incluir los siguientes campos en el body de la publicación:
[...]
"shipping":{
"local_pick_up":false,
"mode": "me1",
"dimensions":"10x10x20,700"
}
[…]Las dimensiones son en centímetros y el peso en gramos.
Activar ME1 para un ítem ya publicado
Para un ítem ya publicado pero como CUSTOM o Entrega a acordar con el vendedor, debes hacer un put informando las dimensiones, peso e el tipo de envío:
Llamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d '{
"shipping":{
"local_pick_up":false,
"mode":"me1",
"dimensions":"$alturax$anchurax$longitud,$peso"
}
}'
https://api.mercadolibre.com/items/$ITEM_IDEjemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d '{
"shipping":{
"local_pick_up":false,
"mode": "me1",
"dimensions":"10x10x20,70"
}
}'
https://api.mercadolibre.com/items/MLA879036495Respuesta:
{
"id": "MLA879036495",
"site_id": "MLA",
"title": "Test No Comprar - Aire Acondicionado 3000 Frigorías",
"subtitle": null,
"seller_id": 645417996,
"category_id": "MLA1644",
"official_store_id": null,
"price": 50000,
"base_price": 50000,
"original_price": null,
"inventory_id": null,
"currency_id": "ARS",
"initial_quantity": 15,
"available_quantity": 12,
"sold_quantity": 3,
"sale_terms": [
{
"id": "WARRANTY_TYPE",
"name": "Tipo de garantía",
"value_id": "2230279",
"value_name": "Garantía de fábrica",
"value_struct": null,
"values": [
{
"id": "2230279",
"name": "Garantía de fábrica",
"struct": null
}
]
},
{
"id": "WARRANTY_TIME",
"name": "Tiempo de garantía",
"value_id": null,
"value_name": "6 meses",
"value_struct": {
"unit": "meses",
"number": 6
},
"values": [
{
"id": null,
"name": "6 meses",
"struct": {
"number": 6,
"unit": "meses"
}
}
]
}
],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_special",
"start_time": "2020-09-16T15:06:56.000Z",
"stop_time": "2040-09-11T04:00:00.000Z",
"end_time": "2040-09-11T04:00:00.000Z",
"expiration_time": "2021-01-11T19:28:44.000Z",
"condition": "new",
"permalink": "http://articulo.mercadolibre.com.ar/MLA-879036495-test-no-comprar-aire-acondicionado-3000-frigorias-_JM",
"pictures": [
{
"id": "790234-MLA43483081743_092020",
"url": "http://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-O.jpg",
"size": "246x120",
"max_size": "246x120",
"quality": ""
}
],
"video_id": null,
"descriptions": [],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"shipping": {
"mode": "me1",
"local_pick_up": false,
"free_shipping": false,
"methods": [],
"dimensions": "10x10x20,700",
"tags": [
"optional_me1_chosen"
],
"logistic_type": "default",
"store_pick_up": false
},
"international_delivery_mode": "none",
"seller_address": {
"id": 1131257838,
"comment": "",
"address_line": "falsa 123",
"zip_code": "6000",
"city": {
"id": "",
"name": "junin"
},
"state": {
"id": "AR-B",
"name": "Buenos Aires"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -34.5885499,
"longitude": -60.94955400000001,
"search_location": {
"neighborhood": {
"id": "",
"name": ""
},
"city": {
"id": "TUxBQ0pVTjE5NjM",
"name": "Junín"
},
"state": {
"id": "TUxBUFpPTmFpbnRl",
"name": "Buenos Aires Interior"
}
}
},
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": -34.5885499,
"longitude": -60.94955400000001
},
"coverage_areas": [],
"attributes": [
{
"id": "ENERGY_EFFICIENCY",
"name": "Eficiencia energética",
"value_id": "98473",
"value_name": "A",
"value_struct": null,
"values": [
{
"id": "98473",
"name": "A",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "AIR_CONDITIONER_TYPE",
"name": "Tipo de aire acondicionado",
"value_id": "290203",
"value_name": "Split",
"value_struct": null,
"values": [
{
"id": "290203",
"name": "Split",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "SEER",
"name": "SEER",
"value_id": "-1",
"value_name": null,
"value_struct": null,
"values": [
{
"id": "-1",
"name": null,
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "COLOR",
"name": "Color",
"value_id": "52055",
"value_name": "Blanco",
"value_struct": null,
"values": [
{
"id": "52055",
"name": "Blanco",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "FRIGORIAS",
"name": "Frigorías",
"value_id": null,
"value_name": "3000 fg",
"value_struct": {
"unit": "fg",
"number": 3000
},
"values": [
{
"id": null,
"name": "3000 fg",
"struct": {
"number": 3000,
"unit": "fg"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "ITEM_CONDITION",
"name": "Condición del ítem",
"value_id": "2230284",
"value_name": "Nuevo",
"value_struct": null,
"values": [
{
"id": "2230284",
"name": "Nuevo",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "COOLING_CAPACITY",
"name": "Capacidad de refrigeración",
"value_id": null,
"value_name": "3520 W",
"value_struct": {
"unit": "W",
"number": 3520
},
"values": [
{
"id": null,
"name": "3520 W",
"struct": {
"number": 3520,
"unit": "W"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "INSTALLATION_PLACEMENTS",
"name": "Lugares de colocación",
"value_id": null,
"value_name": "Pared",
"value_struct": null,
"values": [
{
"id": null,
"name": "Pared",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "HEATING_CAPACITY",
"name": "Capacidad de calefacción",
"value_id": null,
"value_name": "3520 W",
"value_struct": {
"unit": "W",
"number": 3520
},
"values": [
{
"id": null,
"name": "3520 W",
"struct": {
"number": 3520,
"unit": "W"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "SELLER_SKU",
"name": "SKU",
"value_id": null,
"value_name": "116078",
"value_struct": null,
"values": [
{
"id": null,
"name": "116078",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": null,
"value_name": "F3000-T",
"value_struct": null,
"values": [
{
"id": null,
"name": "F3000-T",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "BRAND",
"name": "Marca",
"value_id": "8039499",
"value_name": "Tedge",
"value_struct": null,
"values": [
{
"id": "8039499",
"name": "Tedge",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "GTIN",
"name": "Código universal de producto",
"value_id": null,
"value_name": "1234567890418",
"value_struct": null,
"values": [
{
"id": null,
"name": "1234567890418",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "AIR_CONDITIONING_TYPE",
"name": "Tipo de climatización",
"value_id": "83445",
"value_name": "Frío/Calor",
"value_struct": null,
"values": [
{
"id": "83445",
"name": "Frío/Calor",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
}
],
"warnings": [],
"listing_source": "",
"variations": [],
"thumbnail_id": "790234-MLA43483081743_092020",
"thumbnail": "http://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-I.jpg",
"secure_thumbnail": "https://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-I.jpg",
"status": "active",
"sub_status": [],
"tags": [
"cart_eligible",
"immediate_payment",
"poor_quality_picture",
"test_item"
],
"warranty": "Garantía de fábrica: 6 meses",
"catalog_product_id": null,
"domain_id": "MLA-AIR_CONDITIONERS",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2020-09-16T15:06:56.000Z",
"last_updated": "2020-10-28T16:40:58.491Z",
"health": 0.83,
"catalog_listing": false,
"item_relations": []
}Consultar órdenes con ME1
Para identificar pedidos ME1 consulta el campo "mode" en el recurso /shipments/shipment_id/.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_IDEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/40070866801{
"id": 40070866801,
"mode": "me1",
"created_by": "receiver",
"order_id": 4001889439,
"order_cost": 99.9,
"base_cost": 22.07,
"site_id": "MLB",
"status": "shipped",
[…]
}Identificar el transportista del pedido
Con el anterior recurso también puedes identificar el transportista de la venta. En la respuesta observas:
[…]
{
"shipping_option":{
"id":101757341000001
[…]
}
[…]
}En el ejemplo "17" es el código utilizado en la planilla de costo o enviado por la integración de flete dinámico para identificar la transportista.
Cambiar estados e informar tracking number
Para brindar la mejor experiencia con ME1, te recomendamos desarrollar los cambios de estado y envío de número de seguimiento (tracking number). Esto ayuda a reducir reclamos y contactos por parte del comprador preguntando dónde está el paquete.
Alertas de fraude
Los pedidos ME1 también pueden tener alertas de fraude. Revisa si el pedido tiene el tag fraud_risk_detected ya que en este caso, el pedido no debe ser enviado al comprador. Cuando identificamos una venta sospechosa, alertamos al vendedor por front y API a través del feed de orders. Para más información consulta nuestra documentación de órdenes.
Configurar ME1 para usuarios de prueba
Para comenzar a utilizar el Mercado Envios modo 1 en un usuario productivo, el vendedor debe contactar a su asesor comercial. Para probar el Mercado Envios modo 1 en un usuario de prueba, primero debe ingresar una dirección válida en la cuenta del usuario test y registrar en el panel de configuración como una dirección de ventas. Luego, cargue sus datos de usuario de prueba en el soporte por site:
Siguiente: Estados de órdenes y seguimiento.