Completar trabajo de salida
Permite cerrar en la cola un trabajo de salida existente del TPV, como una impresión, una salida KDS o un procesamiento local del terminal. En el uso manual, el operador entra en Cola de impresión y KDS y marca el job como impreso; en el runtime local, el terminal puede completarlo automáticamente después de procesarlo.
En este artículo
Usa esta guía cuando una salida del TPV o KDS ya se ha procesado y el equipo necesita dejarla cerrada en la cola del servicio activo.
El completado actualiza un `tpv_output_job` existente a `completed`. No crea trabajos nuevos, no confirma físicamente que una impresora haya impreso y respeta el alcance del terminal seleccionado.
Antes de empezar
- Organización y ubicación activas, por ejemplo Grupo Marea Demo y Marea Gran Via.
- TPV abierto con sesión de servicio activa y terminal seleccionado.
- Si la configuración exige acceso por empleado, un empleado seleccionado, por ejemplo Marta Ruiz.
- Permiso para abrir la cola desde TPV: `tpv:print` o `tpv:manage`.
- Un `tpv_output_job` visible para la sesión, ubicación y terminal actuales.
- Para el completado automático, un `tpv_terminal` activo y un `tpv_output_device` activo con adaptador compatible.
Instrucciones
- 1.
Abrir el TPV del servicio activo
Entra en el TPV de Marea Gran Via con el terminal de trabajo. Si aparece el selector de empleado, selecciona Marta Ruiz u otro empleado operativo antes de continuar.
- 2.
Abrir Cola de impresión y KDS
Desde Más acciones del TPV, abre Cola de impresión y KDS. La lista se carga para la sesión de servicio activa y se refresca mientras la pantalla está enfocada.
- 3.
Elegir el trabajo correcto
Localiza la fila de la salida que se acaba de procesar o revisar. Los jobs no fallidos y no completados muestran Marcar impreso; los completados ya no ofrecen esa acción y los fallidos muestran Reintentar.
- 4.
Marcar como impreso
Pulsa Marcar impreso. La aplicación actualiza el trabajo existente con `status: "completed"` y conserva el terminal seleccionado o el terminal ya asociado al job.
- 5.
Confirmar el resultado
Después de la actualización, la app muestra Trabajo de salida actualizado. y refresca la cola. La fila completada deja de ofrecer Marcar impreso.
- 6.
Reconocer el completado automático
En TPV o KDS, el runtime local puede reclamar jobs pendientes y completarlos tras ejecutar un adaptador compatible. En KDS, este recorrido se limita a trabajos `job_kind == kds` de la sesión activa y del terminal seleccionado.
Validaciones y límites
- Cola de impresión y KDS no se muestra en TPV si el usuario solo tiene `tpv:use`, aunque la API pueda aceptar ese permiso.
- Si se envía `terminal_id`, debe pertenecer a la ubicación actual.
- Si el usuario opera solo con permisos KDS, solo puede actualizar jobs cuyo `job_kind` sea `kds`.
- El runtime local no procesa jobs `completed`, `cancelled` o `failed`.
- No documentar `allowed_terminal_ids` del dispositivo como validación de completado; este flujo no lo usa como guard de completion.
- No prometer una matriz estricta de transiciones: el backend acepta cualquier `status` válido.
Resultado esperado
El `tpv_output_job` queda en estado `completed`. Si `completed_at` estaba vacío, se registra en ese momento; si ya existía, se conserva.