# 业务信息字段说明
# 1.外卖业务信息
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| orderStatus | Integer | 是 | 1 | 订单状态，详见：1.1.外卖订单状态枚举 |
| logisticsStatus | Integer | 是 | 1 | 外卖配送状态，详见：1.2.外卖配送状态枚举 |
| originalPrice | String | 是 | 32.00 | 商品原价总金额，单位元，精确到小数点后两位 |
| actualPayTotal | String | 是 | 32.20 | 订单支付总金额（含商品原价总金额、餐盒费、配送费、搭售商品金额），单位元，精确到小数点后两位 |
| boxTotalPrice | String | 是 | 0.20 | 打包盒总费用+打包袋总费用，单位元，精确到小数点后两位。注意，FoodItem中的boxPrice仅含打包盒的费用 |
| appendProductPrice | String | 是 | 32.20 | 搭售商品总金额，单位元，精确到小数点后两位 |
| shippingFee | String | 是 | 5.50 | 配送费，单位元，精确到小数点后两位 |
| recipientName | String | 否 | 张三 | 收货人姓名 |
| recipientPhone | String | 是 | 18511071111 | 收货人电话 |
| recipientAddress | String | 否 | 望京国际研发园 | 收货人地址 |
| addressLongitude | String | 是 | 116.491116 | 配送地址经度（国标） |
| addressLatitude | String | 是 | 40.002102 | 配送地址纬度（国标） |
| estimateArrivalTime | String | 是 | 2019-10-01 16:40:34 | 预计送达时间或预计自取时间，格式：yyyy-MM-dd hh:mm:ss |
| deliverTime | String | 否 | 2019-10-01 16:40:34 | 实际送达时间或实际自取时间，格式：yyyy-MM-dd hh:mm:ss |
| bookingOrder | Boolean | 是 | false | 是否预约订单，true：预订单；false：非预订单 |
| pickType | Integer | 否 | 0 | 配送类型，0：普通订单，1：到店自取订单 |
| poiCateCode | Long | 是 | 21000000 | 商家一级品类code |
| poiCateDesc | String | 是 | 美食 | 商家一级品类名称 |
| poi2ndCateCode | Long | 是 | 21030000 | 商家二级品类code |
| poi2ndCateDesc | String | 是 | 小吃 | 商家二级品类名称 |
| poi3rdCateCode | Long | 否 | 21030001 | 商家三级品类code |
| poi3rdCateDesc | String | 否 | 炸物类小吃 | 商家三级品类名称 |
| remark | String | 否 | 少放辣椒 | 订单备注 |
| foodList | List<FoodItem> | 是 | 菜品明细 | |
| appendProductList | List<AppendProductItem> | 否 | 搭售商品明细 |
FoodItem字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| foodId | String | 是 | 16317 | 菜品ID |
| foodName | String | 是 | 鱼香茄子 | 菜品名称 |
| originPrice | String | 是 | 13.50 | 菜品原价，单位元，精确到小数点后两位 |
| foodPrice | String | 是 | 13.50 | 菜品折后价，单位元，精确到小数点后两位 |
| foodCount | Integer | 是 | 2 | 菜品数量 |
| boxPrice | String | 是 | 0.10 | 餐盒价格，单位元，精确到小数点后两位 |
| boxNum | Integer | 是 | 1 | 餐盒数量 |
AppendProductItem字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| productId | String | 是 | 3461016706757955635 | 搭售商品id |
| productName | String | 是 | 准时宝 | 搭售商品名称，如准时宝 |
| price | String | 是 | 1.92 | 搭售商品价格，单位元，精确到小数点后两位 |
# 1.1.外卖订单状态枚举
| 订单状态编码 | 订单状态说明 |
|---|---|
| 1 | 提交订单 |
| 2 | 向餐厅推单 |
| 4 | 已接单 |
| 8 | 已完成 |
| 9 | 取消 |
# 1.2.外卖配送状态枚举
| 配送状态编码 | 配送状态说明 |
|---|---|
| 0 | 默认值 |
| 1 | 已推送给配送方 |
| 10 | 已抢单 |
| 15 | 骑手已到店 |
| 20 | 已取餐 |
| 40 | 已送达 |
| 100 | 已取消 |
# 2.团购业务信息
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| groupUseType | String | 否 | 套餐 | 团购形式，套餐、代金券 |
| groupConsumeStatus | Integer | 否 | 1 | 订单核销状态，0：未核销，10：已核销，20：部分核销 |
| grouponCodeList | List<GrouponCodeInfo> | 否 | 32.00 | 团购劵核销详情 |
| groupPayment | String | 否 | 32.20 | 团购余额补录金额，单位元，精确到小数点后两位 |
| groupPaymentTime | String | 否 | 0.20 | 团购余额补录时间，格式：yyyy-MM-dd hh:mm:ss |
GrouponCodeInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| encryptCode | String | 是 | aWHtScIHEXEDvymMpHCy9w | 券码 |
| consumeStatus | Integer | 是 | 10 | 团购券状态，详见：2.1.团购卷核销状态枚举 |
| consumeTime | String | 否 | 2019-10-01 16:40:34 | 核销时间，格式：yyyy-MM-dd hh:mm:ss |
| shopId | Long | 否 | 164745678 | 核销店铺id，如需获取，请联系客户经理开通权限 |
| shopName | String | 否 | 百岁我家·酸菜鱼专门店（古美店） | 核销店铺 |
| shopPhone | String | 否 | 888888 | 联系方式 |
| shopAddress | String | 否 | 高银街29号 | 核销店铺地址 |
| provinceId | String | 否 | 330000 | 核销省份编码（国标） |
| provinceName | String | 否 | 浙江省 | 核销省份 |
| cityId | String | 否 | 330100 | 核销城市编码（国标） |
| cityName | String | 否 | 杭州市 | 核销城市 |
| locationId | String | 否 | 330106 | 核销区县编码（国标） |
| locationName | String | 否 | 西湖区 | 核销区县 |
# 2.1.团购卷核销状态枚举
| 卷核销状态编码 | 卷核销状态说明 |
|---|---|
| -10 | 未知 |
| 0 | 未使用 |
| 5 | 部分使用 |
| 10 | 已使用 |
| 20 | 已冻结 |
| 30 | 已撤销 |
| 100 | 已退款 |
| 110 | 部分退款 |
# 3.打车业务信息
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| carBaseInfo | CarOrderBaseInfo | 是 | 打车订单基本信息 | |
| billInfo | CarOrderBillInfo | 是 | 打车费用账单信息 |
CarOrderBillInfo
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| orderStatus | Integer | 是 | 1 | 订单状态，详见：3.1.打车订单状态枚举 |
| carPayStatus | Integer | 是 | 3 | 打车支付状态 ，详见：3.2.打车支付状态枚举 |
| useType | Integer | 否 | 4 | 用车场景，1：延时用车，4：差旅用车，7：日常公出 |
| useTypeName | String | 否 | 加班 | 用车场景名称 |
| tripSceneType | Integer | 否 | 7 | 差旅用车子场景，5：前往机站，6：离开机站，7：出差城市用车 |
| tripSceneTypeName | String | 否 | 往返机站 | 差旅用车子场景名称 |
| carTypeName | String | 是 | 经济型 | 接单运力类型 |
| partnerCarTypeName | String | 否 | 阳光经济型 | 供应商接单车型 |
| reserveType | Integer | 是 | 1 | 预约单类型，1：实时单，2：预约单 |
| cancelReason | String | 否 | 行程取消 | 取消原因 |
| cancelLiabCode | Integer | 否 | 1 | 取消方，1：乘客，2：司机，3：平台 |
| useReason | String | 否 | 公务需要 | 用车原因 |
| upgradeType | String | 是 | 自费升舱 | 升舱服务，自费升舱、免费升舱、无 |
| driverName | String | 否 | 车先生 | 接单司机 |
| driverCarNumber | String | 否 | 苏A21365 | 接单司机车牌号 |
| driverCarModel | String | 否 | 长安逸动新能源 | 汽车型号 |
| driverCarColor | String | 否 | 黑色 | 车身颜色 |
| departureCityName | String | 是 | 北京市 | 用车城市 |
| arrivalCityName | String | 是 | 北京市 | 目的城市 |
| startAddress | String | 是 | 中国电科太极信息技术产业基地(西门)北侧 | 用户选择的上车点 |
| startLongitude | String | 是 | 116.470866 | 用户选择的上车点经度（国标） |
| startLatitude | String | 是 | 40.021955 | 用户选择的上车点纬度（国标） |
| endAddress | String | 是 | 望京-地铁站 | 用户选择的目的地 |
| endLongitude | String | 是 | 116.468674 | 用户选择的目的地经度（国标） |
| endLatitude | String | 是 | 39.998833 | 用户选择的目的地纬度（国标） |
| locatedStartAddress | String | 否 | 来广营东路7号靠近秦淮数据信息技术产业基地 | 系统定位的上车点 |
| locatedStartLongitude | String | 否 | 116.47206 | 系统定位的上车点经度（国标） |
| locatedStartLatitude | String | 否 | 40.022212 | 系统定位的上车点纬度（国标） |
| locatedEndAddress | String | 否 | 来广营东路7号靠近秦淮数据信息技术产业基地 | 系统定位的目的地 |
| locatedEndLongitude | String | 否 | 116.47206 | 系统定位的目的地经度（国标） |
| locatedEndLatitude | String | 否 | 116.47206 | 系统定位的目的地纬度（国标） |
| reserveTime | String | 否 | 2019-10-01 16:40:34 | 预约用车时间，格式：yyyy-MM-dd hh:mm:ss |
| driverConfirmedTime | String | 否 | 2019-10-01 16:40:34 | 司机接单时间，格式：yyyy-MM-dd hh:mm:ss |
| tripStartedTime | String | 否 | 2019-10-01 16:40:34 | 行程开始时间，格式：yyyy-MM-dd hh:mm:ss |
| tripDeliveredTime | String | 否 | 2019-10-01 16:40:34 | 行程结束时间，格式：yyyy-MM-dd hh:mm:ss |
| cancelTime | String | 否 | 2019-10-01 16:40:34 | 订单取消时间，格式：yyyy-MM-dd hh:mm:ss |
CarOrderBillInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| tripPrice | CarTripPriceInfo | 是 | 行程中费用 | |
| beforeTripPrice | CarBeforeTripPriceInfo | 是 | 行程前费用 | |
| afterTripPrice | CarAfterTripPriceInfo | 是 | 行程后费用 | |
| cancelPrice | CarCancelPriceInfo | 是 | 取消费用 |
CarTripPriceInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| totalPrice | String | 是 | 11.16 | 基础行程费（行程中各项费用之和减去三方运力优惠金额），单位元，精确到小数点后两位 |
| driveDistance | String | 是 | 3.700 | 行驶里程，单位公里，精确到小数点后三位 |
| driveDistanceFee | String | 是 | 3.26 | 行驶里程费，单位元，精确到小数点后两位 |
| driveLongDistance | String | 否 | 0.000 | 远途里程，单位公里，精确到小数点后三位 |
| driveLongDistanceFee | String | 是 | 0.00 | 远途里程费，单位元，精确到小数点后两位 |
| driveNight | String | 否 | 0.000 | 夜间里程，单位公里，精确到小数点后三位 |
| driveNightFee | String | 是 | 0.00 | 夜间里程费，单位元，精确到小数点后两位 |
| driveTime | Long | 是 | 36000 | 行驶时长，单位秒 |
| driveTimeFee | String | 是 | 0.40 | 行驶时长费，单位元，精确到小数点后两位 |
| dynamicFee | String | 否 | 0.00 | 动态调价费，单位元，精确到小数点后两位 |
| servicePriceFee | String | 否 | 0.00 | 节日服务费，单位元，精确到小数点后两位 |
| multiple | Integer | 否 | 1 | 计价倍数 |
| normalDistance | String | 否 | 0.000 | 正常里程，单位公里，精确到小数点后三位 |
| normalDistanceFee | String | 否 | 0.00 | 正常里程费，单位元，精确到小数点后两位 |
| normalTime | Long | 否 | 36000 | 正常时长，单位秒 |
| normalTimeFee | String | 否 | 0.00 | 正常时长费，单位元，精确到小数点后两位 |
| startPrice | String | 否 | 7.50 | 起步价，单位元，精确到小数点后两位 |
| startPriceDistance | String | 否 | 0.000 | 起步价最大里程，单位公里，精确到小数点后三位 |
| startPriceTime | Long | 否 | 36000 | 起步价最大时长，单位秒 |
| fixedPrice | String | 否 | 0.00 | 一口价，单位元，精确到小数点后两位 |
| driveMinAmount | String | 否 | 0.00 | 最低消费金额，单位元，精确到小数点后两位 |
| dynamicMaxAmount | String | 否 | 0.00 | 溢价封顶金额，单位元，精确到小数点后两位 |
| taxiMeterAmount | String | 否 | 0.00 | 出租车打表金额，单位元，精确到小数点后两位 |
| discountAmount | String | 否 | 0.00 | 三方运力优惠金额，单位元，精确到小数点后两位 |
| diffAmount | String | 否 | 0.00 | 基础费用补足金额，单位元，精确到小数点后两位 |
CarBeforeTripPriceInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| dispatchFee | String | 否 | 5.00 | 平台调度费，单位元，精确到小数点后两位 |
| longDispatchFee | String | 否 | 5.00 | 远途调度费，单位元，精确到小数点后两位 |
| waitTime | Long | 否 | 36000 | 等待时长，单位秒 |
| waitFee | String | 是 | 2.50 | 等待费，单位元，精确到小数点后两位 |
| thanksFee | String | 否 | 5.00 | 感谢费，单位元，精确到小数点后两位 |
CarAfterTripPriceInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| tollFee | String | 是 | 2.00 | 通行费，单位元，精确到小数点后两位 |
| parkFee | String | 是 | 0.00 | 停车费，单位元，精确到小数点后两位 |
| highwayFee | String | 是 | 10.00 | 高速费，单位元，精确到小数点后两位 |
| eDispatchFee | String | 是 | 5.00 | 电调费，单位元，精确到小数点后两位 |
| otherFee | String | 是 | 0.00 | 其他费用，单位元，精确到小数点后两位 |
CarCancelPriceInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| cancelPayFee | String | 是 | 2.00 | 用户取消时需要支付的费用总和，单位元，精确到小数点后两位 |
| cancelFee | String | 否 | 1.00 | 取消费，单位元，精确到小数点后两位 |
# 3.1.打车订单状态枚举
| 订单状态编码 | 订单状态说明 |
|---|---|
| 0 | 初始 |
| 1 | 提交订单 |
| 2 | 已推单 |
| 3 | 司机已接单 |
| 4 | 司机已到达 |
| 5 | 行驶中 |
| 6 | 已到达 |
| 7 | 待支付 |
| 8 | 已完成 |
| 20 | 乘客撤单 |
| 21 | 司机撤单 |
| 22 | 调度超时撤单 |
| 23 | 客服撤单 |
| 30 | 调度失败 |
| 31 | 计费失败 |
# 3.2.打车支付状态枚举
| 订单状态编码 | 订单状态说明 |
|---|---|
| 0 | 初始 |
| 1 | 待付款 |
| 2 | 付款中 |
| 3 | 付款成功 |
| 4 | 付款失败 |
| 5 | 申请退款 |
| 6 | 确认退款 |
| 7 | 拒绝退款 |
| 8 | 退款成功 |
| 9 | 退款失败 |
| 12 | 代扣中 |
| 13 | 代扣成功 |
| 14 | 代扣失败 |
# 4.特许报备业务信息
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| diningTime | String | 是 | 2019-12-31 00:00:00 | 用餐时间，格式：yyyy-MM-dd hh:mm:ss |
| peopleNum | Integer | 是 | 1 | 人数 |
| amount | String | 是 | 100.00 | 金额，单位元，精确到小数点后两位 |
| avgFee | String | 是 | 100.00 | 人均，单位元，精确到小数点后两位 |
| reasonType | String | 是 | 商家原因-餐厅不允许使用企业支付 | 特许原因类型 |
| reasonDesc | String | 是 | 商家不接受企业支付 | 特许原因描述 |
| auditStatusCode | Integer | 否 | 0 | 审核状态，0：无需审核，1：审核中，2：审核通过，3：拒绝 |
| auditStatusDesc | String | 否 | 无需审核 | 审核状态描述 |
# 5.酒店业务信息
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| hotelBaseInfo | HotelOrderBaseInfo | 是 | 订单基本信息 | |
| aptInfo | HotelOrderAptInfo | 是 | 订单预定信息 | |
| guestList | List<HotelGuestInfo> | 是 | 入住人信息 | |
| roomNightList | List<HotelRoomNightInfo> | 是 | 间夜信息 | |
| appealList | List<HotelAppealInfo> | 否 | 退订服务单信息 |
HotelOrderBaseInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| orderStatus | Integer | 是 | 5125 | 订单状态，详见：5.1.酒店订单状态枚举 |
| orderAmount | String | 是 | 189.05 | 订单金额，单位元，精确到小数点后两位 |
| invoiceType | Integer | 否 | 1 | 发票类型，1：普票、2：专票 |
| isAgreement | Boolean | 是 | true | 是否协议价订单 |
| isReceptionInvoice | Boolean | 是 | true | 是否前台拿票 |
| isOverseal | Boolean | 是 | true | 是否海外订单 |
| hotelPayType | Integer | 是 | 0 | 酒店费用类型，0：预付、2：现付 |
| currency | String | 是 | CNY | 币种 |
| expressAmount | String | 是 | 0.00 | 快递金额，单位元，精确到小数点后两位 |
| roomCount | Integer | 是 | 1 | 房间数 |
| roomNightCount | Integer | 是 | 2 | 间夜数 |
| createTime | String | 是 | 2024-01-01 00:00:00 | 下单时间，格式：yyyy-MM-dd hh:mm:ss |
| modifyTime | String | 是 | 2024-01-01 00:00:00 | 修改时间，格式：yyyy-MM-dd hh:mm:ss |
| riskAmount | String | 是 | 0.00 | 差标，单位元，精确到小数点后两位 |
| avgNightAmount | String | 是 | 10.00 | 间夜均价，单位元，精确到小数点后两位 |
| invoiceSubject | String | 是 | 第三方发票 | 开票方，前台取票、美团开票、第三方发票 |
| lossFromRefund | Integer | 否 | 5.00 | 退订损失（为整个订单因退订产生的损失金额，如提前离店、阶梯取消等），单位元，精确到小数点后两位 |
| isVip | Boolean | 是 | true | 是否含VIP客户 |
| bookType | String | 是 | 因公 | 预订类型，只有因公 |
| cancelRuleType | Integer | 是 | 2 | 取消规则，2：可免费取消、0、空：不可取消 |
| lastTimeCST | String | 否 | 2024-01-01 00:00:00 | 最晚免费取消时间，格式：yyyy-MM-dd hh:mm:ss，当cancelRuleType为2时，此时间前免费取消 |
HotelOrderAptInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| checkinTime | String | 是 | 2024-01-01 00:00:00 | 入住时间，格式：yyyy-MM-dd hh:mm:ss |
| checkoutTime | String | 是 | 2024-01-01 00:00:00 | 离店时间，格式：yyyy-MM-dd hh:mm:ss |
| actualCheckinTime | String | 否 | 2024-01-01 00:00:00 | 实际入住时间，格式：yyyy-MM-dd hh:mm:ss |
| actualCheckoutTime | String | 否 | 2024-01-01 00:00:00 | 实际离店时间，格式：yyyy-MM-dd hh:mm:ss |
| lastCancelTime | String | 否 | 2024-01-01 00:00:00 | 最晚取消时间，格式：yyyy-MM-dd hh:mm:ss |
| hotelStar | String | 否 | 3 | 酒店星级，详见：5.2.酒店星级枚举 |
| breakfast | String | 否 | 不含早/付费早餐/含早 | 早餐信息 |
| cityName | String | 是 | 南京 | 酒店所在城市 |
| cityId | String | 是 | 340100 | 酒店所在城市编码（国标） |
| provinceName | String | 否 | 江苏 | 酒店所在省 |
| provinceId | String | 否 | 340000 | 酒店所在省编码（国标） |
| poiId | Long | 是 | 57073 | 酒店id |
| poiName | String | 是 | 金利源酒店 | 酒店名字 |
| poiAddress | String | 是 | 南京XXX | 酒店地址 |
| goodsId | Long | 是 | 402768792 | 产品id |
| roomName | String | 是 | 标准间 | 房型名称 |
| partnerName | String | 是 | 美团 | 供应商名称 |
| partnerType | String | 是 | 酒店集团 | 供应商类型，0：酒店集团、1：第三方渠道、2：单体酒店、3：多店老板 |
HotelGuestInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| personType | Integer | 否 | 1 | 出行人类型，1：内部员工，2：外部人员 |
| personId | Long | 否 | 230477 | 出行人的ID |
| guestType | Integer | 是 | 0 | 用户类型，0：入住人，1：联系人 |
| guestName | String | 是 | 张三 | 入住人姓名 |
| guestPhone | String | 否 | 18905 | 入住人联系电话 |
| guestEmail | String | 否 | 联系邮箱，该字段无值 | |
| isVip | Boolean | 是 | 是 | 入住人是否为VIP |
| roomIndexId | Integer | 否 | 201 | 房间号 |
| applyNo | Long | 否 | 230477 | 入住人关联出差申请id，美团内部申请单id |
| tripId | Long | 否 | 230477 | 入住人关联出差申请行程id，美团内部行程id |
HotelRoomNightInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| bizDay | String | 是 | 2024-01-01 00:00:00 | 间夜日期，格式：yyyy-MM-dd hh:mm:ss |
| roomIndexId | Integer | 否 | 1 | 房间号 |
| breakfastNum | Integer | 是 | 1 | 早餐份数 |
| roomNightPrice | String | 是 | 399.00 | 每晚单间夜价格(by间夜日期)，单位元，精确到小数点后两位 |
HotelAppealInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| appealId | Long | 是 | 12275 | 服务单id |
| refundType | Integer | 是 | 1 | 退订类型，1：订单取消、2：申请退订 |
| refundNode | Integer | 是 | 2 | 业务节点，1：支付前申请，2：确房前申请、3：确认成功后申请 |
| operateType | Integer | 是 | 1 | 发起方，1：用户、2：客服 |
| refundStatus | Integer | 是 | 1 | 退订状态，1：待退订、2：退订成功、3：退订失败、4：退订撤回 |
| refundFlowId | String | 否 | 693926668463878146 | 退款流水id |
| refundPartInfoList | List<HotelRefundPartInfo> | 否 | 退订间夜信息，只有部分间夜取消(超时申退、客服发起)时此字段有值 | |
| refundReasonName | String | 是 | 疫情原因 | 退订原因名称 |
| refundReasonComment | String | 否 | 其他 | 退订备注 |
| needRefundMoney | Boolean | 是 | true | 是否需退款 |
| applyRefundAmount | String | 否 | 286.15 | 申退金额，单位元，精确到小数点后两位 |
| shouldRefundAmount | String | 否 | 286.15 | 应退总金额，单位元，精确到小数点后两位 |
| realRefundAmount | String | 否 | 286.15 | 实退总金额，单位元，精确到小数点后两位 |
| createTime | String | 是 | 2024-01-01 00:00:00 | 创建时间，格式：yyyy-MM-dd hh:mm:ss |
| updateTime | String | 是 | 2024-01-01 00:00:00 | 更新时间，格式：yyyy-MM-dd hh:mm:ss |
HotelRefundPartInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| personId | Long | 否 | 230477 | 出行人的ID |
| personType | Integer | 否 | 1 | 出行人类型，1：内部员工、2：外部人员 |
| bizDay | String | 是 | 2024-01-01 00:00:00 | 间夜日期，格式：yyyy-MM-dd hh:mm:ss |
| roomIndexId | Integer | 否 | 201 | 房间号 |
# 5.1.酒店订单状态枚举
| 订单状态编码 | 订单状态说明 |
|---|---|
| 5010 | 创建订单 |
| 5020 | 删除订单 |
| 5030 | 隐藏订单 |
| 5040 | 支付中 |
| 5050 | 支付成功 |
| 5060 | 支付失败 |
| 5070 | 超时未支付 |
| 5080 | 支付超时 |
| 5090 | 预定中 |
| 5100 | 预订成功 |
| 5110 | 预订失败 |
| 5115 | 预订异常 |
| 5120 | 商家首次拒绝 |
| 5125 | 取消中 |
| 5130 | 取消成功 |
| 5135 | 取消失败 |
| 5137 | 取消超时 |
| 5140 | 客服强退 |
| 5150 | 已入住 |
| 5200 | 已离店 |
# 5.2.酒店星级枚举
| 酒店星级编码 | 酒店星级说明 |
|---|---|
| 0 | 国家旅游局颁布五星级证书 |
| 1 | 豪华(按五星级标准建造) |
| 2 | 国家旅游局颁布四星级证书 |
| 3 | 高档(按四星级标准建造) |
| 4 | 国家旅游局颁布三星级证书 |
| 5 | 舒适型(按三星级标准建造) |
| 6 | 经济型 |
| 7 | 低档 |
# 6.买药业务信息
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| orderStatus | Integer | 是 | 1 | 买药订单状态，详见：6.1.买药订单状态枚举 |
| logisticsStatus | Integer | 是 | 1 | 买药配送状态，详见：6.2.买药配送状态枚举 |
| originalPrice | String | 是 | 32.20 | 订单原价，单位元，精确到小数点后两位 |
| productPrice | String | 是 | 26.50 | 商品原价，单位元，精确到小数点后两位 |
| shippingFee | String | 是 | 5.50 | 配送费原价，单位元，精确到小数点后两位 |
| boxTotalPrice | String | 是 | 0.20 | 打包费原价，单位元，精确到小数点后两位 |
| actualPayTotal | String | 是 | 32.20 | 订单应付总金额，单位元，精确到小数点后两位 |
| realProductPrice | String | 是 | 26.50 | 商品价格，单位元，精确到小数点后两位，取值逻辑:actualPayTotal-realShippingFee-realboxPrice-appendProductTotalPrice |
| realShippingFee | String | 是 | 5.50 | 配送费，单位元，精确到小数点后两位 |
| realBoxPrice | String | 是 | 0.20 | 打包费，单位元，精确到小数点后两位 |
| appendProductTotalPrice | String | 是 | 0.00 | 搭售商品总金额，单位元，精确到小数点后两位 |
| remark | String | 否 | 放门口 | 订单备注 |
| brandId | Long | 否 | 12345 | 品牌Id |
| brandName | String | 否 | 正方药房 | 品牌名称 |
| recipientName | String | 是 | 张三 | 收货人姓名 |
| recipientPhone | String | 是 | 18511071111 | 收货人电话 |
| recipientAddress | String | 是 | 望京国际研发园 | 收货人地址 |
| addressLongitude | String | 是 | 116.491116 | 配送地址经度 (国标) |
| addressLatitude | String | 是 | 40.002102 | 配送地址纬度 (国标) |
| estimateArrivalTime | String | 是 | 2019-10-01 16:40:34 | 预计到达时间或预计自取时间，格式：yyyy-MM-dd hh:mm:ss |
| deliverTime | String | 否 | 2019-10-01 16:40:34 | 实际送达时间或实际自取时间，格式：yyyy-MM-dd hh:mm:ss |
| bookingOrder | Boolean | 是 | true | 是否预约订单：true为预订单；false为非预订单 |
| itemList | List<OrderItem> | 是 | [{}] | 药品明细 |
| appendProductDetailList | List<AppendProductItem> | 是 | [{}] | 搭售商品明细 |
| poiCateCode | Long | 是 | 22 | 商家一级品类code |
| poiCateDesc | String | 是 | 医药健康 | 商家一级品类名称 |
| poi2ndCateCode | Long | 是 | 2300 | 商家二级品类code |
| poi2ndCateDesc | String | 是 | 综合药店 | 商家二级品类名称 |
| poi3rdCateCode | Long | 否 | 商家三级品类code | |
| poi3rdCateDesc | String | 否 | 商家三级品类名称 | |
| pickType | Integer | 是 | 0 | 配送类型 0-普通订单 1-到店自取订单 2-独立到店自取订单 |
| orderMode | Integer | 是 | 1 | 订单模式 1-O2O 2-B2C |
| logisticsInfoList | List<LogisticsInfo> | 是 | [{}] | 快递信息 |
OrderItem字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| boxNum | Integer | 是 | 1 | 打包盒数量 |
| boxPrice | String | 是 | 0.10 | 打包盒价格，单位元，精确到小数点后两位 |
| count | Integer | 是 | 2 | 数量 |
| name | String | 是 | 感冒灵 | 药品名称 |
| originPrice | String | 是 | 13.50 | 原始金额，单位元，精确到小数点后两位 |
| price | String | 是 | 13.50 | 药品金额，单位元，精确到小数点后两位 |
| spuId | Long | 是 | 2204335708 | 商品ID |
| pictureUrl | String | 否 | http://p0.meituan.net/xianfu/60a70d013366be54160551e746cff6c021016.jpg | 商品缩略图url |
LogisticsInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| logisticsNo | String | 是 | SH1234567X | 物流单号 |
| status | Integer | 是 | 2 | 买药物流状态，详见：6.3.买药物流状态枚举 |
| deliveryName | String | 是 | 顺丰快递 | 物流商名称 |
| spPkgTrackList | List<SpPkgTrack> | 是 | [{}] | 快递轨迹 |
SpPkgTrack字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| time | String | 是 | 2021-05-11 11:12:12 | 物流更新时间，格式：yyyy-MM-dd hh:mm:ss |
| context | String | 是 | 【西安市】 快件已经到达 【西安中转】 | 物流信息 |
# 6.1.买药订单状态枚举
| 订单状态编码 | 订单状态说明 |
|---|---|
| 1 | 提交订单 |
| 2 | 向餐厅推单 |
| 4 | 已接单 |
| 8 | 已完成 |
| 9 | 取消 |
# 6.2.买药配送状态枚举
| 配送状态编码 | 配送状态说明 |
|---|---|
| 0 | 默认值 |
| 1 | 已推送给配送方 |
| 10 | 已抢单 |
| 15 | 骑手已到店 |
| 20 | 已取餐 |
| 40 | 已送达 |
| 100 | 已取消 |
# 6.3.买药物流状态枚举
| 物流状态编码 | 物流状态说明 |
|---|---|
| 0 | 商家已发货 |
| 1 | 商家发货 |
| 10 | 揽件 |
| 20 | 在途 |
| 30 | 派件 |
| 40 | 签收 |
| 50 | 疑难 |
| 60 | 收件人拒签 |
| 70 | 退回 |
| 80 | 退签 |
| 100 | 待清关 |
| 110 | 清关中 |
| 120 | 清关异常 |
| 130 | 已清关 |
| 140 | 转投 |
| 150 | 待取件 |
# 7.买菜业务信息
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| orderStatus | Integer | 是 | 10 | 买菜订单状态，详见：7.1.买菜订单状态枚举 |
| originalPrice | String | 是 | 20.00 | 商品原价总金额：元，精确到小数点后两位 |
| totalPrice | String | 是 | 20.00 | 订单原价总金额：元，精确到小数点后两位（商品原价总金额+商品加工费+餐盒费+配送费） |
| totalAmount | String | 是 | 20.00 | 订单总金额：元，精确到小数点后两位（订单原价总金额-订单优惠总金额 + 配送费） |
| promotionPrice | String | 是 | 20.00 | 商品促销总金额：元，精确到小数点后两位 |
| couponReducePrice | String | 是 | 20.00 | 优惠券减免总金额：元，精确到小数点后两位 |
| cookingPrice | String | 是 | 1.50 | 总加工费：元，精确到小数点后两位 |
| weightDiffPrice | String | 是 | 2.00 | 标品称重差额退金额：元，精确到小数点后两位 |
| packingBoxPrice | String | 是 | 2.00 | 总餐盒费：元，精确到小数点后两位 |
| recipientPhone | String | 是 | 13000000000 | 收货人手机 |
| recipientName | String | 是 | 张三 | 收货人姓名 |
| recipientAddress | String | 是 | 启明国际大厦-A座 (启明大厦8楼) | 收货人地址 |
| deliveryPrice | String | 是 | 1.50 | 配送费：元，精确到小数点后两位 |
| addressLongitude | String | 是 | 116.491116 | 配送地址经度 (国标) |
| addressLatitude | String | 是 | 40.002102 | 配送地址纬度 (国标) |
| refundStatus | Integer | 是 | 0 | 退款状态，0：默认（未退款），3：c端用户申请取消或者部分退，5：用户撤回之前申请，6：客服拒绝用户的申请，10：申请退款，20：拒绝退款，30：确认退款，40：退款失败，50：退款成功 |
| remark | String | 否 | 到货放在门口 | 订单备注 |
| maicaiList | List<MaicaiItem> | 否 | [{}] | 订单商品表 |
| cookingServiceList | List<CookingServiceItem> | 否 | [{}] | 烹饪商品信息表 |
| tradingList | List<TradingItem> | 否 | [{}] | 会员卡明细 |
| promotionList | List<PromotionItem> | 否 | [{}] | 商品促销信息表 |
| couponList | List<CouponItem> | 否 | [{}] | 优惠券信息表 |
| refundList | List<RefundItem> | 否 | [{}] | 退款信息 |
MaicaiItem字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| itemId | Long | 是 | 12345 | 订单商品ID |
| skuId | Long | 否 | 123456 | 商品SKU编码 |
| skuName | String | 是 | 甘竹牌豆豉鲮鱼罐头227g | 商品名称 |
| spuId | Long | 否 | 123456 | 商品SPU编码 |
| productType | Integer | 是 | 1.00 | 商品类型，1：标品，2：散装 |
| quantity | Integer | 是 | 2.00 | 购买数量，当商品类型为标品时和展示数量相同，为散装时单位为毫克 |
| unit | String | 是 | 盒 | 商品单位 |
| price | String | 是 | 27.00 | 单商品原价总和，单位：元，精确到小数点后两位 |
| originalPrice | String | 是 | 13.50 | 单商品原价，单价：元，精确到小数点后两位 |
| packingBoxPrice | String | 是 | 3.00 | 餐盒费金额：元，精确到小数点后两位 |
| frozenPackagePrice | String | 是 | 2.20 | 冻品包材费用：元，精确到小数点后两位 |
| picUrl | String | 否 | http://xxx.jpg | 商品图片 |
CookingServiceItem字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| cookingId | Long | 是 | 12345 | 烹饪服务ID |
| cookingSkuId | Long | 否 | 123456 | 烹饪商品SKU编码 |
| itemId | Long | 否 | 12345 | 烹饪对应主品的订单商品ID |
| cookingName | String | 是 | 炒 | 烹饪服务名称 |
| cookingSkuName | String | 是 | 虾 | 烹饪商品名称 |
| cookingQuantity | Long | 是 | 2 | 加工数量 |
| cookingUnit | String | 是 | 盒 | 商品单位 |
| cookingOriginalPrice | String | 是 | 5.00 | 原价：元，精确到小数点后两位 |
| quantity | Long | 是 | 2 | 数量 |
TradingItem字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| tradingId | Long | 是 | 12345 | 会员卡ID |
| tradingName | String | 是 | XXX卡 | 会员卡名称 |
| tradingQuantity | String | 是 | 2.00 | 数量 |
| tradingOriginalPrice | String | 是 | 10.00 | 单个item的价格：元，精确到小数点后两位 |
| tradingViewPrice | String | 是 | 20.00 | 展示价格：元，精确到小数点后两位 |
| tradingReducePrice | String | 是 | 0.00 | 减免价格：元，精确到小数点后两位 |
| tradingPicUrl | String | 是 | http://xxx.jpg | 会员卡图片 |
PromotionItem字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| promotionId | Long | 是 | 12345 | 促销ID |
| itemId | Long | 否 | 12345 | 促销对应主品的订单商品ID |
| promotionName | String | 是 | 华北果蔬1.8-1.13 | 促销名称 |
| promotionQuantity | Integer | 是 | 1 | 参与促销数量 |
| giftQuantity | Integer | 是 | 10 | 赠品数量 |
| suitCount | Integer | 是 | 10 | 套装数量 |
| mainSkuIdList | List | 否 | [123456] | 订单维度促销的主品skuId |
| discount | String | 是 | 2.00 | 促销减免金额：元，精确到小数点后两位 |
CouponItem字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| couponCode | String | 是 | 100594054 | 优惠券code |
| couponPrice | String | 是 | 5.00 | 优惠券价格：元，精确到小数点后两位 |
| couponReduceType | Integer | 是 | 1 | 优惠券类型，0：不明确的，1：在商品上抵扣，2：在配送费上抵扣，3：在服务费上抵扣 |
RefundItem字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| refundCreateTime | String | 是 | 2022-12-27 15:22:44 | 发起退款的时间 |
| factRefundDeliveryPrice | String | 是 | 2.20 | 实际退的配送费：元，精确到小数点后两位 |
| maicaiItemRefundList | List<MaicaiItemRefundItem> | 是 | [{}] | 退款商品明细 |
MaicaiItemRefundItem字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| itemId | Long | 否 | 12345 | 退款商品ID |
| skuId | Long | 是 | 123456 | 退款商品sku编码 |
| skuName | String | 是 | 白菜 | 退款商品名称 |
| refundQuantity | Integer | 是 | 1 | 退款数量，当商品类型为标品时和展示数量相同，为散装时单位为毫克 |
| refundPrice | String | 是 | 1.00 | 退款商品的实际退款金额，单位：元，精确到小数点后两位 |
| originalPrice | String | 是 | 3.00 | 退款商品原价，单位：元，精确到小数点后两位 |
# 7.1.买菜订单状态枚举
| 订单状态编码 | 订单状态说明 |
|---|---|
| 0 | 提交订单 |
| 10 | 付款中 |
| 20 | 付款失败 |
| 30 | 支付成功 |
| 40 | 已推送至配送中心 |
| 50 | 已送达 |
| 60 | 已完成 |
| 70 | 用户取消 |
| 80 | 客服取消 |
| 90 | 系统自动取消 |
# 8.火车票业务信息
TrainOrderInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| userOrderList | List<UserOrderInfo> | 是 | [{}] | 订单信息列表，直达只有一个子订单，中转时会有2个 |
| PassengerInfoList | List<PassengerInfo> | 是 | [{}] | 乘客信息列表 |
UserOrderInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| trainOrderBase | TrainOrderBaseInfo | 是 | {} | 订单基本信息 |
| TicketInfoList | List<TrainTicketInfo> | 否 | [{}] | 票信息 |
| grabInfo | TrainGrabInfo | 否 | {} | 抢票单信息 |
| bookInfo | TrainBookInfo | 否 | {} | 预订单详细信息 |
| changeInfo | List<TrainChangeInfo> | 否 | [{}] | 改签服务单详细信息 |
| refundInfo | List<TrainRefundInfo> | 否 | [{}] | 退票服务单详细信息 |
| printInfoList | List<TrainPrintInfo> | 否 | [{}] | 代打印结果 |
PassengerInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| passengerId | String | 是 | 123456789 | 乘车人ID |
| passengerName | String | 是 | 王美团 | 乘车人姓名 |
| passengerIdCardType | String | 是 | 1 | 乘车人证件类型，详见：8.1.乘车人证件类型枚举 |
| passengerIdCardNo | String | 是 | 1533634649910001 | 乘车人证件编号 |
| personType | Integer | 是 | 1 | 出行人类型：1-内部员工；2-外部人员 |
| personId | Long | 是 | 6111111 | 出行人的员工ID，内部员工此字段为staffId，外部人员此字段为guestId |
TrainOrderBaseInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| bizOrderId | String | 是 | 1533634649910001 | 用户单号 |
| platformOrderId | String | 是 | 1533634649910001 | 本地单号 |
| orderId12306 | String | 否 | EJ7638586 | 12306订单号（取票号）（若出票成功过则必传） |
| orderStatus | Integer | 是 | 300 | 订单状态码，详见：8.2.订单状态枚举 |
| orderStatusName | String | 是 | 已发车 | 订单状态名称 |
| contactPhone | String | 是 | 15111111111 | 联系人手机号 |
| transferType | Integer | 是 | 1 | 中转类型：0-直达订单；1-中转订单；2-中转补单 |
| transferFatherOrderId | String | 否 | 1798668907620466780233 | 中转父订单号 |
| segmentIndex | Integer | 否 | 1 | 第几程：1-第一程；2-第二程 |
TrainTicketInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| originTicket | TrainTicketDetail | 是 | {} | 原票信息（未改签的或改签后的原票信息） |
| changeTicket | TrainTicketDetail | 否 | {} | 改签票，当有改签成功或改签中的票时，此字段有值 |
| changeFailedTicketList | List<TrainTicketDetail> | 否 | [{}] | 改签失败的票，当改签取消或改签失败时，此字段有值 |
TrainTicketDetail字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| ticketId | Long | 否 | 1798987065116532835416 | 供应商票号 |
| changeServiceId | String | 否 | 1798987065116532835416 | 改签才有值，是改签单的服务单号 |
| passengerId | String | 是 | 1234567890 | 乘车人Id |
| ticketStatus | String | 是 | TICKET_CREATE | 票状态码，详见：8.3.票状态枚举 |
| ticketStatusName | String | 是 | 出票中 | 票状态名称 |
| trainCode | String | 是 | C100 | 车次号 |
| fromStationCode | String | 是 | SYT | 发车站三字码 |
| fromStationName | String | 是 | 沈阳站 | 发车站名称 |
| fromLocationCode | String | 是 | 310000 | 发车行政区编码（国标） |
| fromLocationName | String | 否 | 沈阳市 | 发车行政区名称,存在极少获取不到的情况 |
| toStationCode | String | 是 | IFP | 到达站三字码 |
| toStationName | String | 是 | 北京朝阳站 | 到达站名称 |
| toLocationCode | String | 是 | 110000 | 到达行政区编码（国标） |
| toLocationName | String | 否 | 北京市 | 到达行政区名称,存在极少获取不到的情况 |
| startTime | String | 是 | 2024-06-07 19:15:00 | 发车时间，格式：yyyy-MM-dd hh:mm:ss |
| arriveTime | String | 是 | 2024-06-07 22:00:00 | 到站时间，格式：yyyy-MM-dd hh:mm:ss |
| runTime | Integer | 否 | 165 | 运行时长，单位秒 |
| ticketGate | String | 否 | 1候车大厅2A2B | 候车室检票口 |
| seatTypeCode | Integer | 否 | 14 | 座位类型，详见：8.4.座位类型枚举 |
| seatTypeName | String | 否 | 二等座 | 座位类型名称 |
| coachNo | String | 否 | 04车厢 | 车厢号 |
| seatNo | String | 否 | 08C号 | 座位号 |
| estimatedMaxTicketPrice | String | 是 | 140.50 | 预估最高票单价，单位：元 |
| ticketPrice | String | 否 | 140.50 | 实际票价格（占座成功后必传)，单位：元 |
TrainGrabInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| grabOrderId | Long | 是 | 1583987108805101 | 抢票单号（抢票唯一编号） |
| grabOrderStatusCode | Integer | 是 | 130 | 抢票状态码，详见：8.5.抢票状态枚举 |
| grabOrderStatusName | String | 是 | 抢票出票成功 | 抢票状态名称 |
| grabEndTime | String | 是 | 2024-01-02 00:00:00 | 抢票结束时间，格式：yyyy-MM-dd hh:mm:ss |
| optionDateList | List<String> | 是 | ["2023-12-31 00:00:00", "2024-01-01 00:00:00"] | 乘车日期列表 |
| trainCodeList | List<String> | 是 | ["G101", "G102"] | 车次列表 |
| seatTypeList | List<String> | 是 | ["二等座", "一等座"] | 座席类型列表 |
| speedUpPackageNum | Integer | 是 | 0 | 加速包数量 |
| speedUpPackagePrice | String | 是 | 0.00 | 加速包价格，单位：元 |
| entEstimatePay | String | 是 | 140.00 | 企业预支付金额，单位：元 |
| personalEstimatePay | String | 是 | 0.00 | 个人预支付金额，单位：元 |
| exceedId | String | 否 | E20230331001 | 超规单号（抢票有超规时必传） |
| auditNo | String | 否 | A20230331001 | 审批单号（抢票有审批时必传） |
TrainBookInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| bookTicketList | List<TrainBookTicketInfo> | 是 | [{}] | 预订票简易信息 |
| entEstimatePay | String | 是 | 200.00 | 企业预支付总额（预订企业预支付金额，若是抢票单，则为抢票支付金额），单位：元 |
| personalEstimatePay | String | 是 | 10.00 | 个人预支付总额（预订个人预支付金额，若是抢票单，则为抢票支付金额），单位：元 |
| exceedId | String | 否 | exceed123 | 超规单号（预订有超规时必传，若是抢票出票单，则等同抢票超规单号） |
| auditNo | String | 否 | audit456 | 审批单号（有审批时为必传，若是抢票出票单，则等同抢票审批单号） |
| failReason | String | 否 | 行程冲突 | 预订失败原因 |
TrainBookTicketInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| ticketId | String | 是 | 1798987065116532835 | 票编号（预订单的票编号，若车票后需改签，预订单中的票编号不变) |
TrainChangeInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| changeServiceId | Long | 是 | 1741492192788520962 | 改签服务单ID |
| changeServiceStatusCode | Integer | 是 | 206 | 改签服务单状态code，详见：8.6.改签服务单状态枚举 |
| changeServiceStatusName | String | 是 | 改签成功 | 改签服务单状态名称 |
| changeReasonList | List<TrainChangeReasonInfo> | 是 | ["企业原因"] | 改签原因 |
| changeCreateTime | String | 是 | 2024-01-01 08:08:08 | 改签提交时间，格式：yyyy-MM-dd hh:mm:ss |
| changeTicketList | List<TrainChangeTicketInfo> | 是 | [{}] | 改签票信息 |
| entEstimatePay | String | 是 | 0.00 | 企业预支付金额，单位：元 |
| personalEstimatePay | String | 是 | 0.00 | 个人预支付金额，单位：元 |
| exceedId | String | 否 | exceed123 | 超规单号（改签有超规时必传） |
| auditNo | String | 否 | audit456 | 审批单号（改签有审批必传） |
| changeFailReason | String | 否 | 行程冲突 | 改签失败原因 |
TrainChangeReasonInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| reason | String | 否 | 个人原因 | 改签原因 |
| reasonRemark | String | 否 | 生病 | 改签原因详细描述 |
TrainChangeTicketInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| oldTicketId | Long | 是 | 1798987065116532835416 | 改签前票编号 |
| changeTicketId | Long | 否 | 1798987065116532835417 | 改签后票编号 |
| estimateRefundFee | String | 是 | 5.00 | 预计改签退票费（高改低退票费），单位：元 |
| estimateChangeFee | String | 是 | 0.00 | 预计改签手续费，单位：元 |
| estimateRefundMoney | String | 是 | 5.00 | 预计退票金额，单位：元 |
| estimatePayMoney | String | 是 | 0.00 | 预计支付金额，单位：元 |
TrainRefundInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| refundServiceId | Long | 是 | 1741496773183008770 | 退票服务单ID |
| refundStatusCode | Integer | 是 | 2100 | 退票服务单状态code，详见：8.7.退票服务单状态枚举 |
| refundStatusName | String | 是 | 退票中 | 退票服务单状态名称 |
| refundReasonList | List<String> | 是 | ["个人原因，行程有变"] | 退票原因 |
| refundCreatedTime | String | 是 | 2024-01-01 19:01:09 | 退票提交时间，格式：yyyy-MM-dd hh:mm:ss |
| refundTicketList | List<TrainRefundTicketInfo> | 是 | [{}] | 退款票列表 |
TrainRefundTicketInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| refundTicketId | Long | 是 | 1234567890 | 退票编号 |
| refundTicketStatus | Integer | 是 | 0 | 退票状态，详见：8.8.退票状态枚举 |
| isChangeTicket | boolean | 是 | true | 是否退的改签票 |
| estimateRefundFee | String | 是 | 100.00 | 预计退票费（退票提单时预估扣取的退票费），单位：元 |
| estimateRefundMoney | String | 是 | 40.50 | 预计退款(退票提单时预估的企业退款金额)，单位：元 |
| refundFailReason | String | 否 | 已发车无法退票 | 退票失败原因 |
TrainPrintInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| ticketId | String | 是 | 1798987065116532835416 | 票编号（当前如果是改签，给的是原票号） |
| printStatus | Integer | 是 | 2000 | 代打印结果，详见：8.9.代打印状态枚举 |
| printStatusDesc | String | 是 | 取票成功 | 代打印状态 |
# 8.1.乘车人证件类型枚举
| 乘车人证件类型编码 | 乘车人证件类型说明 |
|---|---|
| 1 | 二代身份证 |
| C | 港澳居民来往内地通行证 |
| G | 台湾居民来往大陆通行证 |
| B | 护照 |
| 10 | 港澳台居民居住证 |
| H | 外国人永久居留身份证 |
# 8.2.订单状态枚举
| 订单状态类型编码 | 订单状态类型说明 |
|---|---|
| 100 | 待支付 |
| 110 | 已取消 |
| 120 | 支付超时 |
| 130 | 出票失败 |
| 150 | 出票中 |
| 200 | 出票成功 |
| 201 | 改签中 |
| 202 | 改签待支付 |
| 203 | 改签出票中 |
| 204 | 改签取消 |
| 205 | 改签失败 |
| 206 | 改签成功 |
| 210 | 退票中 |
| 220 | 部分退票 |
| 230 | 已退票 |
| 240 | 退票失败 |
| 260 | 退款中 |
| 270 | 部分退款 |
| 280 | 退款完成 |
| 290 | 退款失败 |
| 300 | 已发车 |
# 8.3.票状态枚举
| 票状态类型编码 | 票状态类型说明 |
|---|---|
| TICKET_CREATE | 票创建 |
| TICKETING | 出票中 |
| TICKETED | 已出票 |
| TICKET_CANCEL | 票取消 |
| TICKET_REFUNDING | 退票中 |
| TICKET_REFUNDED | 已退票 |
| TICKET_CHANGING | 改签中 |
| TICKET_CHANGED | 已改签 |
| TICKET_DEPART | 已发车 |
# 8.4.座位类型枚举
| 座位类型编码 | 座位类型说明 |
|---|---|
| 1 | 硬座 |
| 2 | 硬卧上 |
| 3 | 硬卧中 |
| 4 | 硬卧下 |
| 5 | 软座 |
| 6 | 软卧上 |
| 7 | 软卧中 |
| 8 | 软卧下 |
| 9 | 商务座 |
| 10 | 多功能座 |
| 11 | 二等包座 |
| 12 | 特等座 |
| 13 | 一等座 |
| 14 | 二等座 |
| 42 | 高级软卧 |
| 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 | 未知 |
# 8.5.抢票状态枚举
| 抢票状态类型编码 | 抢票状态类型说明 |
|---|---|
| 30 | 待支付 |
| 40 | 支付超时 |
| 50 | 提交中 |
| 60 | 提交失败 |
| 100 | 抢票中 |
| 120 | 已暂停 |
| 121 | 已暂停 |
| 122 | 已暂停 |
| 123 | 已暂停 |
| 124 | 已暂停 |
| 125 | 已暂停 |
| 130 | 已占座 |
| 140 | 待启动 |
| 150 | 待启动 |
| 151 | 待开启(无账号 & 未开启专人抢) |
| 160 | 已过期 |
| 169 | 取消中 |
| 170 | 已取消 |
| 300 | 已删除 |
| 400 | 已失败 |
| 500 | 未知 |
# 8.6.改签服务单状态枚举
| 改签服务单状态类型编码 | 改签服务单状态类型说明 |
|---|---|
| 201 | 改签中 |
| 202 | 改签待支付 |
| 203 | 改签出票中 |
| 204 | 改签取消 |
| 205 | 改签失败 |
| 206 | 改签成功 |
# 8.7.退票服务单状态枚举
| 退票服务单状态类型编码 | 退票服务单状态类型说明 |
|---|---|
| 2100 | 退票中 |
| 2200 | 部分退票完成 |
| 2300 | 退票完成 |
| 2400 | 退票失败 |
| 2600 | 退款中 |
| 2800 | 退款完成 |
| 2900 | 退款失败 |
| 4000 | 未知 |
# 8.8.退票状态枚举
| 退票状态类型编码 | 退票状态类型说明 |
|---|---|
| 0 | 未退款 |
| 100 | 退款中 |
| 200 | 退款成功 |
| 300 | 退款失败 |
# 8.9.代打印状态枚举
| 代打印状态类型编码 | 代打印状态类型说明 |
|---|---|
| 1000 | 待推送 |
| 1010 | 推送取消 |
| 1020 | 推送失败 |
| 1030 | 推送成功 |
| 2000 | 代打印成功 |
| 2001 | 取票成功-已改签 |
| 2002 | 取票成功-已退票 |
| 2010 | 未查到车票信息 |
| 2020 | 已被取出 |
| 2030 | 已被退票 |
| 2040 | 已被改签 |
| 2050 | 客服要求取消 |
| 2060 | 信息不符-姓名 |
| 2070 | 信息不符-证件 |
| 2080 | 信息不符-日期 |
| 2090 | 信息不符-车次 |
| 2100 | 信息不符-发/到站 |
| 2110 | 已过取票时间 |
| 2120 | 车次停运 |
| 2999 | 其他 |
# 9.跑腿业务信息
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| 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 | 否 | 3号楼202 | 收货人门牌号 |
| orderStatus | Integer | 是 | 20 | 订单状态，详见：9.1.跑腿订单状态枚举 |
| logisticsStatus | Integer | 是 | 100 | 配送状态，详见：9.2.跑腿配送状态枚举 |
| orderTime | String | 是 | 2024-05-27 14:29:14 | 下单时间 格式：yyyy-MM-dd hh:mm:ss |
| goodsTypeNameList | List<String> | 是 | ["餐饮"] | 物品类型名称 |
| goodsTypeSizeList | List<String> | 是 | ["6寸"] | 物品大小 |
| goodsWeight | String | 是 | 1 | 商品重量 单位kg |
| deliveryDistance | Integer | 否 | 12 | 配送距离 单位km |
| courierName | String | 是 | 李明 | 配送员姓名 |
| courierPhone | String | 是 | 18888888888 | 配送员电话 |
| pickUpTime | String | 是 | 2024-05-27 14:29:14 | 取件时间（立即取件为空）格式：yyyy-MM-dd hh:mm:ss |
| userSpecifiedTime | String | 否 | 2024-05-27 14:29:14 | 用户选定取件时间 格式：yyyy-MM-dd hh:mm:ss |
| estimateArrivalTime | String | 否 | 2024-05-27 15:56:31 | 预计送达时间 格式：yyyy-MM-dd hh:mm:ss |
| estimatePickupDuration | Integer | 是 | 10 | 预计取件时间 单位分钟 |
| canceledTime | String | 是 | 2024-05-27 15:19:30 | 订单取消时间 格式：yyyy-MM-dd hh:mm:ss |
| finishedTime | String | 否 | 2024-05-27 15:19:30 | 订单完成时间 格式：yyyy-MM-dd hh:mm:ss |
| insuranceInfo | PaotuiOrderInsuranceInfo | 否 | {} | 保险信息 |
| modifyDeliveryInfo | PaotuiModifyDeliveryInfo | 否 | {} | 付费修改地址信息，需关注modifyStatus,成功表明地址修改成功 |
| extraList | List<PaotuiOrderExtra> | 否 | [{}] | 订单优惠活动 |
PaotuiOrderInsuranceInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| payCost | String | 否 | 20.00 | 保险实际支付金额：元，精确到小数点后两位 |
| insuranceClaimStatusDesc | String | 否 | 已投保 | 保险理赔状态文案 |
PaotuiModifyDeliveryInfo字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| recipientAddress | String | 否 | XXX | 收货地址 |
| recipientHouseNumber | String | 否 | XXX栋 | 收货地址门牌号 |
| deliveryDistance | Integer | 否 | 2 | 配送距离 单位km |
| pickUpTime | String | 否 | 2024-06-06 17:13:06 | 取件时间（立即取件为空）格式：yyyy-MM-dd hh:mm:ss |
| userSpecifiedTime | String | 否 | 2024-06-06 17:13:06 | 用户选定取件时间 格式：yyyy-MM-dd hh:mm:ss |
| estimateArrivalTime | String | 否 | 2024-06-06 17:13:06 | 预计送达时间 格式：yyyy-MM-dd hh:mm:ss |
| goodsTypeNames | List<String> | 否 | ["蛋糕"] | 物品类型名称 |
| goodsWeight | String | 否 | 8 | 商品重量 单位kg |
| modifyFee | String | 否 | 0.00 | 修改费，单位元，精确到小数点后两位 |
| deliveryChangeDiffFee | String | 否 | 4.00 | 配送信息变更差价，单位元，精确到小数点后两位 |
| modifyStatus | Integer | 否 | 2 | 修改状态：1-修改中；2-成功；3-失败 |
PaotuiOrderExtra字段说明
| 名称 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| reduceFee | String | 否 | 2.00 | 优惠金额，单位元，精确到小数点后两位 |
| remark | String | 否 | 用户使用了支付红包减2元 | 备注 |
# 9.1.跑腿订单状态枚举
| 订单状态编码 | 订单状态说明 |
|---|---|
| 1 | 提单 |
| 10 | 已支付 |
| 20 | 已取消 |
| 90 | 已完成 |
# 9.2.跑腿配送状态枚举
| 配送状态编码 | 配送状态说明 |
|---|---|
| 1 | 待接单 |
| 10 | 已接单 |
| 15 | 已到店 |
| 20 | 已取货 |
| 40 | 已送达 |
| 100 | 已取消 |
← 订单详情查询 订单员工消费汇总查询 →