# 订单管理 本文档面向自研商家和 ISV 服务商，覆盖订单管理模块从查询、处理、发货到结算的完整接入流程。 ## 开发前准备 - **权限与凭证**：商家自研可直接调用，使用小店 access_token；第三方服务商需获得商家对 `权限集 ID：131`（订单管理 + 发货接口）的授权，使用 authorizer_access_token。电子面单接口的权限配置详见 [物流发货 - 开发指南](/doc/store/shop/guide/logistics/delivery) - **消息推送配置**：需配置消息推送回调 URL（配置一次即可接收所有事件回调），本模块涉及 8 个事件通知。详见 [消息通知（回调）说明](/doc/store/shop/dev_before/message_push) ## 接入流程 ### 阶段一：订单查询与同步 商家接入后首先对接订单查询接口，实现订单数据同步。 ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[事件] 订单下单
channels_ec_order_new"] --> B["[API] 获取订单详情
getorder"] C["[API] 获取订单列表
getorderlist"] --> B D["[API] 订单搜索
searchorder"] --> B B --> E[同步到商家系统] style E fill:#ffffff,stroke:#0ab8a6,color:#666666 ``` 推荐通过事件通知驱动订单同步，减少轮询开销。[API] [获取订单列表 / getorderlist](/doc/store/shop/API/channels-shop-order/api_getorderlist) 适合全量/增量拉取，[API] [订单搜索 / searchorder](/doc/store/shop/API/channels-shop-order/api_searchorder) 适合按条件检索。 ### 阶段二：待发货阶段的订单处理 ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[事件] 订单支付成功
channels_ec_order_pay"] --> B[待发货] B --> C["[API] 修改订单备注
changemerchantnotes"] B --> D["[API] 修改订单地址
changeorderaddress"] B --> F[进入发货流程] style B fill:#ffffff,stroke:#0ab8a6,color:#666666 style F fill:#ffffff,stroke:#0ab8a6,color:#666666 ``` [API] [修改订单价格 / changeorderprice](/doc/store/shop/API/channels-shop-order/api_changeorderprice) 仅在**待付款**状态下可用，支付后不可改价。[API] [修改订单地址 / changeorderaddress](/doc/store/shop/API/channels-shop-order/api_changeorderaddress) 为商家主动修改，用户申请修改需通过 [API] [同意用户修改收货地址申请 / acceptorderaddressmodifyapply](/doc/store/shop/API/channels-shop-order/api_acceptorderaddressmodifyapply) 审批。 ### 阶段三：发货流程 订单进入待发货状态后，需通过电子面单取号、打印、发货完成履约。物流发货和电子面单打印的完整接入流程已有独立文档，此处不再重复说明： - [物流发货 - 开发指南](/doc/store/shop/guide/logistics/delivery)：地址配置、运费模板、电子面单取号、发货、补发货等完整链路 - [电子面单打印组件 - 开发指南](/doc/store/shop/guide/logistics/ewaybill)：WebSocket 连接打印组件、面单打印对接 发货完成后，订单状态流转回本模块： - 发货后触发 [事件] [订单发货 / channels_ec_order_deliver](/doc/store/shop/notify/order_callback/channels_ec_order_deliver)，其中 `finish_delivery=0` 表示部分发货，`=1` 表示全部发货完成 - 多包裹场景需多次调用发货接口，每次都会触发发货事件 ### 阶段四：收货与结算 ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[事件] 订单确认收货
channels_ec_order_confirm"] --> B[等待结算] B --> C["[事件] 订单结算成功
channels_ec_order_settle"] C --> D[资金到账] style B fill:#ffffff,stroke:#0ab8a6,color:#666666 style D fill:#ffffff,stroke:#0ab8a6,color:#666666 ``` [事件] [订单确认收货 / channels_ec_order_confirm](/doc/store/shop/notify/order_callback/channels_ec_order_confirm) 包含 `confirm_type` 字段区分用户主动确认（1）和超时自动确认（2）。结算完成后可通过资金结算接口查询流水。 ## 订单状态流转 ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A[待付款 10] -->|用户支付| B[待发货 20] A -->|用户取消/超时| F[已取消 250] A -->|送礼场景| H[礼物待收下 12] A -->|一起买| I[待成团 13] H -->|收礼成功| B H -->|未收下取消| G[订单取消 200] I -->|成团成功| B I -->|未成团取消| G B -->|部分发货| C[部分发货 21] B -->|全部发货| D[待收货 30] C -->|剩余发货完成| D D -->|用户确认/超时| E[完成 100] E -->|全部售后完成| G[订单取消 200] ``` > 订单状态值说明详见 [API] [获取订单详情 / getorder](/doc/store/shop/API/channels-shop-order/api_getorder) 返回参数中的 `order.status` 枚举。 ## 按需接入场景 以下功能按业务需要选择接入，非必接： ### 用户修改收货地址 用户下单后申请修改地址时，通过 [事件] [订单其他信息更新 / channels_ec_order_ext_info_update](/doc/store/shop/notify/order_callback/channels_ec_order_ext_info) 事件（type=4）感知，商家调用 [API] [同意用户修改收货地址申请 / acceptorderaddressmodifyapply](/doc/store/shop/API/channels-shop-order/api_acceptorderaddressmodifyapply) 或 [API] [拒绝用户修改收货地址申请 / rejectorderaddressmodifyapply](/doc/store/shop/API/channels-shop-order/api_rejectorderaddressmodifyapply) 处理。 ### 发货前更换 SKU 用户申请换款时，通过 [事件] [订单其他信息更新 / channels_ec_order_ext_info_update](/doc/store/shop/notify/order_callback/channels_ec_order_ext_info) 事件（type=9）感知，商家调用 [API] [同意待发货前更换sku请求 / approvepreshipmentchangesku](/doc/store/shop/API/channels-shop-order/api_approvepreshipmentchangesku) 或 [API] [拒绝待发货前更换sku请求 / rejectpreshipmentchangesku](/doc/store/shop/API/channels-shop-order/api_rejectpreshipmentchangesku) 处理。也可通过 [API] [获取所有待发货前更换sku待处理请求 / getpreshipmentchangeskuwaithandlelist](/doc/store/shop/API/channels-shop-order/api_getpreshipmentchangeskuwaithandlelist) 主动查询。 ### 隐私号与地址解密 订单默认返回脱敏的手机号和地址信息。需要完整信息时： - [API] [解密订单中的详细收货信息 / decodesensitiveinfo](/doc/store/shop/API/channels-shop-order/api_decodesensitiveinfo)：解密脱敏后的收货信息 - [API] [申请查看订单真实号码 / applyrealnumber](/doc/store/shop/API/channels-shop-order/api_applyrealnumber)：申请查看真实手机号（需审核） - [API] [订单再次申请虚拟号 / applyvirtualnumberagain](/doc/store/shop/API/channels-shop-order/api_applyvirtualnumberagain)：虚拟号过期后重新获取 - [API] [订单虚拟号延期 / delayvirtualnumber](/doc/store/shop/API/channels-shop-order/api_delayvirtualnumber)：延长虚拟号有效期 ### 礼物订单 礼物订单的核心信息可通过 [API] [获取订单详情 / getorder](/doc/store/shop/API/channels-shop-order/api_getorder) 获取，关键字段如下： | 字段 | 说明 | |------|------| | `is_present` | 是否礼物订单 | | `present_giver_openid` / `present_giver_unionid` | 赠送者身份（注意：`order.openid` 为**收礼者**） | | `present_send_type` | 礼物单类型（0-普通单聊 / 1-普通群聊 / 2-公众号送礼 / 3-视频号送礼 / 4-企微单聊 / 5-企微群聊 / 7-小程序送礼 / 8-评价抽奖送礼 / 9-橱窗送礼 / 10-见面礼） | | `present_note` | 礼物订单留言 | | `present_order_id_str` | 礼物订单 ID（`present_order_id` 已废弃） | | `order_present_info.is_b2c_free_present` | 是否商家免费赠送（无需付款场景，此时 `pay_info` 仅返回 `payment_method`） | > 礼物订单特有状态：**12（礼物待收下）**，收礼成功后流转为待发货（20）。 补充接口： - [API] [礼物订单新增备注信息 / presentnote](/doc/store/shop/API/channels-shop-order/api_presentnote)：为礼物订单新增备注 - [API] [获取礼物单的子单列表 / getpresentsuborder](/doc/store/shop/API/channels-shop-order/api_getpresentsuborder)：获取礼物订单下的子订单 ### 质检管理 部分类目（珠宝玉石、生鲜等）的订单需在发货前完成质检。可通过 [API] [获取订单详情 / getorder](/doc/store/shop/API/channels-shop-order/api_getorder) 的 `delivery_info.quality_inspect_type` 字段判断质检类型（0-无需质检 / 1-珠宝玉石类 / 2-生鲜类）。完整的质检接入流程详见独立文档： - [质检管理 - 开发指南](qic)：质检仓配置、送检信息绑定、质检码打印、生鲜质检上传等完整链路 ## 前端对接说明 订单管理为纯服务端接口，无前端组件对接需求。商家需在自有系统中实现订单管理界面。 ## 相关运营文档 - 详见成长中心：[订单发货三步搞定](https://store.weixin.qq.com/chengzhang/webdoc/wiki/9144/9856d41269780faf/growth_center_lesson_for_store/5?bpath=%252Fhome%252Flesson-shop) ## 常见问题 FAQ **Q：如何高效同步订单数据？** A：推荐「事件驱动 + 定时全量」组合方案。监听 [事件] [订单下单 / channels_ec_order_new](/doc/store/shop/notify/order_callback/channels_ec_order_new) 等事件通知实时同步，同时每日通过 [API] [获取订单列表 / getorderlist](/doc/store/shop/API/channels-shop-order/api_getorderlist) 全量对账补漏。 **Q：订单中的收货地址信息为什么是脱敏的？** A：出于隐私保护，订单返回的手机号和地址默认脱敏。需调用 [API] [解密订单中的详细收货信息 / decodesensitiveinfo](/doc/store/shop/API/channels-shop-order/api_decodesensitiveinfo) 获取完整信息。 **Q：虚拟号过期了怎么办？** A：可调用 [API] [订单再次申请虚拟号 / applyvirtualnumberagain](/doc/store/shop/API/channels-shop-order/api_applyvirtualnumberagain) 重新获取，或在过期前调用 [API] [订单虚拟号延期 / delayvirtualnumber](/doc/store/shop/API/channels-shop-order/api_delayvirtualnumber) 延长。 **Q：事件通知推送失败怎么办？** A：微信服务器会自动重试。建议商家同时配置定时拉取作为兜底。 ## 附录：接口速查表 ### 订单管理 API 接口 | 中文名 / 英文名 | 请求方式 | 功能说明 | |----------------|---------|---------| | [获取订单列表](/doc/store/shop/API/channels-shop-order/api_getorderlist) / getorderlist | `POST /channels/ec/order/list/get` | 全量/增量拉取订单列表 | | [获取订单详情](/doc/store/shop/API/channels-shop-order/api_getorder) / getorder | `POST /channels/ec/order/get` | 获取单个订单的完整信息 | | [订单搜索](/doc/store/shop/API/channels-shop-order/api_searchorder) / searchorder | `POST /channels/ec/order/search` | 按条件检索订单 | | [修改订单价格](/doc/store/shop/API/channels-shop-order/api_changeorderprice) / changeorderprice | `POST /channels/ec/order/price/update` | 待付款状态下修改订单价格 | | [修改订单备注](/doc/store/shop/API/channels-shop-order/api_changemerchantnotes) / changemerchantnotes | `POST /channels/ec/order/merchantnotes/update` | 修改商家备注信息 | | [修改订单地址](/doc/store/shop/API/channels-shop-order/api_changeorderaddress) / changeorderaddress | `POST /channels/ec/order/address/update` | 商家主动修改收货地址 | | [修改物流信息](/doc/store/shop/API/channels-shop-order/api_changedeliveryinfo) / changedeliveryinfo | `POST /channels/ec/order/deliveryinfo/update` | 修改已发货订单的物流信息 | | [同意用户修改收货地址申请](/doc/store/shop/API/channels-shop-order/api_acceptorderaddressmodifyapply) / acceptorderaddressmodifyapply | `POST /channels/ec/order/addressmodify/accept` | 同意用户的地址修改申请 | | [拒绝用户修改收货地址申请](/doc/store/shop/API/channels-shop-order/api_rejectorderaddressmodifyapply) / rejectorderaddressmodifyapply | `POST /channels/ec/order/addressmodify/reject` | 拒绝用户的地址修改申请 | | [礼物订单新增备注信息](/doc/store/shop/API/channels-shop-order/api_presentnote) / presentnote | `POST /channels/ec/order/presentnote/add` | 为礼物订单新增备注 | | [获取礼物单的子单列表](/doc/store/shop/API/channels-shop-order/api_getpresentsuborder) / getpresentsuborder | `POST /channels/ec/order/presentsuborder/get` | 获取礼物订单下的子订单 | | [获取所有待发货前更换sku待处理请求](/doc/store/shop/API/channels-shop-order/api_getpreshipmentchangeskuwaithandlelist) / getpreshipmentchangeskuwaithandlelist | `POST /channels/ec/order/preshipmentchangesku/get` | 查询用户换款待处理请求 | | [同意待发货前更换sku请求](/doc/store/shop/API/channels-shop-order/api_approvepreshipmentchangesku) / approvepreshipmentchangesku | `POST /channels/ec/order/preshipmentchangesku/approve` | 同意用户的换款请求 | | [拒绝待发货前更换sku请求](/doc/store/shop/API/channels-shop-order/api_rejectpreshipmentchangesku) / rejectpreshipmentchangesku | `POST /channels/ec/order/preshipmentchangesku/reject` | 拒绝用户的换款请求 | | [解密订单中的详细收货信息](/doc/store/shop/API/channels-shop-order/api_decodesensitiveinfo) / decodesensitiveinfo | `POST /channels/ec/order/sensitiveinfo/decode` | 解密脱敏后的收货信息 | | [申请查看订单真实号码](/doc/store/shop/API/channels-shop-order/api_applyrealnumber) / applyrealnumber | `POST /channels/ec/order/realnumber/apply` | 申请查看真实手机号 | | [查看订单真实号审核状态](/doc/store/shop/API/channels-shop-order/api_getrealnumberviewaudit) / getrealnumberviewaudit | `POST /channels/ec/order/realnumberviewaudit/get` | 查询真实号申请审核结果 | | [订单再次申请虚拟号](/doc/store/shop/API/channels-shop-order/api_applyvirtualnumberagain) / applyvirtualnumberagain | `POST /channels/ec/order/virtualnumber/applyagain` | 虚拟号过期后重新获取 | | [订单虚拟号延期](/doc/store/shop/API/channels-shop-order/api_delayvirtualnumber) / delayvirtualnumber | `POST /channels/ec/order/virtualnumber/delay` | 延长虚拟号有效期 | | [添加待认证的手机号](/doc/store/shop/API/channels-shop-order/api_privatenumberaddphone) / privatenumberaddphone | `POST /channels/ec/merchant/privatenumber/addphone` | 添加待认证的商家手机号 | | [获取短信验证码](/doc/store/shop/API/channels-shop-order/api_privatenumbersendverifycode) / privatenumbersendverifycode | `POST /channels/ec/merchant/privatenumber/sendverifycode` | 获取手机认证验证码 | | [获取小店手机号认证状态](/doc/store/shop/API/channels-shop-order/api_privatenumbergetshopphone) / privatenumbergetshopphone | `POST /channels/ec/merchant/privatenumber/getphone` | 查询手机号认证状态 | ### 事件通知 | 中文名 / 英文名 | 事件标识 | 功能说明 | |----------------|---------|---------| | [订单下单](/doc/store/shop/notify/order_callback/channels_ec_order_new) / channels_ec_order_new | `Event: channels_ec_order_new` | 用户下单时通知 | | [订单取消](/doc/store/shop/notify/order_callback/channels_ec_order_cancel) / channels_ec_order_cancel | `Event: channels_ec_order_cancel` | 订单取消时通知 | | [订单支付成功](/doc/store/shop/notify/order_callback/channels_ec_order_pay) / channels_ec_order_pay | `Event: channels_ec_order_pay` | 用户完成支付时通知 | | [订单待发货](/doc/store/shop/notify/order_callback/channels_ec_order_wait_shipping) / channels_ec_order_wait_shipping | `Event: channels_ec_order_wait_shipping` | 订单进入待发货状态时通知 | | [订单发货](/doc/store/shop/notify/order_callback/channels_ec_order_deliver) / channels_ec_order_deliver | `Event: channels_ec_order_deliver` | 订单发货时通知 | | [订单确认收货](/doc/store/shop/notify/order_callback/channels_ec_order_confirm) / channels_ec_order_confirm | `Event: channels_ec_order_confirm` | 用户确认收货时通知 | | [订单结算成功](/doc/store/shop/notify/order_callback/channels_ec_order_settle) / channels_ec_order_settle | `Event: channels_ec_order_settle` | 订单结算完成时通知 | | [订单其他信息更新](/doc/store/shop/notify/order_callback/channels_ec_order_ext_info) / channels_ec_order_ext_info_update | `Event: channels_ec_order_ext_info_update` | 订单附属信息变更时通知 | ![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（1条） 2026 年 04 月 03 日新增 订单管理 - 开发指南