Mercado Libre - Actualizar Item

↩ Parte de la integración Mercado Libre.

Descripción

Este modulo permite modificar publicaciones existentes: cambiar precio, stock, estado, imagenes, descripción y mas.

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 con permisos de escritura

Parámetros

Campo	Tipo	Requerido	Descripción
credentials_id	string	Si	ID de las credenciales
item_id	string	Si	ID del item (MLA123456789)
title	string	No	Nuevo título
price	number	No	Nuevo precio
available_quantity	number	No	Nuevo stock
status	string	No	active, paused, closed
description	string	No	Nueva descripción
pictures	array	No	Nuevas URLs de imagenes
seller_custom_field	string	No	Nuevo SKU
shipping_mode	string	No	Nuevo modo de envío
free_shipping	boolean	No	Envío gratis
warranty	string	No	Nueva garantia
attributes	array	No	Nuevos atributos

Estados de Item

Valor	Descripción
active	Activar publicación
paused	Pausar publicación
closed	Finalizar publicación

Salida

{
  "success": true,
  "item": {...},
  "item_id": "MLA123456789",
  "fields_updated": ["price", "available_quantity", "status"],
  "message": "Item MLA123456789 actualizado correctamente"
}

Ejemplo de Uso

Actualizar precio

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

Actualizar stock

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

Pausar publicación

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

Reactivar publicación

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

Actualizar precio y stock

{
  "credentials_id": "meli_cuenta",
  "item_id": "MLA123456789",
  "price": 89999,
  "available_quantity": 50
}

Actualizar descripción

{
  "credentials_id": "meli_cuenta",
  "item_id": "MLA123456789",
  "description": "Nueva descripcion del producto con mas detalles..."
}

Agregar envío gratis

{
  "credentials_id": "meli_cuenta",
  "item_id": "MLA123456789",
  "shipping_mode": "me2",
  "free_shipping": true
}

Finalizar publicación

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

Workflows de Ejemplo

Sincronización de stock desde ERP

[Webhook ERP cambio stock] -> [MeliUpdateItem stock] -> [Log cambio]

Actualización masiva de precios

[Leer CSV precios] -> [Loop] -> [MeliUpdateItem precio] -> [Reporte]

Pausar items sin stock

[Schedule c/hora] -> [MeliGetItems stock=0] -> [MeliUpdateItem paused]

Ofertas programadas

[Schedule fecha] -> [Obtener items oferta] -> [MeliUpdateItem precio] -> [Notificar]

Uso con ExecuteScript

// Sincronizar stock desde sistema externo
const cambio = ctx.data.cambio_stock;

// Calcular nuevo stock
const nuevoStock = Math.max(0, cambio.stock_actual);

// Si stock es 0, pausar
ctx.data = {
  item_id: cambio.meli_item_id,
  available_quantity: nuevoStock,
  status: nuevoStock === 0 ? 'paused' : 'active'
};

// Aplicar descuento masivo
const items = ctx.data.items_a_descontar;
const descuento = 0.15; // 15% descuento

ctx.data = items.map(item => ({
  item_id: item.id,
  price: Math.round(item.price * (1 - descuento))
}));

Campos que NO se pueden modificar

• category_id (categoría)
• condition (condición)
• listing_type_id (tipo de publicación - solo upgrade)
• buying_mode

Errores Comunes

Error	Causa	Solución
”Item not found”	ID incorrecto	Verificar item_id
”Cannot update closed item”	Item finalizado	No se puede reactivar
”Invalid status transition”	Transición no permitida	Ver estados validos
”Price is too low”	Precio bajo mínimo	Respetar precio mínimo de categoría

API Utilizada

• API: Mercado Libre Items API
• Endpoint: PUT /items/{id}
• Documentación: https://developers.mercadolibre.com/

Notas

• La descripción se actualiza en un endpoint separado
• Algunos cambios pueden requerir re-moderación
• Los items finalizados (closed) no se pueden reactivar
• El cambio de precio puede afectar el posicionamiento
• Las imagenes se reemplazan completamente (no se agregan)

Nodos Relacionados

• MeliGetItems - Obtener items para actualizar
• MeliCreateItem - Crear nuevos items
• MeliGetOrders - Consultar ventas de los items