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 12/07/2024
Mercado Envíos 1
Configurar un usuario de test
Para configurar la modalidad de envío ME1 para usuarios de prueba, sigue estos pasos:
- Iniciar sesión en la página de Developers de Mercado Libre.
- Seleccionar la categoría a consultar, en este caso: “Configuraciones de test”.
- Desplegar la sección de “Configuración” y elija “Activar ME1 a cuenta test”.
- Completar la información requerida sobre el usuario de prueba.
- Enviar solicitud de activación de ME1 para su cuenta de usuario de prueba.
| País | Enlace |
|---|---|
| Argentina | Solicitud para activar ME1 a cuenta test |
| Brasil | Solicitud para activar ME1 a cuenta test |
| México | Solicitud para activar ME1 a cuenta test |
| Chile | Solicitud para activar ME1 a cuenta test |
| Colombia | Solicitud para activar ME1 a cuenta test |
| Uruguay | Solicitud para activar ME1 a cuenta test |
| Perú | Solicitud para activar ME1 a cuenta test |
Activar ME1 a un vendedor
El proceso de activación de ME1 implica la colaboración del asesor comercial o Key Account Manager (KAM) de la cuenta del vendedor. El vendedor debe seguir estos pasos:
- Inicialmente, el vendedor debe completar la "Tabla de Contingencia", la cual incluye la definición de los costos de envío para ME1 y las áreas geográficas a las que planea enviar estos pedidos.
- Una vez que la tabla esté completa, el vendedor debe solicitar a su asesor la activación de ME1, incluyendo los detalles del integrador de flete dinámico si se dispone de uno.
- El asesor gestiona la solicitud de activación ante el equipo interno, teniendo en cuenta que este proceso puede llevar aproximadamente 7 días hábiles desde la solicitud.
- Después de este período, el vendedor puede solicitar el estado de su solicitud para confirmar que la modalidad ME1 está activa y lista para su uso.
Para mayor detalle, revisar la sección consultar la sección Contingencia Mercado Libre.
Publicar un ítem con ME1
Este endpoint permite publicar un ítem con ME1.
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_IDEjemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items
[...]
{
"shipping": {
"mode": "me1",
"local_pick_up": true,
"dimensions": "189x72x96,58000"
}
}
[...]
Respuesta:
{
"id": "MLA1644124644",
"site_id": "MLA",
"title": "Refrigeradora Samsung Side By Side 602lt Rs60t5200s9",
"subtitle": null,
"seller_id": 1459527474,
"category_id": "MLA9458",
"official_store_id": null,
"price": 567803,
"base_price": 567803,
"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": "189x72x96,58000",
"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": []
}Activar ME1 en un ítem
Este endpoint permite activar ME1 para los ítems que estén configurados en la modalidad de envíos “Custom” o “Acordar con el vendedor”:
Llamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_IDEjemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA1644124644
{
"shipping": {
"mode": "me1",
"local_pick_up": true,
"dimensions": "189x72x96,58000"
}
}Códigos de estado de respuesta:
La siguiente tabla proporciona una mayor visibilidad sobre posibles problemas en la configuración de envío ME1. Asegúrate de revisar regularmente las recomendaciones para mantener un flujo de procesos optimizado y brindar una mejor experiencia a tus clientes.
| Parámetro | Descripción | Recomendación |
|---|---|---|
| 4052 | Esta sugerencia se activará cuando un envío ME1 esté disponible, pero se pierde debido a problemas de dimensiones. Te permitirá identificar rápidamente los casos en los que ME1 no puede ser utilizado debido a restricciones de tamaño o peso. | Validar que al menos una de las dimensiones ingresadas supere el umbral de ME1. Mayor a 500 cm o 500 kg. |
| 4053 | Si un vendedor no tiene habilitada la opción de envío ME1 en sus preferencias de envío, esta sugerencia se activará. De esta manera, podrás verificar fácilmente si ME1 está disponible para el vendedor en cuestión. | Validar las modalidades de envío activas para el vendedor. En caso de no mostrarse ME1, contactar al Key Account Manager (KAM) asignado a la cuenta. |
| 4054 | Esta sugerencia te alertará cuando un producto no tenga habilitada la opción de envío ME1 en las preferencias del catálogo. Con esta información, podrás identificar rápidamente los productos que no son elegibles para ME1. | Validar las modalidades de envíos que tiene el ítem, el dominio o la categoría. |
Consultar envíos con ME1
Este endpoint permite consultar los envíos con ME1 del vendedor.
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/12345678Respuesta:
{
[…]
"receiver_id": 0987654332,
"base_cost": 0,
"status_history": {
"date_shipped": "2024-02-02T16:31:31.184-04:00",
"date_returned": null,
"date_delivered": "2024-02-05T08:38:14.000-04:00",
"date_first_visit": "2024-02-05T08:38:14.000-04:00",
"date_not_delivered": null,
"date_cancelled": null,
"date_handling": null,
"date_ready_to_ship": null
},
"type": "forward",
"return_details": null,
"sender_id": 474415116,
"mode": "me1",
"order_cost": 1699999,
"priority_class": {
"id": null
},
"service_id": 154,
"shipping_items": [
{
"domain_id": null,
"quantity": 1,
"dimensions_source": {
"origin": "seller",
"id": "MLA1388902895__1"
},
"description": "Heladera Samsung Freezer Inf Multi Flow 400l Dispenser Inver",
"id": "MLA1388902895",
"user_product_id": null,
"sender_id": 11111111,
"dimensions": "180.0x76.0x77.0,84000.0"
}
],
"tracking_number": "0999-111111111",
"cost_components": {
"loyal_discount": 0,
"special_discount": 0,
"compensation": 0,
"gap_discount": 0,
"ratio": 0
},
[…]
"customer_id": null,
"order_id": 2000007511222222,
"quotation": null,
"status": "delivered",
"logistic_type": "default"
}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.
Siguiente: Estados de órdenes y seguimiento.