01 · GET STARTED

快速开始

注册登录、兑换积分，然后在“快递查询”提交单号，在“我的查询”查看结果。

注册或登录

访问 FrogTracking 官网，使用常用邮箱注册或登录。有邀请码时，注册时填写即可。新用户注册后可联系企业微信领取 500 积分。

兑换积分

向客服获取兑换码，在“积分明细”输入兑换码并点击“兑换”，积分立即到账。

提交查询

进入“快递查询”，选择目标组和承运商，粘贴单号或上传文件后提交。

查看结果

在“我的查询”中按查询组、批次查看轨迹；也可以在“查询统计”里跨组搜索单号。

左侧菜单

快递查询	手动粘贴或上传文件，批量提交单号
临时查询	临时核对一批单号，不进入查询记录
我的查询	按查询组、批次查看和管理所有结果
查询统计	跨查询组统计状态、搜索单号、导出
导出任务	查看导出进度并下载文件
API & Webhook	管理 API 凭证与回调地址（需开通）
积分明细	查看余额与流水，输入兑换码充值
邀请好友	复制邀请码或邀请链接

开始前建议

为不同客户、店铺或日期建立查询组并写好备注，之后查找、重查和导出都会方便很多。

02 · TRACKING

提交快递查询

在“快递查询”粘贴一批单号立即查询，结果保存到所选查询组。

选择目标组：默认是“默认组”，也可以选已有查询组，或选“新建组...”当场创建。
选择承运商：默认“自动识别”，系统按单号格式判断承运商；确定是同一家时也可以直接指定。
粘贴单号：每行一个，或用逗号、空格分隔。空行和重复单号会自动去掉，单次最多 100,000 个。
提交查询：点击“提交查询”后立即提交并扣除积分，没有二次确认，提交前请再核对一遍目标组和单号。

提交结果

提交完成后会弹出“查询提交完成”，显示：

新增单号 / 消耗积分：本次实际新增的单号数和扣除的积分。
已存在跳过：目标组里已有的单号不会重复添加。
识别失败：无法识别承运商的单号，可复制出来核对。
指定的承运商与单号不符：指定了承运商但格式对不上的单号，不会提交。

点击“前往查看”进入对应查询组，查询完成的单号会陆续显示结果。

承运商冲突

如果有单号同时符合多家承运商的格式，系统会弹出“请选择承运商”，此时还没有创建任何单号。为每一组选择一家承运商，或选择“跳过这组”，再点“确认并重新提交”。

支持哪些承运商？

以“承运商”下拉列表为准。列表之外的单号无法识别，会出现在“识别失败”里。

03 · FILE UPLOAD

文件批量上传

已有 Excel 或 CSV 清单时，在“快递查询”切换到“文件上传”。

点击“下载模板文件”，按模板整理数据。
第一行是表头，第一列填运单号；不要有合并单元格或多余的标题行。
需要逐行指定承运商时，增加一列表头为“承运商”的列，填承运商名称、代码或别名；留空的行按页面上选择的承运商处理，页面选“自动识别”时自动识别。
其余列会作为备注保存，在单号卡片和导出文件中显示。
选择目标组后点击“上传文件”。结果弹窗与手动提交相同。

文件要求

推荐使用 .xlsx 或 UTF-8 编码的 .csv。旧版 .xls 文件请先在 Excel 中另存为 .xlsx 再上传。单个文件最多 100,000 个单号。

上传失败时

先检查文件格式、编码、表头和第一列是否为单号；仍无法上传时，保留报错截图并联系客服。

04 · TEMPORARY

临时查询

临时核对一批单号，结果不进入“我的查询”和“查询统计”。

点击“新建临时查询”，可以填写本次备注、选择承运商，再手动输入或上传文件。
手动输入单次最多 5,000 个单号；文件上传与快递查询相同。
按正常规则扣积分，与快递查询共用 30 天内不重复扣费的规则。
结果页可以筛选、批量搜索单号、重新查询单个单号、导出，或点“清空”。

只保留最近一次

新建临时查询会自动清空上一次的全部结果，且无法恢复。需要保留的结果请先导出；需要长期跟踪的单号请用“快递查询”提交。

05 · ORGANIZATION

查询组与批次管理

查询组用于长期分类，批次记录每一次提交。先找到组，再进入批次。

查询组

每个查询组显示单号数、批次数和状态分布；搜索框按查询组备注搜索。
点击“新建查询组”创建，组名最多 64 字，备注最多 200 字；铅笔图标可重命名、编辑备注。
默认组固定在最前，不能删除；快递查询的目标组默认就是默认组。
点击“重查”或“删除”进入多选模式，可一次处理多个查询组。

批次

每次提交自动生成一个批次，以提交时间命名，显示单号数和最后查询时间，可以添加备注。
合并：同一查询组内选择至少 2 个批次，指定保留哪个批次的备注和创建时间，其他批次的单号并入后原批次删除。
移动：批次卡片上的“移动到其他组”，把整个批次连同单号移到另一个查询组。
删除 / 按状态删除：删除选中的批次，或按物流状态、任务状态批量删除该组下的单号。

删除不可撤销

删除查询组、批次或单号后无法恢复。删除前请确认范围，必要时先导出备份。

06 · RESULTS

查询结果与物流状态

进入批次后，可以筛选单号、展开轨迹、翻译成中文。

筛选单号

点击状态条下方的图例，可直接查看该状态的单号。
“批量搜索单号”一次最多粘贴 10,000 个单号；“搜索备注”匹配单号备注。
可按物流商、任务状态筛选；任务状态选“已完成”后，还可以按物流状态筛选。

FrogTracking 单号轨迹详情与翻译 — 展开单号：轨迹已翻译为中文，原文显示在下方

单号详情

单号旁的图标可以复制单号、重新查询、删除；点击卡片展开完整物流轨迹。
点击“翻译”把轨迹翻译成中文，原文显示在译文下方；点击“显示原文”恢复。翻译不扣积分。
展开后可编辑备注，并查看原始状态、查询次数、最后查询时间和创建时间。

任务状态与物流状态

每个单号有两种状态：任务状态表示系统是否查完，分为待处理、处理中、已完成、失败；物流状态表示包裹走到哪一步。

物流状态	含义
已下单	承运商已收到面单信息，包裹可能还没交寄。
已揽收	承运商已揽收包裹。
运输中	包裹在转运途中。
派送中	包裹已交给派送员，正在派送。
到达待取	已到达自提点或邮局，等待收件人取件。
已签收	轨迹显示已完成投递。
投递失败	尝试投递未成功（如无人签收、地址问题），通常会再次投递。
异常	轨迹出现异常提示，如延误、无法进入投递地点等，需要关注。
退回	包裹正在或已经退回寄件人。
邮资未付	承运商提示邮资未付或不足，需联系发货渠道处理。
未找到	承运商暂无轨迹：单号可能无效、尚未交寄或轨迹还没上网。
已过期	运输时间过长，承运商不再更新轨迹。
未知	无法归类的状态，可展开单号查看原始状态和轨迹。

“失败”不是“投递失败”

任务状态“失败”表示这次查询没能完成，可以稍后重新查询；物流状态“投递失败”表示承运商尝试投递但没有成功。

承运商官网、官方 App 与开放 API 的缓存和刷新时间可能不同。处理重要包裹时，应结合承运商官方查询与客服结果判断。

07 · RECHECK

重新查询

在弹窗里勾选要重查的状态，重查不扣积分。

从哪里重查

单个单号：单号旁的重新查询图标。
整个批次：批次详情右上角的“重新查询”。
多个批次：查询组详情点“重查”，勾选批次后点“重查”。
多个查询组：我的查询点“重查”，勾选查询组后点“重查所选”。

选择范围

弹窗里可以按任务状态（单选“已完成”或“失败”）或按物流状态（可多选）勾选，再点“重查所选”；什么都不选时点“全部重查”。

以弹窗勾选为准

列表上的筛选条件不会带入重查。只想重查异常单号时，请在弹窗里勾选“未找到”“异常”等状态，而不是点“全部重查”。

重查规则

重新查询不扣积分。
已签收、邮资未付属于最终状态，重查时会自动跳过；还在待处理、处理中的单号也会跳过。
刚查过不久的单号不会重复请求承运商，而是沿用上一次的结果，页面同样会经过待处理、处理中到已完成。
列表每隔几秒自动刷新，无需手动刷新页面。

重复提交是否扣费

同一账号的同一单号，30 天内再次提交（包括删除后重新提交、在临时查询或 API 中提交）不会重复扣费；超过 30 天未再提交的，下次提交按新单号计费。

08 · DATA

数据统计与导出

在“查询统计”看整体状态、跨组搜索单号；按需要导出 Excel 或 CSV。

查询统计

右上角“单号来源”可在 Web（网页提交）和 API 之间切换；临时查询不计入统计。
统计格显示总数、任务状态和各物流状态的数量。
“搜索单号”“批量搜索单号”会在所有查询组中查找，适合找不到单号时使用。
还可以按备注、物流商、任务状态、物流状态筛选，再点“导出”导出当前筛选结果。

导出

查询组详情、批次详情、临时查询和查询统计页都有“导出”按钮，导出范围分别是该组、该批次、本次临时查询和当前筛选结果。

按单号汇总（推荐）：每个单号一行，附完整轨迹列。
按轨迹展开：每条轨迹事件一行，行数会多很多。
可按任务状态、物流状态勾选导出范围，不选则导出全部。
文件类型可选 Excel 或 CSV。Excel 单个文件最多约 104 万行，数据量大（尤其按轨迹展开）时请选 CSV。

创建导出后，进入“导出任务”查看进度，状态为“成功”时点击“下载”。文件有保存期限，到期时间见“过期时间”列，过期后需要重新导出。

数据安全

导出文件可能包含客户数据，请控制下载权限和保存位置。

09 · POINTS

积分、充值与邀请

每个新单号扣 1 积分，通过兑换码充值。

计费规则

每个新单号扣 1 积分，提交时扣除，与查询结果无关。
同一单号 30 天内再次提交不重复扣费；重新查询、翻译轨迹不扣积分。
余额不足时，整批提交会失败，不会只提交一部分。

充值方式

联系企业微信客服购买积分，获取兑换码。
进入“积分明细”，在“兑换码”输入框中粘贴兑换码，点击“兑换”。
积分立即到账；含赠送积分的兑换码会额外记一笔“兑换赠送”。

积分套餐

以下为 100,000 积分以内的公开套餐，实际价格以客服报价为准。

积分数量	单价（元/积分）	总价（元）
3,000	0.0179	53.7
5,000	0.0169	84.5
10,000	0.015	150
30,000	0.013	390
50,000	0.012	600
100,000	0.011	1,100

以上价格自 2026 年 6 月 1 日起生效。
首次充值赠送充值积分的 10%。
注册后联系企业微信，可领取 500 积分。
积分长期有效。
超过 100,000 积分，请联系企业微信获取大客户报价。

邀请好友

在“邀请好友”页复制邀请码或邀请链接发给好友，好友注册时会自动带上你的邀请码。邀请奖励活动开启时，页面会显示奖励规则、好友列表和你获得的奖励；具体规则以页面显示为准。

10 · DEVELOPERS

API 与 Webhook

面向需要把物流查询接入自有系统的开发者。接口细节见左侧菜单“API 文档”。

开通与创建凭证

累计充值达到 500,000 积分后，联系客服开通 API 权限；未开通时“创建凭证”不可用。
创建凭证时填写名称；Webhook URL 选填，只通过接口轮询获取结果可以不填。
API Key 和 Webhook Secret 只在创建时显示一次，请立即保存。

接口与推送

认证方式：Bearer API Key；单次请求最多注册 100 个单号，计费规则与网页提交相同。
注册后系统自动查询并持续跟踪：未签收的单号大约每 12–24 小时刷新一次，长时间没有变化会逐步放慢。
连续 30 天没有新轨迹、签收或邮资未付一段时间后、或调用取消接口时，停止跟踪；重新注册即可恢复。
Webhook 只有收到 2xx 响应才算成功，失败会自动重试，含首次最多 10 次，间隔逐步拉长到约 24 小时。
回调地址持续失败时会暂停推送，页面顶部会提示原因；修改回调地址并测试成功后自动恢复。

凭证管理

查看详情：订阅列表、推送记录（含 HTTP 状态码和失败原因）、物流轨迹三个标签页。
轮换 Webhook 密钥：旧密钥保留 24 小时，期间推送同时带新旧两个签名。
重置 API Key：旧 Key 立即失效；禁用或删除凭证后，使用该凭证的请求都会被拒绝。

安全要求

API Key 只保存在服务端安全配置中，不要写入前端代码、截图、邮件或公开文档。创建、轮换或停用凭证前，应确认调用方和影响范围。

11 · FAQ

常见问题

为什么提交后找不到这批单号？

最常见的原因是提交时选了其他目标组。可以在“查询统计”里用“搜索单号”或“批量搜索单号”跨所有查询组查找；也可以在“我的查询”里按批次时间和备注逐一核对，未主动选择时先看默认组。

为什么显示“未找到”？

承运商暂时没有返回轨迹，常见原因是单号无效、包裹还没交寄或轨迹尚未上网。先核对单号和承运商，过一段时间再重新查询。

“失败”和“投递失败”有什么区别？

“失败”是任务状态，表示系统这次没能完成查询，可以稍后重新查询；“投递失败”是物流状态，表示承运商尝试投递但没有成功。

重新查询会扣积分吗？

不会。重新查询、翻译轨迹都不扣积分；同一单号 30 天内再次提交也不会重复扣费。

为什么点了重新查询，状态没有变化？

已签收、邮资未付的单号不会再重查；刚查过不久的单号会直接沿用上一次的结果。承运商还没有新轨迹时，结果自然也不会变化，可以过一段时间再查。

可以一次重查多个异常单号吗？

可以。在批次详情点“重新查询”，或在我的查询、查询组详情里多选后点“重查”，然后在弹窗里勾选“未找到”“异常”等状态，再点“重查所选”。

临时查询的结果去哪了？

新建临时查询会自动清空上一次的结果，清空后无法恢复。需要保留的结果请先导出，或改用“快递查询”提交。

导出的文件为什么下载不了？

导出文件有保存期限，到期后任务会变成“已过期”，文件随之删除，需要重新导出。到期时间见导出任务列表的“过期时间”列。

为什么官网和平台轨迹暂时不同？

不同渠道的缓存和刷新时间可能不同。重要包裹建议同时参考承运商官方 App、官网或客服结果。

12 · SUPPORT

联系客服

充值、批量查询、异常状态、导出或 API 开通问题，可通过企业微信联系 FrogTracking。

扫码添加企业微信

为了更快处理问题，请提供承运商、受影响单号、查询时间、页面状态、已重查次数和脱敏截图。

请勿发送：登录密码、API Key 或完整客户数据表。