悦想家
首页
V1版本
数据字典
数据字典
  • 省市
  • 酒店服务设施
  • 房型服务设施
  • 酒店品牌
首页
V1版本
数据字典
数据字典
  • 省市
  • 酒店服务设施
  • 房型服务设施
  • 酒店品牌
  1. 四、订单类接口
  • Release Notes
  • 签名认证
  • 错误码
  • 一、分销商对接流程图
  • 二、酒店静态信息类接口
    • 2.0说明
    • 2.1城市code获取酒店ID
      POST
    • 2.2酒店分页查询
      POST
    • 2.3获取酒店详情
      POST
    • 2.4获取酒店房型
      POST
  • 三、价格类接口
    • 3.1按照区/县获取酒店起售价
      POST
    • 3.2获取酒店产品列表
      POST
    • 3.4获取酒店实时可订产品列表
      POST
    • 3.5可预订产品房态
      POST
    • 3.6条件搜索酒店接口
      POST
  • 四、订单类接口
    • 4.1预下单校验
      POST
    • 4.2下单接口
      POST
    • 4.3确认订单支付
      POST
    • 4.4查询订单详情
      POST
    • 4.5取消订单
      POST
    • 4.6建售后单
      POST
    • 4.7查售后单
      POST
  • 五、监测类接口
    • 5.1检测酒店房型变更
      POST
    • 5.2监测订单状态
      POST
  • 六、推送类接口
  1. 四、订单类接口

4.2下单接口

POST
/open/corp/hotel/book/createOrder
最后修改时间:2026-01-20 05:09:54
下单操作
频率限制:5次/S

请求参数

Body 参数application/json

示例
{
	"outOrderNo":"ZZ422175941985484",
	"hotelId": "1805940519466315778",
	"productRoomId": "1864221759419854849",
	"num": 1,
	"linkTel": "18311111111",
	"linkMan": "张xx",
	"checkInPersonList": [
		{
			"name": "张xx",
			"idcard": "",
			"mobile": "18311111111",
			"department": ""
		}
	],
	"checkinDate": "2024-12-11",
	"checkoutDate": "2024-12-12",
	"orderStatusNotifyUrl":""
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://api.test.yxjtrip.com/core/open/corp/hotel/book/createOrder' \
--header 'Content-Type: application/json' \
--data-raw '{
	"outOrderNo":"ZZ422175941985484",
	"hotelId": "1805940519466315778",
	"productRoomId": "1864221759419854849",
	"num": 1,
	"linkTel": "18311111111",
	"linkMan": "张xx",
	"checkInPersonList": [
		{
			"name": "张xx",
			"idcard": "",
			"mobile": "18311111111",
			"department": ""
		}
	],
	"checkinDate": "2024-12-11",
	"checkoutDate": "2024-12-12",
	"orderStatusNotifyUrl":""
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 0,
    "msg": "string",
    "data": {
        "orderNo": "string",
        "orderId": "string",
        "outOrderNo": "string",
        "hotelId": "string",
        "hotelName": "string",
        "linkMan": "string",
        "linkTel": "string",
        "status": "string",
        "cancelType": "string",
        "cancelTime": "string",
        "totalPrice": 0,
        "productRoomId": "string",
        "productRoomName": "string",
        "num": "string",
        "paySum": 0,
        "hotelOrderRoomList": [
            {
                "roomOrderNo": "string",
                "roomIdx": 0,
                "checkinDate": "string",
                "checkoutDate": "string",
                "num": 0,
                "totalPrice": 0,
                "actualTotalPrice": 0,
                "name": "string",
                "idcard": "string",
                "telephone": "string",
                "checkStatus": "string",
                "checkoutType": "string",
                "createTime": "string",
                "settleStatus": "string",
                "actualTotalAmount": 0
            }
        ],
        "hotelOrderDayList": [
            {
                "hotelId": "string",
                "orderId": "string",
                "date": "string",
                "price": 0,
                "breakfast": "string"
            }
        ],
        "hotelOrderOtherFeeList": [
            {
                "otherItem": "string",
                "price": "string",
                "totalPrice": "string"
            }
        ]
    }
}
修改于 2026-01-20 05:09:54
上一页
4.1预下单校验
下一页
4.3确认订单支付
Built with