Mercado Libre - Crear Item

↩ Parte de la integración Mercado Libre.

Descripción

Este modulo permite publicar productos en Mercado Libre con todas las opciones de configuración: precio, stock, imagenes, atributos y envío.

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
title	string	Si	Título del producto (max 60 chars)
category_id	string	Si	ID de categoría (MLA1234)
price	number	Si	Precio del producto
currency_id	string	No	Moneda (default: ARS)
available_quantity	number	No	Stock disponible (default: 1)
condition	string	No	new, used, not_specified
listing_type_id	string	No	Tipo de publicación
description	string	No	Descripción del producto
pictures	array	No	URLs de imagenes
seller_custom_field	string	No	SKU o código interno
shipping_mode	string	No	Modo de envío
free_shipping	boolean	No	Envío gratis
warranty	string	No	Texto de garantia
attributes	array	No	Atributos del producto

Tipos de Publicación (listing_type_id)

Valor	Descripción	Comision
gold_special	Clasica	Media
gold_pro	Premium	Alta
free	Gratuita	Sin comision

Monedas Soportadas

Código	Pais
ARS	Argentina
MXN	Mexico
BRL	Brasil
CLP	Chile
COP	Colombia
USD	Dolar

Salida

{
  "success": true,
  "item": {...},
  "item_id": "MLA123456789",
  "permalink": "https://articulo.mercadolibre.com.ar/...",
  "message": "Item \"iPhone 15 Pro\" creado correctamente con ID MLA123456789"
}

Ejemplo de Uso

Producto básico

{
  "credentials_id": "meli_cuenta",
  "title": "iPhone 15 Pro Max 256GB Negro",
  "category_id": "MLA1055",
  "price": 1500000,
  "available_quantity": 5
}

Producto con imagenes

{
  "credentials_id": "meli_cuenta",
  "title": "Zapatillas Nike Air Max 90",
  "category_id": "MLA1574",
  "price": 89999,
  "condition": "new",
  "pictures": [
    "https://example.com/imagen1.jpg",
    "https://example.com/imagen2.jpg"
  ]
}

Producto con atributos

{
  "credentials_id": "meli_cuenta",
  "title": "Samsung Galaxy S24 Ultra 512GB",
  "category_id": "MLA1055",
  "price": 2500000,
  "attributes": [
    {"id": "BRAND", "value_name": "Samsung"},
    {"id": "MODEL", "value_name": "Galaxy S24 Ultra"},
    {"id": "INTERNAL_MEMORY", "value_name": "512 GB"}
  ]
}

Producto con envío gratis

{
  "credentials_id": "meli_cuenta",
  "title": "Smart TV 55 4K UHD",
  "category_id": "MLA1002",
  "price": 450000,
  "shipping_mode": "me2",
  "free_shipping": true
}

Producto con SKU y garantia

{
  "credentials_id": "meli_cuenta",
  "title": "Notebook Lenovo ThinkPad",
  "category_id": "MLA1652",
  "price": 850000,
  "seller_custom_field": "LNV-TP-001",
  "warranty": "12 meses de garantia oficial"
}

Producto usado

{
  "credentials_id": "meli_cuenta",
  "title": "PlayStation 5 Digital Edition",
  "category_id": "MLA1144",
  "price": 650000,
  "condition": "used",
  "description": "Consola en excelente estado, poco uso. Incluye control original."
}

Workflows de Ejemplo

Publicación desde ERP

[Webhook ERP] -> [Preparar datos] -> [MeliCreateItem] -> [Guardar ID en DB]

Publicación masiva

[Leer CSV] -> [Loop] -> [MeliCreateItem] -> [Log resultados]

Sincronización de catalogo

[Schedule] -> [Obtener productos nuevos] -> [MeliCreateItem] -> [Notificar]

Uso con ExecuteScript

// Preparar producto desde sistema externo
const producto = ctx.data.producto_erp;

ctx.data = {
  title: producto.nombre.substring(0, 60), // Max 60 chars
  category_id: producto.categoria_meli,
  price: producto.precio * 1.15, // Margen 15%
  available_quantity: producto.stock,
  condition: producto.es_nuevo ? 'new' : 'used',
  seller_custom_field: producto.sku,
  pictures: producto.imagenes,
  attributes: [
    { id: 'BRAND', value_name: producto.marca },
    { id: 'MODEL', value_name: producto.modelo }
  ],
  shipping_mode: 'me2',
  free_shipping: producto.precio > 50000
};

Errores Comunes

Error	Causa	Solución
”category_id is required”	Falta categoría	Especificar category_id valido
”Invalid category_id”	Categoría incorrecta	Usar predictor de categorías
”title exceeds max length”	Título muy largo	Máximo 60 caracteres
”Invalid picture URL”	URL invalida	Verificar URLs de imagenes

API Utilizada

• API: Mercado Libre API
• Endpoint: POST /items
• Documentación: https://developers.mercadolibre.com/

Notas

• El título tiene un máximo de 60 caracteres
• Las imagenes deben ser URLs publicas accesibles
• La categoría debe ser una hoja (sin subcategorias)
• Los atributos varian según la categoría
• Mercado Envíos (me2) requiere dimensiones en algunos casos

Nodos Relacionados

• MeliGetItems - Obtener items publicados
• MeliUpdateItem - Actualizar items existentes
• MeliGetOrders - Consultar ventas de los items