当前位置: API文档

pdk_basic_spu_detail_query.php(查询铺货基础商品详情)

¥标准

1.接口说明

1.1 接口描述:查询铺货基础商品详情
1.2 适用版本:网页版
1.3 增量获取:根据基础商品ID、内部商品编号或供销平台商品ID,查询基础商品完整详情。

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

如果用spuId查询是,查询的为铺货副本信息,更新数据可能存在查不到的情况;gxGoodsId是直接调用供销接口查询,可获取准确信息


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 公共请求参数

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

   3.3 业务请求参数

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

4.响应参数

   4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeInteger
是状态码:0表示成功,其他表示失败
错误描述messageString
是错误描述
商品详情dataObject
是
商品详情节点,见下述"data节点"

   4.2 业务响应参数

       data

名称字段类型长度
必须描述
基础商品IDidString
是基础商品ID
内部商品编号spuNoString
是
内部商品编号
商品名称spuNameString
是商品名称
外部商品编号outerSpuNoString
是外部商品编号
来源店铺IDsourceShopIdString
是来源店铺ID
商品来源sourceTypeInteger
是0其他、1ERP、2手工创建、3供销平台、4店铺导入、5Excel导入
来源平台IDsourcePlatformIdInteger
是来源平台ID
外部品牌名称outerBrandNameString
是外部品牌名称
供销商品类型gxGoodsTypeInteger
是0非供销商品、1供销商品、2分销商品
供销商品IDgxGoodsIdString
是供销商品ID
供应商租户IDsupplierSidString
是供应商租户ID
供应商商品IDsupplierGoodsIdString
是供应商商品ID
基础类目IDcategoryIdString
是基础类目ID
类目名称路径categoryNamePathString
是类目名称路径
商品销售价salesPriceString
是商品销售价
币种priceCurrencyString
是币种
商品库存stockInteger
是商品库存
商品长度lengthString
是商品长度
商品宽度widthString
是商品宽度
商品高度heightString
是商品高度
长度单位lengthUnitString
是长度单位
商品重量weightString
是商品重量
重量单位weightUnitString
是重量单位
备注remarkString
是备注
商品简要描述summaryString
是商品简要描述
商品详情HTMLdetailsString
是商品详情HTML
创建时间createTimeString
是格式`yyyy-MM-dd HH:mm:ss`
更新时间updateTimeString
是格式`yyyy-MM-dd HH:mm:ss`
商品属性propertiesObject
是示例:

{

            "材质": "纯棉",

            "适用季节": "夏季"

  }

SKU列表skuListArray
是元素结构见下述"skuList节点"
主图列表mainImageListArray
是元素结构见下述"image节点" 
3:4图片列表threeFourRatioImageListArray
是元素结构见下述"image节点"
长图longImageObject
是结构见下述"image节点"
透明素材图transparentImageObject
是结构见下述"image节点"
白底图whiteBackgroundImageObject
是结构见下述"image节点"
视频列表videoListArray
是
规格定义skcListArray
是元素结构见下述"skcList节点" 


   skuList

名称字段类型长度
必须描述
SKU IDidString
是SKU ID
SKU编码skuNoString
是SKU编码
条码barcodeString
是条码
SKU价格priceString
是SKU价格
SKU成本价costPriceString
是成本价,以金额字符串返回;非供销商品、扩展信息不存在或者未维护对应价格时返回Null,不默认补零
SKU分销状态distributionStatusString
是SKU的分销状态:0 上架, 1 下架;未提供状态时返回null,不默认视为上架或者下架
SKU库存stockInteger
是SKU库存
规格映射specMappingObject
是key为规格名,value为`{"valueName":"规格值"}` 
规格图列表skuPreviewImageListArray
是元素结构见下述"image节点"

 image

名称字段类型长度
必须描述
图片IDimgIdString
是图片ID
图片类型bizTypeInteger
是图片类型
图片URLimageUrlString
是图片URL
图片宽度imgWidthInteger
是图片宽度
图片高度imgHeightInteger
是图片高度
文件大小fileSizeString
是文件大小

 skcList

名称字段类型长度
必须描述
规格名称specNameString
是如"颜色" 
规格值specValueListArray
是示例:[ { "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

C#

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
}




常用工具