API文档

pdk_basic_spu_detail_query.php（查询铺货基础商品详情）

¥标准

1.接口说明

1.1 接口描述：查询铺货基础商品详情

1.2 适用版本：网页版

1.3 增量获取：根据基础商品ID、内部商品编号或供销平台商品ID，查询基础商品完整详情。

1.4注意事项：`spuId`、`spuNo`、`gxGoodsId` 至少传一个；同时传入多个时查询优先级：`gxGoodsId` > `spuId` > `spuNo`。

2.调用场景

2.1 举例说明：铺货功能接入ERP

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/pdk_basic_spu_detail_query.php
正式环境	https://openapi.huice.com/openapi/pdk_basic_spu_detail_query.php

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号	appkey	String	是	本开放平台“自助对接”功能模块内自助申请，申请流程单击这里
时间戳	timestamp	int	是	北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名	sign	String	是	API输入参数签名结果，签名算法介绍单击这里

3.3 业务请求参数

名称	字段	类型	必须	描述
基础商品ID	spuId	String/Long	否	基础商品ID，spuId/spuNo/gxGoodsId至少传入一个
内部商品编号	spuNo	String	否	内部商品编号，spuId/spuNo/gxGoodsId至少传入一个
供销平台商品ID	gxGoodsId	String/Long	否	供销平台商品ID，spuId/spuNo/gxGoodsId至少传入一个

4.响应参数

4.1 公共响应参数

名称	字段	类型	必须	描述
错误码	code	Integer	是	状态码:0表示成功,其他表示失败
错误描述	message	String	是	错误描述
商品详情	data	Object	是	商品详情节点，见下述"data节点"

4.2 业务响应参数

data

名称	字段	类型	必须	描述
基础商品ID	id	String	是	基础商品ID
内部商品编号	spuNo	String	是	内部商品编号
商品名称	spuName	String	是	商品名称
外部商品编号	outerSpuNo	String	是	外部商品编号
来源店铺ID	sourceShopId	String	是	来源店铺ID
商品来源	sourceType	Integer	是	0其他、1ERP、2手工创建、3供销平台、4店铺导入、5Excel导入
来源平台ID	sourcePlatformId	Integer	是	来源平台ID
外部品牌名称	outerBrandName	String	是	外部品牌名称
供销商品类型	gxGoodsType	Integer	是	0非供销商品、1供销商品、2分销商品
供销商品ID	gxGoodsId	String	是	供销商品ID
供应商租户ID	supplierSid	String	是	供应商租户ID
供应商商品ID	supplierGoodsId	String	是	供应商商品ID
基础类目ID	categoryId	String	是	基础类目ID
类目名称路径	categoryNamePath	String	是	类目名称路径
商品销售价	salesPrice	String	是	商品销售价
币种	priceCurrency	String	是	币种
商品库存	stock	Integer	是	商品库存
商品长度	length	String	是	商品长度
商品宽度	width	String	是	商品宽度
商品高度	height	String	是	商品高度
长度单位	lengthUnit	String	是	长度单位
商品重量	weight	String	是	商品重量
重量单位	weightUnit	String	是	重量单位
备注	remark	String	是	备注
商品简要描述	summary	String	是	商品简要描述
商品详情HTML	details	String	是	商品详情HTML
创建时间	createTime	String	是	格式`yyyy-MM-dd HH:mm:ss`
更新时间	updateTime	String	是	格式`yyyy-MM-dd HH:mm:ss`
商品属性	properties	Object	是	示例： { "材质": "纯棉", "适用季节": "夏季" }
SKU列表	skuList	Array	是	元素结构见下述"skuList节点"
主图列表	mainImageList	Array	是	元素结构见下述"image节点"
3:4图片列表	threeFourRatioImageList	Array	是	元素结构见下述"image节点"
长图	longImage	Object	是	结构见下述"image节点"
透明素材图	transparentImage	Object	是	结构见下述"image节点"
白底图	whiteBackgroundImage	Object	是	结构见下述"image节点"
视频列表	videoList	Array	是
规格定义	skcList	Array	是	元素结构见下述"skcList节点"

skuList

名称	字段	类型	必须	描述
SKU ID	id	String	是	SKU ID
SKU编码	skuNo	String	是	SKU编码
条码	barcode	String	是	条码
SKU价格	price	String	是	SKU价格
SKU库存	stock	Integer	是	SKU库存
规格映射	specMapping	Object	是	key为规格名，value为`{"valueName":"规格值"}`
规格图列表	skuPreviewImageList	Array	是	元素结构见下述"image节点"

image

名称	字段	类型	必须	描述
图片ID	imgId	String	是	图片ID
图片类型	bizType	Integer	是	图片类型
图片URL	imageUrl	String	是	图片URL
图片宽度	imgWidth	Integer	是	图片宽度
图片高度	imgHeight	Integer	是	图片高度
文件大小	fileSize	String	是	文件大小

skcList

名称	字段	类型	长度	必须	描述
规格名称	specName	String		是	如"颜色"
规格值	specValueList	Array		是	示例：[ { "specValueName": "红色" } ]

5.请求示例

PHP

<?php
    require_once '../WdtClient.php';
    $c = new WdtClient();
    $c->sid = '';
    $c->appkey = '';
    $c->appsecret = '';
    $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/pdk_basic_spu_detail_query.php';

    $c->putApiParam('spuId', '123456789012345678');
    // $c->putApiParam('spuNo', 'SPU-20260825-001');
    // $c->putApiParam('gxGoodsId', '1011468');

    $json = $c->wdtOpenApi();
    var_dump($json);
?>

JAVA

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "message": null,
    "data": {
        "id": "123456789012345678",
        "spuNo": "SPU-20260825-001",
        "spuName": "夏季纯棉短袖",
        "outerSpuNo": "ERP-SPU-001",
        "sourceShopId": "0",
        "sourceType": 2,
        "sourcePlatformId": 0,
        "outerBrandName": "示例品牌",
        "gxGoodsType": 0,
        "gxGoodsId": "0",
        "supplierSid": null,
        "supplierGoodsId": null,
        "categoryId": "10001",
        "categoryNamePath": "服装/男装/T恤",
        "salesPrice": "99.9",
        "priceCurrency": "CNY",
        "stock": 100,
        "length": "30",
        "width": "20",
        "height": "5",
        "lengthUnit": "CM",
        "weight": "0.25",
        "weightUnit": "kg",
        "remark": "",
        "summary": "夏季纯棉短袖",
        "details": "<p>商品详情</p>",
        "properties": {
            "材质": "纯棉",
            "适用季节": "夏季"
        },
        "skuList": [
            {
                "id": "123456789012345679",
                "skuNo": "SKU-RED-M",
                "barcode": "6900000000001",
                "price": "99.9",
                "stock": 100,
                "specMapping": {
                    "颜色": { "valueName": "红色" },
                    "尺码": { "valueName": "M" }
                },
                "skuPreviewImageList": [
                    {
                        "imgId": "123456789012345680",
                        "bizType": 4,
                        "imageUrl": "https://example.com/images/red.jpg",
                        "imgWidth": 800,
                        "imgHeight": 800,
                        "fileSize": "102400"
                    }
                ]
            }
        ],
        "mainImageList": [
            {
                "imgId": "123456789012345681",
                "bizType": 1,
                "imageUrl": "https://example.com/images/main.jpg",
                "imgWidth": 800,
                "imgHeight": 800,
                "fileSize": "204800"
            }
        ],
        "threeFourRatioImageList": [],
        "longImage": null,
        "transparentImage": null,
        "whiteBackgroundImage": null,
        "videoList": [],
        "skcList": [
            {
                "specName": "颜色",
                "specValueList": [ { "specValueName": "红色" } ]
            }
        ],
        "createTime": "2026-08-25 10:00:00",
        "updateTime": "2026-08-25 10:00:00"
    }
}

6.2 异常响应示例

JSON	{ "code": 10000, "message": "商品不存在", "data": null }