Mercado Libre - Obtener Items

Descripcion

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.

Configuracion

Credenciales

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

Campo	Descripcion
access_token	Token de acceso OAuth valido

Parametros

Campo	Tipo	Requerido	Descripcion
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 titulo
limit	number	No	Items por pagina (max 50)
offset	number	No	Desplazamiento para paginacion

Estados de Item (status)

Valor	Descripcion
active	Publicacion activa
paused	Publicacion pausada
closed	Publicacion 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 titulo

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

Listar items pausados

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

Paginacion de items

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

Campos del Item

Campo	Descripcion
id	ID unico del item (MLA…)
title	Titulo de la publicacion
price	Precio actual
currency_id	Moneda (ARS, MXN, BRL, etc.)
available_quantity	Stock disponible
sold_quantity	Unidades vendidas
status	Estado de la publicacion
condition	Condicion (new, used)
listing_type_id	Tipo de publicacion
permalink	URL de la publicacion
pictures	Array de imagenes
attributes	Atributos del producto
shipping	Configuracion de envio

Workflows de Ejemplo

Sincronizacion de stock

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

Monitoreo de publicaciones

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

Exportacion 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}
• Documentacion: https://developers.mercadolibre.com/

Notas

• El limite maximo por peticion 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 titulo del item

Nodos Relacionados

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