后端即时通讯【免费下载链接】easywechat 一个 PHP 微信 SDK项目地址https://gitcode.com/gh_mirrors/ea/easywechat点击查看免费下载本文基于 EasyWeChat 5.x 文档中的《小程序发货信息管理》章节完整讲解微信小程序订单发货管理能力在 EasyWeChat 中的调用方式。你将掌握发货信息录入、合单录入、发货状态查询、确认收货提醒、消息跳转路径设置以及交易管理开通状态查询等 7 类接口的实际用法与参数结构可直接照搬代码接入自己的小程序订单履约流程。能力概览与前置准备发货信息管理微信官方能力对应小程序订单发货管理用于让小程序商家在发货后主动将物流信息上报给微信从而支撑订单发货状态透出、确认收货提醒、交易保障等能力。EasyWeChat 5.x 文档docs/src/5.x/mini-program/shipping.md将这一能力封装为$app-shipping服务对象共暴露以下接口方法用途对应微信能力uploadShippingInfo($data)发货信息录入单笔订单发货后上报物流信息uploadCombineShippingInfo($data)发货信息合单录入一笔交易拆成多包裹/多订单时合并上报getOrder($data)查询订单发货状态查询某笔订单是否已上报、物流单号等getOrderList()查询订单列表分页拉取已录入发货信息的订单notifyConfirmReceive($data)确认收货提醒向用户推送确认收货提醒setMsgJumpPath($data)消息跳转路径设置设置订单消息点击后跳转的小程序页面isTradeManaged()查询是否已开通发货信息管理服务开通状态校验isTradeCompleted()查询是否已完成交易结算管理确认交易结算管理确认状态校验在开始调用前需要先初始化小程序应用实例。按 小程序实例化说明 的约定本页所有示例中的$app均指通过Factory::miniProgram($config)创建的实例use EasyWeChat\Factory; $config [ app_id wx3cf0f39249eb0exx, secret f1c242f4f28f735d4687abb469072axx, // 下面为可选项 // 指定 API 调用返回结果的类型array(default)/collection/object/raw/自定义类名 response_type array, log [ level debug, file __DIR__./wechat.log, ], ]; $app Factory::miniProgram($config);初始化完成后即可通过$app-shipping-方法名(...)调用发货信息管理的全部接口。需要注意的是这些接口底层依赖小程序access_token完成身份认证从仓库源码看小程序应用通过 src/MiniApp/Application.php 中的getAccessToken()与createClient()构建AccessTokenAwareClient所有 API 请求都会自动携带并管理访问令牌开发者无需手工传参当令牌过期时客户端还会依据errcode/error字段自动判定失败并触发重试可参考 src/Kernel/HttpClient/AccessTokenAwareClient.php 的实现。因此你只需关注业务参数本身。发货信息录入接口当用户下单支付成功后商家完成发货时应调用uploadShippingInfo上报该笔订单的物流信息。这是整个发货管理流程中最核心的接口。$data [ order_key [ order_number_type 1, mchid , out_trade_no ], logistics_type 4, delivery_mode 1, shipping_list [ [ tracking_no 323244567777, express_company DHL, item_desc 微信红包抱枕*1个, contact [ consignor_contact 189****1234, receiver_contact 189****1234 ], ], ], upload_time 2022-12-15T13:29:35.12008:00, payer [ openid oUpF8uMuAJO_M2pxb1Q9zNjWeS6o ] ]; $app-shipping-uploadShippingInfo($data);关键参数说明order_key订单标识用于定位是哪一笔交易。order_number_type订单号类型示例中取1代表以微信支付订单号作为标识其余取值含义以微信官方文档为准mchid商户号out_trade_no商户订单号当以商户订单号作为标识时使用。logistics_type物流类型示例中取4即其他物流类型实际业务中请根据微信官方枚举定义选择实体物流、虚拟物流或线上物流等类型。delivery_mode发货方式示例中为1用于区分商家自行寄件或快递公司揽收等发货模式。shipping_list包裹明细可一次上报多个包裹每个包裹包含tracking_no运单号express_company快递公司编码示例为DHL即国际快递 DHLitem_desc商品描述如微信红包抱枕*1个contact联系方式含consignor_contact发货人联系方式与receiver_contact收货人联系方式。upload_time发货时间采用 ISO 8601 格式的带时区时间串如2022-12-15T13:29:35.12008:00建议在服务端生成当前发货时间后原样传入。payer支付用户openid为付款用户在小程序中的唯一标识用于微信侧关联该笔交易与用户。业务场景示例用户在微信内完成支付后订单进入待发货状态仓库出库、快递揽收后服务端生成运单号调用本接口将out_trade_no或微信支付transaction_id、运单号、快递公司、发货/收货人联系方式一并上报微信侧即可在订单详情中展示物流进度。发货信息合单录入接口当一笔支付交易被拆分成多个包裹例如分仓发货、预售与现货分批发货或需要跨订单合并上报时使用uploadCombineShippingInfo$data [ order_key [ order_number_type 1, mchid , out_trade_no ], sub_orders [ order_key [ order_number_type 1, transaction_id , mchid , out_trade_no ], logistics_type 4, delivery_mode 1, shipping_list [ [ tracking_no 323244567777, express_company DHL, item_desc 微信红包抱枕*1个, contact [ consignor_contact 189****1234, receiver_contact 189****1234 ], ], ], ], upload_time 2022-12-15T13:29:35.12008:00, payer [ openid oUpF8uMuAJO_M2pxb1Q9zNjWeS6o ] ]; $app-shipping-uploadCombineShippingInfo($data);与单笔录入相比本接口的差异集中在顶层order_key用于标识父交易即用户实际支付的那笔订单sub_orders中按子订单再次给出order_key此处可以看到还支持transaction_id字段即微信支付交易号并各自携带独立的logistics_type、delivery_mode与shipping_list实现一笔支付、多单多包裹的灵活上报upload_time与payer的语义与单笔录入一致位于顶层。适用场景用户在商城一次下单多件商品系统拆分为两个包裹分别由不同仓库发出此时先以支付订单为父单再分别为每个子订单写入各自的运单信息用户端即可看到完整的分包裹物流轨迹。查询订单发货状态商家或运营后台需要确认某笔订单是否已完成发货上报、查看当前发货状态时调用getOrder$data $app-shipping-getOrder([ transaction_id xxx ]);参数说明transaction_id微信支付交易号微信支付成功后由微信下发的支付单号。接口返回该订单的发货状态信息如是否已上报、上报时间、运单号等可将其用于发货后校验上报是否成功、订单管理后台的状态回显、以及对未发货订单进行补录提醒。查询订单列表需要批量拉取已录入发货信息的订单时调用getOrderList$data $app-shipping-getOrderList();该接口支持分页拉取当前小程序已上报发货信息的订单列表适合在管理后台做发货记录列表页定时任务同步发货状态、导出对账、异常订单巡检等场景均可复用此接口。如需分页请在$data中按微信官方接口要求补充分页参数页面大小、起始位置等具体以微信官方文档为准。确认收货提醒接口当包裹被签收或商家希望主动提醒用户确认收货时调用notifyConfirmReceive$data [ transaction_id 42000020212023112332159214xx, received_time ]; $app-shipping-notifyConfirmReceive($data);参数说明transaction_id微信支付交易号示例为一串完整的支付单号received_time收货时间ISO 8601 格式示例中为空字符串表示按接口要求可选的场景下留空。业务价值主动触发确认收货提醒可以缩短订单的确认收货周期帮助商家更快完成交易结算。通常在物流轨迹显示已签收后的一段时间内调用本接口。消息跳转路径设置接口微信侧推送的订单相关消息如发货通知、确认收货提醒默认展示在订单卡片中通过setMsgJumpPath可以指定用户点击消息后的落地页$data [ path pages/goods/order_detail?idxxxx, ]; $app-shipping-setMsgJumpPath($data);参数说明path小程序页面路径可携带 query 参数示例为pages/goods/order_detail?idxxxx即订单详情页并带上订单 ID。使用建议将落地页设置为带订单 ID 参数的订单详情页用户从发货消息进入后即可直接查看对应订单的物流与售后信息提升转化与体验。查询服务开通与交易结算管理确认状态这两个查询接口用于在接入前或日常运营中校验小程序账号的状态// 查询小程序是否已开通发货信息管理服务 $app-shipping-isTradeManaged(); // 查询小程序是否已完成交易结算管理确认 $app-shipping-isTradeCompleted();isTradeManaged()判断当前小程序是否已开通发货信息管理服务。若未开通上报发货信息前需要先在微信公众平台完成开通否则接口可能返回错误。isTradeCompleted()判断小程序是否已完成交易结算管理确认。这是交易保障链路中的一环确认状态会影响部分交易能力的可用性。建议在启动发货上报任务前先调用这两个接口做前置校验未开通/未确认时给出明确的引导提示避免运行时才发现权限问题。调用链路与源码佐证虽然 5.x 文档中$app-shipping是一组高层的便捷方法但其底层仍然复用 EasyWeChat 小程序模块统一的请求链路。从当前仓库 src/MiniApp/Application.php 可以看到该链路的几个关键事实统一网关所有请求默认以https://api.weixin.qq.com/为base_uri发货信息管理相关接口同样走该网关AccessToken 自动注入createClient()返回AccessTokenAwareClient将getAccessToken()产出的令牌注入每个请求令牌失效如返回errcode非 0 或含error字段时由failureJudge判定并配合AccessTokenExpiredRetryStrategy自动重试响应类型可配置response_type配置项决定接口返回array默认/collection/object/raw等形态本文示例均按默认数组形态编写可插拔客户端若需在测试中模拟接口可参考 src/Kernel/Traits/MockableHttpClient.php 替换 HTTP 客户端方便编写单元测试。因此在生产环境中你无需关心access_token的获取、缓存与刷新细节只需保证Factory::miniProgram($config)的app_id与secret正确即可放心调用上述 8 个方法。实践建议与注意事项参数合法性order_key中的mchid、out_trade_no/transaction_id必须与微信支付侧的真实交易数据一致否则无法关联到订单时间格式upload_time、received_time使用 ISO 8601 带时区格式如2022-12-15T13:29:35.12008:00建议服务端统一生成避免客户端时区差异导致上报失败多包裹场景优先合单一笔支付对应多个运单时使用uploadCombineShippingInfo一次性上报避免重复录入导致订单状态错乱开通前置校验正式上线前调用isTradeManaged()与isTradeCompleted()确认账号状态未开通时先到微信公众平台完成相应设置发货状态回查录入后可通过getOrder回查上报结果结合getOrderList定期巡检确保每笔已支付订单都完成了发货信息上报消息落地页提前通过setMsgJumpPath配置好订单详情落地页让用户从发货、收货提醒消息直达订单上下文。以上即 EasyWeChat 5.x 小程序发货信息管理的全部接口用法。将示例中的业务参数替换为你的真实订单数据即可快速完成小程序端发货上报—状态查询—收货确认的完整履约闭环。赞分享后端即时通讯【免费下载链接】easywechat 一个 PHP 微信 SDK项目地址https://gitcode.com/gh_mirrors/ea/easywechat点击查看免费下载相关推荐EasyWeChat 小程序订阅消息完整接入指南模板管理与消息下发实战EasyWeChat 小程序订阅消息完整接入指南模板管理与消息下发实战 导读 本指南聚焦 EasyWeChatPHP 微信 SDK5.x 版本中 小程序订后端即时通讯EasyWeChat 小程序模板消息使用指南从模板库管理到消息下发EasyWeChat 小程序模板消息使用指南从模板库管理到消息下发 模板消息是微信小程序触达用户的经典通道本文基于 EasyWeChat一个 PHP 微信后端即时通讯如何本地安装 AppFlowy20 分钟跑通开源 AI 协作文档工作区如何本地安装 AppFlowy20 分钟跑通开源 AI 协作文档工作区 AppFlowy 是免费开源的 AI 协作工作区把文档、数据库和 AI 聊天装进一个前端后端企业应用内容协同知识管理AI 应用上一篇PP-OCRv6_tiny_det常见问题解答开发者最关心的20个问题下一篇Duix.Avatar完整教程5步跑通本地AI数字人免费生成数字分身口播视频创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
中国电信CRM设计系统：从客户旅程到数据模型的完整方案 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/24 14:45:10
Swift Package Manager 依赖编辑实战：swift package edit 命令完全指南 Swift Package Manager 依赖编辑实战：swift package edit 命令完全指南 【免费下载链接】swift-package-manager The Package Manager for the Swift Programming Language 项目地址: https://gitcode.com/gh_mirrors/sw/swift-package-manager
swift packag… · 2026/9/24 14:45:10
Keystone 6 代码复用实战：List、字段与 Hooks 的类型安全抽取模式 后端 【免费下载链接】keystone The superpowered headless CMS for Node.js — built with GraphQL and React 项目地址： https://gitcode.com/gh_mirrors/key/keystone 点击查看 免费下载 导读
在 Keystone 6 中，随着项目增长，多个列表&a… · 2026/9/24 14:45:10
nom 8.0 演进全解析：从 CHANGELOG 看 Rust 解析器组合框架的十年架构变迁 开发工具 【免费下载链接】nom Rust parser combinator framework 项目地址： https://gitcode.com/gh_mirrors/no/nom 点击查看 免费下载 nom 是 Rust 生态中最具代表性的解析器组合框架（parser combinator framework）之一，本仓库… · 2026/9/24 15:32:44
Semi Design 图标（Icon）组件完全指南：图标集体系、尺寸旋转、双色多色着色与自定义方案 前端UI组件设计系统 【免费下载链接】semi-design 🚀A modern, comprehensive, flexible design system and React UI library, AI-friendly built-in.🎨Provide 3000 Design Tokens, easy to build your design system. Make Semi Design to Any Design… · 2026/9/24 15:32:38
Pixy学习控制台：HUB75点阵屏驱动与ESP32-S3实战 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/24 15:32:31
使用 RPM 打包 Miller（mlr）：从 spec 文件到源 RPM 与二进制 RPM 的完整指南 CLI数据分析 【免费下载链接】miller Miller is like awk, sed, cut, join, and sort for name-indexed data such as CSV, TSV, and tabular JSON 项目地址： https://gitcode.com/gh_mirrors/mi/miller 点击查看 免费下载 导读
Miller（命令行工具为 m… · 2026/9/24 15:32:25
YOLO 完全指南：YOLO 目标检测实战系列 《YOLO 目标检测实战系列 内容介绍》 本系列由 9 篇文档组成，按“认知 → 训练 → 调优 → 评测 → 工程落地 → 数据标注”的逻辑层层递进，兼顾理论直觉与工程实操： 具体可查看 YOLO 完全指南
① 认知与原理
《YOLO介绍》 从“为什么工业… · 2026/9/24 15:32:19
基于YOLOv8的渔船作业监控系统：从环境搭建到边缘部署全流程 简介：这是一套面向计算机、人工智能、自动化等专业学生与教师的毕业设计级项目资源，围绕YOLOv8实现渔船作业监控系统，可用于毕设、课程设计、大作业或项目立项演示。压缩包共97个文件，约24.21MB，以70个Python源码文件为… · 2026/9/24 0:00:13
1D-CNN时间序列建模实战：从Conv1d原理到工业落地 简介：面向时间序列数据建模的一维卷积神经网络完整实现，适合深度学习入门者及需要快速验证时序模型的研究者，能够从音频、文本、传感器或股价等序列中挖掘局部特征与时间依赖。压缩包体积很小，只有3KB，内含3个Python脚… · 2026/9/24 0:00:26
柔软的L：汉语语流中被忽视的舌肌张力控制 1. 这个“L”不是字母表里的L，而是舌尖上的L最近在几个方言群和语音教学社群里，反复看到有人发一句：“也说字母L：柔软的长舌”。初看以为是英语发音课笔记，点开才发现全是方言爱好者、播音系学生、语言康复师甚至戏曲演… · 2026/9/24 0:00:44
