Cómo crear un alérgeno
Crea un alérgeno propio de la organización o de una ubicación, como Marea Gran Via, para usarlo después en productos y mantener ordenada la taxonomía del catálogo.
En este artículo
Los alérgenos ayudan a mantener una taxonomía clara dentro del catálogo. En Antylogic pueden crearse en el ámbito de organización o en el de una ubicación concreta, según dónde deba estar disponible el registro.
El alta guarda nombre, descripción opcional, color e imagen opcional. Crear el alérgeno no lo asigna automáticamente a productos: esa relación se hace después desde el flujo de producto.
Antes de empezar
- Tener sesión iniciada en Grupo Marea Demo o en la organización correspondiente.
- Para crear en ubicación, tener seleccionada una ubicación, por ejemplo Marea Gran Via.
- Disponer de permiso `catalog:manage` en el ámbito donde se va a crear el alérgeno.
- Usar un nombre que no exista ya en el mismo ámbito de organización o ubicación.
- Si vas a añadir imagen, el servicio de ficheros debe estar disponible; sin imagen, basta con completar el formulario.
Instrucciones
- 1.
Abre la pestaña Alérgenos
Desde la gestión de catálogos de la ubicación, entra en la pestaña Alérgenos. En Marea Gran Via verás la tabla con nombre, descripción, color, propietario, búsqueda y paginación.
- 2.
Entra en Crear Alérgeno
Pulsa Crear Alérgeno. La pantalla se abre en modo creación porque no recibe id de alérgeno y muestra los campos Nombre, Descripción, Color e Imagen.
- 3.
Completa los datos básicos
Introduce el Nombre. La Descripción es opcional y sirve para aclarar el uso interno. Mantén el color por defecto `#98A2B3` o selecciona otro para identificar visualmente el alérgeno.
- 4.
Añade imagen si procede
Si el alérgeno necesita imagen, usa el campo Imagen. La app sube primero el archivo y guarda su referencia para asociarla al registro. Si no añades imagen, el alérgeno se crea sin `image_file_id`.
- 5.
Guarda el alérgeno
Revisa los campos y pulsa Crear Alérgeno. En ubicación, el registro queda guardado para Marea Gran Via; en organización, queda guardado para Grupo Marea Demo.
- 6.
Comprueba la lista
Después de guardar, la app muestra la confirmación, refresca la lista de alérgenos y vuelve a la pestaña del recurso. El nuevo alérgeno queda disponible para seleccionarlo más adelante en productos.
Validaciones y límites
- La organización seleccionada es obligatoria; en ámbito de ubicación también debe existir una ubicación seleccionada.
- Con `catalog:view` se puede consultar, pero crear requiere `catalog:manage`.
- Nombre es obligatorio, se recorta antes de enviar y no puede quedar vacío.
- El nombre debe ser único dentro del mismo ámbito de organización o ubicación.
- Color aparece como obligatorio en la UI, se normaliza como hexadecimal y parte de `#98A2B3` en creación.
- El botón de creación se deshabilita si el formulario no tiene cambios, no es válido o ya se está enviando.
- La imagen es opcional y el selector del formulario acepta una única imagen; no documentes como garantizado el límite visual de 2 MB.
- La ruta determina si el alérgeno se crea en organización o ubicación; el usuario no elige `org_id` ni `location_id` en el formulario.
- La app no crea alérgenos de sistema desde este flujo y la creación no enlaza productos automáticamente.
Resultado esperado
El alérgeno queda creado en el ámbito elegido, la lista se recarga y el registro puede usarse después en productos sin modificar todavía ninguna ficha de producto.