订单验价 - TMC服务平台

订单验价

请求参数

Header 参数

Authorization

string

可选

示例值:

Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJsaXV4dSIsImlhdCI6MTc0NDE2ODQ4NSwiZXhwIjoxNzQ0MjU0ODg1fQ.Q3177SzhuJXg-6qHblR6_l6nlo_JPwuKgtBBa88QOFg

Tenant-Id

string

可选

示例值:

Body 参数application/json

token

string

可选

hotelId

integer <int64>

酒店ID

可选

productId

string

产品ID

可选

hotelName

string

酒店中文名

可选

address

string

酒店地址

可选

city

string

酒店所在城市

可选

hotelStar

integer

酒店星级

可选

roomId

string

房间ID

可选

roomName

string

房间名称

可选

ratePlanId

string

可选

销售房型ID 前端传递 roomCode

roomDetailId

array[integer]

可选

具体的房间id(歌尔长包房使用,可以为空)

ratePlanName

string

价格计划名称

可选

checkInDate

string

入住日期

可选

checkOutDate

string

离店日期

可选

roomNum

integer

间数

可选

supplyCode

string

供应商编码

可选

totalPrice

number

总价（验价）

可选

cgj

number

采购价

可选

source

string

APP、OP

可选

creator

string

创建者

可选

payType

string

可选

PP：预付 FG：到付

prepaidIndicator

boolean

可选

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

priceItemsStr

string

可选

priceItems

array[object (PriceItem) {15}]

售卖信息列表

可选

saleDate

string

可选

日期格式:yyyy-MM-dd

salePrice

number

价格

可选

breakfastType

integer

早餐类型

可选

breakfastNum

integer

早餐数量

可选

roomStatus

integer

可选

当前房态
1 有房
2 待查
3 满房

bookRestrictionType

integer

可选

预订条款类型
0 未设置预订条款;
1 预订需在 day 天前的 time 点之前;
2 表示预订需在 day 天前的 time 点之后。

bookRestrictionDay

integer

提前预定的天数

可选

bookRestrictionTime

string

可选

提前预定天数 Day 天之中的 time 点(如 1700，表示 17 点)

occupancyRestrictionType

integer

可选

入住条款类型
0 未设置入住条款;
1 入住天数需>=day 天;
2 必须入住 day 天;
3 入住天数需<=Day 天。

occupancyRestrictionDay

integer

需要入住的天数

可选

minRoomCount

integer

可选

最少预订房间数(为空则此项不做限制)

maxRoomCount

integer

可选

最多预订房间数(为空则此项不做限制)

cancelRestrictionType

integer

可选

取消条款类型
0 未设置取消条款;
1 表示不可取消，不可更改;
2 表示入住前 day 天 time 点之后取消，需线下联系客服，并支付违约金;
3 表示入住前 day 天 time 点之后不可取消，不可更改。

cancelRestrictionDay

integer

需提前取消的天数

可选

cancelRestrictionTime

string

可选

提前取消的天数的时间点(如 1700，表示 17 点)

cancelRestrictionType

integer

可选

cancelRestrict

integer

需提前取消的天数

可选

cancelRestrictionTime

string

可选

提前取消的天数的时间点(房仓显示如 1700，表示 17 点; 其他显示如：2020-10-18T18:00:00)

breakfastType

integer

早餐类型

可选

breakfastNum

integer

每间房早餐数量

可选

outNo

string

外部单号

可选

outJson

string

额外参数存储

可选

travelNo

string

出差申请单号

可选

highLimit

integer

因公高价限制

可选

isDismantling

integer

是否拆标0否1是

可选

applyHoteId

integer <int64>

酒店行程单ID

可选

names

string

可选

出行人字符串 "张三,李四,王麻子"

businessTravelersItems

string

出行人额度明细

可选

passengers

string

出行人集合

可选

channel

string

渠道来源

可选

version

integer

版本

可选

groupHotelId

integer <int64>

聚合酒店的id

可选

guaranteeMode

string

担保模式

可选

windowType

integer

窗户类型

可选

placeOrder

integer

可选

验价后下单：0:否其他:是

protocol

integer

可选

是否协议房间：0:是 1:否
如果结算要改成1为是的话，代价太大了，会导致发版内的一个月结算对账的数据都是错误显示的，所以决定将这个错误延续下去

isSpecialAccount

boolean

是否专票账户

可选

invoiceType

integer

可选

开票方式:
2 酒店开票
3 供应商开票

couponCodes

array[string]

可选

本次请求所使用的抵用券id列表

discountPrice

number

优惠券优惠的总金额

可选

string

可选

promotion

string

美团会员级别Tag

可选

international

boolean

国际酒店标识

可选

默认值:

false

realHotelId

string

供应商酒店ID

可选

nationality

string

国籍限制

可选

adultCount

integer

成人数量

可选

dailyRateList

array[object (DailyPrices) {9}]

每日房价信息

可选

breakfast

integer

早餐

可选

lunch

integer

午餐

可选

默认值:

dinner

integer

晚餐

可选

默认值:

displayCurrency

number

结算价

可选

feeList

object (RoomFeeList)

国际酒店税费

可选

currency

string

币种

可选

effectiveDate

string

价格生效日期

可选

zqBuyPrice

number

可选

展示给自签协议酒店的采购价格

promotion

string

优惠活动信息

可选

cancelDesc

string

退房政策描述

可选

dailyRateJson

string

可选

每日房价信息json信息 -- op 丽呈用: 解决list直传接收不了问题

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:是

excessAmount

number

超标金额

可选

employeeNumber

string

api缓存变价用

可选

applyHotelId

string

酒店行程单Id

可选

exceedStandardRemark

string

超标备注

可选

liveNum

integer

每间入住人数

可选

extraFees

number

到店付费用

可选

示例

{
    "cancelRestrictionTime": "2025-04-15 18:00",
    "checkInDate": "2025-04-15",
    "checkOutDate": "2025-04-16",
    "hotelId": "1001202501090044289",
    "payType": "PP",
    "ratePlanId": "1003202504020000648",
    "roomId": "100220250109240768",
    "roomNum": 1,
    "totalPrice": 516,
    "channel": "106001001",
    // "version": 2,
    "supplyCode": "",
    "roomName": "大床房",
    "breakfastNum": 1,
    "guaranteeMode": ""
}

示例代码

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 (PriceBookTo)

可选

code

string

可选

状态码
200：成功
3001: 供应商错误
4001：不满足住房条件
4002：房量不足
5001：参数错误
5002：其他错误

desc

string

可选

描述(改为desc)

errorMsg

string

错误信息

可选

string

系统生成订单号

可选

ratePlanId

string

售卖房型id

可选

roomName

string

售卖房型名称

可选

priceChange

boolean

可选

变价？ true:已变价 false:未变价

totalPrice

number

总税后价

可选

averagePrice

number

均税后价

可选

dailyPrices

array[object (DailyPrices) {9}]

可选

每日价格详情(包含餐信息)

paragraph

array[string]

酒店公告

可选

prompt

array[string]

酒店预付信息提示

可选

availabilityStatus

string

可选

可定状态：AvailableForSale-可定；
NoAvailability-不可定；

备注：房型不可定不表示该房型绝对无房可售！仅代表可售房型不满足可定检查请求报文中约定的条件；

availableQuantity

integer

检查到可用的房间数

可选

supplierID

string

可选

供应商ID，用来区分库存来源。

invoiceTargetType

integer

可选

区分发票开具方：1-携程可开票；2-酒店可开票；

buyPrice

number

采购价

可选

cancelStart

string

可选

备注：Start定义了最晚免费取消时间。Start时间之前，客人可免费取消；Start之后，客人需承担相应罚金。如果为0001-01-01T00:00:00.0000000:不可取消

guaranteeMode

string

担保模式

可选

isExceedCode

string

可选

isExceedDesc

string

可选

excessAmount

number

可选

示例

{
  "success": false,
  "errCode": "",
  "errMsg": "",
  "traceId": "",
  "data": {
    "code": "",
    "desc": "",
    "errorMsg": "",
    "no": "",
    "ratePlanId": "",
    "roomName": "",
    "priceChange": false,
    "totalPrice": 0.0,
    "averagePrice": 0.0,
    "dailyPrices": [
      {
        "breakfast": 0,
        "lunch": 0,
        "dinner": 0,
        "displayCurrency": 0.0,
        "fees": 0.0,
        "currency": "",
        "effectiveDate": "",
        "buyPrice": 0.0,
        "zqBuyPrice": 0.0,
        "standardPrice": 0.0,
        "roomPrice": 0.0,
        "promotion": "",
        "date": "",
        "costPrice": 0.0,
        "salePrice": 0.0,
        "ruleSalePrice": 0.0
      }
    ],
    "paragraph": [
      ""
    ],
    "prompt": [
      ""
    ],
    "availabilityStatus": "",
    "availableQuantity": 0,
    "supplierID": "",
    "invoiceTargetType": 0,
    "buyPrice": 0.0,
    "cancelStart": "",
    "guaranteeMode": "",
    "isExceedCode": "",
    "isExceedDesc": "",
    "excessAmount": 0.0
  }
}