新增

2026-04-07 18:13:03 +08:00
parent a780356908
commit fdf714f833
397 changed files with 15086 additions and 1043 deletions
@@ -0,0 +1,281 @@
+# 快递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` - 故障排查指南