当前位置: API文档

¥标准

1.接口说明

1.1 接口描述:①批量推送货品资料给旺店通ERP②批量更新旺店通ERP货品档案资料(支持已经存在的货品(spu),新增单品(sku),good_list中good_no确定sku新增在哪个货品之下,将新增的spec_no以及对应信息放在spec_list,推送成功以后,sku将新增到对应的货品档案(spu)下。)                   
1.2 适用版本:网页版

1.3 注意事项:更新货品档案时,good_no确认要更新的spu属性信息,good_no+spec_no确认要更新的sku属性信息。更新货品(spu)数据时,good_list中good_no对应的数据做变更,spec_list要包含至少一个已经存在的单品(sku)数据。更新单品(sku)数据时,good_list中good_no对应的数据不变,spec_list中spec_no对应的数据做变更,重新推送成功后,变更部分将会更新到ERP

支持批量推送数据,每个请求建议包含50条以下的“goods_list”数据;goods_list下的spec_list条数不要超过500条

2.调用场景

2.1 自研商城、

3.请求参数说明

   3.1 请求地址

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

名称字段类型长度必须描述
货品节点goods_listdata[ ]
请求参数的1级数据节点,包含SPU所有属性信息的数据节点,节点下数据字段详见下述“goods_list”

goods_list

名称字段类型长度必须描述
货品编号goods_novarchar40代表货品(spu)所有属性的唯一编号,用于系统货品区分,,SPU概念介绍,单击这里
货品名称goods_namevarchar255货品名称
货品简称short_namevarchar255货品简称
品牌brand_namevarchar64品牌名称
备注remarkvarchar512备注
自定义属性1spu_prop1varchar255自定义属性1
自定义属性2spu_prop2varchar255自定义属性2
自定义属性3spu_prop3varchar255自定义属性3
自定义属性4spu_prop4varchar255自定义属性4
自定义属性5spu_prop5varchar255自定义属性5
自定义属性6spu_prop6varchar255自定义属性6
单品节点spec_listdata[]
请求参数的2级数据节点,包含sku所有属性信息的数据节点,节点下数据字段详见下述"spec_list"

spec_list

名称字段类型长度必须描述
商家编码spec_novarchar40代表单品(sku)所有属性的唯一编码,用于系统单品区分,SKU概念介绍单击这里
主条码barcodevarchar50主条码
规格名称spec_namevarchar100规格名称
最低价lowest_pricedecimal19,4最低价 同ref_cost_price作为成本价
图片url地址img_urlvarchar1024图片url地址
零售价retail_pricedecimal19,4商品标价,系统内手工建单时使用,传值时需谨慎
批发价wholesale_pricedecimal19,4批发价
成本价ref_cost_pricedecimal19,4成本价
重量weightdecimal19,4ERP默认重量单位:kg
lengthdecimal19,4长(CM)
widthdecimal19,4宽(CM)
heightdecimal19,4高(CM)
备注spec_remarkvarchar512备注
规格自定义属性1prop1varchar255规格自定义属性1
规格自定义属性2prop2varchar255规格自定义属性2
规格自定义属性3prop3varchar255规格自定义属性3
规格自定义属性4prop4varchar255规格自定义属性4
规格自定义属性5prop5varchar255规格自定义属性5
规格自定义属性6prop6varchar255规格自定义属性6
规格自定义属性7prop7varchar255规格自定义属性7
规格自定义属性8prop8varchar255规格自定义属性8
规格自定义属性9prop9varchar255规格自定义属性9
规格自定义属性10prop10varchar255规格自定义属性10

4.响应参数

   4.1 公共响应参数

名称字段类型长度必须描述
错误码codeint11状态码:0表示成功,其他表示失败
错误描述messagevarchar255错误描述
处理失败的错误列表errorsdatadata[]处理失败的错误列表,当code为0且有错误信息时才非空.只列出同一批内有错误的记录.如果code=0,errors为空说明全部成功

   4.2 业务响应参数

   errors

名称字段类型长度必须描述
错误的货品编号goods_novarchar40错误的goods_no
错误信息的描述errorvarchar255错误信息的描述


5.请求示例

PHP
<?php
    require_once('../WdtClient.php');
    $c = new WdtClient;
    //sid appkey appsecret 需要换成自己的
    $c->sid = '';
    $c->appkey = '';
    $c->appsecret = '';
    //测试环境地址
    //上线时需要换成线上的
    $c->gatewayUrl = 'https://openapitest.huice.com/openapi/goods_push.php'; // 测试的
    //$c->gatewayUrl = 'https://openapi.huice.com/openapi/goods_push.php'; //正式的
   
    $goods_list = new stdClass();
    $goods_list->goods_no = "test1";
    $goods_list->goods_name = "test1";
    $goods_list->short_name = "简称";
    $goods_list->brand_name = "测试品牌";
    $goods_list->remark = "备注";


    $spec_item = new stdClass();

    $spec_item->spec_no = "test1";                  // 商家编码
  //  $spec_item->barcode = "1234567890123";         // 主条码
  //  $spec_item->spec_name = "商品规格名称";          // 规格名称
    $spec_item->lowest_price = 10.50;              // 最低价
   // $spec_item->img_url = "http://example.com/img.jpg"; // 图片url地址
   // $spec_item->retail_price = 15.00;              // 零售价
  //  $spec_item->wholesale_price = 12.00;          // 批发价
 //   $spec_item->ref_cost_price = 9.00;             // 成本价
  //  $spec_item->weight = 0.5;                      // 重量 (kg)
    //$spec_item->length = 10.0;                     // 长 (CM)
   // $spec_item->width = 5.0;                       // 宽 (CM)
  //  $spec_item->height = 2.0;                      // 高 (CM)
 //   $spec_item->spec_remark = "这是备注信息";        // 备注
    $goods_list->spec_list = [$spec_item];
    $goods_lists = [$goods_list];
    $c->putApiParam("goods_list", json_encode($goods_lists, JSON_UNESCAPED_UNICODE));
   //$c->putApiParam("goods_list", '[{"goods_no":"T20240805001","goods_name":"T20240805001","spec_list":[{"spec_no":"SPE20240805001","spec_name":"商城测试sku1"}]}]');

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

C#

python

6.响应示例

   6.1 正常响应示例 

JSON
{"code":0,"message":"","errors":[]}

   6.2 异常响应示例

JSON
{"code":0,"message":"","errors":[{"goods_no":null,"error":"货品名称不能为空"}]}




常用工具