Cash register

Para qué sirve y para quién

Caja controla el efectivo del cajón por turnos. Se abre una sesión con el fondo que hay en el cajón; durante el turno, los cobros, las anulaciones y las devoluciones de Ventas aparecen solos, y las entradas y salidas de efectivo (cambio traído de la caja fuerte, un pago a un proveedor, una retirada al banco) se apuntan a mano; se cuenta el cajón por billetes y monedas, y al cerrar se compara lo que debería haber (esperado) con lo que se ha contado: la diferencia queda guardada para siempre. Sirve igual a la peluquería y al restaurante.

Quién la usa:

• El empleado que hace de cajero: abre, apunta, cuenta y cierra.
• El responsable: lo mismo y, además, ve el efectivo esperado aunque el arqueo sea ciego.
• El propietario y el administrador: todo, y además configuran la caja y dan de alta los cajones.

Caja no cobra (es de Ventas), no abre el cajón físico (lo hará Impresión) y no factura.

Referencia adoptada

ERPlora no inventa flujos: adopta los que el mercado ya probó.

• Toast — revisión de turno: al cerrar se enseña lo que queda abierto y se avisa sin impedir el cierre; el cajón se cierra al corte del día de negocio (04:00 de fábrica) si nadie lo cerró; el cierre ciego, con un permiso que deja ver el esperado al supervisor.
• Lightspeed — lista de comprobación del turno: apertura con fondo, entradas y salidas, recuento ciego y cierre por turno.
• Square (gestión del cajón): «esperado en el cajón» visible durante el turno, entradas y salidas con motivo, informe del cajón por sesión con el desglose por forma de pago; informe parcial (X) y de cierre (Z).
• Odoo, Shopify POS, Loyverse y Lightspeed Retail: con el control de caja encendido, no se cobra en efectivo sin una sesión abierta; la pantalla de apertura se pone delante del TPV.
• Del mercado en general: el cajón es solo efectivo (la tarjeta no cuenta para el esperado), un turno cerrado no se reabre, y lo que se corrige después se corrige con otro movimiento en el turno abierto, nunca reescribiendo el cerrado.

Antes de empezar

• Ventas se enciende con Caja y no se puede apagar mientras Caja esté encendida: los cobros, las anulaciones y las devoluciones del turno son los de Ventas.
• Ajustes: los de fábrica valen desde el primer día (recuento obligatorio al cerrar, sin saldo negativo, sin arqueo ciego, sin cierre automático). Se cambian en Caja → Ajustes.
• Cajones: opcionales. Si el negocio tiene varios (barra y terraza), se dan de alta en Caja → Ajustes → Cajones; al abrir la sesión se elige uno. Con uno solo se elige solo.
• Moneda: la del negocio (hoy, el euro). El arqueo enseña sus billetes y monedas.
• Zona horaria: la del negocio. En esta fase, la hora de Madrid (Europe/Madrid) para todos: de ella salen el día de negocio, el número de sesión y la hora del cierre automático.

Configuración inicial, paso a paso:

1. Como administrador, abre Caja → Ajustes, decide fondo obligatorio, recuento obligatorio, saldo negativo, arqueo ciego y cierre automático, y pulsa «Guardar» (CASH_REGISTER-F01).
2. Si tienes varios cajones, dalos de alta en la misma pantalla (CASH_REGISTER-F02).
3. En Caja, pulsa «Abrir sesión» y abre con el fondo real (CASH_REGISTER-F03).
4. Cobra una venta pequeña en efectivo en Ventas → Vender y comprueba en Caja que el esperado sube.

Pantallas

Caja

Menú Caja. Arriba, el título «Caja» y el botón «Abrir sesión» (apagado mientras haya una sesión abierta: «Ya hay una sesión de caja abierta. Ciérrala antes de abrir otra.»). Debajo, la tabla de sesiones, de la más reciente a la más antigua, 50 por página: Sesión, Abierta el, Estado («Abierta», «Cerrada»), Apertura, Esperado, Contado, Diferencia. Buscador «Buscar sesión…» (por número), filtros (estado, número y los cuatro importes) y vista de tabla o tarjetas. Por fila: «Detalle» siempre y, en la sesión abierta, «Movimiento», «Arqueo» y «Cerrar»; tocar la fila abre el detalle. Cada acción abre su ventana:

• Abrir sesión de caja: «Cajón» (opcional; solo si hay cajones), «Fondo de apertura», «Notas», «Abrir sesión» y «Cancelar».
• Movimiento de caja · S-…: «Tipo» («Entrada» o «Salida»), «Importe», «Concepto», «Registrar» y «Cancelar».
• Arqueo de caja · S-…: «Tipo de arqueo» («Cierre» de fábrica, o «Apertura»), «Notas», una casilla por billete y por moneda bajo «Billetes» y «Monedas» y «Total contado» en vivo; sin tabla para la moneda, un solo campo «Total contado». «Registrar arqueo» y «Cancelar».
• Cerrar sesión · S-…: la revisión del turno, «Esperado en el cajón» y «Diferencia» en vivo (si quien cierra puede verlos), «Efectivo contado», «Notas de cierre», «Cerrar sesión» y «Cancelar».

El éxito sale como aviso verde («Sesión abierta», «Movimiento de entrada registrado (…)», «Arqueo registrado · total contado …», «Sesión S-… cerrada · esperado … · contado … · diferencia …»); un rechazo, dentro de la ventana, con las palabras del servidor y el campo marcado. Vacía: «Sin sesiones de caja.». Cargando: «Cargando…». Error al cargar: el mensaje en la tabla con «Reintentar».

Encima de la tabla pueden salir dos avisos:

• «Cobros fuera de turno»: cuántas líneas de venta (cobros, anulaciones, devoluciones) y cuánto efectivo no entraron en ningún turno, con «Ver» para su lista (CASH_REGISTER-F17).
• «La sesión S-… debía cerrarse sola a las 04:00»: el cierre automático está encendido y la sesión sigue abierta de un día anterior; «Abrir sesión» se enciende y, al abrir, la vieja se cierra sola (CASH_REGISTER-F10). Esa sesión ya no admite movimientos, arqueos ni cierre: en su fila solo queda «Detalle».

Detalle de la sesión

Desde Caja, «Detalle» o tocar una fila: se abre como página, con su flecha de volver. Título «Detalle de la sesión · S-…». Un resumen en dos columnas: Estado, Cajón, Abierta (cuándo y quién), Cerrada (cuándo y quién, o «Cerrada sola»), Movimientos (cuántos), Fondo de apertura, Ventas (todas las formas de pago) y, debajo, Ventas en efectivo, Ventas con tarjeta y Ventas con otras formas de pago (esta solo si hubo), Devoluciones, Entradas, Salidas, Invitaciones, Esperado, Contado y Diferencia, y las notas de apertura y de cierre. En una sesión abierta Contado y Diferencia salen «—». Debajo, dos tablas, de lo más reciente a lo más antiguo, 50 por página y en tarjetas en el móvil: Movimientos (Cuándo, Tipo, Importe con su signo, Método, Concepto) y Arqueos (Cuándo, Tipo de arqueo, Total contado, Notas). Vacías: «Sin movimientos en esta sesión.» y «Sin arqueos en esta sesión.». El botón «Imprimir» saca el informe en papel: «Informe parcial (X)» si la sesión está abierta, «Cierre de caja (Z)» si está cerrada (CASH_REGISTER-F16).

Ajustes de Caja

Menú Caja → Ajustes. Una tarjeta «Caja» con «Activar caja», «Exigir fondo de apertura», «Exigir recuento al cierre», «Permitir saldo negativo», «Arqueo ciego», «Cierre automático diario» y «Hora del cierre automático» (de 00:00 a 23:00, en horas en punto), y «Guardar». Debajo, la tarjeta «Cajones»: la lista de cajones (nombre, activo) con «Añadir cajón», «Cambiar nombre» y «Desactivar»/«Activar». Quien no puede cambiar los ajustes los ve bloqueados con «No tienes permiso para cambiar estos ajustes.». Cargando: «Cargando ajustes…». Error: «No se pudieron cargar los ajustes.» con «Reintentar»; al guardar, «No se pudieron guardar los ajustes.». Guardado: «Ajustes guardados.».

Flujos

CASH_REGISTER-F01 Configurar cómo funciona la caja

Estado: hecho Vertical: común Actor: administrador Pantalla: Ajustes de Caja Pasos: 1. Abre Caja → Ajustes. 2. Enciende o apaga «Activar caja», «Exigir fondo de apertura», «Exigir recuento al cierre», «Permitir saldo negativo», «Arqueo ciego» y «Cierre automático diario» con su hora. 3. Pulsa «Guardar». Se guarda lo que cambiaste; lo demás queda como estaba. 4. Sale «Ajustes guardados.» y, desde ese momento, el servidor aplica el fondo obligatorio (F03), el recuento obligatorio (F09), el saldo negativo (F05), el arqueo ciego (F07) y el cierre automático (F10), venga la orden de la pantalla, del asistente o de la API. Entra: las decisiones del administrador. Sale: los ajustes de caja del negocio, una sola fila (avisa: cash_register.settings.updated). Sin guardar nunca, valen los de fábrica. Si falla: «No se pudieron guardar los ajustes.» con el motivo, y los ajustes quedan como estaban. Si la lectura falla, la pantalla no enseña valores (nunca los de fábrica como si fueran los del negocio) y ofrece «Reintentar». Sin el permiso de ajustes, los campos salen bloqueados y no hay «Guardar». Implicados: CASH_REGISTER-F03, F05, F07, F09, F10

CASH_REGISTER-F02 Dar de alta, renombrar y desactivar un cajón

Estado: hecho Vertical: común Actor: administrador, asistente Pantalla: Ajustes de Caja Pasos: 1. En Caja → Ajustes → Cajones, pulsa «Añadir cajón», escribe su nombre («Barra») y pulsa «Guardar»; o pídeselo al asistente («crea un cajón llamado Barra»). 2. Para cambiarle el nombre, pulsa «Cambiar nombre»; para dejar de usarlo, «Desactivar». 3. El cajón activo aparece en «Cajón» al abrir la caja. Entra: el nombre del cajón. Sale: el cajón (avisa: cash_register.register.created o cash_register.register.updated). Un cajón nunca se borra: las sesiones lo nombran. Si falla: sin nombre, «Escribe el nombre del cajón.»; con un nombre que ya tiene otro cajón (sin distinguir mayúsculas), «Ya hay un cajón con ese nombre.». Implicados: CASH_REGISTER-F03

CASH_REGISTER-F03 Abrir el turno de caja con el fondo inicial

Estado: hecho Vertical: común Actor: empleado, responsable, administrador, asistente Pantalla: Caja Pasos: 1. En Caja, pulsa «Abrir sesión». 2. Elige el «Cajón» si hay varios (con uno solo se elige solo), escribe el «Fondo de apertura» tal como se lee («150,50»; vacío es 0) y, si quieres, «Notas». 3. Pulsa «Abrir sesión». 4. Sale «Sesión abierta»; la sesión aparece arriba de la tabla como «Abierta», con su número S-AAMMDD-NNNN (correlativo del día de negocio, lo pone el sistema) y «Abrir sesión» se apaga. Entra: cajón, fondo y notas; los ajustes del negocio. Sale: la sesión abierta, a nombre de quien la abre (avisa: cash_register.session.opened). El fondo cuenta para el esperado desde ese momento. Si falla: «Ya hay una sesión de caja abierta. Ciérrala antes de abrir otra.» (una por negocio, sea cual sea el cajón; si dos dispositivos abren a la vez, solo uno abre y el otro recibe este aviso); con el fondo obligatorio y el fondo vacío o a cero, «Este negocio exige fondo de apertura: indica el efectivo con el que empieza la caja.» bajo el campo; un cajón desactivado o que no existe, «Ese cajón no está disponible.»; un importe ilegible («Esto no es un importe. Escribe una cifra, por ejemplo 12,50.»), negativo o ambiguo («1.250») se para antes de enviar. Implicados: CASH_REGISTER-F04, F09

CASH_REGISTER-F04 Vender solo con la caja abierta

Estado: hecho — lo aplica Ventas al cobrar (SALE-F08): pregunta a Caja si la caja está abierta (ver «Contrato con Ventas»). Lo que se cobra en efectivo sin turno porque Caja estaba apagada o no respondió sale en «Cobros fuera de turno» (F17), sin perder nada. Vertical: común Actor: empleado, sistema Pantalla: Vender (de Ventas) Pasos: 1. Con «Activar caja» encendido y sin sesión abierta, el cajero intenta cobrar en efectivo. 2. Ventas lo rechaza con «La caja está cerrada: abre una sesión de caja para cobrar en efectivo.» (409 sale.cash_register_closed); con tarjeta, transferencia u otro cobra. Una sesión abierta pasada su corte (F10) sigue dejando cobrar: lo cobrado sale en F17. Entra: «Activar caja» y si hay sesión abierta (cash_register.session.current). Sale: nada propio. Si falla: si Caja no responde, Ventas cobra (el bloqueo cede antes que parar las ventas) y el cobro aparece en F17. Implicados: SALE-F08

CASH_REGISTER-F05 Registrar una entrada o una salida de efectivo

Estado: hecho Vertical: común Actor: empleado, responsable, administrador, asistente Pantalla: Caja Pasos: 1. En la fila de la sesión abierta, pulsa «Movimiento». 2. Elige «Entrada» (cambio traído de la caja fuerte) o «Salida» (pago a un proveedor, retirada al banco), escribe el «Importe» en positivo y el «Concepto». 3. Pulsa «Registrar». 4. Sale «Movimiento de entrada registrado (…)» o «Movimiento de salida registrado (…)»; en el detalle aparece el movimiento (la salida en negativo) y el esperado sube o baja. Entra: tipo, importe y concepto. Desde la pantalla el medio es siempre efectivo; el asistente o la API pueden apuntar también tarjeta, transferencia u otro, que salen en la lista y en «Entradas» o «Salidas» pero no cuentan para el esperado. Sale: el movimiento, a nombre de quien lo apunta (avisa: cash_register.movement.added). El signo lo pone el sistema según el tipo. Si falla: «Esta salida dejaría la caja en negativo y el saldo negativo no está permitido.» si los ajustes no lo permiten; un importe cero, ilegible o negativo se para antes de enviar; la sesión cerrada en otro dispositivo: «Esa caja está cerrada: una caja cerrada no acepta movimientos nuevos.». Un movimiento equivocado no se edita ni se borra: se apunta el contrario con un concepto que diga por qué. Implicados: ninguno

CASH_REGISTER-F06 Contar el cajón por billetes y monedas

Estado: hecho Vertical: común Actor: empleado, responsable, administrador Pantalla: Caja Pasos: 1. En la fila de la sesión abierta, pulsa «Arqueo». 2. Deja «Cierre» (al final del turno) o elige «Apertura» (para comprobar el fondo); escribe cuántos hay de cada billete y moneda; «Total contado» se va sumando. Sin tabla para la moneda, escribe el total. 3. Pulsa «Registrar arqueo». 4. Sale «Arqueo registrado · total contado …» y el arqueo aparece en el detalle. Si era de «Cierre», se abre directamente «Cerrar sesión» con «Efectivo contado» ya puesto (F09); el arqueo no cierra nada por sí solo. Entra: las cantidades por billete y moneda, o el total. Sale: el arqueo con su desglose (avisa: cash_register.count.added). El total lo suma el sistema con los decimales de la moneda; un total escrito a mano (o enviado por la API) se guarda tal cual y prevalece sobre el desglose. Si falla: una sesión cerrada, «Esa caja está cerrada: una caja cerrada no acepta movimientos nuevos.»; un billete o moneda que no es de la moneda del negocio, bajo el desglose; sin desglose ni total, «Cuenta el cajón: indica los billetes y monedas o el total.». Implicados: CASH_REGISTER-F09

CASH_REGISTER-F07 Contar a ciegas: quién ve el efectivo esperado

Estado: hecho Vertical: común Actor: administrador, responsable, empleado Pantalla: Caja, Detalle de la sesión Pasos: 1. El administrador enciende «Arqueo ciego» y guarda (F01). 2. Durante el turno, en la sesión abierta, el empleado ve vacía la columna Esperado; en el detalle ve el fondo y «—» en Esperado, Ventas, Devoluciones, Entradas, Salidas e Invitaciones, y en la lista de movimientos solo las entradas y salidas apuntadas a mano: ni las ventas, ni las anulaciones, ni las devoluciones, así que no hay con qué sumar el esperado (Square y Lightspeed ocultan igual el esperado en el cierre ciego). El responsable, el propietario y el administrador lo ven todo: la tabla, el detalle, la lista y la ventana de cierre. 3. El cajero cuenta (F06) y cierra (F09) sin ver el esperado. 4. Al cerrar aparecen esperado, contado y diferencia para todos. Entra: el ajuste «Arqueo ciego» y el permiso de ver el esperado (responsable, propietario y administrador). Sale: nada nuevo; cambia lo que ve cada uno. La regla del saldo negativo sigue funcionando con el esperado real. Si falla: nada propio. Implicados: CASH_REGISTER-F09

CASH_REGISTER-F08 Revisar lo que queda pendiente antes de cerrar

Estado: parcial — mira las cuentas abiertas de Ventas; las comandas sin servir de Cocina y las impresiones pendientes llegarán con esas apps Vertical: común Actor: empleado, responsable, administrador Pantalla: Caja Pasos: 1. Al abrir «Cerrar sesión» sale «Comprobando lo que queda pendiente…». 2. Si hay cuentas abiertas en Ventas, sale «Revisión del turno» con «Cuentas abiertas: N» y sus títulos. Sin nada pendiente no sale nada. 3. El primer «Cerrar sesión» no cierra: avisa «El turno se cerrará igualmente. Pulsa otra vez para confirmar.» y el botón pasa a «Cerrar de todos modos». 4. El segundo clic cierra (F09). Entra: las cuentas abiertas de Ventas (sale.order.list). Sale: nada; avisa, nunca impide. Si falla: si la lectura no se puede hacer, «No se ha podido comprobar lo que queda pendiente, así que esta revisión puede estar incompleta.» y se cierra con un solo clic. Implicados: SALE-F17, SALE-F18

CASH_REGISTER-F09 Cerrar el turno: esperado, contado y diferencia

Estado: hecho Vertical: común Actor: empleado, responsable, administrador, asistente Pantalla: Caja Pasos: 1. En la fila de la sesión abierta, pulsa «Cerrar» (o llega desde un arqueo de «Cierre», F06). 2. Escribe o revisa el «Efectivo contado» (viene del último arqueo de cierre de esa sesión; nunca de uno de apertura); si puedes ver el esperado, «Esperado en el cajón» y «Diferencia» se ven mientras escribes. Añade «Notas de cierre» si quieres. 3. Pulsa «Cerrar sesión» (dos veces si la revisión del turno avisó, F08). 4. Sale «Sesión S-… cerrada · esperado … · contado … · diferencia …»; la fila pasa a «Cerrada» con los tres importes fijos para siempre y «Abrir sesión» vuelve a encenderse. Entra: el efectivo contado y las notas. Sale: la sesión cerrada con esperado (fondo + ventas y entradas en efectivo − salidas, devoluciones y anulaciones en efectivo; lo cobrado o apuntado con tarjeta, transferencia u otro no cuenta), contado y diferencia (contado − esperado: positiva sobra, negativa falta), a nombre de quien cierra (avisa: cash_register.session.closed). Las líneas de Ventas del turno quedan copiadas en la sesión: lo que pase después (una anulación de ayer) va al turno abierto, nunca a este. Si falla: «Escribe el efectivo contado para cerrar la sesión.» con el campo vacío (la pantalla siempre lo pide; el ajuste de recuento obligatorio lo hace cumplir también al asistente y a la API); si otro dispositivo la cerró antes, «Esa caja está cerrada: una caja cerrada no acepta movimientos nuevos.» (dos cierres a la vez: uno cierra, el otro recibe este aviso). No se reabre una sesión cerrada por error: se abre otra con el efectivo real como fondo. Implicados: CASH_REGISTER-F06, F08

CASH_REGISTER-F10 Cerrar sola la caja olvidada al final del día

Estado: hecho — el cierre se aplica al abrir la siguiente sesión y el pase cada 5 minutos lo corre el worker (base/scheduler.py, 2026-10-15; en la fase 1, sobre un solo hub, WORKER_SCOPE_SLUG) Vertical: común Actor: sistema Pantalla: ninguna Pasos: 1. El administrador enciende «Cierre automático diario» y elige la hora (04:00 de fábrica). 2. Cada 5 minutos el Hub mira si ya pasó el último corte en la hora del negocio y cierra la sesión que siga abierta desde antes de ese corte; la abierta después del corte no se toca. Un Hub parado durante el corte la cierra en cuanto vuelve, y quien abre la caja por la mañana también: la vieja se cierra sola antes de abrir la nueva. 3. En Caja la sesión aparece «Cerrada», con «Cerrada sola» en el detalle, su esperado al corte y Contado y Diferencia vacíos. Entra: el ajuste, la hora y la zona horaria del negocio. Sale: la sesión cerrada a la hora del corte, sin recuento y sin persona (avisa: cash_register.session.closed una vez por sesión). Mientras sigue abierta pasado el corte, sus cifras se paran en el corte y lo cobrado después ya sale como «Cobros fuera de turno» (F17), también en la ventana de abrir la siguiente, para contarlo en su fondo; nunca entra en la vieja ni en la nueva. Si falla: con el ajuste apagado no cierra nada. Una sesión pasada su corte no admite movimientos, arqueos ni cierre: «La sesión S-… debía cerrarse sola a las 04:00: abre una sesión nueva (esta se cierra entonces).» (409 cash_register.session_auto_close_due). Implicados: CASH_REGISTER-F17

CASH_REGISTER-F11 Consultar una sesión y revisar un descuadre

Estado: hecho Vertical: común Actor: responsable, administrador, empleado Pantalla: Detalle de la sesión Pasos: 1. En Caja, pulsa «Detalle» o toca la fila de cualquier sesión, abierta o cerrada. 2. Lee el resumen: quién abrió y cerró, el cajón, el fondo, las ventas por forma de pago, devoluciones, entradas, salidas, invitaciones aparte (son coste, no efectivo), esperado, contado, diferencia y las notas. 3. Repasa Movimientos: cada venta se nombra por su documento («Tique …», «Factura …»), una devolución «Devolución de …» y una anulación «Anulación de …»; un movimiento a mano enseña su concepto. Y repasa Arqueos. 4. Pulsa «Volver». Entra: la sesión elegida; el número y el documento de cada venta, de Ventas. Sale: nada; es de solo lectura. Si falla: «No se pudo cargar el detalle de la sesión» o el error de cada tabla con «Reintentar». Implicados: SALE-F28

CASH_REGISTER-F12 Ver la caja en los paneles del inicio

Estado: no hecho — el inicio del Hub es la rejilla de apps y todavía no tiene paneles; las consultas existen (cash_register.session.current para «Caja (sesión actual)» y cash_register.session.list cerradas, por fecha de cierre, para «Descuadres recientes») Vertical: común Actor: responsable, administrador, empleado Pantalla: Paneles del inicio Pasos: 1. En el Inicio, «Caja (sesión actual)» enseña el efectivo esperado de la sesión abierta y «Descuadres recientes», la diferencia de las ocho últimas sesiones cerradas. Entra: la sesión abierta y las cerradas. Sale: nada. Si falla: lo dirá el inicio. Implicados: ninguno

CASH_REGISTER-F13 Anotar en la caja cada cobro de una venta

Estado: hecho Vertical: común Actor: sistema Pantalla: Caja, Detalle de la sesión Pasos: 1. El cajero cobra en Ventas → Vender. 2. Sin que nadie teclee nada, la sesión abierta recibe una línea «Venta» por cada forma de pago del cobro: con pago mixto, una en efectivo y otra con tarjeta. 3. Cada línea lleva lo que esa forma de pago cubrió, no lo entregado: el cambio ya salió del cajón. 4. Solo las de efectivo suben el esperado; las de tarjeta, transferencia u otro salen en la lista y en «Ventas con tarjeta» o «Ventas con otras formas de pago». El coste de las invitaciones va aparte, una vez por venta, a «Invitaciones». Entra: los cobros de Ventas (venta, sus formas de pago con su tipo e importe, y el coste de las invitaciones). Sale: la línea en la sesión abierta, al momento (la pantalla se refresca sola con el aviso sale.sale.completed). Una venta de total cero sin invitaciones no deja nada; una toda invitación deja una línea de importe cero con su coste. Si falla: sin sesión abierta, el cobro no se pierde: sale en F17. Implicados: SALE-F01, SALE-F02, SALE-F03, SALE-F15

CASH_REGISTER-F14 Compensar en la caja una venta anulada

Estado: hecho Vertical: común Actor: sistema Pantalla: Caja, Detalle de la sesión Pasos: 1. Alguien anula en Ventas una venta ya cobrada. 2. La sesión abierta en ese momento recibe una «Anulación de …» por cada forma de pago de la venta; la de efectivo baja el esperado. La línea de la venta no se toca. 3. Va siempre al turno abierto al anular, aunque la venta sea de un turno ya cerrado: el cerrado no se mueve. Anulada en el mismo turno, la venta y su anulación se compensan y no cuentan. Entra: la venta anulada y cuándo se anuló (sale.sale.voided). Sale: la línea de anulación. Cada anulación se anota una sola vez. Si falla: sin sesión abierta, la anulación sale en F17. Anular no corrige nada fiscal: el tique sigue emitido (SALE-F30). Implicados: SALE-F30

CASH_REGISTER-F15 Anotar en la caja una devolución

Estado: hecho Vertical: común Actor: sistema Pantalla: Caja, Detalle de la sesión Pasos: 1. Alguien hace en Ventas una devolución, total o parcial, de una venta de hoy o de otro día. 2. La sesión abierta recibe una «Devolución de …» por cada forma de pago por la que vuelve el dinero. 3. Manda por dónde vuelve el dinero, no cómo se cobró: una venta con tarjeta devuelta en efectivo baja el esperado; una en efectivo devuelta a la tarjeta no lo toca. Entra: la devolución con sus formas de pago e importes (sale.sale.refunded). Sale: la línea de devolución. Cada forma de pago de cada devolución se anota una sola vez. Si falla: sin sesión abierta, la devolución sale en F17. Implicados: SALE-F31

CASH_REGISTER-F16 Imprimir el informe de la sesión (X o Z)

Estado: hecho Vertical: común Actor: responsable, administrador, empleado Pantalla: Detalle de la sesión Pasos: 1. En el detalle de una sesión, pulsa «Imprimir». 2. Sale el diálogo de impresión del navegador con el informe: número de sesión, cajón, quién y cuándo abrió y cerró, el fondo, las ventas por forma de pago, devoluciones, entradas, salidas, invitaciones, esperado, contado, diferencia y notas. Con la sesión abierta es el «Informe parcial (X)»; cerrada, el «Cierre de caja (Z)». Entra: el resumen de la sesión, el mismo que enseña la pantalla. Sale: el papel. Si falla: «No se pudo imprimir.»; con el arqueo ciego, el empleado no puede imprimir el esperado de una sesión abierta (sale «—»). Implicados: CASH_REGISTER-F11

CASH_REGISTER-F17 Ver los cobros fuera de turno

Estado: hecho Vertical: común Actor: empleado, responsable, administrador Pantalla: Caja Pasos: 1. En Caja sale «Cobros fuera de turno: N líneas de venta no entraron en ninguna sesión · … en efectivo» cuando alguna línea de Ventas no cayó en ningún turno: - con la caja cerrada: lo cobrado, anulado o devuelto desde el último turno sin sesión abierta; - con una sesión olvidada pasado su corte (F10): lo de después del corte; - con una sesión abierta: las rezagadas del turno anterior, confirmadas mientras se cerraba (su Z ya no las recoge). 2. Pulsa «Ver» para ver la lista (cuándo, tipo, importe, método y documento). 3. Al abrir la sesión, cuenta ese efectivo en el fondo: ya está en el cajón (la ventana de abrir lo recuerda). Entra: los cobros, anulaciones y devoluciones de Ventas que no cayeron en ninguna sesión. Sale: nada; avisa. Con «Activar caja» apagado no hay turnos que cumplir y no avisa. Si falla: nada propio. Implicados: CASH_REGISTER-F04, F10, F13

Servicios: lo que entra y lo que sale

Todo se puede pedir por las pantallas, el asistente (por voz o por texto, con la sesión de la propia persona) y la API, con las mismas reglas y los mismos permisos. Pensado para la voz: una sesión se nombra por su número («S-261014-0001») y, si no se dice cuál, se entiende la abierta («cierra la caja», «apunta una salida de 20 €»); un cajón, por su nombre.

Lo que ofrece: consultas (leen, no cambian nada)

Todas se pueden seguir en vivo.

Lo que ofrece: acciones (cambian datos)

Lo que avisa

A qué reacciona

A nada: no necesita avisos de nadie. Las líneas de Ventas las lee de Ventas, que es su requisito, en el momento en que se miran; las pantallas se refrescan con sale.sale.completed, sale.sale.voided y sale.sale.refunded.

Lo que necesita de otras apps

• Ventas (requisito): los cobros (Sale, SalePayment), las anulaciones (la venta anulada y cuándo) y las devoluciones (Refund, RefundPayment), leídos de sus modelos; las cuentas abiertas para la revisión del turno (sale.order.list).
• Índices de Ventas para estas lecturas (hecho, sale/0005_cash_register_indexes): parciales en sale_sale(voided_at) y sale_refund(created_at), para que las lecturas por ventana de tiempo de anulaciones y devoluciones no recorran la tabla entera.

Contrato con Ventas (CASH_REGISTER-F04)

Caja no puede tocar Ventas, y Ventas no requiere Caja (sería un ciclo). El bloqueo de cobrar en efectivo con la caja cerrada lo hace Ventas así (hecho; _check_drawer de apps/sale/services.py, probado contra esta app en tests/test_integration_sale.py):

1. Antes de cobrar con un medio de tipo efectivo, Ventas llama a la operación cash_register.session.current por su nombre (live.operations.get; CLAUDE.md «Apps»: operaciones de otra app por nombre, con su permiso y su app activa), con la sesión de quien cobra.
2. Si la respuesta trae required: true y session: null, rechaza el cobro con 409 sale.cash_register_closed («La caja está cerrada: abre una sesión de caja para cobrar en efectivo.»). Solo el efectivo: tarjeta, transferencia y otros cobran siempre.
3. Si Caja está apagada en el Hub o la llamada falla, Ventas cobra igual (el bloqueo cede antes que parar las ventas).
4. La pantalla Vender no se sustituye: el rechazo se lee en el cobro, con un botón que lleva a Caja a abrir la sesión.

Lo que dice Ventas de esto está en su WORKBOOK (SALE-F08). Lo que se cobra en efectivo sin turno porque Caja estaba apagada o no respondió se ve en CASH_REGISTER-F17.

Quién la usa

Quién puede qué

Los papeles llegan del SaaS con prefijo (hub_owner, hub_admin, hub_manager, hub_employee); el cajero del producto actual es un empleado.