Eliminar dispositivo de salida
Retira definitivamente una impresora, salida de cocina, control o pantalla KDS desde la pestaña Impresoras y salidas de la configuración TPV de la ubicación activa.
En este artículo
Los dispositivos de salida conectan el TPV con impresoras, cocina, control y KDS. Esta guía explica cómo retirar uno desde la tabla de Impresoras y salidas sin tocar el resto de la configuración del local.
El ejemplo está localizado en Grupo Marea Demo, con Marea Gran Via como ubicación activa. Es una acción destructiva: el registro se borra, no hay restauración documentada y las referencias por defecto quedan limpias si apuntaban al dispositivo eliminado.
Antes de empezar
- Sesión iniciada en Grupo Marea Demo con Marea Gran Via como ubicación activa.
- Permiso `tpv:manage` en scope `location`; sin este permiso la acción Eliminar no aparece en la tabla y el backend rechaza el borrado.
- Debe existir el dispositivo de salida que se quiere retirar dentro de la ubicación activa.
- Para capturas o pruebas destructivas, usar solo el runtime documental ES con `cleanup_after_run`.
Instrucciones
- 1.
Abrir Impresoras y salidas
Entra en la configuración TPV del local y abre la pestaña Impresoras y salidas. La tabla muestra los dispositivos disponibles para tickets, cocina, control o KDS.
- 2.
Iniciar la eliminación
Localiza el dispositivo que se va a retirar y usa la acción de fila Eliminar. La aplicación guarda ese dispositivo como candidato y abre una confirmación antes de ejecutar el borrado.
- 3.
Confirmar el borrado
En el modal Eliminar recurso, revisa que el nombre corresponde al dispositivo esperado y pulsa Eliminar. La aplicación envía `DELETE /api/app/{orgId}/{locationId}/tpv-output-devices/{id}` sin payload.
- 4.
Comprobar la lista actualizada
Tras la respuesta correcta, el modal se cierra, aparece el aviso de éxito y la tabla se refresca sin el dispositivo eliminado. Si el dispositivo estaba configurado como salida por defecto, esas referencias quedan vacías; los trabajos históricos de salida no se borran.
Validaciones y límites
- La acción Eliminar solo debe estar visible para usuarios con `tpv:manage`.
- Si se pulsa Cancelar o se cierra el modal, no se llama al endpoint y no se elimina nada.
- El borrado correcto devuelve `204 No Content`.
- Si falta el id, falta `locationId` o el dispositivo pertenece a otra ubicación, la operación se trata como no encontrada.
- El borrado no se bloquea por estar asignado como salida por defecto o por tener trabajos históricos; esas referencias se limpian o quedan a `NULL` según corresponda.
- El borrado es físico sobre `tpv_output_devices`; no se observó `deleted_at` ni flujo de restauración.
Resultado esperado
El dispositivo de salida deja de aparecer en Impresoras y salidas, los ajustes TPV relacionados se refrescan y el local queda sin referencias activas al dispositivo retirado.