Cómo gestionar dispositivos de salida

En este artículo

Antes de empezar

• Trabajar con una sesión autenticada y con organización y ubicación resueltas; en el runtime ES, la ubicación de referencia es Marea Gran Via.
• Tener `tpv:view` o `tpv:manage` para ver la lista y el detalle del dispositivo.
• Tener `tpv:manage` para crear un dispositivo nuevo o guardar cambios.
• Para editar, partir de un dispositivo existente de la misma ubicación; el runtime ES aporta `TPV_OUTPUT_DEVICE_ID=54dd2977-dec3-4a8a-a81b-c25ae22bd78c`.
• Tener `users:view` o `users:manage` si se quiere usar el selector Usuarios con acceso para restringir la salida.

Instrucciones

1. 1.

   Abre la pestaña Impresoras

   Entra en los ajustes del TPV de la ubicación y abre `location/tpv?tab=printers`. La pantalla carga la tabla Impresoras y salidas cuando hay organización, ubicación y permisos suficientes.

2. 2.

   Revisa las salidas configuradas

   Comprueba nombre, código, tipo de controlador, transporte calculado, usuarios permitidos y estado activo. Si una salida no tiene usuarios asignados, queda disponible para todos los usuarios de la ubicación.

3. 3.

   Crea o abre un dispositivo

   Con `tpv:manage`, pulsa Nuevo dispositivo para alta o Editar sobre una fila existente. El alta parte de `receipt_printer`, `escpos`, activo y sin usuarios restringidos; la edición hidrata el formulario con los datos guardados.

4. 4.

   Completa los datos generales

   Rellena nombre, código, tipo de controlador y estado. El transporte no se edita manualmente: Antylogic lo muestra calculado según el controlador seleccionado.

5. 5.

   Define usuarios con acceso

   Deja Usuarios con acceso vacío si cualquier usuario de Marea Gran Via puede usar la salida. Selecciona usuarios concretos solo cuando la impresora o pantalla deba quedar restringida a un rol operativo, como cocina o barra.

6. 6.

   Configura la conexión

   Para controladores de red como ESC/POS, Star o ZPL, introduce la IP o el host de la impresora. Para `usb`, `usb_android` o `kds`, la sección Conexión no se muestra. Si eliges ZPL, completa los ajustes numéricos de etiqueta cuando aparezcan.

7. 7.

   Guarda y comprueba la lista

   Pulsa Crear o Guardar. Antylogic valida el formulario, guarda el dispositivo en la ubicación activa, refresca las listas y selectores dependientes, muestra confirmación y vuelve a la pantalla anterior.

Validaciones y límites

• El nombre es obligatorio en la UI y en backend.
• Crear o guardar cambios requiere `tpv:manage`; con solo lectura se puede consultar, pero no mutar.
• El controlador debe ser `escpos`, `escpos_matrix`, `star_graphic`, `star_prnt`, `zpl`, `usb`, `usb_android` o `kds`.
• El transporte se deriva del controlador: drivers de red a `network_tcp`, `usb` a `usb`, `usb_android` a `usb_android` y `kds` a `none`.
• Para controladores de red, la UI exige IP o host. Para ZPL, ancho, alto y margen izquierdo deben ser números válidos.
• `allowed_user_ids` solo acepta usuarios aceptados de la misma ubicación; vacío significa disponible para todos.
• La pantalla actual no muestra selector de `device_kind` ni `terminal_id`, aunque API y modelo los soportan. No documentar la creación completa de un KDS desde esta pantalla como flujo probado.
• La edición desde la UI envía el formulario completo; no debe tratarse como un PATCH parcial.
• Los permisos `kds:*` solo permiten lectura API limitada a dispositivos KDS y no habilitan creación ni edición en esta pantalla.
• El código se normaliza y debe ser único dentro de la ubicación.

Resultado esperado

El dispositivo queda guardado para la ubicación activa y vuelve a aparecer en Impresoras y salidas. Las listas y selectores de TPV se refrescan para que tickets, cocina, control o KDS puedan usar la salida según su configuración.