Cómo configurar un producto de cocina
Configura si un producto de la carta entra en el flujo de cocina/KDS y define los nombres operativos que se muestran en TPV y cocina.
En este artículo
Esta guía cubre la ficha de producto que usa el equipo de Marea Gran Via para decidir si un plato como Croquetas de jamon, Pulpo a la brasa o Arroz meloso de carabinero debe pasar por cocina.
La configuración vive dentro del producto completo: aunque solo cambies campos de cocina, el guardado mantiene nombre, precio, tipo de producto y categoría fiscal.
Antes de empezar
- Tener seleccionada una organización y, para el flujo principal, una ubicación como Marea Gran Via.
- Contar con `catalog:manage` para crear o actualizar productos. Con `catalog:view` puedes consultar, pero no guardar cambios.
- Disponer de tipos de producto y categorías fiscales seleccionables; el formulario los exige aunque la acción se centre en cocina.
- Para comprobar el resultado en KDS, la ubicación debe tener KDS habilitado, un ticket operativo y el producto añadido al ticket.
Instrucciones
- 1.
Abrir Productos
Entra en Catálogos y abre la pestaña Productos. Desde esta lista puedes crear un producto, abrir uno existente, copiarlo o editarlo.
- 2.
Abrir la ficha
Abre un producto existente o crea uno nuevo. En edición se cargan `Requiere cocina`, `Nombre cocina` y `Nombre corto`; en creación, `Requiere cocina` empieza desactivado.
- 3.
Activar Requiere cocina
Activa `Requiere cocina` cuando el producto deba prepararse o seguirse en KDS. Esto afecta a nuevos usos normales del producto, pero no habilita KDS ni envía tickets por sí solo.
- 4.
Definir nombres operativos
Rellena `Nombre cocina` si cocina necesita un nombre distinto al comercial. Usa `Nombre corto` como etiqueta compacta para TPV y como fallback en KDS.
- 5.
Completar obligatorios
Revisa que la ficha completa siga siendo válida: nombre, precio, tipo de producto y categoría fiscal. El guardado se hace sobre el producto completo.
- 6.
Guardar cambios
Pulsa Guardar o Crear. La app guarda `requires_kitchen`, `kitchen_name` y `short_name` junto con el resto del payload del producto.
- 7.
Comprobar en KDS
Añade el producto a un ticket de TPV y abre KDS. El tablero muestra los items relevantes de cocina y aplica la prioridad de nombre operativo definida en la ficha.
Validaciones y límites
- `catalog:manage` es obligatorio para crear o actualizar; `catalog:view` solo permite consultar productos.
- El formulario exige nombre, precio válido, `productTypeId` y `taxCategoryId`.
- El backend recorta el nombre y lo exige; precio `0` se trata como obligatorio y un precio negativo como inválido.
- En ubicación, el tipo de producto debe pertenecer al mismo scope exacto del producto.
- `Nombre cocina` y `Nombre corto` son opcionales; los textos vacíos se limpian al guardar y no se encontró una regla específica de formato o longitud.
- KDS muestra el nombre con prioridad `kitchen_name`, después `short_name` y después `name`; TPV prefiere `short_name` y cae a `name`.
- KDS considera relevante un item si `requires_kitchen=true` o si su estado está en `sent`, `preparing` o `ready`, y excluye `served` y `cancelled`.
- No hay endpoint separado de cocina: estos campos se guardan dentro de POST/PUT de productos.
Resultado esperado
El producto queda guardado con su configuración de cocina y nombres operativos. A partir de ahí, los nuevos ticket_items asociados al producto pueden entrar en el flujo KDS y mostrar el nombre adecuado para sala y cocina.