OTA_HotelInvCountNotifRQ

Richieste

Sintassi

Il messaggio OTA_HotelInvCountNotifRQ utilizza la seguente sintassi:

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

Elementi e attributi

Il messaggio OTA_HotelInvCountNotifRQ contiene i seguenti elementi e attributi:

Elemento / @attributo Occorrenze Tipo Descrizione
OTA_HotelInvCountNotifRQ 1 Complex element L'elemento principale di un messaggio che definisce la disponibilità della tariffa della camera.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) Lo spazio dei nomi XML.
OTA_HotelInvCountNotifRQ / @EchoToken 1 string Un identificatore univoco per questo messaggio di richiesta. Questo valore viene restituito nel messaggio di risposta. I caratteri consentiti sono a-z, A-Z, 0-9, _ (trattino basso) e - (trattino).
OTA_HotelInvCountNotifRQ / @TimeStamp 1 DateTime La data e l'ora di creazione di questo messaggio.
OTA_HotelInvCountNotifRQ / @Version 1 decimal La versione del messaggio OpenTravel.
OTA_HotelInvCountNotifRQ / POS 0..1 POS Un contenitore per specificare l'account partner per questo messaggio (utilizzato in genere se il backend fornisce feed del prezzo per più account partner).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Obbligatorio se è presente <POS>. Un container per <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Obbligatorio se è presente <POS>. Definisce il partner .
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string L'account partner per questo messaggio. Questo valore di stringa corrisponde alla Il valore della chiave del partner riportato nella Impostazioni account di Hotel Center.

Nota: se disponi di un backend che fornisce feed per più questo valore deve corrispondere al valore partner del messaggio Transaction (Property Data) e il valore ID nel campo <RequestorID> elemento di <OTA_HotelRateAmountNotifRQ> messaggio per lo stesso .

OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Un contenitore per uno o più <Inventory> elementi.
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string L'identificatore univoco della struttura. Questo valore deve corrispondere alla ID hotel specificato utilizzando <id> nel <listing> del feed elenco hotel. ID hotel è indicato anche in Hotel Center.
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory Definisce i conteggi delle camere disponibili per intervalli di tempo diversi per un singolo proprietà.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl Definisce l'intervallo di date, nonché l'identificatore del tipo di camera (InvTypeCode)
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date La data di inizio (in base al fuso orario della proprietà), inclusa, di l'intervallo di date.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date La data di fine (in base al fuso orario della proprietà), inclusa, della data intervallo di date. Deve essere uguale o maggiore del valore start. Se start e end sono uguali, l'aggiornamento si applica fino a quella data.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean Imposta su true o 1 per includere esplicitamente i lunedì.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean Imposta su true o 1 per includere esplicitamente i martedì.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean Imposta su true o 1 per includere esplicitamente il mercoledì.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Imposta su true o 1 per includere esplicitamente il giovedì.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean Imposta su true o 1 per includere esplicitamente i venerdì.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean Imposta su true o 1 per includere esplicitamente il sabato.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Imposta su true o 1 per includere esplicitamente la domenica.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string L'identificatore univoco dell'inventario (tipo di camera). Questo valore viene mappato a <RoomID> in una sezione Transazioni (Property Data).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Un contenitore per la definizione di un singolo conteggio di inventario.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Definisce il numero di camere disponibili che possono essere prenotate.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer Il numero di stanze disponibili che possono essere prenotate per il tipo di camera. Il valore zero indica che il tipo di camera è esaurito. A negativo viene considerato zero.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

Il tipo di conteggio dell'inventario specificato. Il valore valido è:

  • 2: disponibilità definitiva.

Esempi

Inventario rimanente

Imposta 5 stanze rimaste per RoomID_1 nelle date specificate.

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

Inventario esaurito

Contrassegna RoomID_1 come esaurito nelle date specificate.

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

Risposte

Sintassi

Il messaggio OTA_HotelInvCountNotifRS utilizza la seguente sintassi:

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

Elementi e attributi

Il messaggio OTA_HotelInvCountNotifRS contiene i seguenti elementi e attributi:

Elemento / @attributo Occorrenze Tipo Descrizione
1 Complex element L'elemento principale per una risposta a un messaggio sulla disponibilità.
OTA_HotelInvCountNotifRS / @TimeStamp 1 DateTime La data e l'ora di creazione di questo messaggio.
OTA_HotelInvCountNotifRS / @EchoToken 1 string L'identificatore univoco dell'elemento associato OTA_HotelInvCountNotifRQ messaggio.
OTA_HotelInvCountNotifRS / Success 0..1 Success Indica che il messaggio OTA_HotelInvCountNotifRQ era elaborato correttamente.

<Success> o <Errors> sono presenti in ogni messaggio.

OTA_HotelInvCountNotifRS / Errors 0..1 Errors Un container per uno o più problemi riscontrati durante l'elaborazione OTA_HotelInvCountNotifRQ messaggio.

<Success> o <Errors> sono presenti in ogni messaggio.

OTA_HotelInvCountNotifRS / Errors / Error 1..n Error La descrizione di un errore riscontrato durante l'elaborazione del OTA_HotelInvCountNotifRQ messaggio. I dettagli su questi errori possono consulta la sezione Messaggi di errore relativi allo stato dei feed.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer Il EWT (Error Warning Type) OpenTravel Alliance associato al . Viene utilizzato solo il valore 12 (Processing exception).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer L'ERR (Error Code) OpenTravel Alliance associato all'errore. Viene utilizzato solo il valore 450 (Unable to process).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum Lo stato della richiesta originale. Solo il valore È in uso NotProcessed.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string L'identificatore Google del problema. I dettagli su questi errori possono essere trovato nei messaggi di errore relativi allo stato dei feed.

Esempi

Operazione riuscita

Di seguito è riportata una risposta a un modulo elaborato correttamente OTA_HotelInvCountNotifRQ messaggio.

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

Errori

Di seguito è riportata una risposta a un messaggio OTA_HotelInvCountNotifRQ non elaborati a causa di errori.

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