快递轨迹

介绍

给发货功能补上查物流：默认免费跳转查询，接了自己的查询接口就能在站内直接看轨迹时间线。

功能清单

什么都不填就能用（0 成本）

1. 装好即用：后台订单详情填物流公司 + 运单号，前台「我的订单」点「查看」直接跳到聚合查询页（Parcels App / 17TRACK 等），自动识别承运商，新标签打开不弹窗。
2. 不用注册、没有额度限制、长期免费——走的是各家公开查询页，单号已经自动拼进地址。
3. 查询渠道清单可编辑：勾选启用哪个、直接改地址、加自己的渠道。地址里 {no} 是单号、{lang} 按店铺语言自动变中英文段。
4. 四种匹配方式：只勾具体快递（编码对得上才跳它官网，对不上的走聚合）/ 只勾一个聚合（所有单号都走它）/ 勾多个（从上往下先精确匹配，对不上的落最前面的聚合）/ 全不勾（走系统默认兜底页）。

接了自己的接口 → 站内看轨迹时间线

1. 填好接口后，「查看」从「跳外部」变成「站内弹窗显示轨迹时间线」，顾客不用离开你的网站。
2. 可以并存多家接口，按承运商编码匹配：发货时物流编码填对哪个就用哪个接口，对不上的单号走「通用聚合」（编码留空那条）。
3. 顺序即优先级：从上到下依次尝试，第一个查到结果的就采用，点箭头可上下调。
4. 内置模板直接选：17TRACK（只填 token，自动登记单号再取轨迹）、顺丰丰桥（自动签名，只填客户编码 + 校验码）、顺丰国际 IUOP（自动换 token + AES 加密 + 签名，四个凭据）、阿里云云市场（任意商品，只粘地址 + 填 AppCode）、RapidAPI（两个请求头）、Ship24、AfterShip、快递100、蓝笛。
5. 任何有 HTTP 接口的服务商都能自己接入：填地址、请求体，变量用 {no} {code} {key} {secret}，返回 JSON 自动找「时间 + 状态」字段。
6. 同一单号 N 分钟内只真查一次（防平台锁单、也省钱）；要立刻重查就勾「强制重查」，并告诉你这次结果是缓存还是真查。
7. 适用站点标记：中文轨迹的源标「仅中文站点」、英文的标「仅外语站点」，同一个源所有语言就保持「通用」。
8. 任何一步失败都自动降级回官网直查，绝不给顾客一个空白页；失败时把承运商原话一起显示出来。
9. 自带接口自测：填完当场测一次，报错直接说明是哪一步（没填地址 / HTTP 状态 / 解析不出轨迹 / 调用异常）。

后台轨迹看板

1. 侧栏「订单 → 快递轨迹」独立看板：8 列看全部订单的物流进度。
2. 最多显示最近 300 单，上面有搜索框找单，点订单号跳订单详情。
3. 一键批量抓取轨迹，抓取过程显示「抓取中… N 单」。
4. 开了之后每天进后台自动抓一批「已发货未完成」的订单，不用配服务器定时任务。

轨迹状态阶段：自己定义进度到哪一步

1. 阶段数量不限、名字随意（已下单 → 已出库 → 已揽收 → 已到达目的地 → 签收…），点「编辑」改，改完立即生效。
2. 每个阶段配一组触发关键词：轨迹描述里出现任意一个词，订单就落到这个阶段。
3. 任何语言的轨迹描述都能命中：阶段名称和关键词都能逐语言填，还能一键翻译。
4. 同时命中多个阶段时取最靠后的一个；一条都没命中但有轨迹 = 运输中。
5. 最后一个阶段是「完成段」，命中它那条轨迹的时间会被记为签收时间。

前台「确认收货」按钮，把话说清楚

1. 先把容易误会的事讲明：前台那个按钮跟快递轨迹没有任何关系，不是系统查到了签收，是顾客自己承认收到了货。
2. 可以整体隐藏，只能由你在后台改订单状态。
3. 可以加「点击前提示」，防止顾客误点之后变已完成、退不回来。
4. 按钮文案可改（默认用「确认收货」，比系统默认的「已签收」准确），支持逐语言填写与一键翻译。
5. 作用范围：前台「我的订单」列表页 + 订单详情页；列表里的拆单子订单同样受这两个开关控制。
6. 插件永远不会替你自动把订单改完成。

需要的工具

• 不填任何接口也能用：走各家公开查询页，0 成本、不用注册。
• 想让顾客在站内直接看到轨迹时间线时，才需要在插件配置页填接口凭据；用 17TRACK 只要一个 token。
• 常用平台怎么填，配置页里有逐个平台的填法说明（阿里云云市场、RapidAPI、Ship24、17TRACK）。

兼容环境

纯插件实现，不改系统任何文件，卸载后网站自动恢复原样。

展示位置

后台订单详情、侧栏「订单 → 快递轨迹」看板；前台「我的订单」列表与订单详情。

更新版本

v2.9.7（2026-10-31 更新）