---
# System prepended metadata

title: Ctrip API Integration

---

# Ctrip API Integration

![](https://i.imgur.com/QYixyTA.png)

![](https://i.imgur.com/GtR9YRc.png)

## Check list

### Development Scope for Content API

- [x] [OTA_HotelDescriptiveContentNotifRQ](http://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelStaticInfoService.asmx?op=HotelDescriptiveContentNotif)
- [x] [OTA_HotelInvNotifRQ](http://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelStaticInfoService.asmx?op=HotelInvNotif)
- [ ] [OTA_HotelRatePlanNotifRQ](http://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelStaticInfoService.asmx?op=HotelRatePlanNotif)
- [ ] [OTA_HotelStatsNotifRQ](http://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelStaticInfoService.asmx?op=HotelStatsNotif)

### Development Scope for Integration API

- [ ] [OTAReceiveService](https://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/OTAReceiveService.asmx)
  - [ ] HotelAvailNotif
  - [ ] HotelCheckInNotif
  - [ ] HotelCheckOutNotif
  - [ ] HotelInvCountNotif
  - [ ] HotelRateAmountNotif
  - [ ] HotelRatePlan
  - [ ] NotifReport
- [ ] [OTAHotelAriAdjustRQ](https://vendor-ctrip.fws.ctripqa.com//Hotel/OTAReceive/OTAHotelAriAdjustRQ.asmx)
- [ ] [HotelResNumUpdate](https://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelResNumUpdate.asmx)

#### Mandatory for Integration API

- [ ] The implementation of ARI push (Section 2, 3)
- [ ] The implementation of shopping (Section 5)
- [ ] The implementation of booking (Section 6)
- [ ] The implementation of cancelation (Section 7)

## Content API

Test Envrionment: [HotelStaticInfoService](http://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelStaticInfoService.asmx)  
`https://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelStaticInfoService.asmx`

Prod Environment: `https://vendor.ctrip.com/Hotel/OTAReceive/HotelStaticInfoService.asmx`

- HotelDescriptiveContentNotif
- HotelInvNotif
- HotelRatePlanNotif
- HotelStatsNotif

### 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.

### 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.

[OTA_HotelDescriptiveContentNotifRQ](http://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelStaticInfoService.asmx?op=HotelDescriptiveContentNotif)

### 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.

[OTA_HotelInvNotifRQ](http://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelStaticInfoService.asmx?op=HotelInvNotif)

### 4 - Sub Room Content

Ctrip sub-room means the combination of basic room and rate plan. Each sub room code is unique in whole Ctrip system and it must be generated under the basic room.

[OTA_HotelRatePlanNotifRQ](http://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelStaticInfoService.asmx?op=HotelRatePlanNotif)

### 5 - Retrieve the Status of Content Update

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

[OTA_HotelStatsNotifRQ](http://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelStaticInfoService.asmx?op=HotelStatsNotif)

### 6 - Static content codes (count)

- Hotel Facility Code: 279
- Room Facility Code: 266
- Credit Card Type: 44
- Ctrip Room Type: 15
- Room View: 26
- Language Code: 17
- Basic Room Bed Type Code: 13
- Nationality Combinations: 13

## Integration API

Test Environment:

- [OTAReceiveService](https://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/OTAReceiveService.asmx)
  - HotelAvailNotif
  - HotelCheckInNotif
  - HotelCheckOutNotif
  - HotelInvCountNotif
  - HotelRateAmountNotif
  - HotelRatePlan
  - NotifReport
- [OTAHotelAriAdjustRQ](https://vendor-ctrip.fws.ctripqa.com//Hotel/OTAReceive/OTAHotelAriAdjustRQ.asmx)
- [HotelResNumUpdate](https://vendor-ctrip.fws.ctripqa.com/Hotel/OTAReceive/HotelResNumUpdate.asmx)

### 0 - 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.
When Ctrip accesses partner service, Ctrip will use authorized account info in POS node provided by partners.

### 1 - Push Availability and Inventory

The OTA_HotelAvailNotifRQ message is used to push the availability info and inventory to Ctrip System.
As current Ctrip’s solution, the success response will be returned immediately once Ctrip system receives this request, but the actual availability and inventory update is in an asynchronous process.  

### 2 - Push Rate

The OTA_HotelRateAmountNotifRQ message is used to push the rate to Ctrip System.
As current Ctrip’s solution, the success response will be returned immediately once Ctrip system receives this request, but the actual rate updates are in an asynchronous process.  

### 3 - Check Availability

The Hotel Availability Request message provides the ability to search single or multiple properties for detailed availability, inventory and pricing information of room products.  

### 4 - Create Reservation

### 5 - Cancel Reservation

### 6 - Update Reservation Confirmation Number

The Confirmation Number Update Request message provides the ability to add or update hotel confirmation number afterwards, in case partner’s system cannot provide hotel confirmation number in the booking response in real-time.

### 7 - Read Reservation

The Read operation enables the user to retrieve a exiting booking generated before, to request a reservation when the booking id number has been specified.

### 8 - Push Availability, Inventory and Rate Adjust

The OTA_HotelAriAdjustRQ message is used to push the corresponding hotel code and change date information to Ctrip System when the supplier’s availability or Rate change.
After Ctrip receives the message, it will take the initiative to get the latest availability and Rate through the OTA_HotelAvailRQ message.
As current Ctrip’s solution, the success response will be returned immediately once Ctrip system receives this request, but the actual availability and rate update are in an asynchronous process.  

### 9 - Update reservation status

The OTA_HotelResStaUpdateRQ message is used to update reservation status timely.  
Update reservation and Read reservation interfaces can be developed at the same time.
When partner develops [Read] interface, Ctrip will call your [Read] interface for the status update every minute.
If partner’s System has the status in advance, partner can also use this [update] interface to push the status first.
In this way, Ctrip can get the latest status timely.
