Cómo activar o desactivar KDS
Permite habilitar o bloquear el uso de KDS en una ubicación desde la configuración TPV. El cambio se guarda junto con el resto de ajustes TPV y, si se apaga KDS mientras la salida de cocina predeterminada era un dispositivo KDS, esa selección se limpia antes de guardar.
En este artículo
El campo Habilitar KDS decide si la ubicación puede usar el tablero de cocina. En Marea Gran Via está dentro de Configuración TPV, en la pestaña General.
No es un cambio aislado: la pantalla guarda el snapshot completo de ajustes TPV. Al desactivar KDS, Antylogic bloquea el tablero KDS y excluye dispositivos KDS de la salida de cocina.
Antes de empezar
- Iniciar sesión en Antylogic con Grupo Marea Demo y la ubicación Marea Gran Via seleccionadas.
- Tener acceso a `/:orgId/:locationId/location/tpv`.
- Disponer de `tpv:manage` para cambiar el checkbox y guardar. Con `tpv:view` la pantalla se puede consultar, pero los campos quedan deshabilitados.
- Esperar a que carguen `tpv-settings` y `tpv-output-devices` antes de modificar el ajuste.
Instrucciones
- 1.
Abrir Configuración TPV
Entra en la pantalla de ajustes TPV de Marea Gran Via desde `/:orgId/:locationId/location/tpv`. La acción se realiza en la pestaña General.
- 2.
Localizar Habilitar KDS
Busca el campo Habilitar KDS y revisa su estado actual. Si no existe una fila previa de `tpv_settings`, el valor inicial se considera activado.
- 3.
Cambiar el checkbox
Activa el campo para permitir el uso de KDS o desactívalo para bloquear el tablero. Si al desactivarlo la salida de cocina predeterminada era un dispositivo de tipo KDS, la pantalla deja esa salida sin seleccionar.
- 4.
Guardar cambios
Pulsa Guardar cambios. La pantalla envía `enable_kds` dentro del snapshot completo de ajustes TPV y muestra la confirmación cuando se guarda correctamente.
- 5.
Comprobar el impacto en cocina
Si KDS queda desactivado, al abrir `/:orgId/:locationId/kds` se muestra que KDS está deshabilitado en los ajustes del TPV y no se carga el tablero operativo.
Validaciones y límites
- Si falta organización o ubicación seleccionada, la pantalla pide seleccionar una ubicación y no ejecuta la acción.
- Sin `tpv:view` ni `tpv:manage`, la pantalla muestra falta de permisos.
- El guardado requiere `tpv:manage`; `tpv:view` solo permite consulta.
- El backend valida que los dispositivos de ticket, cocina y control del snapshot pertenezcan a la misma ubicación o queden vacíos.
- Al reactivar KDS, un dispositivo KDS limpiado como salida de cocina no se restaura automáticamente; hay que seleccionarlo de nuevo.
- Desactivar KDS no cierra servicios, no cambia tickets abiertos, no modifica `ticket_items` y no borra `tpv_output_jobs` existentes.
- El demo `restaurant_full_v1-es` espera `enable_kds=true`; cualquier captura con KDS apagado debe restaurarlo al finalizar.
Resultado esperado
La ubicación queda con `enable_kds` persistido en `tpv_settings`. Si está activado, KDS queda disponible para la operativa de cocina; si está desactivado, el tablero KDS se bloquea y las salidas KDS quedan fuera de los trabajos de cocina.