蚂蚁校服征订系统

微信原生客服会话（小程序里那个 open-type="contact" 按钮）是平台可以单独封掉的能力：一旦被判违规，家长点进去没有任何反应，我们这边收不到任何通知。
微信客服走企业微信，是另一条独立通道，不依赖那项能力。下面两项都填了家长端才会调它；只填一项或都不填，小程序自动回落到「拨打电话 + 意见反馈」。
家长回复的消息在企业微信 App → 微信客服里看，可以把客服账号分给多个同事轮班。

客服电话与客服微信二维码在「站点设置 → 联系信息」里维护； 意见反馈是小程序自带的页面，走我们自己的接口，不经过微信客服能力，封不掉，后台在「意见反馈」里看和回复。

V3 是微信「订单管理-订单信息录入」的接入前提：下单时 description 会带上商品详情（商品名+尺码+数量），并上报 goods_detail。
三项凭据在微信商户平台 → 账户中心 → API安全 获取：API 证书（下载得到 apiclient_cert.pem / apiclient_key.pem，并显示证书序列号）、APIv3 密钥（自行设置 32 位）。
私钥文件请放到网站目录之外的服务器路径，后台只保存路径、不保存内容，也不会回显任何密钥。
怎么改一项已经配好的凭据：明文框（AppID、商户号、回调地址、证书序列号、公钥 ID）里显示的就是当前值，直接改成新值即可，清空再保存就是删除；密钥 / 路径这类不回显的项，留空表示「不改」，要换新值就填新值，要删掉就点该项右边的「清除」。路径类配置会写明服务器上到底找不找得到这个文件，「已配置，但找不到文件」和「未配置」是两种不同的修法。
「验证微信支付身份」有两种模式，只能选一种：老商户号是平台证书（下面两项留空即可，系统自动下载证书验签）；2024-09 之后开号的商户是微信支付公钥（API 安全页会写「当前验证模式：公钥」，平台证书显示「已失效」），必须在「管理公钥」里下载 pub_key.pem 上传、并把页面上的公钥 ID 填进上面两格 —— 少这一份公钥，下单、查单、退款、支付回调都会报「响应验签失败」。
不确定是哪种？点下面的支付自检，它会直接告诉你微信这次回的是哪种序列号、卡在哪一步。

按《商家自营类小程序运营规范》，实物订单必须把发货信息录入微信平台，否则货款一直冻结无法结算；用户在微信服务通知里看到的发货消息也来自这里。
· 填了物流单号 → 按实体物流上报，物流公司需能从「顺丰 / 中通 / 圆通 / 申通 / 韵达 / 京东 / EMS / 德邦 / 极兔」等常用快递中识别；
· 未填物流单号（学校集中发放）→ 按用户自提上报，只带商品说明，同样视为已发货。
同步失败会在订单上留痕，可在订单列表用「重推」按钮再次上报（微信侧一个支付单只能录入一次，重复上报会覆盖）。

家长扫员工专属码绑定学校时就把订单归给他，下单当时按这里的比例（或员工自己的单独比例）快照进订单。
· 这里改的只影响之后新下的单，历史订单永远保持下单当时的比例，改回来对不上账的情况不会有；
· 绩效不算钱、不自动发放，只在「绩效结算」里生成结算单供线下打款核对。

1. 小程序后台 → 功能 → 订单管理 → 订单信息录入：录入商品详情页 Path pages/product-detail/product-detail?id=xx 与订单详情页 Path pages/order-detail/order-detail?id=xx；
2. 小程序后台 → 支付与交易 → 订单管理：确认交易类型为「物流快递 / 用户自提」，否则发货录入接口会报类目不支持；
3. 商户平台 → 产品中心 → 商品详情：如提示缺少信息，按后台指引补齐；
4. 上述 Path 需与小程序已发布页面的真实路径一致，未发布时先用体验版验证。

收件地址留空 = 退货退款与换货整体不开放：家长端申请页只显示「仅退款」，后台审核退货退款与换货时也会被拦下，避免家长申请了却不知道寄到哪。
到校单的新件由学校统一发放，但旧件仍然寄到上面这个地址——学校不负责验收与再寄。

「可申请售后天数」从发货 / 到校取货那一刻起算，超过后退货退款与换货不再开放（仅退款在未发货时仍可申）；填 0 为不限。
「家长寄回天数」从审核通过起算，超时未填单号的售后单会自动关闭（读列表与详情时懒触发，不需要定时任务；也可在「售后管理」点「清理超时」手动跑一次）。
两个值只能填 0 或正整数，它们直接决定家长端的拒绝文案，写成「半个月」会让判定变得看不懂。

后台页面连续这么多分钟没有任何鼠标移动、按键、滚动或触摸动作，就自动退出登录、退回登录页。
同一个时限在服务端也会独立判一次（按「这个账号最后一次请求」算），所以就算有人把页面晾着不动、或者根本不用你这套界面，手里的登录凭证一样会过期；前端这份计时只是让人不用点一次失败的查询才知道自己早就掉线了。
填 0 表示不自动退出，只适合投屏看板这类只读展示；日常运营建议 15～60 分钟。只能填 0 或 5～1440，保存后立刻生效，不用重新登录。

点下面的一键添加，系统会自己去微信的公共模板库里挑一个字段最全的模板选到本小程序，并把「模板字段 ↔ 系统数据」对应好，不用再到公众平台复制模板 ID。
如果提示公共模板列表为空：先在微信公众平台「设置 - 基本设置 - 服务类目」添加类目，例如生活服务 > 百货/超市/便利店，保存类目后回来重新点一次。
这套模板接口微信只开放给已认证的非个人主体小程序：刚注册、还没通过认证（或个人主体）的账号点「一键添加」会返回 48001 api unauthorized，这不是本系统的 bug，认证通过后无需改动即可使用。
一次性订阅需要家长在小程序支付前授权，未授权时下发会记为「跳过」，不影响下单与发货。