Mensagem de inventário

Informações gerais

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 para tipos de quarto específicos. Quando você envia uma mensagem de inventário, indica quantos quartos desse tipo estão disponíveis em uma determinada data. Se nenhum quarto desse tipo estiver disponível, os produtos envolvendo esse tipo de quarto 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 ver exemplos de vários cenários relacionados ao inventário, consulte os Instruções.

Elementos obrigatórios e opcionais

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

Sintaxe e esquemas

Use o exemplo de Sintaxe do inventário como referência ao criar a mensagem do inventário 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 inventário, consulte Esquemas de anúncios de hotel.

Diretrizes

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

• O inventário é codificado 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 do plano de tarifa e da ocupação associados.

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

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

• Envie o inventário atualizado sempre que ocorrer uma reserva ou 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 usando o atributo <BookingLimit> da mensagem OTA_HotelAvailNotifRQ.

Inventário versus disponibilidade

O inventário é o número de quartos que podem ser reservados 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 ARI, a disponibilidade e o inventário podem variar com base em um conjunto de datas ou tipo de acomodação, e ambos têm tipos de mensagem correspondentes. O inventário e a disponibilidade são identificados por hotel, data e tipo de quarto, com a inclusão de um plano de tarifa para a disponibilidade.

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

Há dois conceitos de disponibilidade. Primeiro, a disponibilidade geral de um produto para uma determinada estadia, que é afetada por fatores como se todas as noites têm uma tarifa definida, inventário para o tipo de quarto associado e 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 encerramento dessa disponibilidade é conhecido como "interrupção de vendas".

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 que o preço de um produto seja mostrado.

Observação :se um quarto estiver esgotado, os planos de tarifa associados a ele não poderão mais ser vendidos.

Exemplo

Nesta seção, mostramos um exemplo básico de uma mensagem de inventário usando elementos obrigatórios e opcionais. Depois de preparar o arquivo, será necessário enviá-lo ao Google por uma mensagem POST para este endpoint:

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

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

Importante :envie ao Google uma mensagem atualizada do inventário sempre que o inventário mudar, por exemplo, quando ocorrerem reservas e cancelamentos.

Para HotelCode, use o ID exclusivo do hotel utilizado no sistema para identificar a propriedade. Esse valor precisa corresponder ao ID do hotel especificado usando <id> no elemento <listing> no feed de lista de hotéis. Para <RoomID>, use o mesmo ID do sistema para tipos de quarto. A consistência com seu sistema é fundamental para garantir que o Google esteja exibindo os 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 salas que podem ser reservadas 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

Nesta seção, apresentamos um cenário que você pode encontrar ao enviar uma mensagem do inventário.

Cenário: como impedir que salas sejam reservadas

Descrição

É necessário indicar que não há salas restantes que possam ser reservadas para esse tipo de quarto em um conjunto específico de datas, geralmente porque elas estão esgotados.

Solução

Você define <InvCount Count> como um valor 0 e adiciona o período desejado.

Exemplo

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

Observação: se a contagem de inventário de um quarto for 0 para qualquer noite de estadia, ela não poderá ser reservada 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>