282 lines
5.7 KiB
Markdown
282 lines
5.7 KiB
Markdown
# 快递100账号问题解决方案
|
||
|
||
## 问题确认
|
||
|
||
根据快递100官方文档，错误码 `400` 的含义是：
|
||
|
||
```
|
||
400 - 找不到对应公司
|
||
原因：提交数据不完整或者账号未充值
|
||
```
|
||
|
||
你的账号返回此错误，最可能的原因是：**账号未充值或余额不足**
|
||
|
||
---
|
||
|
||
## 立即检查
|
||
|
||
### 1. 登录快递100后台
|
||
|
||
访问：https://www.kuaidi100.com/
|
||
|
||
使用你的账号登录（Customer: `CC25SV92****`）
|
||
|
||
### 2. 检查账户余额
|
||
|
||
在后台查看：
|
||
- 当前余额
|
||
- 可用查询次数
|
||
- 套餐类型
|
||
- 支持的快递公司列表
|
||
|
||
### 3. 检查充值记录
|
||
|
||
确认是否已经充值：
|
||
- 充值金额
|
||
- 充值时间
|
||
- 是否到账
|
||
|
||
---
|
||
|
||
## 解决方案
|
||
|
||
### 方案一：充值账户（推荐）
|
||
|
||
1. **登录快递100后台**
|
||
- 网址：https://www.kuaidi100.com/
|
||
- 使用你的账号登录
|
||
|
||
2. **进入充值页面**
|
||
- 找到"充值"或"套餐购买"入口
|
||
- 选择合适的套餐
|
||
|
||
3. **选择套餐**
|
||
- 基础套餐：支持常用快递公司
|
||
- 标准套餐：支持更多快递公司
|
||
- 企业套餐：支持所有快递公司
|
||
|
||
4. **完成支付**
|
||
- 支付宝/微信/对公转账
|
||
- 等待到账（通常即时到账）
|
||
|
||
5. **测试查询**
|
||
```bash
|
||
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官网为准。
|
||
|
||
---
|
||
|
||
## 测试步骤
|
||
|
||
### 充值后测试
|
||
|
||
1. **测试配置**
|
||
```bash
|
||
cd server
|
||
php check_logistics_config.php
|
||
```
|
||
|
||
2. **测试API调用**
|
||
```bash
|
||
php debug_kuaidi100.php
|
||
```
|
||
|
||
应该看到：
|
||
```json
|
||
{
|
||
"message": "ok",
|
||
"state": "0",
|
||
"data": [...]
|
||
}
|
||
```
|
||
|
||
3. **测试前端查询**
|
||
- 打开业务订单详情
|
||
- 填写快递单号
|
||
- 点击"查询物流"
|
||
- 应该能看到物流轨迹
|
||
|
||
---
|
||
|
||
## 常见问题
|
||
|
||
### Q1: 充值后多久生效？
|
||
|
||
**A:** 通常即时生效。如果超过10分钟未生效，联系客服。
|
||
|
||
### Q2: 如何查看剩余查询次数？
|
||
|
||
**A:** 登录快递100后台，在首页或账户信息页面查看。
|
||
|
||
### Q3: 查询次数用完了怎么办？
|
||
|
||
**A:**
|
||
1. 续费充值
|
||
2. 升级套餐
|
||
3. 临时使用官网查询链接
|
||
|
||
### Q4: 可以按次付费吗？
|
||
|
||
**A:** 快递100通常提供套餐制，具体咨询客服。
|
||
|
||
### Q5: 支持哪些快递公司？
|
||
|
||
**A:**
|
||
- 基础套餐：顺丰、京东、中通、圆通、申通、韵达等常用快递
|
||
- 标准套餐：50+家快递公司
|
||
- 企业套餐：100+家快递公司
|
||
|
||
完整列表见：https://api.kuaidi100.com/document/5f0ffb5ebc8da837cbd8aefc/5f0ffc3cbc8da837cbd8afc0
|
||
|
||
---
|
||
|
||
## 系统当前状态
|
||
|
||
### ✅ 已完成的优化
|
||
|
||
1. **错误提示优化**
|
||
- 当快递100返回400错误时
|
||
- 提示："快递100暂不支持该快递公司或编码错误，请使用下方官网链接查询"
|
||
|
||
2. **官网链接备用**
|
||
- 所有快递公司都提供官网查询链接
|
||
- 用户可以直接点击跳转
|
||
|
||
3. **支持多家快递**
|
||
- 顺丰速运（shunfeng）
|
||
- 京东快递（jingdong）
|
||
- 极兔速递（jtexpress）
|
||
|
||
4. **详细日志记录**
|
||
- 记录所有查询请求和响应
|
||
- 方便排查问题
|
||
|
||
### 🔄 待完成（充值后）
|
||
|
||
1. **实时物流查询**
|
||
- 快递100 API实时查询
|
||
- 返回完整物流轨迹
|
||
- 显示物流状态
|
||
|
||
2. **自动识别快递公司**
|
||
- 根据单号自动识别
|
||
- 无需手动选择
|
||
|
||
3. **高级功能**
|
||
- 预计到达时间
|
||
- 快递员信息
|
||
- 路由信息
|
||
|
||
---
|
||
|
||
## 建议
|
||
|
||
### 短期（立即可用）
|
||
|
||
**使用官网查询链接：**
|
||
- 功能完全可用
|
||
- 无需额外费用
|
||
- 只需点击跳转
|
||
|
||
### 中期（推荐）
|
||
|
||
**充值快递100账户：**
|
||
- 统一的查询接口
|
||
- 更好的用户体验
|
||
- 自动化物流追踪
|
||
|
||
### 长期（可选）
|
||
|
||
**对接多个物流API：**
|
||
- 快递100作为主要渠道
|
||
- 各快递公司官方API作为备用
|
||
- 提高查询成功率
|
||
|
||
---
|
||
|
||
## 总结
|
||
|
||
**问题原因：** 快递100账号未充值或余额不足
|
||
|
||
**立即行动：**
|
||
1. 登录快递100后台检查余额
|
||
2. 充值账户
|
||
3. 测试查询功能
|
||
|
||
**临时方案：**
|
||
- 使用系统提供的官网查询链接
|
||
- 功能完全可用
|
||
|
||
**充值后：**
|
||
- 可以使用快递100实时查询
|
||
- 获得更好的用户体验
|
||
- 支持更多快递公司
|
||
|
||
---
|
||
|
||
## 相关文档
|
||
|
||
- 快递100官方文档：https://api.kuaidi100.com/document/5f0ffb5ebc8da837cbd8aefc
|
||
- 快递公司编码表：https://api.kuaidi100.com/document/5f0ffb5ebc8da837cbd8aefc/5f0ffc3cbc8da837cbd8afc0
|
||
- `LOGISTICS_INTEGRATION_GUIDE.md` - 物流集成指南
|
||
- `KUAIDI100_TROUBLESHOOTING.md` - 故障排查指南
|