Mercado Libre - Actualizar Item

Descripcion

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

Configuracion

Credenciales

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

Campo	Descripcion
access_token	Token de acceso OAuth con permisos de escritura

Parametros

Campo	Tipo	Requerido	Descripcion
credentials_id	string	Si	ID de las credenciales
item_id	string	Si	ID del item (MLA123456789)
title	string	No	Nuevo titulo
price	number	No	Nuevo precio
available_quantity	number	No	Nuevo stock
status	string	No	active, paused, closed
description	string	No	Nueva descripcion
pictures	array	No	Nuevas URLs de imagenes
seller_custom_field	string	No	Nuevo SKU
shipping_mode	string	No	Nuevo modo de envio
free_shipping	boolean	No	Envio gratis
warranty	string	No	Nueva garantia
attributes	array	No	Nuevos atributos

Estados de Item

Valor	Descripcion
active	Activar publicacion
paused	Pausar publicacion
closed	Finalizar publicacion

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 publicacion

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

Reactivar publicacion

{
  "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 descripcion

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

Agregar envio gratis

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

Finalizar publicacion

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

Workflows de Ejemplo

Sincronizacion de stock desde ERP

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

Actualizacion 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 (categoria)
• condition (condicion)
• listing_type_id (tipo de publicacion - solo upgrade)
• buying_mode

Errores Comunes

Error	Causa	Solucion
”Item not found”	ID incorrecto	Verificar item_id
”Cannot update closed item”	Item finalizado	No se puede reactivar
”Invalid status transition”	Transicion no permitida	Ver estados validos
”Price is too low”	Precio bajo minimo	Respetar precio minimo de categoria

API Utilizada

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

Notas

• La descripcion se actualiza en un endpoint separado
• Algunos cambios pueden requerir re-moderacion
• 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