Mercado Libre - Update Item

Description

This module allows modifying existing listings: change price, stock, status, images, description, and more.

Configuration

Credentials

This module requires Mercado Libre (OAuth) credentials with the following fields:

Field	Description
access_token	OAuth access token with write permissions

Parameters

Field	Type	Required	Description
credentials_id	string	Yes	Credentials ID
item_id	string	Yes	Item ID (MLA123456789)
title	string	No	New title
price	number	No	New price
available_quantity	number	No	New stock
status	string	No	active, paused, closed
description	string	No	New description
pictures	array	No	New image URLs
seller_custom_field	string	No	New SKU
shipping_mode	string	No	New shipping mode
free_shipping	boolean	No	Free shipping
warranty	string	No	New warranty
attributes	array	No	New attributes

Item Statuses

Value	Description
active	Activate listing
paused	Pause listing
closed	End listing

Output

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

Usage Example

Update price

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

Update stock

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

Pause listing

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

Reactivate listing

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

Update price and stock

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

Update description

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

Add free shipping

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

End listing

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

Example Workflows

Stock sync from ERP

[ERP stock change webhook] -> [MeliUpdateItem stock] -> [Log change]

Bulk price update

[Read price CSV] -> [Loop] -> [MeliUpdateItem price] -> [Report]

Pause out-of-stock items

[Schedule every hour] -> [MeliGetItems stock=0] -> [MeliUpdateItem paused]

Scheduled offers

[Schedule date] -> [Get offer items] -> [MeliUpdateItem price] -> [Notify]

Usage with ExecuteScript

// Sync stock from external system
const cambio = ctx.data.cambio_stock;

// Calculate new stock
const nuevoStock = Math.max(0, cambio.stock_actual);

// If stock is 0, pause
ctx.data = {
  item_id: cambio.meli_item_id,
  available_quantity: nuevoStock,
  status: nuevoStock === 0 ? 'paused' : 'active'
};

// Apply bulk discount
const items = ctx.data.items_a_descontar;
const descuento = 0.15; // 15% discount

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

Fields that CANNOT be modified

• category_id (category)
• condition (condition)
• listing_type_id (listing type - upgrade only)
• buying_mode

Common Errors

Error	Cause	Solution
”Item not found”	Incorrect ID	Verify item_id
”Cannot update closed item”	Ended item	Cannot be reactivated
”Invalid status transition”	Transition not allowed	See valid statuses
”Price is too low”	Price below minimum	Respect category minimum price

API Used

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

Notes

• The description is updated on a separate endpoint
• Some changes may require re-moderation
• Ended (closed) items cannot be reactivated
• Price changes may affect ranking
• Images are completely replaced (not appended)

Related Nodes

• MeliGetItems - Get items to update
• MeliCreateItem - Create new items
• MeliGetOrders - Query item sales