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 |
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 |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | Defina como true ou 1 para incluir explicitamente as terças-feiras.
Se definido como |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | Defina como true ou 1 para incluir explicitamente as quartas-feiras.
Se definido como |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | Defina como true ou 1 para incluir explicitamente as quintas-feiras.
Se definido como |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | Defina como true ou 1 para incluir explicitamente as sextas-feiras.
Se definido como |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | Defina como true ou 1 para incluir explicitamente os sábados.
Se definido como |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | Defina como true ou 1 para incluir explicitamente os domingos.
Se definido como |
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 é:
|
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 |
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 |
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>