Antylogic
Probar demoAcceso app

399 guías operativas

Secciones de Docs
DocsTPV y cobros
Dispositivo

Actualizar ajustes generales del TPV

Guarda los ajustes operativos generales del TPV de Marea Gran Via: comportamiento visual, cuenta rápida, KDS, acceso de empleado y marca POS activa, sin mezclarlo con la configuración específica por terminal de impresoras o métodos de pago.

En este artículo

Usa esta guía cuando un responsable de TPV necesite ajustar cómo se comporta el TPV de una ubicación antes del servicio. En Grupo Marea Demo, el ejemplo se documenta sobre Marea Gran Via.

El guardado usa el registro compartido `tpv_settings`: desde la pantalla se envía un snapshot amplio para conservar ajustes existentes, aunque esta guía se centra solo en los ajustes generales, el acceso de empleado, KDS y la marca POS.

Antes de empezar

  • Tener seleccionada la organización Grupo Marea Demo y la ubicación Marea Gran Via.
  • La pantalla debe poder cargar `GET /api/app/{orgId}/{locationId}/tpv-settings`; si no hay registro previo, Antylogic muestra valores por defecto.
  • Contar con permiso de ubicación `tpv:manage` para editar y guardar. Con solo `tpv:view`, la pantalla puede consultarse pero no mutarse.
  • Para elegir `Marca POS`, el usuario debe poder ver marcas virtuales disponibles para la ubicación.

Instrucciones

  1. 1.

    Abrir los ajustes TPV

    Entra en `location/tpv`. La pestaña General carga la configuración actual de Marea Gran Via y muestra los controles operativos principales del TPV.

  2. 2.

    Ajustar el comportamiento general

    Revisa `Mostrar imágenes de producto`, `Cuenta rápida` y `Habilitar KDS`. Cada cambio deja el formulario pendiente de guardar.

  3. 3.

    Configurar el acceso de empleado

    Abre `location/tpv?tab=staff-credentials` para elegir cómo se identifica el personal en el TPV: `selector`, `pin`, `card` o `disabled`.

  4. 4.

    Seleccionar la marca POS

    Abre `location/brands` y usa el selector `Marca POS`. La lista se limita a las marcas virtuales cargadas para el usuario y la ubicación.

  5. 5.

    Guardar cambios

    Pulsa `Guardar cambios` cuando haya modificaciones pendientes. Antylogic envía el snapshot de `tpv_settings` a `PUT /api/app/{orgId}/{locationId}/tpv-settings`.

  6. 6.

    Comprobar el resultado

    Tras guardar, la pantalla se rehidrata con la respuesta, desaparece el estado pendiente y se muestra la confirmación. Revisa General, Credenciales de empleado o Marca POS según el cambio realizado.

Validaciones y límites

  • Sin ubicación seleccionada, la pantalla pide seleccionar una ubicación y no ejecuta guardados.
  • `tpv:manage` es obligatorio para guardar; `tpv:view` permite consulta, pero no mutación.
  • `employee_access_mode` vacío se normaliza a `selector`; solo se aceptan `selector`, `pin`, `card` y `disabled`.
  • Si se desactiva KDS y había una salida de cocina de tipo KDS seleccionada, la interfaz limpia esa selección antes de guardar.
  • El backend valida estructura JSON y referencias a terminales, métodos de pago y dispositivos de salida cuando viajan en el snapshot compartido.
  • La pantalla actual gestiona métodos rápidos e impresoras por terminal en sus pestañas específicas, no mediante selectores globales independientes en esta acción.
  • La asignación de marca POS se limita en frontend a marcas disponibles, pero no debe afirmarse una validación backend de pertenencia de `brand_id` no observada.

Resultado esperado

Marea Gran Via queda con sus ajustes generales de TPV guardados: comportamiento operativo, KDS, modo de acceso de empleado y marca POS activa quedan disponibles para la operación del servicio.

Artículos relacionados