Finanzas y movimientos

Finanzas responde dos preguntas: dónde está el dinero y qué lo movió.

Un pago de reserva, un gasto, un ajuste de arqueo y una transferencia entre las
propias cuentas del hotel terminan todos como una fila del mismo libro. Ese libro
son los movimientos, y es el piso sobre el que se paran las demás funciones de
dinero.

Los movimientos explican el saldo

Si una cuenta muestra 2,645.00 USD, tiene que existir una lista de filas que
sume exactamente eso. Todo lo demás sale de tomarse eso en serio:

Las patas de una transferencia son filas. Mover 50 de la caja al banco
escribe dos movimientos — uno de salida, uno de entrada — y los dos se ven.
Esconderlos haría que el saldo de la caja bajara sin explicación.
Los ajustes de arqueo son filas. Cuando un turno cierra con discrepancia,
la diferencia se escribe como un movimiento. Eso es lo que mantiene el libro
igual a lo que hay físicamente en la caja.
Nada se borra. Una cuenta se desactiva, no se elimina, y se queda en la
lista con su saldo. Un turno cerrado no se edita. Las correcciones son
movimientos nuevos.

Cuentas

Término	Qué es
Cuenta	Dónde está el dinero: una caja, una cuenta bancaria, lo que retiene un canal, lo que retiene una pasarela de pago.
Tipo	`cash`, `bank`, `channel` o `gateway`. Decide qué asientos aterrizan ahí y por qué método.
Cuenta de sistema	La crea Axis Pro y no se renombra ni se desactiva — la lógica la resuelve por tipo y moneda. La caja es la visible.
Saldo en esta propiedad	Lo que la cuenta acumuló con los movimientos de la propiedad activa.
Saldo total	Lo mismo en toda la cuenta. Los saldos de las propiedades suman exactamente el total: nada se queda fuera y nada se cuenta dos veces.

La primera vez que un hotel abre la pantalla de cuentas ya existen algunas: una
cuenta de efectivo por cada moneda que haya usado la caja, y cuentas de canal o
de pasarela a medida que se conectan esos proveedores. Las cuentas bancarias son
las que crea el propio hotel.

Movimientos

Un movimiento — un asiento — es una fila: dirección, monto, moneda, método,
origen, fecha.

Campo	Valores
Categoría	Para qué era el dinero. Cada categoría está tipada como `expense` o `income`, y los formularios solo ofrecen el tipo que corresponde. Elegir el equivocado es un rechazo, no una curiosidad.
Origen	De dónde vino el asiento: `manual`, `gateway`, `channel`, o `ajuste de arqueo`.
Pata de transferencia	Una de las dos filas que escribe una transferencia. Comparten un identificador de grupo, que es por lo que se cancelan a nivel de propiedad.

El tipo de una categoría se puede corregir después. Borrarla le arrancaría la
etiqueta a todo lo ya registrado.

Cada moneda va por su lado

Los saldos y los totales son mapas por moneda, nunca cifras únicas. Nunca se
suman entre sí, y no hay un total consolidado — sumarlos requeriría elegir una
tasa y un momento, y esa no es decisión de un libro de movimientos. Ver
Monedas.

Qué no responden los movimientos

Los movimientos son un libro de caja. Su cifra neta es lo que entró menos lo
que salió. No es utilidad, y no es el ingreso del período.

"¿Cuánto ganamos?" es otra pregunta con otra respuesta: la vista devengada,
que publica cada cargo en la noche en que se dio el servicio y separa el impuesto
del neto.

Una estadía vendida en enero y pagada en marzo está en el devengado de enero
y en la caja de marzo. Ninguna de las dos está mal, y deliberadamente no hay
una línea de conciliación entre ellas — la brecha entre las dos en cualquier
ventana es el capital de trabajo del negocio, no un error que explicar en letra
chica.

Ninguno de los dos bloques es utilidad. Axis Pro registra el ingreso del
hotel y sus movimientos de dinero, no sus costos, así que de estos números no se
puede derivar un margen — intentarlo produciría una cifra que se ve correcta y no
lo es.

En la API

Merchant: /api/merchant/financial-accounts para cuentas y saldos, los
endpoints de transacciones para el libro y sus filtros, y
/api/merchant/financial-reports para los bloques devengado y de caja.
Todo campo de dinero es un string decimal; todo saldo es un mapa con el código
de moneda como llave.

Relacionado

Turnos de caja — la mitad de efectivo, por turno.
Pagos y saldo — lo que escribe la mayoría de estas filas.
Impuestos — de dónde sale la separación de impuesto del bloque devengado.