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 da tarifa do quarto.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) O namespace do 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 da mensagem.
OTA_HotelInvCountNotifRQ / @Version 1 decimal A versão da mensagem do OpenTravel.
OTA_HotelInvCountNotifRQ / POS 0..1 POS Um contêiner para especificar a conta de parceiro dessa mensagem. Normalmente, é usado quando o back-end fornece feeds de preço para várias contas de parceiro.
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Obrigatório se <POS> estiver presente. Um contêiner para a <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 é o valor da chave do parceiro 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_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 é listado na Central para Hotéis.
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory Define a contagem de quartos disponíveis para diferentes períodos de tempo em 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) do período.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date A data de término (com base no fuso horário da propriedade) 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, 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_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 forem definidos explicitamente como true serão excluídos. Na prática, eles são filtrados das datas no 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 forem definidos explicitamente como true serão excluídos. Na prática, eles são filtrados das datas no 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 forem definidos explicitamente como true serão excluídos. Na prática, eles são filtrados das datas no 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 forem definidos explicitamente como true serão excluídos. Na prática, eles são filtrados das datas no 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 forem definidos explicitamente como true serão excluídos. Na prática, eles são filtrados das datas no 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 forem definidos explicitamente como true serão excluídos. Na prática, eles são filtrados das datas no 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 Transactions (Property Data).
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 especificado. O valor válido é:

  • 2: disponibilidade definida.

Exemplos

Inventário restante

Define 5 salas 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

O item RoomID_1 esgotou nas datas indicadas.

<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 da 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.

<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 detalhes sobre esses erros 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. Confira os detalhes desses erros em Mensagens de erro de status do feed.

Exemplos

Sucesso

Confira a seguir uma resposta para 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

Confira a seguir 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>