Antylogic
Probar demoAcceso app

399 guías operativas

Secciones de Docs
DocsTPV y caja
Dispositivo

Cómo abrir caja

Abre la caja del terminal actual dentro de un servicio TPV activo, registra el fondo inicial y deja la sesión lista para cobrar en efectivo con un esperado inicial trazable.

En este artículo

La apertura de caja se hace desde el TPV operativo del local. Antylogic vincula la caja al servicio abierto y al terminal actual, de modo que el fondo inicial y el esperado pertenecen a esa operación concreta.

Este flujo está pensado para responsables de sala, cajeros y encargados de turno que necesitan empezar el servicio con efectivo controlado antes de cerrar tickets.

Antes de empezar

  • Tener sesión iniciada con organización y ubicación activas en Marea Gran Via.
  • Tener permiso de ubicación `tpv:use`.
  • Tener un servicio TPV abierto en la ubicación, por ejemplo `Servicio de comidas Gran Via`.
  • Que la pantalla TPV pueda identificar el terminal actual.
  • Si el acceso de empleados requiere selección, tener seleccionado el empleado operativo, por ejemplo Marta Ruiz.
  • No tener ya una `cash_register_session` abierta para el mismo servicio y terminal.

Instrucciones

  1. 1.

    Abre el TPV del local

    Entra en el TPV de Marea Gran Via desde `${APP_DEEPLINK_BASE}${ORG_ID}/${LOCATION_ID}/tpv?tab=floor` y comprueba que el servicio está activo.

  2. 2.

    Entra en Caja

    Pulsa `Más acciones del TPV` y selecciona `Caja`. Si el terminal no tiene caja abierta, el panel muestra `Fondo inicial` y el botón `Abrir caja`.

  3. 3.

    Indica el fondo inicial

    Escribe el importe con el que empieza la caja. En el runtime español puedes usar coma decimal, por ejemplo `50,00`; la pantalla lo convierte a un importe con dos decimales.

  4. 4.

    Confirma la apertura

    Pulsa `Abrir caja`. Antylogic registra la caja contra el servicio activo, el terminal actual, el empleado seleccionado si existe y el fondo inicial.

  5. 5.

    Comprueba el estado abierto

    Tras el éxito, la pantalla muestra la caja abierta con `Fondo inicial`, `Esperado`, `Conteo final` y `Cerrar caja`. Al principio, si todavía no hay cobros en efectivo, el esperado coincide con el fondo inicial.

Validaciones y límites

  • Sin `tpv:use`, la pantalla no permite operar el TPV ni abrir caja.
  • Sin servicio activo, la interfaz muestra acciones para abrir servicio, no el panel de caja.
  • Si el terminal actual no se puede identificar, la pantalla muestra `No pudimos identificar el terminal actual.` y no continúa.
  • El fondo inicial debe ser numérico y mayor o igual que cero; la UI valida el importe y el backend lo vuelve a comprobar.
  • `terminal_id` es obligatorio y debe corresponder a un terminal válido de la ubicación o al terminal derivado del usuario actual.
  • No puede existir otra `cash_register_session` abierta para la misma combinación de servicio y terminal; si ya existe, el panel muestra el estado abierto en lugar del formulario de apertura.
  • Abrir caja no requiere `tpv:close-cash`; ese permiso pertenece al cierre de caja, no a la apertura.
  • Mientras haya una caja abierta, `Cerrar servicio` queda bloqueado hasta cerrar la caja.

Resultado esperado

Queda creada una `cash_register_session` con `status = "open"`, `opening_amount` redondeado y `expected_amount` inicial igual al fondo. La pantalla refresca la información de caja y el terminal queda listo para cobrar desde el TPV.

Artículos relacionados