# 订单详情查询
# 1.接口说明
名称 | 描述 |
---|---|
功能 | 查询订单详情 |
HTTP方法 | POST |
请求方 | 第三方平台 |
响应方 | 美团企业版平台 |
uri | $API_HOST/queryOrderDetail |
method | order.detail.query |
# 2.公共参数
# 3.业务参数
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
sqtBizOrderId | Long | 是 | 306092209006387202 | 美团企业版订单ID,与支付序列号不能同时为空 |
paySerialNum | String | 否 | 2BWZJWWFL2PU | 交易产生的支付序列号,与美团企业版订单ID不能同时为空 |
说明:一个美团企业版订单可能对应多次支付记录,即一个sqtBizOrderId对应多个支付序列号paySerialNum。通过paySerialNum查询,只返回paySerialNum单条支付记录对应的金额信息,否则返回sqtBizOrderId对应的全部金额信息
# 4.业务响应
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
orderBaseInfo | OrderBaseInfo | 是 | 订单基础信息 | |
staffInfo | StaffInfo | 否 | 员工基本信息 | |
invoiceInfo | InvoiceInfo | 否 | 发票基本信息 | |
controlInfo | ControlInfo | 否 | 管控信息,包含订单关联申请信息 | |
payInfo | PayInfo | 是 | 支付基本信息 | |
wmOrder | WMOrderInfo | 否 | 外卖订单详情,sqtType=4 时非空 | |
groupOrder | GroupOrderInfo | 否 | 团购订单详情,sqtType=3 时非空 | |
offlineOrder | OfflineOrderInfo | 否 | 线下消费订单详情,sqtType=10000 时非空 | |
carOrder | CarOrderInfo | 否 | 打车订单详情,sqtType=5 时非空 | |
hotelOrder | HotelOrderInfo | 否 | 酒店订单详情,sqtType=10 时非空 | |
flightOrder | FlightOrderInfo | 否 | 机票订单详情,sqtType=12 时非空 | |
trainOrder | TrainOrderInfo | 否 | 火车票订单详情,sqtType=13 时非空 | |
maicaiOrder | MaicaiOrderInfo | 否 | 买菜订单详情,sqtType=20 时非空 | |
paotuiOrder | PaotuiOrderInfo | 否 | 跑腿订单详情,sqtType=24 时非空, 跑腿业务未上线,对接请提前沟通 | |
peicanOrder | PeicanOrderInfo | 否 | 盒餐和现场就餐订单详情,sqtType=22 ,sqtType=23 时非空 | |
medicineOrder | MedicineOrderInfo | 否 | 买药订单详情,sqtType=26 时非空 |
# OrderBaseInfo
OrderBaseInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
sqtBizOrderId | Long | 是 | 306092209006387202 | 美团企业版订单ID |
sqtType | Integer | 是 | 5 | 美团企业版业务类型: 1 买单,16 新买单 2 预定 3 团购 4 外卖 5 打车 10 酒店 11 门票 12 机票 13 火车票 14 电影票 15 扫码消费 19 优选 20 买菜 21 团好货 22 盒餐 23 现场就餐 24 跑腿 25 文印图文 26 买药 27 安心付 10000 线下订单特许报备 11000 银联付款码 |
sqtTypeName | String | 是 | 打车 | 订单类型 |
origOrderId | String | 是 | 117422220368474118618069100000 | 业务线原始订单ID |
provinceName | String | 否 | 四川省 | 消费省名称 |
cityName | String | 否 | 成都市 | 消费城市 |
locationName | String | 否 | 锦江区 | 消费区名称 |
provinceCode | String | 否 | 510000 | 消费省编码(国标) |
cityCode | String | 否 | 510100 | 消费城市编码(国标) |
locationCode | String | 否 | 510104 | 消费区编码(国标) |
createdTime | String | 是 | 2019-09-18 15:22:44 | 下单时间 |
updateTime | String | 是 | 2019-09-18 15:22:44 | 更新时间 |
sceneTypeName | String | 否 | 商务差旅 | 下单场景 |
rulePackId | String | 否 | 8410 | 订单应用规则ID(目前适用于餐、车类订单) |
ruleName | String | 否 | 工作日加班餐 | 订单应用规则名称(目前适用于餐、车类订单) |
shopName | String | 否 | 麦当劳店 | 店铺名称(需要额外授权才能获取到) |
shopPhone | String | 否 | 010-xxxxxx | 店铺电话(多个以"/"隔开)(需要额外授权才能获取到) |
shopAddress | String | 否 | 中关村 | 店铺地址(需要额外授权才能获取到) |
shopInvoiceTitle | String | 否 | 商家工商注册信息(只能作为合规参考项,和实际开票抬头可能有差异) | |
bizOrPersonal | Integer | 否 | 0 | 因公因私 0表示公;1表示私 空值表示未知 |
costCenterList | List<CostCenterInfo> | 否 | 成本信息 | |
costBelongInfo | CostBelongInfo | 否 | 费用归属信息(项目、成本中心分摊等信息) | |
orderAmount | String | 是 | 35.40 | 订单金额:元 |
# CostCenterInfo
CostCenterInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
costSource | Integer | 是 | 1 | 成本中心类型 1表示美团企业版成本中心;2表示美团企业版部门;3表示第三方成本中心 |
costNo | String | 是 | 414414 | 成本中心唯一标识 |
costName | String | 是 | 制造本部-河北工厂 | 成本中心名字 |
tradeType | Integer | 是 | 10 | 交易类型 10表示企业支付;20表示个人垫付; |
amount | String | 是 | 20.23 | 分摊金额:元,四舍五入保留2位小数 |
ratio | String | 是 | 0.30 | 分摊比例 |
customField1 | String | 否 | 扩展字段1 | |
customField2 | String | 否 | 扩展字段2 | |
customField3 | String | 否 | 扩展字段3 | |
customField4 | String | 否 | 扩展字段4 | |
customField5 | String | 否 | 扩展字段5 |
# CostBelongInfo
CostBelongInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
costCenterList | List<CostInfo> | 否 | 成本中心及分摊信息 | |
projectList | List<CostInfo> | 否 | 项目列表及分摊信息 |
CostInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
costSource | Integer | 是 | 1 | 成本来源 1.成本中心 2.部门 3.第三方成本中心 4.项目 5.第三方项目 |
costNo | String | 是 | 414414 | 成本唯一标识 |
costName | String | 是 | 制造本部-河北工厂 | 成本名字 |
amount | String | 是 | 20.23 | 分摊金额:元,四舍五入保留2位小数 |
ratio | String | 是 | 0.30 | 分摊比例 |
customField1 | String | 否 | 扩展字段1 | |
customField2 | String | 否 | 扩展字段2 | |
customField3 | String | 否 | 扩展字段3 | |
customField4 | String | 否 | 扩展字段4 | |
customField5 | String | 否 | 扩展字段5 | |
parentChain | List<ParentChain> | 否 | 父级链 |
ParentChain字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
costLevel | Integer | 是 | 1 | 父级级别 |
costNo | String | 是 | 5555 | 成本唯一标识 |
costName | String | 是 | 制造本部 | 成本名字 |
# StaffInfo
StaffInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
staffId | Long | 是 | 230477 | 员工ID |
staffEntNum | String | 否 | 1008611 | 员工工号 |
staffEmail | String | 否 | sucesi@test.cn | 员工邮箱 |
staffName | String | 是 | 苏测试 | 员工姓名 |
staffPhone | String | 否 | 15200000000 | 员工手机 |
staffSerialNum | String | 否 | 3DUOWTZNTN | 员工编码 |
staffLevel | String | 否 | 测试工程师 | 员工级别 |
staffCity | String | 否 | 上海 | 员工所在城市 |
staffOrgInfos | List<StaffOrgInfo> | 否 | 员工部门 |
StaffOrgInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
orgPathName | String | 否 | 美团-XX事业部-XX | 部门路径名称 |
# InvoiceInfo
InvoiceInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
invoiceTitle | String | 否 | 北京三快在线科技有限公司 | 抬头 |
invoiceTaxNum | String | 否 | xxxxxxxxxxxxxxxxxx | 税号 |
invoiceId | String | 否 | 123456 | 企业内部发票Id |
needInvoiceName | String | 否 | 无需平台代收 | 是否需要代收 |
orderInvoiceStatusName | String | 否 | 发票代收状态 |
# ControlInfo
ControlInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
applyNo | String | 否 | 申请号 | 申请唯一标识号(未来废弃,仅支持差旅/用餐申请单,不支持返回多个申请单,不支持用车申请单) |
outerApplyNo | String | 否 | xxxxxxxxxxxxxxxxxx | 外部申请号 |
outerApplyType | Integer | 否 | 1 | 外部申请类型: 1为出差申请,2为用餐申请 |
applyQuotaExceedLimitInfo | ApplyQuotaExceedLimitInfo | 否 | 申请单额度超标信息,此字段作废,如需超标信息,请使用quotaExceedLimitInfoList字段 | |
quotaExceedLimitInfoList | List<QuotaExceedLimitInfo> | 否 | 额度超标信息列表 | |
applyList | List<ApplyInfo> | 否 | 申请单信息(支持多个申请单,支持差旅/用餐/用车申请单) | |
exceedLimitList | List<ExceedLimitInfo> | 否 | 超规则列表信息,对接请提前咨询 | |
auditList | List<AuditInfo> | 否 | 审批列表信息,对接请提前咨询 |
ApplyQuotaExceedLimitInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
isExceed | Integer | 是 | 0 | 是否超标 0:未超标,1:超标 |
exceedAmount | String | 是 | 22.02 | 超标金额 单位:元,精确到小数点后两位 |
reason | String | 否 | 申请用餐 | 原因 |
QuotaExceedLimitInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
quotaCode | String | 是 | applyExceed | 额度code,applyExceed:申请额度超标; avgPersonExceed:人均额度超标 |
isExceed | Integer | 是 | 0 | 是否超标 0:未超标,1:超标 |
exceedAmount | String | 是 | 22.02 | 超标金额 单位:元,精确到小数点后两位 |
reason | String | 否 | 申请用餐 | 原因 |
ApplyInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
applyNo | String | 否 | 123456 | 美团企业版申请单号 |
applyType | Integer | 否 | 1 | 美团企业版申请单类型: 1为出差申请, 2为用餐申请, 3为用车申请 |
ExceedLimitInfo 超标字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
bizType | Integer | 是 | 1 | 业务节点类型 1,下单,2,改签 |
ruleType | Integer | 是 | 111 | 超规则项类型 |
ruleName | String | 否 | 未提前预订 | 超规项名称 |
ruleLimit | String | 否 | 0.00 | 规则标准 |
reason | String | 否 | 提前预定 | 超规则原因 |
reasonRemark | String | 否 | 备注测试 | 超规则原因备注 |
AuditInfo 审批字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
bizType | Integer | 是 | 1 | 业务节点类型 1-预订,2-改签,3-退订 |
auditNo | String | 是 | 111222 | 审批单号 |
auditStatus | Integer | 是 | 10 | 审批状态,10.待提交 20.审批中 30.已撤回 40.已驳回 60.已完成 |
# PayInfo
PayInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
payAmount | String | 是 | 35.40 | 支付金额:元(不含服务费) |
entPayAmount | String | 是 | 35.40 | 企业支付金额:元(不含服务费) |
staffPayAmount | String | 是 | 0.00 | 员工支付金额:元 |
refundAmount | String | 是 | 0.00 | 退款金额:元(不含服务费) |
entRefundAmount | String | 是 | 0.00 | 企业退款金额:元(不含服务费) |
staffRefundAmount | String | 是 | 0.00 | 员工退款金额:元 |
totalReduceAmount | String | 是 | 0.00 | 总优惠金额:元 |
realAmount | String | 是 | 35.40 | 实付金额:元(不含服务费) |
repayAmount | String | 是 | 0.00 | 偿还金额:元 |
businessDiscountPayAmount | String | 是 | 0.00 | 优惠承担支付金额:元 |
businessDiscountRefundAmount | String | 是 | 0.00 | 优惠承担退款金额:元 |
realtimeServiceFee | String | 否 | 0.04 | 随单收服务费:元,四舍五入保留2位小数 |
realtimeServiceFeePayAmount | String | 否 | 0.04 | 随单收服务费支付金额:元 |
realtimeServiceFeeRefundAmount | String | 否 | 0.04 | 随单收服务费退款金额:元 |
realtimeServiceFeeBudgetPayAmount | String | 否 | 0.04 | 随单收服务费扣预算支付金额:元 |
realtimeServiceFeeBudgetRefundAmount | String | 否 | 0.04 | 随单收服务费扣预算退款金额:元 |
realtimeServiceFeeMode | Integer | 否 | 1 | 随单收服务费承担方式枚举: 0 企业承担(不扣预算),1员工承担(扣员工预算),10组合承担 |
afterServiceFee | String | 否 | 0.00 | 后结算服务费:元,四舍五入保留2位小数 |
afterServiceFeePayAmount | String | 否 | 0.00 | 后结算服务费支付金额:元 |
afterServiceFeeRefundAmount | String | 否 | 0.00 | 后结算服务费退款金额:元 |
payStatus | Integer | 是 | 20 | 支付状态枚举: 10未支付,20已支付,31部分退款,32全额退款 |
payStatusName | String | 是 | 已支付 | 支付状态: 未支付,已支付,部分退款,全额退款 |
payType | Integer | 否 | 10 | 支付类型枚举: 10企业支付,20个人支付,50组合支付 |
payTypeName | String | 否 | 企业支付 | 支付类型: 企业支付、个人支付、组合支付 |
payTime | String | 否 | 2019-09-18 15:22:48 | 支付时间 |
latestRefundTime | String | 否 | 2019-09-19 12:34:56 | 最后退款时间 |
# WmOrderInfo
WmOrderInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
orderStatus | Integer | 是 | 1 | 参见外卖订单状态 |
logisticsStatus | Integer | 是 | 1 | 参见外卖配送状态 |
boxTotalPrice | String | 是 | 0.2 | 餐盒费:元 |
originalPrice | String | 是 | 32.2 | 订单原价:元 |
recipientAddress | String | 是 | 望京国际研发园 | 收货人地址 |
remark | String | 否 | 少放辣椒 | 订单备注 |
shippingFee | int | 是 | 5 | 配送费:元 (由于精度问题,请使用strShippingFee替代) |
strShippingFee | String | 是 | 5.5 | 配送费:元 |
total | String | 是 | 32.2 | 订单总金额:元 |
foodList | List<FoodListItem> | 是 | [{}] | 菜品明细 |
recipientName | String | 是 | 张三 | 收货人姓名 |
recipientPhone | String | 是 | 18511071111 | 收货人电话 |
addressLongitude | Integer | 是 | 116491116 | 配送地址经度 (国标,扩大了10的6次方) |
addressLatitude | Integer | 是 | 40002102 | 配送地址纬度 (国标,扩了了10的6次方) |
estimateArrivalTime | Long | 是 | 1509525086 | 预计到达时间(精度是秒) |
deliverTime | Long | 否 | 1509522086 | 实际已送达时间 (精度是秒) |
bookingOrder | boolean | 是 | true | 是否预约订单:true为预订单;false为非预订单 |
actualPayTotal | String | 是 | 32.2 | 应付金额:元 |
appendProductDetailList | List<AppendProductDetailList> | 是 | [{}] | 搭售商品明细 |
poiCateCode | Long | 是 | 21000000 | 商家一级品类code |
poiCateDesc | String | 是 | 美食 | 商家一级品类名称 |
poi2ndCateCode | Long | 是 | 21030000 | 商家二级品类code |
poi2ndCateDesc | String | 是 | 小吃 | 商家二级品类名称 |
poi3rdCateCode | Long | 否 | 21030001 | 商家三级品类code |
poi3rdCateDesc | String | 否 | 炸物类小吃 | 商家三级品类名称 |
pickType | int | 是 | 0 | 配送类型 0-普通订单 1-到店自取订单 2-独立到店自取订单 |
FoodListItem字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
boxNum | int | 是 | 1 | 餐盒数量 |
boxPrice | String | 是 | 0.1 | 餐盒价格:元 |
count | int | 是 | 2 | 数量 |
name | String | 是 | 鱼香茄子 | 菜品名称 |
originPrice | String | 是 | 13.5 | 原始金额:元 |
price | String | 是 | 13.5 | 菜品金额:元 |
AppendProductDetailListItem字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
productId | String | 是 | 3461016706757955635 | 搭售商品id |
name | String | 是 | 准时宝 | 搭售商品名称,如准时宝 |
originalPrice | double | 是 | 1.92 | 原价:元 |
price | double | 是 | 1.92 | 实付价格:元 |
# GroupOrderInfo
GroupOrderInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
groupUseType | String | 否 | 套餐/代金券 | 团购形式 |
groupBusinessType | String | 否 | 到餐团购 | 团购类型 |
groupPayment | String | 否 | 100 | 补录金额,元 |
grouponCodeList | List<GrouponCodeInfo> | 否 | 券核销信息 | |
groupPaymentTime | Long | 否 | 1635177600000 | 团购余额补录时间戳 |
groupConsumeStatus | Integer | 否 | 0 | 团购核销状态 |
consumeDetail | String | 否 | 核销详情 |
GrouponCodeInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
encryptCode | String | 否 | aWHtScIHEXEDvymMpHCy9w | 券码 |
consumeTime | Long | 否 | 1538989711002 | 核销时间 |
shopName | String | 否 | 百岁我家·酸菜鱼专门店(古美店) | 核销店铺 |
shopServicePhone | String | 否 | 888888 | 联系方式 |
shopAddress | String | 否 | 高银街29号 | 店铺地址 |
province | String | 否 | 浙江省 | 核销省份 |
city | String | 否 | 杭州市 | 核销城市 |
location | String | 否 | 西湖区 | 核销区县 |
provinceCode | String | 否 | 330000 | 核销省份编码(国标) |
cityCode | String | 否 | 330100 | 核销城市编码(国标) |
locationCode | String | 否 | 330106 | 核销区县编码(国标) |
grouponStatus | Integer | 否 | 10 | 团购券状态 -10-未知,0-未使用,5-部分使用,10-已使用,20-已冻结,30-已撤销,100-已退款,110-部分退款 |
# OfflineOrderInfo
OfflineOrderInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
diningTime | String | 是 | 2019-12-31 | 用餐时间 |
peopleNum | String | 是 | 1 | 人数 |
amount | String | 是 | 100 | 金额:元 |
avgFee | String | 是 | 100 | 人均:元 |
reason | String | 是 | 商家不接受企业支付 | 特许事由 |
reasonGroup | String | 是 | 商家原因-餐厅不允许使用企业支付 | 特许原因 |
auditStatusCode | Integer | 否 | 0 | 审核状态 0无需审核,1审核中,2审核通过,3拒绝 |
auditStatusDesc | String | 否 | 无需审核 | 审核状态描述 |
# CarOrderInfo
CarOrderInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
carOrderBase | CarOrderBaseInfo | 是 | 订单基本信息 | |
passengers | List<CarPassenger> | 否 | 乘车人列表信息 | |
orderBill | CarOrderBill | 是 | 费用账单信息 |
CarOrderBaseInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
orderStatus | Integer | 是 | 1 | 参见打车订单状态 |
payStatus | Integer | 是 | 3 | 支付状态 0初始 1待付款 2付款中 3付款成功 4付款失败 5申请退款 6确认退款 7拒绝退款 8退款成功 9退款失败 12代扣中 13代扣成功 14代扣失败 |
useType | Integer | 否 | 4 | 用车场景 1 加班用车,4 差旅用车,7 日常公出 |
useTypeName | String | 否 | 加班 | 用车场景名称 |
tripSceneType | Integer | 否 | 7 | 差旅用车子场景 5 前往机站,6 离开机站,7 出差城市用车 |
tripSceneTypeName | String | 否 | 往返机站 | 差旅用车子场景名称 |
carTypeDesc | String | 是 | 美团快车 | 接单运力描述 |
partnerCarTypeName | String | 是 | 美团快车 | 接单车型 |
orgCityName | String | 是 | 北京市 | 用车城市 |
arrCityName | String | 是 | 北京市 | 目的城市 |
reserveType | Integer | 是 | 1 | 预约单类型 1 实时单 2 预约单 |
reserveTime | Long | 是 | 0 | 13位时间戳,预约用车时间 |
startAddress | String | 是 | 中国电科太极信息技术产业基地(西门)北侧 | 用户选择的上车点 |
startLongitude | String | 是 | 116.470866 | 用户选择的上车点经度 |
startLatitude | String | 是 | 40.021955 | 用户选择的上车点纬度 |
endAddress | String | 是 | 望京-地铁站 | 用户选择的目的地 |
endLongitude | String | 是 | 116.468674 | 用户选择的目的地经度 |
endLatitude | String | 是 | 39.998833 | 用户选择的目的地纬度 |
deliveryStartAddress | String | 否 | 来广营东路7号靠近秦淮数据信息技术产业基地 | 系统定位的上车点 |
deliveryStartLongitude | String | 否 | 116.47206 | 系统定位的上车点经度 |
deliveryStartLatitude | String | 否 | 40.022212 | 系统定位的上车点纬度 |
deliveryEndAddress | String | 否 | 来广营东路7号靠近秦淮数据信息技术产业基地 | 系统定位的目的地 |
deliveryEndLongitude | String | 否 | 116.47206 | 系统定位的目的地经度 |
deliveryEndLatitude | String | 否 | 116.47206 | 系统定位的目的地纬度 |
driverName | String | 否 | 车先生 | 接单司机 |
driverCarNumber | String | 否 | 苏A21365 | 司机车牌号 |
driverCarModel | String | 否 | xxxx | 汽车型号 |
driverCarColor | String | 否 | 黑色 | 车身颜色 |
cancelReason | String | 否 | 行程取消 | 取消原因 |
cancelLiabCode | Integer | 否 | 1 | 取消方(1-乘客,2-司机,3-平台) |
orderCreatedTime | Long | 是 | 1617085650321 | 13位时间戳,用车订单创建时间 |
orderConfirmedTime | Long | 否 | 1617085673611 | 13位时间戳,司机接单时间时间 |
tripStartedTime | Long | 否 | 1617085974783 | 13位时间戳,行程开始时间 |
tripDeliveredTime | Long | 否 | 1617085974783 | 13位时间戳,行程结束时间 |
latestUpdateTime | Long | 是 | 1617085974783 | 13位时间戳,更新时间 |
payType | String | 否 | biztpay | 支付方式 |
useReason | String | 否 | 公务需要 | 用车原因 |
rulePackId | String | 否 | 1000000828 | 用车规则包ID (推荐使用OrderBaseInfo中的rulePackId) |
ruleName | String | 否 | 日常公出 | 用车规则名称 (推荐使用OrderBaseInfo中的ruleName) |
upgradeType | String | 否 | 自费升舱 | 升舱服务 |
# CarPassenger
CarPassenger字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
passengerName | String | 是 | 王会 | 乘车人姓名 |
passengerId | String | 否 | 123456 | 用户直接填写乘车人姓名后带出乘车人内部工号ID,若为外部用户则ID为空 |
passengerUniqueIdentifier | String | 否 | N003481612 | 乘车人对应的员工唯一识别码(企业设置的员工唯一标识,可能为邮箱、工号或手机号),若为外部用户则ID为空 |
passengerType | Integer | 是 | 1 | 内部或外部用户,1表示内部,2表示外部 |
CarOrderBill字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
cancelPrice | CancelPrice | 是 | 取消费用 | |
userPrice | UserPrice | 是 | 用户费用 | |
beforeTripPrice | BeforeTripPrice | 是 | 行程前费用 | |
afterTripPrice | AfterTripPrice | 是 | 行程后费用 |
CancelPrice字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
cancelPay | Integer | 是 | 用户取消时需要支付的费用总和 | |
cancelFee | Integer | 是 | 用户费用 |
UserPrice字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
driveDistance | Integer | 是 | 行驶里程,单位米 | |
driveDistancePrice | Integer | 是 | 行驶里程费,单位分 | |
driveLongDistance | Integer | 是 | 远途里程,单位米 | |
driveLongDistancePrice | Integer | 是 | 远途里程费,单位分 | |
driveMinPrice | Integer | 是 | 最低消费,单位分 | |
driveNight | Integer | 是 | 夜间里程,单位米 | |
driveNightPrice | Integer | 是 | 夜间费,单位分 | |
driveStartPrice | Integer | 是 | 起步价,单位分 | |
driveTime | Integer | 是 | 行驶时长,单位毫秒 | |
driveTimePrice | Integer | 是 | 行驶时长费,单位分 | |
dynamicMaxPrice | Integer | 是 | 溢价封顶费用,单位分 | |
dynamicPrice | Integer | 是 | 动态调价费,单位分 | |
fixedPrice | Integer | 是 | 一口价订单,预支付阶段需要用户支付的原始一口价(未减免红包金额) | |
multiple | Integer | 是 | 计价倍数 | |
normalDistance | Integer | 是 | 正常里程,单位米 | |
normalDistancePrice | Integer | 是 | 正常里程费,单位分 | |
normalTime | Integer | 是 | 正常时长 | |
normalTimePrice | Integer | 是 | 正常时长费,单位分 | |
startPriceDistance | Integer | 是 | 起步价最大里程,单位米 | |
startPriceTime | Long | 是 | 起步价最大时长 | |
totalPrice | Integer | 是 | 订单总金额,单位分 | |
servicePriceAmount | Integer | 是 | 春节服务费,单位分 | |
taxiMeterFee | Integer | 是 | 出租车打表金额,单位分 | |
discountPrice | Integer | 是 | 三方运力优惠金额,单位分 | |
priceDifference | Integer | 是 | 基础费用补足金额,单位分 |
BeforeTripPrice字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
platformDispatchPrice | Integer | 是 | 平台调度费,单位分 | |
dispatchPrice | Integer | 是 | 调度费,单位分 | |
longDispatchPrice | Integer | 是 | 远途调度费,单位分 | |
waitFee | Integer | 是 | 等待费,单位分 | |
waitTime | Integer | 是 | 等待时长 | |
thanksFee | Integer | 是 | 感谢费,单位分 |
AfterTripPrice字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
driveTollPrice | Integer | 是 | 通行费,单位分 | |
driveParkPrice | Integer | 是 | 停车费,单位分 | |
driveOtherPrice | Integer | 是 | 其他费用,单位分 | |
driveHighwayPrice | Integer | 是 | 高速费,单位分 | |
eDispatchFee | Integer | 是 | 电调费,单位分 |
# HotelOrderInfo
HotelOrderInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
hotelOrderBase | HotelOrderBaseInfo | 是 | 订单基本信息 | |
aptInfo | OrderAptInfo | 是 | 订单预定信息信息 | |
guests | List<HotelGuest> | 是 | 入住人信息 | |
roomNights | List<HotelRoomNight> | 是 | 间夜信息 | |
shareInfo | HotelShareInfo | 是 | 合住人信息 | |
appealInfos | List<HotelAppealInfo> | 否 | 退订服务单信息 |
HotelBaseInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
orderStatus | Integer | 是 | 5125 | 业务订单状态 |
orderAmount | Long | 是 | 18905 | 订单金额,单位分 |
invoiceType | Integer | 是 | 1 | 发票类型 1 普票 2 专票 |
isExceeded | boolean | 是 | true | 房费是否超标 true 超标(即将废弃,新字段详见controlInfo管控信息) |
exceedReason | String | 否 | 地点合适 | 房费超标原因(即将废弃,新字段详见controlInfo管控信息) |
isBusinessFirst | boolean | 是 | true | 是否商务优选 true 优选 |
isAgreement | boolean | 是 | true | 是否协议价订单 true 协议价订单 |
isReceptionInvoice | boolean | 是 | true | 是否前台拿票 true 前台拿票 |
isOverseal | boolean | 是 | true | 是否海外订单 true 是 false 国内订单,目前只有国内酒店 |
hotelPayType | Integer | 是 | 0 | 酒店费用类型 0预付 2现付 |
currency | String | 是 | CNY | 币种 |
expressAmount | Integer | 是 | 0 | 快递金额,单位分 |
roomCount | Integer | 是 | 1 | 房间数 |
roomNightCount | Integer | 是 | 2 | 间夜数 |
createTime | Long | 是 | 1597823417000 | 下单时间, 13位时间戳 |
modifyTime | Long | 是 | 1597823448000 | 修改时间, 13位时间戳 |
sourceType | String | 是 | 分销 | 下单渠道 |
riskAmount | Integer | 是 | 0 | 差标,单位分 |
avgNightAmount | Integer | 是 | 1000 | 间夜均价, 单位分 |
invoiceSubject | String | 是 | 第三方发票 | 开票方 |
lossFromRefund | Integer | 否 | 500 | 退订损失(单位分),为整个订单因退订产生的损失金额(e.g. 提前离店、阶梯取消等) |
OrderAptInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
checkinTime | Long | 是 | 1597823417000 | 入住时间, 13位时间戳 |
checkoutTime | Long | 是 | 1597823448000 | 离店时间, 13位时间戳 |
actualCheckinTime | Long | 否 | 1597823448000 | 实际入住时间, 13位时间戳 |
actualCheckoutTime | Long | 否 | 1597823448000 | 实际离店时间, 13位时间戳 |
lastCancelTime | Long | 否 | 1597823417000 | 最晚取消时间 |
hotelType | String | 是 | 商务酒店 | 酒店类型 |
hotelStar | String | 否 | 高档 | 0:国家旅游局颁布五星级证书;1:豪华(按五星级标准建造);2:国家旅游局颁布四星级证书;3:高档(按四星级标准建造);4:国家旅游局颁布三星级证书;5:舒适型(按三星级标准建造);6:经济型;7:低档 |
breakfast | String | 否 | 早餐信息 | |
cityLocationName | String | 是 | 南京 | 酒店所在城市 |
cityLocationCode | String | 是 | 340100 | 酒店所在城市编码(国标) |
provinceLocationName | String | 否 | 江苏 | 酒店所在省 |
provinceLocationCode | String | 否 | 340000 | 酒店所在省编码(国标) |
poiId | Long | 是 | 57073 | 酒店id |
poiName | String | 是 | 金利源酒店 | 酒店名字 |
poiAddress | String | 是 | 南京XXX | 酒店地址 |
goodsId | Long | 是 | 402768792 | 产品id |
roomName | String | 是 | 标准间 | 房型名字 |
partnerName | String | 是 | 美团 | 供应商 |
partnerType | String | 是 | 酒店集团 | 供应商类型 |
HotelGuest字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
type | Integer | 是 | 0 | 用户类型( 0 入住人 1 联系人) |
name | String | 是 | 5125 | 姓名 |
phone | String | 否 | 18905 | 电话 |
staffId | Long | 否 | 230477 | 出行人的员工ID |
staffType | Integer | 否 | 1 | 出行人类型( 1 内部员工 2 外部人员 ) |
staffUniqueIdentifier | String | 否 | N003481612 | 出行人的员工唯一识别码(企业设置的员工唯一标识,可能为邮箱、工号或手机号) |
roomIndexId | Integer | 否 | 201 | 房间号 |
String | 否 | 联系邮箱,该字段无值 | ||
tripId | Long | 否 | 230477 | 入住人关联出差申请id |
itineraryId | Long | 否 | 230477 | 入住人关联出差申请行程id |
HotelRoomNight字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
bizDay | Long | 是 | 1597823448000 | 间夜日期, 13位时间戳 |
soldPrice | Integer | 是 | 18905 | 售卖价,单位分 |
payStatus | Integer | 是 | 2010 | 支付状态 |
roomIndexId | Integer | 否 | 201 | 房间号 |
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
shareMode | Integer | 是 | 1 | 合住模式,是否有合住(0未合住,1 有合住) |
shareApplyId | Long | 否 | 547833 | 合住人出差申请单号(合住房间数量多于1间时,每个出行人关联的申请单号请从HotelGuest列表获取) |
shareApplyStaffId | Long | 否 | 633144 | 合住人ID(合住房间数量多于1间时,每个出行人关联的申请单号请从HotelGuest列表获取) |
shareApplyStaffName | String | 否 | 合住人姓名(合住房间数量多于1间时,每个出行人关联的申请单号请从HotelGuest列表获取) |
HotelAppealInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
appealId | Long | 是 | 12275 | 服务单id |
refundType | Integer | 是 | 1 | 退订类型 1-订单取消;2-申请退订 |
refundNode | Integer | 是 | 2 | 业务节点,2-确房前申请;3-确认成功后申请 |
operateType | Integer | 是 | 1 | 创建角色 1-用户(用户端);2-客服(客服端) |
refundStatus | Integer | 是 | 1 | 退订状态 1-待退订;2-退订成功;3-退订失败;4-退订撤回 |
refundFlowId | String | 否 | 693926668463878146 | 退款流水id |
refundPartInfos | List<RefundPartInfo> | 否 | 退订间夜info | |
refundReasonName | String | 是 | 疫情原因 | 退订原因名称 |
refundReasonComment | String | 否 | 其他 | 退订备注 |
needRefundMoney | Integer | 是 | 1 | 是否需退款 1:是 0:不是 |
applyRefundAmount | Integer | 否 | 28615 | 申退金额,单位分 |
shouldRefundAmount | Integer | 否 | 应退总金额,单位分 | |
realRefundAmount | Integer | 否 | 实退总金额,单位分 | |
gmtCreated | Long | 是 | 1664255109000 | 创建时间 |
gmtModified | Long | 是 | 1664255109000 | 更新时间 |
RefundPartInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
guestId | Long | 是 | 4894761 | 美团企业版用户ID(美团企业版内外部出行人主键) |
bizDay | Long | 是 | 1597823448000 | 间夜日期, 13位时间戳 |
roomIndexId | Integer | 否 | 201 | 房间号 |
# FlightOrderInfo
FlightOrderInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
flightOrderBase | FlightOrderBaseInfo | 是 | 订单基本信息 | |
passengers | List<FlightOrderPassenger> | 是 | 乘机人列表信息 | |
tickets | List<FlightOrderTicket> | 否 | 客票信息 | |
insuranceList | List<FlightOrderInsurance> | 否 | 保险信息 | |
segments | List<FlightOrderSegment> | 是 | 航班信息 | |
rescheduleList | List<FlightReschedule> | 否 | 改签服务单信息 | |
returnList | List<FlightReturn> | 否 | 退票服务单信息 | |
diffRefundList | List<FlightDiffRefund> | 否 | 退差信息 | |
lowInfo | FlightOrderLowInfo | 是 | 低价信息 |
FlightOrderBaseInfo 订单基本信息
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
orderStatus | Integer | 是 | 300 | 订单状态 |
orderAmount | Integer | 是 | 18905 | 订单金额,单位分 |
refundAmount | Integer | 是 | 18905 | 累计退票手续费。单位分 |
rescheduleAmount | Integer | 是 | 18905 | 累计改签费(手续费+升舱费)。单位分 |
diffAmount | Integer | 是 | 18905 | 累计退差费。单位分 |
payType | Integer | 是 | 10 | 原单支付方式 |
refundReason | String | 否 | 退票原因(即将废弃,新字段详见退票服务单) | |
refundReasonRemark | String | 否 | 退票备注详情(即将废弃,新字段详见退票服务单) | |
rescheduleReason | String | 否 | 改签原因(即将废弃,新字段详见改签服务单) | |
rescheduleReasonRemark | String | 否 | 改签备注详情(即将废弃,新字段详见改签服务单) | |
protocolType | Integer | 是 | 1 | 协议类型, 1协议航司 |
contactPhone | String | 是 | 135xxxx | 联系人手机号 |
internalFlag | Integer | 是 | 1 | 1,国内,0,国际(目前不支持国际,均默认为1) |
seg | Integer | 是 | 1 | 1 航段序号 |
notAdvanceBookReason | String | 否 | 出差日程刚确认完毕 | 未提前预订原因 |
notBookLowestPriceReason | String | 否 | 已售空 | 未预订最低价原因 |
createTime | Long | 是 | 1597823417000 | 下单时间, 13位时间戳 |
latestUpdateTime | Long | 是 | 1597823417000 | 更新时间, 13位时间戳 |
agentName | String | 是 | 东航旗舰店 | 代理商名称 |
advanceBookLimitDays | Integer | 否 | 3 | 提前预订校验天数 |
advanceDay | Integer | 是 | 2 | 提前预订天数 |
isBookExcessStandardCabin | boolean | 是 | true | 是否预订超标舱位(即将废弃,新字段详见超规则详情exceedLimitList) |
bookExcessStandardCabinReason | String | 否 | 预订超标舱位的原因(即将废弃,新字段详见超规则详情exceedLimitList) | |
beforeTickets | List<FlightOrderTicket> | 否 | 历史客票信息 | |
displayOrderStatus | Integer | 是 | 300 | 用户展示状态 |
FlightOrderPassenger 乘机人列表信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
name | String | 是 | 乘机人姓名 |
staffId | Long | 否 | 出行人的员工ID |
staffType | Integer | 否 | 出行人类型( 1 内部员工 2 外部人员 ) |
staffUniqueIdentifier | String | 否 | 出行人的员工唯一识别码(企业设置的员工唯一标识,可能为邮箱、工号或手机号) |
type | Integer | 是 | 乘机人类型 (0:成人,1:儿童,2:婴儿) |
idCard | String | 否 | 乘机人证件编号 |
idCardType | Integer | 是 | 乘机人证件类型(0 身份证 1 护照 2 其他) |
orderDisCount | Integer | 否 | 折扣信息, 比如88折,100代表不打折 |
passengerId | String | 是 | 乘机人ID |
FlightOrderTicket 客票信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
ticketNumber | String | 是 | 票号,如:784-123456 |
ticketStatus | String | 否 | 当前票号状态,如:LIFT/BOARDED |
ticketPrice | Integer | 是 | 票面价,单位分 |
soldPrice | Integer | 是 | 售卖价,单位分 |
fuelTax | Integer | 是 | 燃油费,单位分 |
tax | Integer | 是 | 税费,单位分 |
constructionFee | Integer | 是 | 基建费,单位分 |
ticketTime | Long | 否 | 出票时间, 13位时间戳 |
segmentId | String | 是 | 航段ID |
passengerId | String | 是 | 乘机人ID |
FlightOrderInsurance 保险信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
insNumber | String | 是 | 保险单号 |
insOrderId | String | 是 | 保险平台主单号 |
insCompany | String | 是 | 保险公司名 |
insType | Integer | 是 | 保险类型:8 组合险 9 航延险 10 航意险 |
insStatus | Integer | 是 | 保险状态,(状态码枚举见保险状态枚举说明),如:7 |
insAmount | Integer | 是 | 保险金额,如:3000,单位:分 |
passengerId | String | 是 | 乘机人ID |
FlightOrderSegment 航班信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
flightNumber | String | 是 | 航班号,如:MU5120 |
carrieCode | String | 否 | 航司码,如:CA |
carrieName | String | 否 | 航司名称 ,如:中国国航 |
departureCityName | String | 否 | 出发城市名称,如:北京 |
departureCityCode | String | 否 | 出发城市编码(国标),如:110000 |
arrivalCityName | String | 否 | 到达城市名称 ,如:上海 |
arrivalCityCode | String | 否 | 到达城市编码(国标),如:310000 |
departureCode | String | 是 | 出发机场三字码,如:PEK |
departureName | String | 是 | 出发机场名称,如:首都机场 |
departureTerminal | String | 否 | 出发航站楼,如:T1 |
departureTime | long | 否 | 起飞时间,如:1542704100000 |
arrivalCode | String | 是 | 到达机场三字码,如:SHA |
arrivalName | String | 是 | 到达机场站名称,如:虹桥机场 |
arrivalTerminal | String | 否 | 到达航站楼,如:T2 |
arrivalTime | long | 否 | 到达时间,如:1542704100000 |
adultCabin | String | 是 | 舱位,如:V |
adultCabinLevel | String | 是 | 舱等,如:Y,Y:经济舱,C:公务舱,F:头等舱 |
mileage | Integer | 否 | 里程,单位公里 |
flightRoute | String | 是 | 航程 |
economyClassFullPrice | Integer | 否 | 经济舱全价,单位分 |
segmentId | String | 是 | 航段ID |
segmentIndex | String | 是 | 航段序号 |
model | String | 否 | 机型 |
stopCities | String | 否 | 经停城市 |
stopTimes | Integer | 否 | 经停次数 |
haveMeal | Integer | 否 | 有无餐食 |
FlightOrderLowInfo 低价信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
lowestFlightNumber | String | 否 | 订票前后一小时最低价航班号 |
lowestDiscount | Integer | 否 | 订票前后一小时最低价折扣 |
lowestPrice | Integer | 否 | 订票前后一小时最低价 |
lowestDepartTime | String | 否 | 订票前后N小时最低价航班起飞时间 格式:yyyy-MM-dd HH:mm:ss |
lowestArriveTime | String | 否 | 订票前后N小时最低价航班降落时间 格式:yyyy-MM-dd HH:mm:ss |
lowestPriceLimitHour | Integer | 否 | 最低价校验小时数 |
browseLowestPriceType | Integer | 否 | 是否查看最低价 0.未呈现 1.是 2.否 |
isSystemDefaultLowestPriceAround1Hour | boolean | 是 | 是否是系统默认前后1小时最低价信息 |
isBookLowestPriceFlight | boolean | 是 | 是否预订最低价航班 |
isBookLowestCabin | boolean | 是 | 是否预订最低价舱位 |
FlightReschedule 改签服务单列表信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
serviceOrderId | String | 否 | 服务单号(即将废弃,优先使用serviceId) |
rescheduleApplyTime | Long | 是 | 改签申请时间 |
rescheduleTime | Long | 否 | 改签时间 |
rescheduleAmount | Integer | 是 | 改签费用,单位分 |
rescheduleFee | Integer | 是 | 改签手续费,单位分 |
cabinChangeFee | Integer | 是 | 改签升舱费,单位分 |
status | Integer | 是 | 业务侧改签状态 |
rescheduleReasonId | Integer | 是 | 改期原因id |
rescheduleType | Integer | 是 | 改签类型 0:人工改签,1:c端自助改期, 2:客服自助改期 |
applySource | Integer | 是 | 改签申请来源 |
rescheduleReason | String | 是 | 改期原因 |
rescheduleReasonRemark | String | 否 | 改期原因备注 |
isVoluntary | Integer | 是 | 0非自愿,1自愿 |
failReason | String | 否 | 失败原因 |
itineraryId | String | 否 | 改签行程单id |
rescheduleTicketList | List<RescheduleTicketInfo> | 是 | 改签详情 |
serviceId | String | 是 | 服务单号唯一标识 |
auditStatus | Integer | 否 | 改签单审批状态,10.待提交 20.审批中 30.已撤回 40.已驳回 60.已完成 |
RescheduleTicketInfo 改签票信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
originTicketId | String | 是 | 原票id |
targetTicketId | String | 否 | 改签票id |
FlightReturn 退票服务单信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
serviceOrderId | String | 是 | 服务单号 |
returnApplyTime | Long | 是 | 退票申请时间 |
rescheduleTime | Long | 否 | 退票成功时间 |
actualRefundAmount | Integer | 是 | 实际退款费用,单位分 |
refundFeeAmount | Integer | 是 | 退票手续费,单位分 |
returnReasonId | String | 是 | 退票原因Id |
returnReason | String | 是 | 退票原因 |
returnReasonRemark | String | 否 | 退票原因备注 |
returnType | Integer | 是 | 退票类型(1.自愿,2.非自愿) |
returnStatus | Integer | 否 | 用户侧退票状态 |
ticketIds | List | 否 | 退票客票id |
FlightDiffRefund 退差列表信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
ticketId | String | 是 | 客票ID |
diffAmount | Integer | 是 | 退差金额,单位分 |
# TrainOrderInfo
TrainOrderInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
trainOrderBase | TrainOrderBaseInfo | 是 | 订单基本信息 | |
grabInfo | GrabInfo | 否 | 抢票基本信息 | |
ticketInfoList | List<TicketInfo> | 是 | 票详细信息 | |
changeList | List<ChangeInfo> | 否 | 改签服务单详细信息 |
TrainBaseInfo订单基本信息
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
orderId12306 | String | 是 | EJ7638586 | 12306订单号 |
fromStationCode | String | 是 | SHH | 出发车站三字码 |
fromStationName | String | 是 | 上海站 | 出发车站名称 |
fromLocationName | String | 是 | 上海市 | 发车行政区名称,存在极少获取不到的情况 |
fromLocationCode | String | 是 | 310000 | 发车行政区编码(国标) |
toStationCode | String | 是 | VNP | 到达车站三字码 |
toStationName | String | 否 | 北京南站 | 到达车站名称 |
toLocationName | String | 否 | 北京市 | 到达行政区名称,存在极少获取不到的情况 |
toLocationCode | String | 否 | 110000 | 到达行政区编码(国标) |
contactPhone | String | 是 | 135xxxx | 联系人手机号 |
payTime | Long | 是 | 1598575736000 | 支付时间:13位时间戳 |
orderAmount | long | 是 | 55300 | 订单原始金额,单位分 |
orderStatus | Integer | 是 | 300 | 业务订单状态码 |
orderStatusName | String | 是 | 已发车 | 订单状态名称 |
createTime | Long | 是 | 1598575680000 | 创建时间 |
latestUpdateTime | Long | 是 | 1598575680000 | 最新更新时间 |
isExceeded | boolean | 是 | true | 是否超标 true表示超标 |
exceededReason | String | 否 | 领导安排 | 超标原因 |
travelRoute | String | 否 | 北京-上海 | 行程段 |
totalRefundFee | Integer | 否 | 100 | 退改签手续费:单位分,线下高价改低价手续费还包含了新票票价。 |
totalDiffMoney | Integer | 否 | 100 | 整单退差金额:单位分,支付金额-实际票价。 |
changeReason | String | 否 | 因行程变动 | 改签原因 |
changeReasonRemark | String | 否 | 个人行程变动 | 改签备注详情 |
refundReason | String | 否 | 暂时不需要了 | 退票原因 |
refundReasonRemark | String | 否 | 个人暂时不需要了 | 退票备注详情 |
supportBrushIdCard | Boolean | 是 | true | 车次是否支持刷身份证进站 |
GrabInfo抢票信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
optionDates | List<Long > | 否 | 乘车日期列表 |
seatTypes | List<String > | 否 | 坐席类型列表 |
trainCodes | List<String > | 否 | 车次列表 |
speedUpPackageNum | int | 否 | 加速包数量 |
speedUpPackagePrice | long | 否 | 加速包价格(单位:分) |
qOrderStatusCode | Integer | 否 | 抢票状态码 |
qOrderStatusName | String | 否 | 抢票状态名称 |
qEndTime | Long | 否 | 抢票结束时间,13位时间戳 |
TicketInfo票信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
passengerName | String | 否 | 乘车人姓名 |
passengerIdCardNo | String | 否 | 乘车人证件编号 |
passengerIdCardTypeName | String | 否 | 乘车人证件类型,目前只有身份证 |
staffId | Long | 否 | 出行人的员工ID |
staffType | Integer | 否 | 出行人类型( 1 内部员工 2 外部人员 ) |
staffUniqueIdentifier | String | 否 | 出行人的员工唯一识别码(企业设置的员工唯一标识,可能为邮箱、工号或手机号) |
currentTicket | TicketDetail | 是 | 最新的车票信息 |
oldTicket | TicketDetail | 否 | 改签前的车票信息 |
printStatus | Integer | 否 | 代打印结果 |
printStatusDesc | String | 是 | 待打印状态(仅限金螳螂使用) |
TicketDetail票详细信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
ticketId | Long | 是 | 车票号 |
trainCode | String | 是 | 车次编号 |
fromStationCode | String | 是 | 发车站三字码 |
fromStationName | String | 是 | 发车站名称 |
toStationCode | String | 是 | 目的站三字码 |
toStationName | String | 是 | 目的站名称 |
startTime | Long | 是 | 发车时间,13位时间戳 |
arriveTime | Long | 是 | 到站时间,13位时间戳 |
runTime | Integer | 否 | 运行时长(单位:分钟) |
statusCode | Integer | 是 | 票状态码 |
statusName | String | 是 | 票状态名称 |
ticketStatus | String | 是 | 新版票状态码 |
ticketStatusName | String | 是 | 新版票状态名称 |
ticketTypeCode | Integer | 是 | 火车票类型 |
ticketTypeName | String | 是 | 火车票类型名称 |
coachNo | String | 否 | 车厢号 |
seatNo | String | 否 | 座位号 |
seatTypeCode | Integer | 否 | 座位类型 |
seatTypeName | String | 否 | 座位类型名称 |
ticketPrice | long | 否 | 实际票价格(单位:分) |
fromLocationCode | String | 否 | 发车行政区编码(国标) |
toLocationCode | String | 否 | 到达行政区编码(国标) |
ChangeInfo改签信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
changeServiceId | String | 是 | 改签服务单ID |
changeType | Integer | 是 | 改签类型 |
changeStatusCode | Integer | 是 | 火车票状态 |
trainNo | String | 是 | 火车code码 |
startTime | Long | 是 | 发车时间 |
arriveTime | Long | 是 | 到达时间 |
fromStationCode | String | 是 | 发车站三字码 |
fromStationName | String | 是 | 发车站名称 |
toStationCode | String | 是 | 目的站三字码 |
toStationName | String | 是 | 目的站名称 |
runTime | Integer | 是 | 运行时长,单位分钟 |
gmtCreateTime | Long | 是 | 改签时间,13位时间戳 |
loseTime | Long | 是 | 截止订单支付时间,13位时间戳 |
paySuccessTime | Long | 是 | 支付成功时间,13位时间戳 |
bookingPrice | String | 是 | 改签后票价,单位元 |
totalPrice | String | 是 | 改签总金额,单位元 |
payPrice | String | 是 | 实际支付金额,单位元 |
oldPrice | String | 是 | 预订价格,单位元 |
estimateRefundFee | String | 是 | 预计退票手续费,单位元 |
estimateChangeFee | String | 是 | 预计改签费用,单位元 |
changeReasonList | List<TrainOrderReason> | 是 | 改签原因列表 |
ticketList | List<TrainChangeTicket> | 是 | 改签票列表 |
bookSuccessTime | Long | 是 | 预订成功时间,13位时间戳 |
tripId | Long | 是 | 行程ID |
itineraryId | Long | 是 | 行程单ID |
failReason | String | 是 | 失败原因 |
TrainOrderReason操作原因信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
reasonId | Integer | 是 | 原因ID |
reason | String | 是 | 原因 |
reasonRemark | String | 否 | 原因备注 |
TrainChangeTicket改签服务单票信息
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
passengerName | String | 是 | 乘车人姓名 |
passengerIdCardTypeName | String | 是 | 乘车人证件类型 |
passengerIdCardNo | String | 是 | 乘车人证件编号 |
ticketId | Long | 是 | 改签后票号ID |
oldTicketId | Long | 是 | 改签前原票ID |
bookingTicketPrice | String | 是 | 预定时票价格,单位元 |
ticketPrice | String | 是 | 实际票价格,单位元 |
# MaicaiOrderInfo
MaicaiOrderInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
orderStatus | Integer | 是 | 10 | 参见买菜订单状态 |
originalPrice | Integer | 是 | 2000 | 订单原价:分 |
totalAmount | Integer | 是 | 2000 | 订单总金额:分(需要支付的总金额:商品总价-活动价-优惠券+配送费) |
packingBoxPrice | Integer | 是 | 200 | 餐盒金额:分 |
frozenPackagePrice | Integer | 是 | 150 | 冻品包材金额:分 |
packingBagPrice | Integer | 是 | 120 | 打包袋金额:分 |
recipientPhone | String | 是 | 13000000000 | 收货人手机 |
recipientName | String | 是 | 张三 | 收货人姓名 |
recipientAddress | String | 是 | 启明国际大厦-A座 (启明大厦8楼) | 收货人地址 |
deliveryPrice | Integer | 是 | 150 | 配送费:分 |
addressLongitude | Integer | 是 | 116491116 | 配送地址经度 (国标,扩大10的6次方) |
addressLatitude | Integer | 是 | 40002102 | 配送地址纬度 (国标,扩大10的6次方) |
maicaiItemList | List<MaicaiItem> | 否 | [{}] | 菜品明细 |
cookingServiceList | List<CookingService> | 否 | [{}] | 订单烹饪服务列表 |
tradingItemList | List<TradingItem> | 否 | [{}] | 会员卡明细 |
orderPromotionList | List<PromotionItem> | 否 | [{}] | 订单涉及的促销 |
groupBuyInfo | GroupBuyInfo | 否 | [{}] | 拼团信息(优惠) |
couponInfo | List<CouponInfo> | 否 | [{}] | 订单优惠券信息 |
refundInfo | List<RefundInfo> | 否 | [{}] | 退款信息 |
remark | String | 否 | 到货放在门口 | 订单备注 |
MaicaiItem字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
skuId | Long | 否 | 123456 | 商品SKU编码 |
price | Integer | 是 | 2700 | 单商品原价总和,单位:分 price=originalPrice * quantity |
originalPrice | Integer | 是 | 1350 | 单商品原价,单价:分 |
quantity | Integer | 是 | 2 | 购买数量,当商品类型为标品时和展示数量相同,当商品类型为散装时 =展示数量unit1000 转成毫克 |
productType | Integer | 是 | 1 | 商品类型,1:标品,2:散装 |
packingBoxPrice | Integer | 是 | 300 | 餐盒费金额:分 |
frozenPackagePrice | Integer | 是 | 220 | 冻品包材费用 |
skuName | String | 是 | 甘竹牌豆豉鲮鱼罐头227g | 商品名称 |
unit | String | 是 | 盒 | 商品单位 |
picUrl | String | 否 | 商品图片 | |
spuId | Long | 否 | 商品SPU编码 |
CookingService字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
skuId | Long | 否 | 123456 | 商品SKU编码 |
skuName | String | 是 | 虾 | 烹饪商品名称 |
cookingServiceName | String | 是 | 炒 | 烹饪服务名称 |
quantity | Long | 是 | 2 | 数量 |
unit | String | 是 | 盒 | 商品单位 |
cookingQuantity | Long | 是 | 2 | 加工数量 |
originalPrice | Integer | 是 | 500 | 原价:分 |
totalPrice | Integer | 是 | 500 | 总金额:分 |
TradingItem字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
tradingPrice | Integer | 是 | 2000 | 总价:分 |
tradingOriginalPrice | Integer | 是 | 1000 | 单个item的价格:分 |
tradingReducePrice | Integer | 是 | 0 | 减免价格:分 |
tradingQuantity | String | 是 | 2 | 数量 |
tradingName | String | 是 | XXX卡 | 会员卡名称 |
tradingPicUrl | String | 是 | 会员卡图片 | |
tradingViewPrice | Long | 是 | 2000 | 展示价格 |
PromotionItem字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
mainSkuIdList | List | 否 | [123456] | 订单维度促销的主品skuId |
promotionName | String | 是 | 华北果蔬1.8-1.13 | 促销名称 |
discount | Integer | 是 | 200 | 促销减免金额:分 |
promotionQuantity | Integer | 是 | 1 | 参与促销数量 |
giftQuantity | Integer | 是 | 10 | 赠品数量 |
suitCount | Integer | 是 | 10 | 套装数量 |
GroupBuyInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
discount | Integer | 是 | 优惠金额:分 | |
groupBuyInfoQuantity | Integer | 是 | 拼团商品数量 |
CouponInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
code | String | 是 | 优惠券code | |
price | Long | 是 | 优惠券价格:分 | |
reduceType | Integer | 是 | 优惠券类型 |
RefundInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
refundPrice | Integer | 否 | 100 | 退款总金额,单位:分 |
createTime | String | 是 | 2022-12-27 15:22:44 | 发起退款的时间 |
factRefundDeliveryPrice | Integer | 是 | 220 | 实际退的配送费:分 |
refundItem | List<RefundItem> | 是 | [{}] | 退款商品明细 |
RefundItem字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
skuId | Long | 是 | 123456 | 退款商品skuId |
skuName | String | 是 | 白菜 | 退款商品名称 |
refundQuantity | Integer | 是 | 1 | 退款数量,当商品类型为标品时和展示数量相同,当商品类型为散装时=展示数量unit1000转成毫克 |
refundPrice | Integer | 是 | 100 | 退款商品的实际退款金额,单位:分 |
originalPrice | Integer | 是 | 300 | 退款商品原价,单位:分 |
# PaotuiOrderInfo
PaotuiOrderInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
paotuiBizType | Integer | 是 | 1 | 1 帮送(包含帮我取和帮我送) 2 帮买 |
senderName | String | 是 | 张三 | 发件人姓名 |
senderPhone | String | 是 | 13000000000 | 发件人电话 |
senderAddress | String | 是 | 启明国际大厦-A座 | 帮送-发件人地址 帮买-购买地址 |
senderHouseNumber | String | 否 | 150 | 帮送-发货地址-门牌号;帮买-购买地址-门牌号 |
recipientName | String | 是 | 张三 | 收货人姓名 |
recipientPhone | String | 是 | 13000000000 | 收货人手机 |
recipientAddress | String | 是 | 启明国际大厦-A座 (启明大厦8楼) | 收货地址 |
recipientHouseNumber | String | 否 | 收货人门牌号 | |
orderStatus | Integer | 是 | 150 | 订单状态,参见跑腿状态映射说明 |
logisticsStatus | Integer | 是 | 150 | 配送状态,参见跑腿状态映射说明 |
orderTime | Long | 是 | 116491116 | 下单时间,13位时间戳 |
goodsTypeNames | List<String > | 是 | 物品类型名称 | |
goodsTypeSize | List<String > | 是 | 物品大小 | |
goodsWeight | Double | 是 | 重量 单位kg | |
goodsValueMin | Integer | 是 | 物品价值下限 | |
goodsValueMax | Integer | 是 | 物品价值上限 0为无穷大 | |
deliveryDistance | Integer | 否 | 配送距离 单位km | |
courierName | Integer | 是 | 配送员姓名 | |
courierPhone | Integer | 是 | 配送员电话 | |
pickUpTime | Long | 是 | 取件时间(立即取件为空) | |
userSpecifiedTime | Long | 否 | 用户选定取件时间 | |
estimateArrivalTime | String | 否 | 预计送达时间 | |
estimatePickupDuration | Integer | 是 | 预计取件时间 | |
canceledTime | Long | 是 | 订单取消时间 | |
finishedTime | Long | 否 | 订单完成时间 | |
insuranceInfo | PaotuiOrderInsuranceInfoDto | 否 | {} | 保险信息 |
modifyDeliveryInfo | PaotuiModifyDeliveryInfDto | 否 | {} | 付费修改地址信息,需关注modifyStatus,成功表明地址修改成功 |
PaotuiOrderInsuranceInfoDto字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
payCost | String | 否 | 20.00 | 保险实际支付金额:元 |
insuranceClaimStatusDesc | String | 否 | 已投保 | 保险理赔状态文案 |
PaotuiModifyDeliveryInfDto字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
recipientAddress | String | 否 | XXX | 收货地址 |
recipientHouseNumber | String | 否 | XXX栋 | 收货地址门牌号 |
deliveryDistance | Integer | 否 | 配送距离 单位km | |
pickUpTime | Long | 否 | 取件时间(立即取件为空) | |
userSpecifiedTime | Long | 否 | 用户选定取件时间 | |
estimateArrivalTime | Long | 否 | 预计送达时间 | |
goodsTypeNames | List<String > | 否 | 物品类型名称 | |
goodsWeight | Double | 否 | 重量 单位kg | |
modifyFee | String | 否 | 修改费,单位元 | |
diliveryChangeDiffFee | String | 否 | 配送信息变更差价,单位元 | |
modifyStatus | Integer | 否 | 修改状态,1修改中 2成功 3失败 |
# PeicanOrderInfo
PeicanOrderInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
cutOrderTime | Long | 否 | 截单时间缀(单位:ms) | |
deliveryBTime | Long | 否 | 收餐时间缀(单位:ms) | |
takeFoodCode | String | 否 | 150 | 取餐码 |
orderDetail | WMOrderInfo | 是 | {} | 订单详细信息 |
# MedicineOrderInfo
MedicineOrderInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
orderStatus | Integer | 是 | 1 | 参见买药订单状态 |
logisticsStatus | Integer | 是 | 1 | 参见买药配送状态 |
originalPrice | String | 是 | 32.2 | 订单原价:元 |
productPrice | String | 是 | 26.5 | 商品原价:元 |
shippingFee | String | 是 | 5.5 | 配送费原价:元 |
boxTotalPrice | String | 是 | 0.2 | 打包费原价:元 |
actualPayTotal | String | 是 | 32.2 | 订单应付总金额:元 |
realProductPrice | String | 是 | 26.5 | 商品价格:元,取值逻辑:actualPayTotal-realShippingFee-realboxPrice-appendProductTotalPrice |
realShippingFee | String | 是 | 5.5 | 配送费:元 |
realBoxPrice | String | 是 | 0.2 | 打包费:元 |
appendProductTotalPrice | String | 是 | 0 | 搭售商品总金额:元 |
recipientAddress | String | 是 | 望京国际研发园 | 收货人地址 |
remark | String | 否 | 放门口 | 订单备注 |
brandId | Long | 否 | 12345 | 品牌Id |
brandName | String | 否 | 正方药房 | 品牌名称 |
recipientName | String | 是 | 张三 | 收货人姓名 |
recipientPhone | String | 是 | 18511071111 | 收货人电话 |
addressLongitude | Integer | 是 | 116491116 | 配送地址经度 (国标,扩大了10的6次方) |
addressLatitude | Integer | 是 | 40002102 | 配送地址纬度 (国标,扩了了10的6次方) |
estimateArrivalTime | Long | 是 | 1509525086 | 预计到达时间(精度是秒) |
deliverTime | Long | 否 | 1509522086 | 实际已送达时间 (精度是秒) |
bookingOrder | boolean | 是 | true | 是否预约订单:true为预订单;false为非预订单 |
itemList | List<OrderItem> | 是 | [{}] | 药品明细 |
appendProductDetailList | List<AppendProductDetailList> | 是 | [{}] | 搭售商品明细 |
poiCateCode | Long | 是 | 22 | 商家一级品类code |
poiCateDesc | String | 是 | 医药健康 | 商家一级品类名称 |
poi2ndCateCode | Long | 是 | 2300 | 商家二级品类code |
poi2ndCateDesc | String | 是 | 综合药店 | 商家二级品类名称 |
poi3rdCateCode | Long | 否 | 商家三级品类code | |
poi3rdCateDesc | String | 否 | 商家三级品类名称 | |
pickType | int | 是 | 0 | 配送类型 0-普通订单 1-到店自取订单 2-独立到店自取订单 |
orderMode | Integer | 是 | 0 | 订单模式 1-O2O 2-B2C |
logisticsInfoList | List<LogisticsInfo> | 是 | [{}] | 快递信息 |
OrderItem字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
boxNum | int | 是 | 1 | 打包盒数量 |
boxPrice | String | 是 | 0.1 | 打包盒价格:元 |
count | int | 是 | 2 | 数量 |
name | String | 是 | 感冒灵 | 药品名称 |
originPrice | String | 是 | 13.5 | 原始金额:元 |
price | String | 是 | 13.5 | 药品金额:元 |
LogisticsInfo字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
logisticsNo | String | 是 | SH1234567X | 物流单号 |
status | Integer | 是 | 2 | 参见买药物流状态 |
deliveryName | String | 是 | 顺丰快递 | 物流商名称 |
spPkgTrackList | List<SpPkgTrack> | 是 | [{}] | 快递轨迹 |
SpPkgTrack字段说明
名称 | 类型 | 是否非空 | 示例 | 说明 |
---|---|---|---|---|
time | String | 是 | 2021-05-11 11:12:12 | 时间 |
context | String | 是 | 【西安市】 快件已经到达 【西安中转】 | 物流信息 |
# 5.业务状态码
# 5.1 酒店订单相关状态码映射
# 5.1.1 订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
5010 | 创建订单 |
5020 | 删除订单 |
5030 | 隐藏订单 |
5040 | 支付中 |
5050 | 支付成功 |
5060 | 支付失败 |
5070 | 超时未支付 |
5080 | 支付超时 |
5090 | 预定中 |
5100 | 预订成功 |
5110 | 预订失败 |
5115 | 预订异常 |
5120 | 商家首次拒绝 |
5125 | 取消中 |
5130 | 取消成功 |
5135 | 取消失败 |
5137 | 取消超时 |
5140 | 客服强退 |
5150 | 已入住 |
5200 | 已离店 |
# 5.1.2 间夜支付状态
payStatus | 支付状态枚举 |
---|---|
2010 | 未支付 |
2015 | 已支付等结果 |
2020 | 超时未支付 |
2030 | 支付超时 |
2040 | 支付成功 |
2050 | 退款 |
2060 | 申请退款中 |
# 5.2 机票订单相关状态码映射
# 5.2.1 订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
101 | 订座成功等待支付 |
102 | 订座成功等待价格确认 |
200 | 订单取消 |
300 | 支付成功等待出票 |
400 | 出票中 |
401 | 出票完成 |
500 | 改签申请 |
501 | 改签完成 |
600 | 退票申请 |
601 | 未出票申请退款 |
602 | 退票完成等待退款 |
603 | 退款完成 |
# 5.2.2 客票状态枚举值
ticketStatus | 客票状态枚举说明 |
---|---|
USED/FLOWN | 已使用 |
REFUNDED | 已退票 |
EXCHANGED | 已改期 |
OPEN FOR USE | 待使用 |
LIFT/BOARDED | 已起飞 |
CHECKED IN | 已值机 |
AIRPORT CONTROL | 航空管制 |
VOID | 已退票 |
# 5.2.3 保险状态枚举值
insStatus | 保险状态枚举说明 |
---|---|
1 | 待支付 |
2 | 未出保 |
3 | 已出保 |
4 | 已退保 |
6 | 已取消 |
7 | 出保中 |
9 | 退保中 |
# 5.3 火车票订单相关状态码映射
# 5.3.1 订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
100 | 待支付 |
110 | 已取消 |
120 | 支付超时 |
130 | 预定失败 |
150 | 出票中 |
200 | 出票成功 |
201 | 改签中 |
202 | 改签待支付 |
203 | 改签出票中 |
204 | 改签取消 |
205 | 改签失败 |
206 | 已改签 |
210 | 退票中 |
220 | 部分退票 |
230 | 已退票 |
240 | 退票失败 |
260 | 退款中 |
270 | 部分退款 |
280 | 已退款 |
290 | 退款失败 |
300 | 已发车 |
# 5.3.2 抢票订单状态枚举
qorderStatus | 抢票订单状态枚举值说明 |
---|---|
30 | 待支付 |
40 | 支付超时 |
50 | 提交中 |
60 | 提交失败 |
100 | 抢票中 |
120 | 已暂停 |
130 | 已占座 |
150 | 待启动 |
160 | 已过期 |
169 | 取消中 |
170 | 已取消 |
300 | 已删除 |
400 | 已失败 |
500 | 未知 |
# 5.3.3 座位类型枚举
seatType | 座位类型枚举值说明 |
---|---|
1 | 硬座 |
2 | 硬卧上 |
3 | 硬卧中 |
4 | 硬卧下 |
5 | 软座 |
6 | 软卧上 |
7 | 软卧中 |
8 | 软卧下 |
9 | 商务座 |
10 | 观光座 |
11 | 一等包座 |
12 | 特等座 |
13 | 一等座 |
14 | 二等座 |
15 | 高级软卧上 |
16 | 高级软卧下 |
17 | 无座 |
18 | 一人软包 |
19 | 二人软包 |
20 | 动卧 |
21 | 高级动卧 |
22 | 包厢硬卧 |
23 | 硬卧 |
24 | 软卧 |
25 | 一等软座 |
26 | 二等软座 |
27 | 特等软座 |
28 | 包厢硬卧上 |
29 | 包厢硬卧中 |
30 | 包厢硬卧下 |
31 | 包厢软座 |
32 | 一等卧 |
33 | 二等卧 |
34 | 混编硬座 |
35 | 混编软座 |
36 | 一等卧上 |
37 | 一等卧中 |
38 | 一等卧下 |
39 | 二等卧上 |
40 | 二等卧中 |
41 | 二等卧下 |
43 | 动卧上 |
44 | 动卧下 |
45 | 高级动卧上 |
46 | 高级动卧下 |
47 | 硬卧代硬座 |
48 | 软卧代二等座 |
110 | 混编硬卧 |
111 | 混编软卧 |
99 | 未知 |
# 5.3.4 代打印结果枚举值
printStatus | 代打印结果枚举值说明 |
---|---|
null | 不支持代打印 |
1000 | 待推送 |
1010 | 推送取消 |
1020 | 推送失败 |
1030 | 待处理 |
2000 | 取票成功 |
2001 | 取票成功-已改签 |
2002 | 取票成功-已退票 |
2010 | 未查到车票信息 |
2020 | 已被取出 |
2030 | 已被退票 |
2040 | 已被改签 |
2050 | 客服要求取消 |
2060 | 信息不符-姓名 |
2070 | 信息不符-证件 |
2080 | 信息不符-日期 |
2090 | 信息不符-车次 |
2100 | 信息不符-发/到站 |
2110 | 已过取票时间 |
2120 | 车次停运 |
2999 | 其他 |
# 5.3.5 票状态枚举值
ticketStatus | 票状态枚举值说明 |
---|---|
60 | 占座中 |
90 | 占座失败 |
100 | 支付中 |
110 | 已取消 |
120 | 支付超时 |
130 | 出票失败 |
150/180 | 出票中 |
200 | 出票成功 |
300 | 已发车 |
201 | 改签中 |
202 | 改签待支付 |
203 | 改签出票中 |
204 | 改签取消 |
205 | 改签失败 |
206 | 改签成功 |
300 | 已发车 |
210 | 退票中 |
230 | 已退票 |
240 | 退票失败 |
# 5.4 打车订单相关状态码映射
# 5.4.1 订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
0 | 初始 |
1 | 提交订单 |
2 | 已推单 |
3 | 司机已接单 |
4 | 司机已到达 |
5 | 行驶中 |
6 | 已到达 |
7 | 待支付 |
8 | 已完成 |
20 | 乘客撤单 |
21 | 司机撤单 |
22 | 调度超时撤单 |
23 | 客服撤单 |
30 | 调度失败 |
31 | 计费失败 |
# 5.4.2 订单事件状态枚举值
打车订单事件 | 事件描述 | 事件码 |
---|---|---|
ORDER_CREATED | 已下单 | 10 |
ORDER_PUSHED | 已推单 | 11 |
ORDER_CONFIRMED | 已接单 | 20 |
ORDER_REASSIGNED | 改派 | 30 |
ORDER_SERVICE_STARTED | 司机已开始服务 | 40 |
DEPARTURE_CHANGED | 订单已更改接驾点 | 41 |
DRIVER_ARRIVED | 司机已达到上车点 | 50 |
TRIP_STARTED | 已开始行程 | 60 |
DESTINATION_CHANGED | 订单已更改目的地 | 61 |
TRIP_DELIVERED | 乘客已被送达目的地 | 70 |
BILL_GENERATED | 已生成账单 | 80 |
BILL_CHANGED | 订单已改价 | 81 |
ORDER_PAID | 订单已支付完成 | 90 |
ORDER_CANCELED | 订单已被取消无取消费 | 100 |
ORDER_CANCELED_WITH_PAY | 订单已被取消且有取消费,需要用户支付 | 110 |
ORDER_SUSPENDED | 订单挂起 | 111 |
ORDER_UN_SUSPENDED | 订单解除挂起 | 112 |
CAR_TYPE_APPENDED | 已追加车型 | 113 |
# 5.5 外卖订单相关状态码映射
# 5.5.1 订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
1 | 提交订单 |
2 | 向餐厅推单 |
4 | 已接单 |
8 | 已完成 |
9 | 取消 |
# 5.5.2 配送状态枚举值
logisticsStatus | 配送状态枚举说明 |
---|---|
0 | 默认值 |
1 | 已推送给配送方 |
10 | 已抢单 |
15 | 骑手已到店 |
20 | 已取餐 |
40 | 已送达 |
100 | 已取消 |
# 5.6 团购订单相关状态码映射
# 5.6.1 团购订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
-99999 | 已取消 |
# 5.6.2 团购核销状态枚举值
groupConsumeStatus | 团购核销状态枚举说明 |
---|---|
0 | 未核销 |
10 | 已核销 |
20 | 部分核销 |
# 5.7 买菜订单状态码映射
# 5.7.1 买菜订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
0 | 提交订单 |
10 | 付款中 |
20 | 付款失败 |
30 | 支付成功 |
40 | 已推送至配送中心 |
50 | 已送达 |
60 | 已完成 |
70 | 用户取消 |
80 | 客服取消 |
90 | 系统自动取消 |
# 5.8 跑腿订单状态码映射
# 5.8.1 跑腿订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
1 | 创建订单 |
10 | 订单已支付 |
20 | 订单取消(未支付取消或全额退款) |
30 | 商家已确认 |
40 | 商家已履约 |
90 | 订单完成 |
# 5.8.2 跑腿配送状态枚举值
logisticsStatus | 配送状态枚举说明 |
---|---|
0 | 下单时默认的初始态 |
1 | 待接单 |
10 | 已接单 |
15 | 已到店 |
20 | 已取货 |
40 | 已送达 |
100 | 配送取消 |
# 5.9 买单订单相关状态码映射
# 5.9.1 买单订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
-99999 | 已取消 |
# 5.10 配餐&现场就餐订单状态码映射
# 5.10.1 配餐&现场就餐订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
1 | 提单 |
2 | 已支付 |
3 | 已推单 |
4 | 已截单 |
5 | 已接单 |
6 | 已存餐 |
7 | 已取餐 |
8 | 已完成 |
9 | 已取消 |
20 | 申请退款 |
21 | 确认退款 |
22 | 退款成功 |
# 5.11 安心付订单相关状态码映射
# 5.11.1 安心付订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
-99999 | 已取消 |
# 5.12 买药订单相关状态码映射
# 5.12.1 订单状态枚举值
orderStatus | 订单状态枚举说明 |
---|---|
1 | 提交订单 |
2 | 向餐厅推单 |
4 | 已接单 |
8 | 已完成 |
9 | 取消 |
# 5.12.2 配送状态枚举值
logisticsStatus | 配送状态枚举说明 |
---|---|
0 | 默认值 |
1 | 已推送给配送方 |
10 | 已抢单 |
15 | 骑手已到店 |
20 | 已取餐 |
40 | 已送达 |
100 | 已取消 |
# 5.12.3 物流状态枚举值
status | 物流状态枚举说明 |
---|---|
0 | 商家已发货 |
1 | 商家发货 |
10 | 揽件 |
20 | 在途 |
30 | 派件 |
40 | 签收 |
50 | 疑难 |
60 | 收件人拒签 |
70 | 退回 |
80 | 退签 |
100 | 待清关 |
110 | 清关中 |
120 | 清关异常 |
130 | 已清关 |
140 | 转投 |
150 | 待取件 |
# 6.FAQ
1.订单模块对接推荐方式有哪些? R:订单模块推荐两种对接方式,方案一:企业对接订单变更推送模块后,接到推送消息需要关注的消息变更,反查订单详情接口更新企业本地订单信息。该方案适用于企业需要较实时感知订单状态变更; 方案二:企业根据订单变更时间范围根据订单列表查询接口批量拉取订单列表,再查订单详情接口更新企业本地订单信息。该方案适用于企业不需要实时关注订单状态变更。
# 7.示例结果
{
"status": 0,
"msg": "成功",
"data": {
"orderBaseInfo": {
"sqtBizOrderId": 306092209006387202,
"sqtType": 5,
"sqtTypeName": "打车",
"origOrderId": "117422220368474118618069100000",
"cityName": "上海",
"createdTime": "2019-09-18 15:22:44",
"sceneTypeName": "商务差旅",
"shopName": "麦当劳店",
"shopPhone": "010-12345678",
"shopAddress": "北京中关村",
"bizOrPersonal": 1,
"orderAmount": "35.40",
"costCenterList": [
{
"costSource":1,
"costNo":"414414",
"costName":"制造本部-河北工厂",
"tradeType":2,
"amount":"32.50",
"ratio":"0.30",
"customField1":"扩展字段1",
"customField2":"扩展字段2",
"customField3":"扩展字段3",
"customField4":"扩展字段4",
"customField5":"扩展字段5"
},{
"centerType":1,
"centerCode":"414413",
"centerName":"制造本部-河北工厂1",
"tradeType":2,
"amount":"82.50",
"ratio":"0.70",
"customField1":"扩展字段1",
"customField2":"扩展字段2",
"customField3":"扩展字段3",
"customField4":"扩展字段4",
"customField5":"扩展字段5"
}
]
},
//外卖详情
"wmOrder": {
"orderStatus": 4,
"boxTotalPrice": "0.0",
"originalPrice": "40.49",
"recipientAddress": "启明国际大厦-A座 (启明大厦8楼)",
"remark": "美团工作餐订单无需开票 (请勿删除)",
"shippingFee": 4,
"total": "33.59",
"foodList": [
{
"boxNum": 1,
"boxPrice": "0.0",
"count": 1,
"name": "荷兰黄瓜约400g",
"originPrice": "6.8",
"price": "6.8"
},
{
"boxNum": 1,
"boxPrice": "0.0",
"count": 1,
"name": "绿叶生菜500g",
"originPrice": "8.8",
"price": "8.8"
},
{
"boxNum": 1,
"boxPrice": "0.0",
"count": 1,
"name": "海南小台农芒果400g",
"originPrice": "8.99",
"price": "8.99"
},
{
"boxNum": 1,
"boxPrice": "0.0",
"count": 1,
"name": "千禧小番茄500g",
"originPrice": "11.8",
"price": "8.9"
}
],
"estimateArrivalTime": 1618911632,
"deliverTime": null,
"recipientName": "大博(女士)",
"recipientPhone": "xxxxxx",
"addressLongitude": 116474932,
"addressLatitude": 40012052
},
//团购详情
"groupOrder":{
"groupUseType": "套餐",
"groupBusinessType": "到餐团购",
"groupPayment": "120",
"groupConsumeStatus": 0,
"grouponCodeList": [
{
"encryptCode": "aWHtScIHEXEDvymMpHCy9w",
"consumeTime": 1538989711002,
"shopName": "百岁我家·酸菜鱼专门店(古美店)",
"shopServicePhone": "888888",
"shopAddress": "高银街29号",
"province": "浙江省",
"city": "杭州市",
"location": "西湖区"
}
]
},
//线下订单(特需报备)详情
"offlineOrder":{
"diningTime": "2019-11-29",
"peopleNum": "2",
"amount": "2.0",
"avgFee": "1.0",
"reason": "商家不接受企业支付",
"reasonGroup": "商家原因-餐厅不允许使用企业支付"
},
//打车详情
"carOrder": {
"carOrderBase": {
"orderStatus": 8,
"payStatus": 3,
"useType": 4,
"useTypeName": "差旅用车",
"tripSceneType": 7,
"tripSceneTypeName": "出差城市用车",
"partnerCarTypeName": "曹操出行",
"orgCityName": "常德市",
"arrCityName": "常德市",
"reserveType": 1,
"reserveTime": 0,
"startAddress": "柳叶湖汽车站-南门",
"startLongitude": "111.716053",
"startLatitude": "29.059174",
"endAddress": "丽枫酒店(常德步行街店)",
"endLongitude": "111.691752",
"endLatitude": "29.032043",
"deliveryStartLongitude": "111.716064",
"deliveryStartLatitude": "29.058954",
"deliveryStartAddress": "",
"deliveryEndLongitude": "111.6917",
"deliveryEndLatitude": "29.032572",
"deliveryEndAddress": null,
"driverName": "项师傅",
"driverCarNumber": "湘JU7167",
"driverCarModel": "xxxxxxx",
"driverCarColor": "白色",
"cancelReason": null,
"cancelLiabCode": null,
"payType": "biztpay",
"orderCreatedTime": 1618908310754,
"orderConfirmedTime": 1618908312250,
"tripStartedTime": 1618908470474,
"tripDeliveredTime": 1618909399304
},
"orderBill": {
"cancelPrice": {
"cancelPay": 0,
"cancelFee": 0
},
"userPrice": {
"driveDistance": 5050,
"driveDistancePrice": 550,
"driveLongDistance": 0,
"driveLongDistancePrice": 0,
"driveMinPrice": 0,
"driveNight": 0,
"driveNightPrice": 0,
"driveStartPrice": 600,
"driveTime": 900000,
"driveTimePrice": 360,
"dynamicMaxPrice": 0,
"dynamicPrice": -120,
"fixedPrice": 0,
"multiple": 0,
"normalDistance": 0,
"normalDistancePrice": 550,
"normalTime": 0,
"normalTimePrice": 360,
"startPriceDistance": 0,
"startPriceTime": 0,
"totalPrice": 1390,
"servicePriceAmount": 0,
"taxiMeterFee": 0,
"discountPrice": 0
},
"beforeTripPrice": {
"platformDispatchPrice": 0,
"dispatchPrice": 0,
"longDispatchPrice": 0,
"waitFee": 0,
"waitTime": 0,
"thanksFee": 0
},
"afterTripPrice": {
"driveTollPrice": 0,
"driveParkPrice": 0,
"driveOtherPrice": 0,
"driveHighwayPrice": 0,
"edispatchFee": 0
}
}
},
//酒店订单
"hotelOrder": {
"hotelOrderBase": {
"orderStatus": 5100,
"orderAmount": 67800,
"invoiceType": 1,
"isExceeded": false,
"isBusinessFirst": false,
"isAgreement": true,
"isReceptionInvoice": false,
"createTime": 1618909361000,
"modifyTime": 1618909401000
},
"guests": [
{
"type": 0,
"name": "贺磊",
"phone": null
},
{
"type": 1,
"name": "贺磊",
"phone": "xxxxxxxx"
}
],
"aptInfo": {
"checkinTime": 1618848000000,
"checkoutTime": 1619020800000,
"actualCheckoutTime": null,
"hotelType": "[2]",
"hotelStar": "3",
"breakfast": null,
"cityLocationName": "南京",
"cityLocationCode": "340100",
"provinceLocationName": "江苏",
"provinceLocationCode": "340000",
"poiId": 191141130,
"poiName": "西安钟楼美居酒店",
"poiAddress": "西新街8号(近回民街、距2号线钟楼地铁站D出口500米)",
"goodsId": 686453831,
"roomName": "折上9折标准房-双床(无窗)"
},
"roomNights": [
{
"bizDay": 1618848000000,
"soldPrice": 33700,
"payStatus": 2040
},
{
"bizDay": 1618934400000,
"soldPrice": 34100,
"payStatus": 2040
}
]
},
//机票订单
"flightOrder": {
"flightOrderBase": {
"orderStatus": 401,
"orderAmount": 111100,
"rescheduleAmount": 0,
"contactPhone": "xxxx",
"gmtCreated": 1618906577000
},
"passengers": [
{
"type": 0,
"name": "姚珠",
"idCardType": 0,
"idCard": "xxxxx",
"orderDisCount": 66
}
],
"tickets": [
{
"ticketNumber": "781-xxxx",
"ticketStatus": null,
"fuelTax": 0,
"ticketPrice": 106000,
"constructionFee": 5000
}
],
"insuranceList": [
{
"insType": 10,
"insNumber": "",
"insOrderId": "xxxx",
"insCompany": "德华安顾人寿保险有限公司",
"insStatus": 7,
"insAmount": 1
}
],
"segments": [
{
"flightNumber": "MU8859",
"carrieCode": "MU",
"carrieName": "东方航空",
"departureCityName": "北京",
"arrivalCityCode": "340300",
"departureCode": "PKX",
"departureName": "大兴机场",
"departureTerminal": "",
"departureTime": 1619161500000,
"arrivalCityName": "上海",
"arrivalCityCode": "340200",
"arrivalCode": "SHA",
"arrivalName": "虹桥机场",
"arrivalTerminal": "T2",
"arrivalTime": 1619169300000,
"adultCabin": "N",
"adultCabinLevel": "Y",
"mileage": 1178
}
],
"lowInfo": {
"lowestFlightNumber": "KN5955",
"lowestDiscount": 60,
"lowestPrice": 98000
}
},
//火车票订单
"trainOrder": {
"trainOrderBase": {
"orderId12306": "E809720246",
"fromStationCode": "AOH",
"fromStationName": "上海虹桥站",
"fromLocationName": "上海市",
"fromLocationCode": "110100",
"toStationCode": "NKH",
"toStationName": "南京南站",
"toLocationName": "北京市",
"toLocationCode": "110000",
"contactPhone": "xxxx",
"payTime": 1611206175000,
"orderAmount": 20500,
"orderStatus": 210,
"orderStatusName": "退票中",
"createTime": 1611206114000
},
"grabInfo": null,
"ticketInfoList": [
{
"currentTicket": {
"trainCode": "G2662",
"fromStationCode": "AOH",
"fromStationName": "上海虹桥站",
"toStationCode": "NKH",
"toStationName": "南京南站",
"startTime": 1611287100000,
"arriveTime": 1611293580000,
"runTime": 108,
"statusCode": 210,
"statusName": "退票中",
"ticketTypeCode": 1,
"ticketTypeName": "成人票",
"coachNo": "1车厢",
"seatNo": "1号",
"seatTypeCode": 13,
"seatTypeName": "一等座",
"ticketPrice": 20500,
"printStatus": 1030
},
"oldTicket": {
"trainCode": "G106",
"fromStationCode": "AOH",
"fromStationName": "上海虹桥站",
"toStationCode": "NKH",
"toStationName": "南京南站",
"startTime": 1611270720000,
"arriveTime": 1611275640000,
"runTime": 82,
"statusCode": 210,
"statusName": "退票中",
"ticketTypeCode": 1,
"ticketTypeName": "成人票",
"coachNo": "1车",
"seatNo": "1号",
"seatTypeCode": 14,
"seatTypeName": "二等座",
"ticketPrice": 12900,
"printStatus": 2040
},
"passengerName": "唐晶晶",
"staffId": 230477,
"staffUniqueIdentifier": "230477"
}
]
},
//买菜详情
"maicaiOrder": {
"orderStatus": 60,
"originalPrice": 6080,
"totalAmount": 5400,
"packingBoxPrice": 0,
"frozenPackagePrice": 0,
"packingBagPrice": 0,
"recipientPhone": "",
"recipientName": "陈柏丞",
"recipientAddress": "xxxx",
"deliveryPrice": 0,
"addressLongitude": 116454816,
"addressLatitude": 39991953,
"maicaiItemList": [
{
"price": 840,
"originalPrice": 280,
"quantity": 3,
"productType": 1,
"packingBoxPrice": 0,
"frozenPackagePrice": 0,
"skuName": "农夫山泉天然水1.5L",
"unit": "瓶",
"picUrl": "https://img.meituan.net/mallimages/50e80a6d146c08c2c2bbd6efeba08465213674.png"
},
{
"price": 1790,
"originalPrice": 1790,
"quantity": 1,
"productType": 1,
"packingBoxPrice": 0,
"frozenPackagePrice": 0,
"skuName": "狮王white-white牙膏150g",
"unit": "支",
"picUrl": "https://img.meituan.net/mallimages/b7cd040ce212cc2331fc03103e17c938308891.png"
},
{
"price": 1090,
"originalPrice": 1090,
"quantity": 1,
"productType": 1,
"packingBoxPrice": 0,
"frozenPackagePrice": 0,
"skuName": "思念小小汤圆三合一混合装300g",
"unit": "袋",
"picUrl": "https://p0.meituan.net/mallimages/16b094ce005f322f698b0a405a8bd9ce460796.jpg"
},
{
"price": 1080,
"originalPrice": 1080,
"quantity": 1,
"productType": 1,
"packingBoxPrice": 0,
"frozenPackagePrice": 0,
"skuName": "云南克瑞森无籽红提350g起",
"unit": "盒",
"picUrl": "https://img.meituan.net/mallimages/620cad32b79b468155c27cce351b0449859421.png"
},
{
"price": 1280,
"originalPrice": 1280,
"quantity": 1,
"productType": 1,
"packingBoxPrice": 0,
"frozenPackagePrice": 0,
"skuName": "春见耙耙柑约800g",
"unit": "袋",
"picUrl": "https://p0.meituan.net/mallimages/5560eddc86fd5741928220439e1374de660000.jpg"
}
],
"cookingServiceList": null,
"tradingItemList": null,
"orderPromotionList": [
{
"promotionName": "生活超市1231-0102",
"discount": 0,
"promotionQuantity": 1,
"giftQuantity": 0,
"suitCount": 0,
"underlinedPrice": 0,
"underlinedPriceDiscount": 0
},
{
"promotionName": "生活超市1231-0102",
"discount": 190,
"promotionQuantity": 0,
"giftQuantity": 1,
"suitCount": 0,
"underlinedPrice": 1280,
"underlinedPriceDiscount": 680
},
{
"promotionName": "生活超市1231-0102",
"discount": 200,
"promotionQuantity": 0,
"giftQuantity": 1,
"suitCount": 0,
"underlinedPrice": 1090,
"underlinedPriceDiscount": 680
},
{
"promotionName": "生活超市1231-0102",
"discount": 290,
"promotionQuantity": 0,
"giftQuantity": 1,
"suitCount": 0,
"underlinedPrice": 1080,
"underlinedPriceDiscount": 680
},
{
"promotionName": "生活超市1231-0102",
"discount": 0,
"promotionQuantity": 3,
"giftQuantity": 0,
"suitCount": 0,
"underlinedPrice": 0,
"underlinedPriceDiscount": 0
}
],
"groupBuyInfo": null,
"couponInfo": null,
"remark": ""
},
"staffInfo": {
"staffId": 230477,
"staffEntNum": "1008611",
"staffEmail": "sucesi@test.cn",
"staffName": "苏测试",
"staffPhone": "15200000000",
"staffSerialNum": "3DUOWTZNTN",
"staffLevel": "测试工程师",
"staffCity": "北京",
"staffOrgInfos": [
{
"orgPathName": "美团点评-技术部-质量部"
}
]
},
"invoiceInfo": {
"invoiceTitle": "北京三快在线科技有限公司",
"invoiceTaxNum": "xxxxxxxxxxxxxxxxxx",
"needInvoiceName": "无需平台代收",
"orderInvoiceStatusName": null
},
"controlInfo":{
"applyNo": "12345",
"outerApplyNo": "xxxxxxx"
},
"payInfo": {
"payAmount": "35.40",
"entPayAmount": "35.40",
"staffPayAmount": "0.00",
"refundAmount": "0.00",
"entRefundAmount": "0.00",
"staffRefundAmount": "0.00",
"realAmount": "35.40",
"payStatus": 20,
"payStatusName": "已支付",
"payType": 10,
"payTypeName": "企业支付",
"payTime":"2019-09-18 15:22:48",
"serviceFee": null
}
}
}