获取订单
按订单号、手机号、营种、营期、营员、状态等条件获取订单列表。返回字段与 订单变更通知 中的订单快照基本一致,可用于主动同步或核对回调数据。
取消订单
取消未完成支付等可取消状态的订单。需同时校验订单号与会员手机号。
核销订单
将已支付订单核销为已结营。需同时校验订单号与会员手机号,且订单当前为已支付状态。
修改订单手机号
将订单归属会员手机号更换为新号码。支持一次传多个订单号。
导入订单退款
对 导入订单 产生的线下导入订单直接办理退款:sid 为空 / 0 = 整单全退;sid 有值 = 仅退该营员(部分退)。退款金额由调用方显式传入,直接落库、不走财务审批流。
获取订单营员信息
获取某订单下全部营员的报名表字段(含当前值、控件类型与可选值)。编辑请使用 编辑订单营员。
订单数据结构
获取订单 返回的 data] 中的单个订单对象,与 [订单变更通知 推送的 request_data 订单快照,采用同一结构,本文档统一说明。
重新获取合同签名
获取订单 返回的 signpdfurl(电子合同链接)在私有域名加签成功时为有效期 7 天的临时签名链接,过期后可通过本接口按订单 ID 重新获取,无需重新构造其它查询条件。
导入订单
按订单批量导入报名数据,一笔订单可携带多个营员(儿童营员 + 亲子营成人营员),也可暂不传营员(students 与 big_students 同时缺省 / 为空)先创建订单,后续再通过 编辑/添加营员 补录。导入时逐单独立校验、独立处理,成功后自动生成订单、绑定营员并按需记录支付。订单内营员的表单字段需与 获取营种导入模版 返回的字段定义一致。
编辑/添加订单营员
对 导入订单 产生的订单做营员级维护:type=1(默认)编辑现有营员,按 ordernum + sid 全量覆盖该营员字段,sid 不变;type=2 **新增一名营员**到订单,受订单购买人数上限约束。营员字段键与 获取营种导入模版 返回的 formfields.child/big 的 name 一致,两种模式的落库口径均与 导入订单 完全同构。
更换营期
对 导入订单 产生的线下导入订单更换营期:传入新的 plu(营期规格),把订单从原营期迁移到新营期。允许跨营种(新 plu 的 pid 可与原订单不同),直接落库、不走换营审批流(不产生 order_exchange 记录)。