Guía de productos en Medusa Admin¶

Esta guía permite que Andrea publique y mantenga el catálogo de Cementos sin editar código. Los nombres de botones y secciones aparecen entre comillas tal como se muestran en la interfaz de Medusa, que por ahora está en inglés.

Antes de comenzar¶

Admin local: http://localhost:9000/app
Admin: https://admin.andreazambrano.co/app
Tienda local: http://localhost:8080/cementos/co
Canal de ventas: Cementos
Ubicación de inventario: Inventario principal
Moneda: pesos colombianos (COP)

Completa las fotos, el precio y el inventario antes de publicarlo. Si un producto publicado necesita más trabajo, abre su menú principal, elige Edit, cambia su estado a Draft y guarda; así deja de estar disponible en la tienda. Los cambios del Admin se guardan en Medusa y una recarga normal de la tienda local los refleja durante esta fase del MVP.

Cómo se relacionan los datos¶

Producto
  └─ variante (por ejemplo: Natural o Terracota)
       ├─ precio en COP
       └─ artículo de inventario (SKU)
            └─ existencia en Inventario principal

Products es el catálogo: nombre, descripción, fotos, opciones y variantes. Inventory contiene las unidades físicas que se pueden contar. Activar Managed inventory en una variante hace que Medusa cree su artículo de inventario; después se asigna la cantidad disponible en una ubicación. Por eso un producto puede aparecer en Products pero no en Inventory, o aparecer sin existencias, si esa relación no se creó o no tiene una ubicación y cantidad.

Crear un producto sencillo¶

En el menú lateral abre Products y selecciona Create.
En Details, completa:
Title: un nombre corto y reconocible, por ejemplo, “Bandeja Órbita”.
Subtitle: opcional; una frase breve para complementar el nombre.
Handle: opcional. Si lo escribes, usa solamente minúsculas, números y guiones, por ejemplo bandeja-orbita. Debe ser único.
Description: materiales, dimensiones aproximadas, acabado, cuidados y cualquier variación artesanal importante.
En Media, sube una o varias fotos. La primera imagen debe mostrar el objeto claramente y sin elementos que confundan al cliente. Marca la mejor como Make thumbnail; luego puedes cambiar el orden arrastrando las imágenes.
Para una pieza con una sola presentación, deja desactivada la opción que indica que el producto tiene variantes. Medusa igualmente crea una variante predeterminada para asignarle precio e inventario.
En Organize:
asigna una colección o categoría cuando corresponda;
deja Discountable activado si el producto podrá entrar en promociones;
agrega el canal de ventas Cementos;
conserva el perfil de envío configurado para productos físicos.
En Variants, completa la fila de la variante:
SKU: un identificador único y estable, por ejemplo CEM-BAN-ORBITA-NAT;
activa Managed inventory;
deja Allow backorder desactivado para no ofrecer unidades agotadas;
escribe el precio en la columna COP. Verifica visualmente que el valor mostrado corresponda a pesos colombianos antes de guardar.
Selecciona Publish cuando toda la información esté completa. Si descubres que falta algo después de crearlo, cambia su estado a Draft desde Edit hasta terminar la revisión.

No actives Has inventory kit para una pieza normal. Esa función es para un producto compuesto por varios artículos de inventario o para un paquete.

Asignar la existencia disponible¶

Después de crear el producto:

Abre el producto y busca la sección Variants.
En el menú de esa sección selecciona Edit stock levels.
Confirma que la variante tenga su SKU y una columna para Inventario principal.
Escribe el número de unidades físicas terminadas y disponibles para vender.
Guarda y abre Inventory para comprobar que el SKU aparezca con esa cantidad.

La existencia disponible no siempre es igual a la existencia física: Medusa resta las reservas de pedidos de la cantidad almacenada. En el flujo actual de consulta por WhatsApp o correo no se crea un pedido ni una reserva; Andrea confirma la disponibilidad manualmente.

También se puede abrir un artículo desde Inventory, usar Manage locations para asociar Inventario principal y editar la cantidad desde la sección Locations.

Crear colores, tamaños u otros acabados¶

Para un producto que se vende en más de una presentación:

Durante la creación activa Yes, this is a product with variants.
Agrega una opción, por ejemplo Color, con valores separados como Natural, Terracota y Carbón. Para dimensiones utiliza otra opción como Tamaño.
Medusa crea las combinaciones. Desmarca cualquier combinación que Andrea no fabrique.
Asigna a cada variante su propio SKU, precio en COP e inventario. Cada color puede tener una cantidad diferente.
Sube primero todas las fotos al Media del producto. Después abre una variante y usa Media > Edit images para asociarle las fotos correctas y elegir su miniatura.

La tienda ya permite elegir variantes y utiliza precio y disponibilidad de la variante seleccionada. Antes de depender de fotografías específicas por color, verifica ese cambio en la página pública; perfeccionar el cambio automático de galería puede tratarse como una mejora visual separada.

Cambiar precio y crear una oferta¶

Para cambiar el precio normal, abre la variante y edita su precio COP. No reutilices el SKU para un objeto físicamente distinto.

Para una oferta temporal usa Price Lists > Create:

Elige tipo Sale y estado Draft mientras la preparas.
Define título, fechas de inicio y final, si aplican.
Selecciona los productos y escribe los precios promocionales de sus variantes en COP.
Revisa los valores y cambia la lista a Active.

Medusa conserva el precio normal y calcula el promocional. La presentación pública de precio anterior tachado y precio de oferta debe comprobarse antes de anunciar una promoción.

Revisar antes de mostrar el producto¶

El producto está Published, no Draft.
Está asignado al canal Cementos.
Cada variante tiene un SKU único y precio en COP.
Managed inventory está activado y Allow backorder está desactivado.
El SKU aparece en Inventory, asociado a Inventario principal.
La cantidad disponible es correcta.
Hay miniatura y las demás fotos están en el orden deseado.
Título, descripción, precio, selector de variante e inventario se ven bien en /cementos/co después de recargar.
Se puede agregar la variante correcta al carrito y quitarla de nuevo.

Solución de problemas¶

Aparece en Products, pero no en Inventory¶

Abre la variante y comprueba Managed inventory. Si estaba desactivado, actívalo y guarda. Luego usa Edit stock levels o abre el artículo en Inventory, agrega Inventario principal con Manage locations y asigna la cantidad. Cada variante administrada debe tener su propio artículo de inventario y SKU.

Aparece en Admin, pero no en la tienda¶

Comprueba, en este orden:

estado Published;
canal de ventas Cementos;
precio en COP;
variante e inventario válidos;
existencia positiva en Inventario principal, salvo que se permita pedido pendiente;
recarga completa de la página de la tienda.

Si sigue sin aparecer, Justin puede ejecutar npm run commerce:verify y revisar los registros del backend. La clave publicable limita el Store API al canal Cementos; un producto fuera de ese canal no se devuelve al navegador.

Error poco claro al editar una variante¶

Confirma que cada variante tenga un valor para cada opción (Color, Tamaño, etc.).
Comprueba que el SKU y el Handle no estén usados por otro registro.
Revisa que el precio esté en la columna COP y no haya quedado una celda incompleta.
Guarda primero el producto y luego edita una variante a la vez.
Recarga el Admin antes de repetir el cambio para descartar un formulario desactualizado.

Si vuelve a ocurrir, toma una captura del mensaje y anota el producto, la variante y la acción exacta. No borres el producto: los registros del backend y la respuesta de la API normalmente contienen el detalle que el diálogo omite.

La tienda dice agotado aunque hay unidades¶

Comprueba que la cantidad esté en Inventario principal, no solamente en el artículo de inventario, y que la variante correcta esté vinculada a ese artículo. El canal Cementos y la ubicación ya están relacionados por la configuración inicial. Revisa también reservas existentes y Allow backorder.

Una imagen no aparece¶

Espera a que finalice la carga antes de guardar. Vuelve a abrir el producto para confirmar que la imagen figure en Media, elige una miniatura y recarga la tienda. Si el archivo figura en Admin pero su enlace falla, Justin debe revisar el servicio de medios Garage y los registros de Medusa; no hace falta volver a crear el producto.

Cambios que conviene evitar¶

No borres productos, variantes o artículos de inventario para corregir un error de texto; edítalos o pásalos a borrador.
Cuando existan pedidos reales, no borres variantes históricas ni reutilices sus SKU para otro objeto.
No actives pedidos pendientes sin que Andrea haya decidido cómo comunicar y fabricar esas unidades.
No publiques una oferta sin verificar sus fechas, precio COP y presentación en la tienda.