# 快递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` - 故障排查指南