当前位置： API文档

goods.Goods.push（货品推送）

¥标准

1.接口说明

1.1 接口描述：①推送货品资料给ERP ②更新ERP货品档案资料
1.2 适用版本：客户端 V1.3.8.7及以上版本

1.3注意事项：（1）该接口是pushGoods的替代接口. 接口以goods_no和spec_no来匹配货品和单品, 所以如果接口传入已经存在的goods_no或spec_no的时候对应的操作是修改操作。

                  （2）spu维度一次只能推一条，一个货品可以推送多条明细

2.调用场景

2.1 举例说明：自研商城、SCM、SRM、财务系统、SAP等系统的对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://47.92.239.46/openapi
正式环境http://wdt.wangdian.cn/openapi

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
是卖家账号, 由旺店通分配
接口账号keyString
是由旺店通分配appkey, 在发送的数据中对应 key 字段
盐saltString
是由旺店通分配appsecret，是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
是调用的接口名称
版本号vString
是1.0
秒级时间戳timestampint
是秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
是签名

   3.3 业务请求参数

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

货品信息


goodsInfo

Map<String,Object>


是

货品信息


单品信息列表specInfoList

List<Map<String, Object>>


是规格信息列表

goodsInfo






货品编号

goods_no

String

40

Y

货品编号

货品名称

goods_name

String

255

Y

货品名称’

分类名称

class_name

String

64

N

分类名称,不传或为空则默认为’无’

品牌名称

brand_name

String

64

N

品牌名称, 不传或为空则默认为’无’

基本单位名称

unit_name

String

20

N

基本单位名称, 不传或为空则默认为’无’

辅助单位名称

aux_unit_name

String

20

N

辅助单位名称, 不传或为空则默认为’无’

标记名称

flag_name

String

32

N

货品标记名称, 不传或为空则默认为’无’

货品类别

goods_type

Int


4

N

默认0, 

0：其它

1：销售货品

2：原材料

3：包装物

4：周转材料

5：虚拟商品

6：固定资产

8：分装箱

货品简称

short_name

String


255

N

货品简称

货品别名

alias

String


255

N

货品别名

产地

origin

String


64

N

产地

备注

remark

String


512

N

货品备注

货品自定义属性1

prop1

String

255

N

货品自定义属性1

货品自定义属性2

prop2

String

255

N

货品自定义属性2

货品自定义属性3

prop3

String

255

N

货品自定义属性3

货品自定义属性4

prop4

String

255

N

货品自定义属性4

货品自定义属性5

prop5

String

255

N

货品自定义属性5

货品自定义属性6

prop6

String

255

N

货品自定义属性6

是否自动创建品牌和分类

auto_create_bc

bool

1

N

如果品牌,分类不存在,是否自动创建.不填默认为false

specInfoList




名称

字段

类型

长度

是否必须

描述

商家编码

spec_no

String

40

Y

商家编码

规格码

spec_code

String

40

Y

规格码

条码

barcode

String

50

N

条码

规格名称

spec_name

String

100

Y

规格名称

仓库流程

wms_process_mask

Int

4

N

默认0 （需要的仓库流程相加）

2、无需验货 8、需要质检 16、无需拣货

32、无需唯一码

64、无需自动打印吊牌

货品标签

goods_label

String

11

N

默认无,可选值:自定义货品标签的名称(参考属性名称编辑页面->货品标签)多个标签使用英文逗号拼接

启用序列号

sn_type

Int

4

N

默认0,0不启用序列号 1强序列号 2弱序列号

最低价

lowest_price

Decimal(19,4)


N

最低价

零售价

retail_price

Decimal(19,4)


N

零售价

批发价

wholesale_price

Decimal(19,4)


N

批发价

会员价

member_price

Decimal(19,4)


N

会员价

市场价

market_price

Decimal(19,4)


N

市场价

有效期天数

validity_days

Int

6

N

有效期天数

最佳销售天数

sales_days

Int

11

N

最佳销售天数

最佳收货天数

receive_days

Int

11

N

最佳收货天数

重量

weight

Decimal(19,4)


N

重量

高

height

Decimal(19,4)


N

高

长

length

Decimal(19,4)


N

长

宽

width

Decimal(19,4)


N

宽

拆分

large_type

Int

4

N

默认0, 0非大件1普通大件2独立大件（不可和小件一起发) 3按箱规拆分 -1非单发件

单品自定义属性1

prop1

String

255

N

单品自定义属性1

单品自定义属性2

prop2

String

255

N

单品自定义属性2

单品自定义属性3

prop3

String

255

N

单品自定义属性3

单品自定义属性4

prop4

String

255

N

单品自定义属性4

单品自定义属性5

prop5

String

255

N

单品自定义属性5

单品自定义属性6

prop6

String

255

N

单品自定义属性6

自定义价格1

custom_price1

Decimal(19,4)


N

自定义价格1

自定义价格2

custom_price2

Decimal(19,4)


N

自定义价格2

允许低于成本

is_lower_cost

boolean

1

N

默认0,0:不允许,1 允许

图片链接

img_url

String

1024

N

图片链接

单品备注

remark

String

512

N

单品备注

销售积分

sale_score

Decimal(19,4)


N

销售积分

打包积分

pack_score

Decimal(19,4)


N

打包积分

拣货积分

pick_score

Decimal(19,4)


N

拣货积分

分拣积分

sort_score

Decimal(19,4)


N

分拣积分

扫描积分

scan_score

Decimal(19,4)


N

扫描积分

补货积分

supply_score

Decimal(19,4)


N

补货积分

上架积分

shelve_score

Decimal(19,4)


N

上架积分

入库积分

stockin_score

Decimal(19,4)


N

入库积分

质检积分

inpsect_score

Decimal(19,4)


N

质检积分

税务编码

tax_code

String

40

N

税务编码

基本单位名称

unit_name

String

20

N

基本单位名称

辅助单位名称

aux_unit_name

String

20

N

辅助单位名称

4.响应参数

名称字段类型长度
必须描述
状态码statusInt
是

0表示成功推送。

货品iddataInt
否

调用成功返回货品id,调用失败不返回该字段

返回信息message

String


否如果创建/修改成功message内容为空,否则为错误信息

5.请求示例

json格式请求报文
[{
"goods_no": "testGoodsQ03-26 00:51:10_0",
"goods_name": "testGoodsNameQ03-26 00:51:10_0",
"short_name": "shortName",
"auto_create_bc": true,
"class_name": "\u65b0\u5efa\u5206\u7c7b3",
"brand_name": "\u65b0\u5efa\u54c1\u724c3",
"unit_name": "\u4e2a",
"aux_unit_name": "\u4ef6",
"goods_type": 1,
"alias": "alias",
"pinyin": "ceshi",
"origin": "\u5185\u8499\u53e4\u547c\u548c\u6d69\u7279\u5e02",
"remark": "\u8d27\u54c1\u5907\u6ce8",
"prop1": "P1",
"prop2": "P2",
"prop3": "P13",
"prop4": "P14",
"prop5": "P15",
"prop6": "P16",
"flag_name": "g_f"
},
[{
"spec_no": "spec_noQ03-26 00:51:10_0_0",
"spec_name": "spec_nameQ03-26 00:51:10_0_0",
"spec_code": "spec_code",
"barcode": "spec_noQ03-26 00:51:10_0_0",
"pack_score": 12,
"lowest_price": 200,
"unit_name": "\u4e2a",
"aux_unit_name": "10\u4e2a",
"remark": "\u5355\u54c1\u5907\u6ce8",
"is_single_batch": 1,
"goods_label": 6
}, {
"spec_no": "spec_noQ03-26 00:51:10_0_1",
"spec_name": "spec_nameQ03-26 00:51:10_0_1",
"spec_code": "spec_code",
"barcode": "spec_noQ03-26 00:51:10_0_1",
"pack_score": 12,
"lowest_price": 200,
"unit_name": "\u4e2a",
"aux_unit_name": "10\u4e2a",
"remark": "\u5355\u54c1\u5907\u6ce8",
"is_single_batch": 1,
"goods_label": 6
}, {
"spec_no": "spec_noQ03-26 00:51:10_0_2",
"spec_name": "spec_nameQ03-26 00:51:10_0_2",
"spec_code": "spec_code",
"barcode": "spec_noQ03-26 00:51:10_0_2",
"pack_score": 12,
"lowest_price": 200,
"unit_name": "\u4e2a",
"aux_unit_name": "10\u4e2a",
"remark": "\u5355\u54c1\u5907\u6ce8",
"is_single_batch": 1,
"goods_label": 6
}, {
"spec_no": "spec_noQ03-26 00:51:10_0_3",
"spec_name": "spec_nameQ03-26 00:51:10_0_3",
"spec_code": "spec_code",
"barcode": "spec_noQ03-26 00:51:10_0_3",
"pack_score": 12,
"lowest_price": 200,
"unit_name": "\u4e2a",
"aux_unit_name": "10\u4e2a",
"remark": "\u5355\u54c1\u5907\u6ce8",
"is_single_batch": 1,
"goods_label": 6
}]
]
PHP
<?php
header("Content-Type: text/html; charset=UTF-8");
date_default_timezone_set("Asia/Shanghai");
require_once('wdtsdk.php');
 
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret");
 
$goodListNum = 2;
$specListNum = 4;
$editValue = "Q";
 
$goodsList = array();
 
//for ($i = 0; $i < $goodListNum; $i++) {
$i = 0;
$goods = new stdClass();
$goodsSuffix = $editValue.$dateStr."_".$i;
$goods->goods_no = "testGoods".$goodsSuffix;
$goods->goods_name = "testGoodsName".$goodsSuffix;
$goods->short_name = "shortName";
$goods->auto_create_bc = true;
$goods->class_name = "新建分类3";
$goods->brand_name = "新建品牌3";
$goods->unit_name = "个";
$goods->aux_unit_name = "件";
//$goods->cycle_name = "无";
$goods->goods_type = 1;
 
$goods->alias = "alias";
$goods->pinyin = "ceshi";
$goods->origin = "内蒙古呼和浩特市";
$goods->remark = "货品备注";
$goods->prop1 = "P1";
$goods->prop2 = "P2";
$goods->prop3 = "P13";
$goods->prop4 = "P14";
$goods->prop5 = "P15";
$goods->prop6 = "P16";
$goods->flag_name = 'g_f';
 
$specList = array();
for ($y = 0; $y < $specListNum; $y++) {
$specSuffix = $goodsSuffix."_".$y;
  $spec = new stdClass();
$spec->spec_no = 'spec_no'.$specSuffix;
$spec->spec_name = 'spec_name'.$specSuffix;
$spec->spec_code = 'spec_code';
$spec->barcode = $spec->spec_no;

$spec->pack_score = 12.0000;
$spec->lowest_price = 200.0000;
$spec->unit_name = '个';
$spec->aux_unit_name = '10个';
$spec->remark = '单品备注';
$spec->is_single_batch = 1;
$spec->goods_label = 6;
array_push($specList, $spec);
} 
$response = $client->call("goods.Goods.push ", $ goods, $ specList);
 
?>
JAVA

C#

6.响应示例

   6.1 正常响应示例 

JSON
{
"data": 101
}

   6.2 异常响应示例

JSON
{
"status": 100,
"message": "商家编码已存在"
}


常用工具