Mensagem de inventário

Visão geral

A mensagem de inventário (OTA_HotelInvCountNotifRQ) define os números de inventário (número de quartos físicos) que estão disponíveis para reserva em tipos de quarto específicos. Ao enviar uma mensagem de inventário, você indica o número de cômodos estejam disponíveis em uma determinada data. Se nenhuma sala desse tipo estiver disponível, produtos que envolvam esse tipo de quarto e data não serão exibidos.

As seções a seguir abordam diretrizes gerais, um exemplo básico e instruções para 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 Instruções.

Elementos obrigatórios e opcionais

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

Sintaxe e esquemas

Use a guia Inventário de sintaxe como uma ao criar a mensagem de inventário para garantir que você está seguindo no formato correto.

Você pode usar uma ferramenta XML de terceiros, como o xmllint, para validar seus feeds com os esquemas publicados antes de enviá-los ao Google. Para o inventário de mensagem do anúncio, consulte Esquemas de anúncios de hotéis.

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 tarifas e da ocupação associados.

  • Se a contagem de inventário for igual a 0, as salas não estarão disponíveis para 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 definitiva".

  • Enviar inventário atualizado sempre que fizer uma reserva ou cancelar um quarto ocorre no sistema.

.

Inventário versus disponibilidade

"Inventário" é o número de salas que podem ser reservadas com base na contagem física "availability" indica se a combinação de tipo de quarto e plano de tarifa é que podem ser reservadas. Para ARI, a disponibilidade e o inventário podem variar de acordo com em um conjunto de datas ou tipo de acomodação, e ambos têm termos tipos de mensagem. O inventário e a disponibilidade são codificados por hotel, data e quarto com a adição de um plano de tarifação para disponibilidade.

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

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

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

Exemplo

Esta seção apresenta um exemplo básico de uma mensagem de inventário usando os atributos e elementos opcionais. Depois de preparar o arquivo, você precisará 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 a mensagem por push/POST, consulte Push .

Para HotelCode, utilize o ID de hotel exclusivo usado no seu sistema para identificando a propriedade. Esse valor precisa corresponder ao ID do hotel especificado <id> neste ambiente: <listing> na Feed de lista de hotéis. Para <RoomID>, use o mesmo ID no sistema para tipos de quarto. A consistência no sistema é essencial para garantir que o Google está exibindo seus dados corretamente.

Este exemplo mostra como definir o inventário de 13 salas que podem ser reservadas para o 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 Inventário exemplos.

Tutoriais

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

Situação: como bloquear a reserva de salas

Descrição

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

Solução

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

Exemplo

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

<?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>