md.shop.products.create (v1)

产品新增(支持多规格数据)

请求URL:

  • https://openapi.weixin12315.com/api/sign/md.shop.products/v1/create

请求方式:

  • POST

请求示例:

IAuth auth = new Sign("app_id", "app_secret"); 
IClient client = new SignClient(auth); 
IDictionary<string, object> parameters = new Dictionary<string, object>();
parameters.Add("SysCategroyID","2"); 
parameters.Add("GoodsName","加多宝"); 
parameters.Add("price",3); 
parameters.Add("originalprice",4.5); 
parameters.Add("authorintroduction","金罐加多宝");  
parameters.Add("stock",1000); 
parameters.Add("salecounts",100);  
parameters.Add("picurl1",""); 
parameters.Add("picurl2",""); 
parameters.Add("picurl3",""); 
parameters.Add("picurl4",""); 
parameters.Add("picurl5",""); 
parameters.Add("sequence",10); 
parameters.Add("unit","瓶");  
parameters.Add("points",10); 
parameters.Add("isformat",0); 
parameters.Add("weight",1); 
parameters.Add("Sequence",1); 
parameters.Add("isvirtual",0); 
parameters.Add("pronumber",""); 
parameters.Add("ProType",0); 
parameters.Add("ValidPeriod",0); 
parameters.Add("brandtradersname",""); 
parameters.Add("GoodsDesc",""); 
parameters.Add("barcode",""); 
parameters.Add("nosaletypeid","");  
string apiurl="https://openapi.weixin12315.com";
var result = client.Call(apiurl,"md.shop.products.create", "v1", "POST", parameters);

参数:


参数名必选类型说明
SysCategroyIDint系统类目Id
IsVirtualint商品类型/礼品类型 0:实物;1:虚拟票券2:联盟卡券;3:直充类
GoodsNamestring商品名称
PriceDecimal(9,2)价格(现价)
OriginalPriceDecimal(9,2)市场价格
AuthorIntroductionstring产品亮点
GoodsDescstring商品描述
PicUrlstring商品主图片Url
ProTypeint商品类别 0商品
Stockint库存量
Sequenceint排序
Unitstring产品单位
SaleCountsint全网销量
IsFormatint是否有规格 0:没有;1:有
WeightDecimal(9,2)产品重量
ProNumberstring商品编号
BrandTradersNamestring品牌名称
BarCodestring商品条码
ValidPeriodint有效期类型0:无有效期(礼品市场大礼包专有)1:长期有效2:领取后N天有效3:自定义日期
EffectiveDaysintValidPeriod为2时,此值有效
EffectDatedatetime生效日期,ValidPeriod为3时,此值有效
ExpireDatedatetime失效日期,ValidPeriod为3时,此值有效,并必须大于EffectDate
WarnStockint商品库存预警数量
DeliveryTypeint配送方式:0 商家配送 1 自提 2 在线交易 3快递配送(直营商品的配送方式)
GoodTypeint商品类型(当为云店商品时,来判断是否是直营商品)
Pointsint 商品积分
PackingRatioint商品包装比例,例如:5:1
GoodsPicListarray[object]商品图片
GoodsGraphicDescModelobject图文描述
GoodsSysSpecificationsListarray[object]商品系统规格
GoodsSpecificationsListarray[object]商品规格属性
GoodsForMatListarray[object]商品规格表
OnSaleGoodsModelobject在售商品实体
MicroMalRulesModelobject微商城规则实体
GoodsUnImportantAttrsModelobject非关键属性
GoodsCategoryListarray[object]分类信息
GoodsParametersListarray[object]商品参数

GoodsUnImportantAttrsCreateRequest:

参数名必选类型说明
HomeRecommendedint是否首页推荐 0 否 1 是
HomeRecommendedint是否首页推荐 0 否 1 是
IsPopularint是否人气产品 0 否 1 是
Remindedstring产品特别提醒
ActivityIDint活动id
IsQAint是否通过质量鉴证

GoodsCategoryList:

参数名必选类型说明
GoodsIDint商品Id
CategoryIdint分类ID
ParentIDint分类父ID
Typeint分类类型:0在售商品分类,1商品库分类 2 礼品分组
MallTypeint商城类型 0两者都是, 1微商城, 2小程序商城 


GoodsParametersList:

参数名必选类型说明
ParametersNamestring参数名称
Contentstring参数值
Sortint排序字段


GoodsPicList:

参数名必选类型说明
PicNamestring图片名称
PicUrlstring图片地址


GoodsGraphicDescModel:

参数名必选类型说明
GoodDesstring内容描述


GoodsSysSpecificationsList:

参数名必选类型说明
SIDint系统规格Id
FormartNamestring规格名称


GoodsSpecificationsList:

参数名必选类型说明
SIDint系统规格Id
SNamestring系统规格名称
GoodsFormartNamestring商品规格名称
ImgPathstring规格图片


GoodsForMatList:

参数名必选类型说明
ForMatIDsint产品规格属性Ids
ForMatNamesstring规格名称集合
ForMatPicUrlstring规格图片
PriceDecimal(9,2)价格
Stockint库存
SaleCountsint销量
GoodsNumberstring商品编号


OnSaleGoodsModel:

参数名必选类型说明
GoodNamestring商城标题
GoodChannelint商品出售渠道(1微商城,积分商城 3 云店小程序)
GoodPriceDecimal(9,2)商品价格
Statusint是否上架(0 仓库中 1已上架 2 不可售)
SaleTimeDateTime上架时间
PulishTimeDateTime发布时间
FTMIDint运费模版id
IsTimingint是否开启定时上架
Versionstring商品版本
OutIdstring外部商品id
GoodLimitationsint限购数量
IsPackageint是否包裹 0 否 1 是


MicroMalRulesModel:

参数名必选类型说明
IsOutBuyint购买方式(是否外部购买)
OutBuyUrlstring外部购买链接
OutButtonStrstring外部购买链接按钮文字
OrderLimitationsint每单限购数量
Pointsint赠送积分


返回数据:

错误数据:    
{    
    "return_code": -1,    
    "return_msg":"系统错误"    
}

正确数据:  
{    
    "return_code": 0,    
    "return_msg":"success" ,    
    "retrun_data":{        
        "id":1    
    }  
}

返回参数说明

参数名类型说明
return_codeint错误编码
return_msgint错误描述
retrun_datajosn添加成功后返回值( id:商城编号)

















API工具

SDK下载 调试工具