Propriedades

O que é uma propriedade na API PMS Tatallo, campo a campo.

Uma propriedade é um alojamento que um anfitrião oferece na Tatallo: um apartamento, uma casa, um hotel. Através da API PMS Tatallo o seu PMS vê apenas as propriedades que os seus anfitriões ligaram a ele.

Uma propriedade não é necessariamente um quarto ou uma unidade. Uma casa é um só alojamento; um hotel tem muitos quartos numa propriedade. A API PMS Tatallo v1 ainda não expõe unidades (veja o roteiro), por isso mapeie uma propriedade apenas para o anúncio no seu PMS a que corresponde e não assuma uma granularidade que a Tatallo não prometeu.

​

Campos

Campo	Tipo	Significado
id	UUID	Identificador opaco e permanente da propriedade. Guarde-o uma vez na tabela de mapeamento: o significado nunca muda, mesmo quando a Tatallo acrescenta funcionalidades. É um identificador, não uma credencial: sabê-lo não concede nada.
name	string	Nome da propriedade na Tatallo, para confirmar que mapeia o anúncio certo.
timezone	string ou null	Fuso horário IANA da propriedade, por exemplo Europe/Rome. Interprete datas de estadia e horas de check-in nele. É null apenas enquanto a propriedade está pending.
status	active, inactive ou pending	Se a propriedade pode vender (abaixo).
country	string	País da propriedade, por nome.
city	string	Cidade da propriedade.
max_guests	integer	Número máximo de hóspedes que a propriedade acolhe.
currency	string	Moeda da propriedade, ISO 4217 (por exemplo EUR).
updated_at	string	Última alteração da propriedade, ISO 8601 em UTC.

Nada mais sobre a propriedade é partilhado. Em particular, a API nunca expõe morada, coordenadas, preços, regras da casa nem contactos do anfitrião.

​

Estado

status	Significado
active	Ativa na Tatallo: os hóspedes podem reservar.
inactive	Suspensa: os hóspedes não podem reservar por agora.
pending	Ainda não está ativa: em configuração.

Novos estados nunca são adicionados em silêncio: uma alteração a esta lista segue a política de versões de /v1.

​

Que propriedades vê

Uma propriedade só é visível para a sua credencial PMS depois de o respetivo anfitrião a ter ligado ao seu PMS. Uma propriedade não ligada, removida ou que nunca existiu responde 404 property_not_found, igual em todos os casos. Quando um anfitrião desliga uma propriedade ou coloca em pausa a ligação ao seu PMS, ela desaparece da lista e passa a responder 404 no pedido seguinte.