# 小程序发货信息管理服务(#微信小程序商城订单发货)

根据《商家自营类小程序运营规范》,特定类型的小程序需要在平台完成发货信息录入及确认收货流程后方可进行资金结算。

# 小程序发货信息管理服务(#微信小程序商城订单发货)

开发者可以通过该接入服务,完成商品发货信息录入、提醒用户确认收货、在小程序内调起确认收货组件等功能,提升发货信息录入效率,优化用户体验。

一、发货信息录入接口

二、发货信息合单录入接口

三、查询订单发货状态

四、查询订单列表

五、确认收货提醒接口

六、消息跳转路径设置接口

七、查询小程序是否已开通发货信息管理服务

八、查询小程序是否已完成交易结算管理确认

九、相关消息推送

十、特殊发货报备

小程序确认收货组件接入说明

用户交易后,默认资金将会进入冻结状态,开发者在发货后,需要在小程序平台录入相关发货信息,平台会将发货信息以消息的形式推送给购买的微信用户。

如果你已经录入发货信息,在用户尚未确认收货的情况下可以通过该接口修改发货信息,但一个支付单只能更新一次发货信息,请谨慎操作。

如暂时没有完成相关API的对接开发工作,你也可以登陆小程序的后台,通过发货信息管理页面手动录入发货信息。

  1. 根据指定的订单单号类型,采用不同参数给指定订单上传物流信息:

    (1). 商户侧单号形式(枚举值1),通过下单商户号和商户侧单号确定一笔订单

    (2). 微信支付单号形式(枚举值2),通过微信支付单号确定一笔订单

  2. 发货模式根据具体发货情况选择:

    (1). 统一发货(枚举值1),一笔订单统一发货,只有一个物流单号。

    (2). 分拆发货(枚举值2),一笔订单分拆发货,包括多个物流单号。

  3. 物流公司编码,参见获取运力 id 列表get_delivery_list。

  4. 上传时间,用于标识请求的先后顺序,如果要更新物流信息,上传时间必须比之前的请求更新,请按照 RFC 3339 格式填写。

  5. 分拆发货仅支持使用物流快递发货,一笔支付单最多分拆成 10 个包裹。

  6. 以下情况将视为重新发货,每笔支付单仅有一次重新发货机会。

    (1). 对已完成发货的支付单再次调用该 API。

    (2). 使用该 API 修改发货模式或物流模式。

HTTPS 调用

第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:142

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

请求数据示例

返回数据示例

用户交易后,默认资金将会进入冻结状态,开发者在发货后,需要在小程序平台录入相关发货信息,平台会将发货信息以消息的形式推送给购买的微信用户。

如果你已经录入发货信息,在用户尚未确认收货的情况下可以通过该接口修改发货信息,但一个支付单只能更新一次发货信息,请谨慎操作。

如暂时没有完成相关API的对接开发工作,你也可以登陆小程序的后台,通过发货信息录入页面手动录入发货信息。

  1. 根据指定的订单单号类型,采用不同参数给指定订单上传物流信息,注意子单和主单的订单单号类型必须一致:

    (1). 商户侧单号形式(枚举值1),通过下单商户号和商户侧单号确定一笔订单

    (2). 微信支付单号形式(枚举值2),通过微信支付单号确定一笔订单

  2. 发货模式根据具体发货情况选择:

    (1). 统一发货(枚举值1),一笔订单统一发货,只有一个物流单号。

    (2). 分拆发货(枚举值2),一笔订单分拆发货,包括多个物流单号。

  3. 物流公司编码,参见获取运力 id 列表get_delivery_list。

  4. 上传时间,用于标识请求的先后顺序,如果要更新物流信息,上传时间必须比之前的请求更新,请按照RFC 3339格式填写。

  5. 分拆发货仅支持使用物流快递发货,一笔支付单最多分拆成 10 个包裹。

  6. 以下情况将视为重新发货,每笔支付单仅有一次重新发货机会。 (1). 对已完成发货的支付单再次调用该 API。

    (2). 使用该 API 修改发货模式或物流模式。

HTTPS 调用

第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:142

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

请求数据示例

返回数据示例

你可以通过交易单号或商户号+商户单号来查询该支付单的发货状态。

HTTPS 调用

第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:142

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

请求数据示例

返回数据示例

你可以通过支付时间、支付者openid或订单状态来查询订单列表。

HTTPS 调用

第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:142

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

请求数据示例

返回数据示例

如你已经从你的快递物流服务方获知到用户已经签收相关商品,可以通过该接口提醒用户及时确认收货,以提高资金结算效率,每个订单仅可调用一次。

  1. 通过交易单号或商户号+商户单号来指定订单。
  2. 只有物流类型为物流快递时才能进行提醒。
  3. 签收时间由商户传入,在给用户发送提醒消息时会显示签收时间,签收时间必须在发货时间之后。

HTTPS 调用

第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:142

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

请求数据示例

返回数据示例

如你已经在小程序内接入平台提供的确认收货组件,可以通过该接口设置发货消息及确认收货消息的跳转动作,用户点击发货消息时会直接进入你的小程序订单列表页面或详情页面进行确认收货,进一步优化用户体验。

  1. 如设置为空路径或小程序中不存在的路径,将仍然跳转平台默认的确认收货页面,不会进入你的小程序。

  2. 平台会在路径后面增加支付单的 transaction_id、merchant_id、merchant_trade_no 作为query参数,如果存在二级商户号则还会再增加 sub_merchant_id 参数,开发者可以在小程序中通过onLaunch等方式获取。

  3. 如你需要在path中携带自定义的query参数,请注意与上面的参数进行区分。

HTTPS 调用

第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:142

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

请求数据示例

返回数据示例

调用该接口可查询小程序账号是否已开通小程序发货信息管理服务(已开通的小程序,可接入发货信息管理服务API进行发货管理)。

服务商被授权了 18 或 142 权限集时才能进行查询。

HTTPS 调用

请求参数

返回参数

请求数据示例

返回数据示例

调用该接口可查询小程序账号是否已完成交易结算管理确认(即对小程序已关联的所有商户号都完成了订单管理授权或解绑)。已完成订单管理授权的商户号,产生的订单均需要通过发货信息管理服务进行发货。

服务商被授权了 18 或 142 权限集时才能进行查询。

HTTPS 调用

请求参数

返回参数

请求数据示例

返回数据示例

当产生交易或订单结算时,微信服务器会向开发者服务器、第三方平台方的消息与事件接收 URL 以 的方式推送相关事件。注意,需要先接入 微信小程序消息推送服务 才能接收事件。

事件:

  • 小程序完成账期授权时
  • 小程序产生第一笔交易时
  • 已产生交易但从未发货的小程序,每天一次

事件:

  • 曾经发过货的小程序,订单超过48小时未发货时

事件:

  • 订单完成发货时
  • 订单结算时

事件字段说明

事件字段说明

事件字段说明

调用该接口可以对未发货的订单进行特殊发货报备,适用于预售商品订单和测试订单。发货时效超过15天的订单需报备为预售商品订单,报备后用户将收到预计发货时间的通知。测试订单报备后无需发货,资金会在一段时间内自动退回给用户。

  1. 通过微信支付单号或商户单号来指定订单。
  2. 预售商品订单预计发货时间必须在订单支付时间的15天后,不得超过330天。

HTTPS 调用

第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:142

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

请求参数

返回参数

请求数据示例

返回数据示例

转载请说明出处 内容投诉内容投诉
九幽软件 » # 小程序发货信息管理服务(#微信小程序商城订单发货)