跳到主要内容
版本:v2.0

订单数据结构

获取订单 返回的 data[] 中的单个订单对象,与 订单变更通知 推送的 request_data 订单快照,采用同一结构,本文档统一说明。

订单基础信息

字段类型说明
order_idNumber订单 ID
ordernumString订单号
pidNumber营种 ID
period_idNumber营期 ID
extra_product_idNumber外部营种 ID(营种列表配置)
product_nameString营种名称
current_product_nameString最新营种名称
periodString参营营期,如 2023/05/18-2023/05/19
per_nameString场次名称,如「下午场」(若有)
sku_strString规格
statusString订单状态文案
numberString人数
small_number / big_numberNumber大小营人数(若有)
unit_priceString单价
order_priceNumber订单金额
have_payNumber已支付金额
have_pay_moneycardString已支付储值卡金额
annual_convert_moneyNumber年卡报名折算费用(单次价值 × 净核销次数,用于确认收入,不计入资金流)
createtimeString创建时间
user_phoneString会员手机号
user_nameString会员姓名
user_idcardString会员身份证号
unionidString会员开放平台 unionid
staff_nameString员工名称
staff_idString员工 ID
type_listArray营种分类,元素含 idname
sign_pdf_titleString电子合同名称(签署成功后)
sign_pdf_urlString电子合同地址(签署成功后)

优惠字段

字段类型说明
discount_moneyNumber优惠总额,等于 discount_list 各项 price 之和
discount_listArray优惠明细,仅返回金额大于 0 的项,元素结构见「优惠明细 discount_list[]」

优惠明细 discount_list[]

字段类型说明
fieldString优惠项标识,取值见下表
nameString优惠名称
priceNumber优惠金额

field 的取值:

字段说明
full_reduction_money满减优惠
moneycard_sale储值卡优惠
sale_price限期优惠
card_money优惠券优惠
full_money多人满减优惠
vip_level_price等级优惠
invited_money邀请减免
agio_moneyVIP折扣
parent_child_discount亲子优惠
old_price老营员优惠
bed_price拼床优惠
cut_price砍价优惠
coin_price虚拟币优惠
annual_card_discount_money年卡优惠
order_agio订单优惠

示例:

"discount_money": 150,
"discount_list": [
{ "field": "full_reduction_money", "name": "满减优惠", "price": 50 },
{ "field": "agio_money", "name": "VIP折扣", "price": 100 }
]

拼团相关

字段类型说明
team_idNumber拼团 ID,大于 0 表示存在拼团
team_statusNumber拼团状态:1 进行中,2 成功,3 失败
team_order_listArray拼团订单明细,元素含 order_idnumberordernum

拆单 / 合并

字段类型说明
cut_order_infoObject拆单关联信息,含 master_order_id(被拆分金额)、cut_order_id(拆分生成的新订单)、order_num
merge_order_infoObject合并关联信息,含 master_order_id(合并目标订单)、be_merge_order_id(被合并且取消的订单)、order_num
提示

需根据当前 order_id 判断本订单在拆单/合并中扮演的角色。

营员 students[]

字段类型说明
sidString营员 ID,退营订单编辑订单营员获取营员评价 等接口的 sid 入参即取此值
nameString姓名
phoneString手机号
idcardString证件号
idcard_typeString证件类型:1 身份证,2 护照,3 其他,4 台胞证,5 回乡证,6 港澳通行证,7 港澳居民居住证,8 旅行证
birthdayString出生日期
heightString身高
weightString体重
sizeString尺码(若有)

换营记录 exchenge_list[]

字段类型说明
old_pid / new_pidString原/新 营种 ID
old_period_id / new_period_idString原/新 营期 ID
old_pname / new_pnameString原/新 营种名称
old_period / new_periodString原/新 营期
old_extra_product_id / new_extra_product_idString原/新 外部营种 ID
addtimeString换营时间

支付 / 退款 / 备注

支付明细 pay_list[]

字段类型说明
addtimeString支付时间
moneyString现金支付
moneycardString储值卡支付
tranction_idString微信/支付宝支付单号

退营/退款明细 refund_list[]

字段类型说明
team_idNumber拼团 ID(系统自动退款时可能大于 0)
addtimeString退款时间
moneyString现金退款
moneycardString储值卡退款
refund_typesString退款类型:全部退营 / 部分退营 / 仅退款
refund_idNumber信多帮退款单 ID
descString退款原因

订单备注 remarks_list[]

字段类型说明
contentString备注内容
addtimeString添加时间

外部订单备注 out_remarks_list[]

remarks_list 中类型为外部备注的子集,元素结构相同。

团组 cut_group_info

字段类型说明
team_nameString团名称
team_nick_nameString团昵称
group_nameString组名称
group_nick_nameString组昵称
cut_idString分团 ID
group_idString分组 ID

连报订单

字段类型说明
more_countNumber连报订单数
more_all_payString连报累计现金支付
more_all_pay_moneycardString连报累计储值卡支付
more_info_listArray连报订单简版明细,含 order_idordernumpnameperiodpidperiod_idhave_payhave_pay_moneycard