创建订单 - TMC服务平台

创建订单

请求参数

Header 参数

Authorization

string

可选

示例值:

Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJsaXV4dSIsImlhdCI6MTc0NDQyMDk2NiwiZXhwIjoxNzQ0NTA3MzY2fQ.qCrPSz3lkvILUkF2E6BWbxR0FE-x3W_p9QAiSb5vSyk

Tenant-Id

string

可选

示例值:

Body 参数application/json

token

string

可选

hotelId

integer <int64>

酒店ID

可选

roomId

string

房间ID

可选

ratePlanId

string

可选

售卖房间id 对应携程:roomCode 美团:goodId

checkInDate

string

入住日期

可选

checkOutDate

string

离店日期

可选

roomNum

integer

预订间数

可选

totalPrice

number

总金额

可选

string

合作商订单号

可选

outNo

string

外部单号

可选

priceItems

array[object (CreateOrderPriceItem) {5}]

可选

订单每日价格详情(List)

saleDate

string

售卖日期

可选

salePrice

number

价格

可选

breakfastType

integer

可选

早餐类型 - 非必传

breakfastNum

integer

可选

早餐数量 - 非必传

buyPrice

number

采购价格

可选

priceItemsStr

string

可选

订单每日价格详情(String)

names

array [array]

可选

入住人名列表(List)

object (Passenger)

可选

常旅客表，保存常旅客信息

checkin

string

可选

OPnames

array[string]

OP入住人列表

可选

linkMan

string

订单联系人

可选

linkPhone

string

联系人电话

可选

string

邮箱 - 非必传

可选

latestArriveTime

string

可选

最晚到店时间 HH:mm

supplyCode

string

供应商编码

可选

remark

string

可选

备注信息 - 非必传

commonMark

string

出行分类

可选

specialDemand

string

可选

特殊要求 - 非必传

travelNo

string

出差申请单号

可选

source

string

订单来源

可选

highLimit

integer

因公高价限制

可选

isDismantling

integer

是否拆标0否1是

可选

businessTravelersItems

string

出行人额度明细

可选

payType

string

可选

PP：预付 FG：到付

roomSharingStrategys

array [array]

可选

出行人分房策略
内容如下：
[
[
{
"passengerNo": "0000000001",
"passengerName": "上官三纶",
"money": 400
},
{
"passengerNo": "0000000001",
"passengerName": "王望尢",
"money": 400
}
],
[
{
"passengerNo": "0000000001",
"passengerName": "薛学雪",
"money": 400
},
{
"passengerNo": "0000000001",
"passengerName": "胡乎怙",
"money": 500
}
]
]

object (RoomSharingStrategy)

可选

ipay

integer

可选

是否自己支付超标金额

channel

string

渠道

可选

extraCost

number

可选

额外费用(OP端手动增加服务费)

buyPrice

number

采购价

可选

outHotelId

string

外部酒店id

可选

prepaidIndicator

boolean

可选

是否为预付房型，true-预付，false-到付

默认值:

true

travelRules

object (TravelRules)

差旅规则

可选

standardDetail

array [array]

可选

出行人标准
外层list:代表共有几间房
内层list:代表每间房，住了多少人

roomCheckRules

integer

可选

房间是否超标校验规则 0:总价 1:每日价格

isDismantling

integer

是否拆标0否1是

可选

ipay

integer

可选

是否自己支付超标金额

shareStandard

integer

可选

共享标准 0:按照最高 1:按照最低 2:平均

highLimitRules

integer

可选

高价限制规则。1=只提示不记录 2=列表提示为违规酒店 3=不可预定 4=提示违规再次审批或个人支付 5=个人支付

groupBuy

integer

可选

团购 0:否 1:是

approvedAbnormal

boolean

是否超标并已通过

可选

默认值:

false

relationalNo

string

新订单号

可选

realHotelId

string

供应商酒店ID

可选

applyHotelId

integer <int64>

酒店行程单ID

可选

applyHoteId

integer <int64>

会报错，暂时保留

可选

excessAmount

number

超标金额

可选

isBusiness

integer

可选

是否是因公预定 0是 1否

示例

// {
//     "no": "202504021652582477",
//     "linkPhone": "19862891836",
//     "totalPrice": 516,
//     "linkMan": "颜建伟",
//     "checkInDate": "2025-04-15",
//     "names": [
//         [
//             {
//                 "phone": "19862891836",
//                 "name": "颜建伟"
//             }
//         ]
//     ],
//     "checkOutDate": "2025-04-16",
//     "latestArriveTime": "18:00"
// }
{
    "no": "202504120920520903",
    "roomNum": 1,
    "latestArriveTime": "2025-04-12T01:20:25.630Z",
    "remark": "",
    "linkMan": "颜建伟",
    "linkPhone": "13099999999",
    "email": "123@qq.com",
    "salePrice": "",
    "extraCost": 10,
    "commonMark": "123123",
    "specialDemand": "123123",
    "names": [
        [
            {
                "name": "颜建伟"
            }
        ]
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

success

boolean

可选

errCode

string

可选

errMsg

string

可选

traceId

string

可选

data

object (CheckBookTo)

可选

integer <int64>

可选

desc

string

可选

错误信息 FAIL:预算不足

status

integer

可选

订单创建的状态： 1：创建订单成功 2:此房间不可预定（未创建订单）3.重复预定 4：未满足住房标准 5: 在上游层面预定失败
6:个人支付 7:超标询问 8：超标审批或个人支付

buyNo

string

订单号

可选

excessAmount

number

超标金额

可选

paragraph

array[string]

酒店公告

可选

prompt

array[string]

酒店预付信息提示

可选

createTime

string

创建时间

可选

默认值:

LocalDateTime.now().toString()

buyPrice

number

可选

示例

{
  "success": false,
  "errCode": "",
  "errMsg": "",
  "traceId": "",
  "data": {
    "no": 0,
    "desc": "",
    "status": 0,
    "buyNo": "",
    "excessAmount": 0.0,
    "paragraph": [
      ""
    ],
    "prompt": [
      ""
    ],
    "createTime": "",
    "buyPrice": 0.0
  }
}