创建商品
<p><strong>请求URI:</strong></p>
<ul>
<li><code>/goods</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_type</td>
<td style="text-align: left;">require,in:0,1,2,integer</td>
<td style="text-align: left;">int</td>
<td>类型:0=商品,1=项目,2=计次,3=优惠券,4=规格商品</td>
</tr>
<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;">require,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;">>=: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;">>=: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;">require,>=: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;">require,>=: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;">require,>=: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;">require,>=: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;">require,>=: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;">require,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;">require,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;">require,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;">require,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;">require,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;">require,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;">require,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;">require,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;">require,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;">require,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;">require,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;">require,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,[*].>:0</td>
<td style="text-align: left;">array</td>
<td>捆绑商品uid列表</td>
</tr>
<tr>
<td style="text-align: left;">consumable_goods_uid</td>
<td style="text-align: left;">list,[*].>: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;">require,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;">requireIf:use_wechat_miniprogram_switch=1</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;">special_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;">gender</td>
<td style="text-align: left;">require,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;">require,>=:0,<=:10</td>
<td style="text-align: left;">decimal(4,2)</td>
<td>商品折扣比例</td>
</tr>
</tbody>
</table>
<ul>
<li>consumable_goods_uid</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;">group_title</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">string</td>
<td>组名称</td>
</tr>
<tr>
<td style="text-align: left;">option_type</td>
<td style="text-align: left;">require,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;">import</td>
<td style="text-align: left;">require,list</td>
<td style="text-align: left;">array</td>
<td>引入商品列表</td>
</tr>
<tr>
<td style="text-align: left;">import.*.goods_uid</td>
<td style="text-align: left;">require,>:0</td>
<td style="text-align: left;">int</td>
<td>商品uid</td>
</tr>
<tr>
<td style="text-align: left;">import.*.goods_title</td>
<td style="text-align: left;">require</td>
<td style="text-align: left;">string</td>
<td>商品显示名称</td>
</tr>
<tr>
<td style="text-align: left;">import.*.sale_price</td>
<td style="text-align: left;">require,>=0</td>
<td style="text-align: left;">int</td>
<td>售价</td>
</tr>
<tr>
<td style="text-align: left;">import.*.use_self_sale_price</td>
<td style="text-align: left;">require,in:0,1</td>
<td style="text-align: left;">int</td>
<td>引用商品原始售价:0=否,1=是</td>
</tr>
</tbody>
</table>
<p>> 商品信息由3部分组成,基础信息-私有配置-小程序配置</p>
<ul>
<li>所有商品必有基础信息(主表)</li>
<li>所有商品必有私有配置,内容根据goods_type而定(分表)</li>
<li>小程序配置由use_wechat_miniprogram_switch控制(分表)</li>
<li>当创建商品时use_wechat_miniprogram_switch=0,则wechat_miniprogram配置对象可不给.</li>
<li>use_wechat_miniprogram_switch在编辑时可重新开启,因此wechat_miniprogram的分表信息为强制覆写模式.sub_payload的变更也保持逻辑一致强制覆写.即所有分表数据均为覆写,主表为更新.</li>
</ul>
<hr />
<p>> 关于库存(stock_qty)与销量(sold_qty)</p>
<ul>
<li>实物商品(virtual_switch=0)订单销售时 加销量 减少库存</li>
<li>虚拟商品(virtual_switch=1)订单销售时只增加销量 库存值维持原样</li>
</ul>
<hr />
<p>> <strong><font color="#5cb85c">wechat_miniprogram属性</font><font color="red">(use_wechat_miniprogram_switch=1)</font></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,>=: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,>=: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,>=: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,>=: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,>=: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,>=: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,>=: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,>=: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,>=: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,>: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>
<ul>
<li>goods_type=3 优惠券</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,>=: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,>=: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;">balance_price</td>
<td style="text-align: left;">require,>=:0</td>
<td style="text-align: left;">int</td>
<td>优惠券金额(分)</td>
</tr>
<tr>
<td style="text-align: left;">time_sell_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;">sell_start_datetime</td>
<td style="text-align: left;">requireIf:time_sell_switch=1,datetime</td>
<td style="text-align: left;">datetime</td>
<td>售卖开始时间</td>
</tr>
<tr>
<td style="text-align: left;">sell_end_datetime</td>
<td style="text-align: left;">requireIf:time_sell_switch=1,datetime</td>
<td style="text-align: left;">datetime</td>
<td>售卖结束时间</td>
</tr>
<tr>
<td style="text-align: left;">use_limit_price_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;">use_limit_price</td>
<td style="text-align: left;">require,>=:0</td>
<td style="text-align: left;">int</td>
<td>使用门槛金额(分)</td>
</tr>
</tbody>
</table>
<hr />
<hr />
<p>> <strong><font color="#5cb85c">sub_payload额外私有属性</font></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;">inquiry_day</td>
<td style="text-align: left;">require,>:0,integer</td>
<td style="text-align: left;">int</td>
<td>回访日期(天)</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=天,2=指定日期</td>
</tr>
<tr>
<td style="text-align: left;">expiry_value</td>
<td style="text-align: left;">require,>=:0,integer</td>
<td style="text-align: left;">int</td>
<td>有效期类型载荷(天/日期时间戳-秒)</td>
</tr>
<tr>
<td style="text-align: left;">infinite_qty_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;">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,>=: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>
<ul>
<li>goods_type=3 优惠券</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;">grant_type</td>
<td style="text-align: left;">require,in:0,1</td>
<td style="text-align: left;">int unsigned</td>
<td>模式:0=单次,1=分期</td>
</tr>
<tr>
<td style="text-align: left;">once_expiry_type</td>
<td style="text-align: left;">requireIf:grant_type=0,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;">once_expiry_payload</td>
<td style="text-align: left;">>=:0</td>
<td style="text-align: left;">int</td>
<td>有效期类型载荷(单次下发) 天=天数, 指定日期=时间戳</td>
</tr>
<tr>
<td style="text-align: left;">installment_interval_day</td>
<td style="text-align: left;">requireIf:grant_type=1,>=:0,integer</td>
<td style="text-align: left;">int</td>
<td>每期天数</td>
</tr>
<tr>
<td style="text-align: left;">installment_count</td>
<td style="text-align: left;">requireIf:grant_type=1,>=:0,integer</td>
<td style="text-align: left;">int</td>
<td>分期次数</td>
</tr>
<tr>
<td style="text-align: left;">grant_qty</td>
<td style="text-align: left;">require,>:0,integer</td>
<td style="text-align: left;">int</td>
<td>下发数量</td>
</tr>
<tr>
<td style="text-align: left;">disposable_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;">balance_price</td>
<td style="text-align: left;">>=:0</td>
<td style="text-align: left;">int unsigned</td>
<td>优惠券金额(分)</td>
</tr>
<tr>
<td style="text-align: left;">limit_type</td>
<td style="text-align: left;">require,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;">limit_type_payload</td>
<td style="text-align: left;">[*].>:0</td>
<td style="text-align: left;">array</td>
<td>使用限制载荷 分类券=分类uid列表 定向券=商品uid列表</td>
</tr>
<tr>
<td style="text-align: left;">limit_price_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;">limit_price</td>
<td style="text-align: left;">require,>=:0</td>
<td style="text-align: left;">int unsigned</td>
<td>限制金额(分)</td>
</tr>
<tr>
<td style="text-align: left;">use_limit_price_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;">use_limit_price</td>
<td style="text-align: left;">require,>=:0</td>
<td style="text-align: left;">int unsigned</td>
<td>使用门槛金额(分)</td>
</tr>
</tbody>
</table>
<ul>
<li>once_expiry_type=1/2是 once_expiry_payload必须大于0</li>
<li>grant_type=1(分期)时 installment_interval_day与installment_count必须大于0</li>
</ul>
<hr />
<p>> 请求示例</p>
<p>//计次 goods_type=2</p>
<pre><code> {
&quot;goods_type&quot;: 2,
&quot;goods_number&quot;: &quot;&quot;,
&quot;title&quot;: &quot;有损耗捆绑计次&quot;,
&quot;goods_unit_uid&quot;: 11241107523670001,
&quot;sale_price&quot;: 300,
&quot;customer_price&quot;: 280,
&quot;wholesale_price&quot;: 200,
&quot;customer_day_price&quot;:260,
&quot;cost_price&quot;: 150,
&quot;consumption_minute&quot;: 0,
&quot;stock_qty&quot;: 100,
&quot;use_type&quot;: 0,
&quot;delay_remind_day&quot;: 0,
&quot;use_customer_day_switch&quot;: 0,
&quot;customer_price_reduced_switch&quot;: 0,
&quot;virtual_switch&quot;: 1,
&quot;only_goods_reduced_switch&quot;: 0,
&quot;customer_point_switch&quot;: 1,
&quot;use_business_switch&quot;: 1,
&quot;use_wechat_miniprogram_switch&quot;: 1,
&quot;ban_switch&quot;: 0,
&quot;bundle_goods_uid&quot;:[12241107525450001],
&quot;consumable_goods_uid&quot;:[
{
&quot;group_title&quot;: &quot;杯型&quot;,
&quot;option_type&quot;: 1,,
&quot;import&quot;:[
{
&quot;goods_uid&quot;:12241107525820001,
&quot;goods_title&quot;:&quot;中杯&quot;,
&quot;sale_price&quot;:0,
&quot;use_self_sale_price&quot;:1,
},
{
&quot;goods_uid&quot;:12241107525450001,
&quot;goods_title&quot;:&quot;大杯&quot;,
&quot;sale_price&quot;:2,
&quot;use_self_sale_price&quot;:0,
}
]
}
],
&quot;special_switch&quot;:0,
&quot;gender&quot;:0,
&quot;goods_reduced_per&quot;:10,
&quot;wechat_miniprogram&quot;:{
&quot;title&quot;:&quot;有损耗捆绑计次mini&quot;,
&quot;sale_price&quot;:300,
&quot;original_price&quot;:0,
&quot;shard_commission_per&quot;:5,
&quot;show_index_switch&quot;:1,
&quot;online_switch&quot;:0,
&quot;refund_switch&quot;:0,
&quot;takeaway_price&quot;:10,
&quot;aggregate_qty&quot;:20,
&quot;employee_commission_type&quot;:1,
&quot;employee_commission_value&quot;:1500
},
&quot;sub_payload&quot;:{
&quot;expiry_never_switch&quot;:0,
&quot;expiry_type&quot;:0,
&quot;expiry_value&quot;:30,
&quot;aggregate_qty&quot;:25,
&quot;extra_qty&quot;:2,
&quot;extra_cost_price&quot;:19900,
&quot;limit_type&quot;:2,
&quot;limit_qty&quot;:5,
&quot;commission_calculate_type&quot;:0,
&quot;employee_commission_type&quot;:0,
&quot;employee_commission_value&quot;:15,
&quot;employee_extra_commission_type&quot;:1,
&quot;employee_extra_commission_value&quot;:1500
}
}</code></pre>
<p>//商品/服务 goods_type=0|goods_type=1</p>
<pre><code> {
&quot;goods_type&quot;: 1,
&quot;goods_number&quot;: &quot;&quot;,
&quot;title&quot;: &quot;有损耗捆绑服务&quot;,
&quot;goods_unit_uid&quot;: 11241107523670001,
&quot;sale_price&quot;: 300,
&quot;customer_price&quot;: 280,
&quot;wholesale_price&quot;: 200,
&quot;customer_day_price&quot;:260,
&quot;cost_price&quot;: 150,
&quot;consumption_minute&quot;: 0,
&quot;stock_qty&quot;: 100,
&quot;use_type&quot;: 0,
&quot;delay_remind_day&quot;: 0,
&quot;use_customer_day_switch&quot;: 0,
&quot;customer_price_reduced_switch&quot;: 0,
&quot;virtual_switch&quot;: 1,
&quot;only_goods_reduced_switch&quot;: 0,
&quot;customer_point_switch&quot;: 1,
&quot;use_business_switch&quot;: 1,
&quot;use_wechat_miniprogram_switch&quot;: 1,
&quot;ban_switch&quot;: 0,
&quot;bundle_goods_uid&quot;:[],
&quot;consumable_goods_uid&quot;:[
{
&quot;group_title&quot;: &quot;杯型&quot;,
&quot;option_type&quot;: 1,,
&quot;import&quot;:[
{
&quot;goods_uid&quot;:12241107525820001,
&quot;goods_title&quot;:&quot;中杯&quot;,
&quot;sale_price&quot;:2,
&quot;use_self_sale_price&quot;:1,
},
{
&quot;goods_uid&quot;:12241107525450001,
&quot;goods_title&quot;:&quot;大杯&quot;,
&quot;sale_price&quot;:4,
&quot;use_self_sale_price&quot;:0,
},
{
&quot;goods_uid&quot;:12241107525450001,
&quot;goods_title&quot;:&quot;小杯&quot;,
&quot;sale_price&quot;:0,
&quot;use_self_sale_price&quot;:0,
}
]
}
&quot;special_switch&quot;:0,
&quot;gender&quot;:0,
&quot;goods_reduced_per&quot;:10,
&quot;wechat_miniprogram&quot;:{
&quot;title&quot;:&quot;有损耗捆绑服务mini&quot;,
&quot;sale_price&quot;:300,
&quot;original_price&quot;:0,
&quot;shard_commission_per&quot;:5,
&quot;show_index_switch&quot;:1,
&quot;online_switch&quot;:0,
&quot;refund_switch&quot;:0,
&quot;takeaway_price&quot;:10
}
}</code></pre>