Publicar productos

Publicas un producto de tu inventario en MercadoLibre desde su propia ficha y luego administras todas las publicaciones (sincronizar, pausar, activar) en una tabla. La publicación se hace en Menú → Inventario → editar producto → pestaña MercadoLibre; la tabla está en Menú → MercadoLibre → pestaña Publicaciones (ruta /app/mercadolibre?tab=publicaciones).

Permiso

ACCESO_MERCADOLIBRE para el módulo. Para abrir la ficha del producto necesitas además los permisos de Inventario → Productos. La pestaña MercadoLibre del producto solo aparece cuando ya guardaste las credenciales en Conectar.

Publicar desde la ficha del producto

Menú → Inventario → Croissant → pestaña MercadoLibre

DatosPreciosstorefrontMercadoLibre

check_circle Publicado en MercadoLibre como MCO1234567890 (estado: active)open_in_new Ver publicación 1

Categoría ML (predicción automática)Croissants (Panadería y Repostería) 2

Precio base$ 4.000

Margen %18

TipoClásica (gold_special)

Elegir la categoría correcta evita que ML recategorice la publicación · Cubre comisión ML

Precio final en ML: $4.720 3

verified Publicación válida — lista para publicar. 4

rule Validarstorefront Actualizar publicaciónpause Pausar 5

Pestaña MercadoLibre del Croissant: ya está publicado, así que el botón dice Actualizar publicación y aparece Pausar.

1. 1 Franja verde solo cuando el producto ya está publicado: muestra el ID de MercadoLibre, el estado y el enlace Ver publicación.
2. 2 Categoría ML (predicción automática): MercadoLibre sugiere categorías a partir del nombre del producto; elige la correcta. Precio base es tu precio de venta; Margen % (18 por defecto) cubre la comisión de MercadoLibre; Tipo es el tipo de publicación: Clásica (gold_special), Premium (gold_pro), Gratuita (free) o Silver.
3. 3 Precio final en ML: precio base + margen. Es lo que verá el comprador.
4. 4 Resultado de la validación: verde si MercadoLibre aceptó la publicación; rojo con la lista MercadoLibre reportó problemas: si falta algo.
5. 5 Validar (necesita categoría y precio base) → Publicar o Actualizar publicación (solo tras validar) → Pausar / Activar (solo si ya existe en MercadoLibre).

1. Abre el producto en Inventario → Productos y entra a la pestaña MercadoLibre. Antes revisa que tenga descripción, fotos y stock: la publicación se arma con esos datos.
2. Elige la Categoría ML, escribe el Precio base, ajusta el Margen % y el Tipo. Mira el Precio final en ML.
3. Pulsa Validar. MercadoLibre revisa la publicación sin crearla; si todo está bien verás Publicación válida.
4. Pulsa Publicar. Al terminar aparece Producto publicado en MercadoLibre (MCO…) y la franja verde con el enlace Ver publicación.

Qué se envía a MercadoLibre

Título (nombre del producto, máximo 60 caracteres), descripción (si está vacía se envía Producto en excelente estado), fotos del producto, condición, stock actual y los atributos del producto. Si no tienes atributo BRAND, se usa el nombre de tu empresa como marca. El envío se ofrece gratis solo cuando el precio final supera los $80.500.

Cambiar precio o margen exige validar de nuevo

Cada vez que cambias categoría, precio base, margen o tipo, el botón Publicar / Actualizar publicación vuelve a exigir Validar. Si MercadoLibre devuelve errores, corrígelos en la ficha del producto (fotos, descripción, atributos) y valida otra vez.

La tabla de publicaciones

Menú → MercadoLibre → Publicaciones

sellPublicaciones

EstadoActivas

Buscar productocroi… search

Producto	ID ML	Estado	Precio ML	Stock	Última sincronización
Croissant	MCO1234567890	active	4.720	25	2/9/2026, 8:15	sync pause edit open_in_new
Pan de bono	MCO1234567891	paused	2.950	0	1/9/2026, 17:40	sync play_arrow edit open_in_new
Café americano	—	Borrador	0	40	—	edit

Tres productos: uno activo, uno pausado por falta de stock y un borrador que aún no se ha validado.

Columna / acción	Significado
Estado	active o paused para publicaciones que existen en MercadoLibre. Si aún no existen: Validada (pasó Validar) o Borrador.
Precio ML / Stock	Precio final publicado y cantidad actual del producto en tu inventario.
Última sincronización	Última vez que Agapanto y MercadoLibre intercambiaron stock, precio o estado.
sync Sincronizar desde ML	Trae de MercadoLibre el stock, el precio y el estado, y los escribe en el producto local. El aviso dice qué cambió, por ejemplo Sincronizado (stock: 25 → 23) o sin cambios.
pause Pausar / play_arrow Activar	Cambian el estado de la publicación en MercadoLibre sin borrarla.
edit Editar producto	Abre la ficha del producto, donde está la pestaña MercadoLibre.
open_in_new Ver en MercadoLibre	Abre la publicación en el sitio de MercadoLibre.

El filtro Estado ofrece Publicadas, Sin publicar, Activas y Pausadas; Buscar producto filtra por nombre.

El stock y el precio se sincronizan solos

Cuando vendes o ajustas inventario en Agapanto, el nuevo stock viaja a MercadoLibre en segundo plano (solo para productos publicados). Si cambias el precio de venta que usaste como Precio base, el precio en MercadoLibre se recalcula con el margen. Y si el cambio ocurre en MercadoLibre, la notificación actualiza el producto local. Usa Sincronizar desde ML cuando sospeches que quedaron desfasados.

¿Problemas?

• No veo la pestaña MercadoLibre en el producto. Todavía no hay App ID guardado en Conectar. No hace falta estar autorizado para ver la pestaña, pero sí para validar y publicar.
• La pestaña dice "No se pudo inicializar MercadoLibre para este producto". La cuenta no está conectada o el token venció: Verifique que la conexión con ML esté activa. Reconecta y vuelve a abrir el producto.
• Validar muestra "MercadoLibre reportó problemas". Lee cada línea: suelen ser fotos faltantes, categoría que exige atributos (p. ej. marca o modelo) o precio fuera del rango de la categoría. Corrige en la ficha del producto y valida de nuevo.
• La tabla de publicaciones está vacía. Verás el aviso Publique productos desde el formulario de producto (Inventario → editar producto → pestaña MercadoLibre). Las publicaciones nacen en la ficha del producto, no aquí.

Siguiente: Órdenes y facturas.