《电商平台资料对接接口(草稿).doc》由会员分享,可在线阅读,更多相关《电商平台资料对接接口(草稿).doc(7页珍藏版)》请在金锄头文库上搜索。
1、电商平台资料对接接口(草稿)*备注:0.默认通信协议为https 或者 http1.如无特殊说明,传入参数与返回结果数据皆为标准Json格式2.接口调用权限验证规则与方式由你方制定,为可选项3.接口返回结果中的状态码(例如:200)与描述信息(例如:成功),应简洁明确,方便调试一、 基础商品资料上传接口 调用情景: -线下总部通过后台系统筛选出能够在线上电商平台销售的商品资料,通过后台系统交互界面批量同步到电商平台,等待后续电商平台上架操作 传入参数: -权限验证信息 -预设处理信息(1.单次传输商品数,用于校验;2.数据处理方式:测试、正常) -商品资料信息(单个商品信息包含:名称,价格,库
2、存,条码,结算价格,零售价格,成本价格,品牌,商品编码,分类(大、中、小),规格,单位,包装数,物流包装,产地,等级) 返回结果: -状态码 -描述信息二、 商品下架接口 调用情景: -门店在线下后台系统进行商品下架后,后台系统自动告知电商平台商品同步下架 传入参数: -权限验证信息 -预设处理信息(1.门店信息;2.数据处理方式:测试、正常) -下架商品信息列表 返回结果: -状态码 -描述信息三、 商品资料变更接口 调用情景: -门店在线下后台系统对商品信息进行修改(商品名称、结算价格、零售价等),后台系统定时传送商品变更日志到电商平台 传入参数: -权限验证信息 -预设处理信息(1.门店
3、信息;2.数据处理方式:测试、正常) -变更商品信息列表 返回结果: -状态码 -描述信息四、 门店基础信息上传接口 调用情景: -门店使用线下后台系统交互界面将门店基础信息导入线上电商平台 传入参数: -权限验证信息 -预设处理信息(1.门店信息;2.数据处理方式:测试、正常) -门店基础信息列表 返回结果: -状态码 -描述信息五、 商品价格、库存同步接口 调用情景: -门店后台系统定时同步各门店商品价格、库存信息到电商平台 传入参数: -权限验证信息 -预设处理信息(1.门店信息;2.数据处理方式:测试、正常) -商品价格、库存信息列表 返回结果: -状态码 -描述信息六、 获取电商订单
4、信息接口 调用情景: -在线下门店,收银员通过扫码获取订单号,门店系统通过订单号自动获取订单完整商品列表信息 传入参数: -权限验证信息 -预设处理信息(1.门店信息;2.订单信息;3.数据处理方式:测试、正常) 返回结果: -状态码 -描述信息 -订单商品明细列表七、 换货接口 调用情景: -捡货环节,因缺货导致捡货无法完成,在用户同意的情况下,发货清单发生变动,收银员进行换货录入操作,门店系统自动同步变动订单信息到电商平台(暂定只允许同价格换货) 传入参数: -权限验证信息 -预设处理信息(1.门店信息;2.订单信息;3.数据处理方式:测试、正常) -原商品列表 -新商品列表 返回结果: -状态码 -描述信息八、 退货接口 调用情景: -用户申请退货操作,门店完成退货后,门店系统自动同步退货订单信息到电商平台(暂定允许部分退货) 传入参数: -权限验证信息 -预设处理信息(1.门店信息;2.订单信息;3.数据处理方式:测试、正常) -退货商品信息列表 返回结果: -状态码 -描述信息九、 获取会员资料接口 调用情景: -在后台系统拉取预付卡会员资料信息到本地门店系统 传入参数: -权限验证信息 -预设处理信息(1.门店信息;2.数据处理方式:测试、正常) 返回结果: -状态码 -描述信息 -会员资料信息列表