Cómo definir la salida de cocina
Configura qué impresora de cocina o pantalla KDS recibirá por defecto las comandas de una ubicación desde los ajustes TPV, sin crear ni editar dispositivos de salida.
En este artículo
La salida de cocina por defecto decide a qué destino intentará enviar Antylogic las comandas de cocina de una ubicación como Marea Gran Via. El ajuste vive en Ajustes TPV, dentro de la pestaña General y la sección Impresoras por defecto.
El selector no crea dispositivos: solo permite elegir entre salidas ya existentes de la misma ubicación. Las impresoras de cocina aparecen siempre que su `device_kind` sea `kitchen_printer`; las pantallas KDS solo aparecen cuando `Habilitar KDS` está activo.
Antes de empezar
- Iniciar sesión con Grupo Marea Demo y la ubicación Marea Gran Via seleccionadas, o con un contexto equivalente de organización y ubicación.
- Tener permiso de ubicación `tpv:manage` para modificar el selector y guardar cambios; con `tpv:view` la pantalla queda en modo consulta.
- Para elegir una salida real, debe existir un `tpv_output_devices` de la ubicación con `device_kind` `kitchen_printer`, o `kds` si se va a usar una pantalla KDS.
- Mantener activo `Habilitar KDS` si la salida por defecto será una pantalla KDS.
Instrucciones
- 1.
Abre los ajustes TPV
Entra en `/:orgId/:locationId/location/tpv` con la ubicación seleccionada. La pantalla carga los ajustes TPV y la lista de dispositivos de salida antes de mostrar el formulario.
- 2.
Revisa el estado de KDS
En la pestaña General, comprueba `Habilitar KDS` antes de elegir una pantalla KDS. Si solo vas a usar una impresora de cocina, este ajuste no oculta las opciones `kitchen_printer`.
- 3.
Abre Impresora de cocina
En Impresoras por defecto, abre el campo `Impresora de cocina`. Verás `Sin configurar` y las salidas elegibles de la ubicación.
- 4.
Elige la salida
Selecciona la impresora de cocina o KDS que debe recibir por defecto las comandas. Si el local no necesita una salida fija, deja `Sin configurar`; se guardará como valor vacío.
- 5.
Guarda los cambios
Pulsa `Guardar cambios`. Antylogic guarda el ajuste dentro de `tpv_settings.default_kitchen_output_device_id` y muestra la confirmación `Configuracion guardada` cuando la actualización termina.
- 6.
Comprueba el efecto operativo
A partir de ese momento, las comandas de cocina intentan usar primero la salida configurada. Si no hay una salida válida activa, el sistema recurre a impresoras de cocina activas y, con KDS activo, también añade pantallas KDS activas.
Validaciones y límites
- Sin organización o ubicación seleccionada, la pantalla no carga el formulario de ajustes.
- El guardado requiere `tpv:manage`; `tpv:view` permite consultar, pero no modificar ni guardar.
- `Sin configurar` es válido y se transforma en `null` antes del guardado.
- Las opciones KDS desaparecen del selector cuando `Habilitar KDS` está desactivado; si la selección actual era KDS, la interfaz la limpia antes de guardar.
- El backend acepta una salida vacía o valida que el dispositivo indicado pertenezca a la misma ubicación.
- El guardado puede fallar por permisos, payload inválido, datos de facturación no válidos o un dispositivo que pertenezca a otra ubicación.
- La interfaz filtra las opciones normales por `device_kind`, pero el backend no fuerza que el dispositivo guardado sea `kitchen_printer` o `kds`; por eso conviene cambiar este campo desde la pantalla de ajustes TPV.
Resultado esperado
Marea Gran Via queda con una salida de cocina por defecto configurada en `tpv_settings`. Las próximas comandas intentarán usar ese destino antes de aplicar las reglas de fallback de impresoras de cocina y KDS activos.