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 especificados em <StatusApplicationControl>, uma atualização de qualquer restrição definida anteriormente substitui apenas o valor da mesma restrição. Já a adição de uma nova restrição não afeta outras restrições definidas anteriormente. Por exemplo, se uma duração mínima de estadia de dois dias foi definida anteriormente e uma nova mensagem contendo apenas uma duração máxima de estadia de sete dias foi atualizada, essa ação não apagará o valor mínimo anterior.

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 de tarifas de quarto.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) O namespace XML.
OTA_HotelAvailNotifRQ / @EchoToken 1 string Um identificador exclusivo para esta 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 desta mensagem.
OTA_HotelAvailNotifRQ / @Version 1 decimal A versão da mensagem OpenTravel.
OTA_HotelAvailNotifRQ / POS 0..1 POS Um contêiner para especificar a conta do parceiro para esta mensagem. Normalmente, ele é usado se o back-end fornece feeds de preços para várias contas de parceiros.
OTA_HotelAvailNotifRQ / POS/ Source 1 Source Obrigatório se <POS> estiver presente. Um contêiner para o <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 forneça feeds para várias contas, esse valor precisará corresponder ao valor do atributo partner da sua 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> do 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 de uma única propriedade.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer Observação:a mensagem OTA_HotelInvCountNotifRQ é preferível à definição desse atributo.

O número de quartos restantes que podem ser reservados para o período em <StatusApplicationControl>. Se BookingLimit for especificado, <StatusApplicationControl> precisará especificar InvTypeCode, e <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 informado.

Observação:para estabelecer a disponibilidade de um quarto 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, os outros dias da semana que não forem explicitamente definidos como "true" serão excluídos. Na prática, eles serã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, os outros dias da semana que não forem explicitamente definidos como true serão excluídos. Na prática, eles serão filtrados das datas dentro de 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, os outros dias da semana que não forem explicitamente definidos como true serão excluídos. Na prática, eles serão filtrados das datas dentro de 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, os outros dias da semana que não forem explicitamente definidos como true serão excluídos. Na prática, eles serão filtrados das datas dentro de 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, os outros dias da semana que não forem explicitamente definidos como true serão excluídos. Na prática, eles serão filtrados das datas dentro de 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, os outros dias da semana que não forem explicitamente definidos como true serão excluídos. Na prática, eles serão filtrados das datas dentro do 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, os outros dias da semana que não forem explicitamente definidos como true serão excluídos. Na prática, eles serão filtrados das datas dentro de 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 de Transações (dados da propriedade).
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 taxas é definido e referenciado em <StatusApplicationControl> nas mensagens <OTA_HotelRateAmountNotifRQ> e <OTA_HotelAvailNotifRQ>.

O atributo RatePlanCode não é aplicável e não deve 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 ficar ausente caso contrário.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1..n LengthOfStay Define restrições na 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 de duração da estadia. Um valor zero é tratado como nenhuma restrição. Por exemplo, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> significa que não há uma duração máxima de estadia.

Observação:esse atributo precisa ser definido, a menos que você esteja usando MinMaxMessageType="FullPatternLOS".

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum A unidade de tempo. Se não informado, o padrão será "Day". O valor válido é:
  • Day
Observação:uma unidade "Day" é igual a uma pernoite.
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 restrição de duração da estadia.

Observação:esse elemento precisa estar presente ao usar MinMaxMessageType="FullPatternLOS" e ausente caso contrário.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string Uma sequência de caracteres Y e N indicando se cada duração da estadia é permitida, de uma noite até o valor em FixedPatternLength. Qualquer período de permanência maior que FixedPatternLength herda o valor na posição final. Por exemplo, com FixedPatternLength="4" e FullPatternLOS="YNYN", somente 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 do itinerário estão disponíveis para check-in.
  • Open e Close com Departure: essa combinação especifica quais datas do itinerário estão disponíveis para check-out.
  • A data Arrival não restringe a disponibilidade para as noites de estadia após a data do check-in.

    Por exemplo, uma estadia de 1º a 4 de abril em que os dias 2 a 4 de abril estão fechados para chegada ainda pode ser reservada.

    Observação:

    • Por padrão, o Google considera que a configuração Master de todos os produtos é Close. Você pode configurar isso em "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.
    • Definir Master como Close é conhecido como uma "interrupção de venda".
    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 itinerários com uma data de check-in durante o período de Start e End, inclusive.
    • Departure: Esse valor impede itinerários com uma data de check-out durante o período de Start e End (inclusive).
    • Master: Esse valor indica se a diária está disponível para reserva na data.

    Arrival e Departure precisam ter disponibilidade aberta para o itinerário especificado. O valor padrão para Arrival e Departure é Open, a menos que uma mensagem anterior tenha sido enviada indicando que ela foi fechada. 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 Status de Open e um valor restriction de Master para as datas relevantes e reabra 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 noturna de 1º a 3 de abril. O último dia da estadia (4 de abril) está fechado, já que apenas as datas de pernoite 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 horário local da propriedade) para que essa tarifa de quarto possa 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 padrão) indica que não há restrição no horário mais recente da reserva.
    • 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 ser feita seis horas antes do fim da data de chegada (ou seja, às 18h) 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) para que essa tarifa de quarto possa 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 com mais de 30 dias de antecedência da data de chegada. Um valor de 0 (o padrão) indica que não há restrição no horário mais cedo de reserva.
    • 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 estadia

    Defina as durações 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 estadia

    Defina as durações mínima e máxima da estadia (com base na estadia até o fim).

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

    Definir Time="0" em <LengthOfStay> indica que não há restrições para o período de permanência especificado. 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

    Definir uma restrição de fechado para partida. Isso evita itinerários com check-out nas 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="Departure"/>
        </AvailStatusMessage>
      </AvailStatusMessages>
    </OTA_HotelAvailNotifRQ>
    
    

    Restrição de chegada

    Defina uma restrição de fechado para chegada. Isso evita itinerários com check-in nas 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

    Abra a disponibilidade de um tipo de quarto e plano de tarifa em datas específicas.

    Observação:as tarifas por noite também são necessárias, além de uma contagem de inventário maior que 0 para o tipo de quarto, antes que os preços estejam 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 "interrupção de vendas".

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

    Agendamento de corte

    Aplicar um limite para reservas no dia da 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 um 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 reserva

    Defina as contagens de inventário para um tipo de quarto em datas específicas.

    Observação:a mensagem OTA_HotelInvCountNotifRQ é preferível à definiçã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

    Definir uma restrição de duração da estadia para um padrão completo.

    Para um check-in em 26 de julho de 2023, apenas as durações de estadia de 2, 4 e 6 são permitidas. As durações de estadia de 1, 3, 5 e mais de 7 dias 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 desta 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 com sucesso.

    <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 detalhes sobre esses erros em Mensagens de erro de status do feed.
    OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer O EWT (tipo de erro/aviso) da OpenTravel Alliance associado ao erro. Apenas o valor 12 (Processing exception) é usado.
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer O código de erro da OpenTravel Alliance associado ao erro. Apenas 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. Os detalhes desses erros podem ser encontrados em Mensagens de erro de status do feed.

    Exemplos

    Sucesso

    Confira a seguir uma resposta a uma mensagem OTA_HotelAvailNotifRQ processada com sucesso.

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

    A seguir, uma resposta a uma mensagem OTA_HotelAvailNotifRQ não 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>