餐饮行业商品解决方案
1 基础
1.1.1 商家、操作员的操作路径
1.商家可以通过口碑商家中心（PC版本），点击左侧的“餐饮-商品管理”导航，可以看到目前商户已经发布的商品列表。点击去“服务市场”可以看到已经订购的“商品管理”类型的应用，点击“进入服务”后可以进入ISV的系统后台，使用ISV的商品管理能力。
2.商家给操作员赋予插件的权限之后，操作员登陆商家中心后，可以在“服务市场”中“我的服务”看到有权限使用的插件，点击“进入服务”跳转到ISV的系统后台系统，使用餐饮商品管理能力。
1.1.2 服务商、服务商小二的操作路径
1.服务商、服务商小二可以在口碑“销售中台”的“商品管理”菜单中，看到商家订购的“商品管理”类型的插件，点击“进入服务”跳转到ISV的系统后台，使用商品管理服务。
1.1.3 ISV需要做什么
1.ISV需要理解商家、操作员、服务商、服务商小二这几个角色的含义
2.点击“进入服务”，会跳转到ISV发布的插件的“商家端访问地址（PC）”，请ISV发布服务时，以此规范来配置此参数：
3.口碑会回跳到ISV的redirect_url，并且带上相应参数，示例如下：[url]https://xxx.isv.com.cn?app_id=2015110400844031&source=koubei&scope=auth_base&auth_type=pay_member&auth_code=6a8713a414da4a2dafdb7c24e597TX80[/url]
4.ISV使用auth_code换取信息，详见《koubei.member.data.oauth.query》
在商户账号已经打通的情况下，以上的角色就可以免登进入ISV的后台了。
2 商品
2.1 标准商品和非标准商品
1.商品分类为“标准商品”、“非标准”商品：
a) 标准商品指的是价格固定的商品，明码标价，不受时间、地点等限制；比如精品2-3人套餐，原价588元，现价328元。
b) 非标准商品指的是价格不固定的商品，价格跟时间、地点等其他因素有较大关联的；比如预定包厢，同样一个大包厢，中午、晚上的价格是截然不同的。
2.标准商品与非标准商品的用户购买路径如下：
3.标准商品、非标准商品在接口中是以“price_mode”字段进行区分的，标准商品是常用的类型。
4.本期只有标准商品可以参加双十二
2.2 商品字段在用户端的展示
1.创建商品时候所有的字段详见《alipay.offline.market.item.create》
2.其中字段与客户端展示的对应关系如下：
2.3 商品状态
1.商品状态及说明
2.变更商品状态的操作，通过控制售卖状态state_type 参数，可变更商品的状态。
3.商品状态流转图：
a) 商品发布成功，会自动到达“生效”状态
b) 商家可以选择“暂停售卖”；如果商家跟口碑签约的协议失效了，所有的商品都会被暂停售卖；
c) 商品暂停售卖时，商家可以选择恢复售卖
d) 如果商品违规，口碑内部服务小二有权利对商品进行人工干涉，对商品进行处罚；比较轻的处罚是将商品冻结一段时间，冻结状态的商品不展现在客户端，也不能被购买，处罚状态解除后会恢复到生效状态；更为严重的处罚是直接将商品失效，失效状态的商品不展现在客户端，也不能被购买。
e) 失效状态的商品不可以被恢复到其他状态，相当于这个商品已经被删除了；在接口调用时请谨慎使用该功能
2.4 商品报名活动（比如双十二）
1.在ISV后台发布的商品，可以通过口碑的活动报名页面进行活动报名
2.商品在提交报名时候，需要填写活动期间的价格（活动价）、库存（活动库存）：
a) 商品只有在活动期间以活动价格售卖；在日常及预热期间都是以商品的现价进行售卖
b) 活动库存是从商品总库存中扣减的。比如商品目前库存5000份，报名活动2000份，那么在活动开始之前最多只能售卖3000份。活动结束之后，活动剩余库存会再补充到商品的总库存中。
3.一旦提交报名（包括服务商代提交报名），商品就会被锁定，口碑会向ISV网关发送商品被锁定的通知，详见excel中《商品操作通知服务》关于ext_info字段
4.以下几种场景，商品会解除锁定，口碑会向ISV网关发送商品解锁的通知：
a) 商户自己撤销活动报名
b) 商户的活动报名申请被口碑小二驳回
c) 商户活动报名成功后，被口碑小二解除报名
d) 商户活动报名成功后，因为违规等各类原因被口碑小二退出活动（此种情况商户无法再报名）
e) 活动结束后，商品解除锁定
5.商品被锁定后，所有信息都不能被修改
6.ISV可以通过活动查询接口，查询商户在某个活动中报名的具体信息，详见接口PDF文档中的《招商商家报名分页查询接口(版本1.0)》
在我们的订单通知接口中，有activity_id字段，可以表明是在活动期间售卖的商品，ISV可以通过这个功能来向商户展示在活动期间售卖了多少商品。
3 交易
3.1 订单流程介绍
1.订单整体流程如下：
2.对于“标准商品”，商品详情页是由口碑搭建的，所以ISV无需使用“订单创建信息接口”；对于“非标准商品”，由于商品详情页是由ISV搭建的，所以需要使用“订单创建信息”接口来创建订单，创建成功之后，调用口碑的下单页进行下单
3.2 订单状态
1.单明细订单（一次只购买了一个商品的订单）状态流转：
2.多明细订单（一次购买了多个商品的订单）状态流转：
3.主订单状态对照：
4.凭证状态对照：
