Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Última actualización 17/06/2026
Importar catálogo
Nota:
Al insertar los IDs de las tiendas que recibirán el catálogo, se deben insertar los externals_ids. El ID externo de una tienda se puede configurar a través del endpoint Modificar ID externo de la sucursal.
Importante:
Debido a que el proceso de carga del catálogo es asíncrono, se debe usar el endpoint Consultar estado de publicación para verificar si el catálogo se importó correctamente. Si hay un error en la validación de esta publicación, recomendamos implementar un mecanismo de reintentos.
Alguna solicitud no fue enviada correctamente y contiene un error.
Parámetros de Request
Header
Parámetro
Tipo
Descripción
Authorization (obligatorio)
string
Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Body
Parámetro
Tipo
Descripción
store_ids
array
Array que recibe los external_ids de las tiendas que deben recibir el catálogo.
sections
array
Array de objetos que contienen información sobre las secciones que deben importarse al catálogo.
name (string): Nombre de la sección.
description (string): Descripción de la sección.
items (array): Array de ítems de la sección.
name (string): Nombre del ítem.
description (string): Descripción del ítem.
external_id (string): ID externo del ítem (SKU).
image (string): URL de la imagen del ítem.
price (number): Precio del ítem. Debe ser mayor a 200.
discount_price (number): Precio con descuento del ítem.
status (string): Estado del ítem (active o paused).
options (array): Array de opciones/complementos.
name (string): Nombre del grupo de opciones.
group_min (number): Cantidad mínima de complementos que el cliente debe seleccionar del grupo.
group_max (number): Cantidad máxima de complementos que el cliente puede seleccionar del grupo.
complements (array): Array de complementos individuales.
name (string): Nombre del complemento.
description (string): Descripción del complemento.
external_id (string): ID externo del complemento.
image (string): URL de la imagen del complemento.
min (number): Cantidad mínima de este complemento específico. Debe ser 0 (ver nota abajo).
max (number): Cantidad máxima de este complemento específico. Debe ser menor o igual a group_max.
price (number): Precio del complemento.
status (string): Estado del complemento (active o paused).
Importante - Configuración de complementos:
La suma de los valores min de todos los complementos individuales nunca debe exceder el valor de group_max.
Regla de configuración:
Cuando el grupo es obligatorio (group_min > 0), significa que el cliente debe elegir al menos una opción del grupo.
En este caso, cada complemento individual debe configurarse con min: 0 para indicar que la obligatoriedad recae en el grupo, no en cada ítem individual.
El valor max de cada complemento debe ser menor o igual a group_max.
Ejemplo correcto:
Un grupo con group_min: 1 y group_max: 3 indica que el cliente debe elegir entre 1 y 3 complementos del grupo. Cada complemento dentro de ese grupo debe tener min: 0, delegando la obligatoriedad al grupo. El sistema interpreta que "elegir algo es obligatorio" porque group_min: 1, pero cuál complemento elegir es decisión del cliente.
Parámetros de Response
Parámetro
Tipo
Descripción
msg
string
Descripción del resultado de la operación.
results
array
Array de resultados de publicación por tienda.
store_id (string): ID externo de la tienda.
catalog_id (string): ID del catálogo generado para verificar el estado del proceso.
status (string): Estado del proceso (processing).
Errores
Código de Error
Descripción
400
Error de publicación causado por alguna inconsistencia en los campos.
