《商城众网及合作商城订单接口文档.docx》由会员分享,可在线阅读,更多相关《商城众网及合作商城订单接口文档.docx(10页珍藏版)》请在得力文库 - 分享文档赚钱的网站上搜索。
1、商城众网与合作商城订单接口文档功能介绍:本文档旨在标准商城众网与合作商城之间订单数据传输字段,实现商城众网对所有合作商城传过来订单数据进展标准化处理,实现商城众网订单数据与合作商城订单数据同步功能。一 合作密钥,合作商城账号:为了保证商城众网与合作商城之间订单数据平安性及订单数据唯一性,双方在数据进展请求对接时候,需要约定一个合作密钥Protocol_Key和一个合作商城账号Protocol_Name进展认证,传递密钥生成规那么:md5(当前年月日+sczw+md5(合作密钥),实例:如php语法生成:md52021 -05-01sczw.md5(合作密钥),合作商城账号Protocol_Na
2、me为一个唯一识别约定字符串,如sczw003。二 用户购物方式:a.用户以商城众网会员身份点击连接到合作商城,合作商家后台根据发送会员账号自动帮他注册并登录,然后进展购物。b.用户与合作商城合作,当用户以会员身份点击连接到合作商城时,会以众网会员身份同步登录到合作商城进展购物。三 请求参数:1用户以a方式请求合作商城进展购物,商城众网以表单形式提交给合作商城参数为:字段例如值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Member_Id0234商城众网会员idMember_NameSc
3、zw-123456789商城众网会员账号Member_Password28635f2099525c1商城众网会员密码(已经用md5加密过)Member_Email123123 商城众网邮箱Member_Tel13345668877商城众网手机Jump_Url :/ sczw 验证过后要调转链接商城众网在传给合作商城参数后,合作商城验证过后检查该会员是否已登录,未登录检查是否已注册,未注册后台以传递过来Member_Name为账号帮他注册并登录,然后将其参数以相应字段存入到cookie或session中。 2合作商城开发人员需在用户下单时候检测是否商城众网会员,是话就将订单在数据库里标记为商城众
4、网会员订单,会员付款后将订单信息同步传递给商城众网,其传递给商城众网相应字段为:字段例如值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Member_Id0123商城众网会员IDOrder_Sn94684984订单号Order_Amount129订单金额Order_Statuspay订单状态(支付)Consignee张三收货人Address北京市朝阳区收货地址Contact_Tel13342325566联系手机Testtest测试时添加该字符将其相应字段值按照规那么组成一个数组,然后以po
5、st方式传递给商城众网,如:$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);商城众网订单数据承受地址为 :/ sczw /Api/gateway;(3) 合作商城需提供返回订单商品信息链接,商城众网收到订单信息后将申请访问此链接以获取订单商品信息商城众网以数组形
6、式传递数据为:字段例如值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Order_Sn0135464订单号合作商城验证过后以数组形式返回字段:字段例如值说明Goods_Name手套商品名称Spec_Name绿色版本名称(没有可留空)Goods_Id34商品idQuantity1数量Price123.00单价Default_Image :/ sczw /Public/upload/20211202/547d349d0a1d4.png商品默认图片“Goods_Name:手套,Spec_Name
7、:绿色,Quantity:1,Price:123.00,Default_Image: :/ sczw /Public/upload/20211202/547d349d0a1d4.png(4) 为方便商城众网会员查询订单物流信息,合作商城发货时检测是否商城众网会员订单,是话传递物流信息给商城众网,传递信息为:字段例如值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Order_Sn94684984订单号Shipping_Code123456789物流单号Shipping_Nameshunfen
8、g快递公司代码Order_Statusshipping订单状态发货Testtest测试时添加该字符$send=array(“Protocol_Name=sczw003,“Protocol_Key=332drssdwere4232,“Order_Sn=94684984,“Shipping_Code=123456789,“Order_Status=shipping);$url = “ :/ sczw /Api/shippingway;(5) 确认收货时合作商城检测是否商城众网会员订单,是话传递订单信息给商城众网,传递信息为:字段例如值说明Protocol_Namesczw003合作商城账号Prot
9、ocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Order_Sn94684984订单号Order_Statusreceipt订单状态收货Testtest测试时添加该字符$send=array(“Protocol_Name=sczw003,“Protocol_Key=332drssdwere4232,“Order_Sn=94684984,“Order_Status=receipt);$url = “ :/ sczw /Api/receiptway;(6) 用户退货/退款时合作商城检测是否商城众网会员订单,是话传递订单信息给商城众网,传递信息为:字段例如值说
10、明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=9468498
11、4,“Order_Status=back,“Order_Amount=123,“Goods_id=45,48,89,“Quantity=1,2,3);$url = “ :/ sczw /Api/backway;(7) 返回值:返回值说明1账号有误2密钥验证失败3该申请已处理4订单不存在success成功error未知错误status订单状态有误test_false测试失败Test_success测试成功三为了保证商城众网产品信息跟合作商城产品信息一致,商城众网会发送请求到合作商城去获取产品信息,请求信息为:字段例如值说明Protocol_Namesczw003合作商城账号Protocol_Ke
12、yae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Page1为了防止数据太多中途丧失,一次最多返回100条合作商城返回信息:字段例如值说明Goods_Name手套商品名称Spec_Name绿色版本名称(没有可留空)Goods_Id34商品idGoods_CodeA2s1321商品编号(没有可留空)StockY库存有:Y,无:NPrice123.00单价Default_Image :/ sczw /Public/upload/20211202/547d349d0a1d4.png商品默认图片Brand_Id2021品牌Id(没有可留空)Cate_Id23产品分类IDOff_Time132561654下架时间戳(没有可留空)Goods_Url :/ 1233 商品详情页链接“Goods_Name:手套,Spec_Name:绿色,Goods_Code:1510479,Stock:Y,Price:123.00,Default_Image: :/ sczw /Public/upload/20211202/547d349d0a1d4.png,Brand_Id:12,Cate_Id:23,Off_Time:13314124123,Goods_Url: :/ 1233 , 商城众网 技术开发