DocumentaciónPanel AdministrativoGuía del Panel Administrativo de Medusa 2.0

🛒 Guía del Panel de Administración de Medusa

El panel administrativo de Medusa es el centro neurálgico donde administras productos, pedidos, cupones de descuento, clientes y tarifas de transporte.


1. Acceso al Panel Administrativo

Utiliza las siguientes credenciales para acceder al panel en tu entorno local:

  • URL en Desarrollo Local: http://localhost:7001
  • Usuario por Defecto: admin@medusa-test.com (o el correo definido en tu archivo .env)
  • Contraseña por Defecto: supersecret

2. Gestión de Productos, Categorías y Colecciones

🛍️ Creación de Nuevos Productos y Variantes

  1. En el menú lateral izquierdo, haz clic en Products.
  2. Haz clic en el botón Create Product en la esquina superior derecha.
  3. Introduce Title (Título), Description (Descripción), Handle (Slug URL) y las imágenes principales.
  4. Definir Opciones (Options): Si el artículo tiene variaciones de color o talla, crea opciones como Color o Size.
    🎨 Cómo se muestran los círculos de colores en el frontend:
    Modo normal (nombre en inglés): Si el nombre del color está en inglés estándar (como Red, Blue, Black), el frontend lo utiliza directamente para mostrar el círculo de color.
    Modo exacto (código hexadecimal / títulos locales y no ingleses): Para mayor precisión o al usar títulos localizados en cualquier idioma (español, persa, francés, etc.), debes definir la clave color_code con un código hexadecimal (ej. #FF5733) en la sección Metadata.
Consejo sobre la visualización de muestras de color (Color Swatches)
El sistema frontend funciona de la siguiente manera para mostrar las muestras de color:
  • Si el nombre del color se introduce en inglés estándar (como Red o Green), el frontend lo utiliza automáticamente.
  • Para mostrar códigos de color más precisos (hexadecimales como #2A9D8F) o al utilizar títulos traducidos en otros idiomas, se recomienda rellenar el campo color_code en Metadata.

📁 Asignar Categorías (Categories)

Las categorías determinan cómo se agrupan los productos en el menú principal del sitio y en las páginas de la tienda.

  1. En la pantalla de edición del producto, baja hasta la sección Organize.
  2. Selecciona la categoría adecuada en el selector Categories.

🏷️ Colecciones y Campañas de Venta

Las colecciones se usan para agrupar productos fuera de la estructura de categorías principal (como Rebajas de Otoño o Colección Especial de Primavera).

  1. Haz clic en Collections en el menú izquierdo y pulsa el botón New Collection.
  2. Introduce el título de la campaña y añade los productos deseados.
  3. Puedes usar esta colección en secciones dinámicas de Strapi (como Section Showcase).

3. Gestión y Envío de Pedidos

📦 Seguimiento y Cambio de Estado de Pedidos

Cuando un cliente finaliza una compra, la orden aparece inmediatamente listada en Orders.

  • Pending: Pedido creado y pago verificado satisfactoriamente.
  • Processing: Pedido en fase de empaquetado y preparación en almacén.
  • Fulfilled: Paquete recogido y entregado a la empresa de mensajería.
  • Completed: Pedido entregado al cliente con éxito.

🚚 Introducir Código de Rastreo (Tracking Number)

  1. Accede al detalle del pedido en cuestión.
  2. En la sección Fulfillment, haz clic en Create Fulfillment.
  3. Introduce el Tracking Number y la empresa logística asignada.
  4. El cliente recibe de forma inmediata un correo electrónico con el enlace directo para rastrear su paquete.

🧾 Generación de Facturas y Recibos

Haz clic en Export Invoice para descargar la factura oficial en formato PDF e incluirla con el envío.


4. Regiones y Métodos de Envío

🌐 Configuración de Regiones (Regions)

Medusa organiza las monedas y reglas impositivas de cada país mediante el concepto de Regions.

  1. Accede a Settings > Regions.
  2. Selecciona una región existente o crea una nueva para tu mercado objetivo.
  3. Configura la moneda base e introduce las tasas impositivas correspondientes.

📮 Definir Opciones de Envío

Crea métodos como 'Envío Express 24h', 'Envío Estándar Gratuito' o 'Recogida en Tienda':

  • Envío Exprés: Entrega rápida nacional con tarifa fija o basada en peso.
  • Envío Estándar: Entrega económica para compras habituales.
  • Mensajería Urbana: Entrega en el mismo día para envíos dentro de la ciudad.

5. Cupones de Descuento y Promociones

🎟️ Cupones de Descuento Porcentuales y de Importe Fijo

  1. Navega a Discounts en el menú lateral y haz clic en Add Discount.
  2. Define el código promocional (ej: PRIMAVERA20 o BIENVENIDA).
  3. Selecciona la modalidad de descuento:
    • Percentage: Descuento porcentual (ej: 20%).
    • Fixed Amount: Importe fijo de descuento (ej: 15 €).
  4. Establece el importe mínimo del carrito o productos aplicables.

🎁 Creación de Promoción de Envío Gratuito

Al seleccionar el tipo Free Shipping (Envío Gratuito) al crear una promoción, el costo de envío se reduce automáticamente a cero para los pedidos que cumplan las condiciones.

Condiciones que puedes definir:

  • Región (Region): Envío gratuito activo solo para una región o país específico.
  • Grupo de Clientes (Customer Group): Envío gratuito exclusivo para grupos como clientes VIP o mayoristas.
  • Canal de Venta (Sales Channel): Envío gratuito aplicado únicamente a través de un canal de ventas determinado.

6. Gestión de Clientes y Segmentación

👥 Grupos de Clientes (Customer Groups)

En la sección Customers puedes examinar la lista completa de usuarios registrados, direcciones guardadas e historial de compras.

  1. Crea un nuevo grupo en la pestaña Customer Groups (ej: Clientes VIP o Compradores B2B).
  2. Asigna usuarios específicos a dicho grupo.
  3. Configura listas de precios exclusivas y descuentos dedicados para los miembros del grupo.

7. Recursos y Documentación Oficial de Medusa

Para configuraciones avanzadas y personalización técnica del motor de comercio, consulta los recursos oficiales de MedusaJS: