Cómo asignar taxonomía a un producto
Clasifica un producto existente con tipo de producto, tipo impositivo, alérgenos y especificaciones desde el formulario estándar de producto.
En este artículo
La taxonomía del producto se gestiona desde la propia ficha de producto. Tipo, impuesto, alérgenos y especificaciones se guardan con la actualización general de `products`, no con una acción separada.
Este flujo está pensado para operadores de catálogo y responsables de carta que necesitan dejar cada producto listo dentro del catálogo del local u organización sin crear nuevas entidades de taxonomía desde esta pantalla.
Antes de empezar
- Sesión autenticada con organización activa; en la demo ES, usar Grupo Marea Demo y la ubicación Marea Gran Via.
- Producto existente y editable en su scope propietario. Para capturas guiadas sin mutar datos, puede usarse el formulario de producto sin `PRODUCT_ID`.
- Permiso `catalog:view` para abrir el producto y `catalog:manage` para guardar cambios.
- Listas cargadas de `product-types`, `tax-categories`, `allergens` y `specifications`.
- Nombre y precio válidos, porque la taxonomía se guarda con la edición completa del producto.
Instrucciones
- 1.
Abre la ficha del producto
Entra en el catálogo de productos de ubicación u organización y abre el producto que quieres clasificar.
- 2.
Revisa nombre y precio
Comprueba que `Nombre` está informado y que `Precio` es válido. Si esos campos fallan, la app no permite guardar la taxonomía.
- 3.
Elige el tipo de producto
En `Tipo de producto`, selecciona una de las opciones visibles en el selector. La UI filtra tipos al scope exacto del formulario.
- 4.
Elige el tipo impositivo
En `Tipo impositivo`, selecciona la categoría fiscal que debe aplicar al producto dentro de las listas cargadas del catálogo.
- 5.
Marca alérgenos
Selecciona los alérgenos aplicables y desmarca los que ya no correspondan. Al guardar, esta selección sustituye por completo la lista anterior.
- 6.
Marca especificaciones
Selecciona las características aplicables al producto. Igual que con alérgenos, la selección guardada reemplaza la anterior.
- 7.
Guarda los cambios
Pulsa `Guardar` cuando el formulario tenga cambios y todos los campos obligatorios estén completos. La app actualiza el producto en el endpoint de ubicación u organización según su propietario real.
Validaciones y límites
- `Guardar` solo queda disponible si el formulario está modificado, es válido y no se está enviando.
- El frontend exige `Nombre`, `Precio`, `Tipo de producto` y `Tipo impositivo`.
- El backend exige `name`, `price` mayor que cero y valida el scope de `product_type_id` cuando viene informado.
- Con solo `catalog:view`, la ficha se puede consultar, pero queda en modo lectura y no permite guardar.
- No se puede editar un elemento de scope `system` ni guardar un producto desde un endpoint que no corresponda a su scope propietario.
- Si `allergen_ids` o `specification_ids` quedan vacíos, el guardado limpia las relaciones existentes.
- El formulario no crea tipos, impuestos, alérgenos ni especificaciones; esas entidades se gestionan en sus propias pantallas.
Resultado esperado
El producto queda actualizado en su scope propietario: `product_type_id` y `tax_category_id` se guardan en `products`, las relaciones de alérgenos y especificaciones se reemplazan, y la lista y el detalle de productos se refrescan.