Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Gestión de capacidad de envíos
La gestión de capacidad de envíos es una herramienta que permite a los vendedores configurar la cantidad máxima de envíos que pueden despachar en un día sin sufrir demoras. Esto les brinda la flexibilidad de organizarse y evitar retrasos, ya sea frente a cambios planificados en su volumen de ventas o situaciones inesperadas.
Conoce más sobre:
- Qué es mi capacidad de envíos y para qué me sirve.
- Qué pasa cuando supero mi capacidad.
- Hasta cuándo puedo modificarla.
- Cómo la modifico si tengo más de una colecta en el día.
- Qué es mi capacidad mínima.
- Cómo finalizar colectas con mi código.
Asimismo, conoce como funciona Mercado Envíos Colecta (cross_docking) y qué es Mercado Envíos 2.
Obtener capacidad actual
Este endpoint permite obtener la configuración actual de la capacidad de envío de un usuario:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/capacity_middleend/$LOGISTIC_TYPE
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/419059119/capacity_middleend/cross_docking
Respuesta:
{
"capacities":[
{
"day": "monday",
"capacity_min":20,
"capacity_max": 140,
"capacity": {
"value": 120,
"maximum": false
},
"next_capacity": {
"value": 110,
"maximum": false
},
"can_add_capacity": false,
"can_subtract_capacity": true,
"intervention" : "delay",
},
{
"day": "tuesday",
"capacity_min":20,
"capacity_max": 140,
"capacity": {
"value": 120,
"maximum": false
},
"next_capacity": null,
"can_add_capacity": true,
"can_subtract_capacity": false,
"intervention" : "delay",
},
{
"day": "wednesday",
"capacity_min":20,
"capacity_max": 140,
"capacity": {
"value": 140,
"maximum": false
},
"next_capacity": null,
"can_add_capacity": true,
"can_subtract_capacity": false,
"intervention" : "delay",
},
{
"day": "thursday",
"capacity_min":20,
"capacity_max": 140,
"capacity": {
"value": 120,
"maximum": false
},
"next_capacity": null,
"can_add_capacity": true,
"can_subtract_capacity": false,
"intervention" : "delay",
},
{
"day": "friday",
"capacity_min":20,
"capacity_max": 140,
"capacity": {
"value": 110,
"maximum": false
},
"next_capacity": null,
"can_add_capacity": true,
"can_subtract_capacity": false,
"intervention" : "delay",
},
{
"day": "saturday",
"capacity_min":20,
"capacity_max": 140,
"capacity": {
"value": 120,
"maximum": true
},
"next_capacity": null,
"can_add_capacity": true,
"can_subtract_capacity": false,
"intervention" : "delay",
},
]
}
Parámetros de respuesta:
- day: Representa el día de la semana al que se refiere la capacidad. Los valores posibles son monday, tuesday, wednesday, thursday, friday, y saturday.
- capacity_min: Es el valor mínimo de capacidad permitido para ese día.
- capacity_max: Es el valor máximo de capacidad permitido para ese día.
- capacity.value: Es el valor de la capacidad actual para el día y semana en la que se encuentra el usuario.
- capacity.maximum: Indica si el usuario tiene seleccionado la capacidad infinita(false) / máxima(true). En caso de no tener next_capacity se devuelve un null para este campo.
- next_capacity.value: Es el valor de la capacidad configurada aplicable para la siguiente semana.
- next_capacity.maximum: Indica si el usuario tiene seleccionado la capacidad infinita(false) / máxima(true) para la siguiente semana.
- can_add_capacity: Indica si es posible agregar capacidad adicional para ese día. Los posibles valores son true o false.
- can_subtract_capacity: Indica si es posible restar capacidad para ese día. Los posibles valores son true o false.
- intervention: Describe el tipo de intervención en el que pueda incurrir el usuario:
- delay: intervención por demoras.
- null: no tiene intervención.
Códigos de estado de respuesta
Código | Mensaje | Descripción | Recomendación |
---|---|---|---|
200 - OK | - | Se obtuvo correctamente la configuración actual. | - |
404 - Not Found | not valid logistic type | No existe el usuario o no tiene la logística de cross_docking. | Validar el user_id y los tipos de logística del usuario. |
Actualizar capacidad de envíos
Este endpoint permite actualizar o modificar la configuración actual de capacidad de envío del usuario.
Llamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/capacity_middleend/$LOGISTIC_TYPE
Ejemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/419059119/capacity_middleend/cross_docking
{
"capacities": [
{
"day": "monday",
"capacity": {
"value": 120,
"maximum": false
},
},
{
"day": "tuesday",
"capacity": {
"value": 120,
"maximum": false
},
},
{
"day": "wednesday",
"capacity": {
"value": 120,
"maximum": false
},
},
{
"day": "tuesday",
"capacity": {
"value": 120,
"maximum": false
},
},
{
"day": "friday",
"capacity": {
"value": 120,
"maximum": true
},
},
{
"day": "saturday",
"capacity": {
"value": 120,
"maximum": false
},
},
]
}'
Códigos de estado de respuesta
Código | Mensaje | Descripción | Recomendación |
---|---|---|---|
200 - OK | - | Se obtuvo correctamente la configuración actual. | - |
400 - Bad Request | there was an error parsing the request body | Error en los parámetros del request body. | Validar el request body. |
404 - Not Found | not valid logistic type | No existe el usuario o no tiene la logística de cross_docking. | Validar el user_id y los tipos de logística del usuario. |