# 订单管理 - 开发指南

本文档面向自研商家和 ISV 服务商，覆盖订单管理模块从查询、处理、发货到结算的完整接入流程。

# 开发前准备

• 权限与凭证：商家自研可直接调用，使用小店 access_token；第三方服务商需获得商家对以下权限集的授权，使用 authorizer_access_token：
  • 订单管理 + 发货接口：权限集 ID：131
  • 电子面单接口：权限集 ID：130 / 159 / 192（三选一）
• 消息推送配置：需配置消息推送回调 URL（配置一次即可接收所有事件回调），本模块涉及 8 个事件通知。详见 消息通知（回调）说明

# 接入流程

# 阶段一：订单查询与同步

商家接入后首先对接订单查询接口，实现订单数据同步。

推荐通过事件通知驱动订单同步，减少轮询开销。[API] 获取订单列表 / getorderlist 适合全量/增量拉取，[API] 订单搜索 / searchorder 适合按条件检索。

# 阶段二：待发货阶段的订单处理

[API] 修改订单价格 / changeorderprice 仅在待付款状态下可用，支付后不可改价。[API] 修改订单地址 / changeorderaddress 为商家主动修改，用户申请修改需通过 [API] 同意用户修改收货地址申请 / acceptorderaddressmodifyapply 审批。

# 阶段三：发货流程（必须使用电子面单）

微信小店要求商家必须使用平台电子面单进行发货，不支持手动填写快递单号。完整发货链路为：查询面单账号 → 预取号 → 取号 → 打印面单 → 调用发货接口。

注意：以下接口来自物流发货模块，详细参数说明请参考 物流发货 API 接口文档。

# 3-1 电子面单取号与打印

各接口说明：

• [API] 查询面单账号信息 / ewaybill_biz_account_get：查询商家已开通的快递公司网点和面单账号，确认面单库存
• [API] 电子面单预取号 / ewaybill_biz_order_precreate：校验取号参数，获取全局唯一的 ewaybill_order_id，用于后续正式取号
• [API] 电子面单取号 / ewaybill_biz_order_create：正式取号，获取快递单号 waybill_id
• [API] 获取打印报文 / ewaybill_biz_print_get：获取面单打印内容，传给打印组件
• [API] 打印成功通知 / ewaybill_biz_order_print：打印完成后通知平台出单结果
• [API] 电子面单子件追加 / ewaybill_biz_order_addsuborder：子母单场景（顺丰、德邦、京东等）追加子件

# 3-2 调用发货接口

• [API] 订单发货 / senddelivery：传入电子面单取号获得的 waybill_id 和 delivery_id（快递公司编码）完成发货。部分发货（finish_delivery=0）后继续发货剩余商品时，仍调用此接口
• [API] 订单补发货 / delivery_compensation：针对已通过 senddelivery 完成发货的商品，出现漏发、拆分包裹、坏损、赠品等情况时调用
• 发货后 [事件] 订单发货 / channels_ec_order_deliver 事件中 finish_delivery=0 表示部分发货，=1 表示全部发货完成
• 多包裹场景需多次取号、多次调用发货接口，每次都会触发发货事件通知
• 发货后如需修改物流信息（如更换快递公司、更正快递单号），调用 [API] 修改物流信息 / changedeliveryinfo

# 阶段四：收货与结算

[事件] 订单确认收货 / channels_ec_order_confirm 包含 confirm_type 字段区分用户主动确认（1）和超时自动确认（2）。结算完成后可通过资金结算接口查询流水。

# 订单状态流转

订单状态值说明详见 [API] 获取订单详情 / getorder 返回参数中的 order.status 枚举。

# 按需接入场景

以下功能按业务需要选择接入，非必接：

# 用户修改收货地址

用户下单后申请修改地址时，通过 [事件] 订单其他信息更新 / channels_ec_order_ext_info_update 事件（type=4）感知，商家调用 [API] 同意用户修改收货地址申请 / acceptorderaddressmodifyapply 或 [API] 拒绝用户修改收货地址申请 / rejectorderaddressmodifyapply 处理。

# 发货前更换 SKU

用户申请换款时，通过 [事件] 订单其他信息更新 / channels_ec_order_ext_info_update 事件（type=9）感知，商家调用 [API] 同意待发货前更换sku请求 / approvepreshipmentchangesku 或 [API] 拒绝待发货前更换sku请求 / rejectpreshipmentchangesku 处理。也可通过 [API] 获取所有待发货前更换sku待处理请求 / getpreshipmentchangeskuwaithandlelist 主动查询。

# 隐私号与地址解密

订单默认返回脱敏的手机号和地址信息。需要完整信息时：

• [API] 解密订单中的详细收货信息 / decodesensitiveinfo：解密脱敏后的收货信息
• [API] 申请查看订单真实号码 / applyrealnumber：申请查看真实手机号（需审核）
• [API] 订单再次申请虚拟号 / applyvirtualnumberagain：虚拟号过期后重新获取
• [API] 订单虚拟号延期 / delayvirtualnumber：延长虚拟号有效期

# 礼物订单

• [API] 礼物订单新增备注信息 / presentnote：为礼物订单新增备注
• [API] 获取礼物单的子单列表 / getpresentsuborder：获取礼物订单下的子订单

# 生鲜质检

• [API] 上传生鲜质检信息 / submitfreshinspectinfo：生鲜类订单发货前上传质检打包信息

# 前端对接说明

订单管理为纯服务端接口，无前端组件对接需求。商家需在自有系统中实现订单管理界面。

# 相关运营文档

• 详见成长中心：订单发货三步搞定

# 常见问题 FAQ

Q：如何高效同步订单数据？ A：推荐「事件驱动 + 定时全量」组合方案。监听 [事件] 订单下单 / channels_ec_order_new 等事件通知实时同步，同时每日通过 [API] 获取订单列表 / getorderlist 全量对账补漏。

Q：订单中的收货地址信息为什么是脱敏的？ A：出于隐私保护，订单返回的手机号和地址默认脱敏。需调用 [API] 解密订单中的详细收货信息 / decodesensitiveinfo 获取完整信息。

Q：虚拟号过期了怎么办？ A：可调用 [API] 订单再次申请虚拟号 / applyvirtualnumberagain 重新获取，或在过期前调用 [API] 订单虚拟号延期 / delayvirtualnumber 延长。

Q：事件通知推送失败怎么办？ A：微信服务器会自动重试。建议商家同时配置定时拉取作为兜底。

# 附录：接口速查表

# 订单管理 API 接口

# 发货相关 API 接口（物流发货模块）

详细参数请参考 物流发货 API 接口文档。

# 事件通知