Cómo se organiza Axis Pro

Casi todo objeto en Axis Pro pertenece a uno de tres niveles. Saber en qué nivel
vive una cosa responde la mayoría de las preguntas del tipo "¿por qué no veo
esto acá?" antes de tener que hacerlas.

Cuenta (tenant)
└── Propiedad       un hotel, hostal o edificio físico
    └── Unidad      un espacio rentable, o un tipo de espacios idénticos

Cuenta

La cuenta — tenant en la API — es la empresa hotelera. Es dueña de todo lo que
está debajo, y nada se comparte jamás entre cuentas.

Algunas cosas viven en este nivel a propósito, porque son propiedades de la
empresa y no de un edificio en particular:

• Huéspedes. El registro de un huésped se comparte entre todas las
  propiedades de la cuenta, así que un huésped que regresa es una persona, no
  una por hotel.
• Pares de tasas de cambio. Una tasa es propiedad del par de monedas, no de
  un edificio — una sola tabla sirve a una cuenta cuyos hoteles están en países
  distintos. Ver Monedas.
• Usuarios y sus roles. Una persona puede tener roles distintos en cuentas
  distintas.

Propiedad

Una propiedad es un lugar físico: un hotel, un hostal, un edificio de
apartamentos. Es el nivel al que está acotado casi todo el trabajo diario —
reservas, tarifas, Housekeeping, caja, reportes.

Tres campos de la propiedad pesan mucho más allá de su propia pantalla:

timezone — el reloj de la propiedad. Toda fecha que cargue dinero o
significado operativo se lee con él, nunca con el del servidor. La ventana de un
reporte, el día en que cae un pago, si la última noche de una estadía queda
dentro de un horizonte de reserva: todo eso se resuelve en la zona horaria de la
propiedad. Un hotel en Guatemala y uno en Chile cierran días distintos en el
mismo instante, y ese es justamente el punto.

default_currency — una semilla, no una restricción. Los planes tarifarios
nuevos la heredan cuando no se indica otra, pero un plan tarifario es libre de
usar otra moneda y nada obliga a que coincidan. Ver Monedas.

booking_code_prefix — de 2 a 5 caracteres con los que empieza todo código
de reserva de esta propiedad (CDB-000001). Lo fija un admin de plataforma, es
único dentro de la cuenta y queda bloqueado en el momento en que la propiedad
emite su primer código de reserva — reescribirlo partiría la historia de la
propiedad en dos series. Una propiedad retirada nunca devuelve su prefijo,
porque una propiedad nueva que lo reutilizara reiniciaría el contador en 1 y
chocaría con códigos ya entregados.

Las features son por propiedad

Los módulos se habilitan por propiedad, no por cuenta. Channel Manager y
check-in digital son los casos visibles: las dos propiedades de un hotel pueden
legítimamente tener habilitadas cosas distintas, y una feature apagada no
aparece en absoluto.

Unidad

Una unidad es lo que se vende y donde se duerme. Es también donde vive casi toda
la sutileza del modelado, porque una "unidad" puede ser una habitación física,
una casa entera con habitaciones adentro, o un tipo que representa a cuatro
habitaciones idénticas. Unidades es la página para eso.

Una unidad nunca tiene precio propio. Los precios pertenecen a los
planes tarifarios, que se enganchan a las unidades.

Qué significa esto para una integración

Dos headers cargan la jerarquía en las APIs del portal merchant: X-Tenant
nombra la cuenta y X-Property nombra la propiedad. En la
External API pública no se manda ninguno de los dos por esa
lógica — la API key es la cuenta, y X-Property se manda solo cuando la
key cubre más de una propiedad. Ver
Alcances y el header X-Property.