货盘页面接入说明

1. 接入目标

我方提供一个商品货盘页面，可挂接到甲方 ERP 系统中使用。
甲方用户可从 ERP 中进入商品货盘页面，查看商品并执行铺货操作。

2. 甲方需要配合的事项

甲方侧需要完成以下 4 项工作：

注册为选品网用户，并通过邀请链接成为分销商(和西之月对接人沟通获取)

生成客户邀请链接，并复制分享链接中邀请码invite_link_code（例如：https://westmonth.test.szad.teehmoon.com/?invite_link_code=ae0c8ef832da0d8ce5bf8837 ,其中 ae0c8ef832da0d8ce5bf8837 就是邀请码, 和西之月对接人沟通获取）

在打开商品货盘页面时，通过 URL 传入来源平台、邀请码、时间戳、和甲方用户唯一标识。

提供铺货接口，供我方服务在用户点击“铺货”时调用(我方传product_id、external_user_sn，甲方调用商品相关的接口获取数据)。

如果甲方的接口是异步处理，那认为该商品铺货成功

基于安全考虑，external_user_sn 可以是甲方内部算法加密后的值

签名方式、签名算法及密钥信息默认沿用全局签名配置，详见全局调用验签。甲方接口收到请求后，需自行完成签名校验

3. 页面打开方式

甲方 ERP 打开商品货盘页面时，需在 URL 中带上以下参数：

external_user_sn：用户唯一标识，必填

source：来源平台(我方提供)，必填

timestamp：当前时间戳(秒)，必填

invite_link_code：邀请码，必填

extra：扩展，非必填（会回传铺货接口）
示例：

https://www.westmonth.com/products/collect?source=erp&invite_link_code=ae0c8ef832da0d8ce5bf8837&external_user_sn=10001&timestamp=1775528315&extra=ce5bf88

说明：

external_user_sn 需保证在甲方 ERP 体系内唯一。

4. 推送铺货接口格式

签名方式、签名算法及密钥信息默认沿用全局签名配置，详见全局调用验签

   curl -X POST "https://xxx.example.com/goods/sync" \
  -H "Content-Type: application/json" \
  -H "Authorization: ${authorization}" \
  -d '{
    "product_id": "100001",
    "external_user_sn": "U202404290001"
    "extra": "ce5bf88"
  }'

响应示例

code 等于 0 则认为成功

{
    "code": 0,
    "msg": "",
    "data": {
    }

5. 下单流程

ERP下单时每次通过 external_user_sn + source 查询 auth_code 放到 header 的 Auth-Token中，获取授权码

1. 接入目标#

2. 甲方需要配合的事项#

3. 页面打开方式#

4. 推送铺货接口格式#

响应示例#

5. 下单流程#