Antylogic
Probar demoAcceso app

399 guías operativas

Secciones de Docs
DocsTPV
Dispositivo

Cómo gestionar terminales TPV

Consulta, crea y edita terminales TPV de una ubicación como Marea Gran Via, definiendo nombre, código, plataforma, dispositivo, versión, estado activo y capacidades técnicas en JSON.

En este artículo

Los terminales TPV representan los dispositivos desde los que el equipo opera cobros, impresiones locales y capacidades técnicas del punto de venta en una ubicación concreta.

Este flujo está pensado para responsables de sala, administradores de ubicación y soporte operativo que necesitan revisar o preparar un terminal sin tocar referencias de borrado ni otros ajustes TPV.

Antes de empezar

  • Tener seleccionadas la organización Grupo Marea Demo y la ubicación Marea Gran Via.
  • Contar con permiso de ubicación `tpv:manage` para crear o guardar cambios.
  • Para consultar desde la pantalla, contar con `tpv:view` o `tpv:manage`.
  • Para abrir el detalle existente del runtime ES, usar `TPV_TERMINAL_ID=279b8b87-20f7-40b5-b058-e39fa2ea520e`.
  • Si se edita `Capabilities JSON`, introducir un objeto JSON válido como `{}`; no usar arrays ni texto libre.

Instrucciones

  1. 1.

    Abre el terminal

    Entra en la pantalla de detalle de terminal dentro de la ubicación. Con `id` se cargan los datos existentes; sin `id` se abre `Nuevo terminal` con plataforma Android, estado activo y capacidades `{}`.

  2. 2.

    Revisa los datos principales

    Comprueba nombre, código, plataforma, nombre del dispositivo, versión de la app y estado activo. El nombre identifica el terminal para el equipo y el código se normaliza para uso interno.

  3. 3.

    Edita las capacidades técnicas

    Usa `Capabilities JSON` solo para capacidades técnicas del terminal. Si no hay capacidades específicas, deja `{}` para que el guardado mantenga un objeto vacío válido.

  4. 4.

    Guarda los cambios

    Pulsa `Crear` en modo alta o `Guardar` en edición. Antylogic asocia siempre el terminal a la ubicación actual, actualiza la lista y, en edición, refresca el detalle.

  5. 5.

    Entiende el listado disponible

    El listado de terminales puede combinar terminales persistidos con terminales derivados de usuarios-dispositivo con permisos TPV o KDS. Esta guía cubre consulta, alta y edición; el borrado pertenece a otra acción.

Validaciones y límites

  • `orgId` y `locationId` deben estar presentes en el contexto.
  • El nombre es obligatorio para crear o actualizar.
  • La plataforma persistida debe ser `ios`, `android`, `web`, `windows`, `macos` o `linux`.
  • `Capabilities JSON` debe ser un objeto JSON; arrays, JSON malformado o texto libre bloquean el guardado.
  • El botón de guardado solo queda activo con `tpv:manage` y cambios pendientes.
  • Un terminal de otra ubicación se trata como no encontrado.
  • El filtro `is_active` del listado debe ser booleano cuando se use.
  • La pantalla permite ver detalle solo con `tpv:view` o `tpv:manage`, aunque el backend acepta más permisos TPV/KDS para listado y detalle.

Resultado esperado

El terminal queda creado o actualizado dentro de la ubicación actual, con sus datos operativos y capacidades técnicas validados sin modificar referencias de borrado ni otros recursos TPV.

Artículos relacionados