Listar trabajos de salida TPV/KDS
Permite revisar la cola de salida de impresión y KDS de una ubicación, normalmente para el servicio activo y el terminal seleccionado. Es una acción de solo lectura: muestra trabajos pendientes, completados o fallidos sin reintentar, marcar como impreso ni cambiar estados.
En este artículo
La cola de salida ayuda al equipo de Marea Gran Via a confirmar qué trabajos del TPV y de cocina siguen pendientes, cuáles terminaron y cuáles fallaron durante el servicio activo.
Esta guía debe leerse como una comprobación operativa. Si una fila requiere corrección, las acciones de reintento, marcado como impreso o procesamiento local se documentan por separado.
Antes de empezar
- Iniciar sesión en Grupo Marea Demo y trabajar sobre Marea Gran Via.
- Tener una sesión de servicio activa, por ejemplo Servicio de comidas Gran Via.
- Si el TPV pide empleado, seleccionar Marta Ruiz u otro empleado TPV autorizado.
- Para abrir el TPV se necesita tpv:use; para ver Cola de impresión y KDS se necesita tpv:print o tpv:manage.
- Para la variante KDS, enable_kds debe estar activo y el usuario debe tener kds:view, kds:use o kds:manage.
Instrucciones
- 1.
Abrir el TPV de la ubicación
Entra en el TPV de Marea Gran Via con el terminal de trabajo seleccionado. La pantalla debe quedar en el espacio operativo del servicio activo antes de revisar la cola.
- 2.
Seleccionar empleado si se solicita
Si aparece el selector de empleado TPV, selecciona Marta Ruiz. Sin empleado seleccionado cuando sea obligatorio, la superficie de cola no debe abrirse.
- 3.
Abrir Más acciones del TPV
Abre Más acciones del TPV y localiza Cola de impresión y KDS. Esta entrada solo se muestra cuando el usuario puede imprimir o gestionar el TPV.
- 4.
Revisar el panel de cola
Al abrir la cola, revisa el alcance del terminal, los contadores de pendientes, completados y fallidos, y las filas visibles del servicio activo.
- 5.
Interpretar cada trabajo
Cada fila muestra el tipo de trabajo, estado, ticket o salida de servicio, dispositivo de salida, solicitante, error visible si existe y hora de solicitud.
- 6.
Mantener la lectura sin cambios
No pulses Reintentar ni Marcar impreso dentro de esta acción. El listado no crea, reclama, completa, cancela ni reintenta trabajos.
- 7.
Consultar la variante KDS
Desde cocina, KDS consume la misma cola restringida a trabajos job_kind=kds y al terminal seleccionado o activo cuando la funcionalidad KDS está habilitada.
Validaciones y límites
- GET /api/app/{orgId}/{locationId}/tpv-output-jobs solo lista trabajos; otros métodos sobre la colección no forman parte de esta acción.
- LocationID no se toma del query string: el backend lo obtiene del contexto de ubicación.
- Los filtros admitidos para listar son service_session_id, ticket_id, invoice_id, output_device_id, terminal_id, job_kind y status, y se combinan de forma acumulativa.
- La UI TPV lista por service_session_id y aplica el alcance visual por terminal en cliente mediante terminal_id y claimed_by_terminal_id.
- La UI TPV muestra como máximo ocho filas, aunque la API no implementa paginación ni límite explícito.
- Los tipos implementados en frontend son ticket_receipt, kitchen_order, control_order, invoice y kds; los estados son pending, claimed, completed, failed y cancelled.
- Usuarios solo KDS quedan restringidos a job_kind=kds; pedir otro tipo devuelve permiso denegado.
Resultado esperado
El operador ve el estado de la cola de salida para el servicio y terminal actuales, puede detectar pendientes, completados o fallidos, y decide si hace seguimiento o pasa a una acción correctiva documentada aparte.