Questa pagina è stata tradotta dall'API Cloud Translation.

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 (in genere utilizzato se il backend fornisce feed del prezzo per più account partner).
OTA_HotelInvCountNotifRQ / POS/ Source	1	Source	Obbligatorio se è presente `<POS>`. Un contenitore per l'elemento `<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 per questo messaggio. Questo valore stringa è il valore Chiave partner elencato 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 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 proprietà. Questo valore deve corrispondere all'ID hotel specificato utilizzando <id> nell'elemento <listing> del feed elenco hotel. L'ID hotel è anche elencato 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 uguale o superiore al valore di `start`. Se `start` e `end` sono uguali, l'aggiornamento verrà applicato alla data in questione.
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 esplicitamente impostati su `true` vengono esclusi (in effetti, vengono esclusi dalle date incluse in `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 esplicitamente impostati su `true` vengono esclusi (in effetti, vengono esclusi dalle date incluse in `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`, gli altri giorni della settimana non esplicitamente impostati su `true` vengono esclusi (in effetti, vengono esclusi dalle date incluse in `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`, gli altri giorni della settimana non esplicitamente impostati su `true` vengono esclusi (in effetti, vengono esclusi dalle date incluse in `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 esplicitamente impostati su `true` vengono esclusi (in effetti, vengono esclusi dalle date incluse in `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`, gli altri giorni della settimana non esplicitamente impostati su `true` vengono esclusi (in effetti, vengono esclusi dalle date incluse in `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`, gli altri giorni della settimana non esplicitamente impostati su `true` vengono esclusi (in effetti, vengono esclusi dalle date incluse in `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 definire un singolo conteggio dell'inventario.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount	1	InvCount	Definisce il numero di stanze disponibili che è possibile prenotare.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count	1	integer	Il numero di stanze 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 5rooms left forRoomID_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 di 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	L'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	L'identificatore di 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 messaggio OTA_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>