Anfragen
Syntax
Die Nachricht OTA_HotelRateAmountNotifRQ
verwendet die folgende Syntax:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="message_ID"
TimeStamp="timestamp"
Version="3.0"
NotifType="[Overlay|Delta|Remove]"
NotifScopeType="[ProductRate]">
<POS>
<Source>
<RequestorID ID="partner_key"/>
</Source>
</POS>
<RateAmountMessages HotelCode="HotelID">
<RateAmountMessage>
<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"
RatePlanCode="PackageID"
RatePlanType="[26]" />
<Rates>
<Rate>
<BaseByGuestAmts>
<BaseByGuestAmt AmountBeforeTax="float"
AmountAfterTax="float"
CurrencyCode="currency"
NumberOfGuests="integer"/>
</BaseByGuestAmts>
<AdditionalGuestAmounts>
<AdditionalGuestAmount Amount="float"
AgeQualifyingCode="[10|8]"
MaxAge="integer"/>
</AdditionalGuestAmounts>
</Rate>
</Rates>
</RateAmountMessage>
</RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
Elemente und Attribute
Die Nachricht OTA_HotelRateAmountNotifRQ
enthält die folgenden Elemente und
Attribute:
Element / @Attribut | Häufigkeit | Typ | Beschreibung |
---|---|---|---|
OTA_HotelRateAmountNotifRQ | 1 | Complex element | Das Stammelement für eine Preisnachricht. |
OTA_HotelRateAmountNotifRQ / @xmlns | 0..1 | string (URI) | Der XML-Namespace. |
OTA_HotelRateAmountNotifRQ / @EchoToken | 1 | string | Eine eindeutige Kennung für diese Anfragenachricht. Dieser Wert wird
in der Antwortnachricht. Zulässige Zeichen sind a-z , A-Z , 0-9 , _ (underscore) und - (dash) . |
OTA_HotelRateAmountNotifRQ / @TimeStamp | 1 | DateTime | Erstellungsdatum und -uhrzeit der Nachricht. |
OTA_HotelRateAmountNotifRQ / @Version | 1 | decimal | Die OpenTravel-Nachrichtenversion. |
OTA_HotelRateAmountNotifRQ / @NotifType | 0..1 | enum | Der Benachrichtigungstyp, der für jede
Gültige Werte sind: Um zu verstehen, wie diese Attribute funktionieren, lesen Sie Beispiele
|
OTA_HotelRateAmountNotifRQ / @NotifScopeType | 0..1 | enum | Der Geltungsbereich von Gültige Werte sind:
|
OTA_HotelRateAmountNotifRQ / POS | 0..1 | POS | Ein Container zum Angeben des Partnerkontos für diese Nachricht (wird normalerweise verwendet, wenn Ihr Backend Preisfeeds für mehrere Partnerkonten. |
OTA_HotelRateAmountNotifRQ / POS / Source | 1 | Source | Erforderlich, wenn <POS> vorhanden ist. Ein Container für die
<RequestorID> |
OTA_HotelRateAmountNotifRQ / POS / RequestorID | 1 | RequestorID | Erforderlich, wenn <POS> vorhanden ist. Definition des Partners
Konto. |
OTA_HotelRateAmountNotifRQ / POS / RequestorID / @ID | 1 | string | Das Partnerkonto für diese Nachricht. Dieser Zeichenfolgenwert ist der
„Partnerschlüssel“ Wert aufgelistet auf
die
Seite „Kontoeinstellungen“ im Hotel Center.
Hinweis: Wenn Sie ein Back-End haben, das Feeds für mehrere
muss dieser Wert mit dem Wert |
OTA_HotelRateAmountNotifRQ / RateAmountMessages | 1 | RateAmountMessages | Eine Sammlung von <RateAmountMessage> -Elementen, die
Preise definieren. |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / @HotelCode | 1 | string | Die eindeutige Kennung für die Unterkunft. Dieser Wert muss mit der Mit <id> angegebene Hotel-ID in das Element <listing> im Hotel Listenfeed. Die Hotel-ID ist auch im Hotel Center aufgeführt. |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage | 1..n | RateAmountMessage | Ein Container zum Festlegen von Preisen für einen Zimmerpreis (Zimmertyp und -preis). Plankombination für einen Zeitraum). |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl | 1 | StatusApplicationControl | Definiert den Zeitraum sowie die IDs für den Zimmertyp
(InvTypeCode ) und Preisplan (RatePlanCode ). |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Start | 1 | Date | Das Startdatum (basierend auf der Zeitzone der Unterkunft), einschließlich, von Zeitraum |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @End | 1 | Date | Das Enddatum (basierend auf der Zeitzone der Unterkunft), einschließlich des Enddatums des
Zeitraum. Muss gleich oder größer als der Wert von start sein.
Wenn start und end gleich sind, wird die Aktualisierung angewendet
bis zu diesem Datum. Beachten Sie, dass Google Daten aus bis zu drei Jahren unterstützt. |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Mon | 0..1 | boolean | Legen Sie true oder 1 fest, um explizit einzuschließen
montags.
Mit der Einstellung |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Tue | 0..1 | boolean | Legen Sie true oder 1 fest, um explizit einzuschließen
Dienstags.
Mit der Einstellung |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Weds | 0..1 | boolean | Legen Sie true oder 1 fest, um explizit einzuschließen
Mittwochs.
Mit der Einstellung |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Thur | 0..1 | boolean | Legen Sie true oder 1 fest, um explizit einzuschließen
Donnerstags.
Mit der Einstellung |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Fri | 0..1 | boolean | Legen Sie true oder 1 fest, um explizit einzuschließen
Freitags.
Mit der Einstellung |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sat | 0..1 | boolean | Legen Sie true oder 1 fest, um explizit einzuschließen
Samstags.
Mit der Einstellung |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sun | 0..1 | boolean | Legen Sie true oder 1 fest, um explizit einzuschließen
Sonntags.
Mit der Einstellung |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @InvTypeCode | 1 | string | Die eindeutige Kennung für das Inventar (Zimmertyp). Dieser Wert wird zugeordnet
an <RoomID> in einer Nachricht „Transaktion (Unterkunftsdaten)“. |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanCode | 1 | string | Eine eindeutige Kennung für den Preisplan. Diese ID wird der
<PackageID> in einer Transaktion (Unterkunftsdaten)
angezeigt. Der Preisplan wird weiter definiert und
in <StatusApplicationControl> in beiden
<OTA_HotelRateAmountNotifRQ> und
<OTA_HotelAvailNotifRQ> Nachrichten. |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanType | 0..1 | string | Eine Kennung, die den Typ des ARI-Preismodells angibt,
für diese Preisaktualisierung gilt. Geben Sie diesen nur mit einem
Wert von 26 , wenn das auf der Aufenthaltsdauer basierende Preismodell verwendet wird. Ausschluss
Dieses Attribut gibt an, dass es sich um einen Preis pro Datum handelt.
aktualisieren. |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates | 0..1 | Rates | Container für eine Sammlung von <Rate> -Elementen. Wenn
NotifType ist "Remove" , dieses Element darf nicht
angegeben werden. Andernfalls muss dieses Element genau einmal angegeben werden. |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate | 1 | Rate | Container für eine Sammlung von <BaseByGuestAmts>
Elemente. |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @RateTimeUnit | 0..1 | String | Die Einheit, mit der die Aufenthaltsdauer angegeben wird. Die einzige unterstützte
Wert ist "Day" , was bedeutet, dass sich die Aufenthaltsdauer auf
in Tagen angegeben werden.
So verwenden Sie auf der Aufenthaltsdauer basierende Preise:
|
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier | 0..1 | Integer | Die Anzahl der RateTimeUnits , die sich aus der Länge von
zu diesem Preis bleiben.
Beispiel: Wenn der Wert von Die unter dieser So verwenden Sie auf der Aufenthaltsdauer basierende Preise:
|
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts | 1 | BaseByGuestAmts | Container für eine Sammlung von Grundgebühren. |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt | 1..n | BaseByGuestAmt | Gibt Zimmerpreise in einer bestimmten Währung an. Der Preis kann
pro Belegung, indem mehrere <BaseByGuestAmt> verwendet werden
-Elemente mit jeweils einem anderen Wert für NumberOfGuests .
Andernfalls gilt der Preis für eine maximale Anzahl von Personen.
definiert durch NumberOfGuests . |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountBeforeTax | 0..1 | float |
Der Tagespreis des Zimmerpreises vor Steuern und Gebühren. Sowohl Wenn Sie Angebote verwenden,
Der Rabatt wird auf |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountAfterTax | 0..1 | float | Der Tagespreis des Zimmerpreises nach Abzug der anwendbaren Steuern und
Gebühren. Wenn AmountAfterTax angegeben ist, trennen Sie jede Property.
<TaxFeeInfo> Nachrichten müssen nicht gesendet werden. Dieses
Attribut kann in Kombination mit AmountBeforeTax verwendet werden
um sowohl Basis- als auch Gesamtpreise bereitzustellen, die Nutzern in
in bestimmten Regionen.
Warnung: Wenn Sie Angebote verwenden,
raten von der Verwendung von Hinweis: Wenn |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @CurrencyCode | 1 | enum | Der ISO 4217 (3)-Alphacode für eine bestimmte Geldeinheit.
Diese finden Sie in der Liste der unterstützten Währungen. |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @NumberOfGuests | 0..1 | integer | Maximale Anzahl von Gästen, die zu diesem Preis aufgenommen werden können.
Wenn keine Angabe gemacht wird, werden standardmäßig 2 Gäste verwendet.
Hinweis: Wenn |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts | 0..1 | AdditionalGuestAmounts | Container für eine Sammlung von Gebühren für zusätzliche Gäste.
Diese Syntax ist nützlich, wenn zusätzliche Gäste- oder untergeordnete Preise
ändern sich je nach Datum. Erwägen Sie die Verwendung der effizienteren
Beispiel: Angenommen, Basispreise sind für 1 und 2 angegeben. für Erwachsene geeignet ist.
|
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount | 0..n | AdditionalGuestAmount | Gibt Preise basierend auf dem Gasttyp an, angegeben durch
AgeQualifyingCode und, falls zutreffend, Alter des Gasts
angegeben durch MaxAge .
|
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @AgeQualifyingCode | 1 | enum | Definiert die Art des zusätzlichen Gasts (Erwachsener oder Kind). Gültig
Optionen sind:
<ph type="x-smartling-placeholder">
|
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @MaxAge | 0..1 | integer | MaxAge muss angegeben werden, wenn
AgeQualifyingCode hat den Wert 8 . Darf nicht
wird angegeben, wenn AgeQualifyingCode gleich 10 ist.
Wenn Sie den Wert Werte über Mehrere Kinderalter können durch separate
|
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @Amount | 1 | float | Betrag vor Steuern und Gebühren, die jeweils zum Basispreis hinzugefügt werden
zusätzlicher Gast.
Steuern und Gebühren, die von den Belegungen der Insassen abhängen Altersangaben muss angegeben werden durch
das |
Beispiele
Dieser Abschnitt enthält Codebeispiele, die zeigen, wie Sie:
- Basis- und Gesamtpreise einrichten
- Preise hinzufügen, überlagern und entfernen
- Zusätzliche Gästebeträge hinzufügen, überlagern und entfernen
- Auf der Aufenthaltsdauer basierende Preise einrichten
- Auf der Aufenthaltsdauer basierende Preise hinzufügen, überlagern und entfernen
Wenn Sie die Werte add
, overlay
oder remove
festlegen, können die Zeiträume
je nach Ihren Zielen gleich oder unterschiedlich sind. So können Sie beispielsweise
overlay
festlegen, dass nur wenige Wochen für die Feiertage im Dezember und nicht
Gesamter Bereich für „Preis hinzufügen“ angezeigt. Dadurch wird die Belegung
nur für diesen Zeitraum.
Preis pro Datum
Für einen bestimmten Zimmer- und Preisplan können maximal 50 Belegungsraten pro Property. Wenn die Preise für alle Belegungen identisch sind, sollten Sie einfach den maximale Belegungen mit dem erforderlichen Preis. Daraus folgt Google, dass und die niedrigeren Belegungen ebenfalls denselben Basispreis.
Basis- und Gesamtpreise einrichten
Beispiel 1
Basispreis (ohne Steuern oder Gebühren) für eine Standardbelegung (Doppel). In dieser
müssen Steuern und Gebühren für die Unterkunft mit einem
<TaxFeeInfo>
-Nachricht. Der Basispreis ist höher
für Nutzer, die in bestimmten Regionen suchen.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" CurrencyCode="USD"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Beispiel 2
Grund- und Gesamtpreis für die Standardbelegung (Doppel). In diesem Modell werden Steuern
und Gebühren sollten nicht separat mit <TaxFeeInfo>
definiert werden.
Nachrichten. Der Basispreis wird bei Suchanfragen von
in bestimmten Regionen.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" AmountAfterTax="110.00" CurrencyCode="USD"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Beispiel 3
Gesamtpreis (mit Steuern und Gebühren) für mehrere Belegungen. Bei diesem Modell
Steuern und Gebühren sollten nicht separat mit <TaxFeeInfo>
definiert werden
Nachrichten.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountAfterTax="100.00" CurrencyCode="USD" NumberOfGuests="1"/> <BaseByGuestAmt AmountAfterTax="110.00" CurrencyCode="USD" NumberOfGuests="2"/> <BaseByGuestAmt AmountAfterTax="120.00" CurrencyCode="USD" NumberOfGuests="3"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Beispiel 4
Basis- und Gesamtpreis für mehrere Zimmertypen und Preispläne in Zeiträume zu vergleichen.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" AmountAfterTax="110.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> <RateAmountMessage> <StatusApplicationControl Start="2020-05-01" End="2020-05-31" InvTypeCode="RoomID_2" RatePlanCode="PackageID_2"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="200.00" AmountAfterTax="220.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Preise hinzufügen, überlagern und entfernen
Es gibt ein Limit von 5.000 Produkten (Zimmertyp und Paket).
Kombinationen – pro Property. Benachrichtigung Overlay
oder Remove
verwenden
, um zuvor definierte Produkte zu entfernen.
Preise hinzufügen
Legen Sie NotifType
auf Delta
fest, um Preise pro Belegung hinzuzufügen für
RoomID_1 und PackageID_1 zwischen 20.10.2021 und 31.12.2021. Beachten Sie, dass
Google unterstützt die Daten von bis zu drei Jahren.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Delta" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" CurrencyCode="USD" NumberOfGuests="1"/> <BaseByGuestAmt AmountBeforeTax="110.00" CurrencyCode="USD" NumberOfGuests="2"/> <BaseByGuestAmt AmountBeforeTax="120.00" CurrencyCode="USD" NumberOfGuests="3"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Preise überlagern
Legen Sie NotifType
auf Overlay
fest, um alle pro Belegung zu löschen
Preise für RoomID_1 und PackageID_1 zwischen 20.10.2021 und 31.12.2021
und ersetzen Sie sie durch die neu angegebenen Preise pro Belegung.
Wenn diese Nachricht beispielsweise nach dem Nachricht, die Preise für Belegung 1, 2 und 3 werden gelöscht und nur die Preise für die neue Belegung 1 Preis gespeichert werden. Sie können auch einen kürzeren Zeitraum festlegen (z.B.: 20.12.2021 und 31.12.2021), um nur einen Teil der Belegung an bestimmten Tagen (z. B. an Feiertagen).
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Overlay" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="200.00" CurrencyCode="USD" NumberOfGuests="1"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Preise entfernen
Legen Sie NotifType
auf Remove
fest, um alle Preise pro Belegung zu löschen
Preise für RoomID_1 und PackageID_1 zwischen 20.10.2021 und 31.12.2021.
Wenn diese Nachricht z. B. nach einem der beiden werden keine Preise pro Belegung gespeichert.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Remove" NotifScopeType="ProductRate">> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Zusätzliche Gastbeträge hinzufügen, überlagern und entfernen
Beträge hinzufügen
Legen Sie NotifType
auf Delta
fest, um Basispreise hinzuzufügen für
Belegung 1 und 2 und zusätzliche Gästebeträge für Zimmer-ID_1 und
PackageID_1 zwischen 20.10.2021 und 31.12.2021.
Zusätzliche Beträge für Gäste werden auf den Basispreis aufgeschlagen, der von der Belegung in der Suchanfrage eines Nutzers bestimmt werden. Der angegebene Nutzer Die Belegung muss innerhalb der Kapazität von RoomID_1 liegen.
In diesem Beispiel werden zusätzliche Gastbeträge wie folgt angewendet:
- 5 $ für Kinder von 0 bis 10 Jahren (einschließlich).
- 10 $ für Kinder im Alter von 11 bis 17 Jahren (einschließlich).
- 20 $ für Erwachsene.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Delta" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" CurrencyCode="USD" NumberOfGuests="1"/> <BaseByGuestAmt AmountBeforeTax="110.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> <AdditionalGuestAmounts> <AdditionalGuestAmount Amount="5.00" AgeQualifyingCode="8" MaxAge="10" /> <AdditionalGuestAmount Amount="10.00" AgeQualifyingCode="8" MaxAge="17" /> <AdditionalGuestAmount Amount="20.00" AgeQualifyingCode="10" /> </AdditionalGuestAmounts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Beträge einblenden
Legen Sie NotifType
auf Overlay
fest, um alle pro Belegung zu löschen
Preise und alle zusätzlichen Gastbeträge für RoomID_1 und PackageID_1
zwischen dem 20.10.2021 und 31.12.2021
Preise pro Belegung und zusätzliche Beträge angegeben werden.
Wenn diese Nachricht beispielsweise nach dem Nachricht, die Preise für die Basisbelegung 1 und 2 werden gelöscht und nur die neuen Basispreise Preis für Belegung 1 gespeichert. Die vorherige Gruppe zusätzlicher Gäste werden gelöscht und nur die neuen Beträge gespeichert. Für zusätzliche Gästebeträge wird jetzt der neue Preis für Belegung 1 als Basispreis an. Nach diesem Update sind keine weiteren Gäste mehr für untergeordnete Publisher festgelegt.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Overlay" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="200.00" CurrencyCode="USD" NumberOfGuests="1"/> </BaseByGuestAmts> <AdditionalGuestAmounts> <AdditionalGuestAmount Amount="30.00" AgeQualifyingCode="10" /> </AdditionalGuestAmounts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Beträge entfernen
Legen Sie NotifType
auf Delete
fest, um alle pro Belegung zu löschen
Basispreise und alle zusätzlichen Gastbeträge für RoomID_1 und PackageID_1
20.10.2021 und 31.12.2021.
Wenn diese Nachricht z. B. nach einem der beiden Nachrichten, keine Basispreise pro Belegung oder zusätzliche Gästebeträge gespeichert werden.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Remove" NotifScopeType="ProductRate">> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Nur zusätzliche Gastbeträge entfernen
Legen Sie NotifType
auf Delta
fest und geben Sie eine leere
<AdditionalGuestAmounts>
-Element, um alle zu löschen
zusätzliche Gastbeträge für RoomID_1 und PackageID_1, ohne dass dies davon betroffen ist
Basispreise zwischen dem 20.10.2021 und 31.12.2021.
Wenn diese Nachricht z. B. nach einem der beiden Nachrichten werden nur die Basisbeträge gespeichert.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Delta" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <AdditionalGuestAmounts/> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Auf der Aufenthaltsdauer basierende Preise
Auf der Aufenthaltsdauer basierende Preise einrichten
Beispiel 1
Legen Sie Preise für 1, 2 oder 3 Übernachtungen ab dem 18.05.2020 fest. Die Der Gesamtpreis für 1, 2 und 3 Übernachtungen beträgt in diesem Beispiel 100 $. 180 $ bzw. 240 $.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-18" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1" RatePlanType="26"/> <Rates> <Rate UnitMultiplier="1" RateTimeUnit="Day"> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> <Rate UnitMultiplier="2" RateTimeUnit="Day"> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="90.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> <Rate UnitMultiplier="3" RateTimeUnit="Day"> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="80.00" CurrencyCode="USD" NumberOfGuests="2" /> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Auf der Aufenthaltsdauer basierende Preise hinzufügen, überlagern und entfernen
Aufenthaltsdauer hinzufügen
Bei auf der Aufenthaltsdauer basierenden Preisen können mit einem Delta
-Vorgang Preise
werden schrittweise für die Check-in-Zeiträume aktualisiert, die in
<StatusApplicationControl>
und für alle Aufenthaltsdauern
jedes untergeordnete Rate
-Elements
UnitMultiplier
.
Für jedes zutreffende Check-in-Datum und jede Aufenthaltsdauer, alle Belegungen Preise müssen angegeben werden.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0" NotifType="Delta" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-18" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1" RatePlanType="26"/> <Rates> <Rate UnitMultiplier="3" RateTimeUnit="Day"> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="80.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Aufenthaltsdauer(n) einblenden
Bei auf der Aufenthaltsdauer basierenden Preisen ist ein Overlay
-Vorgang
ersetzt die Preise für alle Aufenthaltsdauern des Produkts und das Anreisedatum
in <StatusApplicationControl>
angegebenen Bereich.
Mit dieser Nachricht werden die Preise pro Belegung für alle Aufenthaltsdauern im angegebene Ankunftsdaten werden entfernt und durch eine Doppelbelegung ersetzt. Preis, der nur für die Aufenthaltsdauer von 3 definiert ist.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0" NotifType="Overlay" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-18" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1" RatePlanType="26"/> <Rates> <Rate UnitMultiplier="3" RateTimeUnit="Day"> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="80.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Aufenthaltsdauer entfernen
Bei auf der Aufenthaltsdauer basierenden Preisen werden die Preise durch einen Remove
-Vorgang entfernt
für die gesamte Aufenthaltsdauer des Produkts und den Check-in-Zeitraum, die in
<StatusApplicationControl>
.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Remove" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1" RatePlanType="26"/> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
Antworten
Syntax
Die Nachricht OTA_HotelRateAmountNotifRS
verwendet die folgende Syntax:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS 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_HotelRateAmountNotifRS>
Elemente und Attribute
Die Nachricht OTA_HotelRateAmountNotifRS
enthält Folgendes:
-Elemente und -Attribute:
Element / @Attribut | Häufigkeit | Typ | Beschreibung |
---|---|---|---|
OTA_HotelRateAmountNotifRS | 1 | Complex element | Das Stammelement für eine Antwort auf eine Verfügbarkeitsnachricht. |
OTA_HotelRateAmountNotifRS / @TimeStamp | 1 | DateTime | Erstellungsdatum und -uhrzeit der Nachricht. |
OTA_HotelRateAmountNotifRS / @EchoToken | 1 | string | Die eindeutige Kennung der zugehörigen
OTA_HotelRateAmountNotifRQ -Nachricht. |
OTA_HotelRateAmountNotifRS / Success | 0..1 | Success | Gibt an, dass die Nachricht OTA_HotelRateAmountNotifRQ war
erfolgreich verarbeitet.
Entweder |
OTA_HotelRateAmountNotifRS / Errors | 0..1 | Errors | Ein Container für ein oder mehrere Probleme, die bei der Verarbeitung der
OTA_HotelRateAmountNotifRQ -Nachricht.
Entweder |
OTA_HotelRateAmountNotifRS / Errors / Error | 1..n | Error | Die Beschreibung eines Fehlers, der bei der Verarbeitung der
OTA_HotelRateAmountNotifRQ -Nachricht. Details zu diesen
finden Sie unter Fehlermeldungen für den Feedstatus. |
OTA_HotelRateAmountNotifRS / Errors / Error / @Type | 1 | integer | Der EWT der OpenTravel Alliance (Fehlerwarnungstyp), der mit dem
Fehler. Nur der Wert 12 (Processing exception) wird verwendet. |
OTA_HotelRateAmountNotifRS / Errors / Error / @Code | 1 | integer | Der mit dem Fehler verknüpfte OpenTravel Alliance ERR (Error Code, Fehlercode).
Nur der Wert 450 (Unable to process) wird verwendet. |
OTA_HotelRateAmountNotifRS / Errors / Error / @Code | 1 | enum | Der Status der ursprünglichen Anfrage. Nur der Wert
NotProcessed wird verwendet. |
OTA_HotelRateAmountNotifRS / Errors / Error / @ShortText | 1 | string | Die Google-Kennung für das Problem. Details zu diesen Fehlern können Sie finden sie unter Fehlermeldungen zum Feedstatus. |
Beispiele
Erfolg
Im Folgenden finden Sie eine Antwort auf eine erfolgreich verarbeitete OTA_HotelRateAmountNotifRQ-Nachricht.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0"> <Success/> </OTA_HotelRateAmountNotifRS>
Fehler
Im Folgenden finden Sie eine Antwort auf eine OTA_HotelRateAmountNotifRQ-Nachricht, die nicht aufgrund von Fehlern verarbeitet werden.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0"> <Errors> <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error> </Errors> </OTA_HotelRateAmountNotifRS>