Service

Multiple ancestors

Service is a descendant of:

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/ `@CurrencyCode`	Specifies the currency code.	currencycode	1..1	If specified, must match the property's default currency code.
_Service/ `@ExistsCode`	Specifies if the service exists, i.e. it sets if the facility is present or missing.	enum	0..1	`1` = yes(present), `2` = no(missing). Default: `1`.
_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
_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="5052"
  ExistsCode="2" />
<Service
  Code="173"
  Price="14"
  CurrencyCode="EUR">
  <Types>
    ...
  </Types>
  <Items>
    ...
  </Items>
  <OperationTimes>
    ...
  </OperationTimes>
</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`	Specifies an index number that works as a cross-reference to link guests (ResGuest) to rooms RoomStay.	integer	0..1
_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.

Service

OTA_HotelDescriptiveContentNotifRQ

Fields

XML

OTA_HotelResNotifRQ & OTA_HotelResModifyNotifRQ

Feature res_new_services_format turned Off

Fields

XML

Feature res_new_services_format turned On

Fields

XML

Instay service example

Addon service example

@ServiceInventoryCodeForAddons

@ServiceInventoryCodeForInstayServices

@ServicePricingType

@ReservationStatusType

Related endpoints

Feature `res_new_services_format` turned Off

Feature `res_new_services_format` turned On