# 小程序发货信息管理服务
根据《商家自营类小程序运营规范》,特定类型的小程序需要在平台完成发货信息录入及确认收货流程后方可进行资金结算。
开发者可以通过该接入服务，完成商品发货信息录入、提醒用户确认收货、在小程序内调起确认收货组件等功能，提升发货信息录入效率，优化用户体验。
# 一、小程序内确认收货
# 二、相关 API 接口
| 接口名称 | 请求路径 | 描述 |
|---|---|---|
| 发货信息录入 | /wxa/sec/order/upload_shipping_info | 用户交易后，默认资金将会进入冻结状态，开发者在发货后，需要在小程序平台录入相关发货信息，平台会将发货信息以消息的形式推送给购买的微信用户 |
| 发货信息合单录入 | /wxa/sec/order/upload_combined_shipping_info | 用户交易后，默认资金将会进入冻结状态，开发者在发货后，需要在小程序平台录入相关发货信息，平台会将发货信息以消息的形式推送给购买的微信用户 |
| 查询订单发货状态 | /wxa/sec/order/get_order | 可以通过交易单号或商户号+商户单号来查询该支付单的发货状态 |
| 查询订单列表 | /wxa/sec/order/get_order_list | 可以通过支付时间、支付者openid或订单状态来查询订单列表 |
| 确认收货提醒 | /wxa/sec/order/notify_confirm_receive | 如你已经从你的快递物流服务方获知到用户已经签收相关商品，可以通过该接口提醒用户及时确认收货，以提高资金结算效率，每个订单仅可调用一次 |
| 消息跳转路径设置 | /wxa/sec/order/set_msg_jump_path | 如你已经在小程序内接入平台提供的确认收货组件，可以通过该接口设置发货消息及确认收货消息的跳转动作，用户点击发货消息时会直接进入你的小程序订单列表页面或详情页面进 |
| 查询小程序是否已开通发货信息管理服务 | /wxa/sec/order/is_trade_managed | 调用该接口可查询小程序账号是否已开通小程序发货信息管理服务（已开通的小程序，可接入发货信息管理服务API进行发货管理） |
| 查询小程序是否已完成交易结算管理确认 | /wxa/sec/order/is_trade_management_confirmation_completed | 调用该接口可查询小程序账号是否已完成交易结算管理确认（即对小程序已关联的所有商户号都完成了订单管理授权或解绑） |
| 特殊发货报备 | /wxa/sec/order/opspecialorder | 调用该接口可以对未发货的订单进行特殊发货报备，适用于预售商品订单和测试订单 |
| 品牌申请 | /wxa/sec/famousbrand/apply | 本接口用于小程序品牌申请 |
| 小程序品牌申请状态查询 | /wxa/sec/famousbrand/get_status | 本接口用于查询小程序品牌申请状态 |
| 小程序交易类型变更申请 | /wxa/sec/order/setwxatradetypecgi | 本接口用于小程序开发者提交交易类型变更申请 |
# 三、相关消息推送
当产生交易或订单结算时，微信服务器会向开发者服务器、第三方平台方的消息与事件接收 URL 以 POST 的方式推送相关事件。注意，需要先接入 微信小程序消息推送服务 才能接收事件。
# 事件类型
| 事件类型 | 说明 |
|---|---|
| trade_manage_remind_access_api | 提醒接入发货信息管理服务API |
| trade_manage_remind_shipping | 提醒需要上传发货信息 |
| trade_manage_order_settlement | 订单将要结算或已经结算 |
| wxa_trade_controlled | 小程序需接入订单发货管理 |
# 消息推送时机
wxa_trade_controlled 事件：
- 小程序需接入订单发货管理时
trade_manage_remind_access_api 事件：
- 小程序完成交易结算管理确认时
- 小程序产生第一笔交易时
- 已产生交易但从未发货的小程序，每天一次
trade_manage_remind_shipping 事件：
- 曾经发过货的小程序，订单超过48小时未发货时
trade_manage_order_settlement 事件：
- 订单完成发货时
- 订单结算时
# 字段说明
trade_manage_remind_access_api 事件字段说明
| 参数 | 类型 | 说明 |
|---|---|---|
| ToUserName | string | 小程序的原始 ID |
| FromUserName | string | 发送方账号（一个 OpenID，此时发送方是系统账号） |
| CreateTime | number | 消息创建时间 （整型），时间戳 |
| MsgType | string | 消息类型，为固定值 "event" |
| Event | string | 事件类型 |
| msg | string | 消息文本内容 |
trade_manage_remind_shipping 事件字段说明
| 参数 | 类型 | 说明 |
|---|---|---|
| ToUserName | string | 小程序的原始 ID |
| FromUserName | string | 发送方账号（一个 OpenID，此时发送方是系统账号） |
| CreateTime | number | 消息创建时间 （整型），时间戳 |
| MsgType | string | 消息类型，为固定值 "event" |
| Event | string | 事件类型 |
| transaction_id | string | 微信支付订单号 |
| merchant_id | string | 商户号 |
| sub_merchant_id | string | 子商户号 |
| merchant_trade_no | string | 商户订单号 |
| pay_time | number | 支付成功时间，秒级时间戳 |
| msg | string | 消息文本内容 |
trade_manage_order_settlement 事件字段说明
| 参数 | 类型 | 说明 |
|---|---|---|
| ToUserName | string | 小程序的原始 ID |
| FromUserName | string | 发送方账号（一个 OpenID，此时发送方是系统账号） |
| CreateTime | number | 消息创建时间 （整型），时间戳 |
| MsgType | string | 消息类型，为固定值 "event" |
| Event | string | 事件类型 |
| transaction_id | string | 支付订单号 |
| merchant_id | string | 商户号 |
| sub_merchant_id | string | 子商户号 |
| merchant_trade_no | string | 商户订单号 |
| pay_time | number | 支付成功时间，秒级时间戳 |
| shipped_time | number | 发货时间，秒级时间戳 |
| estimated_settlement_time | number | 预计结算时间，秒级时间戳。发货时推送才有该字段 |
| confirm_receive_method | number | 确认收货方式：1. 手动确认收货；2. 自动确认收货。结算时推送才有该字段 |
| confirm_receive_time | number | 确认收货时间，秒级时间戳。结算时推送才有该字段 |
| settlement_time | number | 订单结算时间，秒级时间戳。结算时推送才有该字段 |
wxa_trade_controlled 事件字段说明
| 参数 | 类型 | 说明 |
|---|---|---|
| ToUserName | string | 小程序的原始 ID |
| FromUserName | string | 发送方账号（一个 OpenID，此时发送方是系统账号） |
| CreateTime | number | 消息创建时间 （整型），时间戳 |
| MsgType | string | 消息类型，为固定值 "event" |
| Event | string | 事件类型 |
| msg | string | 消息文本内容 |