新建消费项目
新建商品后,可以通过编辑商品SKU接口编辑SKU
请求地址(POST)
https://openapi.1card1.cn/Special/Add_GoodsItem?openId=[OpenId]&signature=[Signature]×tamp=[TimeStamp]
字段 | 说明 |
---|---|
OpenId | 登陆开放平台生成的OpenId |
Signature | 签名=md5(OpenId+Secret+Timestamp+data),格式:32位md5大写加密 |
TimeStamp | 发起请求的时间戳,查看标准timestamp |
请求说明
data= {"barCode": "201202400","name":"康帅傅绿茶", "goodsItemTypeGuid" : "9C156524-38DE-E211-A4B1-A0E8599D15EA","imagePath":"", "userAccount":"10000","price":"50", "unit":"箱","referencePrice":"20","isBargain":"true", "bargainPrice":"40","allowBargainDiscount":"true" ,"allowBargainPoint":"true","meno":"备注", "description":"描述", "discountRate":"0.8","pointRate":"1.25","isPublishToMall":"false","marketPrice":"100","mallPrice":"20", "extValue": [{"颜色": "红","尺码":"M"}], "sku":[ { "spec1Guid":"badd83ea-ef85-11e8-917f-0010184dbd22", "spec1AttrGuid":"8a36f194-ef86-11e8-917f-0010184dbd22", "spec2Guid":"badf4f73-ef85-11e8-917f-0010184dbd22", "spec2AttrGuid":"8a3702e1-ef86-11e8-917f-0010184dbd22", "spec3Guid":"bae0f2cd-ef85-11e8-917f-0010184dbd22", "spec3AttrGuid":"8a370ba8-ef86-11e8-917f-0010184dbd22", "price":110, "referencePrice":"90", "skuCode":"ABCD1" },{ "spec1Guid":"badd83ea-ef85-11e8-917f-0010184dbd22", "spec1AttrGuid":"8a36f194-ef86-11e8-917f-0010184dbd22", "spec2Guid":"badf4f73-ef85-11e8-917f-0010184dbd22", "spec2AttrGuid":"8a3702e1-ef86-11e8-917f-0010184dbd22", "spec3Guid":"bae0f2cd-ef85-11e8-917f-0010184dbd22", "spec3AttrGuid":"8a37146c-ef86-11e8-917f-0010184dbd22", "price":120, "referencePrice":"90", "skuCode":"ABCD2" },{ "spec1Guid":"badd83ea-ef85-11e8-917f-0010184dbd22", "spec1AttrGuid":"8a36f194-ef86-11e8-917f-0010184dbd22", "spec2Guid":"badf4f73-ef85-11e8-917f-0010184dbd22", "spec2AttrGuid":"8a3702e1-ef86-11e8-917f-0010184dbd22", "spec3Guid":"bae0f2cd-ef85-11e8-917f-0010184dbd22", "spec3AttrGuid":"8a370fd7-ef86-11e8-917f-0010184dbd22", "price":130, "referencePrice":"90", "skuCode":"ABCD3", "imagePath":"https://files.1card1.cn/Platform/166631/20190722/d7c0b620bca84fb59802daa3ac9b6630.jpg" }] }
字段 | 是否必须 | 说明 |
---|---|---|
barCode | 是 | 商品编码 |
name | 是 | 商品名称 |
goodsItemTypeGuid | 是 | 商品类别(Guid)唯一标识(通过“获取商品类型列表”获得) |
userAccount | 是 | 工号 |
price | 是 | 价格 |
referencePrice | 是 | 进货价格 |
unit | 否 | 单位(如: 个 ,次, 罐 等) |
imagePath | 否 | 图片地址(通过“上传图片”获得)imagePath 字段 |
isBargain | 否 | 是否特价 |
bargainPrice | 否 | 特价价格(仅在isBargain = true时生效) |
allowBargainDiscount | 否 | 特价情况下是否允许打折(仅在isBargain = true时生效) |
allowBargainPoint | 否 | 特价情况下是否允许积分(仅在isBargain = true时生效) |
meno | 否 | 备注 |
description | 否 | 描述 |
discountRate | 否 | 折扣系数 |
pointRate | 否 | 积分系数 |
isPublishToMall | 否 | 是否上架(true表示上架,false表示下架,不填或者其他表示不进行上下架操作) |
marketPrice | 否 | 划线价(isPublishToMall为true时生效) |
mallPrice | 否 | 商城价(isPublishToMall为true时生效) |
extValue | 否 | 扩展字段(Json类型字符串数组) |
sku | 否 |
JSON数组,数组中每个元素包含一下字段:
spec1Guid:规格一唯一标识(Guid类型,必须),通过获取规格列表获得SpecGuid字段 spec2Guid:规格二唯一标识(Guid类型,与spec2AttrGuid共同生效,不需要此字段时不传此字段,不要传空字符串) spec3Guid:规格三唯一标识(Guid类型,与spec3AttrGuid共同生效,不需要此字段时不传此字段,不要传空字符串) spec1AttrGuid:规格一唯一标识(Guid类型,必须),通过获取属性列表获得SpecGuid字段 spec2AttrGuid:规格二唯一标识(Guid类型,与spec2Guid共同生效,不需要此字段时不传此字段,不要传空字符串) spec3AttrGuid:规格三唯一标识(Guid类型,与spec3Guid共同生效,不需要此字段时不传此字段,不要传空字符串) price:零售价 referencePrice:参考进货价 skuCode:SKU编码 imagePath:图片地址(通过“上传图片”获得)imagePath 字段 |
返回说明
成功时返回:
{"status":0,"goodsItemGuid":"357008AF-3805-4A39-9A12-5CE9BF364087","message":"消费项目添加成功"}}
失败时返回:
{"status":-1,"message":"消费项目添加失败"}
字段 | 是否必须 | 说明 |
---|---|---|
status | 是 | 状态(0,成功;-1,失败) |
message | 是 | 是否成功及提示 |