Ver detalle de producto
Abre un producto existente del catálogo para revisar precio, tipo, impuesto, cocina/KDS, imagen, alérgenos y especificaciones antes de tocar la carta o validar su uso en TPV y cocina.
En este artículo
El detalle de producto concentra la información comercial y operativa que el restaurante necesita antes de publicar, revisar o modificar un artículo de carta.
En el demo de España, esta guía encaja con Marea Gran Via y productos como Croquetas de jamon, siempre que el runtime documental publique un identificador real de producto para abrir el detalle directo.
Antes de empezar
- Hay una organización seleccionada; en ámbito ubicación también hay una ubicación seleccionada, por ejemplo Marea Gran Via.
- El producto existe y es visible desde el ámbito actual: producto de ubicación, producto heredado de organización o producto de sistema legible.
- El usuario tiene `catalog:view` o `catalog:manage` en el ámbito correspondiente.
- Las listas de tipos de producto, tipos impositivos, alérgenos y especificaciones están disponibles para mostrar nombres y opciones del formulario.
Instrucciones
- 1.
Abre Productos en Catálogos
Desde la ubicación, entra en Catálogos y selecciona la pestaña Productos. La tabla muestra productos propios de la ubicación y productos heredados de la organización cuando son legibles.
- 2.
Selecciona el producto
Pulsa la fila del producto o la acción Ver/Editar. La pantalla con id abre el detalle; la misma ruta sin id corresponde a creación y no forma parte de esta consulta.
- 3.
Revisa los datos comerciales
Comprueba Nombre, Precio, Tipo de producto, Tipo impositivo y Descripción para validar cómo se identifica, vende y grava el producto en carta y TPV.
- 4.
Revisa cocina, alias e imagen
Comprueba Requiere cocina, Nombre cocina, Nombre corto, Color e Imagen. Requiere cocina indica si el producto pasa por KDS; Nombre cocina y Nombre corto separan el alias de cocina de las superficies compactas.
- 5.
Revisa alérgenos y especificaciones
Consulta los chips o selectores de Alérgenos y Especificaciones. La pantalla resuelve esas etiquetas desde los catálogos auxiliares disponibles en el mismo ámbito.
- 6.
Distingue consulta de edición
Si el usuario solo tiene `catalog:view`, o si el producto no pertenece a un ámbito editable para ese usuario, el formulario queda bloqueado. Guardar, Eliminar y creación pertenecen a otras acciones.
Validaciones y límites
- La pantalla necesita `selectedOrgId`; en ámbito `location` también necesita `selectedLocationId`.
- El detalle se carga desde `GET /api/app/{orgId}/{locationId}/products/{productId}` en ubicación o `GET /api/app/{orgId}/products/{productId}` en organización.
- El backend exige `PermCatalogView` y devuelve no encontrado si el producto queda fuera de alcance.
- Los productos de sistema pueden verse si el backend los devuelve, pero no son editables.
- El enlace directo necesita un `productId` real; el runtime ES inspeccionado no publica `SETUP_PRODUCT_ID`.
Resultado esperado
El operador ve el formulario del producto cargado con datos comerciales, cocina/KDS, imagen, alérgenos y especificaciones, y entiende si ese producto solo puede consultarse o también editarse.