当前位置: API文档

pdk_basic_spu_query.php(分页查询铺货基础商品)

¥标准

1.接口说明

1.1 接口描述:根据商品编号、名称、来源、类目、SKU编码、供销商品类型等条件分页查询基础商品。
1.2 适用版本:网页版
1.3 增量获取:按照创建时间获取
1.4 时间跨度:start_time和end_time最大跨度为30天。
1.5注意事项:


2.调用场景

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


3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapi.ali.huice.cc/openapi/pdk_basic_spu_query.php
正式环境https://openapi.huice.com/openapi/pdk_basic_spu_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 业务请求参数

名称字段类型长度
必须描述
页码pageNoInteger

从`0`开始,默认`0`(第一页)
每页数量pageSizeInteger
默认 50,最大生效值为 100
是否计算总数calcTotalCountBoolean

默认第一页计算,其他页不计算
SPU ID列表spuIdsArray

传入后忽略其他查询条件
内部商品编号spuNoString
内部商品编号
编号匹配方式spuNoTypeInteger
`1`模糊查询,`2`精确查询
商品名称spuNameString
商品名称
名称匹配方式spuNameTypeInteger
`1`模糊查询,`2`精确查询
外部商品编号outerSpuNoString
按前缀匹配
商品来源sourceInteger
商品来源
创建时间开始createTimeStartString
格式`yyyy-MM-dd HH:mm:ss` 
创建时间结束createTimeEndString
格式`yyyy-MM-dd HH:mm:ss`
完善状态对应平台IDcompletePlatformInteger
完善状态对应平台ID
完善状态completeStatusInteger
需配合`completePlatform`使用
备注remarkString
模糊查询
基础类目IDcategoryIdLong
基础类目ID
SKU编码skuNoString
SKU编码
SKU匹配方式skuNoTypeInteger
 `1`模糊查询,`2`精确查询  
供销商品类型gxGoodsTypeInteger
`0`非供销商品、`1`供销商品、`2`分销商品
创建人createdByString
创建人

4.响应参数

   4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeint11状态码:0表示成功,其他表示失败
错误描述messagevarchar255错误描述
分页数据dataObject

见下述"data节点"  

   4.2 业务响应参数

       data节点(分页

名称字段类型长度
必须描述
总记录数totalCountInteger
满足条件的总记录数
商品列表dataArray

当前页商品列表,元素结构见下述"商品节点"


     data[]节点(商品数据

名称字段类型长度
必须描述
基础商品IDidString
基础商品ID
第一张主图mainImageString

第一张主图
预览原图previewUrlString
预览原图
内部商品编号spuNoString
内部商品编号
商品名称spuNameString

商品名称
外部商品编号outerSpuNoString
外部商品编号
来源店铺IDsourceShopIdString
来源店铺ID
来源店铺名称sourceShopNameString

来源店铺名称
外部品牌名称outerBrandNameString
外部品牌名称
商品来源sourceTypeInteger
0其他、1ERP、2手工创建、3供销平台、4店铺导入、5Excel导入
供销商品类型gxGoodsTypeInteger

0非供销商品、1供销商品、2分销商品
供销商品IDgxGoodsIdString
供销商品ID
来源平台IDsourcePlatformIdInteger
来源平台ID
基础类目IDcategoryIdString

基础类目ID
类目名称categoryNameString
类目名称
已完善平台列表completePlatformListArray<Integer>
已完善平台列表
未完善平台列表incompletePlatformListArray<Integer> 

未完善平台列表
已发布店铺列表publishShopListArray<Integer> 
已发布店铺列表
备注remarkString
备注
商品简要描述summary


商品简要描述
商品详情HTMLdetails

商品详情HTML
主图URLmainImages

主图URL,多个以逗号分隔
3:4图片URLthreeFourImages


主图URL,多个以逗号分隔
白底图URLwhiteBgImage

白底图URL
长图URLlongImage

长图URL
透明素材图URLtransparentImage

透明素材图URL
创建人createdBy

创建人
更新人updateBy

更新人
创建时间createTime

格式`yyyy-MM-dd HH:mm:ss` 
更新时间updateTime

格式`yyyy-MM-dd HH:mm:ss` 
商品标签列表labelsArray
示例:[{"labelId","labelName","labelType"}]
SKU列表skuListArray
元素结构见下述"SKU节点"


skuList

名称字段类型长度
必须描述
SKU IDidString
SKU ID
SKU名称nameString
SKU名称
SKU编码skuNoString
SKU编码
SKU库存stockInteger
SKU库存
SKU销售价priceString
SKU销售价
SKU重量weight

SKU重量
条码barcode

条码
第一层规格名spec1Name

第一层规格名
第一层规格值spec1

第一层规格值
第二层规格名spec2Name

第二层规格名
第二层规格值spec2

第二层规格值
规格图URLspecImage

规格图URL


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_query.php';

    $c->putApiParam('pageNo', '0');           
    $c->putApiParam('pageSize', '20');
    $c->putApiParam('calcTotalCount', 'true');
    $c->putApiParam('spuNo', 'SPU-2026');
    $c->putApiParam('spuNoType', '1');        
    $c->putApiParam('spuName', '短袖');
    $c->putApiParam('spuNameType', '1');
    $c->putApiParam('createTimeStart', '2026-08-01 00:00:00');
    $c->putApiParam('createTimeEnd', '2026-08-31 23:59:59');

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

C#

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": null,
    "data": {
        "data": [
            {
                "id": "123456789012345678",
                "mainImage": "https://example.com/images/main.jpg",
                "previewUrl": null,
                "spuNo": "SPU-20260825-001",
                "spuName": "夏季纯棉短袖",
                "outerSpuNo": "ERP-SPU-001",
                "sourceShopId": "0",
                "sourceShopName": null,
                "outerBrandName": "示例品牌",
                "sourceType": 2,
                "gxGoodsType": 0,
                "gxGoodsId": "0",
                "sourcePlatformId": 0,
                "categoryId": "10001",
                "categoryName": "T恤",
                "completePlatformList": null,
                "incompletePlatformList": null,
                "publishShopList": null,
                "skuList": [
                    {
                        "id": "123456789012345679",
                        "name": "颜色:红色;尺码:M",
                        "skuNo": "SKU-RED-M",
                        "stock": 100,
                        "price": "99.9",
                        "weight": "0.25",
                        "barcode": "6900000000001",
                        "spec1Name": "颜色",
                        "spec1": "红色",
                        "spec2Name": "尺码",
                        "spec2": "M",
                        "specImage": "https://example.com/images/red.jpg"
                    }
                ],
                "remark": "",
                "summary": "夏季纯棉短袖",
                "details": "<p>商品详情</p>",
                "mainImages": "https://example.com/images/main.jpg",
                "threeFourImages": "https://example.com/images/three-four.jpg",
                "whiteBgImage": "https://example.com/images/white.jpg",
                "longImage": "https://example.com/images/long.jpg",
                "transparentImage": "https://example.com/images/transparent.png",
                "createdBy": "system",
                "updateBy": "system",
                "createTime": "2026-08-25 10:00:00",
                "updateTime": "2026-08-25 10:00:00",
                "labels": []
            }
        ],
        "totalCount": 1
    }
}

   6.2 异常响应示例

JSON
{
  "code": 10000,
  "message": "查询失败原因",
  "data": null
}




常用工具