注意：以下文档只适用于TOP接口，请谨慎使用！
注意：以下文档只适用于TOP接口，请谨慎使用！
智慧门店解决方案帮助品牌线上线下会员和交易全打通，实现门店数字化，这其中包含了各类智能硬件/软件服务商提供的服务。
先通过 taobao.smartstore.stores.query (智慧门店门店查询) 查询商家的门店信息，也可以由商家直接提供门店信息和store_id。
然后通过 taobao.smartstore.device.add (智慧门店设备创建) 接口创建智能硬件设备device_code，这个code很重要,它标识了一个设备的身份，以及与品牌门店的关系，后续设备数据回流都通过device_code来关联。
设备部署到门店后，通过状态回流接口，taobao.smartstore.device.status.feedback（设备在线状态回流）回流设备的运营状态，建议24小时不间断，调用周期1-5分钟。
其他相关设备管理接口：
taobao.smartstore.device.delete (智慧门店设备删除)
taobao.smartstore.device.update (智慧门店设备更新)
taobao.smartstore.device.query (智慧门店设备查询)
taobao.smartstore.device.get (智慧门店设备获取)
需要在智能设备终端调用设备在线状态接口，请保证每5分钟回流一次设备状态，taobao.smartstore.device.status.feedback 设备在线状态回流。
建议系统架构，提供独立的服务端，做有一套日志采集分析系统； 智能设备上打点的用户操作数据先回传到服务端，服务端再定时（一般5-10分钟间隔）调用 智慧门店API接口回流数据给平台快闪数据中心。 如果回流接口出现异常，还可以通过打点记录回补数据。
新增数据回流字段，outer_user 用于智能硬件识别的游客标识，用于分析设备的UV访问情况。
智慧门店试妆镜设备回流规则：
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权
3.action为ITEM_CLICK和TRY_MAKEUP时，item_id必须传入,且必须是淘宝商品的数字id；
4.skin_detection 和scalp_detection 涉及相关检测功能的硬件设备回传。
5.每一个acion都必须传入用户操作时间op_time；
6.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
智慧门店店头互动游戏设备回流规则：（店头/商城互动游戏通用）
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权
3.每一个action都必须传入用户身份user_nick，需要传入淘宝账号名称；
4.每一个action都必须传入用户操作时间op_time；（start/end_time后续废弃）
5.action为GAME_OVER_WITH_PROMOTION时，需传入draw_result，只能传入0或者1；
6.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
智慧门店售货机设备回流规则：
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权
3.action为VENDING_MACHINE_SHIPMENT时，trade_type 和trade_no 必须传入且配套使用；
4.action为ITEM_CLICK、BUY_CLICK、VENDING_MACHINE_SHIPMENT时，item_id必须传入,且必须是淘宝商品的数字id；
5.每一个action都必须传入用户身份user_nick，需要传入淘宝账号名称。
6.每一个action都必须传入用户操作时间op_time；
7.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
智慧门店云货架设备回流规则：（互动云货架、VR云货架通用）
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权,
3.每一个action都必须传入用户操作时间op_time；（start/end_time后续废弃）
4.action为ITEM_CLICK、ITEM_SENSOR、BUY_CLICK时，item_id必须传入,且必须是淘宝商品的数字id；
5.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
智慧门店客流摄像头设备回流 规则：
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权
3.face_id使用自定义标识，用于区分是否同一个访客；性别字段sex，只能传入M/F/N，其中M表示男，F表示女女 ，N表示无法判断；
4.必须传入用户操作时间op_time；（start/end_time后续废弃）
5.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
智慧门店试衣镜设备回流规则：
1.回流的数据属于当前授权的用户，回流的设备device_code由当前应用添加
2.对于快闪店的智能硬件不需要授权,
3.action为ITEM_CLICK和BUY_CLICK时，item_id必须传入,且必须是淘宝商品的数字id；
4.action为TRY_FITTING_CLICK 点击试衣时，try_fitting需传入搭配商品id
5.每一个acion都必须传入用户操作时间op_time；（start/end_time后续废弃）
6.outer_biz_id 用于硬件设备大量数据回流场景，服务商本地日志统计系统对一条日志记录生成唯一标识。 平台后端会对传入的outer_biz_id 做去重处理。
快闪店商品码和活动码需要使用这个接口生成，会统计对应device_code的用户线上扫码操作。
根据商品id 获取商品sku级别的优惠价格。
在开放平台控制台， 进入全渠道智慧门店应用，可以进入到 数据回流查询工具。通过该工具可以查询到智能硬件已经回流的具体数据。
