Mensagem de inventário

Visão geral

A mensagem de inventário (OTA_HotelInvCountNotifRQ) define as contagens de inventário (número de quartos físicos) que estão disponíveis para reserva de tipos de quarto específicos. Ao enviar uma mensagem de inventário, você indica quantas salas desse tipo estão disponíveis em uma determinada data. Se não houver salas desse tipo disponíveis, os produtos que envolvem esse tipo de sala e data não serão exibidos.

As seções a seguir abordam diretrizes gerais, um exemplo básico e cenários de instruções para você começar a adicionar e atualizar o inventário e enviar mensagens de inventário.

Para exemplos de vários cenários relacionados ao inventário, consulte Tutoriais.

Elementos obrigatórios e opcionais

A referência XML fornece descrições dos elementos obrigatórios e opcionais. Para mais detalhes sobre atributos e elementos filhos, consulte Elementos e atributos de inventário.

Sintaxe e esquemas

Use o exemplo de sintaxe de inventário como referência ao criar a mensagem de inventário para garantir que você está 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 inventário, consulte Esquemas de anúncios de hotel.

Diretrizes

Use as seguintes diretrizes para uma mensagem de inventário:

• O inventário é identificado por hotel, data e tipo de quarto.

• A contagem de inventário precisa ser maior que 0 para todas as noites da estadia para mostrar o preço da tarifa e da ocupação associadas.

• Se a contagem de inventário for igual a 0, os quartos não estarão disponíveis para reserva no ID do quarto e período especificados.

• CountType precisa sempre ter o valor de 2 para ser válido, já que indica uma contagem de "disponibilidade definitiva".

• Envie o inventário atualizado sempre que houver uma reserva ou um cancelamento de um quarto no seu sistema.

Observação: envie as contagens de inventário de quartos usando OTA_HotelInvCountNotifRQ (método recomendado) ou o método alternativo com o atributo <BookingLimit> da mensagem OTA_HotelAvailNotifRQ.

Inventário x disponibilidade

O inventário é o número de quartos disponíveis para reserva com base na contagem física, e a disponibilidade indica se a combinação de tipo de quarto e plano de tarifa pode ser reservada. Para a ARI, a disponibilidade e o inventário podem variar com base em um conjunto de datas ou no tipo de acomodação, e ambos têm tipos de mensagens correspondentes. O inventário e a disponibilidade são identificados por hotel, data e tipo de quarto, além do plano de tarifa para disponibilidade.

Pode haver "nenhuma disponibilidade" mesmo quando há inventário, já que inventário e disponibilidade são independentes um do outro.

Há dois conceitos de disponibilidade. Primeiro, há a disponibilidade geral de um produto para uma determinada estadia, que é afetada por fatores como se todas as noites têm uma tarifa definida, o inventário para o tipo de quarto associado e se a restrição de disponibilidade está aberta. Em segundo lugar, há a restrição específica para um produto em uma determinada data, representada por <RestrictionStatus Restriction="Master" Status="Open"/> em OTA_HotelAvailNotifRQ, e o fechamento dessa disponibilidade é conhecido como "parar de vender".

O inventário precisa ser um número inteiro maior que 0 para o quarto, e a restrição de disponibilidade precisa estar aberta para mostrar o preço de um produto.

Observação: se um quarto estiver esgotado, nenhum plano de tarifa associado a ele poderá ser vendido.

Exemplo

Nesta seção, fornecemos um exemplo básico de uma mensagem de inventário usando elementos obrigatórios e opcionais. Depois de preparar o arquivo, envie-o ao Google com uma mensagem POST para este endpoint:

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

Para saber mais sobre como enviar/POST a mensagem, consulte Envio de mensagens.

Ponto principal: envie ao Google uma mensagem de inventário atualizada sempre que ele mudar, como quando houver reservas e cancelamentos.

Para HotelCode, use o ID exclusivo do hotel que você usou no seu sistema para identificar a propriedade. Esse valor precisa corresponder ao ID do hotel especificado usando <id> no elemento <listing> do feed de lista de hotéis. Para <RoomID>, use o mesmo ID que você usou no seu sistema para tipos de quarto. A consistência com seu sistema é fundamental para garantir que o Google mostre seus dados corretamente.

Observação: <CountType=2> é a única opção válida porque indica uma contagem de "disponibilidade definitiva".

Este exemplo mostra como definir o inventário de 13 quartos disponíveis para reserva no mês de dezembro:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Para mais exemplos, consulte Exemplos de inventário.

Tutoriais

Esta seção apresenta um cenário que pode ocorrer ao enviar uma mensagem de inventário.

Cenário: como impedir que salas sejam reservadas

Descrição

Você precisa indicar que não há mais quartos disponíveis para reserva desse tipo em um conjunto específico de datas, geralmente porque estão esgotados.

Solução

Defina <InvCount Count> como um valor 0 e adicione o período desejado.

Exemplo

Este exemplo mostra como usar InvCount para definir o inventário como 0 para o quarto e as datas especificados (por exemplo, as primeiras semanas de janeiro).

Observação: se a contagem de inventário de um quarto for 0 em qualquer noite de uma estadia, não será possível reservar a estadia para nenhum produto associado a esse quarto.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>