01 · GET STARTED
快速开始
登录后，从“提交查询”开始；需要回看结果时进入“我的查询”。
1
注册或登录
访问 Frogtracking 官网，使用常用邮箱完成注册或登录。新用户注册后可联系企业微信领取 500 积分。
2
进入提交查询
选择手动输入或文件上传，并确认承运商、目标查询组和预计消耗积分。
3
查看结果
提交完成后进入结果页；之后可在“我的查询”中按查询组和批次重新找到记录。
开始前建议
整理并去除重复单号；为不同客户、日期或业务建立清晰的查询组和备注。
02 · TRACKING
提交物流查询
适合直接粘贴一批物流单号并立即查询。
- 输入单号：每行一个物流单号，并检查空行和重复项。
- 选择承运商：已知承运商时应明确选择；不确定时按页面当前支持方式处理。
- 选择目标组：确认记录要保存到哪个查询组，避免提交后找不到批次。
- 检查费用：提交前核对有效单号数量、重复项和预计积分消耗。
- 提交查询：提交后等待系统处理，再进入结果或相应批次查看轨迹。
单次容量
当前页面标注单次最多提交 100,000 个单号。超大批量建议先清洗数据并拆分批次。
临时查询
只需要临时查看轨迹、暂时不想把记录加入长期查询组时，可以使用临时查询入口。提交前仍需核对单号和承运商；如需后续持续跟踪，应使用正式提交查询。
03 · FILE UPLOAD
文件批量上传
适合已有 Excel 或 CSV 清单的批量业务。
- 先按照页面提供的字段和格式整理文件。
- 确认单号列没有合并单元格、公式错误或多余标题行。
- 在文件上传页选择文件，并设置目标查询组及承运商相关选项。
- 检查系统识别的新单号、重复项和预计积分消耗后再确认。
上传失败时
先检查文件类型、列名、空白行和数据量；仍无法上传时保留报错截图并联系客服。
04 · ORGANIZATION
查询组与批次管理
查询组用于长期分类，批次用于记录一次提交。先找到组，再进入批次。
查找数据
- “我的查询”首页搜索的是查询组备注。
- 进入查询组后，再按批次创建时间、数量或备注定位记录。
- 未主动选择目标组时，优先检查默认组。
高风险操作
合并、转移或删除前，应先确认目标组、目标批次、备注和数据范围。删除可能不可恢复，建议先导出备份，并再次核对页面确认弹窗。
05 · RESULTS
查询结果与物流状态
进入批次后，可以筛选状态、查看轨迹、核对查询次数和最后查询时间。
未找到
接口暂时没有返回可识别轨迹，可能是单号、承运商、上网延迟或服务异常。
失败
本次处理发生错误或未成功完成，可稍后重新查询并观察是否恢复。
运输中
已获取有效物流轨迹，包裹正在运输流程中。
已签收
轨迹显示完成投递；如与实际情况不同，应同时参考承运商官方结果。
承运商官网、官方 App 与开放 API 的缓存和刷新时间可能不同。处理重要包裹时，应结合承运商官方查询与客服结果判断。
06 · RECHECK
异常与重新查询
先筛选异常状态，再执行重新查询，避免误选全部数据。
- 进入包含异常单号的查询组和批次。
- 按“未找到”或“失败”筛选，并核对数量。
- 点击重新查询，按照弹窗确认状态和处理范围。
- 完成后刷新页面，查看查询次数、最后查询时间和状态变化。
重查是否扣费
同一单号未删除时，重复查询或重新查询不会重复扣费：查询次数会增加，但积分流水不会新增消费。
如删除后重新提交，系统的扣费记忆以当前业务规则为准；现行规则为同一单号在 30 天滑动窗口内不重复扣费。执行删除前应先导出备份并确认影响。
07 · DATA
数据统计与导出
通过统计了解整体状态，再按筛选条件创建导出任务。
- 在批次或统计页面设置状态、承运商、日期或批次范围。
- 创建导出任务前再次核对筛选条件和预计数据量。
- 进入“导出任务”查看处理状态；完成后及时下载并妥善保存。
- 导出文件包含客户数据时，应控制下载权限和保存位置。
08 · POINTS
积分、充值与活动
以下为 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 积分，请联系企业微信获取大客户报价。
09 · DEVELOPERS
API 与 Webhook
面向需要把物流查询接入内部系统的开发者。
- 累计充值达到 500,000 积分后，联系客服开通 API 权限。
- 认证方式：Bearer API Key。
- 单次请求最多注册 100 个物流单号。
- 注册后系统自动查询，订阅单号通常每 6–12 小时刷新。
- 连续 30 天没有事件更新，或已签收后 15 天没有变化，将停止刷新。
- Webhook 失败最多重试 10 次，按指数退避，最长重试间隔约 24 小时。
安全要求
API Key 只保存在服务端安全配置中，不要写入前端代码、截图、邮件或公开文档。创建、轮换或停用凭证前，应确认调用方和影响范围。
10 · FAQ
常见问题
为什么提交后找不到这批单号？
最常见原因是提交时选择了其他目标组。进入“我的查询”，按查询组创建时间、数量和备注逐一核对；未主动选择时优先检查默认组。
为什么显示“未找到”？
可能是单号无效、承运商尚未接收包裹、接口暂未返回轨迹或服务异常。先核对单号和承运商，再稍后重新查询。
为什么显示“失败”？
通常表示承运商接口返回错误或本次查询处理失败。稍后重新查询；持续失败时检查承运商选择并联系客服。
为什么官网和平台轨迹暂时不同？
不同渠道的缓存和刷新时间可能不同。重要包裹建议同时参考承运商官方 App、官网或客服结果。
重新查询会重复扣费吗？
同一单号在扣费记忆窗口内不会重复扣费。重查后查询次数会增加，但积分流水不会新增消费。
可以一次处理多个异常单号吗？
可以。先筛选“未找到”或“失败”，再使用批次或查询组的重新查询功能。执行前核对状态和范围。
11 · SUPPORT
联系客服
充值、批量查询、异常状态、导出或 API 开通问题，可通过企业微信联系 Frogtracking。
扫码添加企业微信
为了更快处理问题，请提供承运商、受影响单号、查询时间、页面状态、已重查次数和脱敏截图。
请勿发送：登录密码、API Key 或完整客户数据表。
