OTA_HotelAvailNotifRQ

Solicitações

Sintaxe

A mensagem OTA_HotelAvailNotifRQ usa a seguinte sintaxe:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="message_ID"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay FixedPatternLength="integer">
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay|FullPatternLOS]">
          <LOS_Pattern FullPatternLOS="pattern"/>
        </LengthOfStay>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer_or_duration"
                         MinAdvancedBookingOffset="integer_or_duration"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Cada mensagem <OTA_HotelAvailNotifRQ> é tratada como uma atualização delta. Para cada propriedade, data, quarto e pacote especificado em <StatusApplicationControl>, uma atualização de qualquer restrição definida anteriormente substitui apenas o valor da mesma restrição, enquanto a adição de uma nova restrição não afeta outras restrições definidas anteriormente. Por exemplo, se uma estadia mínima de dois dias foi definida anteriormente e uma nova mensagem contendo apenas uma estadia máxima de sete dias foi atualizada, essa ação não vai apagar o valor anterior da estadia mínima.

Elementos e atributos

A mensagem OTA_HotelAvailNotifRQ tem os seguintes elementos e atributos:

Observação:cada tipo de restrição de duração da estadia é definido de forma independente. Por exemplo, uma mensagem que define SetMaxLOS não substitui um valor definido anteriormente para SetForwardMaxStay.

Elemento / @Attribute Ocorrências Tipo Descrição
OTA_HotelAvailNotifRQ 1 Complex element O elemento raiz de uma mensagem que define a disponibilidade da tarifa do quarto.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) O namespace do XML.
OTA_HotelAvailNotifRQ / @EchoToken 1 string Um identificador exclusivo para essa mensagem de solicitação. Esse valor é retornado na mensagem de resposta. Os caracteres permitidos são a-z, A-Z, 0-9, _ (sublinhado) e - (traço).
OTA_HotelAvailNotifRQ / @TimeStamp 1 DateTime A data e a hora de criação da mensagem.
OTA_HotelAvailNotifRQ / @Version 1 decimal A versão da mensagem do OpenTravel.
OTA_HotelAvailNotifRQ / POS 0..1 POS Um contêiner para especificar a conta do parceiro para esta mensagem. Ele é geralmente usado quando o back-end fornece feeds de preço para várias contas de parceiros.
OTA_HotelAvailNotifRQ / POS/ Source 1 Source Obrigatório se <POS> estiver presente. Um contêiner para a <RequestorID>.
OTA_HotelAvailNotifRQ / POS / RequestorID 1 RequestorID Obrigatório se <POS> estiver presente. Define a conta de parceiro.
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID 1 string A conta do parceiro para esta mensagem. Esse valor de string é o valor de Partner key listado na página "Configurações da conta" da Central para Hotéis.

Observação:se você tiver um back-end que fornece feeds para várias contas, esse valor precisa corresponder ao valor do atributo partner da mensagem de Transação (dados da propriedade) e ao valor do atributo ID no elemento <RequestorID> da mensagem <OTA_HotelRateAmountNotifRQ> para a mesma conta.

OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages Um contêiner para um ou mais elementos <AvailStatusMessage>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string O identificador exclusivo da propriedade. Esse valor precisa corresponder ao ID do hotel especificado usando <id> no elemento <listing> no feed de lista de hotéis. O ID do hotel também está listado na Central para Hotéis.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage Define a disponibilidade e as restrições de tarifas de quartos para diferentes períodos de tempo em uma única propriedade.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer Observação:a mensagem OTA_HotelInvCountNotifRQ é a preferida em vez de definir esse atributo.

O número de salas restantes que podem ser reservadas para o período em <StatusApplicationControl>. Se BookingLimit for especificado, <StatusApplicationControl> precisará especificar InvTypeCode, e o <AvailStatusMessage> não poderá conter <LengthOfStay> ou <RestrictionStatus>.

Precisa ser igual ou maior que 0. O padrão é 0 se for negativo ou não for fornecido.

Observação:para estabelecer a disponibilidade de quartos para uma determinada configuração de <StatusApplicationControl>, o atributo BookingLimit precisa ser definido pelo menos uma vez.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl 1 StatusApplicationControl Define o período e os identificadores do tipo de quarto (InvTypeCode) e do plano de tarifa (RatePlanCode).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start 1 Date A data de início com base no fuso horário da propriedade que inclui o período.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date A data de término (com base no fuso horário da propriedade), incluindo o período. Precisa ser igual ou maior que o valor de start. Se start e end forem iguais, a atualização será aplicada a essa data.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0..1 boolean Defina como true ou 1 para incluir explicitamente as segundas-feiras.

Se definido como true, outros dias da semana que não forem definidos explicitamente como "true" serão excluídos. Na prática, eles são filtrados das datas no Start and End).

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean Defina como true ou 1 para incluir explicitamente as terças-feiras.

Se definido como true, outros dias da semana que não forem definidos explicitamente como true serão excluídos. Na prática, eles são filtrados das datas no Start e End.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean Defina como true ou 1 para incluir explicitamente as quartas-feiras.

Se definido como true, outros dias da semana que não forem definidos explicitamente como true serão excluídos. Na prática, eles são filtrados das datas no Start e End.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean Defina como true ou 1 para incluir explicitamente as quintas-feiras.

Se definido como true, outros dias da semana que não forem definidos explicitamente como true serão excluídos. Na prática, eles são filtrados das datas no Start e End.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean Defina como true ou 1 para incluir explicitamente as sextas-feiras.

Se definido como true, outros dias da semana que não forem definidos explicitamente como true serão excluídos. Na prática, eles são filtrados das datas no Start e End.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean Defina como true ou 1 para incluir explicitamente os sábados.

Se definido como true, outros dias da semana que não forem definidos explicitamente como true serão excluídos. Na prática, eles serão filtrados das datas em "Início" e End.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean Defina como true ou 1 para incluir explicitamente os domingos.

Se definido como true, outros dias da semana que não forem definidos explicitamente como true serão excluídos. Na prática, eles são filtrados das datas no Start e End.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string O identificador exclusivo do inventário (tipo de quarto). Esse valor é mapeado para <RoomID> em uma mensagem Transactions (Property Data).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string Um identificador exclusivo do plano de tarifas. Esse identificador é mapeado para o valor de <PackageID> em uma mensagem de transação (dados da propriedade). O plano de tarifas é definido e mencionado em <StatusApplicationControl> nas mensagens <OTA_HotelRateAmountNotifRQ> e <OTA_HotelAvailNotifRQ>.

O atributo RatePlanCode não é aplicável e não precisa ser especificado quando <AvailStatusMessage> contém o atributo BookingLimit. Precisa ser especificado se <RestrictionStatus> ou <LengthOfStay> for especificado.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay Um contêiner para definir restrições de LOS. Não precisa estar presente se <AvailStatusMessage> incluir o atributo BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength 0..1 integer O comprimento do padrão definido em FullPatternLOS.

Observação:esse atributo precisa ser definido ao usar MinMaxMessageType="FullPatternLOS" e ausente em outros casos.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1..n LengthOfStay Define restrições sobre a duração da estadia. Ao usar mais de um elemento <LengthOfStay>, cada um precisa especificar um valor MinMaxMessageType diferente.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time 0..1 integer Valor da unidade da medição da duração da estadia. Um valor de zero é tratado como nenhuma restrição. Por exemplo, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> significa que não há duração máxima da estadia.

Observação:esse atributo precisa ser definido, a menos que seja usado MinMaxMessageType="FullPatternLOS".

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum A unidade de tempo. Se não for informado, o padrão será "Day". O valor válido é:
  • Day
Observação:uma unidade de "Day" equivale a uma estadia de uma noite.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 enum Vários tipos de restrições de duração da estadia. SetMaxLOS, SetMinLOS e FullPatternLOS são baseados na chegada. SetForwardMinStay e SetForwardMaxStay são baseados em permanência. Os valores máximos precisam ser maiores ou iguais aos valores mínimos.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern 0..1 LOS_Pattern Define o padrão de duração da restrição.

Observação:esse elemento precisa estar presente ao usar MinMaxMessageType="FullPatternLOS" e ausente em outros casos.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string Uma sequência de caracteres Y e N que indica se cada duração de estadia é permitida, de uma noite até o valor em FixedPatternLength. Qualquer duração de estadia maior que FixedPatternLength herda o valor na posição final. Por exemplo, com FixedPatternLength="4" e FullPatternLOS="YNYN", apenas as durações de estadia 1 e 3 são permitidas.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus 0..1 RestrictionStatus Define restrições de itinerário. Não precisa estar presente se <AvailStatusMessage> incluir o atributo BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status 0..1 enum Indica se o tipo de restrição especificado pelo atributo Restriction está aberto ou fechado. Os valores válidos são:
  • Open
  • Close

Os valores Open e Close são compatíveis com todos os valores do elemento <Restriction>. Quando os valores Open e Close são usados com os valores Arrival e Departure, eles restringem datas específicas no itinerário para check-in e check-out, respectivamente.

  • Open e Close com Arrival: essa combinação especifica quais datas no itinerário estão disponíveis para check-in.
  • Open e Close com Departure: essa combinação especifica quais datas no itinerário estão disponíveis para check-out.
  • A data de Arrival não restringe a disponibilidade das noites de estadia após a data de check-in.

    Por exemplo, para uma estadia de 1º a 4 de abril, em que 2 a 4 de abril estão indisponíveis, ainda é possível fazer reservas.

    Observação:

    • Por padrão, o Google assume que a configuração Master de todos os produtos é Close. É possível configurar isso na "Disponibilidade padrão" nas Configurações de preços da Central para Hotéis. O valor "Fechado" na Central para Hotéis corresponde ao valor Close aqui.
    • A configuração de Master como Close é conhecida como "stop sell".
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

    Esse atributo é obrigatório se Status for fornecido.

    Os valores válidos são:

    • Arrival: Esse valor impede que itinerários com uma data de check-in durante o período de Start e End sejam incluídos.
    • Departure: Esse valor impede que itinerários com uma data de saída sejam incluídos no período de Start a End.
    • Master: Esse valor indica se a tarifa do quarto está disponível para reserva na data.

    Arrival e Departure são necessários para ter disponibilidade aberta para o itinerário especificado. O valor padrão de Arrival e Departure é Open, a menos que uma mensagem anterior tenha sido enviada indicando que ela foi encerrada. Além disso, a combinação de quarto/pacote precisa estar disponível para todas as datas do itinerário, exceto o último dia da estadia. Essa disponibilidade pode ser definida pelas configurações padrão na Central para Hotéis ou pelo elemento <Status> ou <Restriction>. Se a configuração padrão for Close, envie um valor de Status de Open e um valor de restriction de Master para as datas relevantes para reabrir a disponibilidade para as datas do itinerário.

    Por exemplo, para uma estadia de três noites com data de chegada em 1º de abril, o itinerário completo é de 1º a 4 de abril. O valor de Status precisa ser definido como Open, e o valor de Restriction precisa ser definido como Master para a estadia de 1 a 3 de abril. O último dia da estadia (4 de abril) está fechado, já que apenas as datas de estadia noturna exigem um status Open.

    Observação:se o Restriction não for especificado, o valor padrão será Master.

    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0..1 integer or duration Duração mínima antes da data de chegada (no fuso horário local da propriedade) em que essa tarifa pode ser reservada.

    Os tipos de valor válidos são:

    • Integer: O número de dias antes da data de chegada. Por exemplo, um valor de 1 indica que a tarifa do quarto precisa ser reservada pelo menos um dia antes da data de chegada. Um valor de 0 (o valor padrão) indica que não há restrição no horário de reserva mais recente.
    • ISO 8601 Duration (days, hours, and minutes): O número de dias (e, opcionalmente, horas/minutos) antes da data de chegada. Por exemplo, um valor de P1D indica que a diária do quarto precisa ser reservada um dia antes da data de chegada. Um valor de P0DT6H indica que a reserva precisa ocorrer seis horas antes do fim da data de chegada (ou seja, 18:00) ou antes.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0..1 integer or duration Duração máxima antes da data de chegada (no horário local da propriedade) em que essa tarifa de quarto pode ser reservada.

    Os tipos de valor válidos são:

    • Integer: O número de dias antes da data de chegada. Por exemplo, um valor de 30 indica que a tarifa do quarto não pode ser reservada antes de 30 dias da data de chegada. Um valor de 0 (o valor padrão) indica que não há restrição no horário de reserva mais cedo.
    • ISO 8601 Duration (days, hours, and minutes): O número de dias (e, opcionalmente, horas/minutos) antes da data de chegada. Por exemplo, um valor de P30D indica que a tarifa do quarto não pode ser reservada antes de 30 dias da data de chegada. Um valor de P30DT6H indica que a reserva não pode ocorrer antes das 18h, 30 dias antes da data de chegada.

    Exemplos

    Data de chegada da LoS

    Defina a duração mínima e máxima da estadia (com base na data de chegada).

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-07-26"
                                    End="2023-07-31"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <LengthsOfStay>
            <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
            <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
          </LengthsOfStay>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    

    Duração da LoS

    Defina a duração mínima e máxima da estadia (com base na permanência).

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-07-26"
                                    End="2023-07-31"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <LengthsOfStay>
            <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
            <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
          </LengthsOfStay>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    

    Remover restrições de LoS

    A configuração Time="0" em <LengthOfStay> indica que não há restrições para a duração de estadia especificada. Por exemplo, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> significa que não há restrição de duração máxima da estadia.

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2024-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage>
          <StatusApplicationControl Start="2024-07-26"
                                    End="2024-07-31"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <LengthsOfStay>
            <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/>
          </LengthsOfStay>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    

    Restrição de partida

    Defina uma restrição de saída fechada. Isso impede itinerários com saída em datas específicas.

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-07-26"
                                    End="2023-07-31"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <RestrictionStatus Status="Close" Restriction="Departure"/>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    

    Restrição de chegada

    Defina uma restrição de chegada. Isso impede itinerários com check-in em datas especificadas.

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-07-26"
                                    End="2023-07-31"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <RestrictionStatus Status="Close" Restriction="Arrival"/>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    


    Datas de disponibilidade

    Disponibilidade aberta para um tipo de quarto e plano de tarifa em datas específicas.

    Observação:também são necessárias tarifas noturnas e uma contagem de inventário maior que 0 para o tipo de quarto antes que os preços fiquem totalmente disponíveis.

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-07-26"
                                    End="2023-07-31"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <RestrictionStatus Status="Open" Restriction="Master"/>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    

    Fechar datas de disponibilidade

    Fechar a disponibilidade de um tipo de quarto e plano de tarifa em datas específicas. Isso também é conhecido como "stop sell".

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-07-26"
                                    End="2023-07-31"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <RestrictionStatus Status="Close" Restriction="Master"/>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    

    Restrições de reserva antecipada

    Defina restrições mínimas e máximas de janela de reserva avançada, aplicadas apenas nos fins de semana.

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-01-01"
                                    End="2023-06-30"
                                    Mon=”false”
                                    Tue=”false”
                                    Weds=”false”
                                    Thur=”false”
                                    Fri=”false”
                                    Sat=”true”
                                    Sun=”true”
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <RestrictionStatus MaxAdvancedBookingOffset="30"
                             MinAdvancedBookingOffset="2"/>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    

    Reserva de corte

    Aplique um limite para reservas na data de chegada às 18h no horário local do hotel.

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-01-01"
                                    End="2023-06-30"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    

    Várias restrições

    Defina várias restrições nas mesmas datas para um tipo de quarto e plano de tarifa.

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-07-26"
                                    End="2023-07-31"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <RestrictionStatus Status="Open" Restriction="Master"/>
        </AvailStatusMessage>
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-07-26"
                                    End="2023-07-31"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <RestrictionStatus Status="Close" Restriction="Arrival"/>
        </AvailStatusMessage>
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-07-26"
                                    End="2023-07-31"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <RestrictionStatus Status="Close" Restriction="Departure"/>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    


    Limite de reservas

    Defina os inventários de um tipo de quarto em datas específicas.

    Observação:a mensagem OTA_HotelInvCountNotifRQ é preferencial à configuração desse atributo.

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage BookingLimit="5">
          <!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
          <StatusApplicationControl Start="2023-07-26"
                                    End="2023-07-31"
                                    InvTypeCode="RoomID_1"/>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    

    FullPatternLoS

    Defina uma restrição de duração de estadia de padrão completo.

    Para um check-in em 26 de julho de 2023, apenas durações de 2, 4 e 6 são permitidas. As durações de estadia 1, 3, 5 e 7+ não estão disponíveis.

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                           EchoToken="12345678"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <AvailStatusMessages HotelCode="Property_1">
        <AvailStatusMessage>
          <StatusApplicationControl Start="2023-07-26"
                                    End="2023-07-26"
                                    InvTypeCode="RoomID_1"
                                    RatePlanCode="PackageID_1"/>
          <LengthsOfStay FixedPatternLength="7">
            <LengthOfStay MinMaxMessageType="FullPatternLOS">
              <LOS_Pattern FullPatternLOS="NYNYNYN"/>
            </LengthOfStay>
          </LengthsOfStay>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    
    

    Respostas

    Sintaxe

    A mensagem OTA_HotelAvailNotifRS usa a seguinte sintaxe:

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                           TimeStamp="timestamp"
                           EchoToken="echo_token"
                           Version="3.0">
      <!-- Either Success or Errors will be populated. -->
      <Success/>
      <Errors>
        <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
      </Errors>
    </OTA_HotelAvailNotifRS>
    

    Elementos e atributos

    A mensagem OTA_HotelAvailNotifRS tem os seguintes elementos e atributos:

    Elemento / @Attribute Ocorrências Tipo Descrição
    OTA_HotelAvailNotifRS 1 Complex element O elemento raiz de uma resposta a uma mensagem de disponibilidade.
    OTA_HotelAvailNotifRS / @TimeStamp 1 DateTime A data e a hora de criação da mensagem.
    OTA_HotelAvailNotifRS / @EchoToken 1 string O identificador exclusivo da mensagem OTA_HotelAvailNotifRQ associada.
    OTA_HotelAvailNotifRS / Success 0..1 Success Indica que a mensagem OTA_HotelAvailNotifRQ foi processada.

    <Success> ou <Errors> está presente em cada mensagem.

    OTA_HotelAvailNotifRS / Errors 0..1 Errors Um contêiner para um ou mais problemas encontrados durante o processamento da mensagem OTA_HotelAvailNotifRQ.

    <Success> ou <Errors> está presente em cada mensagem.

    OTA_HotelAvailNotifRS / Errors / Error 1..n Error A descrição de um erro encontrado ao processar a mensagem OTA_HotelAvailNotifRQ. Confira os detalhes desses erros em Mensagens de erro de status do feed.
    OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer O EWT (tipo de aviso de erro) da OpenTravel Alliance associado ao erro. Somente o valor 12 (Processing exception) é usado.
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer O ERR (código de erro) da OpenTravel Alliance associado ao erro. Somente o valor 450 (Unable to process) é usado.
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 enum O status da solicitação original. Somente o valor NotProcessed é usado.
    OTA_HotelAvailNotifRS / Errors / Error / @ShortText 1 string O identificador do Google para o problema. Confira os detalhes desses erros em Mensagens de erro de status do feed.

    Exemplos

    Sucesso

    Confira a seguir uma resposta para uma mensagem OTA_HotelAvailNotifRQ processada.

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <Success/>
    </OTA_HotelAvailNotifRS>
    
    

    Erros

    Confira a seguir uma resposta a uma mensagem OTA_HotelAvailNotifRQ que não foi processada devido a erros.

    <?xml version="1.0" encoding="UTF-8"?>
    <OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                           TimeStamp="2023-07-21T20:50:37-05:00"
                           Version="3.0">
      <Errors>
        <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
      </Errors>
    </OTA_HotelAvailNotifRS>