Criar um Feed de preços

Artigo
11/13/2024

Para fornecer ao Bing os dados de preços e disponibilidade do hotel, crie um documento XML que contenha um Feed de preços. O Feed de preços contém uma lista de datas de entrada, durações de estadia e preços.

Os feeds de preços podem conter até 180 dias de reserva avançada, e cada reserva pode especificar até 14 noites de estadia. Uma data de entrada e duração da estadia é referida como um itinerário. Se especificar o número máximo de itinerários, a mensagem conterá 2520 itinerários.

Os feeds de preços estão limitados a 100 MB de dados não comprimidos ou 10 MB de dados comprimidos (com compressão GZip). Para reduzir o tráfego de rede, deve enviar dados comprimidos.

Um Feed de preços deve conter apenas itinerários que está a adicionar ou atualizar— não inclua itinerários que não tenham sido alterados desde a última vez que enviou uma mensagem.

O documento tem de utilizar a codificação UTF-8 e tem de estar em conformidade com o XSD de Transação.

Importante

Tem de ler e seguir todas as políticas de Anúncios de Preços de Hotel. Para obter a lista de políticas, veja Políticas de programas piloto.

Nota

O Bing não suporta todos os elementos XSD de Transação. O Bing ignora qualquer elemento ou atributo na mensagem que não suporta. A Referência do Feed de preços inclui apenas os elementos e atributos suportados pelo Bing.

Nota

A mensagem tem de especificar os elementos na ordem definida no XSD de Transação (ou conforme mostrado na referência).

O elemento Transação de nível superior

Os feeds de preços contêm um elemento Transação de nível superior único.

<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">

Tem de especificar os timestamp atributos e id .

O timestamp atributo deve identificar a hora em que submete a mensagem. O Bing utiliza o carimbo de data/hora para garantir que processa apenas os itinerários mais recentes. Por exemplo, se o Bing processar uma mensagem com um carimbo de data/hora de 14:10 e, em seguida, processar uma mensagem com um carimbo de data/hora de 14:09, o Bing só processa os itinerários na mensagem 14:09 que não foram incluídos na mensagem 14:10.

O id atributo é um ID definido pelo utilizador que identifica exclusivamente a mensagem para o anunciante. O anunciante utiliza o ID para identificar a mensagem na lista de relatórios de estado do feed de propriedades.

Especificar a lista de itinerários

O Transaction elemento contém uma lista de Elementos de resultado , um para cada itinerário que define. A mensagem deve incluir apenas novos itinerários ou os que foram alterados.

O seguinte mostra um Result elemento que especifica os elementos subordinados necessários.

  <Result>
    <Property>13579</Property>
    <Checkin>2017-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
  </Result>

O Property ID tem de corresponder ao ID de uma propriedade no ficheiro de feed de propriedades. A Checkin data tem de estar dentro da janela de reserva avançada de 90 dias e tem de estar entre 1 e Nights 14 dias.

Especifica Baserate o custo de toda a duração da estadia e não a taxa de quarto noturna.

Se permitir cinco dias de reserva avançada e estadias de até três noites, a sua mensagem conterá 15 Result elementos. O exemplo seguinte mostra um dia de itinerários.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
</Transaction>

Depois de definir os 15 itinerários, cada mensagem subsequente incluiria apenas os itinerários que mudaram. Por exemplo, alterações de preços ou disponibilidade.

A remover itinerários

Para remover um itinerário, defina os respetivos Baserateelementos , Taxe OtherFees como -1,00. O Bing remove automaticamente itinerários com datas de verificação anteriores.

Utilizar os elementos de Resultado opcionais

O seguinte mostra um Result elemento que inclui os elementos subordinados opcionais.

  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <ExpirationTimestamp>2017-05-28T09:00:34Z</ExpirationTimestamp>
    <ChargeCurrency>deposit</ChargeCurrency>
    <Custom1>summer2017</Custom1>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>

Utilize ExpirationTimestamp para especificar uma data de expiração para o itinerário. Por exemplo, no Caso 1, o itinerário é servido.

Caso 1:

Hoje = 16/03/2018
CheckInDate = 01/04/2018
ExpirationTimestamp = 20/03/2018

Mas no caso 2, o itinerário não é servido.

Caso 2:

Hoje = 21/03/2018
CheckInDate = 01/04/2018
ExpirationTime = 20/03/2018

Utilize o ChargeCurrency elemento para especificar quando o utilizador é cobrado pela reserva. Por predefinição, o utilizador paga quando reserva (esta é a opção Web). Este exemplo utiliza Deposit, que pede ao utilizador para pagar uma parte na reserva e o restante mais tarde (por exemplo, quando sai).

Utilize um ou mais dos cinco Custom elementos para fornecer valores de substituição para parâmetros dinâmicos num URL de ponto de venda (POS). Por exemplo, se o URL da POS for https://www.partnerdomain.com?promo=(CUSTOM1) e Custom1 estiver definido para verão de 2017, o URL de POS que o Bing utiliza é https://www.partnerdomain.com?promo=summer2017. Para obter mais informações, veja Using Dynamic Query Parameters (Utilizar Parâmetros de Consulta Dinâmica).

A soma de todos os valores Personalizados[1-5] está limitada a um máximo de 1000 carateres, mas tenha em atenção que o limite prático pode ser menor dado o comprimento máximo de um URL.

Utilize o AllowablePointsOfSale elemento para especificar URLs de POS específicos que os utilizadores podem utilizar para reservar. Por predefinição, o utilizador pode utilizar qualquer POS no ficheiro de feed Páginas de destino do parceiro. O id atributo tem de corresponder a uma POS no ficheiro de feed.

Passos seguintes

Antes de enviar Feeds de preços, certifique-se de que o ficheiro de feed de propriedades e o ficheiro páginas de destino estão atualizados. Para atualizar estes ficheiros, contacte a sua TAM. Depois de a TAM importar os dados para o Bing, pode começar a enviar Feeds de preços. Os feeds de preços enviados antes da importação dos dados falharão.

Valide o feed Price antes de o enviar para o Bing. Para obter informações, consulte Validar o feed Price.

Para obter informações sobre como enviar o Feed de preços do Bing, veja Pushing Price feeds to Bing or Having Bing Pull Price feeds (Enviar Feeds de preços push para o Bing) ou Having Bing Pull Price feeds (Enviar Feeds de preços para o Bing) ou Having Bing Pull Price feeds (Enviar Feeds de preços pull do Bing).

Para obter informações sobre como adicionar pacotes de salas aos seus itinerários, consulte Criar um Feed de preços de metadados e Utilizar Pacotes de Salas.

Partilhar via