Catálogo y Precios
Todo lo que un miembro ve en el dispensario nace acá. Esta guía cubre la construcción del catálogo —genéticas, categorías, productos, fracciones, precios e inventario—; dispensar ese catálogo (pedidos, pagos, retiros) está en Gestionar el Dispensario.
De la cepa al stock
El catálogo se arma en cadena: nada existe suelto. Una cepa da origen a un producto, el producto se divide en fracciones, y cada fracción tiene su precio y su stock por filial.
Si tu club cultiva, el stock entra desde la cosecha; si comprás a terceros, entra desde una compra mayorista. En los dos casos el destino es el mismo: una fracción con stock en una filial.
Genéticas
Antes de crear productos necesitás cepas cargadas en la biblioteca. La cepa es el dato botánico y médico; el producto es el artículo dispensable.
Cada cepa guarda su tipo (sativa / índica / híbrida con porcentajes), su perfil de cannabinoides (THC, CBD, CBG, CBN, THCV), sus terpenos dominantes, su linaje y sus análisis de laboratorio. El producto se vincula a la cepa y hereda ese perfil, así el dato vive en un solo lugar y el miembro lo ve en la ficha del dispensario.
Consejo
Cargá la cepa antes que el producto. Si creás el producto primero vas a tener que volver a editarlo para vincularlo, y mientras tanto el perfil de cannabinoides aparece vacío en el dispensario.
Cómo modela Cannahub un producto
Cannahub usa Medusa como backend de comercio. Entender su modelo evita los dos errores más comunes: cargar cada fracción como un producto aparte, y buscar el stock en el lugar equivocado.
| Elemento | Qué representa |
|---|---|
| Producto | La entidad base del catálogo (ej: "Blue Dream"). Agrupa variantes, imágenes y categorías. |
| Opciones | Las dimensiones de configuración, típicamente el gramaje (opción "Peso" con valores 1 g, 3,5 g, 5 g). |
| Variantes | Cada fracción dispensable. Una variante = una combinación de opciones, con SKU, precio y stock propios. |
| Categorías | Clasificación jerárquica del producto. |
| Metadata | Campos propios de Cannahub; ahí se guarda el vínculo con la cepa. |
Una fracción no es un producto
1 g, 3,5 g y 5 g de Blue Dream son tres variantes de un mismo producto, no tres productos. Todo el precio y todo el inventario se manejan a nivel de variante.
Categorías
Las categorías clasifican el catálogo y admiten jerarquía (una categoría padre con subcategorías).
| Categoría | Subcategorías |
|---|---|
| Flores | Sativas, Índicas, Híbridas, Alto CBD |
| Extracciones | Aceites, Resinas, Concentrados, Tinturas |
| Semillas | Feminizadas, Auto-florecientes, Regulares |
| Accesorios | Cultivo, Consumo, Medición, Almacenamiento |
Las reglas son pocas y conviene respetarlas:
- Una categoría tiene una sola categoría padre (o ninguna, si es raíz), y no puede ser descendiente de sí misma.
- Las subcategorías heredan visibilidad: si el padre está inactivo, las hijas no aparecen en el dispensario.
- Un producto puede estar en varias categorías a la vez (ej: "Flores > Híbridas" y "Alto CBD").
- El orden (rank) define cómo se listan en los menús del dispensario.
Consejo
Mantené la jerarquía en 2 o 3 niveles. Un árbol más profundo complica la navegación del miembro sin agregar precisión.
Crear un producto
Desde Productos → Añadir, un asistente de cinco pasos. Cada paso valida sus campos obligatorios antes de dejarte avanzar.
Asistente de producto
- Nombre (obligatorio): no vacío y único dentro del catálogo
- Categoría (obligatoria): al menos una asignada
- Descripción corta: el texto que se lee en los listados
- Descripción completa: el detalle médico y de uso de la ficha
- Handle / URL: se genera del nombre, es editable y debe ser único
El producto nace en borrador. No lo ve ningún miembro hasta que lo pases a activo.
Ese es el punto del paso 2: elegís Wedding Cake y el producto se queda con su THC, sus terpenos y su genealogía. No se vuelven a tipear, y si mañana corregís el perfil de la cepa, el producto lo refleja.
El SKU es único
Un SKU duplicado bloquea el guardado. No es una validación decorativa: el SKU es lo que ata cada movimiento de inventario a su fracción, y repetirlo rompe la trazabilidad del lote.
Crear el producto no crea el stock
Al terminar el asistente, el producto aparece en el catálogo con su precio y la columna de stock en Añadir stock. Son dos cosas distintas: el asistente define qué se dispensa y a cuánto; el inventario define cuánto hay y en qué filial. Ese es el paso siguiente, más abajo.
Qué fracción ofrecer
No hay una regla fija, pero estas son las presentaciones que mejor funcionan y a qué consumo responden:
| Fracción | A qué responde |
|---|---|
| 1 g | Probar una cepa nueva |
| 3,5 g | Consumo semanal |
| 5 g | Consumo quincenal |
| 10 g | Consumo mensual |
Estados del producto
Solo el estado activo hace visible un producto en el dispensario.
Estados del producto
Borrador
En preparación. No lo ve ningún miembro.
- Completar fracciones y precios
- Pasarlo a activo cuando esté listo
| Desde | Hacia | Efecto |
|---|---|---|
| Borrador | Activo | Lo publica. Requiere al menos una fracción con precio |
| Activo | Borrador | Lo oculta del dispensario sin borrarlo |
| Activo | Archivado | Lo retira de la dispensación y conserva el historial |
| Archivado | Borrador | Lo reactiva para editarlo antes de volver a publicarlo |
Archivar no es borrar
El producto archivado conserva su historial de dispensación e inventario, que es exactamente lo que te van a pedir en una auditoría. Archivá en lugar de eliminar siempre que puedas.
Precios
El precio de una fracción se resuelve en dos capas: el precio base que cargaste en el paso 4, y las listas de precios que lo sobrescriben cuando se cumplen ciertas condiciones.
Una lista de precios agrupa precios especiales para un conjunto de fracciones bajo ciertas condiciones:
| Atributo | Qué define |
|---|---|
| Tipo | sale (oferta) o override (precio fijo de segmento) |
| Segmento | A qué membresía o grupo aplica |
| Región | La filial o región donde rige |
| Vigencia | Rango de fechas; fuera de él se vuelve al precio base |
| Fracciones | Qué variantes afecta y con qué precio |
Los segmentos que casi todos los clubes terminan usando son General (equivale al base), VIP para membresías premium, Médica para pacientes y Staff para el equipo. Si dos listas aplican a la misma persona, gana la más específica y vigente.
Consejo
La causa número uno de "este precio está mal" es una promoción vieja que nunca se dio de baja. Revisá las fechas de vigencia antes de tocar el precio base.
Inventario
El stock se lleva por fracción y por filial: la misma fracción puede tener 20 unidades en Sede Central y 0 en Sede Norte. Cada filial mantiene tres números por fracción:
| Número | Qué es |
|---|---|
| En stock | Las unidades cargadas en esa filial |
| Reservado | Lo comprometido en pedidos que todavía no se entregaron |
| Disponible | En stock menos reservado: lo que se puede dispensar hoy |
Unidades arriba, gramos abajo
En la fracción, la cantidad son unidades (10 paquetes de 5 g = 10). En el producto, Cannahub suma las fracciones multiplicadas por su peso, así que la cantidad son gramos (esos mismos 10 paquetes = 50 g). Es el mismo dato con dos unidades según el nivel, y explica por qué el número del producto nunca coincide con el de sus fracciones.
Producto: Blue Dream — Sede Central
├─ 1 g: 20 unidades = 20 g
├─ 3,5 g: 15 unidades = 52,5 g
├─ 5 g: 8 unidades = 40 g
└─ 10 g: 5 unidades = 50 g
Total del producto: 162,5 g en 48 unidades
Cargar y ajustar stock
Hay dos caminos, y conviene usar el correcto:
- Por producto — desde la ficha, Editar stock abre las fracciones de ese producto para ajustarlas filial por filial. Es lo natural para una corrección puntual.
- Por lote — actualizás muchas fracciones de una sola vez. Es lo que querés después de una cosecha o de una compra, cuando entran varias fracciones juntas.
Actualizar stock
Alertas
El sistema avisa solo cuando una fracción cae debajo del mínimo configurado, cuando llega a cero, y cuando se acerca una fecha de caducidad. El mínimo se define por fracción: no es lo mismo quedarse sin 1 g que sin 10 g.
Trazabilidad
Cada lote de stock guarda su número, la cantidad inicial, la filial de origen, la fecha de cosecha, cómo se repartió entre fracciones y sus controles de calidad. Esa cadena es la que se audita en Cumplimiento.
Preguntas frecuentes
¿Cuál es la diferencia entre un producto y una fracción?
El producto es la entidad base (Blue Dream). Cada fracción (1 g, 3,5 g, 5 g) es una variante de ese producto con su propio SKU, precio e inventario. No se cargan como productos separados.
¿Por qué mi producto nuevo no aparece en el dispensario?
Los productos se crean en borrador. Tenés que pasarlo a activo y tener al menos una fracción con precio para que sea visible.
¿Por qué el stock del producto no coincide con el de sus fracciones?
Porque están en unidades distintas: la fracción cuenta unidades y el producto cuenta gramos (suma cada fracción multiplicada por su peso). 10 paquetes de 5 g se muestran como 10 en la fracción y como 50 g en el producto.
¿Cómo aplico un precio distinto para miembros VIP?
Creá una lista de precios para el segmento VIP, asignale las fracciones con su precio y definí la vigencia. Sobrescribe el precio base para ese grupo mientras esté vigente.
¿Cómo repongo stock después de una cosecha?
Con la actualización por lote: seleccionás las fracciones del lote, elegís la filial y cargás las cantidades en una sola operación auditada.
¿Conviene borrar o archivar un producto discontinuado?
Archivar. Conserva el historial de dispensación e inventario para trazabilidad y cumplimiento, y podés reactivarlo pasándolo a borrador.