自建小程序扫码点餐解决方案
一、业务说明

客如云基于自身的硬件能力和标准接口提供一体化解决方案，可对接商家或三方服务商的自研小程序、H5等点餐系统，实现下单到POS收银系统做履约的业务能力。
1.适用客户：已经使用客如云智享版收银系统，典型的商户业态有小吃快餐、饮品店等；
2.业务场景：对接自研的点餐系统（小程序点餐、H5等多种点餐终端），扫码下单到门店收银系统。

二、对接场景
序号	对接场景	能力范围	场景说明
1	快餐/饮品扫码点餐下单	门店基础档案查询/ 商品列表和明细查询/新订单创单并推送/订单履约状态双方同步	三方服务商(自研品牌商)通过该场景的接口，将支付完成的快餐/饮品订单推送到客如云智享版POS并完成后续履约处理。

场景举例：
1. 自研小程序或H5点餐系统下单，订单推送到客如云智享版POS，POS接单后打印并制作和出品，整个订单的状态支持自研小程序和H5点餐系统上同步可查看。
三、服务包声明
序号	需申请的解决方案名称	需申请的服务包列表	备注
1	自建小程序扫码点餐解决方案	“订单信息”、“门店基础信息”、“菜品”、“堂食下单”、“订单数据同步”	服务版本未升级的开发者请申请本方案推荐的全部服务包
2	三方对接客如云基础信息解决方案	“门店基础信息”、“菜品”、“门店档案”（非必接）、“总部基础信息”（非必接）、“机构合约”（非必接）、“总部员工管理”（非必接）、“门店员工管理”（非必接）	非必接服务包，服务版本未升级的开发者无需关注
三、开发者入驻及接入


1.请根据开放平台服务商、品牌商入驻说明进行入驻：入驻说明
2.请根据接口权限申请指南完成开放平台的应用创建及权限申请：接口权限申请指南
3.请根据商户授权指南完成开放平台应用的相关授权操作：商户授权操作指南

四、业务流程

五、API接口列表
序号	接口名称	接口说明	地址
1	门店基础信息查询	查询门店详情与经营相关信息，用于小程序下单的门槛要求	查询
2	查询菜品详情	查询商品详情信息，渲染在点单界面用于选中下单，存在两个或两个以上系统维护菜品时需要先完成菜品数据映射	查询
3	扫码点餐先付模式下单	三方服务商(自研品牌商)通过该场景的接口，将支付完成的快餐/饮品订单推送到客如云智享版POS并完成后续履约处理	查询
4	订单列表查询	三方服务商(自研品牌商)通过该接口可查询到满足条件的客如云订单列表	查询
5	订单详情查询	三方服务商(自研品牌商)通过该接口可查询到某个订单的详情数据，包括订单的金额、支付状态、支付方式、优惠金额等	查询
6	订单变更事件同步	客如云订单变更后实时通知到三方服务商(自研品牌商)	需开发者后台配置回调地址



注意事项：
1.门店档案数据和菜品数据可通过客如云智享版版接口获取，若服务商有独立的门店和菜品管理平台也可通过菜品数据映射的方式完成下单（关注门店菜品id）；
2.三方小程序订单的接单动作必须在POS端完成，客如云智享版POS当前默认配置“自动接单”逻辑；
3.客如云智享版POS的订单状态变更可通过通知事件同步至三方小程序，三方小程序需要进行订单状态幂等，避免两边系统的状态不同步。


六、开发指南

本解决方案针对点餐场景提供了开发指南供开发者参考：《扫码点餐场景小程序开发指南 （必读）》


七、对接常见问题

1.本解决方案中提供的接口收费么？
答：目前客如云接口暂不收费，但不承诺永久免费，如有收费会将收费规则及收费价格政策等在开放平台网站公示。


2.本解决方案对客如云收银系统版本最低要求是什么版本？
答：智享版POS要求版本为V1.20版本及以上。
