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, por encargo o experiencias con cupo puedes permitir que el comprador reserve pagando una parte en vez del total. Se activa por producto con la casilla Aceptar abono, en el bloque de precio, y eliges el Tipo de abono. En el checkout, el comprador elige entre pagar ese abono o el importe completo.

• Porcentaje del precio — por ejemplo 30 %. Tiene que estar entre 0 y 100, sin incluirlos: un 0 % no cobraría nada y un 100 % es el total.
• Monto fijo — por ejemplo $50. En Se cobra eliges si es por unidad (por persona), así dos adultos reservan con $100, o por línea, una sola vez sin importar la cantidad.
• Si un monto fijo iguala o supera el precio de una variante, esa línea se cobra completa: un abono de $50 no aplica a una entrada de $39.
• Solo aplica a productos de pago único: una suscripción ya cobra por ciclo y un abono sobre ella no significa nada.

Abono por variante

Con el abono activo, la tabla de la pestaña Variantes muestra la columna Abono. Cada combinación puede:

• Hereda (por defecto) — usa la regla del producto.
• Sin abono — esa combinación se paga completa.
• % propio o $ propio — su propia regla. Si se cobra por unidad o por línea lo sigue decidiendo el producto.

Ejemplo en un tour: el producto acepta $50 por persona, Niño (6-11) lleva $30 propios y Niño (2-5) queda sin abono. La casilla Aceptar abono del producto es el interruptor general: si la desactivas, ninguna variante cobra abono aunque tenga una regla propia. Si editas las variantes por API o con un agente y no envías la regla de abono de una combinación, se conserva la que tenía.

Qué se cobra al reservar

El abono solo reduce las líneas que lo aceptan. Todo lo demás se cobra completo al reservar: los productos sin abono, el envío y el impuesto. Ejemplo: un tour de $100 con 30 % de abono y un producto de $149 sin abono cobran $179 al reservar ($30 + $149); si el comprador elige un envío de $10, pasan a $189. Los $70 restantes del tour quedan como saldo pendiente del pedido.

Cómo lo ve el comprador

Con la tienda en modo Carrito y el precio visible (formato Exacto o Desde), el precio total se sigue mostrando y el abono aparece como una línea adicional:

• Tarjeta del listado: «Reserva con 50.00 USD», o «Reserva desde …» si el abono cambia entre variantes.
• Ficha del producto: «Reserva hoy con 50.00 USD · resto 40.00 USD después», que se actualiza al elegir la variante. El botón de compra rápida pasa a decir «Reservar con 50.00 USD».
• Pestaña Pago: un aviso con el porcentaje o el monto del abono.

Con el precio oculto o «Solo cotización», el abono tampoco se muestra, porque delataría el precio.

En el producto guardas la regla (porcentaje o monto), no una cifra final: el importe se calcula al crear el pedido, línea por línea, y queda fijado en ese pedido. El saldo 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.

10. Fecha de reserva (tours, experiencias, alquileres)

Para servicios que se compran para un día concreto —un tour, una clase, un alquiler— el producto puede pedir al comprador que elija la fecha antes de agregarlo al carrito. Es opcional y está apagado por defecto: primero se activa Reservas con fecha en Configuración → Tienda, y recién entonces aparece en cada producto el bloque Reserva con fecha con la casilla Pedir fecha al comprar. Las tiendas que no lo activan no ven ningún cambio.

• Anticipación mínima (días) — 0 permite reservar para hoy; 1, desde mañana.
• Ventana de reserva (días) — hasta cuántos días hacia adelante se puede reservar (365 por defecto).
• Días de operación — los días de la semana en que hay salida.
• Fechas bloqueadas — feriados o días sin salida.

En la ficha, el comprador ve un calendario con los días disponibles y los botones de compra se habilitan al elegir una fecha. La fecha no se borra al cambiar de variante, así que puede agregar un adulto y un niño para el mismo día; fechas distintas quedan como líneas separadas del carrito. El día de hoy se calcula con la zona horaria de la cuenta, y al crear el pedido se vuelve a comprobar que la fecha siga disponible.

La fecha queda en la descripción de cada línea (por ejemplo «Tour Isla Mamey — Adulto — 29 sept 2026»), así que aparece en el pedido, el correo de confirmación y la factura, y se conserva al convertir un presupuesto en factura. En modo Catálogo también viaja en la cotización. Para ver los pedidos de un día, usa el filtro de fecha de Tienda → Órdenes — ver Tienda online.