Table of Contents
📌 ¿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
- Tener una credencial válida de Mercado Libre asociada a tu cuenta de vendedor.
- Contar con los datos mínimos del producto: título, categoría, precio, stock, etc.
- Para mensajes, es necesario conocer el user ID del comprador y el pack ID o ID de la orden.
- Las imágenes deben estar en formato accesible por URL pública o como archivo local si es compatible.