Appearance
创建商品（暂支持小程序商品）
请求路径
- 请求方式：
POST - 请求头：
Content-Type:application/json - 接口地址：
https://gateway.nuoyunapi.com/Api/GoodsBase/createGoods/2.0.0 - 频率限制：
10秒100次
请求参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| name | 是 | string | 商品名字 |
| underlined_price | 是 | number | 划线价格 |
| price | 是 | number | 价格 |
| pics | 是 | array | 图片数组，最多5张 |
| link_type | 是 | string | 购买方式：text文字链接，pic图片链接，local本地购买，applet小程序购买 |
| unit | 是 | string | 单位 |
| storage | 是 | integer | 商品库存 |
| applet_buy_conf_link | 是 | string | 小程序链接地址 |
| applet_buy_conf_original_id | 是 | string | 小程序原始id |
| applet_buy_conf_appid | 是 | string | 小程序appid |
| status | 否 | integer | 状态：1-正常，2-已下架 |
| sort_sn | 否 | integer | 商品排序 |
| buyer_message_sw | 否 | integer | 买家留言开关：1-开启，2-关闭 |
| buyer_message | 否 | string | 留言文案 |
| selling_point | 否 | string | 商品卖点 |
| is_can_refund | 否 | integer | 是否可以申请退款：1-可以申请，2-不能申请 |
| goods_encode | 否 | string | 商品编码 |
| delivery_method | 否 | integer | 实体商品配送方式：1-快递发货，2-自提，3-发货和自提 |
| is_to_store_discount | 否 | integer | 1-到店折扣，2-不是到店折扣 |
请求示例
json
{
"name": "菠萝-小程序--接口创建",
"underlined_price": 50,
"price": 20,
"pics": [
"https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/ConsoleWechat/35016/materialPic/202507110935371550418.jpg",
"https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/ConsoleWechat/35016/materialPic/202507110935371550418.jpg",
"https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/ConsoleWechat/35016/materialPic/202507110935371550418.jpg"
],
"link_type": "applet",
"unit": "个",
"status": 1,
"sort_sn": 100,
"buyer_message_sw": 2,
"buyer_message": "留言文案验证",
"selling_point": "商品卖点132",
"is_can_refund": 2,
"storage": 10001,
"goods_encode": "spbm123456",
"delivery_method": 2,
"applet_buy_conf_link": "/pages/tbccServce/tbccServce?type=activityPD20220524S00011434&activitySource=20&productsSource=2022SeptemberZB3333333",
"applet_buy_conf_original_id": "gh_e00595d90431222222",
"applet_buy_conf_appid": "wxab8ed3662e18633a11111",
"is_to_store_discount": 2
}响应参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | integer | 状态码：200-成功，400-失败 |
| msg | 是 | string | 提示信息 |
| data | 是 | object | 响应数据 |
data 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| id | 是 | integer | 商品ID |
响应示例
成功响应
json
{
"msg": "Success",
"code": 200,
"data": {
"id": 174929
}
}失败响应
json
{
"code": 400,
"msg": "商品名称不能为空",
"data": {}
}返回值状态码说明
| 状态码 | 描述 |
|---|---|
| 200 | 成功 |
| 400 | 失败 |
字段说明
购买方式 (link_type)
text：文字链接pic：图片链接local：本地购买applet：小程序购买（当前接口仅支持此类型）
商品状态 (status)
1：正常（上架状态）2：已下架
留言开关 (buyer_message_sw)
1：开启买家留言功能2：关闭买家留言功能
退款设置 (is_can_refund)
1：可以申请退款2：不能申请退款
配送方式 (delivery_method)
1：快递发货2：自提3：发货和自提
到店折扣 (is_to_store_discount)
1：到店折扣商品2：不是到店折扣商品
使用说明
1. 小程序商品配置
- 小程序链接 (
applet_buy_conf_link)：商品在小程序中的页面路径 - 小程序原始ID (
applet_buy_conf_original_id)：微信小程序的原始ID（gh_开头） - 小程序AppID (
applet_buy_conf_appid)：微信小程序的AppID
2. 商品图片
- 图片数量：最多支持5张图片
- 图片格式：建议使用HTTPS链接
- 图片大小：建议单张图片不超过2MB
3. 价格设置
- 销售价格 (
price)：实际售卖价格 - 划线价格 (
underlined_price)：原价或参考价格，通常高于销售价格
注意事项
- 接口限制：当前版本仅支持创建小程序商品（
link_type必须为applet） - 小程序信息：必须提供有效的小程序AppID、原始ID和链接地址
- 图片要求：商品图片必须可正常访问，建议使用CDN地址
- 库存管理：创建时需要设置初始库存，后续可通过其他接口调整
- 商品编码：建议设置唯一的商品编码便于管理
- 权限验证：需要确保有创建商品的权限
错误情况
| 错误信息 | 可能原因 | 解决方案 |
|---|---|---|
| 商品名称不能为空 | name 参数未提供 | 确保提供商品名称 |
| 价格不能为负数 | price 或 underlined_price 为负数 | 检查价格参数 |
| 图片格式不正确 | pics 中包含无效图片链接 | 检查图片链接有效性 |
| 小程序信息无效 | 小程序配置参数错误 | 确认小程序AppID等信息 |
| 权限不足 | 无创建商品权限 | 确认账号权限 |
业务场景
- 小程序电商：为小程序创建商品进行销售
- 直播带货：创建商品后添加到直播间进行推广
- 活动促销：设置划线价格展示优惠力度
- 库存管理：创建商品时设置初始库存
- 分类管理：通过商品编码和排序进行管理
相关接口
最佳实践
- 完整信息：创建时尽量填写完整的商品信息
- 图片质量：使用高质量的商品图片提升转化率
- 价格策略：合理设置划线价格和销售价格
- 库存预估：根据实际情况设置合理的初始库存
- 小程序测试：创建后测试小程序跳转是否正常