Saturn Studio – Mercado Libre

📌 ¿Qué es este módulo?

Mercado Libre es la mayor plataforma de comercio electrónico en América Latina, que ofrece un ecosistema completo para compras, ventas, pagos y envíos. Este módulo permite esperar notificaciones, crear productos, obtener órdenes y enviar mensajes a compradores desde Saturn Studio.

📚 Descripción de los comandos

🔔 Wait for Notification

Esperar una notificación desde la plataforma de Mercado Libre.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Mercado Libre necesaria para recibir eventos.	credential
Tipo de notificación	Tipo de notificación: All, Order, Payment, Item, Stock.	All
Asignar variable	Variable donde se almacenará el resultado.	{var}

🛒 Create a New Product

Crear un producto nuevo en Mercado Libre.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Mercado Libre necesaria para publicar un producto.	credential
Título	Título del producto.	Test item – Do not bid
Categoría	Categoría del producto.	Vehicle Accessories
Tipo de publicación	Tipo de publicación: Classic, Premium, etc.	Classic
Condición	Estado del producto: New, Used.	New
Precio	Precio del producto.	350
Moneda	Tipo de moneda.	Argentine Peso
Stock	Cantidad de unidades disponibles.	10
Modo de compra	Modalidad de compra: Buy it now, Auction, Classified.	Buy it now
Tipo de garantía	Tipo de garantía ofrecida.	Seller warranty
Tiempo de garantía	Tiempo de garantía (en días, meses, etc).	days
Garantía	Duración de la garantía.	90
Imagen (URL)	Enlace a la imagen del producto.	http://mla-s2-p.mlstatic.com/968521-MLA20805195516.jpg
Marca	Marca del producto.	Audi
Modelo	Modelo del producto.	A4
Asignar variable	Variable donde se almacenará el resultado. Ejemplo: {“product”:{“id”:”MLA2005509964″}}	{var}

📦 Get an Order

Obtener información de una orden por su ID.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Mercado Libre necesaria para obtener órdenes.	credential
ID de la orden	Número de la orden que deseas consultar.	2000010619381092
Asignar variable	Variable donde se almacenará el resultado. Ejemplo: {“order”:{“id”:2000010619381092}}	{var}

💬 Create a Message

Enviar un mensaje a un comprador basado en una orden.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Mercado Libre necesaria para enviar mensajes.	credential
Mensaje	Contenido del mensaje.	Test item – Do not bid
ID del usuario	ID del comprador.	2321500017
ID del pack	Pack ID o ID de la orden.	2000010619381092
Ruta del archivo	Ruta local del archivo o imagen a enviar.	image.jpg
Asignar variable	Variable donde se almacenará el resultado. Ejemplo: {“message_sent”:true}	{var}

🧪 Ejemplo de uso

• Wait for Notification
  Configurar escucha para recibir eventos en tiempo real sobre ventas, pagos o cambios de stock.
• Create a New Product
  Publicar automáticamente productos en Mercado Libre con detalles como precio, imagen, marca, modelo y garantías.
• Get an Order
  Consultar detalles de una orden usando su identificador único.
• Create a Message
  Enviar mensajes personalizados al comprador, con posibilidad de adjuntar archivos o imágenes.

🧩 Requisitos

1. Tener una credencial válida de Mercado Libre asociada a tu cuenta de vendedor.
2. Contar con los datos mínimos del producto: título, categoría, precio, stock, etc.
3. Para mensajes, es necesario conocer el user ID del comprador y el pack ID o ID de la orden.
4. Las imágenes deben estar en formato accesible por URL pública o como archivo local si es compatible.