Mercado Libre - Obtener Items

↩ Parte de la integración Mercado Libre.

Descripción

Este modulo permite consultar items de tu cuenta de Mercado Libre, ya sea un item especifico por ID o una lista con filtros por estado y busqueda.

Configuración

Credenciales

Este modulo requiere credenciales de tipo Mercado Libre (OAuth) con los siguientes campos:

Campo	Descripción
access_token	Token de acceso OAuth valido

Parámetros

Campo	Tipo	Requerido	Descripción
credentials_id	string	Si	ID de las credenciales
item_id	string	No	ID de item especifico (MLA123456789)
seller_id	string	No	ID del vendedor (usa credenciales si no se especifica)
status	string	No	Estado del item
search	string	No	Busqueda por título
limit	number	No	Items por página (max 50)
offset	number	No	Desplazamiento para paginación

Estados de Item (status)

Valor	Descripción
active	Publicación activa
paused	Publicación pausada
closed	Publicación finalizada
under_review	En revision por MeLi

Salida

{
  "success": true,
  "items": [
    {
      "id": "MLA123456789",
      "title": "iPhone 15 Pro Max 256GB",
      "price": 1500000,
      "currency_id": "ARS",
      "available_quantity": 10,
      "sold_quantity": 25,
      "status": "active",
      "permalink": "https://articulo.mercadolibre.com.ar/...",
      "pictures": [...],
      "attributes": [...]
    }
  ],
  "total": 150,
  "offset": 0,
  "limit": 50,
  "message": "50 items obtenidos"
}

Ejemplo de Uso

Obtener item por ID

{
  "credentials_id": "meli_cuenta",
  "item_id": "MLA123456789"
}

Listar items activos

{
  "credentials_id": "meli_cuenta",
  "status": "active",
  "limit": 50
}

Buscar items por título

{
  "credentials_id": "meli_cuenta",
  "search": "iPhone",
  "status": "active"
}

Listar items pausados

{
  "credentials_id": "meli_cuenta",
  "status": "paused"
}

Paginación de items

{
  "credentials_id": "meli_cuenta",
  "limit": 50,
  "offset": 100
}

Campos del Item

Campo	Descripción
id	ID único del item (MLA…)
title	Título de la publicación
price	Precio actual
currency_id	Moneda (ARS, MXN, BRL, etc.)
available_quantity	Stock disponible
sold_quantity	Unidades vendidas
status	Estado de la publicación
condition	Condición (new, used)
listing_type_id	Tipo de publicación
permalink	URL de la publicación
pictures	Array de imagenes
attributes	Atributos del producto
shipping	Configuración de envío

Workflows de Ejemplo

Sincronización de stock

[Schedule c/30min] -> [MeliGetItems active] -> [Loop] -> [Actualizar ERP]

Monitoreo de publicaciones

[Schedule diario] -> [MeliGetItems] -> [Verificar precios] -> [Alerta Slack]

Exportación de catalogo

[Trigger manual] -> [MeliGetItems] -> [Paginacion] -> [Generar Excel]

Uso con ExecuteScript

// Analizar items por estado
const items = ctx.data.items;

const stats = {
  total: items.length,
  activos: items.filter(i => i.status === 'active').length,
  pausados: items.filter(i => i.status === 'paused').length,
  sin_stock: items.filter(i => i.available_quantity === 0).length,
  valor_inventario: items.reduce((sum, i) =>
    sum + (i.price * i.available_quantity), 0)
};

ctx.data = stats;

API Utilizada

• API: Mercado Libre API
• Endpoint: GET /users/{user_id}/items/search, GET /items/{id}
• Documentación: https://developers.mercadolibre.com/

Notas

• El limite máximo por petición es 50 items
• Los items se obtienen en lotes de 20 para incluir detalles completos
• El seller_id se toma de las credenciales si no se especifica
• La busqueda (search) filtra por título del item

Nodos Relacionados

• MeliCreateItem - Crear nuevos items
• MeliUpdateItem - Actualizar items existentes
• MeliGetOrders - Consultar ventas de los items