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 / @Attribute Ocorrências Tipo Descrição
OTA_HotelInvCountNotifRQ 1 Complex element O elemento raiz de uma mensagem que define a disponibilidade de tarifas de quarto.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) O namespace XML.
OTA_HotelInvCountNotifRQ / @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_HotelInvCountNotifRQ / @TimeStamp 1 DateTime A data e a hora de criação desta 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 de parceiro desta mensagem (normalmente usado se o back-end fornecer feeds de preços para várias contas de parceiro).
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 de parceiro.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string A conta do parceiro para esta mensagem. Esse valor de string é a chave do parceiro listada na página de 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 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_HotelInvCountNotifRQ / Inventories 1 Inventories Um contêiner para um ou mais elementos <Inventory>.
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 uma única propriedade.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl Define o período e 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, do 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 de 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, 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_HotelInvCountNotifRQ / Inventories / Inventory / 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_HotelInvCountNotifRQ / Inventories / Inventory / 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_HotelInvCountNotifRQ / Inventories / Inventory / 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_HotelInvCountNotifRQ / Inventories / Inventory / 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_HotelInvCountNotifRQ / Inventories / Inventory / 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 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, 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_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 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 especificado. O valor válido é:

  • 2: disponibilidade definida.

Exemplos

Inventário restante

Define 5 quartos restantes para RoomID_1 nas datas especificadas.

<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

Marcar RoomID_1 como esgotado nas datas especificadas.

<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 / @Attribute 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 desta mensagem.
OTA_HotelInvCountNotifRS / @EchoToken 1 string O identificador exclusivo da mensagem OTA_HotelInvCountNotifRQ associada.
OTA_HotelInvCountNotifRS / Success 0..1 Success Indica que a mensagem OTA_HotelInvCountNotifRQ foi processada com sucesso.

<Success> ou <Errors> está presente em cada mensagem.
OTA_HotelInvCountNotifRS / Errors 0..1 Errors Um contêiner para um ou mais problemas encontrados durante o processamento da mensagem OTA_HotelInvCountNotifRQ.

<Success> ou <Errors> está presente em cada mensagem.
OTA_HotelInvCountNotifRS / Errors / Error 1..n Error A descrição de um erro encontrado ao processar a mensagem OTA_HotelInvCountNotifRQ. Confira mais detalhes em Mensagens de erro de status do feed.
OTA_HotelInvCountNotifRS / 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_HotelInvCountNotifRS / 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_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. 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_HotelInvCountNotifRQ processada com sucesso.

<?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, há uma resposta a uma mensagem OTA_HotelInvCountNotifRQ que não foi 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>