Productos / Servicios

El módulo Productos (Inventario) es el catálogo central de MGPanel: cada producto o servicio que creas aquí puede usarse en Facturas, Presupuestos y en la Tienda online sin volver a cargarlo.

1. ¿Qué es el módulo de Productos?

Desde el menú lateral → CRM → Productos administras el inventario completo. Cada producto guarda su información, precio(s), imágenes, categorías y visibilidad, y queda disponible para:

• Agregarlo como línea de una factura o presupuesto con un clic (trae SKU, precio y descripción).
• Mostrarlo en la Tienda online con los shortcodes {{tienda=...}} — ver Tienda online.
• Consultarlo o crearlo por API desde sistemas externos.

2. Crear un producto

En la vista de producto completa:

1. Título y slug (URL): el slug se usa en la ficha pública del producto dentro de la tienda.
2. Descripción corta (aparece en listados) e información ampliada (contenido largo para la ficha del producto).
3. Imágenes: sube una o varias; marca una como portada para que sea la que se use en cards, buscador y facturas.
4. Categorías y SKU: usa las categorías para filtrar en {{tienda=categoria}} y el buscador; el SKU también es buscable.
5. Estado: Borrador o Activo. Solo los productos Activos con precio pueden aparecer en la tienda.

3. Precios: pago único o suscripción

Cada producto tiene un tipo de precio:

• Pago único: un solo precio fijo.
• Suscripción: precio mensual y/o anual; puedes marcar cuál de los dos ciclos es el predeterminado.

Junto a cada precio encontrarás la casilla Exento de impuesto (con sus variantes mensual y anual en los productos de suscripción, y una casilla propia por variante). Márcala en los productos o servicios que no causan ITBMS: las facturas y presupuestos que los usen dejarán esa línea fuera de la base del impuesto y la mostrarán con el sufijo (E).

La Tienda online y el checkout de carrito usan siempre el pago único o el ciclo mensual del producto — las suscripciones recurrentes se gestionan hoy vía Facturas.

4. Variantes: opciones y combinaciones

Cuando un mismo producto se vende en más de una presentación —tallas, colores, capacidades— no hace falta crear un producto por cada una. En la pestaña Variantes defines las opciones (el eje de variación, por ejemplo Color) y sus valores (Rojo, Azul). Con Generar combinaciones, MGPanel cruza todas las opciones y crea una fila por cada combinación posible.

Cada combinación tiene su propio SKU, precio, stock y estado, así que puedes tener la talla S agotada mientras la M sigue a la venta, o cobrar más por una capacidad mayor.

• Puedes definir hasta 3 opciones por producto.
• Los valores repetidos se descartan: Rojo y rojo son el mismo valor.
• Toda combinación necesita un valor de cada opción. Si defines Color y Talla, no existe una variante que sea solo «Rojo».
• Desactivar una combinación la oculta en la tienda sin borrarla ni perder su stock.

Las imágenes cuelgan del valor, no de la combinación

Las fotos se asocian al valor de una opción, normalmente al color. Si asignas tres fotos a Rojo, la galería del sitio mostrará esas tres cuando el comprador elija Rojo, sin importar qué talla haya seleccionado. Es lo que evita subir la misma foto para cada combinación.

Las fotos tienen que existir antes de poder asignarlas: guarda el producto y súbelas a su galería, y después vuelve a abrir el valor y asócialas desde Imágenes (opcional).

El stock pasa a calcularse solo

En cuanto un producto tiene combinaciones, el stock del producto deja de escribirse a mano: MGPanel lo calcula como la suma del stock de las combinaciones activas. Si desactivas una, su inventario deja de contar en el total. Para corregir existencias, edita la fila de la combinación, no el campo del producto.

Plantillas de variantes

Si repites los mismos ejes en muchos productos —Talla S/M/L, los colores de tu marca— guárdalos como plantilla desde el menú de la pestaña Variantes y aplícala al crear el siguiente producto. Las plantillas se guardan en la cuenta, no en el producto: cada cuenta puede tener hasta 20, con un máximo de 3 opciones cada una.

Editar variantes por API o con un agente

Las variantes también se pueden definir desde fuera del panel, por la API o con un agente conectado. Ahí hay una diferencia importante: el envío reemplaza la lista completa. Lo que no vaya en la llamada se borra, con su stock. Por eso conviene pedir primero el estado actual, y ejecutar en modo simulación para ver qué se crearía y qué se borraría antes de guardar.

Las fotos no viajan en esa llamada: se conservan las que ya tenías para cada valor que siga existiendo. Un valor nuevo nace sin imágenes y hay que asignárselas desde el panel.

5. Abono: reservar pagando una parte

Para productos caros o por encargo puedes permitir que el comprador reserve pagando un porcentaje en vez del total. Se activa por producto con la casilla Aceptar abono y un Porcentaje del abono. En el checkout, el comprador elige entre pagar ese abono o el importe completo.

• Solo aplica a productos de pago único: una suscripción ya cobra por ciclo y un abono sobre ella no significa nada.
• El porcentaje tiene que estar entre 0 y 100, sin incluirlos: un 0 % no cobraría nada y un 100 % es el total.
• Las combinaciones heredan el porcentaje del producto; no se configura por variante.

En el producto guardas el porcentaje, no una cifra: el importe en dinero se calcula al crear el pedido, sobre las líneas de pago único, y queda fijado en ese pedido. El resto queda como saldo pendiente de esa factura, así que lo sigues cobrando con el circuito normal de pagos.

6. Visibilidad en la tienda

Un producto aparece en /store y en los shortcodes de tienda solo si cumple los tres criterios:

• Estado Activo.
• Interruptor “Tienda online” activo (independiente de si lo usas en facturas).
• Tiene un precio configurado.

Los destacados (usados por {{tienda=destacados}}) no son un interruptor por producto: son una lista curada a nivel de cuenta, en la configuración de la tienda. Por ahora no tiene un editor visual en el panel — si necesitas curar destacados, contacta a soporte.

7. Relación con facturas y presupuestos

Al agregar un producto del inventario a una factura o presupuesto, MGPanel copia su título, precio, descripción y su condición de exento de ITBMS como una línea independiente del documento. Es una fotografía del momento: si luego editas el precio, el título o la exención del producto en Inventario, los documentos ya creados no cambian — solo aplica a los nuevos que agregues.

Gracias a eso, una misma factura o presupuesto puede combinar líneas gravadas y exentas: basta con que los productos exentos tengan marcada su casilla. El detalle del cálculo y los tres niveles de exención (producto, documento y cliente) están en Facturas.

8. API de productos

Para integraciones externas (importaciones, sincronización con otro sistema), MGPanel expone:

• GET /api/products: listado con filtros page, limit, search, category, type.
• POST /api/products: crea o actualiza un producto (autenticado con API Key).

Cada producto devuelto incluye id, title, description, url, sku, price, priceType, priceDetail, imageUrl, categories y stock. Consulta Integraciones para generar tu API Key.

9. Códigos de barras (EAN) e inventario

El campo SKU admite cualquier texto: puedes usarlo para guardar tu código EAN o de barras existente, escribiéndolo manualmente al crear o editar el producto. Al ser buscable, también sirve para ubicar el producto rápido desde ese código.

Por ahora MGPanel no cuenta con una función nativa para escanear el código EAN con la cámara del celular y actualizar el inventario de forma automática. Es una mejora que podría evaluarse en una futura actualización del módulo de Productos.