资源预览内容
第1页 / 共10页
第2页 / 共10页
第3页 / 共10页
第4页 / 共10页
第5页 / 共10页
第6页 / 共10页
第7页 / 共10页
第8页 / 共10页
第9页 / 共10页
第10页 / 共10页
亲,该文档总共10页全部预览完了,如果喜欢就下载吧!
资源描述
商城众网与合作商城订单接口文档商城众网与合作商城订单接口文档功能介绍:本文档旨在规范商城众网与合作商城之间的订单数据的传输字段,实现商城众网对所有合作商城传过来的订单数据进行规范化的处理,实现商城众网的订单数据与合作商城的订单数据同步的功能。1合作密钥,合作商城账号:为了保证商城众网与合作商城之间的订单数据的安全性及订单数据的唯一性,双方在数据进行请求对接的时候,需要约定一个合作密钥 Protocol_Key 和一个合作商城账号 Protocol_Name 进行认证,传递密钥生成规则:md5(当前年月日+sczw+md5(合作密钥),实例:如 php 语法生成:md5(2015-05-01sczw.md5(合作密钥)),合作商城账号 Protocol_Name 为一个唯一识别的约定字符串,如 sczw003。2用户购物方式:a.用户以商城众网的会员身份点击连接到合作商城,合作商家后台根据发送的会员账号自动帮他注册并登录,然后进行购物。b.用户与合作商城合作,当用户以会员身份点击连接到合作商城时,会以众网会员的身份同步登录到合作商城进行购物。3请求参数:(1)用户以 a 方式请求合作商城进行购物,商城众网以表单的形式提交给合作商城的参数为:字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Member_Id0234商城众网会员 idMember_NameSczw-123456789商城众网会员账号Member_Password28635f2099525c1商城众网会员密码(已经用 md5 加密过)Member_Email123123.com商城众网邮箱Member_Tel13345668877商城众网手机Jump_Urlhttp:/www.sczw.com验证过后要调转的链接商城众网在传给合作商城的参数后,合作商城验证过后检查该会员是否已登录,未登录的检查是否已注册,未注册的后台以传递过来的 Member_Name 为账号帮他注册并登录,然后将其参数以相应的字段存入到 cookie 或 session 中。(2)合作商城的开发人员需在用户下单的时候检测是否商城众网的会员,是的话就将订单在数据库里标记为商城众网会员的订单,会员付款后将订单信息同步传递给商城众网,其传递给商城众网的相应字段为:字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Member_Id0123商城众网会员 IDOrder_Sn94684984订单号Order_Amount129订单金额Order_Statuspay订单状态(支付)Consignee张三收货人Address北京市朝阳区收货地址Contact_Tel13342325566联系手机Testtest测试时添加该字符将其相应的字段值按照规则组成一个数组,然后以 post 方式传递给商城众网,如:$send=array(“Protocol_Name”=”sczw003”,“Protocol_Key”=”332drssdwere4232”,“Member_Id”=0123,“Order_Sn”=”94684984”,“Order_Amount”=129,“Order_Status”=”Pay”,“Consignee”=”张三”,“Address”=”北京市朝阳区”,“Contact_Tel”=”13342325566”);商城众网订单数据接受地址为http:/www.sczw.com/Api/gateway;(3)合作商城需提供返回订单商品信息链接,商城众网收到订单信息后将申请访问此链接以获取订单商品信息商城众网以数组的形式传递数据为:字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Order_Sn0135464订单号合作商城验证过后以数组的形式返回字段:字段示例值说明Goods_Name手套商品名称Spec_Name绿色版本名称(没有可留空)Goods_Id34商品 idQuantity1数量Price123.00单价Default_Imagehttp:/www.sczw.com/Public/upload/2014120商品默认图片2/547d349d0a1d4.png“Goods_Name”:”手套”,”Spec_Name”:”绿色”,”Quantity”:”1”,”Price”:”123.00”,”Default_Image”:”http:/www.sczw.com/Public/upload/20141202/547d349d0a1d4.png”(4)为方便商城众网会员查询订单物流信息,合作商城发货时检测是否商城众网会员的订单,是的话传递物流信息给商城众网,传递信息为:字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Order_Sn94684984订单号Shipping_Code123456789物流单号Shipping_Nameshunfeng快递公司代码Order_Statusshipping订单状态(发货)Testtest测试时添加该字符$send=array(“Protocol_Name”=”sczw003”,“Protocol_Key”=”332drssdwere4232”,“Order_Sn”=”94684984”,“Shipping_Code”=”123456789”,“Order_Status”=”shipping”);$url = “http:/www.sczw.com/Api/shippingway”;(5)确认收货时合作商城检测是否商城众网会员的订单,是的话传递订单信息给商城众网,传递信息为:字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Order_Sn94684984订单号Order_Statusreceipt订单状态(收货)Testtest测试时添加该字符$send=array(“Protocol_Name”=”sczw003”,“Protocol_Key”=”332drssdwere4232”,“Order_Sn”=”94684984”,“Order_Status”=”receipt”);$url = “http:/www.sczw.com/Api/receiptway”;(6)用户退货/退款时合作商城检测是否商城众网会员的订单,是的话传递订单信息给商城众网,传递信息为:字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Order_Sn94684984订单号Order_Statusback订单状态(退货/退款)Order_Amount123订单金额Goods_Id45,48,89商品 id,有多个就用英文逗号分隔Quantity1,2,3商品数量,有多款商品就用英文逗号分隔Testtest测试时添加该字符$send=array(“Protocol_Name”=”sczw003”,“Protocol_Key”=”332drssdwere4232”,“Order_Sn”=”94684984”,“Order_Status”=”back”,“Order_Amount”=”123”,“Goods_id”=”45,48,89”,“Quantity”=”1,2,3”);$url = “http:/www.sczw.com/Api/backway”;(7)返回值:返回值说明1账号有误2密钥验证失败3该申请已处理4订单不存在success成功error未知错误status订单状态有误test_false测试失败Test_success测试成功三为了保证商城众网的产品信息跟合作商城的产品信息一致,商城众网会发送请求到合作商城去获取产品信息,请求信息为:字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Page1为了避免数据太多中途丢失,一次最多返回 100 条合作商城返回信息:字段示例值说明Goods_Name手套商品名称Spec_Name绿色版本名称(没有可留空)Goods_Id34商品 idGoods_CodeA2s1321商品编号(没有可留空)StockY库存(有:Y,无:N)Price123.00单价Default_Imagehttp:/www.sczw.com/Public/upload/20141202/547d349d0a1d4.png商品默认图片Brand_Id2012品牌 Id(没有可留空)Cate_Id23产品分类 IDOff_Time132561654下架时间戳(没有可留空)Goods_Urlhttp:/www.1233.com商品详情页链接“Goods_Name”:”手套”,”Spec_Name”:”绿色”,”Goods_Code”:”1510479”,”Stock”:”Y”,”Price”:”123.00”,”Default_Image”:”http:/www.sczw.com/Public/upload/20141202/547d349d0a1d4.png”,”Brand_Id”:”12”,”Cate_Id”:”23”,”Off_Time”:”13314124123”,”Goods_Url”:”http:/www.1233.com”,商城众网技术开发
网站客服QQ:2055934822
金锄头文库版权所有
经营许可证:蜀ICP备13022795号 | 川公网安备 51140202000112号