Turnos de caja

Un turno de caja es un turno: un período con nombre y con un responsable, al
que se atribuye cada pieza de efectivo que pase mientras está abierto.

Todo lo que hace el módulo existe para producir una cifra: lo que el sistema
esperaba menos lo que la persona contó. No es un registro de movimientos con un
arqueo atornillado encima; es un arqueo, y los movimientos existen para que el
arqueo se pueda calcular.

Vocabulario

Término	Qué es
Fondo inicial	Lo que ya estaba físicamente en la caja al abrir, declarado por moneda. Una declaración, no un ingreso — no mueve dinero, solo dice dónde empieza el conteo.
Esperado	Fondo inicial + efectivo que entró − efectivo que salió. Lo que debería haber en la caja.
Contado	Lo que la persona contó de verdad.
Diferencia	Contado − esperado. Negativo significa que falta dinero, positivo que sobra. Las dos merecen explicación.
Movimiento	Cualquier entrada o salida de efectivo atribuida al turno: un pago de reserva, un gasto, o un movimiento manual de caja.
Movimiento manual	Entrada o salida de efectivo sin una reserva detrás — una ida al banco, un fondo agregado desde la caja fuerte. Tiene que decir qué fue: una categoría, o una cuenta contraparte.
Efectivo sin asignar	Efectivo registrado sin un turno detrás. Llega por la External API, por integraciones o por seeders.
Adoptar	Jalar efectivo sin asignar al turno abierto propio, para que el arqueo lo espere.

Las reglas que le dan forma a todo

El arqueo es a ciegas. El campo donde va el monto contado arranca vacío,
nunca prellenado con la cifra esperada. Un campo prellenado convierte un arqueo
en un "aceptar", y el número deja de significar nada.

Una diferencia distinta de cero hay que explicarla. Las notas de cierre pasan
de opcionales a obligatorias en el momento en que aparece una discrepancia, por
pequeña que sea. Sin explicación, la diferencia es un número que nadie puede
interpretar tres meses después.

Un turno cerrado es un registro firmado. No se edita — ni el arqueo, ni los
movimientos contados adentro. Una corrección a un turno cerrado es siempre un
movimiento nuevo, nunca una edición del pasado.

Solo se cuenta el efectivo. Los pagos con tarjeta y transferencia aparecen,
pero aparte y en gris: no pueden salir caminando de la caja, así que no se
cuentan ni se concilian.

Un turno abierto por persona, no por propiedad

Cada usuario puede tener un turno abierto en toda la cuenta. No uno por
propiedad — uno.

Así que si uno abrió su turno en una propiedad y después cambió el selector de
propiedad a otra, sigue viendo su turno, con un aviso que dice dónde está abierto
realmente. Se puede operar y cerrar desde donde uno esté. La caja física está en
la otra propiedad, y decirlo es justamente el punto del aviso.

El fondo inicial lee los movimientos

Con qué abre un turno sale del dinero que efectivamente está ahí, no de un valor
por defecto configurado. Entre dos turnos, el efectivo no se desvanece ni se
reinicia calladamente — una declaración ausente no es lo mismo que 0.00.

Qué monedas aparecen

Las filas que se ofrecen al abrir un turno son la moneda por defecto de la
propiedad más toda moneda para la que el hotel haya cotizado una tasa alguna
vez. Ofrecer los ~150 códigos ISO convertiría abrir la caja en una búsqueda, y
el 99% de los turnos usa una o dos. El catálogo completo sigue disponible detrás
de un selector de "agregar otra moneda", para el huésped que pagó en algo que
nadie esperaba.

En la API

Merchant: /api/merchant/cash-sessions — abrir, leer el turno en curso,
registrar movimientos, cerrar con los montos contados, y el historial con sus
diferencias por moneda. El efectivo sin asignar tiene su propia bandeja y una
acción de adoptar.

Relacionado

Finanzas y movimientos — dónde aterrizan los movimientos del turno y su ajuste de cierre.
Pagos y saldo — la mayoría de los movimientos de un turno empiezan acá.
Monedas — por qué un turno cuenta por moneda y nunca suma.