新零售联盟
贩卖机网络对接指南
更新时间：2019/08/20
访问次数：3186
贩卖机网络对接指南
1. 介绍
天猫合作贩卖机核心需要将交易上翻到天猫的交易系统，因此需要在商品、库存、交易付款、发货等环节上与天猫的系统完成对接，大致流程如下图所示：
- 天猫的品牌商发布商品，通过奇门接口将天猫上的商品同步贩卖机上。
- 贩卖机上基于天猫的商品设置货道补货，同时需要将库存及货道信息同步给天猫系统。
- 贩卖机不支持现金支付，消费者购买时，贩卖生成天猫要求的二维码，消费者通过“手淘”或者“天猫”扫码支付。
- 支付过程天猫的系统会创建贩卖机订单，付款完成后通过奇门接口通知贩卖掉货。
- 贩卖机收到掉货消息，触发贩卖机硬件工控系统掉货，掉货完成通知天猫系统已经掉货，以便系统完成订单发货。
2. 设备注册
商品、库存、交易对接过程中，天猫的系统需要知道设备位置、描述、归属等信息，因此第一步需要通过设备注册接口将设备注册上来，注册完成后设备会返回一个device_sn作为设备在天猫的身份ID，后续商品、库存、交易相关接口请传该值。
3. 商品同步
品牌需要在天猫的贩卖机后台发布商品，发布商品后天猫通过奇门将商品信息下发，接受方实现商品同步接口，以便拿到商品信息。
4. 库存同步
5. 二维码生成规则
整个交易流程中，需要调用接口生成支付二维码，消费者通过手淘、猫客扫描二维码创建贩卖机交易。
接口参数说明：
| 参数名称 | 说明 | 获取方式 |
|---|---|---|
| item_id | 商品ID | 在商品同步环节，已经包含商品ID，需要存储起来 |
| biz_name | 业务标识 | 每个业务不一样，ISV联系负责人分配 |
| device_id | 设备ID | 天猫设备ID，设备注册返回的device_sn |
| wh_nonce_str | 随机数 | 随机说 |
| isv_order_id | 己方订单 | ISV自己订单ID，天猫订单交易关联，请确保唯一 |
返回值：
{
"request_id": "6z53vut6f7yj",
"result": {
"error_infos": [],
"module": {
"PAY_TIMEOUT": 300,
"isvOrderId": "1235679",
"shortUrl": "http://tb.cn/WK9o0Qw",
"timeout": 20,
"token": "rpu4AN8h3K19YlXK5WSjvK-_dd96"
},
"success": true
}
}
说明：
- 请使用 shortUrl展示二维码
- timeout 秒过后重新刷新shortUrl
