Cómo crear una especificación
Crea una especificación de catálogo para reutilizarla como etiqueta o atributo de producto en la carta, como Sin gluten, Picante o Vegetariano.
En este artículo
Las especificaciones ayudan a ordenar el catálogo con etiquetas reutilizables. Se crean una vez en el ámbito de organización o ubicación y después pueden asociarse a productos desde su propio formulario.
En el demo ES, el flujo operativo se documenta en Grupo Marea Demo, ubicación Marea Gran Via, desde la pestaña Especificaciones de la gestión de catálogos.
Antes de empezar
- Tener sesión iniciada con organización activa; para crear en ubicación, Marea Gran Via debe estar seleccionada.
- Disponer de `catalog:manage` en el ámbito donde se va a crear la especificación.
- Tener `catalog:view` para cargar y revisar la lista de especificaciones.
- Si se quiere usar imagen, subirla desde el campo Imagen antes de guardar; la especificación también puede crearse sin imagen.
Instrucciones
- 1.
Abre Especificaciones
Entra en la gestión de catálogos de Marea Gran Via y abre `/location/catalogs?tab=specifications`. Esa lista será la superficie que se refresque después del alta.
- 2.
Pulsa Crear Especificación
La app abre el formulario sin `id`, mantiene la pestaña de origen como `specifications` y prepara el alta en el ámbito actual.
- 3.
Rellena los campos principales
Escribe el nombre de la especificación. La descripción es opcional y el color ya tiene un valor por defecto (`#98A2B3`), aunque puedes cambiarlo antes de guardar.
- 4.
Añade imagen solo si hace falta
El campo Imagen sube primero el archivo y guarda la referencia resultante. Si no adjuntas imagen, el alta continúa con nombre, descripción y color.
- 5.
Guarda la especificación
Al pulsar Crear Especificación, la app envía la especificación al ámbito de ubicación o de organización. En ubicación se crea para Marea Gran Via; en organización se crea para Grupo Marea Demo.
- 6.
Comprueba el resultado en la lista
Tras el `201`, la app invalida la lista, vuelve a la pestaña Especificaciones y muestra la nueva etiqueta disponible para el catálogo.
Validaciones y límites
- `Nombre` es obligatorio y no puede quedar vacío después de quitar espacios al inicio y al final.
- `Color` se normaliza en el frontend; si está vacío o no es un hex válido, se usa `#98A2B3`.
- `Descripción` e `image_file_id` se omiten del payload cuando quedan vacíos.
- No puede existir otra especificación con el mismo nombre dentro del mismo ámbito efectivo de organización o ubicación.
- `catalog:view` permite ver la lista, pero crear exige `catalog:manage`.
- Crear una especificación no la asocia a productos; esa relación se gestiona desde el formulario de producto.
- La imagen depende de `POST /api/app/files`; si la subida falla, se puede guardar la especificación sin imagen.
Resultado esperado
La especificación queda creada en el ámbito elegido, la lista se refresca y la etiqueta queda preparada para usarse después en productos del catálogo.