Esta página foi traduzida pela API Cloud Translation.

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 diária.
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 do parceiro para essa mensagem. Geralmente, é usado se o back-end fornece feeds de preço para várias contas de parceiros.
OTA_HotelInvCountNotifRQ / POS/ Source	1	Source	Obrigatório se `<POS>` estiver presente. Um contêiner para `<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 esta mensagem. O valor da string é o valor da Chave do parceiro listado na página de configurações da conta na Central para Hotéis. Observação:se você tem um back-end que fornece feeds para várias contas, esse valor precisa corresponder ao valor do atributo `partner` da mensagem da transação (dados da propriedade) e 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 com <id> no elemento <listing> do feed de lista de hotéis. O ID do hotel também aparece 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, 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, 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 estiverem explicitamente definidos como `true` serão excluídos (na verdade, eles serão filtrados das datas em `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 estiverem explicitamente definidos como `true` serão excluídos (na verdade, eles serão filtrados das datas em `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 estiverem explicitamente definidos como `true` serão excluídos (na verdade, eles serão filtrados das datas em `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 estiverem explicitamente definidos como `true` serão excluídos (na verdade, eles serão filtrados das datas em `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 estiverem explicitamente definidos como `true` serão excluídos (na verdade, eles serão filtrados das datas em `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 estiverem explicitamente definidos como `true` serão excluídos (na verdade, eles serão filtrados das datas em `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 estiverem explicitamente definidos como `true` serão excluídos (na verdade, eles serão filtrados das datas em `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 salas disponíveis que podem ser reservadas.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count	1	integer	O número de salas disponíveis que podem ser reservadas para o tipo de sala. 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 cinco salas restantes para RoomID_1 nas datas informadas.

<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 esgotados nas datas informadas.

<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 com sucesso. Cada mensagem tem `<Success>` ou `<Errors>`.
OTA_HotelInvCountNotifRS / Errors	0..1	Errors	Um contêiner para um ou mais problemas encontrados durante o processamento da mensagem `OTA_HotelInvCountNotifRQ`. Cada mensagem tem `<Success>` ou `<Errors>`.
OTA_HotelInvCountNotifRS / Errors / Error	1..n	Error	A descrição de um erro encontrado ao processar a mensagem `OTA_HotelInvCountNotifRQ`. Os detalhes sobre esses erros podem ser encontrados em Mensagens de erro de status do feed.
OTA_HotelInvCountNotifRS / Errors / Error / @Type	1	integer	O tipo de aviso de erro (EWT, na sigla em inglês) da OpenTravel Alliance associado ao erro. Apenas 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. Apenas o valor `450 (Unable to process)` é usado.
OTA_HotelInvCountNotifRS / Errors / Error / @Code	1	enum	O status da solicitação original. Apenas o valor `NotProcessed` é usado.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText	1	string	É o identificador do Google para o problema. Os detalhes sobre esses erros podem ser encontrados em Mensagens de erro de status do feed.

Exemplos

Concluído

Veja 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

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