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 |
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 |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | Imposta su true o 1 per includere esplicitamente i martedì.
Se impostato su |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | Imposta su true o 1 per includere esplicitamente il mercoledì.
Se impostato su |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | Imposta su true o 1 per includere esplicitamente il giovedì.
Se impostato su |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | Imposta su true o 1 per includere esplicitamente i venerdì.
Se impostato su |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | Imposta su true o 1 per includere esplicitamente il sabato.
Se impostato su |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | Imposta su true o 1 per includere esplicitamente la domenica.
Se impostato su |
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 è:
|
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.
|
OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | Un container per uno o più problemi riscontrati durante l'elaborazione
OTA_HotelInvCountNotifRQ 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>