# 平台商品管理（个性）

> **注意：** 以下所有接口仅对特殊客户开放，其他客户无权限调用。

平台商品管理（个性）分类提供平台商品发布、查询、素材管理等接口，共 **19** 个API。

---

## 接口列表

| 序号 | 接口名称 | Method | 说明 |
|------|----------|--------|------|
| 1 | [查询平台运费模板（个性）](#1-查询平台运费模板个性) | `foonsu.erp.platForm.goods.queryFreightTemplateList` | 查询运费模板 |
| 2 | [查询平台品牌（个性）](#2-查询平台品牌个性) | `foonsu.erp.platForm.goods.queryPlatformBrandList` | 查询平台品牌 |
| 3 | [查询平台商品发布规则（个性）](#3-查询平台商品发布规则个性) | `foonsu.erp.platForm.goods.queryPlatformGoodsCreateRule` | 查询发布规则 |
| 4 | [查询平台商品属性（个性）](#4-查询平台商品属性个性) | `foonsu.erp.platForm.goods.queryPlatformCateProperty` | 查询商品属性 |
| 5 | [发布平台商品（个性）](#5-发布平台商品个性) | `foonsu.erp.platForm.goods.createPlatformGoods` | 发布商品到平台 |
| 6 | [修改平台商品（个性）](#6-修改平台商品个性) | `foonsu.erp.platForm.goods.updatePlatformGoods` | 修改平台商品 |
| 7 | [查询平台商品类目（个性）](#7-查询平台商品类目个性) | `foonsu.erp.platForm.goods.queryPlatformCategoryList` | 查询商品类目 |
| 8 | [搜索素材中心文件夹（个性）](#8-搜索素材中心文件夹个性) | `foonsu.erp.platForm.goods.materialSearchFolder` | 搜索素材文件夹 |
| 9 | [批量上传图片到素材中心（个性）](#9-批量上传图片到素材中心个性) | `foonsu.erp.platForm.goods.materialBatchUploadImageSync` | 批量上传图片 |
| 10 | [根据素材id查素材详情（个性）](#10-根据素材id查素材详情个性) | `foonsu.erp.platForm.goods.materialQueryMaterialDetail` | 查询素材详情 |
| 11 | [查询平台商品列表（个性）](#11-查询平台商品列表个性) | `foonsu.erp.platForm.goods.queryProductInfoList` | 查询平台商品列表 |
| 12 | [查询平台商品详情（个性）](#12-查询平台商品详情个性) | `foonsu.erp.platForm.goods.queryProductInfoDetail` | 查询平台商品详情 |
| 13 | [查询质检仓配置（个性）](#13-查询质检仓配置个性) | `foonsu.erp.platForm.goods.queryQicInspectConfig` | 查询质检仓配置 |
| 14 | [查询送检配置模板信息（个性）](#14-查询送检配置模板信息个性) | `foonsu.erp.platForm.goods.queryQicInspectSubmitConfig` | 查询送检配置 |
| 15 | [打印质检码（个性）](#15-打印质检码个性) | `foonsu.erp.platForm.goods.queryQicInspectCodePrintInfo` | 打印质检码 |
| 16 | [绑定送检信息（个性）](#16-绑定送检信息个性) | `foonsu.erp.platForm.goods.submitQicInspect` | 绑定送检信息 |
| 17 | [查询平台商家结算账单（个性）](#17-查询平台商家结算账单个性) | `foonsu.erp.platForm.finance.getSettleBillDetail` | 查询结算账单 |
| 18 | [获取平台订单物流信息（个性）](#18-获取平台订单物流信息个性) | `foonsu.erp.platForm.logistics.queryLogisticsDetail` | 获取平台物流信息 |
| 19 | [获取平台联盟订单明细（个性）](#19-获取平台联盟订单明细个性) | `foonsu.erp.platForm.goods.getAllianceOrderList` | 获取联盟订单明细 |

---

## 通用说明

### 个性接口通用请求结构

| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| shopId | 是 | Long | 店铺id |
| requestId | 是 | string | 请求id（随机数） |
| requestParam | 是 | string | 平台接口的请求参数的Json String |

### 个性接口通用返回结构

| 参数名 | 类型 | 说明 |
|--------|------|------|
| data | object | 返回数据 |
| requestId | String | 请求id |
| success | boolean | 是否成功 |
| errorMsg | String | 错误信息 |

---

## 1. 查询平台运费模板（个性）

**Method：** `foonsu.erp.platForm.goods.queryFreightTemplateList`

**支持平台：** 抖店、快手、淘宝

**请求示例：**
```json
{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"page\":0,\"pageSize\":100}"
}
```

**返回参数：**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| data | object | 返回数据 |
| requestId | String | 请求id |
| platformGoodsInfo | String | 平台返回信息 |
| success | boolean | 是否成功 |
| errorMsg | String | 错误信息 |

---

## 2. 查询平台品牌（个性）

**Method：** `foonsu.erp.platForm.goods.queryPlatformBrandList`

**支持平台：** 抖店

**请求示例：**
```json
{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"category_id\":20178}"
}
```

**平台文档：** [抖店品牌查询](https://op.jinritemai.com/docs/api-docs/14/1267)

---

## 3. 查询平台商品发布规则（个性）

**Method：** `foonsu.erp.platForm.goods.queryPlatformGoodsCreateRule`

**支持平台：** 抖店

**请求示例：**
```json
{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"category_id\":20178}"
}
```

**平台文档：** [抖店发布规则](https://op.jinritemai.com/docs/api-docs/14/1614)

---

## 4. 查询平台商品属性（个性）

**Method：** `foonsu.erp.platForm.goods.queryPlatformCateProperty`

**支持平台：** 抖店

**请求示例：**
```json
{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"category_leaf_id\":20178}"
}
```

**平台文档：** [抖店商品属性](https://op.jinritemai.com/docs/api-docs/14/1373)

---

## 5. 发布平台商品（个性）

**Method：** `foonsu.erp.platForm.goods.createPlatformGoods`

**支持平台：** 抖店

**请求示例：**
```json
{
  "requestId": "12312313111",
  "requestParam": "{...平台商品信息...}",
  "shopId": 100030000000003021
}
```

requestParam 中包含商品名称、规格、价格、图片、运费模板、品牌等完整商品信息。

**平台文档：** [抖店发布商品](https://op.jinritemai.com/docs/api-docs/14/249)

---

## 6. 修改平台商品（个性）

**Method：** `foonsu.erp.platForm.goods.updatePlatformGoods`

**支持平台：** 抖店

**返回参数：**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| data | object | 返回数据 |
| requestId | String | 请求id |
| platformGoodsInfo | String | 平台返回信息 |
| success | boolean | 是否成功 |
| errorMsg | String | 错误信息 |

**平台文档：** [抖店修改商品](https://op.jinritemai.com/docs/api-docs/14/250)

---

## 7. 查询平台商品类目（个性）

**Method：** `foonsu.erp.platForm.goods.queryPlatformCategoryList`

**支持平台：** 抖店、淘宝、快手

**请求示例：**
```json
{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"cid\":0}"
}
```

**平台文档：**
- 抖店：https://op.jinritemai.com/docs/api-docs/13/1820
- 淘宝：https://open.taobao.com/api.htm?docId=122&docType=2
- 快手：https://open.kwaixiaodian.com/zone/new/docs/api?name=open.item.category.optional.get&version=1

---

## 8. 搜索素材中心文件夹（个性）

**Method：** `foonsu.erp.platForm.goods.materialSearchFolder`

**支持平台：** 抖店

**请求示例：**
```json
{
  "shopId": 100030000000003021,
  "requestId": "987654321",
  "requestParam": "{\"orderBy\":1,\"pageNum\":1,\"pageSize\":40,\"name\":\"商品\"}"
}
```

**平台文档：** [抖店素材中心](https://op.jinritemai.com/docs/api-docs/69/1149)

---

## 9. 批量上传图片到素材中心（个性）

**Method：** `foonsu.erp.platForm.goods.materialBatchUploadImageSync`

**支持平台：** 抖店

**请求示例：**
```json
{
  "shopId": 100030000000003021,
  "requestId": "987654321",
  "requestParam": "{\"materials\":[{\"request_id\":\"123456789\",\"folder_id\":\"102\",\"name\":\"测试上传\",\"url\":\"https://example.com/image.jpg\",\"material_type\":\"photo\"}]}"
}
```

**平台文档：** [抖店批量上传图片](https://op.jinritemai.com/docs/api-docs/69/1616)

---

## 10. 根据素材id查素材详情（个性）

**Method：** `foonsu.erp.platForm.goods.materialQueryMaterialDetail`

**支持平台：** 抖店

**请求示例：**
```json
{
  "shopId": 100030000000003021,
  "requestId": "987654321",
  "requestParam": "{\"material_id\":\"72937055346656709750897\"}"
}
```

**平台文档：** [抖店素材详情](https://op.jinritemai.com/docs/api-docs/69/1145)

---

## 11. 查询平台商品列表（个性）

**Method：** `foonsu.erp.platForm.goods.queryProductInfoList`

**支持平台：** 抖店、快手、淘宝

**请求示例：**
```json
{
  "shopId": "100030000000003037",
  "requestId": "123456",
  "requestParam": "{\"page_no\":1,\"page_size\":50,\"order_by\":\"list_time:modified\",\"start_modified\":\"2024-03-01 00:00:00\",\"end_modified\":\"2024-03-21 00:00:00\"}"
}
```

**平台文档：**
- 抖店：https://op.jinritemai.com/docs/api-docs/14/633
- 快手：https://open.kwaixiaodian.com/zone/docs/api?name=open.item.list.get&version=1
- 淘宝：https://open.taobao.com/api.htm?docId=162&docType=2

---

## 12. 查询平台商品详情（个性）

**Method：** `foonsu.erp.platForm.goods.queryProductInfoDetail`

**支持平台：** 抖店、快手、淘宝

**请求示例：**
```json
{
  "shopId": "100030000000003037",
  "requestId": "123456",
  "requestParam": "{\"num_iids\":\"584747567232,748902807330\"}"
}
```

**平台文档：**
- 抖店：https://op.jinritemai.com/docs/api-docs/14/56
- 快手：https://open.kwaixiaodian.com/zone/docs/api?name=open.item.get&version=1
- 淘宝：https://open.taobao.com/api.htm?docId=24626&docType=2

---

## 13. 查询质检仓配置（个性）

**Method：** `foonsu.erp.platForm.goods.queryQicInspectConfig`

**支持平台：** 微信视频号

**返回参数：**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| data | object | 返回数据 |
| requestId | String | 请求id |
| platformResponseInfo | String | 平台返回信息 |
| success | boolean | 是否成功 |
| errorMsg | String | 错误信息 |

**平台文档：** [微信视频号质检仓配置](https://developers.weixin.qq.com/doc/channels/API/qic/getinspectconfig.html)

---

## 14. 查询送检配置模板信息（个性）

**Method：** `foonsu.erp.platForm.goods.queryQicInspectSubmitConfig`

**支持平台：** 微信视频号

**平台文档：** [微信视频号送检配置](https://developers.weixin.qq.com/doc/channels/API/qic/getinspectsubmitconfig.html)

---

## 15. 打印质检码（个性）

**Method：** `foonsu.erp.platForm.goods.queryQicInspectCodePrintInfo`

**支持平台：** 微信视频号

**请求示例：**
```json
{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"order_id\":\"37423523451235145\"}"
}
```

**平台文档：** [微信视频号打印质检码](https://developers.weixin.qq.com/doc/channels/API/qic/printinspectcode.html)

---

## 16. 绑定送检信息（个性）

**Method：** `foonsu.erp.platForm.goods.submitQicInspect`

**支持平台：** 微信视频号

**请求示例：**
```json
{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"order_id\":\"37423523451235145\",\"inspect_info\":{\"delivery_id\":\"SF\",\"backup_delivery_id\":\"STO\",\"delivery_product_id\":2,\"backup_delivery_product_id\":1,\"express_insure\":true,\"express_insure_amount\":999,\"delivery_insure_id\":\"INSURE\",\"backup_express_insure\":false,\"express_merge\":true,\"refund_intercept\":0,\"inspect_org_id\":\"001\",\"inspect_org_name\":\"中质\",\"warehouse_name\":\"xxx\",\"warehouse_addr\":\"kklmp\"}}"
}
```

**平台文档：** [微信视频号绑定送检](https://developers.weixin.qq.com/doc/channels/API/qic/submitinspectinfo.html)

---

## 17. 查询平台商家结算账单（个性）

**Method：** `foonsu.erp.platForm.finance.getSettleBillDetail`

**支持平台：** 抖店

**请求示例：**
```json
{
  "shopId": 100030000000003037,
  "requestId": "123456",
  "requestParam": "{\"startIndex\":\"123445\",\"payType\":\"1\",\"productId\":\"123456\",\"size\":100,\"orderId\":\"4778345176320227200\",\"timeType\":\"0\",\"startTime\":\"2024-04-08 00:00:00\",\"endTime\":\"2024-04-10 00:00:00\",\"flowType\":\"1\"}"
}
```

**返回参数：**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| data | object | 返回数据 |
| requestId | String | 请求id |
| financeInfo | String | 平台返回信息 |
| success | boolean | 是否成功 |
| errorMsg | String | 错误信息 |

**平台文档：** [抖店结算账单](https://op.jinritemai.com/docs/api-docs/46/1753)

---

## 18. 获取平台订单物流信息（个性）

**Method：** `foonsu.erp.platForm.logistics.queryLogisticsDetail`

**支持平台：** 淘宝、快手、抖音、微信视频号

### 请求参数

| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| shopId | 是 | Long | 店铺id |
| requestId | 是 | string | 请求id |
| tradeNo | 是 | string | 平台交易编号 |

**请求示例：**
```json
{
  "shopId": 100030000000003037,
  "requestId": "123456",
  "tradeNo": "2423234234234"
}
```

### PlatformLogisticsResp 返回对象

| 参数名 | 类型 | 说明 |
|--------|------|------|
| logisticsInfo | LogisticsInfo | 返回对象数据 |
| requestId | String | 请求id |
| success | boolean | 是否成功 |
| errorMsg | String | 错误信息 |

### LogisticsInfo 对象

| 参数名 | 类型 | 说明 |
|--------|------|------|
| logisticsOrderInfos | List | LogisticsOrderInfo 对象列表 |
| tradeNo | String | 平台交易编号 |
| postAmount | String | 运费 |
| sendTime | Date | 发货时间 |
| platformCode | String | 企得宝电商平台编号 |

### LogisticsOrderInfo 对象

| 参数名 | 类型 | 说明 |
|--------|------|------|
| logisticsNo | String | 运单号 |
| logisticsCode | String | 物流公司编号 |
| logisticsCompany | String | 物流公司 |
| sendTime | Date | 发货时间 |
| logisticsStatus | String | 物流状态 |

**平台文档：**
- 淘宝：[查询订单详情](https://open.taobao.com/api.htm?docId=54&docType=2) / [查询物流订单](https://open.taobao.com/api.htm?docId=234&docType=2)
- 抖店：[查询订单详情](https://op.jinritemai.com/docs/api-docs/15/1343) / [查询运单轨迹](https://op.jinritemai.com/docs/api-docs/1262/1851)
- 快手：[查询订单详情](https://open.kwaixiaodian.com/zone/new/docs/api?name=open.order.detail)
- 微信视频号：[查询订单详情](https://developers.weixin.qq.com/doc/channels/API/order/get.html)

---

## 19. 获取平台联盟订单明细（个性）

**Method：** `foonsu.erp.platForm.goods.getAllianceOrderList`

**支持平台：** 抖店

**请求示例：**
```json
{
  "shopId": "100030000000003408",
  "requestId": "0.987654321",
  "requestParam": "{\"order_ids\":[6932777433868735826]}"
}
```

**返回参数：**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| data | object | 返回数据 |
| requestId | String | 请求id |
| platformReturnResult | String | 平台返回信息 |
| success | boolean | 是否成功 |
| errorMsg | String | 错误信息 |

**返回示例：**
```json
{
  "errorCode": null,
  "msg": null,
  "data": {
    "requestId": "0.987654321",
    "platformReturnResult": "{\"code\":\"10000\",\"data\":{\"code\":\"100000\",\"codeMsg\":\"success\",\"datas\":[{\"allianceBizType\":\"COMMON\",\"authorAccount\":\"于谦铺子\",\"commissionRate\":2000,\"estimatedComission\":122400,\"orderId\":\"6932777433868735826\",\"orderStatus\":\"退款\",\"phaseId\":1,\"productId\":\"3697602450732220716\",\"realComission\":0,\"shopId\":\"110269615\",\"shortId\":\"22534514211\",\"totalPayAmount\":680000}]},\"logId\":\"2024081215062509CC7595066156CB4B70\",\"msg\":\"success\",\"subCode\":\"\",\"subMsg\":\"\",\"success\":true}",
    "success": true,
    "errorMsg": null
  },
  "date": "2024-08-12 15:06:30",
  "version": null,
  "success": true
}
```

**平台文档：** [抖店联盟订单](https://op.jinritemai.com/docs/api-docs/46/469)
