要上传购物订单物流信息，需调用`uploadShippingInfo`接口并按以下规范传参： ### 关键参数配置： 1. **订单标识** - `order_key`必须包含以下至少一组参数： - `mchid`+`out_trade_no`（商户号+商户订单号） - `transaction_id`（微信支付单号） 2. **物流信息** - `express_company`：从微信官方物流编码列表选取（如顺丰对应"SF"） - `tracking_no`：物流单号（1-128字符） ### 批量配送配置示例（统一发货模式）： ```json { "order_key": { "mchid": "商户号", "out_trade_no": "MERCHANT_ORDER_ID" }, "delivery_mode": 1, "shipping_list": [ { "tracking_no": "EXPRESS_NO", "express_company": "SF" } ], "upload_time": "2023-08-25T15:00:00+08:00" } ``` ### 注意事项： 1. **统一发货模式（delivery_mode=1）** - 仅需提交1条物流记录 - 禁止包含`item_list`字段 2. **特殊物流要求** - 使用顺丰物流时建议加密填写： - `consignor_contact`（寄件人电话，格式：189****1234） - `receiver_contact`（收件人电话） 3. **时间格式** - `upload_time`必须使用RFC3339格式（示例：`"2023-08-25T15:00:00+08:00"`） 参考文档： - [上传物流信息接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/shopping-order/normal-shopping-detail/uploadShippingInfo.html)

微信URLLink不支持永久有效，最长有效期限制为30天。设置方式如下： 1. **有效期参数选择**： - 使用`expire_type=1`表示按天数计算有效期 - 设置`expire_interval=30`（最大允许值） 2. **注意事项**： - 到期后链接将失效不可访问 - 建议设置到期前提醒机制（如提前3天通知用户） - 若需长期使用，建议定期调用接口重新生成链接 替代方案：如需长期有效链接，可使用小程序普通网页链接（需自行处理版本兼容问题） 参考文档： [生成URLLink接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/qrcode-link/url-link/generateUrlLink.html)

微信支付功能在开发工具正常但真机报错，需按以下步骤排查： **核心问题定位** 1. **商户号绑定验证** - 检查商户号是否与小程序AppID正确绑定 - 确认商户主体与小程序主体一致（企业主体需完全匹配） 2. **类目合规性检查** - 支付场景需与小程序申报的服务类目一致 - 虚拟支付需符合《小程序运营规范》中"文娱-在线课程"等特定类目要求 3. **环境配置验证** - 正式版必须使用生产环境配置（检查wx.requestPayment调用参数） - 检查HTTPS协议证书有效性 **备案状态说明** - 备案审核未完成不影响支付功能开通（支付功能仅需完成微信认证） - 备案通过后需重新提交代码审核并发布新版本 **解决方案** 1. 立即检查： - 登录微信商户平台核对商户号绑定状态 - 对照《小程序运营规范》核查支付类目合规性 2. 备案完成后： - 在小程序后台确认备案状态同步 - 重新提交含支付功能的代码审核并发布 参考文档： - [小程序接入指南](https://developers.weixin.qq.com/miniprogramintroduction/) - [特殊场景调试](https://developers.weixin.qq.com/miniprogram/dev/devtools/different.html)

针对getUnlimitedQRCode接口在体验版中的跳转问题，请按以下步骤排查： **核心排查步骤**： 1. **环境参数设置** - 显式设置`env_version: "trial"`（若需指向体验版环境） - 注意：该参数为可选字段，默认值为release（线上环境） 2. **关键参数配置** - 必须设置`check_path: false`（关闭线上页面校验） - 确保`page`参数格式为"pages/detail/detail"（不带参数） - 页面参数应通过`scene`字段传递（需自行解码） 3. **常见故障原因** - 未关闭路径校验：当线上版本无对应页面时会强制跳转首页 - 环境版本混淆：未指定env_version时默认指向线上版本 - 路径格式错误：页面路径需与体验版代码中的实际路径完全一致 **开发调试建议**： 1. 使用开发者工具"通过二维码编译"功能模拟scene参数 2. 检查scene参数解码逻辑： ```javascript Page({ onLoad(query) { const scene = decodeURIComponent(query.scene) } }) ``` **注意事项**： 1. `check_path=false`时允许生成未发布页面，但单日上限6万个 2. 确保体验版已上传包含目标页面的代码包 3. scene参数禁止包含`scancode_time`等系统保留字段 参考文档： [获取不限制的小程序码](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/qrcode-link/qr-code/getUnlimitedQRCode.html)

公众号关注组件的稳定性及使用限制说明如下： ### 一、official-account组件 1. **触发条件** - 必须通过**指定场景值**进入小程序： - 冷启动场景：1011（扫码）、1047（小程序码）、1124（一物一码）等 - 热启动场景：1089（聊天主界面下拉）、1001（发现栏小程序入口）等 - 需在小程序后台关联公众号（同主体或关联主体） 2. **稳定性限制** - 开发版仅支持场景值1011调试（需使用微信Mac版） - 体验版支持全场景展示 - 组件尺寸固定为最小宽度300px、高度84px，每个页面仅允许配置一个 ### 二、替代方案说明 目前微信官方未提供`wx.openOfficialAccountProfile`接口。若需引导用户关注公众号，建议： 1. 通过`official-account`组件实现场景触发式关注 2. 使用``组件跳转公众号文章页（需用户手动关注） ### 共同限制 - 关联公众号必须正常运营且未被封禁 - 小程序与公众号需满足以下关系之一： - 同主体 - 跨主体但已完成关联（最多关联3个非同主体公众号） ### 自查建议 1. 通过`wx.getLaunchOptionsSync()`检查场景值是否符合要求 2. 监听组件`binderror`事件，根据状态码排查问题： - 常见错误码：3（未关联公众号）、5（场景值不匹配） 3. 登录小程序后台检查公众号关联状态 参考文档： [公众号关注组件](https://developers.weixin.qq.com/miniprogram/dev/component/official-account.html)

发货信息接口的订单处理能力分两种情况： 一、普通订单接口（uploadShippingInfo） 1. 仅支持单订单处理 2. 发货模式： - 统一发货：提交1个物流信息（shipping_list数组长度=1） - 分拆发货：支持同一订单提交多个物流信息（shipping_list数组长度≤10） 二、合单订单接口（uploadCombinedShippingInfo） 1. 支持多订单处理 2. 通过sub_orders数组提交多个子订单 3. 每个子订单可独立选择发货模式： - 统一发货：每个子订单对应1个物流信息 - 分拆发货：每个子订单可对应多个物流信息 关键限制： - 普通接口每次调用仅处理1个订单 - 合单接口支持批量处理多个关联订单 参考文档： [上传物流信息接口](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/shopping-order/normal-shopping-detail/uploadShippingInfo.html) [上传合单物流信息接口](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/shopping-order/shopping-detail/uploadCombinedShippingInfo.html)

Android端无法返回第三方App的问题排查要点： 1. **Android回调处理验证**： - 确认已实现`IWXAPIEventHandler`接口并处理`WXLaunchMiniProgram.Resp` - 检查`WXEntryActivity`中是否正确解析`extMsg`参数： ```java public void onResp(BaseResp resp) { if (resp.getType() == ConstantsAPI.COMMAND_LAUNCH_WX_MINIPROGRAM) { WXLaunchMiniProgram.Resp launchResp = (WXLaunchMiniProgram.Resp) resp; String appParameter = launchResp.extMsg; // 此处必须正确获取参数 } } ``` 2. **场景状态验证**： - 通过`wx.getLaunchOptionsSync()`获取实际场景值 - 检查是否触发`invalid scene`错误（场景值非1069时触发） 3. **配置完整性检查**： - 确保AndroidManifest.xml已声明微信回调Activity： ```xml activity android:name=".wxapi.WXEntryActivity" android:exported="true" android:taskAffinity="应用包名" android:launchMode="singleTask"/> ``` 4. **参数传递验证**： - 小程序端需使用标准触发方式： ```html ``` 排查步骤建议： 1. 在Android端添加调试日志，确认收到`COMMAND_LAUNCH_WX_MINIPROGRAM`响应 2. 检查小程序编译模式是否为"正式版"（体验版/开发版可能限制功能） 3. 对比iOS/Android的app-parameter参数格式是否一致 参考文档： [指南/打开App](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html)

根据微信官方文档要求，长期订阅消息目前仅对政务民生、医疗、交通、金融、教育等线下公共服务类目开放。针对访客管理系统场景，建议采用以下解决方案： **替代实施方案** 1. **一次性订阅消息优化** - 在关键交互节点（如提交访客申请时）触发订阅弹窗，通过`wx.requestSubscribeMessage`接口获取授权 - 拆分通知场景为独立模板（如"信息填写提醒"和"申请结果通知"），实现精准推送 - 结合新版一次性订阅消息（无需弹窗）特性，通过支付场景或按钮组件获取推送权限 2. **补充通知渠道** - 启用客服消息接口，在用户48小时内有交互时主动推送通知 - 利用服务通知历史列表功能沉淀重要消息 **自查建议** 1. 确认小程序后台「设置-基本设置-服务类目」是否属于开放范围 2. 在「功能-订阅消息」模块核查已申请模板类型（type字段） 3. 测试消息模板与实际业务场景的匹配度 参考文档： - [订阅消息能力概述](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message-overview.html) - [消息模板使用规范](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message.html)

微信小程序长期推送消息方案需使用长期订阅消息功能，具体实施要点如下： 1. **功能准入条件** - 仅限政务民生、医疗、交通、金融、教育等线下公共服务类目 - 需通过微信开放平台类目资质审核 2. **核心实现流程** - 前端调用`wx.requestSubscribeMessage`获取用户授权 - 服务端使用`subscribeMessage.send`接口发送消息 - 消息推送无时间限制（区别于一次性订阅消息的7天限制） 3. **系统配置要求** - 配置消息推送服务器接收用户订阅/退订事件 - 需建立用户订阅状态管理机制 - 消息模板需通过微信审核且符合规范 4. **关键注意事项** - 禁止发送营销类内容 - 用户主动退订后必须停止推送 - 支持添加消息提醒和语音播报功能 - 需提供可持续的服务场景（如航班延误提醒） 建议通过用户关键行为触发消息（如服务状态变更），保持消息有效性和用户活跃度。 参考文档： [订阅消息功能概述](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message-overview.html) [订阅消息开发指南](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message.html)

小程序HTTPS请求不强制使用443端口，但需满足以下要求： **关键配置要求：** 1. **域名配置规范** - 非标准端口必须在小程序后台显式声明（如配置域名时需包含端口号） - 必须完成ICP备案且证书域名与配置完全匹配 2. **TLS协议要求** - iOS必须支持TLS 1.2及以上版本 - Android需支持TLS 1.2（可向下兼容但建议保持统一） **超时错误排查步骤：** 1. 检查小程序后台域名配置是否包含端口号 2. 确认服务器监听指定端口且防火墙放行 3. 在开发者工具开启"不校验域名"选项进行对比测试 4. 使用curl命令验证接口响应时间： ```bash curl -v -k -X GET https://yourdomain.com:port/api ``` **注意事项：** - 微信云托管服务无需配置端口 - 正式环境必须关闭开发者工具的域名校验选项 - 建议优先使用443端口避免运营商拦截 参考文档： [小程序网络请求规范](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/network.html) [HTTPS证书要求](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/network.html)