03-平台商品管理(个性).md 16 KB

平台商品管理(个性)

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

平台商品管理(个性)分类提供平台商品发布、查询、素材管理等接口,共 19 个API。


接口列表

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

支持平台: 抖店、快手、淘宝

请求示例:

{
  "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

支持平台: 抖店

请求示例:

{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"category_id\":20178}"
}

平台文档: 抖店品牌查询


3. 查询平台商品发布规则(个性)

Method: foonsu.erp.platForm.goods.queryPlatformGoodsCreateRule

支持平台: 抖店

请求示例:

{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"category_id\":20178}"
}

平台文档: 抖店发布规则


4. 查询平台商品属性(个性)

Method: foonsu.erp.platForm.goods.queryPlatformCateProperty

支持平台: 抖店

请求示例:

{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"category_leaf_id\":20178}"
}

平台文档: 抖店商品属性


5. 发布平台商品(个性)

Method: foonsu.erp.platForm.goods.createPlatformGoods

支持平台: 抖店

请求示例:

{
  "requestId": "12312313111",
  "requestParam": "{...平台商品信息...}",
  "shopId": 100030000000003021
}

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

平台文档: 抖店发布商品


6. 修改平台商品(个性)

Method: foonsu.erp.platForm.goods.updatePlatformGoods

支持平台: 抖店

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

平台文档: 抖店修改商品


7. 查询平台商品类目(个性)

Method: foonsu.erp.platForm.goods.queryPlatformCategoryList

支持平台: 抖店、淘宝、快手

请求示例:

{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"cid\":0}"
}

平台文档:


8. 搜索素材中心文件夹(个性)

Method: foonsu.erp.platForm.goods.materialSearchFolder

支持平台: 抖店

请求示例:

{
  "shopId": 100030000000003021,
  "requestId": "987654321",
  "requestParam": "{\"orderBy\":1,\"pageNum\":1,\"pageSize\":40,\"name\":\"商品\"}"
}

平台文档: 抖店素材中心


9. 批量上传图片到素材中心(个性)

Method: foonsu.erp.platForm.goods.materialBatchUploadImageSync

支持平台: 抖店

请求示例:

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

平台文档: 抖店批量上传图片


10. 根据素材id查素材详情(个性)

Method: foonsu.erp.platForm.goods.materialQueryMaterialDetail

支持平台: 抖店

请求示例:

{
  "shopId": 100030000000003021,
  "requestId": "987654321",
  "requestParam": "{\"material_id\":\"72937055346656709750897\"}"
}

平台文档: 抖店素材详情


11. 查询平台商品列表(个性)

Method: foonsu.erp.platForm.goods.queryProductInfoList

支持平台: 抖店、快手、淘宝

请求示例:

{
  "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\"}"
}

平台文档:


12. 查询平台商品详情(个性)

Method: foonsu.erp.platForm.goods.queryProductInfoDetail

支持平台: 抖店、快手、淘宝

请求示例:

{
  "shopId": "100030000000003037",
  "requestId": "123456",
  "requestParam": "{\"num_iids\":\"584747567232,748902807330\"}"
}

平台文档:


13. 查询质检仓配置(个性)

Method: foonsu.erp.platForm.goods.queryQicInspectConfig

支持平台: 微信视频号

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

平台文档: 微信视频号质检仓配置


14. 查询送检配置模板信息(个性)

Method: foonsu.erp.platForm.goods.queryQicInspectSubmitConfig

支持平台: 微信视频号

平台文档: 微信视频号送检配置


15. 打印质检码(个性)

Method: foonsu.erp.platForm.goods.queryQicInspectCodePrintInfo

支持平台: 微信视频号

请求示例:

{
  "shopId": 100030000000003021,
  "requestId": "1122211111111455",
  "requestParam": "{\"order_id\":\"37423523451235145\"}"
}

平台文档: 微信视频号打印质检码


16. 绑定送检信息(个性)

Method: foonsu.erp.platForm.goods.submitQicInspect

支持平台: 微信视频号

请求示例:

{
  "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\"}}"
}

平台文档: 微信视频号绑定送检


17. 查询平台商家结算账单(个性)

Method: foonsu.erp.platForm.finance.getSettleBillDetail

支持平台: 抖店

请求示例:

{
  "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 | 错误信息 |

平台文档: 抖店结算账单


18. 获取平台订单物流信息(个性)

Method: foonsu.erp.platForm.logistics.queryLogisticsDetail

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

请求参数

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

请求示例:

{
  "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 物流状态

平台文档:


19. 获取平台联盟订单明细(个性)

Method: foonsu.erp.platForm.goods.getAllianceOrderList

支持平台: 抖店

请求示例:

{
  "shopId": "100030000000003408",
  "requestId": "0.987654321",
  "requestParam": "{\"order_ids\":[6932777433868735826]}"
}

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

返回示例:

{
  "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
}

平台文档: 抖店联盟订单