business-2025


编辑商品

<p><strong>请求URI:</strong></p> <ul> <li><code>/goods/edit</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST <code>AUTH</code></li> </ul> <p><strong>参数:</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">校验规则</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">goods_number</td> <td style="text-align: left;">max:254</td> <td style="text-align: left;">string</td> <td>编号</td> </tr> <tr> <td style="text-align: left;">cover_photo</td> <td style="text-align: left;">max:254</td> <td style="text-align: left;">string</td> <td>封面照</td> </tr> <tr> <td style="text-align: left;">bar_code</td> <td style="text-align: left;">max:254</td> <td style="text-align: left;">string</td> <td>条形码</td> </tr> <tr> <td style="text-align: left;">title</td> <td style="text-align: left;">max:254</td> <td style="text-align: left;">string</td> <td>名称</td> </tr> <tr> <td style="text-align: left;">goods_sort_uid</td> <td style="text-align: left;">&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>分类唯一值</td> </tr> <tr> <td style="text-align: left;">goods_unit_uid</td> <td style="text-align: left;">&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>单位唯一值</td> </tr> <tr> <td style="text-align: left;">sale_price</td> <td style="text-align: left;">&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>售价(分)</td> </tr> <tr> <td style="text-align: left;">customer_price</td> <td style="text-align: left;">&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>会员售价(分)</td> </tr> <tr> <td style="text-align: left;">wholesale_price</td> <td style="text-align: left;">&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>批发售价(分)</td> </tr> <tr> <td style="text-align: left;">customer_day_price</td> <td style="text-align: left;">&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>会员日售价(分)</td> </tr> <tr> <td style="text-align: left;">cost_price</td> <td style="text-align: left;">&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>成本价(分)</td> </tr> <tr> <td style="text-align: left;">consumption_minute</td> <td style="text-align: left;">integer</td> <td style="text-align: left;">int</td> <td>时长(分)</td> </tr> <tr> <td style="text-align: left;">stock_qty</td> <td style="text-align: left;">integer</td> <td style="text-align: left;">int</td> <td>库存数</td> </tr> <tr> <td style="text-align: left;">sold_qty</td> <td style="text-align: left;">integer</td> <td style="text-align: left;">int</td> <td>已售数</td> </tr> <tr> <td style="text-align: left;">use_type</td> <td style="text-align: left;">in:0,1,2,integer</td> <td style="text-align: left;">int</td> <td>类型:0=自用,1=分享,2=合作商</td> </tr> <tr> <td style="text-align: left;">delay_remind_day</td> <td style="text-align: left;">integer</td> <td style="text-align: left;">int</td> <td>周期提醒(天)</td> </tr> <tr> <td style="text-align: left;">use_customer_day_switch</td> <td style="text-align: left;">in:0,1,integer</td> <td style="text-align: left;">int</td> <td>是否参与会员日:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">customer_price_reduced_switch</td> <td style="text-align: left;">in:0,1,integer</td> <td style="text-align: left;">int</td> <td>会员价参与折扣:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">virtual_switch</td> <td style="text-align: left;">in:0,1,integer</td> <td style="text-align: left;">int</td> <td>虚拟商品:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">only_goods_reduced_switch</td> <td style="text-align: left;">in:0,1,integer</td> <td style="text-align: left;">int</td> <td>只取商品折扣:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">customer_point_switch</td> <td style="text-align: left;">in:0,1,integer</td> <td style="text-align: left;">int</td> <td>参与积分:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">use_business_switch</td> <td style="text-align: left;">in:0,1,integer</td> <td style="text-align: left;">int</td> <td>门店使用:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">use_wechat_miniprogram_switch</td> <td style="text-align: left;">in:0,1,integer</td> <td style="text-align: left;">int</td> <td>微信小程序使用:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">bundle_goods_uid</td> <td style="text-align: left;">list,[*].&gt;:0</td> <td style="text-align: left;">array</td> <td>捆绑商品列表</td> </tr> <tr> <td style="text-align: left;">consumable_goods_uid</td> <td style="text-align: left;">list,[*].&gt;:0</td> <td style="text-align: left;">array</td> <td>耗品商品列表</td> </tr> <tr> <td style="text-align: left;">ban_switch</td> <td style="text-align: left;">in:0,1,integer</td> <td style="text-align: left;">int</td> <td>封禁:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">wechat_miniprogram</td> <td style="text-align: left;"></td> <td style="text-align: left;">object</td> <td>小程序信息配置 参照对应属性描述</td> </tr> <tr> <td style="text-align: left;">sub_payload</td> <td style="text-align: left;"></td> <td style="text-align: left;">object</td> <td>额外私有配置 参照对应属性描述</td> </tr> <tr> <td style="text-align: left;">goods_uid</td> <td style="text-align: left;">require,&gt;:0,integer</td> <td style="text-align: left;">int</td> <td>商品唯一值</td> </tr> <tr> <td style="text-align: left;">special_switch</td> <td style="text-align: left;">in:0,1,integer</td> <td style="text-align: left;">int</td> <td>特价:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">gender</td> <td style="text-align: left;">in:0,1,2,integer</td> <td style="text-align: left;">int</td> <td>使用对象性别:0=全部,1=男,2=女</td> </tr> <tr> <td style="text-align: left;">goods_reduced_per</td> <td style="text-align: left;">&gt;=:0,&lt;=:10</td> <td style="text-align: left;">decimal(4,2)</td> <td>商品折扣比例</td> </tr> </tbody> </table> <ul> <li>wechat_miniprogram与sub_payload更新为强制覆写模式,因此需传递完整参数,与创建一致.</li> </ul> <hr /> <p>&gt; <strong>&lt;font color=&quot;#5cb85c&quot;&gt;wechat_miniprogram属性&lt;/font&gt;&lt;font color=&quot;red&quot;&gt;(use_wechat_miniprogram_switch=1)&lt;/font&gt;</strong></p> <ul> <li>goods_type=0 商品</li> </ul> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">校验规则</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">title</td> <td style="text-align: left;">require,max:254</td> <td style="text-align: left;">string</td> <td>名称</td> </tr> <tr> <td style="text-align: left;">sale_price</td> <td style="text-align: left;">require,&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>售价(分)</td> </tr> <tr> <td style="text-align: left;">original_price</td> <td style="text-align: left;">require,&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>标价(分)</td> </tr> <tr> <td style="text-align: left;">shard_commission_per</td> <td style="text-align: left;">require</td> <td style="text-align: left;">decimal(4,2)</td> <td>分享佣金比例</td> </tr> <tr> <td style="text-align: left;">show_index_switch</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>首页展示:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">online_switch</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>上架:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">refund_switch</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>可退款:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">detail</td> <td style="text-align: left;"></td> <td style="text-align: left;">string</td> <td>详情</td> </tr> <tr> <td style="text-align: left;">takeaway_price</td> <td style="text-align: left;">require,&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>外卖价(分)</td> </tr> </tbody> </table> <ul> <li>goods_type=1 服务</li> </ul> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">校验规则</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">title</td> <td style="text-align: left;">require,max:254</td> <td style="text-align: left;">string</td> <td>名称</td> </tr> <tr> <td style="text-align: left;">sale_price</td> <td style="text-align: left;">require,&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>售价(分)</td> </tr> <tr> <td style="text-align: left;">original_price</td> <td style="text-align: left;">require,&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>标价(分)</td> </tr> <tr> <td style="text-align: left;">shard_commission_per</td> <td style="text-align: left;">require</td> <td style="text-align: left;">decimal(4,2)</td> <td>分享佣金比例</td> </tr> <tr> <td style="text-align: left;">show_index_switch</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>首页展示:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">online_switch</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>上架:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">refund_switch</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>可退款:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">detail</td> <td style="text-align: left;"></td> <td style="text-align: left;">string</td> <td>详情</td> </tr> <tr> <td style="text-align: left;">takeaway_price</td> <td style="text-align: left;">require,&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>外卖价(分)</td> </tr> </tbody> </table> <ul> <li>goods_type=2 计次</li> </ul> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">校验规则</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">title</td> <td style="text-align: left;">require,max:254</td> <td style="text-align: left;">string</td> <td>名称</td> </tr> <tr> <td style="text-align: left;">sale_price</td> <td style="text-align: left;">require,&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>售价(分)</td> </tr> <tr> <td style="text-align: left;">original_price</td> <td style="text-align: left;">require,&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>标价(分)</td> </tr> <tr> <td style="text-align: left;">shard_commission_per</td> <td style="text-align: left;">require</td> <td style="text-align: left;">decimal(4,2)</td> <td>分享佣金比例</td> </tr> <tr> <td style="text-align: left;">show_index_switch</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>首页展示:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">online_switch</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>上架:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">refund_switch</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>可退款:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">detail</td> <td style="text-align: left;"></td> <td style="text-align: left;">string</td> <td>详情</td> </tr> <tr> <td style="text-align: left;">takeaway_price</td> <td style="text-align: left;">require,&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>外卖价(分)</td> </tr> <tr> <td style="text-align: left;">aggregate_qty</td> <td style="text-align: left;">require,&gt;:0,integer</td> <td style="text-align: left;">int</td> <td>次数</td> </tr> <tr> <td style="text-align: left;">employee_commission_type</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>业绩计算方式:0=比例,1=固定</td> </tr> <tr> <td style="text-align: left;">employee_commission_value</td> <td style="text-align: left;">require</td> <td style="text-align: left;">string</td> <td>业绩计算载荷(百分比/金额(分))</td> </tr> </tbody> </table> <hr /> <p>&gt; <strong>&lt;font color=&quot;#5cb85c&quot;&gt;sub_payload属性&lt;/font&gt;</strong></p> <ul> <li>goods_type=2</li> </ul> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">校验规则</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">expiry_forever_switch</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>无限有效期:0=否,1=是</td> </tr> <tr> <td style="text-align: left;">expiry_type</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>有效期类型:0=天,1=固定日期</td> </tr> <tr> <td style="text-align: left;">expiry_value</td> <td style="text-align: left;">require,&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>有效期类型载荷(天/日期时间戳-秒)</td> </tr> <tr> <td style="text-align: left;">aggregate_qty</td> <td style="text-align: left;">require,integer</td> <td style="text-align: left;">int</td> <td>次数</td> </tr> <tr> <td style="text-align: left;">extra_qty</td> <td style="text-align: left;">require,integer</td> <td style="text-align: left;">int</td> <td>赠送次数</td> </tr> <tr> <td style="text-align: left;">extra_cost_price</td> <td style="text-align: left;">require,&gt;=:0,integer</td> <td style="text-align: left;">int</td> <td>赠送价值(分)</td> </tr> <tr> <td style="text-align: left;">limit_type</td> <td style="text-align: left;">require,in:0,1,2,3,integer</td> <td style="text-align: left;">int</td> <td>使用限制:0=不限制,1=天,2=周,3=年</td> </tr> <tr> <td style="text-align: left;">limit_qty</td> <td style="text-align: left;">require,integer</td> <td style="text-align: left;">int</td> <td>限制次数</td> </tr> <tr> <td style="text-align: left;">commission_calculate_type</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>业绩模式:0=整体计算,1=分别计算</td> </tr> <tr> <td style="text-align: left;">employee_commission_type</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>业绩计算方式:0=比例,1=固定</td> </tr> <tr> <td style="text-align: left;">employee_commission_value</td> <td style="text-align: left;">require</td> <td style="text-align: left;">string</td> <td>业绩计算载荷(百分比/金额(分))</td> </tr> <tr> <td style="text-align: left;">employee_extra_commission_type</td> <td style="text-align: left;">require,in:0,1,integer</td> <td style="text-align: left;">int</td> <td>赠送业绩计算方式:0=比例,1=固定</td> </tr> <tr> <td style="text-align: left;">employee_extra_commission_value</td> <td style="text-align: left;">require</td> <td style="text-align: left;">string</td> <td>赠送业绩计算载荷(百分比/金额(分))</td> </tr> </tbody> </table> <hr /> <ul> <li>请求示例</li> </ul> <pre><code>{     &amp;quot;goods_uid&amp;quot;: &amp;quot;12241111380950001&amp;quot;,     &amp;quot;wechat_miniprogram&amp;quot;: {         &amp;quot;title&amp;quot;: &amp;quot;修改的有损耗捆绑计次&amp;quot;,         &amp;quot;sale_price&amp;quot;: 301,         &amp;quot;original_price&amp;quot;: 1,         &amp;quot;shard_commission_per&amp;quot;: 51,         &amp;quot;show_index_switch&amp;quot;: 1,         &amp;quot;online_switch&amp;quot;: 0,         &amp;quot;refund_switch&amp;quot;: 0,         &amp;quot;takeaway_price&amp;quot;: 101,         &amp;quot;detail&amp;quot;: &amp;quot;&amp;lt;p&amp;gt;123&amp;lt;/p&amp;gt;&amp;quot;     } } {     &amp;quot;goods_uid&amp;quot;:&amp;quot;12241111380950001&amp;quot;,     &amp;quot;ban_switch&amp;quot;:1 }</code></pre>

页面列表

ITEM_HTML