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_account_name"/>
    </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 "Chiave del partner" presente nella pagina Impostazioni account in 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 a quello dell'attributo ID nell'elemento <RequestorID> del tuo 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 proprietà. Questo valore deve corrispondere all'ID hotel specificato utilizzando <id> nell'elemento <listing> nel 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 dell'intervallo di date.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date La data di fine dell'intervallo di date. Deve essere maggiore o uguale al valore di start. Se start e end sono uguali, l'aggiornamento verrà applicato a tale 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 Transaction (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 Int 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. I valori validi sono:

  • 2: disponibilità definita.

Esempi

Esempio 1

Imposta 5 camere rimaste per RoomID_1 nelle date specificate.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2020-05-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Esempio 2

Contrassegna RoomID_1 come esaurito nelle date specificate.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2020-05-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-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
OTA_HotelInvCountNotifRS 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 (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. 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

Success

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

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2020-05-13T20:50:37-05:00"
                          Version="3.0">
  <Success/>
</OTA_HotelInvCountNotifRS>

Errors

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="2020-05-13T20:50:37-05:00"
                          Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>