跳到主要内容

商品对应关系查询（按商品ID）

接口描述​

根据平台商品ID查询该商品下所有SKU的对应关系。适用于抖店等导出数据只有商品ID没有SKU ID的场景。

注意：一个平台商品ID可能对应多个ERP商品，每个ERP商品返回一条独立记录。

系统相关界面​

"界面路径：【商品】----【商品对应表】"

请求地址​

环境服务地址(HTTP/HTTPS)
V2正式环境（推荐）https://gw.superboss.cc/router

2022年4月1日以后申请的APP Key，统一使用V2正式环境的请求地址：https://gw.superboss.cc/router

公共参数​

调用任何一个API都必须传入的参数，目前支持的公共参数有：

参数名称参数类型是否必须参数描述
methodstring是API接口名称
appKeystring是分配给应用的AppKey
timestampstring是时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
formatstring否响应格式。默认为json格式，可选值：json
versionstring是API协议版本 可选值：1.0
sign_methodstring否签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。
signstring是签名
sessionstring是授权会话信息 （即access_token，由系统分配）

请求头​

全部展开
参数名
类型
描述
必填
Content-Type
string
multipart/form-data
必填

API接口地址​

全部展开
参数名
类型
描述
必填
method
string
erp.item.outerid.list.byitem.get
必填

请求参数​

全部展开
参数名
类型
描述
必填
numIidList
string
平台商品id，多个用逗号隔开
必填
userId
long
店铺编码（与平台店铺id二选一必填）
必填
taobaoId
long
平台店铺id（与店铺编码二选一必填）
必填

请求示例​

{
  "taobaoId": 123456789,
  "numIidList": "1001,1002,1003"
}

响应参数​

全部展开
参数名
类型
描述
必填
itemOuterIdInfos
array
平台商品id与商家编码的对应信息列表
必填
numIid
string
平台商品id
必填
outerId
string
系统商家编码（有SKU时返回SKU的商家编码，否则返回商品的商家编码）
必填
userId
long
店铺编码
必填
taobaoId
long
平台店铺id
必填

响应示例​

{
    "itemOuterIdInfos": [
        {
            "numIid": "1001",
            "outerId": "ERP001"
        },
        {
            "numIid": "1001",
            "outerId": "ERP002"
        },
        {
            "numIid": "1002",
            "outerId": "ERP003"
        }
    ],
    "userId": 123456,
    "taobaoId": 123456789,
    "success": true,
    "trace_id": "3553483395423660"
}

说明：上述示例中，平台商品ID "1001" 对应了两个ERP商品（ERP001和ERP002），因此返回了两条记录。

异常示例​

{
    "code": "25",
    "msg": "服务方法(item.single.get:1.0)的签名无效",
    "success": false,
    "trace_id": "3553483395423660"
}

错误码解释​

错误码错误信息解决方案
20146店铺编码和平台店铺ID不能都为空请检查店铺编码和平台店铺ID是否都为空
20147店铺编码或平台店铺ID不存在！请检查店铺编码或平台店铺ID是否准确
20148店铺类型不支持！请检查店铺类型是否不是自建或系统类型
20150查询系统商家编码有误请根据返回的错误信息进行处理

与原接口的区别​

特性erp.item.outerid.list.geterp.item.outerid.list.byitem.get (新接口)
接口用途查询平台商品（最小粒度）与ERP商品的对应关系根据平台商品ID查询所有SKU的对应关系
输入平台商品ID（最小粒度）或系统商家编码平台商品ID（可为商品级，非最小粒度）
输出一对一映射一对多映射（一个商品可对应多个ERP商品）
适用场景有精确SKU ID的场景只有商品ID没有SKU ID的场景（如抖店导出）