Proprietà

Che cosa è una proprietà nell’API PMS Tatallo, campo per campo.

Una proprietà è un luogo che un host offre su Tatallo: un appartamento, una casa, un hotel. Tramite l’API PMS Tatallo il tuo PMS vede solo le proprietà che i tuoi host hanno collegato.

Una proprietà non è necessariamente una camera o un’unità. Una casa è un solo luogo, mentre un hotel ha molte camere sotto un’unica proprietà. L’API PMS Tatallo v1 non espone ancora le unità (vedi la roadmap), quindi associa una proprietà solo all’annuncio del tuo PMS a cui corrisponde, e non dare per scontata una granularità che Tatallo non ha promesso.

​

Campi

Campo	Tipo	Significato
id	UUID	L’identificatore opaco e permanente della proprietà. Salvalo una volta nella tabella di corrispondenza: il suo significato non cambia, anche quando Tatallo aggiunge funzioni. È un identificatore, non una credenziale: conoscerlo non concede nulla.
name	string	Il nome della proprietà su Tatallo, per verificare che stai associando l’annuncio giusto.
timezone	string o null	Il fuso orario IANA della proprietà, per esempio Europe/Rome. Interpreta in quel fuso le date del soggiorno e gli orari di check-in. Vale null solo finché la proprietà è pending.
status	active, inactive o pending	Se la proprietà può essere venduta (sotto).
country	string	Il Paese della proprietà, per nome.
city	string	La città della proprietà.
max_guests	integer	Il numero massimo di ospiti che la proprietà può ospitare.
currency	string	La valuta della proprietà, ISO 4217 (per esempio EUR).
updated_at	string	Quando la proprietà è cambiata l’ultima volta, in ISO 8601 e UTC.

Nient’altro di una proprietà viene condiviso. In particolare, l’API non espone mai l’indirizzo, le coordinate, i prezzi, il regolamento della casa né i recapiti dell’host.

​

Stato

status	Significato
active	Online su Tatallo: gli ospiti possono prenotarla.
inactive	Sospesa: per ora gli ospiti non possono prenotarla.
pending	Non ancora online: è ancora in configurazione.

I nuovi stati non vengono mai aggiunti in silenzio: una modifica a questo elenco segue la politica di versionamento di /v1.

​

Quali proprietà vedi

Una proprietà è visibile alla tua credenziale PMS solo quando il suo host l’ha collegata al tuo PMS. Una proprietà non collegata, rimossa o mai esistita risponde 404 property_not_found, allo stesso modo in tutti i casi. Quando un host scollega una proprietà, o mette in pausa il collegamento con il tuo PMS, la proprietà sparisce dal tuo elenco e dalla richiesta successiva risponde 404.