Propiedades

Qué es una propiedad en la API PMS de Tatallo, campo por campo.

Una propiedad es un lugar que un anfitrión ofrece en Tatallo: un apartamento, una casa, un hotel. A través de la API PMS de Tatallo, tu PMS solo ve las propiedades que tus anfitriones han conectado.

Una propiedad no es necesariamente una habitación o una unidad. Una casa es un lugar, mientras que un hotel tiene muchas habitaciones bajo una sola propiedad. La API PMS de Tatallo v1 aún no expone unidades (consulta la hoja de ruta), así que asigna una propiedad solo al anuncio de tu PMS al que corresponde, y no des por sentado un nivel de detalle que Tatallo no ha prometido.

​

Campos

Campo	Tipo	Significado
id	UUID	Identificador opaco y permanente de la propiedad. Guárdalo una vez en tu tabla de asignación: no cambia de significado aunque Tatallo añada funciones. Es un identificador, no una credencial: conocerlo no concede nada.
name	string	El nombre de la propiedad en Tatallo, para ayudarte a confirmar que estás asignando el anuncio correcto.
timezone	string o null	La zona horaria IANA de la propiedad, por ejemplo Europe/Rome. Interpreta las fechas de estancia y las horas de entrada en esa zona. Solo es null mientras la propiedad está pending.
status	active, inactive o pending	Si la propiedad puede venderse (más abajo).
country	string	El país de la propiedad, por nombre.
city	string	La ciudad de la propiedad.
max_guests	integer	El máximo de huéspedes que admite la propiedad.
currency	string	La moneda de la propiedad, ISO 4217 (por ejemplo EUR).
updated_at	string	Cuándo cambió la propiedad por última vez, ISO 8601 en UTC.

No se comparte nada más de una propiedad. En concreto, la API nunca expone su dirección, coordenadas, precios, normas de la casa ni los datos de contacto del anfitrión.

​

Estado

status	Significado
active	Publicada en Tatallo: los huéspedes pueden reservarla.
inactive	Suspendida: los huéspedes no pueden reservarla por ahora.
pending	Aún no publicada: sigue en configuración.

Nunca se añaden estados nuevos en silencio: un cambio en esta lista sigue la política de versiones de /v1.

​

Qué propiedades ves

Una propiedad es visible para tu credencial PMS solo cuando su anfitrión ha conectado esa propiedad a tu PMS. Una propiedad que no está conectada, que se eliminó o que nunca existió responde 404 property_not_found, igual en todos los casos. Cuando un anfitrión desconecta una propiedad, o pausa su conexión con tu PMS, desaparece de tu lista y responde 404 desde la siguiente solicitud.