服务商与淘系线上店铺的系统打通， 是通过阿里巴巴开放平台来进行打通的。服务商需要入驻开放平台，全渠道智慧门店的入驻：http://my.open.taobao.com/common/applyIsv.htm?appTag=128&accessCode=13A7600CC940ED805C80E7E40DB08337
通过api获取商家商品等信息，需要商家授权，授权文档：//open.taobao.com/docs/doc.htm?docType=1&articleId=102635&treeId=1
API调用说明文档：
//open.taobao.com/docs/doc.htm? &treeId=1&articleId=112&docType=1
门店导购场景的对接分为三个部分：硬件设备初始化、硬件设备上展示线上商品。
其中需要用到的数据接口包括：门店信息管理接口；设备管理接口；商品管理接口；
| API列表 |
描述 |
| 门店列表查询 |
|
| 门店导购员（子账号）查询 |
| API列表 |
描述 |
| 智慧门店设备创建，生成的code用来调用其他API |
|
| 智慧门店设备删除 |
|
| 智慧门店设备更新 |
|
| 智慧门店设备查询 |
|
| 智慧门店设备获取 |
| API列表 |
描述 |
| 获取当前会话用户出售中的商品列表 |
|
| 获取后台供卖家发布商品的标准商品类目 |
|
| 得到当前会话用户库存中的商品列表 |
|
| 商品优惠详情查询 |
|
| 获取单个商品详细信息 |
|
| 批量获取商品详细信息 |
|
| 生成全渠道导购URL，自动实现交易统计、分账功能 |
|
| 创建二维码/短连接 |
| API列表 |
描述 |
| 生成订单支付页面接口 |
智慧门店三个重点接口：设备注册接口、全渠道商品URL接口、生成订单支付页面接口
特别注意：设备注册接口生成的device_code用来调用其他接口。
| 接口名 |
|||||
| 接口参数 |
|||||
| 名称 |
是否必须 |
参数类型/SDK类型 |
示例值 |
更多限制 |
描述 |
| device_address |
必须 |
String |
杭州市文一西路969号8-6-408 |
最大长度：300 |
设备地址 |
| device_description |
必须 |
String |
提供虚拟试妆镜、商品预览、扫码购等功能 |
最大长度：300 |
设备用途描述 |
| device_name |
必须 |
String |
雅诗兰黛品牌试妆镜 |
最大长度：100 |
设备名称 |
| isv_url |
必须 |
String |
https://xxx.ews.m.jaeapp.com |
最大长度：500 |
设备应用首页URL。如没有url，可以任意填写 |
| device_type |
必须 |
String |
试妆镜 |
最大长度：50 |
参考枚举值： 互动游戏大屏，AR游戏，商品货架大屏，人脸识别，wifi探针，红外感应，试衣镜，试妆镜，电子价签，rfid，pos，其他请直接填写名称 |
| store_id |
必须 |
Number |
98977 |
门店ID |
|
| 接口名 |
|||||
| 接口参数 |
|||||
| 名称 |
是否必须 |
参数类型/SDK类型 |
示例值 |
更多限制 |
描述 |
| trade_info |
可选 |
ScanCodeTradeUrl |
|
|
交易信息 |
| └ o2o_guide_id |
必须 |
Number |
12343 |
|
商户中心的导购员id |
| └ shop_id |
可选 |
Number |
1334 |
|
店铺ID |
| └ device_code |
必须 |
String |
0F56454D89 |
|
智慧门店设备码 通过设备管理API获取 |
| └ ext_info |
可选 |
String |
ext_info |
|
扩展信息 |
| └ link_type |
必须 |
String |
item |
|
链接类型，可选值[item、shop、url] |
| └ item_id |
可选 |
Number |
12334 |
|
商品ID |
| └ target_url |
可选 |
String |
htts://xx.m.taobao.com/xxx |
|
码跳转的目标地址，只能指向*.tmall.com或者*.taobao.com |
| 接口名 |
|||||
| 接口参数 |
|||||
| 名称 |
是否必须 |
参数类型/SDK类型 |
示例值 |
更多限制 |
描述 |
| cart_info |
必须 |
String |
mycart |
最大长度：4000 |
购物车信息，格式为【商品id:skuId:购买数量】。一次购买多个商品，用英文逗号隔开 |
| guide_id |
必须 |
Number |
101 |
最小值：0 |
导购员id |
| guide_name |
必须 |
String |
willson |
最大长度：64 |
导购员姓名 |
| shop_id |
必须 |
Number |
101 |
最小值：1 |
门店ID |
| shop_name |
必须 |
String |
myshop |
|
门店名称 |
| delivery_type |
必须 |
String |
Inshop |
|
是店内提货还是线上发货，店内提货传入:inshop；线上发货传入：online |
| total_fee |
可选 |
Number |
10000 |
|
修改订单总额，单位为【分】 |
| ext_info |
可选 |
String |
outTradeId:12345 |
|
传入扩展参数，目前包含外部订单号设置 |
生成的订单，会在 接口 taobao.trade.fullinfo.get 中返回的字段o2o值为smg。
上面表格中相关的参数获取API如下（重点学习API）：
device_code：设备ID获取：taobao.smartstore.device.add
storeId/store_id/shop_id：门店id 获取：taobao.place.private.poi.list
o2oGuideId/guide_id：导购员id获取：taobao.place.account.query
sellerId：卖家id获取：taobao.user.seller.get
itemID：商品ID获取：taobao.items.seller.list.get
skuID：销售属性ID获取：taobao.item.seller.get
生成的商品导购链接示例：
链接生成后可以自行将链接转化成二维码，或者使用我们提供的接口：taobao.wireless.xcode.create
对接消息通知监控商品实时变更信息。如商品改价，上下架等-根据相关应用场景看是否需要。点击查看教程
