OTA_HotelInvCountNotifRQ

Richieste

Sintassi

La sintassi del messaggio OTA_HotelInvCountNotifRQ è la seguente:

<?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à relativa alla 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 di questo messaggio (in genere è utilizzato se il backend fornisce feed dei prezzi per più account partner).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Obbligatorio se è presente <POS>. Un contenitore per <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Obbligatorio se è presente <POS>. Definisce l'account partner.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string L'account partner di questo messaggio. Il valore della stringa è il valore della chiave del partner indicato nella pagina Impostazioni account di Hotel Center.

Nota: se hai un backend che fornisce feed per più account, questo valore deve corrispondere al valore dell'attributo partner del messaggio Transaction (Property Data) e al valore dell'attributo ID nell'elemento <RequestorID> del messaggio <OTA_HotelRateAmountNotifRQ> per lo stesso account.
OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Un contenitore per uno o più elementi <Inventory>.
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string L'identificatore univoco della struttura. Questo valore deve corrispondere all'ID hotel specificato utilizzando <id> nell'elemento <listing> del feed elenco hotel. L'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 una singola 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 (inclusa) dell'intervallo di date (in base al fuso orario della proprietà).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date La data di fine (inclusa) dell'intervallo di date (in base al fuso orario della proprietà). Deve essere maggiore o uguale al valore start. Se start e end sono uguali, l'aggiornamento verrà applicato 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, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra 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, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean Imposta su true o 1 per includere esplicitamente i mercoledì.

Se è impostato su true, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Imposta su true o 1 per includere esplicitamente i giovedì.

Se è impostato su true, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra 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, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean Imposta su true o 1 per includere esplicitamente i sabati.

Se è impostato su true, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Imposta su true o 1 per includere esplicitamente le domeniche.

Se è impostato su true, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra Start e End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string L'identificatore univoco dell'inventario (tipo di camera). Questo valore è mappato a <RoomID> in un messaggio Transactions (Property Data).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Un contenitore per la definizione di un singolo conteggio dell'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 Numero di camere disponibili che possono essere prenotate per il tipo di camera. Un valore pari a zero indica che il tipo di camera è esaurito. Un valore negativo viene considerato pari a zero.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

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

  • 2: disponibilità definita.

Esempi

Inventario rimanente

Imposta 5 camere 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

La sintassi del messaggio OTA_HotelInvCountNotifRS è la seguente:

<?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 di disponibilità.
OTA_HotelInvCountNotifRS / @TimeStamp 1 DateTime La data e l'ora di creazione di questo messaggio.
OTA_HotelInvCountNotifRS / @EchoToken 1 string L'identificatore univoco del messaggio OTA_HotelInvCountNotifRQ associato.
OTA_HotelInvCountNotifRS / Success 0..1 Success Indica che il messaggio OTA_HotelInvCountNotifRQ è stato elaborato correttamente.

In ogni messaggio è presente <Success> o <Errors>.
OTA_HotelInvCountNotifRS / Errors 0..1 Errors Un contenitore per uno o più problemi riscontrati durante l'elaborazione del messaggio OTA_HotelInvCountNotifRQ.

In ogni messaggio è presente <Success> o <Errors>.
OTA_HotelInvCountNotifRS / Errors / Error 1..n Error La descrizione di un errore riscontrato durante l'elaborazione del messaggio OTA_HotelInvCountNotifRQ. Per informazioni dettagliate su questi errori, consulta la sezione Messaggi di errore relativi allo stato dei feed.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer EWT (Error Warning Type) OpenTravel Alliance associato all'errore. Viene utilizzato solo il valore 12 (Processing exception).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer ERR (codice di errore) 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. Viene utilizzato solo il valore NotProcessed.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string Identificatore Google del problema. Per informazioni dettagliate su questi errori, consulta la sezione Messaggi di errore relativi allo stato dei feed.

Esempi

Operazione riuscita

Di seguito è riportata una risposta a un messaggioOTA_HotelInvCountNotifRQ elaborato correttamente.

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