电商平台资料对接接口(草稿).doc

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