Cómo gestionar dispositivos de salida del TPV
Consulta, crea y edita las salidas del TPV de una ubicación: impresoras de tickets, cocina, control y pantallas KDS, con permisos por usuario y conexión calculada desde el driver.
En este artículo
Los dispositivos de salida definen a dónde envía el TPV cada ticket, comanda o pantalla operativa. En Antylogic se gestionan por ubicación, de modo que Marea Gran Via puede mantener sus propias impresoras y salidas sin afectar a otros locales del grupo.
Este flujo cubre la consulta, el alta y la edición. No incluye el borrado de dispositivos ni el cambio de impresoras por defecto de los ajustes TPV, aunque al guardar se refrescan esas dependencias para que los selectores usen datos actualizados.
Antes de empezar
- Sesión iniciada con Grupo Marea Demo y la ubicación Marea Gran Via seleccionada.
- Permiso de ubicación `tpv:view` o `tpv:manage` para abrir la pantalla de gestión del TPV.
- Permiso `tpv:manage` para crear, editar y guardar dispositivos de salida.
- Permiso `users:view` o `users:manage` si necesitas cambiar el campo Usuarios con acceso.
- Para capturas localizadas, usar `TPV_OUTPUT_DEVICE_ID=54dd2977-dec3-4a8a-a81b-c25ae22bd78c`.
Instrucciones
- 1.
Abre Impresoras y salidas
Entra en la configuración de TPV de la ubicación y abre la pestaña Impresoras. La pantalla carga los dispositivos de salida de la ubicación activa y los ordena por nombre.
- 2.
Revisa la tabla de dispositivos
Comprueba cada fila por nombre, código, tipo de driver, transporte, usuarios permitidos y estado. Si Usuarios con acceso está vacío, la salida queda disponible para todos los usuarios de la ubicación.
- 3.
Crea o edita una salida
Pulsa Nuevo dispositivo para iniciar un alta o abre Editar desde una fila existente. En edición se cargan los datos guardados; en alta se parte de una impresora de tickets activa con driver `escpos`.
- 4.
Completa los datos generales
Rellena Nombre, Código, Tipo, Estado y Usuarios con acceso. Si no tienes permisos de usuarios, el selector queda bloqueado y conserva los usuarios ya guardados.
- 5.
Configura conexión y driver
Revisa el transporte calculado por la app. Los drivers de red muestran el campo IP y lo exigen antes de guardar; si el driver es `zpl`, la sección de driver muestra dimensiones numéricas para la etiqueta.
- 6.
Guarda el dispositivo
Usa Crear en un alta o Guardar en una edición. La app valida los campos, envía el cambio a la API de la ubicación, refresca la lista y los ajustes TPV relacionados, muestra confirmación y vuelve a la pantalla anterior.
Validaciones y límites
- `name` es obligatorio en la app y en la API.
- `code` se normaliza y debe ser único dentro de la ubicación.
- Los tipos de dispositivo admitidos son `receipt_printer`, `kitchen_printer`, `control_printer` y `kds`.
- Los drivers admitidos son `escpos`, `escpos_matrix`, `star_graphic`, `star_prnt`, `zpl`, `usb`, `usb_android` y `kds`.
- La app deriva el transporte: red TCP para drivers de red, `usb` para USB, `usb_android` para Android USB y `none` para KDS.
- `allowed_user_ids` vacío significa que la salida queda disponible para todos los usuarios de la ubicación.
- Sin `tpv:manage`, el formulario queda en solo lectura y no ejecuta guardado.
- Sin `users:view` o `users:manage`, no se puede cambiar la restricción de Usuarios con acceso desde la UI.
- La UI actual no muestra selector de `terminal_id` ni editores JSON para claves extra de `connection_config` o `driver_config`.
- El borrado de dispositivos pertenece a la acción `tpv.output-device.delete` y no forma parte de este flujo.
Resultado esperado
El dispositivo de salida queda guardado en `tpv_output_devices` para la ubicación activa. La lista y los ajustes TPV se refrescan, y la salida queda disponible para los tickets, cocina, control o KDS según su tipo, estado y usuarios permitidos.