Propriétés

Ce qu’est une propriété dans l’API PMS Tatallo, champ par champ.

Une propriété est un lieu qu’un hôte propose sur Tatallo : un appartement, une maison, un hôtel. Via l’API PMS Tatallo, votre PMS ne voit que les propriétés que vos hôtes y ont connectées.

Une propriété n’est pas nécessairement une chambre ni une unité. Une maison est un seul lieu, tandis qu’un hôtel compte de nombreuses chambres sous une seule propriété. L’API PMS Tatallo v1 n’expose pas encore les unités (voir la feuille de route) : ne faites donc correspondre une propriété qu’à l’annonce concernée dans votre PMS, et ne supposez pas une granularité que Tatallo n’a pas promise.

​

Champs

Champ	Type	Signification
id	UUID	Identifiant opaque et permanent de la propriété. Enregistrez-le une fois dans votre table de correspondance : son sens ne change jamais, même lorsque Tatallo ajoute des fonctionnalités. C’est un identifiant, pas un secret : le connaître n’accorde aucun droit.
name	string	Le nom de la propriété sur Tatallo, pour vous aider à confirmer que vous faites correspondre la bonne annonce.
timezone	string ou null	Le fuseau horaire IANA de la propriété, par exemple Europe/Rome. Interprétez les dates de séjour et les heures de check-in dans ce fuseau. Il vaut null uniquement tant que la propriété est pending.
status	active, inactive ou pending	Indique si la propriété peut être vendue (ci-dessous).
country	string	Le pays de la propriété, indiqué par son nom.
city	string	La ville de la propriété.
max_guests	integer	Le nombre maximal de voyageurs que la propriété peut héberger.
currency	string	La devise de la propriété, au format ISO 4217 (par exemple EUR).
updated_at	string	Date du dernier changement de la propriété, au format ISO 8601 en UTC.

Rien d’autre concernant une propriété n’est partagé. En particulier, l’API n’expose jamais son adresse, ses coordonnées géographiques, ses prix, son règlement intérieur ni les coordonnées de l’hôte.

​

Statut

status	Signification
active	En ligne sur Tatallo : les voyageurs peuvent la réserver.
inactive	Suspendue : les voyageurs ne peuvent pas la réserver pour le moment.
pending	Pas encore en ligne : la mise en place est en cours.

De nouveaux statuts ne sont jamais ajoutés en silence : une modification de cette liste suit la politique de versions de /v1.

​

Quelles propriétés vous voyez

Une propriété n’est visible pour votre identifiant PMS qu’une fois que son hôte a connecté cette propriété à votre PMS. Une propriété qui n’est pas connectée, qui a été retirée ou qui n’a jamais existé répond 404 property_not_found, de la même façon dans tous les cas. Lorsqu’un hôte déconnecte une propriété, ou met en pause sa connexion à votre PMS, elle disparaît de votre liste et répond 404 dès la requête suivante.