Mensagem de transação (dados de propriedade)

Informações gerais

A mensagem da transação de ARI (dados da propriedade) define as informações sobre os tipos de quarto e pacotes (ou planos de tarifa) de cada propriedade. Cada dado de tipo de quarto inclui um identificador exclusivo (RoomID), nome localizado, descrição e URLs para fotos de quarto. Cada dado do pacote inclui um identificador exclusivo (PackageID), nome localizado, descrição, ocupação e valores agregados.

Você pode usar uma Mensagem de transação para fazer o seguinte:

• Defina dados para uma ou mais propriedades.
• Defina as informações do tipo de quarto e do pacote para cada propriedade.
• Controlar ofertas de produtos.

Além disso, você pode definir ações para:

• Adicione um tipo de quarto e um pacote a uma propriedade.
• Remover um tipo de quarto e um pacote de uma propriedade.

Para ver exemplos de mensagens de transação, consulte Exemplos de transações (dados de propriedade).

Elementos obrigatórios e opcionais

A referência XML fornece descrições dos elementos obrigatórios e opcionais. Para detalhes sobre atributos e elementos filhos, consulte Elementos e atributos da transação (dados da propriedade).

Sintaxe e esquemas

Use o exemplo de sintaxe de transação (dados de propriedade) como referência ao criar a Mensagem de transação para garantir que você esteja seguindo o formato correto.

Você pode usar uma ferramenta XML de terceiros, como xmllint, para validar seus feeds com os esquemas publicados antes de enviá-los ao Google. Para o esquema de Mensagens de transação, consulte Esquemas de Anúncios de hotéis.

Diretrizes

Use as seguintes diretrizes para uma Mensagem de transação:

Ações:

delta: use para adicionar ou atualizar novos tipos de quarto e pacotes (planos de tarifa).

overlay: use para substituir todos os tipos de quarto e pacotes de uma propriedade por um novo conjunto. É preciso incluir informações sobre todos os tipos de quarto e planos de tarifa que você ainda quer vender.

Suporte de linguagem:

Especifique um ou dois idiomas (inglês e um idioma local para a propriedade, se necessário) para os campos "Nome", "Descrição" e "Legenda". É possível adicionar mais de dois idiomas, se necessário.

Tipos de quarto e pacotes:

Ao atualizar um tipo de quarto ou pacote, você precisa enviar todas as informações relacionadas a esse tipo de quarto ou pacote. Por exemplo, ao adicionar uma foto, você também precisa incluir o nome e a descrição.

<AllowablePackageIDs> e <AllowableRoomIDs> são opcionais e, se não forem definidos, qualquer combinação de tipo de quarto e plano de tarifa poderá ser feita. Você ainda precisa enviar a disponibilidade e as diárias com o tipo de quarto e os IDs do plano de tarifa. Esses elementos permitem controlar produtos e desativar combinações que não são mais compatíveis com seu sistema.

Envie ao Google uma atualização de Mensagens de transação sempre que houver uma mudança nos tipos de quarto ou pacotes ou detalhes importantes sobre tipos de quarto ou pacotes que precisam ser adicionados.

Observação :como o Google armazena dados de propriedades conectados a uma propriedade "correspondente", não será possível aceitar esses dados até que a propriedade correspondente seja "correspondida" no sistema. O envio de todas as suas propriedades no feed de lista pode ajudar a evitar erros ou atrasos futuros.

Exemplo

Nesta seção, mostramos um exemplo básico de uma mensagem de transação ARI usando elementos obrigatórios e opcionais. Para adicionar ou atualizar tipos de quarto e pacotes, use uma ação para delta adicionar ou atualizar tipos e pacotes de quarto ou para overlay para substituir todas as definições de tipo de quarto e pacote (exclui entradas antigas).

É necessário especificar de um a dois idiomas (inglês e um idioma local para a propriedade, se necessário) para os campos "Nome", "Descrição" e "Legenda". Em seguida, adicione informações dos dados da propriedade, incluindo links para fotos.

Para os planos <PropertyID> e <RoomID>, use os mesmos IDs utilizados no sistema para planos de tarifa e tipos de quarto, respectivamente. A consistência com seu sistema é fundamental para garantir que o Google exiba corretamente seus preços e dados.

Observação: o Google usa "ID" para indicar o tipo de quarto e o pacote (plano de tarifa). Já o XML das OTAs usa "código". Use seus próprios IDs, já que o Google não os gera. Para dados da propriedade, o tipo de quarto e os IDs do plano de tarifa precisam ser exclusivos por propriedade.

Depois de preparar seu arquivo, é necessário enviá-lo ao Google por uma mensagem POST para o seguinte endpoint: https://www.google.com/travel/hotels/uploads/property_data

Para saber mais sobre como enviar/POSTar a mensagem, consulte Como enviar mensagens.

O exemplo a seguir mostra como definir a Mensagem de transação usando uma ação delta:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

Para ver mais exemplos, por exemplo, como usar a ação overlay, adicionar um tipo de quarto e um pacote aos dados da propriedade e remover tipos e pacotes de quarto existentes, consulte Exemplos de transação (dados de propriedade).

Tutoriais

Esta seção fornece soluções para cenários que você pode encontrar ao enviar Mensagens de transação.

Cenário 1: como remover dados de tipo de quarto

Como removo os dados do tipo de quarto e/ou pacote existentes?

Descrição

Você enviou vários tipos de quarto, incluindo king e queen, para a propriedade. Todos os tipos de quarto queen size estão indisponíveis durante uma reforma, e apenas os tipos de quarto king estão disponíveis no momento.

Solução

• Não é necessário atualizar a disponibilidade, as tarifas ou o inventário por noite para o tipo de quarto e os IDs de pacote que foram removidos ou desativados.
• Se o tipo de quarto ou pacote tiver sido removido ou desativado, envie uma nova Mensagem de transação com action="overlay", que inclua somente os tipos de quarto e os pacotes que ainda estão ativos e exclui o tipo de quarto ou pacote removido.

Exemplo

Este snippet XML mostra como usar a ação overlay para remover um tipo de quarto.

Observação: embora este exemplo abranja o tipo de quarto, você também pode usar a mesma ação para remover os dados do pacote.

Esta é a ação original de delta, que inclui os tipos de quarto king e queen:

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
      </PackageData>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

Você pode definir overlay para remover o tipo de quarto queen e manter o de quarto king:

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>

Cenário 2: como controlar produtos usando AllowablePackageIDs

Como faço para controlar produtos (combinações de tipos de quarto e pacotes) quando os pacotes estão agrupados por tipo de quarto?

Observação: se os tipos de quarto estiverem agrupados por pacote, consulte o Cenário 3.

Descrição

Alguns pacotes só estão disponíveis para determinados tipos de quarto. Por exemplo, se a propriedade tem quatro tipos de quarto (incluindo suíte presidencial) e seis pacotes diferentes, mas apenas alguns pacotes estão qualificados para a suíte presidencial, você pode especificar a qualificação.

Solução

Enviar uma Mensagem de transação atualizada que especifique quais produtos estão incluídos no pacote usando <AllowablePackageIDs>.

Observação: use <AllowablePackageIDs> ou <AllowableRoomIDs>, mas não ambos. O elemento usado depende se o sistema usa a hierarquia room>package ou package>room. Se nenhum desses elementos estiver definido na Mensagem de transação, os tipos de quarto poderão ser combinados com qualquer pacote.

Exemplo

Este snippet XML mostra como usar <AllowablePackageIDs> para especificar pacotes usados com um determinado tipo de quarto. Aqui, o tipo de quarto de suíte na cobertura aceita apenas o pacote com tudo incluído ou de café da manhã gratuito. Já o tipo de quarto rei permite apenas o pacote all-inclusive king ou o pacote que permite animais de estimação.

<RoomData>
  <RoomID>penthouse_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
    <AllowablePackageID>free_breakfast</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
  <RoomID>king_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>king_all_inclusive</AllowablePackageID>
    <AllowablePackageID>pet_friendly</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
  <PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>pet_friendly</PackageID>
</PackageData>

Observação: se você usar <AllowablePackageIDs> ou <AllowableRoomIDs> para desativar uma combinação que já tenha sido usada, mas que agora não está mais permitida no sistema, não vai ser necessário reenviar o ARI para todas as datas apenas para remover os dados anteriores.

Cenário 3: como controlar produtos usando AllowableRoomIDs

Como controlo os produtos (combinações de tipos de quarto e pacotes) quando os tipos de quarto estão agrupados por pacote?

Observação: se os pacotes estiverem agrupados por tipo de quarto, consulte o Cenário 2.

Descrição

Uma combinação de tipo de quarto e pacote não é mais vendida como um produto ou você quer controlar o que está incluído em um novo pacote. Por exemplo, se você quiser especificar apenas determinados tipos de quarto, como quartos king e queen com vista para o mar, com um pacote.

Solução

Envie uma Mensagem de transação atualizada que especifique os produtos exatos incluídos no pacote usando o elemento <AllowableRoomIDs>.

Exemplo

Este snippet XML mostra como usar <AllowableRoomID> para especificar os tipos de quarto king e queen com vista para o mar no pacote.

<PackageID>RO</PackageID>
<AllowableRoomIDs>
  <AllowableRoomID>king_oceanview</AllowableRoomID>
  <AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>