OTA_HotelInvCountNotifRQ

Solicitações

Sintaxe

A mensagem OTA_HotelInvCountNotifRQ usa a seguinte sintaxe:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="message_ID"
                          TimeStamp="timestamp"
                          Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="integer" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Elementos e atributos

A mensagem OTA_HotelInvCountNotifRQ tem os seguintes elementos e atributos:

Elemento / @Atributo Ocorrências Tipo Descrição
OTA_HotelInvCountNotifRQ 1 Complex element O elemento raiz de uma mensagem que define a disponibilidade da tarifa do quarto.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) O namespace XML.
OTA_HotelInvCountNotifRQ / @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_HotelInvCountNotifRQ / @TimeStamp 1 DateTime A data e a hora de criação dessa mensagem.
OTA_HotelInvCountNotifRQ / @Version 1 decimal A versão da mensagem OpenTravel.
OTA_HotelInvCountNotifRQ / POS 0..1 POS Um contêiner para especificar a conta do parceiro para essa mensagem (geralmente usado se o back-end fornecer feeds de preços para várias contas de parceiros).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Obrigatório se <POS> estiver presente. Um contêiner para o <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Obrigatório se <POS> estiver presente. Define a conta do parceiro.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string A conta do parceiro para essa mensagem. Esse valor de string é o valor da chave do parceiro listado na página Configurações da conta na 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 dopartner atributo da mensagem de transação (dados da propriedade) e ao valor doID atributo no elemento<RequestorID> da mensagem <OTA_HotelRateAmountNotifRQ> da mesma conta.
OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Um contêiner para um ou mais <Inventory> elementos.
OTA_HotelInvCountNotifRQ / Inventories / @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_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory Define as contagens de quartos disponíveis para diferentes períodos de tempo de uma única propriedade.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl Define o período, bem como o identificador do tipo de quarto (InvTypeCode).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date A data de início (com base no fuso horário da propriedade), inclusive, de o período.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date A data de término (com base no fuso horário da propriedade), inclusive, do período. Precisa ser igual ou maior que o valor start. Se start e end forem iguais, a atualização será aplicada a essa data.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / 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 estiverem explicitamente definidos como true serão excluídos (na verdade, eles serão filtrados das datas dentro de Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / 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 estiverem explicitamente definidos como true serão excluídos (na verdade, eles serão filtrados das datas dentro de Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / 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 estiverem explicitamente definidos como true serão excluídos (na verdade, eles serão filtrados das datas dentro de Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / 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 estiverem explicitamente definidos como true serão excluídos (na verdade, eles serão filtrados das datas dentro de Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / 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 estiverem explicitamente definidos como true serão excluídos (na verdade, eles serão filtrados das datas dentro de Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / 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 estiverem explicitamente definidos como true serão excluídos (na verdade, eles serão filtrados das datas dentro de Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / 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 estiverem explicitamente definidos como true serão excluídos (na verdade, eles serão filtrados das datas dentro de Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / 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_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Um contêiner para definir uma única contagem de inventário.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Define o número de quartos disponíveis que podem ser reservados.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer O número de quartos disponíveis que podem ser reservados para o tipo de quarto. Um valor de zero indica que o tipo de quarto está esgotado. Um valor negativo é tratado como zero.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

O tipo de contagem de inventário que está sendo especificado. O valor válido é:

  • 2: disponibilidade definida.

Exemplos

Inventário restante

Define 5 quartos restantes para RoomID_1 nas datas fornecidas.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Inventário esgotado

Marque RoomID_1 como esgotado nas datas fornecidas.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Respostas

Sintaxe

A mensagem OTA_HotelInvCountNotifRS usa a seguinte sintaxe:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS 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_HotelInvCountNotifRS>

Elementos e atributos

A mensagem OTA_HotelInvCountNotifRS tem os seguintes elementos e atributos:

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

Either <Success> or <Errors> is present in each message.
OTA_HotelInvCountNotifRS / Errors 0..1 Errors Um contêiner para um ou mais problemas encontrados durante o processamento da OTA_HotelInvCountNotifRQ mensagem.

Either <Success> or <Errors> is present in each message.
OTA_HotelInvCountNotifRS / Errors / Error 1..n Error A descrição de um erro encontrado durante o processamento da OTA_HotelInvCountNotifRQ mensagem. Detalhes sobre esses erros podem ser encontrados em Mensagens de erro de status do feed.
OTA_HotelInvCountNotifRS / 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_HotelInvCountNotifRS / 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_HotelInvCountNotifRS / Errors / Error / @Code 1 enum O status da solicitação original. Somente o valor NotProcessed é usado.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string O identificador do Google para o problema. Detalhes sobre esses erros podem ser encontrados em Mensagens de erro de status do feed.

Exemplos

Sucesso

A seguir, apresentamos uma resposta a uma mensagem OTA_HotelInvCountNotifRQ processada corretamente.

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

Erros

A seguir, apresentamos uma resposta a uma mensagem OTA_HotelInvCountNotifRQ não processada devido a erros.

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