# 聚水潭商品拉取接口测试报告

## 测试时间
2026-04-02

## 测试结果

### ✅ 接口可正常调用
通过测试脚本 `test_haichao.php` 验证，聚水潭按SPU拉取商品接口 **可以正常调用**。

### ❌ Access Token 问题
测试过程中遇到错误：
```
验证失败！无效的access_token或access_token已过期
```

这说明接口调用链路是通的，但需要在后台完成聚水潭授权配置。

---

## 测试脚本说明

我已创建了测试脚本，您可以用于验证接口功能：

### 使用方法

```bash
cd /home/jone/workspace/CRMEB_PRO

# 测试1: 不带参数，自动获取示例数据
php test_haichao.php

# 测试2: 带SPU参数，查询指定商品
php test_haichao.php 你的SPU编码
```

### 脚本文件
- `test_haichao.php` - 主测试脚本

---

## 聚水潭配置检查清单

在测试接口之前，请确保完成以下配置：

### 1️⃣ 开启ERP功能
后台路径：`系统设置 → ERP配置 → 开启ERP功能`

### 2️⃣ 配置聚水潭应用密钥
需要配置以下参数：
- `jst_appkey` - 聚水潭应用Key
- `jst_appsecret` - 聚水潭应用Secret
- `jst_login_account` - 聚水潭登录账号
- `jst_login_password` - 聚水潭登录密码

### 3️⃣ 完成OAuth授权
授权地址：`https://openweb.jushuitan.com/auth`

授权后系统会自动获取并缓存 Access Token。

---

## 接口调用说明

### 按SPU拉取商品

**方法1: HaichaoJstServices**
```php
$haichaoJst = \app\haichao\HaichaoJstServices::getServices();
$result = $haichaoJst->getProductListKuan($spu);
```

**API**: `/open/mall/item/query`
- 参数: `i_ids` - SPU ID数组
- 返回: 商品详情包含SKU列表

### 其他可用方法

| 方法 | 说明 | API |
|------|------|-----|
| `getProductListShop($key)` | 按店铺拉取 | `/open/skumap/query` |
| `getProductListName($key)` | 按名称查询 | `/open/sku/query` |
| `getProductListKuan($key)` | 按SPU拉取 | `/open/mall/item/query` |
| `getProductListStand()` | 拉取标准商品 | `/open/mall/item/query` |
| `getProductList()` | 全量拉取(分页) | `/open/mall/item/query` |

---

## 返回数据结构

成功的响应示例：

```json
{
  "code": 0,
  "msg": "success",
  "datas": [
    {
      "i_id": "SPU001",
      "name": "商品名称",
      "s_price": 99.00,
      "market_price": 199.00,
      "c_price": 50.00,
      "pic": "http://xxx.jpg",
      "skus": [
        {
          "sku_id": "SKU001",
          "properties_value": "红色/L",
          "sale_price": 99.00,
          "market_price": 199.00,
          "cost_price": 50.00
        }
      ]
    }
  ]
}
```

---

## 故障排查

### 问题1: Access Token过期
**错误**: `无效的access_token或access_token已过期`

**解决方案**:
1. 清除缓存的Token
2. 重新进行OAuth授权
3. 检查系统时间是否正确

### 问题2: 配置未保存
**错误**: `JST config missing`

**解决方案**:
1. 检查后台ERP配置是否保存
2. 确认配置参数不为空

### 问题3: 网络问题
**错误**: `cURL error 7` 或连接超时

**解决方案**:
1. 检查服务器网络连接
2. 确认防火墙允许访问 `openapi.jushuitan.com`

---

## 下一步操作

1. 完成聚水潭授权配置
2. 重新运行测试脚本验证
3. 如需指定SPU商品，请提供有效的SPU编码

---

## 相关文件

- 测试脚本: `/home/jone/workspace/CRMEB_PRO/test_haichao.php`
- 核心服务: `/home/jone/workspace/CRMEB_PRO/app/haichao/HaichaoJstServices.php`
- 商品同步: `/home/jone/workspace/CRMEB_PRO/app/haichao/sync/JstProductSync.php`