当前位置: API文档

pdk_basic_spu_create.php(创建铺货基础商品资料)

¥标准

1.接口说明

1.1 接口描述:创建一条铺货基础商品资料,返回创建成功后的基础商品ID
1.2 适用版本:网页版
1.3注意事项:


2.调用场景

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


3.请求参数说明

   3.1 请求地址

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

名称字段类型长度必须描述
商品编号spuNoString

内部商品编号,租户内唯一

商品名称spuNameString
商品名称
基础类目IDcategoryIdString/Long
默认'0'
外部商品编号
outerSpuNoString
外部商品编号
外部品牌名称outerBrandNameString
外部品牌名称
品牌brandString
品牌
商品销售价salesPriceNumber/String
商品销售价
商品库存stockInteger
商品库存
商品重量weightNumber/String
商品重量
重量单位weightUnitString
`kg`、`g`,默认`kg` 
长度lengthNumber/String
长度
宽度widthNumber/String
宽度
高度heightNumber/String
高度
长度单位lengthUnitString
`M`、`DM`、`CM`、`MM`,默认`CM` 
备注remarkString
备注
商品简要描述summaryString
商品简要描述
商品详情HTMLdetailsString
商品详情HTML
商品属性propertiesObject
如`{"材质":"纯棉","适用季节":"夏季"}`
商品主图URL列表mainImageUrlsArray
如`["https://xxx/a.jpg"]`  
3:4图片URL列表threeFourRatioImageUrlsArray
如`["https://xxx/a.jpg"]` 
长图URLlongImageUrlString
如 "https://xxx/a.jpg"
白底图URLwhiteBackgroundImageUrlString
如 "https://xxx/a.jpg"
透明素材图URLtransparentImageUrlString
如 "https://xxx/a.jpg"
SKU列表skuListArray[]
至少传一个,元素结构见下述"skuList"


   skuList[]

名称字段类型长度必须描述
SKU编码
skuNoString
租户内唯一
SKU销售价priceNumber/String
SKU销售价
SKU库存stockInteger
SKU库存
SKU重量weightNumber/String
SKU重量
条码barcodeString
条码
规格映射specMapObject
建议是格式"规格名→规格值",如`{"颜色":"红色","尺码":"M"}`
规格图列表specImageUrlsArray
如`["https://xxx/a.jpg"]`  



4.响应参数


   4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeInteger
状态码:0表示成功,其他表示失败
错误描述messageString
失败时的错误描述
商品IDdataString
创建成功后的基础商品ID

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

    $c->putApiParam('spuNo', 'SPU-20260825-001');
    $c->putApiParam('spuName', '夏季纯棉短袖');
    $c->putApiParam('categoryId', '10001');
    $c->putApiParam('outerSpuNo', 'ERP-SPU-001');
    $c->putApiParam('outerBrandName', '示例品牌');
    $c->putApiParam('salesPrice', '99.90');
    $c->putApiParam('stock', '200');
    $c->putApiParam('weight', '0.25');
    $c->putApiParam('weightUnit', 'kg');
    $c->putApiParam('length', '30');
    $c->putApiParam('width', '20');
    $c->putApiParam('height', '5');
    $c->putApiParam('lengthUnit', 'CM');
    $c->putApiParam('summary', '夏季纯棉短袖');
    $c->putApiParam('details', '<p>商品详情</p>');
    $c->putApiParam('properties', json_encode(array('材质' => '纯棉', '适用季节' => '夏季'), JSON_UNESCAPED_UNICODE));
    $c->putApiParam('mainImageUrls', json_encode(array('https://example.com/images/main-1.jpg', 'https://example.com/images/main-2.jpg')));
    $c->putApiParam('threeFourRatioImageUrls', json_encode(array('https://example.com/images/three-four.jpg')));
    $c->putApiParam('longImageUrl', 'https://example.com/images/long.jpg');
    $c->putApiParam('whiteBackgroundImageUrl', 'https://example.com/images/white.jpg');
    $c->putApiParam('transparentImageUrl', 'https://example.com/images/transparent.png');

    $skuList = array(
        array(
            'skuNo' => 'SKU-RED-M',
            'price' => '99.90',
            'stock' => 100,
            'weight' => '0.25',
            'barcode' => '6900000000001',
            'specMap' => array('颜色' => '红色', '尺码' => 'M'),
            'specImageUrls' => array('https://example.com/images/red.jpg')
        ),
        array(
            'skuNo' => 'SKU-RED-L',
            'price' => '109.90',
            'stock' => 100,
            'weight' => '0.26',
            'barcode' => '6900000000002',
            'specMap' => array('颜色' => '红色', '尺码' => 'L'),
            'specImageUrls' => array('https://example.com/images/red.jpg')
        )
    );
    $c->putApiParam('skuList', json_encode($skuList, JSON_UNESCAPED_UNICODE));

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

C#

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": null,
    "data": "123456789012345678"
}

   6.2 异常响应示例

JSON
{
    "code": 10010,
    "message": "编码重复",
    "data": null
}




常用工具