当前位置: API文档

goods.Goods.push2(货品推送2)

¥标准

1.接口说明

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

1.3注意事项:

(1)接口以goods_no和spec_no来匹配货品和单品, 所以如果接口传入已经存在的goods_no或spec_no的时候对应的操作是修改操作。

(2)spu维度一次只能推一条,一个货品可以推送多条明细

2.调用场景

2.1 举例说明:自研商城、SCMSRM、财务系统、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

N


规格码

条码

barcode

String

50

N

条码

规格名称

spec_name

String

100

N

规格名称

仓库流程

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

入库积分

质检积分

inspect_score

Decimal(19,4)


N

质检积分

分装积分

packing_score

Decimal(19,4)


N

分装积分

操作积分

operate_score

Decimal(19,4)


N

操作积分

称重积分

weigh_score

Decimal(19,4)


N

称重积分

发货积分

consign_score

Decimal(19,4)


N

发货积分

税务编码

tax_code

String

40

N

税务编码

基本单位名称

unit_name

String

20

N

基本单位名称

辅助单位名称

aux_unit_name

String

20

N

辅助单位名称

4.响应参数

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

0表示成功推送。

返回信息message

String


如果创建/修改成功message内容为空,否则为错误信息
品iddataMap<String,Object>

货品信息

data

名称
字段类型长度必须描述
货品idgoods_idInt
货品id
货品编号goods_noString

货品编号信息

单品信息
spec_info_listList<Map<String,Object>>
单品信息


spec_info_list:

名称字段类型长度必须描述
单品idspec_idInt
单品id
商家编码
spec_noString
商家编码





5.请求示例

json格式请求报文
[
    {
        "goods_name": "testGoodsNameQ11-21-09-46-14_0",
        "goods_no": "testGoodsQ11-21-09-46-14_0"
    },
    [
        {
            "aux_unit_name": "10个",
            "custom_price1": 77,
            "custom_price2": 7777,
            "is_single_batch": 1,
            "lowest_price": 200,
            "remark": "单品备注",
            "spec_no": "spec_noQ11-21-09-46-14_0_1",
            "unit_name": "个"
        }
    ]
]
PHP
<?php  
header("Content-Type: text/html; charset=UTF-8");  
date_default_timezone_set("Asia/Shanghai");  

$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret");
$goods = new stdClass();
$goods->goods_name = 'testGoodsNameQ11-21-09-46-14_0';
$goods->goods_no = 'testGoodsQ11-21-09-46-14_0';

$spec=new stdClass();
$spec->aux_unit_name = '10个';
$spec->custom_price1 = 77;
$spec->custom_price2 = 7777;
$spec->is_single_batch = 1;
$spec->lowest_price = 200;
$spec->remark = '单品备注';
$spec->spec_no = 'spec_noQ11-21-09-46-14_0_1';
$spec->unit_name = '个';

$specList = array();
array_push($specList, $spec);

$data = $client->call("goods.Goods.push2", $goods, $specList);
JAVA
C#

6.响应示

   6.1 正常响应示例 

JSON
{
    "data": {
        "goods_id": 20225796,
        "goods_no": "testGoodsQ11-21-09-46-14_0",
        "spec_info_list": [
            {
                "spec_id": 6726,
                "spec_no": "spec_noQ11-21-09-46-14_0_1"
            }
        ]
    },
    "status": 0
}

   6.2 异常响应示例

JSON
{
    "data": {
        "message": "未知错误"
    },
    "status": 100
}



常用工具