Ver ajustes TPV
Consulta en modo lectura la configuración TPV de Marea Gran Via: ajustes generales, facturación, terminales, credenciales, métodos de pago, plantillas e impresoras, sin guardar cambios.
En este artículo
Los ajustes TPV permiten revisar cómo opera una ubicación antes del servicio: acceso del personal, comportamiento del TPV, KDS, imágenes de producto, modo rápido, facturación y preferencias por terminal.
Esta guía documenta una consulta de solo lectura. Crear recursos, abrir formularios de edición o pulsar Guardar cambios pertenece a acciones de gestión separadas.
Antes de empezar
- Sesión iniciada con Grupo Marea Demo y la ubicación Marea Gran Via seleccionadas.
- Permiso `tpv:view` o `tpv:manage` en la ubicación para entrar en la pantalla completa de ajustes TPV.
- Para capturas ES, usar el runtime demo con `ORG_ID`, `LOCATION_ID`, `TPV_TERMINAL_ID`, `TPV_PAYMENT_METHOD_ID`, `TPV_OUTPUT_DEVICE_ID` y `TPV_BILLING_DETAILS_TITLE`.
- No usar una cuenta solo KDS como ejemplo principal: ese acceso puede leer una respuesta recortada del endpoint, pero no representa la pantalla completa `location/tpv`.
Instrucciones
- 1.
Abrir Ajustes TPV
En Marea Gran Via, entra en `location/tpv`. La pantalla carga la configuración TPV de la ubicación actual y abre la pestaña General cuando no se indica otro `tab`.
- 2.
Revisar General
Comprueba el modo de acceso de empleados, las opciones de comportamiento, KDS, imágenes de producto, modo rápido y marca activa si aplica.
- 3.
Consultar Facturación
Abre `location/tpv?tab=billing` para revisar datos fiscales, series y configuración fiscal o Verifactu leídas desde `billing_config`.
- 4.
Comprobar Terminales y Credenciales
Usa `terminals` y `staff-credentials` para revisar terminales TPV, credenciales de personal y alcance por terminal, por ejemplo con Marta Ruiz en el demo ES.
- 5.
Revisar Pagos por Terminal
Abre `payment-methods` para consultar métodos de pago y preferencias de métodos rápidos por terminal sin modificar `payment_methods`.
- 6.
Revisar Impresión y Salidas
Abre `printing` para plantillas de impresión y `printers` para impresoras, salidas y preferencias por terminal.
- 7.
Cerrar sin Guardar
Sal de la pantalla o cambia de sección sin pulsar Guardar cambios. La acción solo confirma el estado existente.
Validaciones y límites
- Si faltan organización o ubicación seleccionadas, la pantalla pide seleccionar una ubicación para configurar el TPV.
- Sin `tpv:view` ni `tpv:manage`, la pantalla muestra un error de permisos.
- La lectura usa `GET /api/app/{orgId}/{locationId}/tpv-settings` y no envía payload.
- Si no existe fila en `tpv_settings`, se presentan valores por defecto sin crear una fila nueva.
- Si `employee_access_mode` llega vacío, se presenta como `selector`.
- Los JSON vacíos se normalizan como arrays vacíos para métodos y preferencias, y como `{}` para `billing_config`.
- Una pestaña no reconocida vuelve a General; `location/tpv?tab=brands` redirige a la pantalla separada de marcas virtuales.
- Guardar cambios exige `tpv:manage` y queda fuera de esta acción de vista.
- Las capturas de esta guía no deben abrir formularios de edición, crear recursos ni cambiar controles.
Resultado esperado
El responsable confirma la configuración TPV y fiscal vigente de Marea Gran Via, incluidas preferencias por terminal, sin modificar `tpv_settings` ni recursos asociados.