当前位置: 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
}




常用工具