Please check this page regularly for functionality and feature updates to SMX For Apps - Reservation API.
Removed / Modified / Added to the specification.
Upcoming Change July 2023
Addition of: ResStatus=”Redacted”
Impact
Reservations with a @ResStatus of “Redacted” will have all ‘PII’ data removed. The redaction timestamp will be added to the reservation comments.
Important: The SMX partner application should be able to accept all ResStatus values and respond with Success (200 OK status). It will now need to handle the additional ‘Redacted’ value.
XML Sample of new ResStatus
<HotelReservations>
<HotelReservation ResStatus="Redacted" CreateDateTime="2017-09-19T18:02:44+00:00" CreatorID="LINDA-RESAGENT" LastModifyDateTime="2017-09-19T18:13:51+00:00" LastModifierID="651651651651">
<POS>…</POS>
<UniqueID ID="BDC-3685569477"/>
<RoomStays>…</RoomStays>
<ResGlobalInfo>
<Comments>
<Comment>
<Text>Redacted at 2017-09-19T18:02:44+00:00</Text>
</Comment>
</Comments>
</ResGlobalInfo>
</HotelReservation>
</HotelReservations>
Updated 09-February-2022
Addition of: ResGlobalInfo / Total / Taxes
OTA_HotelResNotifRQ
Element | Attribute | Number | Description |
|---|---|---|---|
OTA_HotelResNotifRQ / HotelReservations / HotelReservation / ResGlobalInfo / Total |
| 1 | Mandatory |
| @AmountBeforeTax | 0..1 | The total amount not including any associated tax (e.g., sales tax, VAT, GST or any associated tax). |
| @AmountAfterTax | 0..1 | The total amount including all associated taxes (e.g., sales tax, VAT, GST or any associated tax). |
| @CurrencyCode | 0..1 | An ISO 4217 (3) alpha character code that specifies a monetary unit. |
OTA_HotelResNotifRQ / HotelReservations / HotelReservation / ResGlobalInfo / Total / Taxes |
| 0..1 | A collection of taxes relating to the total reservation cost. |
| @CurrencyCode | 0..1 | An ISO 4217 (3) alpha character code that specifies a monetary unit. |
| @Amount | 0..1 | A monetary amount of tax. |
OTA_HotelResNotifRQ / HotelReservations / HotelReservation / ResGlobalInfo / Total / Taxes / Tax | 0..99 | This element allows for both percentages and flat amounts. If one field is used, the other should be zero since logically, taxes should be calculated in only one of the two ways. | |
| @Code | 0..1 | Code identifying the fee (e.g.,agency fee, municipality fee). Refer to OpenTravel Code List Fee Tax Type (FTT). |
| @Amount | 0..1 | A monetary amount of tax. |
| @CurrencyCode | 0..1 | An ISO 4217 (3) alpha character code that specifies a monetary unit. |
| @Percent | 0..1 | Fee percentage; if zero, assume use of the Amount attribute (Amount or Percent must be a zero value). |
OTA_HotelResNotifRQ / HotelReservations / HotelReservation / ResGlobalInfo / Total / Taxes / Tax / TaxDescription | 0..5 | Text description of the taxes. | |
OTA_HotelResNotifRQ / HotelReservations / HotelReservation / ResGlobalInfo / Total / Taxes / Tax / TaxDescription / Text | 0..n | Textual description of Discount Reason. |
Updated 07-February-2022
Removal of: ResGlobalInfo / DepositPayments / GuaranteePayment / AcceptedPayments / AcceptedPayment / DirectBill @amount @numberOfNights
OTA_HotelResNotifRQ
OTA_HotelResNotifRQ / HotelReservations / HotelReservation / ResGlobalInfo / DepositPayments / GuaranteePayment / AcceptedPayments / AcceptedPayment / DirectBill |
| 0..1 | Details of a direct billing arrangement. |
| @DirectBill_ID | 0..1 | Identifier for the organization to be billed directly for travel services. |
@Amount | 0..1 | A monetary amount taken for the deposit. | |
@NmbrOfNights | 0..1 | The number of nights of the hotel stay that are used to calculate the fee amount. |
Updated 04-February-2022
Removal of: HotelReservation / Services / Service / ServiceDetails / GuestCounts / TimeSpan
Addition of: HotelReservation / Services / Service / ServiceDetails / TimeSpan
OTA_HotelResNotifRQ
OTA_HotelResNotifRQ / HotelReservations / HotelReservation / Services / Service / ServiceDetails | 0..1 | Details on the Service including Guest Counts, Time Span of this Service, pointers to Res Guests, guest Memberships, Comments and Special Requests pertaining to this particular Service and finally financial information related to the Service, including Guarantee, Deposit and Payment and Cancellation Penalties. | |
OTA_HotelResNotifRQ / HotelReservations / HotelReservation / Services / Service / ServiceDetails / GuestCounts | 0..1 | A collection of Guest Counts associated to the whole Reservation or a particular Room Stay or Service. | |
OTA_HotelResNotifRQ / HotelReservations / HotelReservation / Services / Service / ServiceDetails / GuestCounts / TimeSpan | |||
@Start | 0..1 | The starting value of the time span. | |
@End | 0..1 | The ending value of the time span. | |
OTA_HotelResNotifRQ / HotelReservations / HotelReservation / Services / Service / ServiceDetails / GuestCounts / GuestCount | 0..99 | A recurring element that identifies the number of guests and ages of the guests. | |
@AgeQualifyingCode | 0..1 | A code representing a business rule that determines the charges for a guest based upon age range (e.g. Adult, Child, Senior, Child With Adult, Child Without Adult). This attribute allows for an increase in rate by occupant class. Refer to Age Qualifying Code List. | |
@Age | 0..1 | Defines the age of a guest. | |
@Count | 0..1 | The number of guests in one AgeQualifyingCode or Count. | |
@AgeBucket | 0..1 | Defines the age range category or bucket a guest can be booked into. This is typically used in conjunction with the age qualifying code to further define the applicable age range. | |
OTA_HotelResNotifRQ / HotelReservations / HotelReservation / Services / Service / ServiceDetails / TimeSpan | 0..1 | The Time Span which covers the Service. | |
@Start | 0..1 | The starting value of the time span. | |
@End | 0..1 | The ending value of the time span. |