Service

OTA_HotelDescriptiveContentNotifRQ

Fields

Field Description Type Min/max Notes
Services/
Service
Details of a service. object 0..* -
Service/
@Code
The Hotel Amenity Code for the service. HAC 1..1 -
Service/
@ExistsCode
Specifies if the service exists. enum 0..1 1 = yes, 2 = no. Default: 2. Required if @Code="218" (children welcome).
Service/
@Included
Specifies whether the service is included in the room price or comes at an extra charge. enum 0..1 Accepts: true, false, unknown. Default: unknown
Service/
@Price
The price for the service, in the property's default currency. int 0..1 Required if @Code is 173 (breakfast), 6000 (lunch), 6001 (dinner).
Service/
Features
Details about service features. array of Feature 0..1 Required if @Code is 218 or 5038.
Service/
Types
The types of service offered. array of Type 0..1 Currently used for breakfast services only.
Service/
Items
The items for the service offered. array of Item 0..1 Currently used for breakfast services only.
Service/
OperationTimes
Opening/Closing times for the service offered. array of OperationTime 0..1 Currently used for breakfast services only.

XML

<Service
  Code="5"
  Included="false" />
<Service
  Code="173"
  Price="14"
  CurrencyCode="EUR">
  <Types>
    ...
  </Types>
  <Items>
    ...
  </Items>
  <OperationTimes>
    ...
  </OperationTimes>
</Service>
<Service
  Code="218"
  ExistsCode="1"
  Quantity="2">
  <Features>
    ...
  </Features>
</Service>

OTA_HotelResNotifRQ & OTA_HotelResModifyNotifRQ

Feature res_new_services_format turned Off

Fields

Field Description Type Min/max Notes
Services/
Service
Contains details of a service (also: add-on) included in the reservation. object 0..* -
Service/
@ServiceRPH
Unique index number for the service. integer 0..1 Used for cross-referencing with ServiceRPH[@RPH].
Service/
@ServiceInventoryCode
The type of service/add-on. enum 0..1 Values listed under @ServiceInventoryCodeForAddons.
Service/
@ServicePricingType
The charge frequency/type (e.g.: per night; per person; etc.). enum 0..1 Values listed under @ServicePricingType.
Service/
ServiceDetails
The details of a Service. object 1..1 The contents of this element depend on the value of Service[@ServiceTypeCode], and can include the number of guests, the number of days the service is provided, and any fees that apply.

XML

<Service
  ServiceRPH="1"
  ServiceInventoryCode="22"
  ServicePricingType="3">
  <ServiceDetails>
    ...
  </ServiceDetails>
</Service>

Feature res_new_services_format turned On

Fields

Field Description Type Min/max Notes
Services/
Service
Contains details of a service (also: add-on & instay services) included in the reservation. object 0..* -
Service/
@ID
The ID for the Service that the reservation happened on. The service is an instance of Service type where the partner previously customized it. integer 0..1 Existing for instay services only
Service/
@instance
The ID for the service reservation. integer 0..1 Existing for instay services only
Service/
@ReservationStatusType
Service reservation status enum 0..1 Values listed under @ReservationStatusType
Service/
@Inclusive
Specifies whether the service is included in the price of the booking or comes at an extra charge. boolean 0..1
Service/
@URL
The URL that the partner can use to approve the reservation in case it’s needed. string 0..1 Existing for instay services only
Service/
@ServiceInventoryCode
Unique identifier for service types. integer 0..1 Existing for both Addons and instay services. Addons Ids are listed under @ServiceInventoryCodeForAddons. In-stay services Ids are listed under @ServiceInventoryCodeForInstayServices. Note this field is not enough to identify the type. It should be used in addition to ServiceCategoryCode
Service/
@ServiceCategoryCode
It has only two possible values ( “Addons” , “InStayServices” ). In booking there two sources for services, which are “Addons” and “InStayServices”. To uniquely identify any service. Two fields should be used: @ServiceCategoryCode + @ServiceInventoryCoded
Service/
@ServicePricingType
The charge frequency/type (e.g.: per night; per person; etc.). enum 0..1 Existing only for Addons. Values listed under @ServicePricingType.
Service/
@ServiceRPH
Unique index number for the service. integer 0..1 Existing only for Addons. Used for cross-referencing with ServiceRPH[@RPH].
Service/
ServiceDetails
The details of a Service. object 1..1 The contents of this element depend on the value of @ServiceCategoryCode + @ServiceInventoryCoded. It includes information about the service reservation, like customer comments. It also includes more information about the service itself
Service/
Price
It contains detailed information about the price of the service. object 1..* There can be more than one Price Tag. If the service has multiple rates, each rate will have a separate tag.
Service/
TPA_Extensions
It has extra identification information ServiceExtraIdentificationInfo about the Service that had reservation. Also It has the ReservationTime. object 0..1 Existing for Addons and instay services

XML

Instay service example
<Service
        ID="2808"
        instance="7546"
        ReservationStatusType="Reserved"
        Inclusive="0"
        URL="https://admin.booking.com/hotel/hoteladmin/extranet_ng/manage/booking.html?service_action=details&amp;hotel_id=555926&amp;service_req=7546&amp;res_id=1773108520"
        ServiceInventoryCode="6"
        ServiceCategoryCode ="InStayServices"
        ServicePricingType="0"
        >
    <Price NumberOfUnits="1">
        <Total CurrencyCode="EUR" AmountAfterTax="25" />
        <Base CurrencyCode="EUR" Type="per_bottle" AmountAfterTax="25"/>
    </Price>
    <TPA_Extensions>
        <ServiceExtraIdentificationInfo
           Title="Champagne"
           ServiceTypeName="champagne"
           AutoApproveEnabled="True"
         >
            <Attribute key="champagne_specifics_more">This service includes a bottle of cava (Catalan champagne), strawberries with chocolate, and a sensual kit.</Attribute>
            <Attribute key="moderation">1</Attribute>
        </ServiceExtraIdentificationInfo>
        <ReservationTime time="2019-03-07 03:35:51"></ReservationTime>
    </TPA_Extensions>
    <ServiceDetails>
        <Comments></Comments>
        <CancelPenalties CancelPolicyIndicator="False">

         </CancelPenalties>
        <DepositPayments>
            <GuaranteePayment>
                <Description>
                    <Text>Payment policy was not defined</Text>
                </Description>
            </GuaranteePayment>
        </DepositPayments>
    </ServiceDetails>
</Service>
Addon service example
<Service
        ServiceRPH="1"
        ServiceInventoryCode="1"
        ServicePricingType="4"
         ServiceCategoryCode ="Addons" 
        >
    <Price NumberOfUnits="18">
        <Total CurrencyCode="EUR" AmountAfterTax="54" />
        <Base CurrencyCode="EUR" Type="per person / per night" AmountAfterTax="3"/>
        <RateDescription>
            <Text>per person / per night</Text>
        </RateDescription>
    </Price>
    <ServiceDetails>
        <Comments>
            <Comment Name="Guest count">
                <Text>3</Text>
            </Comment>
            <Comment Name="Night count">
                <Text>6</Text>
            </Comment>
        </Comments>
        <CancelPenalties CancelPolicyIndicator="False"></CancelPenalties>
        <GuaranteePayment>
            <Description>
                <Text>Same payment method of the room reservation 24864713 </Text>
            </Description>
        </GuaranteePayment>
    </ServiceDetails>
    <TPA_Extensions>
        <ServiceExtraIdentificationInfo Title="Colazione" ServiceTypeName="Breakfast" >
            </ServiceExtraIdentificationInfo>
    </TPA_Extensions>
</Service>

@ServiceInventoryCodeForAddons

Specifies the type of service or add-on.

Value Name
1 Breakfast
2 Continental breakfast
3 American breakfast
4 Buffet breakfast
5 Full english breakfast
6 Lunch
7 Dinner
8 Half board
9 Full board
11 Breakfast for Children
12 Continental breakfast for Children
13 American breakfast for Children
14 Buffet breakfast for Children
15 Full english breakfast for Children
16 Lunch for Children
17 Dinner for Children
18 Half board for Children
19 Full board for Children
20 WiFi
21 Internet
22 Parking space
23 Extra bed
24 Baby cot

@ServiceInventoryCodeForInstayServices

Specifies the type of service or add-on.

Value Name
1 Late Check-out
2 Early Check-in
3 Late Check-in
4 Champagne
5 Wine
6 Flowers
7 Attraction
8 Airport Shuttle
9 Parking
10 Massage
11 Facial
12 Body
13 Christmas
14 New Year
15 Celebration Package
16 Ski Pass

@ServicePricingType

Specifies how the price for the service is calculated.

Value Description
0 Not applicable.
1 Once per stay.
2 Once per person, per stay.
3 Once per night.
4 Once per person, per night.
5 Percentage of total stay price.
6 Percentage of total stay price, per person.

@ReservationStatusType

Service reservations statuses.

Value Description
Cancelled This reservation has been cancelled.
Checked out The guest has checked out and the reservation has been changed to "Checked out" status
In-house This reservation has been check in, and is in "in-house" status.
No-show This reservation is in "no show" status. Typically this means the person for whom this reservation belonged did not chec
Request denied The request for the reservation has been denied.
Requested The reservation has been requested but has not yet been reserved.
Reserved The reservation has been reserved.
Waitlisted This reservation is in waitlist status and the reservation has not been confirmed.