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 la cantidad que MercadoLibre debe mostrar: tu inventario menos lo ya vendido en MercadoLibre que aún no has facturado. Un reloj indica que el envío está en camino; un aviso rojo con Reintentar, que MercadoLibre lo rechazó (pasa el cursor para ver el motivo). Full significa que el stock lo administra la bodega de MercadoLibre.
Última sincronización	Última vez que Agapanto y MercadoLibre intercambiaron stock, precio o estado.
sync Sincronizar desde ML	Trae de MercadoLibre el estado y el precio de la publicación. El aviso dice qué cambió, por ejemplo Sincronizado (status: active → paused) o sin cambios. Nunca cambia tu inventario.
pause Pausar / play_arrow Activar	Cambian el estado de la publicación en MercadoLibre sin borrarla.
more_vert Más acciones	Finalizar publicación la cierra en MercadoLibre (luego puedes Republicar: MercadoLibre le asigna un número nuevo). Eliminar de MercadoLibre la borra y deja el producto sin vincular; las órdenes y facturas ya registradas se conservan.
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, Pausadas y Finalizadas; Buscar producto filtra por nombre.

Vincular publicaciones que ya tienes en MercadoLibre

Si publicaste productos directamente en MercadoLibre (o con otra herramienta), pulsa Vincular existentes. Verás las publicaciones de tu cuenta; en cada una que no esté vinculada:

1. Pulsa Vincular y elige el producto de Agapanto que le corresponde.
2. Si la publicación tiene variaciones (color, talla…), elige un producto para cada una: en Agapanto cada variación es un producto con su propio inventario. Las que dejes vacías no se sincronizan ni se pueden facturar.
3. Indica qué cantidad es la correcta hoy: la de tu inventario (se publica en MercadoLibre) o la de MercadoLibre (se ajusta tu inventario con un movimiento). Desde ahí manda siempre tu inventario.

El precio que la publicación ya tenía se respeta. Las órdenes de esa publicación que habían llegado sin mapear quedan listas para facturar.

Tu inventario manda: el stock y el precio se publican solos

Cada vez que vendes (en caja, en la tienda o en MercadoLibre) o ajustas inventario, la nueva cantidad viaja a MercadoLibre en unos segundos, y cada 15 minutos Agapanto revisa que coincidan. Una publicación que MercadoLibre pausó por quedarse sin unidades se reactiva al reponer inventario. Lo que cambies a mano en MercadoLibre se corrige con el valor de Agapanto.

Si el Precio base que usaste es uno de los precios de venta del producto, al cambiar ese precio el de MercadoLibre se recalcula con el margen. Un precio base escrito a mano no se actualiza solo.

¿Problemas?

• No veo la pestaña MercadoLibre en el producto. La cuenta no está conectada (Conectar), el módulo no está activo o tu rol no tiene ACCESO_MERCADOLIBRE.
• 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. Publica desde la ficha del producto (Inventario → editar producto → pestaña MercadoLibre) o usa Vincular existentes para las que ya tienes en MercadoLibre.
• La pestaña dice que la publicación tiene variaciones. Su precio y sus datos se editan en MercadoLibre; el inventario de cada variación sí se actualiza desde Agapanto.

Siguiente: Órdenes y facturas.