This document is designed to clarify each of the Ctrip

integration content APIs for the technical details.

In each section, Partner will also find sample requests,

responses, as well as the comment of each node, field and
attribute.

Ctrip Integration Content

API Specification
Version：2.2

Ctrip.com
1 携程静态信息接口文档

Index
Overview ........................................................................................................................................................3
History ............................................................................................................................................................3
Access Web Services ................................................................................................................................5
Ctrip Content System Structure..............................................................................................................6

1 Authentication......................................................................................................................................7

1.1 Authentication Sample& Soap Structure .......................................................................7

1.2 Authentication Element Definition ....................................................................................8

2 Hotel Content.......................................................................................................................................8

2.1 XML Request ..........................................................................................................................9

2.2 XML Request Node Definition ........................................................................................ 16

2.3 XML Response ................................................................................................................... 25

3 Basic Room Content ...................................................................................................................... 26

3.1 XML Request ....................................................................................................................... 27

3.2 XML Request Node Definition ........................................................................................ 31

3.3 XML Response ................................................................................................................... 38

4 Sub Room Content ......................................................................................................................... 38

4.1 XML Request ....................................................................................................................... 39

4.2 XML Request Node Definition ........................................................................................ 41

4.3 XML Response ................................................................................................................... 45

5 Retrieve the Status of Content Update .................................................................................... 46

5.1 XML Request ....................................................................................................................... 46

5.2 XML Response ................................................................................................................... 46

2 携程静态信息接口文档

5.3 XML Response Node Definition .................................................................................... 48

5.4 Status ..................................................................................................................................... 49

6 Appendix ............................................................................................................................................ 50

6.1 Hotel Facility Code ............................................................................................................ 50

6.2 Room Facility Code ........................................................................................................... 53

6.3 Credit Card Type ................................................................................................................ 56

6.4 Ctrip Room Type ................................................................................................................ 57

6.5 Room View ........................................................................................................................... 58

6.6 Language Code .................................................................................................................. 59

6.7 Basic Room Bed Type Code .......................................................................................... 59

6.8 Nationality Possible Combinations ............................................................................... 60

6.9 Cancellation Policy Samples .......................................................................................... 61

6.10 Hotel Classification List ....................................................................................................... 62

6.11 CheckinWay list ..................................................................................................................... 66
3 携程静态信息接口文档

Overview
This document describes
 XML specifications for one or more supported operation(s) within the Ctrip
integration interface based on the OTA 2015B standard.
 The development scope.
 Formats of the individual XML tags & applicable values.
 XML message instances (samples). In the message instances below, field
names in bold indicate mandatory fields.
 Other considerations related to the specific operation or set of operations.

History
Version Date Revise by Comment

1.0 2016/04 Vincent Lin Created

2.0 2018/06 Angel Liu Modify
1.Add the attribute [BookingOffsetUnit]
under the node [BookingRule] in the sub-
2.1 2018/07 Angel Liu room request;
2.Add the value [AfterConfrimation] for the
node [OffsetDropTime] in all cancel policy;
Modify the bed type and add the combined
2.2 2018/08 Angel Liu
case of the bed type
2.3 2018/10 Wood Lin Add multilingual language code
Add more bed types on the basic room in
the appendix ;
Add more combined bed types cases to
the basic room ;
Add bed types and the combined bed type
2.4 2019/04 Angel Liu
cases to the sub room ;
Multi - language code uniform case
specification ;
Add the applicable nationality and people
in the sub room and combinations in the
4 携程静态信息接口文档

appendix ;
Add more cases and descriptions about the
cancellation in the appendix ;
Remove the value [Assistive Animals Only ] of
the attribute [PetsAllowedCode] ;
Add the PKG code 502 in all the attribute
[RatePlanCategory];
Add more case about the room
Sizemeasurement and Floor ;
Add Homestay fields:
HotelCategory
PolicyStay
PolicyCheckIn
3.0 2019/8 Jelly Ding
HostInfo
Visible: Whether to show the hotel's full
address before booking
RoomSpec
Support the earliest and latest time limit at
sub-room level。
3.1 2019/12 Jelly Ding
Add Homestay field：
LicenseInfo
5 携程静态信息接口文档

Access Web Services

Test https://vendor-
Environment ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelStaticInfoService.asmx

Live/Production
https://vendor.ctrip.com/Hotel/OTAReceive/HotelStaticInfoService.asmx
Environment
6 携程静态信息接口文档

Ctrip Content System Structure

7 携程静态信息接口文档

1 Authentication

When partners come to access to the Ctrip Push API service, they should provide their

authorized account info in the POS node of any request.。

1.1 Authentication Sample& Soap Structure

<OTA_HotelDescriptiveContentNotifRQ Target="Production" PrimaryLangID="zh-CN"
Version="1.0" TimeStamp="2016-02-13T09:30:47Z"
xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance">
<POS>
<Source>
<!--ID：Partner ID-->
<!--MessagePassword：Partner’s password used to invoke API-->
<RequestorID ID="32" MessagePassword="P@ssw0rd" Type="1">
<CompanyName Code="C" CodeContext="1" />
</RequestorID>
</Source>
</POS>
...

</OTA_HotelDescriptiveContentNotifRQ>

Soap Information
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://w
ww.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header/>
<soap:Body>
<! -- A request of a specific type will be put here. -->
</soap:Body>
</soap:Envelope>

The full request will be like below.

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://w
ww.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header/>
<soap:Body>
8 携程静态信息接口文档

<OTA_HotelDescriptiveContentNotifRQ Target="Production" PrimaryLangID="zh-CN"

Version="1.0" TimeStamp="2016-02-13T09:30:47Z"
xmlns="http://www.opentravel.org/OTA/2003/05">
<POS>
<Source>
<!--ID：Partner ID-->
<!--MessagePassword：Partner’s password used to invoke API-->
<RequestorID ID="32" MessagePassword="P@ssw0rd" Type="1">
<CompanyName Code="C" CodeContext="1" />
</RequestorID>
</Source>
</POS>
...
</OTA_HotelDescriptiveContentNotifRQ>
</soap:Body>
</soap:Envelope>
In the remaining document, Soap part is not depicted in the samples.

1.2 Authentication Element Definition

Node Comment Mandatory
Target Default Value:Prodcut •
PrimaryLangID Default Value:zh-CN •
Version Default Value:1.0 •
Default
TimeStamp •
Value:CurrentTime(Timezone:GMT+8)
ID user name •
MessagePassword Partner's password used to access API •
Type It is always "1" •
CodeContext Partner ID •
Code It is always "C" •

2 Hotel Content

Hotel generation and content update interface, the partner can use it to generate a

new hotel in Ctrip system or update the content on the existing hotel.
9 携程静态信息接口文档

Note 1：

The field in table with mark • means it is mandatory, it must be filled in xml request

passed to Ctrip. Others are optional, but it is better that partner fill that as full as

possible. The reason is the content affect that user performance and the number of

reservation the guest makes on that hotel.

Note 2：

It is allowed to pass the status of hotel in partner system via this interface, which

means Ctrip also closes the hotel in Ctrip system according to that status passed by

partner. But it is a complicated business logic to open that, although the first necessary

condition is “Open” status passed.

Note 3：

It is only allowed to remove all values in the Collection data, no single update. The

behavior is to add the collection node and leave the empty value in that list.

EG: To remove the image on that hotel, only need add the ImageItems node and keep

it empty.

< ImageItems >

</ ImageItems >

2.1 XML Request

<OTA_HotelDescriptiveContentNotifRQ Target="Production" PrimaryLangID="zh-CN"

10 携程静态信息接口文档

Version="1.0" TimeStamp="2016-02-13T09:30:47Z"
xmlns="http://www.opentravel.org/OTA/2003/05">
<POS>
<Source>
<!--ID：Partner ID -->
<!--MessagePassword：Partner’s password used to invoke API -->
<RequestorID ID="32" MessagePassword="P@ssw0rd" Type="1" />
<CompanyName Code="C" CodeContext="1" />
</Source>
</POS>
<!--ChainName：Partner Name-->
<!--BrandName：Hotel Brand Name-->
<!--HotelCode：Hotel Code-->
<!--HotelCityCode:Ctrip Hotel ID -->
<HotelDescriptiveContents ChainName="Tourico" BrandName="JW Marriott"
HotelCode="1332484">
<HotelDescriptiveContent>
<!--HotelStatus：Hotel Status in partner system
Open：Active
Closed：Deactivated
-->
<!--WhenBuilt：Established time -->
<HotelInfo HotelStatus="Active" WhenBuilt="2005-01" HotelCategory="Hotels">
<Descriptions>
<MultimediaDescriptions>
<MultimediaDescription>
<TextItems>
<!--Title：Hotel Name-->
<!--Brief：Hotel Shorter Description-->
<!--Description：Hotel Description-->
<!--Both Chinese and English are best,
otherwise English hotel information must be available -->
<TextItem Language="zh-CN" Title="上海明天广场JW万豪酒店">
<Brief>
上海明天广场JW万豪酒店紧邻人民公园，人民广场，以其无与伦比的优越地理
位置，使客人尽享高架桥及地铁的便利交通。
</Brief>
<Description>
上海明天广场JW万豪酒店紧邻人民公园，人民广场，以其无与伦比的优越地理
位置，使客人尽享高架桥及地铁的便利交通。
上海明天广场JW万豪酒店作为万豪国际酒店集团下的旗舰品牌 ——JW万豪，
11 携程静态信息接口文档

在中国大陆的首家酒店，上海JW万豪酒店及万豪行政公寓坐落于繁华商业中心，信步即达多处著名休
闲景点。旨在以其先进的设计理念，豪华的装饰设备，为每位商务客人及旅游者提供至善至美的服
务。酒店共有豪华客房三百间，位于明天广场41层至59层，每个房间都可从不同角度享受城市美景。
行政楼层位于酒店59楼，除可一览城市美景外，客人还可在此享受早餐，全天候精美茶点和晚间鸡尾
酒，并可使用位于酒店60层，被吉尼斯世界纪录评为“世界最高“的图书馆。
上海明天广场JW万豪酒店38楼至40楼的每间餐厅及酒廊为客人提供丰富的饮
食、娱乐之选，并可同时俯瞰全城美景。位于酒店7楼的“泳池畔”风格简洁而时尚 - 室内游泳池在美丽
玻璃房内，四季恒温，而又充分享受阳光温暖。室外空间休闲放松，同时可一览人民公园绿景。
</Description>
</TextItem>
<TextItem Language="en-US" Title="JW Marriott Hotel Shanghai">
<Brief>
The JW Marriott Hotel Shanghai Changfeng Park (Shanghai Xinfazhan Yatai
JW Wanhao Jiudian) is located at the Changfeng Ecology Commercial District in west Shanghai,
facing the picturesque Changfeng Park and Suzhou River.
</Brief>
<Description>
The JW Marriott Hotel Shanghai Changfeng Park (Shanghai Xinfazhan Yatai
JW Wanhao Jiudian) is located at the Changfeng Ecology Commercial District in west Shanghai,
facing the picturesque Changfeng Park and Suzhou River. It is well positioned, neighboring the
Shanghai Convention & Exhibition Center of International Sourcing and the internationally renowned
National Exhibition and Convention Center (NECC). The hotel is also adjacent to Changfeng
Parkside Plaza, one of the largest shopping malls in west Shanghai.
</Description>
</TextItem>
</TextItems>
</MultimediaDescription>
<!--RenovationCompletionDate：The date of decoration completed-->
<Renovation RenovationCompletionDate="2015-01" />
</MultimediaDescriptions>
</Descriptions>
<CategoryCodes>
<!--GuestRoomInfo：number of physical rooms-->
<GuestRoomInfo Quantity="100" />
</CategoryCodes>
<Position Longitude="121.76" Latitude="31.05" />
<Services>
<!--Code：Ctrip facility code-->
<Service Code="16" />
<Service Code="233" />
</Services>
12 携程静态信息接口文档

</HotelInfo>
<LicenseInfo>
<Business Type="String" ExpiryDate="1967-08-13" EnterpriseName="String"
Place="String" LegalPerson="String" Code="String" Scope="String"/>
<IDCardInfo Name="String" IDCard="ID" Code="String"/>
<Property Type="Rent" ExpiryDate="1967-08-13"/>
<LicensePictures>
<LicensePicture Type="BusinessLicense" Url="String"/>
</LicensePictures>
</LicenseInfo>
<Policies>
<Policy>
<GuaranteePaymentPolicy>
<GuaranteePayment>
<AcceptedPayments>
<AcceptedPayment>
<!--CardCode：The Credit Card Code which is supported by this hotel-->
<PaymentCard CardCode="1"/>
</AcceptedPayment>
</AcceptedPayments>
</GuaranteePayment>
</GuaranteePaymentPolicy>
<!--Description：The restriction of staying or reminder-->
<PolicyInfoCodes>
<PolicyInfoCode>
<Description>
<Text Language="en-US">no smoking in public area</Text>
<Text Language="zh-CN">外环内禁止烟火</Text>
</Description>
</PolicyInfoCode>
</PolicyInfoCodes>
<!--KidsStayFree：Whether the child is free to stay in-->
<!--UsualStayFreeCutoffAge：The max age that child free to stay in -->
<!--UsualStayFreeChildPerAdult：The number of free stay child per adult-->
<!--MinGuestAge：The min guest age-->
<!--CheckInTime：The early check in time-->
<!--CheckOutTime：The last check out time-->
<!--LastCheckInTime：The early check in time-->
<!--EarlyCheckOutTime：The last check out time-->
<!--AcceptedGuestType：The accepted guest type, discard it if no this kind restriction
AdultOnly
13 携程静态信息接口文档

CouplesOnly
-->
<PolicyInfo UsualStayFreeCutoffAge="12" KidsStayFree="false"
UsualStayFreeChildPerAdult="1" CheckInTime="14:00" LastCheckInTime="20:00"
CheckOutTime="12:00" EarlyCheckOutTime ="10:00" MinGuestAge="18"
AcceptedGuestType="AdultOnly">
<Description>The min guest age is 18 </Description>
</PolicyInfo>
<!--PetsAllowedCode：
Pets Allowed
Pets Not Allowed
-->
<PetsPolicies PetsAllowedCode=" Pets Allowed">
<!--CurrencyCode：Currency code-->
<!--NonRefundableFee：Charge for the pets-->
<PetsPolicy CurrencyCode="CNY" NonRefundableFee="200" />
</PetsPolicies>
<FeePolicies>
<!--MandatoryInd：Mandatory surcharge-->
<FeePolicy MandatoryInd="true">
<!--CurrencyCode：Taxes currency -->
<!--Percent：Percentage of taxes -->
<!--Amount：Fixed amount of taxes-->
<Taxes>
<Tax CurrencyCode="CNY" Percent="5.00" Amount="20" />
</Taxes>
<!--Text：Taxes description -->
<Description>
<Text Language="zh-CN">酒店入住后征收额外的5% 清洁费</Text>
<Text Language="en-US">Additonal 5% cleaning fee</Text>
</Description>
</FeePolicy>
</FeePolicies>
<PolicyStay PhotoAllowed="true" QuietEndTime="00:00" QuietStartTime="00:00"
PartyAllowed="true"/>
<PolicyCheckIn CheckInAddress="String" CheckInWay="Text" CheckInNote="String"/>
<CheckImages>
<CheckImage Width="800" Height="600">
<URL>http://dimg10.c-
ctrip.com/images/hotel/20000/19825/9e5c8758b2364618be3dd7bdf8c0074e_R_100_75.jpg</URL>
</CheckImage>
14 携程静态信息接口文档

</CheckImages>
</ PolicyCheckIn >
</Policy>
</Policies>
<AffiliationInfo>
<Awards>
<!--Rating：The rank of hotel-->
<!--RatingSymbol： The default value is “Star”-->
<Award Rating="5" RatingSymbol="Star"/>
</Awards>
</AffiliationInfo>
<MultimediaDescriptions>
<MultimediaDescription>
<ImageItems>
<ImageItem>
<!--Width：The width of image-->
<!--Height：The height of image-->
<!--URL：URL of image-->
<ImageFormat Width="800" Height="600">
<URL>http://dimg10.c-
ctrip.com/images/hotel/20000/19825/9e5c8758b2364618be3dd7bdf8c0074e_R_100_75.jpg</URL>
</ImageFormat>
<Description>
<Text Language="zh-CN">大厅</Text>
<Text Language="en-US">Lobby</Text>
</Description>
</ImageItem>
<ImageItem>
<ImageFormat Width="800" Height="600">
<URL>http://dimg10.c-
ctrip.com/images/hotel/20000/19825/9f7a417d869a45458e1c82f184a71d7e_R_100_75.jpg</URL>
</ImageFormat>
<Description>
<Text Language="zh-CN">海景</Text>
<Text Language="en-US">Ocean View</Text>
</Description>
</ImageItem>
</ImageItems>
</MultimediaDescription>
</MultimediaDescriptions>
<ContactInfos>
15 携程静态信息接口文档

<ContactInfo>
<Names>
<!--Name：Contact person-->
<Name>
<!--NamePrefix：Prefix of contact person，Ms,Mr or Mrs-->
<!--GivenName：Last name-->
<!--Surname：First name-->
<NamePrefix>Mr</NamePrefix>
<GivenName>San</GivenName>
<Surname>Zhang</Surname>
</Name>
</Names>
<Addresses Visible="true" >
<!--Language：Language type of address-->
<!--AddressLine：Address in deatial-->
<!--PostalCode：邮政编码-->
<Address Language="zh-CN">
<CountryName Code="CN">中国</CountryName>
<CityName>上海</CityName>
<AddressLine>南京西路399号</AddressLine>
<PostalCode>200041</PostalCode>
</Address>
<Address Language="en-US">
<CountryName Code="CN">China</CountryName>
<CityName>Shanghai</CityName>
<AddressLine>West Nanjing Road, Number 399</AddressLine>
<PostalCode>200041</PostalCode>
</Address>
</Addresses>
<Phones>
<!--PhoneNumber：Hotel contact phone number-->
<Phone PhoneNumber="13900000000" PhoneTechType="Voice"/>
<Phone PhoneNumber="64190000" PhoneTechType="Fax"/>
</Phones>
<Emails>
<!--Email：Hotel e-mail-->
<Email>Someone@Marriott.com</Email>
</Emails>
<HostInfo>
<Name>String</Name>
<Introduction>String</Introduction>
16 携程静态信息接口文档

<PicUrl> http://dimg10.c-
ctrip.com/images/hotel/20000/19825/9f7a417d869a45458e1c82f184a71d7e_R_100_75.jpg </PicUrl>
</HostInfo>
</ContactInfo>
</ContactInfos>
<GDS_Info>
<!--GDS_Name：
Sabre
Worldspan
Galileo
Amadeus
-->
<!--GDS_PropertyCode：Hotel code in GDS system -->
<GDS_Codes>
<GDS_Code GDS_Name="Sabre" GDS_PropertyCode="1213897" />
</GDS_Codes>
<GDS_Codes>
<GDS_Code GDS_Name="Amadeus" GDS_PropertyCode="2345667" />
</GDS_Codes>
</GDS_Info>
<TPA_Extensions/>
</HotelDescriptiveContent>
</HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRQ>

2.2 XML Request Node Definition

Node Comment M
OTA_HotelDescriptiveContentNotifRQ Root node •
Collection of hotel
HotelDescriptiveContents •
content info
ChainName Partner name
BrandName Hotel brand name
Hotel code

HotelCode Limit of length ： •

100 Bytes
HotelDescriptiveContent Single hotel content •
17 携程静态信息接口文档

HotelInfo Basic hotel info •

Hotel status in
partner system
Active: Open and
bookable
HotelStatus •
Deactivated:
Obsolete, used
when the hotel is
permanently closed
Established time,
WhenBuilt
format: YYYY-MM
Classification of

hotel，see hotel
HotelCategory •
classification list in
appendix
Descriptions / •
MultimediaDescriptions / •
MultimediaDescription / •
Hotel name and
TextItems •
description
Hotel name with
TextItem •
specified language
Language type of
hotel name，
multilingual
Language •
language code refer
to Appendix
Language code
Hotel name

Title Limit of length ： •

200 Bytes
Hotel shorter
Brief
description
Hotel description
Limit of length of

Description desc in Chinese：

4000 Bytes
Limit of length of
18 携程静态信息接口文档

desc in other

language：2048

Bytes
Renovation
Renovation
information
The date of
decoration
RenovationCompletionDate
completed
Format: YYYY-MM
CategoryCodes /
GuestRoomInfo /
Number of physical
Quantity
rooms
Position Hotel position •
Longitude, Format:
Longitude •
ddd.ddddd
Latitude, Format:
Latitude •
ddd.ddddd
Services Hotel facility list
Service Hotel facility
Ctrip facility code,
Code see the appendix
for mapping
LicenseInfo /
Business /
EnterpriseName Company name
LegalPerson juridical person
Place Business Location
Scope scope of business
Type:
personal
Type
company
others
Code Registration ID
Expiration Date,
ExpiryDate 9999-12-30:
infinite long
IDCardInfo /
IDCard Certificate type:
19 携程静态信息接口文档

ID,Passport
Taiwan
HKM
SocialSecurity
DrivingLicense
None
Name
Code ID Number
Property /
Certificate type:
ContractType
Rent
Type
OwnerShip
Payment
None
ExpiryDate Expiration Date
LicensePicture /
LicensePicture
Url URL
Type of photo：
BusinessLicense，
IDCard
Type Rent
OwnerShip
SpecLicense
PaymentList
subtype
desc
Policies /
Policy /
GuaranteePaymentPolicy /
GuaranteePayment /
AcceptedPayments /
AcceptedPayment /
PaymentCard Credit card info
The credit card
supported by this
CardCode
hotel，see credit

card list in appendix

20 携程静态信息接口文档

PolicyInfoCodes /
PolicyInfoCode /
Description Hotel policy
Text Hotel specific policy
Hotel policy with
specified
language，
Language multilingual
language code refer
to Appendix
Language code
PolicyInfo Check-in policy
The max age that
UsualStayFreeCutoffAge
child free to stay in
Whether the child is
KidsStayFree
free to stay in
The number of free
UsualStayFreeChildPerAdult
stay child per adult
The earliest check
CheckInTime
in time
The latest check out
CheckOutTime
time
The latest check in
LastCheckInTime
time
The earliest check
EarlyCheckOutTime
out time
MinGuestAge The min guest age
The accepted guest
type:

AdultOnly
AcceptedGuestType
CouplesOnly

Discard it if no this
kind restriction.
Policies as free text,
used by the partner
Description who cannot provide
the policy info as
structure field.
21 携程静态信息接口文档

PetsPolicies Pets Policies

PetsAllowedCode：
PetsAllowedCode
Pets Allowed
Pets Not Allowed
Only used while
Pets Allowed is true
PetsPolicy
and hotel charges
the fee.
CurrencyCode Currency code
NonRefundableFee Fee charge of pets
FeePolicies Fee charge policies
FeePolicy Fee charge policy
Mandatory
MandatoryInd
surcharge or not
Taxes The collection of fee
Tax Single tax element
CurrencyCode Tax currency
Percent Percentage of tax
Amount Fixed amount of tax
Description Tax description
Text of tax
Text
description
Text of tax
description with
specified
language，
Language
multilingual
language code refer
to Appendix
Language code
Mostly used on
PolicyStay homestay
properties
PartyAllowed If party allowed.
True:allowed
Flase:not allowed
PhotoAllowed If commercial photo
allowed.
True:allowed
22 携程静态信息接口文档

Flase:not allowed
QuietEndTime quiet time
Null is unknown
QuietStartTime quiet time
Null is unknown
Mostly used on
PolicyCheckIn homestay
properties.
CheckInWay Way of Check
in,see checkinWay
list in appendix
CheckInAddress Check in address.
Null means same
with hotel
address.330 bytes
at most.
CheckInNote Check in related
notes, 400 bytes at
most.
CheckImages Check in related
pictures
CheckImage URL of image.5 urls
at most.
Width Width of image
Height Height of image
URL URL of image
AffiliationInfo /
Awards /
Award Ranking
Rating The rank of hotel
The default value is
RatingSymbol
“Star”
MultimediaDescriptions /
MultimediaDescription /
The collection of
ImageItems
images
ImageItem Single image
ImageFormat Image format
Width Width of image
Height Height of image
23 携程静态信息接口文档

URL URL of image

Description Image description
Text of image
Text
description
Text of image
description with
specified
language，
Language
multilingual
language code refer
to Appendix
Language code
List of hotel contact
ContactInfos
info
Single hotel contact
ContactInfo
info
List of hotel contact
Names
person
hotel contact
Name
person

Name prefix，Ms，
NamePrefix
Mr or Mrs
GivenName First name
Surname Last name
The collection of
Addresses •
address info
Whether to show the
hotel's full address
before booking
Visible （Homestay uses it
most）
True show
False not show
Address single address info •
address info with
specified
Language language， •
multilingual
language code refer
24 携程静态信息接口文档

to Appendix
Language code
CountryName Country name
2 digital country
Code
code: ISO 3166-1
The name of city
CityName •
that hotel located in
Hotel address
AddressLine Limit of length:
100Bytes
Hotel postal code
PostalCode Limit of length:
50Bytes
The list of hotel
Phones
phone number
Phone Single phone info
PhoneNumber Phone number
Phone number
type:
PhoneTechType
Voice
Fax
The list of hotel e-
Emails
mail address
Hotel e-mail
address
Email
Limit of length:
50Bytes
Mostly used on
HostInfo homestay
properties
Landlord name.50
Name
bytes at most.
The introduction of
Introduction landlord. 2000
bytes at most.
The picture of
PicUrl landlord. 255 bytes
at most.
GDS_Info GDS info
GDS_Codes Single GDS code
25 携程静态信息接口文档

GDS Name:

Sabre

GDS_Name Worldspan

Galileo

Amadeus
Hotel code in GDS
GDS_PropertyCode
system
LicenseInfo/LicensePicture/subtype
is a picture subclass, only accepted following fixed values
Business License: License-"Picture" Relationship Certificate-"Relationship"
Picture of personal certificates:
Front of ID card
Back of ID card
Certificate of Incorporation, Certificate of Title, and House lease contract in hand
Picture of other certificates: special-"spec" fire protection-"fire" hygiene-"hygiene" tax-
"tax" catering-"cater" private account-"account" star rating-"star"
1.Rent contract, 2.property certificate, and 3.water and electricity payment proof is under on
e subtype. It’s not mandatory to follow the exact order of 1, 2, and 3. Each picture of certific
ate should be different and could contain no more than 3 pictures. The first picture pass wit
h “1”, and etc.

2.3 XML Response

The creation and update is an asynchronous process，Ctrip always returns success

once the request is received，the status in the response does not mean the real status

in Ctrip system, instead, the partner should use OTA_HotelStatsNotif to check that.

<OTA_HotelDescriptiveInfoRS Target="Production" PrimaryLangID="zh-CN" Version="1.0"

TimeStamp="2016-02-13T09:30:47Z" xmlns="http://www.opentravel.org/OTA/2003/05"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Success />
</OTA_HotelDescriptiveInfoRS>
26 携程静态信息接口文档

3 Basic Room Content

Room generation and content update interface, the partner can use it to generate a

new room in Ctrip system or update the content of the existing physical room.

Note 1：

The field in table with mark • means it is mandatory, it must be filled in xml request

passed to Ctrip. Others are optional, but it is better that partner fill that as full as

possible. The reason is the content affect that user performance and the number of

reservation the guest makes on that hotel.

Note 2：

It is allowed to pass the status of room in partner system via this interface, which

means Ctrip also closes this room in Ctrip system according to that status passed by

partner. But it is a complicated business logic to open that, although the first necessary

condition is “Open” status passed.

Note 3：

It is only allowed to remove all values in the Collection data, no single update. The

behavior is to add the collection node and leave the empty value in that list.

EG: To remove the image on that hotel, only need add the ImageItems node and keep

it empty.

< ImageItems >

</ ImageItems >
27 携程静态信息接口文档

Note 4：

No duplicated room name is allowed to generated on the same one hotel.

3.1 XML Request

<OTA_HotelInvNotifRQ Target="Production" PrimaryLangID="zh-CN" Version="1.0"

TimeStamp="2016-02-13T09:30:47Z" xmlns="http://www.opentravel.org/OTA/2003/05">
<POS>
<Source>
<!--ID：Partner ID-->
<!--MessagePassword：Partner’s password used to invoke API-->
<RequestorID ID="32" MessagePassword="P@ssw0rd" Type="1" />
<CompanyName Code="C" CodeContext="1" />
</Source>
</POS>
<!--HotelCode：Partner’s Hotel Code-->
<!--HotelName：Hotel name-->
<SellableProducts HotelCode="1332484" HotelName="上海明天广场JW万豪酒店">
<!--InvTypeCode: Partner’s Hotel Code -->
<!--InvStatusType：Hotel status in partner system
Open: Active
Closed: Deactivated
-->
<SellableProduct InvTypeCode="3001" InvStatusType="Active">
<GuestRoom>
<!--MaxRollaways：Maximum number of extra beds that can be placed -->
<!--MaxCribs：Maximum number of baby crib that can be placed -->
<Quantities MaxRollaways="1" MaxCribs="1" />
<!--MinOccupancy：The min number of guest can stay in-->
<!--MaxOccupancy：The max number of guest can stay in -->
<!--AgeQualifyingCode：
10 Adult
8 Child
-->
<Occupancy AgeQualifyingCode="10" MinOccupancy="1" MaxOccupancy="3"/>
<Occupancy AgeQualifyingCode="8" MinOccupancy="1" MaxOccupancy="1"/>
28 携程静态信息接口文档

<!--RoomTypeCode:Ctrip room type，see appendix-->

<!--Quantity：Number of physical room-->
<!--RoomViewCode：Room view，see appendix -->
<!--NonSmoking：An option that defines whether smoking is allowed -->
<!--Floor：The number of floor range-->
<!--RoomGender：An option that defines whether any gender restriction on that room
Male
Female
MaleAndFemale
-->
<!--SizeMeasurement：room size，unit is square meters -->
<Room RoomTypeCode="3" Quantity="1" RoomViewCode="11" NonSmoking="true"
Floor="10" RoomGender="Female" SizeMeasurement="30" />
<RoomSpec BathroomCount="0" BedroomCount="1" Sharing="true" LivingroomCount="0">
<Bedrooms>
<Bedroom Name="String">
<BedTypes>
<BedType Length="3.141593E0" Width="3.141593E0" BedTypeCode="0"
CategoryCode="0" Quantity="1"/>
</BedTypes>
</Bedroom>
</Bedrooms>
<Livingrooms>
<Bedroom Name="String">
<BedTypes>
<BedType Length="3.141593E0" Width="3.141593E0" BedTypeCode="0"
CategoryCode="0" Quantity="1"/>
</BedTypes>
</Bedroom>
</Livingrooms>
<Bathrooms>
<BathRoom LocationCode="String" BedRoomName="String" FacilityId="String"/>
</Bathrooms>
</RoomSpec>
<Amenities>
<!--Amenity：Ctrip room facility code-->
<Amenity AmenityCode="111"/>
<Amenity AmenityCode="112"/>
</Amenities>
<TPA_Extensions>
<!--HasWindow：
29 携程静态信息接口文档

Yes
No
Possible
-->
<!--Equipment：Internet connection Type
WiFi
LAN
-->
<!--Enable：
Yes
No
Possible
-->
<!--isChargeable
Yes
No
Unknown
-->
<Ventilation HasWindow="Possible" />
<Equipments>
<WiFi Enable="Possible" isChargeable="Unkown" />
<LAN Enable="Yes" isChargeable="Yes" />
</Equipments>
<!--BedTypeCode：
1 Double bed
2 Semi-double bed
3 King bed
4 Round bed
5 Queen bed
6 Sofa Bed
7 Tatami
9 Single bed
10 Kang
11 Space Capsule
12 Dorm bed
13 Water Bed
14 Bunk
-->
<BedTypes>
<!—If there are multiple type of bed combinations in one room，Please look in detail at
30 携程静态信息接口文档

bed type case1 and case2-->

<BedType BedTypeCode="3" Length="2.0" Width="2.0" Quantity="1"
CategoryCode="0" />
</BedTypes>
</TPA_Extensions>
<Currency Code="USD" />
<Description>
<!--Text：Room Name-->
<Text Language="zh-CN">豪华海景房</Text>
<Text Language="en-US">Deluxe Room with Ocean view</Text>
</Description>
<LongDescription>
<!--Text：Room Description-->
<Text Language="zh-CN">该房型分别有中国、英国、美国、德国、印度、西班牙、日
本、法国等九种规格的不同的装饰风格...</Text>
</LongDescription>
<ImageItems>
<ImageItem>
<!--Width：Width of Image-->
<!--Height：Height of Image-->
<!--URL：URL of Image-->
<ImageFormat Width="800" Height="600">
<URL>http://dimg10.c-
ctrip.com/images/hotel/20000/19825/9e5c8758b2364618be3dd7bdf8c0074e_R_100_75.jpg</URL>
</ImageFormat>
<Description>
<Text Language="zh-CN">浴室</Text>
<Text Language="en-US">Bath Room</Text>
</Description>
</ImageItem>
</ImageItems>
</GuestRoom>
</SellableProduct>
</SellableProducts>
</OTA_HotelInvNotifRQ>

Bed type cases

Bed Type Case 1: In one room，there are one double bed and two Single beds when
category code are both 0.
31 携程静态信息接口文档

<BedTypes>
<!—Please fill in the bed size according to the actual situation. This is only an example,
not the actual size-->
<BedType BedTypeCode="1" Length="1.8" Width="1.5" Quantity="1"
CategoryCode="0" />
<BedType BedTypeCode="9" Length="1.8" Width="1.2" Quantity="2"
CategoryCode="0" />
</BedTypes>

Bed Type Case 2: In one room，there are one double bed or two Single beds when category
code set as 0 and 1, or other different values.
<BedTypes>
<!—Please fill in the bed size according to the actual situation. This is only an example,
not the actual size-->
<BedType BedTypeCode="1" Length="1.8" Width="1.5" Quantity="1"
CategoryCode="0" />
<BedType BedTypeCode="9" Length="1.8" Width="1.2" Quantity="2"
CategoryCode="1" />
</BedTypes>

Note：At Present，the combination of multiply types of beds only supports the following
combination of beds： 1&3, 1&5, 1&9, 3&5, 3&9, 5&9.

Bed Type Case 3: Twin Room with 2 single beds

<BedTypes>
<!—Please fill in the bed size according to the actual situation. This is only an example,
not the actual size-->
<BedType BedTypeCode="9" Length="1.8" Width="1.2" Quantity="2"
CategoryCode="0" />
</BedTypes>

3.2 XML Request Node Definition

Node Comment M
OTA_HotelInvNotifRQ Root node •
32 携程静态信息接口文档

Collection of room
SellableProducts •
content
HotelCode Partner's hotel code •
HotelName Hotel name
SellableProduct Specified room content •
InvTypeCode Partner's room code •
Room status in partner
system
InvStatusType •
Active
Deactivated
GuestRoom Guest room information •
Quantities Bed information
Maximum number of
MaxRollaways extra beds that can be
placed
Maximum number of
MaxCribs baby crib that can be
placed
Occupancy Occupancy information •
Age Qualifying Type
AgeQualifyingCode 10 Adult •
8 Child
The min number of
MinOccupancy •
guest can stay in
The max number of
MaxOccupancy •
guest can stay in
Room Room information

Ctrip room type，see

RoomTypeCode
appendix
Number of physical
Quantity
room

Room view，see
RoomViewCode
appendix
An option that defines
whether smoking is
NonSmoking allowed
False
True
33 携程静态信息接口文档

The number of floor，

The possible values as
below:
1) 10-12, it meas the
floor range is from
10 to 12;
2) 10~12, it meas the
floor range is from
Floor
10 to 12;
3) 10/12, it meas the
floor range is from
10 to 12;
4) 10、12， it meas
the floor is 10 or 12;
5) 10 it meas the floor
is 10 ;
An option that defines
whether any gender
restriction on that room
Male
Female

RoomGender
MaleAndFemale

It is allowed to discard,
which means no
restricon on gender.

Room size，unit is

square meters，The
possible values as
below:
1) 10-12, it meas the
SizeMeasurement
room size range is
from 10 to 12;
2) 10~12, it meas the
room size range is
from 10 to 12;
34 携程静态信息接口文档

3) 10/12, it meas the

room size range is
from 10 to 12;
4) 10.12, it meas the
room size is the
specified 10.12.
5) 10, it meas the room
size is the specified
10.

Mostly used on
RoomSpec
homestay properties
Sharing Whether to live with a
landlord or other
tenant
BedroomCount Number of bedroom,
A minimum of 1
BathroomCount Number of bathroom,
A minimum of 0
LivingroomCount Number of livingroom,
A minimum of 0
Bedrooms /
Bedroom /
Name Name of bedroom.
Bedroom 1/2/3, if not
in compliance with the
specification (empty is
also not specification)
ctrip will be replaced
with the specification
name. The names of
rooms in the same list
cannot be duplicated

BedTypes
BedTypeCode BedTypeCode：
1 Double bed
2 Semi-double bed
3 King bed
4 Round bed
35 携程静态信息接口文档

5 Queen bed
6 Sofa Bed
7 Tatami
9 Single bed
10 Kang
11 Space Capsule
12 Dorm bed
13 Water Bed
14 Bunk

CategoryCode Bed type category code,

it means this room may
have the different bed
type as the code is
different. The default
value is 0. Please refer
to bed type cases
Length Length of bed, unit is
square meters
Quantity Number of bed, A
minimum of 1
Width Width of bed, unit is
square meters
Livingrooms
Bedroom
Name
BedTypes
BedTypeCode BedTypeCode
CategoryCode Bed type category code,
it means this room may
have the different bed
type as the code is
different. The default
value is 0. Please refer
to bed type cases
Length Length of bed, unit is
square meters
Quantity Number of bed, A
minimum of 1
Width Width of bed, unit is
square meters
36 携程静态信息接口文档

Bathrooms
BathRoom
BedRoomName Adjoining bedroom
name, the locationCode
is empty if there are
adjoining bedrooms

FacilityId Ctrip facility ID

LocationCode Location code, Specify
the location of the toilet;
Null or "" means in the
bedroom。
RoomNextDoor、
CorridorEnd、
RoomOpposite、
CorridorAlong、Other
Amenities Room facilities
Amenity Room facility
AmenityCode Ctrip room facility code
TPA_Extensions /
Ventilation Ventilation info
HasWindow:
Yes
HasWindow
No
Possible
Collection of equipment
Equipments
with property extension
WiFi Has WIFI
LAN Has LAN
Is Enable:
Yes
Enable
No
Possible
Is Chargeable
Yes
isChargeable
No
Unknown
BedTypes Collection of bed types
BedType Single bed type
37 携程静态信息接口文档

BedTypeCode：
1 Double bed
2 Semi-double bed
3 King bed
4 Round bed
5 Queen bed
6 Sofa Bed
BedTypeCode 7 Tatami
9 Single bed
10 Kang
11 Space Capsule
12 Dorm bed
13 Water Bed
14 Bunk

Length of bed, unit is

Length
square meters
Width of bed, unit is
Width
square meters
Quantity Number of bed
Bed type category code,
it means this room may
have the different bed
CategoryCode type as the code is
different. The default
value is 0. Please refer
to bed type cases.
Description Room name •
Text of room name
Text •
Limit of length: 50 Bytes
Room name with
specified language，
Language multilingual language •
code refer to Appendix
Language code
Currency / •
Code Currency code •
LongDescription Room description
Text Text of room description
Room description with
Language
specified language，
38 携程静态信息接口文档

multilingual language
code refer to Appendix
Language code
ImageItems Collection of image
ImageItem Single image information
ImageFormat Image format
Width Width of image
Height Height of image
URL URL of image
Description Image description
Text of image
Text
description
Image description with
specified language，
Language multilingual language
code refer to Appendix
Language code

3.3 XML Response

The creation and update is an asynchronous process，Ctrip always returns success

once the request is received，the status in the response does not mean the real status

in Ctrip system, instead, the partner should use OTA_HotelStatsNotif to check that.

<OTA_HotelInvNotifRS Target="Production" PrimaryLangID="zh-CN" Version="1.0"

TimeStamp="2016-02-13T09:30:47Z" xmlns="http://www.opentravel.org/OTA/2003/05"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Success />
</HotelInvNotifRS>

4 Sub Room Content

Ctrip sub-room means the combination of basic room and rate plan. Each sub room
39 携程静态信息接口文档

code is unique in whole Ctrip system and it must be generated under the basic room.

Note:

It is additional update process，not mandatorily required to pass this information

to Ctrip. Both of Ctrip and partner need to determine it before launching the integration

project.

4.1 XML Request

<OTA_HotelRatePlanNotifRQ Target="Production" PrimaryLangID="zh-CN" Version="1.0"

TimeStamp="2016-02-13T09:30:47Z" xmlns="http://www.opentravel.org/OTA/2003/05">
<POS>
<Source>
<!--ID：Partner ID-->
<!--MessagePassword：Partner’s password used to invoke API-->
<RequestorID ID="32" MessagePassword="P@ssw0rd" Type="1" />
<CompanyName Code="C" CodeContext="1" />
</Source>
</POS>
<!--HotelCode：Partner’s Hotel Code-->
<!--HotelName：Hotel name-->
<RatePlans HotelCode="1332484" HotelName="上海明天广场JW万豪酒店">
<!--RatePlanCategory：16 Pay at hotel，501 Prepay-->
<!--RatePlanCode：Partner’s sub-room code-->
<!--RatePlanStatusType：
Open：Active
Closed：Deactivated
-->
<RatePlan RatePlanStatusType="Active" RatePlanCode="3001_PP"
RatePlanCategory="501">
<BookingRules>
<!--MinAdvancedBookingOffset：How long in advance the room can be booked. It is relative
to midnight of the check-in day-->
<!--MaxAdvancedBookingOffset：How long in advance the room can be booked. It is
relative to midnight of the check-in day-->
<!--BookingOffsetUnit：The unit of the MinAdvancedBookingOffset and
40 携程静态信息接口文档

MaxAdvancedBookingOffset, the value is Day and Hour ,Default value is Day-->

<!--MaxContiguousBookings：Max number of room can be booked in single booking
request-->
<!--MaxTotalOccupancy：Max number of guest is allowed to stay for this rate, this is
different with max occupancy of a specific room type.-->
<BookingRule MaxTotalOccupancy="2" MinAdvancedBookingOffset="24"
MaxAdvancedBookingOffset="0" BookingOffsetUnit="Day" MaxContiguousBookings="8"
EarlyCheckInTime="14" LastCheckInTime="20" LastCheckOutTime ="10">
<CancelPenalties>
<CancelPenalty>
<!--OffsetTimeUnit：Unit is Hour or Day-->
<!--OffsetDropTime：Calculation type of cancellation deadline
BeforeArrival
AfterBooking
AfterConfirmation
-->
<!--OffsetUnitMultiplier：Penalty type，choose one of them
Amount
NmbrOfNights
Percent
-->
<!—Not support Cascading Cancellation Policies, and If the cancellation is changed by
the date, This cancellation can be ignored; You can transfer the cancellation Policies with the rate.
-->
<Deadline OffsetTimeUnit="Hour" OffsetDropTime="BeforeArrival"
AbsoluteDeadline="2001-12-17T09:30:47Z" OffsetUnitMultiplier="10"/>
<AmountPercent Amount="200" NmbrOfNights="1" Percent="10.00"/>
</CancelPenalty>
</CancelPenalties>
</BookingRule>
</BookingRules>

<!--Nationalities：Guest Nationality-->
<!--Code：Country Code，ISO 3166-Alpha 3 -->
<!--Limitation：
Permission：允许, only support values are CHN、HKG、MAC、TWN. Please refer to
appendix to find permission combinations.
Forbidden：禁止, only possible value is LOC. It means this rate cannot be booked by local
residents.
-->
<Nationalities>
41 携程静态信息接口文档

<Nationality Code="CHN" Limitation="Permission"/>

<Nationality Code="HKG" Limitation="Permission"/>
</Nationalities>

<!--If there are multiple type of bed combinations in one basic room, you can set a fixed bed type in a
sub room-->
<BedType BedTypeCode="9" Length="1.8" Width="1.2" Quantity="2" />

<!--InvTypeCode：Partner’s basic room code-->

<SellableProducts>
<SellableProduct InvTypeCode="STD" />
</SellableProducts>
<Rates>
<!--MinLOS：Min length of stay-->
<!--MaxLOS：Max length of stay-->
<!--Breakfast：Is breakfast included-->
<!--Lunch：Is lunch included-->
<!--Dinner：Is dinner included-->
<Rate MinLOS="3" MaxLOS="7">
<MealsIncluded Breakfast="true" NumberOfMeal="2" Lunch="true" Dinner="true" />
</Rate>
</Rates>
<!--Text：Sub-room name-->
<Description>
<Text Language="zh-CN">春节促销</Text>
<Text Language="en-US">Promotion Price</Text>
</Description>
</RatePlan>
</RatePlans>
</OTA_HotelRatePlanNotifRQ>

4.2 XML Request Node Definition

Node Comment M
OTA_HotelRatePlanNotifRQ Root node •
Collection of sub-room
RatePlans •
information
42 携程静态信息接口文档

HotelCode Partner's hotel code •

HotelName Hotel name
RatePlan Single sub-room information •
Sub-room status in partner
system
RatePlanStatusType •
Active
Deactivated
RatePlanCode Partner's sub-room Code •

Pay at hotel：16

RatePlanCategory •
Prepay：501

PKG: 502
BookingRules Booking rules
BookingRule Single booking rule
Max number of guest
allowed to stay for this rate.
MaxTotalOccupancy This may be different with •
max occupancy of a specific
room type.
The min time in advance of
MinAdvancedBookingOffset
the room can be booked.
The max time in advance of
MaxAdvancedBookingOffset the room can be booked.
It is not currently enabled.[l1]
The unit of the
MinAdvancedBookingOffset
and
BookingOffsetUnit
MaxAdvancedBookingOffset,
the value is Day and
Hour ,Default value is Day
Max number of room can be
MaxContiguousBookings booked in single booking
request
The earlist check-
EarlyCheckInTime in time(local time)。
Range：0-4，6-23
The latest check-
LastCheckInTime in time(local time)。
Range：0-5，16-23
43 携程静态信息接口文档

The latest check-

LastCheckOutTime out time(local time)。
Range：0-3，5-23
Collection of cancellation
policy, Not support
Cascading Cancellation
Policies, and If the
CancelPenalties cancellation is changed by
the date, This cancellation
can be ignored; You can
transfer the cancellation
Policies with the rate.
CancelPenalty Single cancellation policy
Deadline /
The units of time, Unit is
OffsetTimeUnit
Hour or Day
Calculation type of
cancellation deadline.
Possible values:
OffsetDropTime
BeforeArrival;
AfterBooking;
AfterConfirmation
The number of units, which
OffsetUnitMultiplier
is range from 0 to 23899
A detail deadline, hotel local
time. With the highest
AbsoluteDeadline
priority, other values are
ignored if has this
Penalty type, 3 types are
AmountPercent
alternatives, just choose one
Amount Fix amount of the penalty
Number of stay nights of the
NmbrOfNights hotel to calculate the amount
of penalty.
Percentage of total order
Percent Rate to calculate the amount
of penalty.
Nationalities /
Nationality
ISO Country Code, ISO
Code
3166-Alpha 3
44 携程静态信息接口文档

Possible values:
Permission / Forbidden

Permission：only support
values are CHN、HKG、
MAC、TWN. Please refer to
appendix to find permission
Limitation
combinations.

Forbidden： only possible

value is LOC. It means this
rate cannot be booked by
local residents.

SellableProducts / •
SellableProduct Basic room info •
The code of partner's basic
InvTypeCode room which own this sub- •
room
Rates /
Rate /
MinLOS Min length of stay
MaxLOS Max length of stay
MealsIncluded Meal plan info
Breakfast Is breakfast included
NumberOfBreakfast Number of breakfast
Lunch Is lunch included
Dinner Is dinner included
Description Sub-room name
Text Text of Sub-room name
Sub-room name with
specified language,
Language multilingual language code
refer to Appendix Language
code
45 携程静态信息接口文档

4.3 XML Response

The creation and update is an asynchronous process，Ctrip always returns success

once the request is received，the status in the response does not mean the real status

in Ctrip system, instead, the partner should use OTA_HotelStatsNotif to check that.

<OTA_HotelRatePlanNotifRS Target="Production" PrimaryLangID="zh-CN" Version="1.0"

TimeStamp="2016-02-13T09:30:47Z" xmlns="http://www.opentravel.org/OTA/2003/05"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Success />
</OTA_HotelRatePlanNotifRS>
46 携程静态信息接口文档

5 Retrieve the Status of Content Update

This interface is used to check the real status of content creation/update in Ctrip
system.

5.1 XML Request

<OTA_HotelStatsNotifRQ Target="Production" PrimaryLangID="zh-CN" Version="1.0"
TimeStamp="2016-02-13T09:30:47Z" xmlns="http://www.opentravel.org/OTA/2003/05" >
<POS>
<Source>
<!--ID：Partner ID-->
<!--MessagePassword：Partner’s password used to invoke API-->
<RequestorID ID="32" MessagePassword="P@ssw0rd" Type="1" />
<CompanyName Code="C" CodeContext="1" />
</Source>
</POS>
<Statistics>
<!--HotelCode：Partner’s Hotel Code-->
<Statistic HotelCode="1332484" />
<Statistic HotelCode="1332483" />
</Statistics>
</OTA_HotelStatsNotifRQ>

5.2 XML Response

<OTA_HotelStatsNotifRS Target="Production" PrimaryLangID="zh-CN" Version="1.0"

TimeStamp="2016-02-13T09:30:47Z" xmlns="http://www.opentravel.org/OTA/2003/05" >
<Success/>
<TPA_Extensions>
<Hotels>
<Hotel HotelCode="1332484" CtripHotelCode="123456" Status="Active">
<BasicRooms>
<BasicRoom RoomCode="3001" CtripRoomCode="12345612" Status="Active">
<RatePlans>
<RatePlan RatePlanCode ="3001_3rd_Std" CtripRatePlanCode="12345612_1"
Status="Active"/>
47 携程静态信息接口文档

<RatePlan RatePlanCode ="3001_2nd_Std" CtripRatePlanCode="12345612_2"

Status="Active"/>
</RatePlans>
</BasicRoom>
<BasicRoom RoomCode="3003" Status="Pending" />
<BasicRoom RoomCode="3004" CtripRoomCode="12345613" Status="Active">
<RatePlans>
<RatePlan RatePlanCode ="3004_3rd_Std" Status="Failed">
<Errors>
<Error Code="394" ShortText="Duplicated sub-room name" />
<Error Code="394" ShortText="RatePlanCode: Field Missed" />
</Errors>
</RatePlan>
<RatePlan RatePlanCode ="3004_2nd_Std" Status="Failed">
<Errors>
<Error Code="394" ShortText="Duplicated sub-room name" />
</Errors>
</RatePlan>
</RatePlans>
</BasicRoom>
</BasicRooms>
</Hotel>
<Hotel HotelCode="1332483" Status="Failed">
<Errors>
<Error Code="394" ShortText="Failed to find this hotel" />
</Errors>
</Hotel>
</Hotels>
</TPA_Extensions>
</OTA_HotelStatsNotifRS>
48 携程静态信息接口文档

5.3 XML Response Node Definition

Node Comment M

OTA_HotelStatsNotifRS Root node •

It means that request has been
Success •
received
TPA_Extensions / •
Hotels Colleciton of hotel info •
Hotel Single hotel info •
HotelCode Partner's hotel code •
CtripHotelCode Ctrip hotel code
Status Status of hotel in Ctrip system •
Collection of error info, included if
Errors
the status is "Failed"
Error Single error info
Code Default value is 394
ShortText Text of error message
BasicRooms Collection of basic room
BasicRoom Single basic room
RoomCode Partner's basic room code
CtripRoomCode Ctrip basic room code
Status Status of basc room in Ctrip system
Collection of error info, included if
Errors
the status is "Failed"
Error Single error info
Code Default value is 394
ShortText Text of error message
RatePlans Collection of Ctrip sub-room
RatePlan Single sub-room
RatePlanCode Partner's sub-room code
CtripRatePlanCode Ctrip sub-room code
Status Status of rate plan creation/update
Collection of error info, included if
Errors
the status is "Failed"
49 携程静态信息接口文档

Error Single error info

Code Default value is 394
ShortText Text of error message

5.4 Status
Status Comment
Hotel, Room or Sub-room has been generated in Ctrip system and they
Active
are opened.
Deactivated Hotel, Room or Sub-room is closed in Ctrip system
The creation/update request has been received but it is a queue not
Pending
successfully updated in Ctrip system.
Failed Failed to generate/ update the content passed by partner.
50 携程静态信息接口文档

6 Appendix

6.1 Hotel Facility Code

Code Name
1 Chinese restaurant
2 Western restaurant
3 Café
5 Bar
6 Meeting Room
8 Business Centre
9 Parking lot
11 Exchange Service
12 Travel Ticket Service
15 Laundry service
16 Room service
19 Accessible Guestroom
20 Ballroom
22 KTV
24 chess and card room
26 Billiard room
27 Table tennis room
29 Indoor swimming pool
30 Bowling alley
31 Tennis court
32 Squash room
33 Golf Course
34 Simulated golf course
35 Shopping mall
36 Flower shop
40 Clinic
41 Hairdressing and beauty center
42 Gymnasium
43 Massage Room
44 Sauna bath
47 Sun bathing
55 Call car service
51 携程静态信息接口文档

60 Shuttle bus
61 Outdoor swimming pool
62 Nightclub
63 Teahouse
64 Foot bath
65 SPA
66 Japanese Restaurant
67 Barbecue
68 Children’s Playground
69 Postal Service
70 diving
71 Football
72 Basketball
73 Beach Volleyball
74 Aquatic Sports
95 Front desk valuables safe
96 Full time luggage
97 Luggage Deposit
98 Morning Call
99 ATM
100 Free Parking
101 Pay Parking
102 Public area with wireless internet access
103 Free travel map (Free)
105 Pick up service
106 Lobby bar
109 No elevator
110 Elevator
116 Air conditioner
117 central air-conditioning
118 General split air conditioner
119 No air conditioning
120 There is free access to the public area of wireless Internet
121 Shuttle airport shuttle free
122 Child care
123 Car rental
127 Concierge service
128 dry cleaning
129 Fax / copy
130 Ironing Service
52 携程静态信息接口文档

131 Check in / check out

132 Shoeshine
133 shuttle service
134 Secretarial services
135 Translation service
136 Children's Club
137 Wedding banquet service
138 Multilingual staff
139 butler service
140 24 hours front desk service
141 Smoking is strictly prohibited in all public and private places
142 Smoking Area
143 Check in / check out quickly.
144 Heating
145 Lobby free newspaper
146 Private beach area
147 Restaurant
148 Ski gear storage
149 Valet Parking
150 Billiards
151 Casino
152 Bicycle rental service
153 Fishing
154 Game room
155 Hike
156 Hot spring
157 Library
158 Skiing
159 snorkeling
160 Full-time Doorman
161 Gift Gallery
162 Credit card settlement services
163 One time billing and settlement services
164 Multifunction Room
165 24 hours lobby manager
166 Part time lobby manager
167 Travel ticket counter
168 Business services
169 Part time foreground service
170 Public sound system
53 携程静态信息接口文档

171 Non-operating guest rest area

172 Special exhibition hall
173 Non-smoking floor
174 Executive floor
175 Executive lounge
176 Multimedia demonstration system
177 CCTV in public area
178 External laundry service
263 Transportation Service
267 Charter service
268 Vehicle leasing
269 Deposit of valuables
270 Travel Around
271 Free tour guide service
272 Attractions tickets to buy
273 Vouchers
274 Free afternoon tea
275 Local delicacies
276 National photo shoot
277 Romantic package
278 Local merchandise shopping
279 Farm food

6.2 Room Facility Code

Code Name
13 Domestic Direct Dialing
14 International Direct Dialing
75 Slipper
76 Umbrella
77 Desk
78 Bathroom cosmetic magnifying glass
79 24 hours hot water
80 Electric kettle
81 Coffee pot / tea pot
82 Free toiletries (more than 6)
83 Free bottled water
85 Mini Bar
86 Ironing equipment
54 携程静态信息接口文档

87 Small refrigerator
88 Bathrobe
89 Multiple specification power supply socket
90 110V voltage socket
91 Bathtub
92 Independent shower room
93 Hair drier
94 Interior safe
107 Central air-conditioning
108 General split air conditioner
111 shared bathroom
112 No air conditioning
113 Non 24 hours hot water
114 Electric water heater
115 No hot water
179 Charge movie
180 Cable channel
181 Satellite channel
182 LCD TV
183 Television
184 Game machine
185 3D TV
186 CD player
187 computer
188 video recorder
189 IPad
190 radio
191 IPod music base
192 Coffee machine
193 toaster
194 oven
195 a kitchen stove
196 fireplace
197 Dining area
198 kitchen
199 Kitchen utensils
200 Electric fan
201 Electric blanket
202 Locker Room
203 Private entrance
55 携程静态信息接口文档

204 Microwave Oven

205 Mosquito net
206 dishwasher
207 Washing Machine
208 Wardrobe / wardrobe
209 connecting room
210 Terrace
211 Heating
212 alarm clock
213 Sewing kit
214 Single specification power outlet
215 220V voltage socket
216 No socket
217 Shading curtain
218 Automatic curtain
219 Hand curtain
220 No curtain
221 day bed
222 Long bed (over two meters)
223 The spare bed
224 Bedding: duvet
225 Bedding: blanket or quilt
226 No bed
227 Private hot springs
228 Private swimming pool
229 Wake-up call service
230 voicemail
231 Welcome gifts
232 Executive lounge
233 Free toiletries (6 or less)
234 No free toiletries
235 Common hair dryer
236 Massage bathtub
237 sauna
238 Shower Room
239 Shared bathroom
240 City View
241 seascape
242 River View
243 Mountain View
56 携程静态信息接口文档

244 Lakeview
245 Garden View
246 Enjoy the scenery
247 Balcony
248 Landmark scene
249 Swimming pool view
250 Fax
251 Bathroom TV
252 Bath room telephone
253 Sofa
254 Sound
255 DVD player
256 Free newspaper
257 Open night bed
258 Electronic scale
259 High speed internet access in the room
260 Pay TV on demand
261 Telephone
262 shower
264 WIFI
265 Free Domestic Direct Dialing
266 Free WIFI

6.3 Credit Card Type

Type Code Credit Card Type Name
1 American Express
2 Visa
3 Euro/Mastercard
4 Carte Bleue
5 Diners Club
7 JCB
8 PIN

9 Red 6000
10 Maestro
11 Discover
12 Bancontact
13 Solo
57 携程静态信息接口文档

14 Switch
15 Carte Blanche
16 NICOS
17 UC
18 No creditcards accepted, only cash
19 Bankcard
21 CartaSi

22 Argencard
23 Cabal
25 Red Compra
26 Other Cards
27 Greatwall

28 Peony
29 Dragon
30 Pacific
31 Jin Sui
32 Eftpos
34 Hipercard
35 UnionPay debit card
36 UnionPay credit card
37 EC-Card
38 BC-Card
39 Booking virtual card (MasterCard)
40 Mastercard Google Wallet
41 KH Széchényi Pihenõkártya
42 MKB Széchényi Pihenõkártya
43 OTP Széchényi Pihenõkártya
44 UnionPay credit card

6.4 Ctrip Room Type

Ctrip Chinese English
Code Name Name
1 标准间 Standard
Room
2 双床房 Twin Room
3 三人房 Triple
Room
58 携程静态信息接口文档

4 单人间 Single
Room
5 家庭房 Family
Room
6 大床房 Double
Room
7 四人间 Quad
Room
8 套房 Suite
9 床位房 Bunk
10 公寓 Apartment
11 别墅 Villa
12 房车 MotorHome
13 帐篷 Camp
14 小木屋 Bungalow
15 工作室 Studio

6.5 Room View

代码 景观名称
1 Airport view
2 Bay view
3 City view
4 Courtyard view
5 Golf view
6 Harbor view
7 Intercoastal view

8 Lake view
9 Marina view
10 Mountain view
11 Ocean view
12 Pool view
13 River view
14 Water view
15 Beach view
16 Garden view
17 Park view
18 Forest view
59 携程静态信息接口文档

19 Rain forest view

20 Various views
21 Limited view
22 Slope view
23 Strip view
24 Countryside view

25 Sea view
26 Gulf view

6.6 Language Code

语种名 Language Name 对应 code
英文 English en-US
中文 Chinese zh-CN
日语 Japanese ja-JP
韩语 Korean ko-KR
德语 German de-DE
法语 French fr-FR
西班牙语 Spanish es-ES

意大利语 Italian it-IT

俄语 Russian ru-RU
繁体-香港 Traditional- zh-HK
Hongkong
繁体-台湾 Traditional-Taiwan zh-TW
马来西亚 Malaysian ms-MY
语
印度尼西 Indonesian id-ID
亚语
泰语 Thai th-TH
越南语 Vietnamese vi-VN
菲律宾语 Filipino tl-PH
瑞典语 Swedish sv-SE

6.7 Basic Room Bed Type Code

60 携程静态信息接口文档

Bed Type Bed Type Bed Width Width Unit

CnName EnName Type Min Max
Code
双人床 DoubleBed 1 1.31 1.5 m

特大床 King Bed 3 1.81 15 m

大床 Queen Bed 5 1.51 1.8 m

小型双人床（国内 Semi-double 2 0.9 1.4 m

没有）
单人床 SingleBed 9 0.8 1.3 m

圆床 RoundBed 4 1.31 5 m

沙发床 SofaBed 6 0.8 5 m

榻榻米 Tatami 7 0.8 15 m

炕 Kang 10 0.8 15 m

太空舱 SpaceCapsule 11 0.8 5 m

胶囊床 CapsuleBed 12 0.8 1.3 m

水床 WaterBed 13 1.31 5 m

上下铺 Bunk Bed 14 0.8 5 m

6.8 Nationality Possible Combinations

适用人群 Applicable Nationality Combination

Nationalities
中宾 Chinese Guests CHN+HKG+MAC+TWN
内宾 Mainland Chinese Guests CHN
持中国身份证 Mainland Chinese + CHN+HKG
及香港客人 HongKong
持中国身份证 Mainland Chinese + CHN+MAC
及澳门客人 Macau
持中国身份证 Mainland Chinese Guests CHN + HKG + MAC
及港澳客人 + HongKong + Macau
61 携程静态信息接口文档

持中国身份证 Mainland Chinese + CHN+TWN+HKG

及台湾，香港 Taiwan + HongKong
客人
持中国身份证 Mainland Chinese + CHN+TWN+MAC
及台湾，澳门 Taiwan + Macau
客人
港澳台 HK + Macau + Taiwan HKG+MAC+TWN
港澳客人 HK + Macau HKG+MAC
台宾 Taiwan TWN
香港客人 HongKong HKG
澳门客人 Macau MAC
当地客人 Local Residents LOC

6.9 Cancellation Policy Samples

Cancellation Policy XML Sample
Scenario

Free Cancellation <AmountPercent Percent="0"/>

<Deadline OffsetTimeUnit="Hour" OffsetUnitMultiplier="0"
OffsetDropTime="BeforeArrival"/>

Non Refundable <AmountPercent Percent="100"/>

<Deadline OffsetTimeUnit="Hour" OffsetUnitMultiplier="23899"
OffsetDropTime="BeforeArrival"/>

Non Refundable <AmountPercent Percent="100"/>

(use afterbooking <Deadline OffsetTimeUnit="Hour" OffsetUnitMultiplier="0"
and offset is 0 hour) OffsetDropTime="AfterBooking"/>

Non Refundable <AmountPercent Percent="100"/>

(use a timestamp in <Deadline AbsoluteDeadline="2017-04-24T18:00:00"/>
the past)
62 携程静态信息接口文档

First Night Penalty <AmountPercent NmbrOfNights="1"/>

<Deadline OffsetTimeUnit="Hour" OffsetUnitMultiplier="24"
OffsetDropTime="BeforeArrival"/>
It means from Checkin date 23:59, back to 24 hours

6.10 Hotel Classification List

分类 classification 描述定义 Descriptive definition

Accommodations for
此类住宿具有统一的
travelers often with
管理和装修，通常为
酒店 Hotels restaurants, meeting
旅行者提供餐厅等客
rooms and other guest
用设施及住宿服务
services

此类住宿靠近交通道 Roadside hotel usually

路，通常面向自驾客 for motorists, with
汽车旅馆 Motels
人，提供停车服务，其 direct access to parking
他设施较少 and fewer amenities

此类住宿提供内部餐
厅和丰富的活动，气
氛轻松悠闲，装潢陈 A place for relaxation
设较为奢华（与度假 with on-site
度假村 Resorts
屋的区别在于有多栋 restaurants, activities
建筑，可分别出租给 and often a luxury feel
不同用户。分类时以
≥5 栋为分界。
）

Provide
此类酒店提供住宿服 accommodation
Economy
经济型酒店 务和基本设施，价格 services and basic
hotels
经济实惠，规模不大 facilities at an
affordable price

此类住宿一般为家庭 Private home with

旅馆 Inns 经营，主人与住客分 separate living facilities
别使用不同的设施 for host and guest
63 携程静态信息接口文档

Adult-only
此类住宿仅限成人入
accommodations
情人酒店 Love hotels 住，按小时或天数出
rented by the hour or
租
night

Traditional Japanese-
此类住宿享有日本传
日式旅馆 Ryokans style accommodations
统风格，提供餐食
with meal options

此类住宿规模较小，
Small property with
陈设简约，满足基本
宾馆 Guest House basic accommodations
需要，常见于民用楼
and a rustic feel
改装

此类住宿一般为家庭 Private home offering

住 宿 加 早 餐 Bed and
经营，提供过夜住宿 overnight stays and
旅馆 Breakfasts
和早餐 breakfast

此类酒店式或服务式
Independent
公寓具有统一的管理
apartments with some
酒店公寓 Aparthotels 和装修，拥有家具陈
hotel facilities like a
设，可提供长租或短
front desk
租

With standardized
此类住宿具有相对标 management and
准化的管理与设施， facilities, with local
客栈 Tavern 装修风格具有当地特 characteristics, mostly
色，多在旅游风景区， in tourist scenic spots,
古镇名山等地 ancient towns and
famous places

此类多为独栋建筑，
可整栋出租，周边建
筑密度较低，享有奢 Private, freestanding
别墅 Villas 华感和私密性（联排 and independent
别墅、叠拼别墅，如果 home with a luxury feel
可以整栋出租，也可
分类为别墅）

此类住宿为乡村的私 Private villas in the

人别墅，多为独栋建 country, usually with
乡村别墅 Cottages
筑，可整栋出租，常见 private courtyards and
私人庭院，环境良好。 a good environment.
64 携程静态信息接口文档

此类住宿设在私家农 Private farm with

农家乐 farm stays 场，陈设简约，提供当 simple
地美食 accommodations

A shared home where

民宿指的是供客人居 the guest has a private
住的私人住宅，房东 room and the host lives
民宿 Homestays 也可能生活在其他房 and is on site. Some
间内，房东和客人会 facilities are shared
共用一些设施 between hosts and
guests.

Private residence
此类住宿由物业管理 owned by an individual
整栋大厦，个人拥有 homeowner or family
公寓大厦 Condos 其中一套房屋的产 in a building or
权，通常设施设备齐 community with
全 multiple units or
townhouses

Traditional Moroccan
此类住宿享有摩洛哥
摩洛哥传统 accommodations with
Riad 传统风格和奢华感，
庭院住宅 a courtyard and luxury
设有庭院
feel

Furnished,
此类住宿拥有家具陈 independent
公寓 Apartments 设，可以短期或长期 accommodations
出租 available for short- and
long-term rental

Freestanding home
此类住宿为独立屋
Holiday with private, external
度假屋 舍，设有外部私人入
homes entrance and rented
口，一般为度假出租
specifically for vacation

Private independent
此类住宿为私人自助
residences located on
式住宿，位于公共场
假日公园 Holiday parks shared grounds with
地，提供共用设施或
shared facilities or
休闲娱乐活动
recreational activities
65 携程静态信息接口文档

Like an old-fashioned
youth hostel, a place
此类住宿设在乡村或
offering fairly basic
法式乡村民 城郊，充满法式乡村
Gites overnight
宿 风格，常见天然的藤
accommodation in a
编家具和绿色植物等
village or in the
countryside.

Private home in the

Country 此类住宿为乡村的私 countryside with
乡村民宿
house 人屋舍，陈设简约 simple
accommodations

Individual 此 类 住 宿 为 独 栋 建 single-family building

独栋房
apartment 筑，可整栋出租 that can be rented out

Extremely small units or

此类住宿空间极小， capsules offering
胶囊旅馆 Capsule hotel 提供价格便宜的基本 cheap and basic
过夜设施 overnight
accommodations

Budget
此类住宿价格低廉，
accommodations with
通常按床位售卖，多
青年旅馆 Hostels mostly dorm-style
分男女宿舍，适合背
beds and social
包客出行
atmosphere

Commercial travel
此类住宿设在船内，
船屋 Boats accommodations
具有基本过夜设施
located on a boat

此类住宿提供带有固 Tents with fixed beds

定床铺的帐篷和其他 and some services,
豪华帐篷 Luxury tents
服务，周围自然环境 located in natural
优美 surroundings

Freestanding home
此 类 住 宿 为 独 立 屋 characterized by a
木屋 Chalet 舍，木质结构，常见用 sloping roof and
于度假出租 rented specifically for
vacations
66 携程静态信息接口文档

A cruise ship is a
此类住宿设在船内，
passenger ship used
观光船 Cruises 提供旅途观光服务，
for pleasure voyages
风景宜人
when the voyage itself

Private home with

此 类 住 宿 为 私 人 屋 accommodations
山林小屋 Lodges 舍，自然环境优美，一 surrounded by nature,
般处于山间或林间 such as a forest or
mountains

Accommodations
此类住宿在露营地附 offering cabins or
近提供小屋或简易独 bungalows alongside
露营地 Campsites 栋房，或提供带有设 areas for camping or
施和娱乐活动的大篷 campers, with shared
车 facilities or recreational
activities

Characteristic housing
此类住宿具有特色的
style, mostly
特色住宿 Others 房屋形态，多为体验
experience
式住宿
accommodation

6.11 CheckinWay list

字段（Field） 分类 Classification

前台领取钥匙 frontdesk

有专人接待客人 reception

通过门禁密码 password

钥匙放寄存箱自取 keybox
入住方式(Checkin Way)
钥匙存放于隐蔽处 keyhide

我们会发送说明 instruction

请客人联系我们索要说明 contactus

其他 other