ZYT/zyt

Fork 0

Files

T

Your Name fdf714f833 新增

2026-04-07 18:13:03 +08:00

5.7 KiB

Raw Blame History

快递100账号问题解决方案

问题确认

根据快递100官方文档，错误码 400 的含义是：

400 - 找不到对应公司
原因：提交数据不完整或者账号未充值

你的账号返回此错误，最可能的原因是：账号未充值或余额不足

立即检查

1. 登录快递100后台

访问：https://www.kuaidi100.com/

使用你的账号登录（Customer: CC25SV92****）

2. 检查账户余额

在后台查看：

当前余额
可用查询次数
套餐类型
支持的快递公司列表

3. 检查充值记录

确认是否已经充值：

充值金额
充值时间
是否到账

解决方案

方案一：充值账户（推荐）

登录快递100后台
- 网址：https://www.kuaidi100.com/
- 使用你的账号登录
进入充值页面
- 找到"充值"或"套餐购买"入口
- 选择合适的套餐
选择套餐
- 基础套餐：支持常用快递公司
- 标准套餐：支持更多快递公司
- 企业套餐：支持所有快递公司
完成支付
- 支付宝/微信/对公转账
- 等待到账（通常即时到账）
测试查询
```
cd server
php debug_kuaidi100.php
```

方案二：联系客服

如果确认已充值但仍然报错：

快递100客服：

官网：https://www.kuaidi100.com/
在线客服：工作日 9:00-18:00
电话：查看官网联系方式

提供信息：

Customer ID: CC25SV92****
错误信息：找不到对应公司 (returnCode: 400)
测试单号：JD0230761381812
快递公司：京东快递

方案三：使用官网查询（临时方案）

在充值前，系统已提供官网查询链接：

京东快递：

https://www.jdl.com/#/trackQuery?waybillCode=JD0230761381812

极兔速递：

https://www.jtexpress.com.cn/index/query/gzquery.html?bills=JT5472795424064

顺丰速运：

https://www.sf-express.com/cn/sc/dynamic_function/waybill/#search/bill-number/SF1234567890

快递100套餐说明

基础套餐

价格：约 ¥100-500/年
查询次数：1000-5000次
支持快递：10-20家常用快递
适合：小型企业、个人开发者

标准套餐

价格：约 ¥500-2000/年
查询次数：5000-20000次
支持快递：50+家快递公司
适合：中型企业

企业套餐

价格：约 ¥2000+/年
查询次数：20000+次
支持快递：100+家快递公司
适合：大型企业、电商平台

注意： 具体价格和套餐内容以快递100官网为准。

测试步骤

充值后测试

测试配置

cd server
php check_logistics_config.php

测试API调用

php debug_kuaidi100.php

应该看到：

{
    "message": "ok",
    "state": "0",
    "data": [...]
}

测试前端查询
- 打开业务订单详情
- 填写快递单号
- 点击"查询物流"
- 应该能看到物流轨迹

常见问题

Q1: 充值后多久生效？

A: 通常即时生效。如果超过10分钟未生效，联系客服。

Q2: 如何查看剩余查询次数？

A: 登录快递100后台，在首页或账户信息页面查看。

Q3: 查询次数用完了怎么办？

续费充值
升级套餐
临时使用官网查询链接

Q4: 可以按次付费吗？

A: 快递100通常提供套餐制，具体咨询客服。

Q5: 支持哪些快递公司？

基础套餐：顺丰、京东、中通、圆通、申通、韵达等常用快递
标准套餐：50+家快递公司
企业套餐：100+家快递公司

完整列表见：https://api.kuaidi100.com/document/5f0ffb5ebc8da837cbd8aefc/5f0ffc3cbc8da837cbd8afc0

系统当前状态

✅ 已完成的优化

错误提示优化
- 当快递100返回400错误时
- 提示："快递100暂不支持该快递公司或编码错误，请使用下方官网链接查询"
官网链接备用
- 所有快递公司都提供官网查询链接
- 用户可以直接点击跳转
支持多家快递
- 顺丰速运（shunfeng）
- 京东快递（jingdong）
- 极兔速递（jtexpress）
详细日志记录
- 记录所有查询请求和响应
- 方便排查问题

🔄 待完成（充值后）

实时物流查询
- 快递100 API实时查询
- 返回完整物流轨迹
- 显示物流状态
自动识别快递公司
- 根据单号自动识别
- 无需手动选择
高级功能
- 预计到达时间
- 快递员信息
- 路由信息

建议

短期（立即可用）

使用官网查询链接：

功能完全可用
无需额外费用
只需点击跳转

中期（推荐）

充值快递100账户：

统一的查询接口
更好的用户体验
自动化物流追踪

长期（可选）

对接多个物流API：

快递100作为主要渠道
各快递公司官方API作为备用
提高查询成功率

总结

问题原因： 快递100账号未充值或余额不足

立即行动：

登录快递100后台检查余额
充值账户
测试查询功能

临时方案：

使用系统提供的官网查询链接
功能完全可用

充值后：

可以使用快递100实时查询
获得更好的用户体验
支持更多快递公司

5.7 KiB Raw Blame History Unescape Escape