商城众网与合作商城订单接口文档

1、商城众网与合作商城订单接口文档功能介绍：本文档旨在规范商城众网与合作商城之间的订单数据的传输字段，实现商城众网对所有合作商城传过来的订单数据进行规范化的处理，实现商城众网的订单数据与合作商城的订单数据同步的功能。1 合作密钥，合作商城账号:为了保证商城众网与合作商城之间的订单数据的安全性及订单数据的唯一性，双方在数据进行请求对接的时候，需要约定一个合作密钥Protocol_Key和一个合作商城账号Protocol_Name进行认证，传递密钥生成规则：md5(当前年月日+sczw+md5(合作密钥)，实例：如php语法生成：md5（2015-05-01sczw.md5(合作密钥)），合作商城账号

2、Protocol_Name为一个唯一识别的约定字符串，如sczw003。2 用户购物方式:a.用户以商城众网的会员身份点击连接到合作商城，合作商家后台根据发送的会员账号自动帮他注册并登录，然后进行购物。b.用户与合作商城合作，当用户以会员身份点击连接到合作商城时，会以众网会员的身份同步登录到合作商城进行购物。3 请求参数：（1）用户以a方式请求合作商城进行购物，商城众网以表单的形式提交给合作商城的参数为：字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Member_Id0234商城

3、众网会员idMember_NameSczw-123456789商城众网会员账号Member_Password28635f2099525c1商城众网会员密码(已经用md5加密过)Member_Email123商城众网邮箱Member_Te城众网手机Jump_Url验证过后要调转的链接商城众网在传给合作商城的参数后，合作商城验证过后检查该会员是否已登录，未登录的检查是否已注册，未注册的后台以传递过来的Member_Name为账号帮他注册并登录，然后将其参数以相应的字段存入到cookie或session中。 （2）合作商城的开发人员需在用户下单的时候检测是否商城众网的会员，

4、是的话就将订单在数据库里标记为商城众网会员的订单，会员付款后将订单信息同步传递给商城众网，其传递给商城众网的相应字段为:字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Member_Id0123商城众网会员IDOrder_Sn94684984订单号Order_Amount129订单金额Order_Statuspay订单状态(支付)Consignee张三收货人Address北京市朝阳区收货地址Contact_Te系手机Testtest测试时添加该字符将其相应

5、的字段值按照规则组成一个数组，然后以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”=>);商城众网订单数据接受地址为（

6、3） 合作商城需提供返回订单商品信息链接，商城众网收到订单信息后将申请访问此链接以获取订单商品信息商城众网以数组的形式传递数据为：字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Order_Sn0135464订单号合作商城验证过后以数组的形式返回字段：字段示例值说明Goods_Name手套商品名称Spec_Name绿色版本名称(没有可留空)Goods_Id34商品idQuantity1数量Price123.00单价Default_Image商品默认图片“Goods_Name”:”手

7、套”,”Spec_Name”:”绿色”,”Quantity”:”1”,”Price”:”123.00”,”Default_Image”:”（4） 为方便商城众网会员查询订单物流信息，合作商城发货时检测是否商城众网会员的订单，是的话传递物流信息给商城众网，传递信息为：字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Order_Sn94684984订单号Shipping_Code123456789物流单号Shipping_Nameshunfeng快递公司代码Order_Statussh

8、ipping订单状态（发货）Testtest测试时添加该字符$send=array(“Protocol_Name”=>”sczw003”,“Protocol_Key”=>”332drssdwere4232”,“Order_Sn”=>”94684984”,“Shipping_Code”=>”123456789”,“Order_Status”=>”shipping”);$url = “（5） 确认收货时合作商城检测是否商城众网会员的订单，是的话传递订单信息给商城众网，传递信息为：字段示例值说明Protocol_Namesczw003合作商城账号Protocol_Key

9、ae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Order_Sn94684984订单号Order_Statusreceipt订单状态（收货）Testtest测试时添加该字符$send=array(“Protocol_Name”=>”sczw003”,“Protocol_Key”=>”332drssdwere4232”,“Order_Sn”=>”94684984”,“Order_Status”=>”receipt”);$url = “（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”,“O

11、rder_Sn”=>”94684984”,“Order_Status”=>”back”,“Order_Amount”=>”123”,“Goods_id”=>”45,48,89”,“Quantity”=>”1,2,3”);$url = “（7） 返回值：返回值说明1账号有误2密钥验证失败3该申请已处理4订单不存在success成功error未知错误status订单状态有误test_false测试失败Test_success测试成功三为了保证商城众网的产品信息跟合作商城的产品信息一致，商城众网会发送请求到合作商城去获取产品信息，请求信息为：字段示例值说明Protoco

12、l_Namesczw003合作商城账号Protocol_Keyae60f4daeab0c96b2cb6396e4f0cee8e传递密钥Page1为了避免数据太多中途丢失，一次最多返回100条合作商城返回信息：字段示例值说明Goods_Name手套商品名称Spec_Name绿色版本名称(没有可留空)Goods_Id34商品idGoods_CodeA2s1321商品编号(没有可留空)StockY库存（有:Y，无:N）Price123.00单价Default_Image商品默认图片Brand_Id2012品牌Id(没有可留空)Cate_Id23产品分类IDOff_Time132561654下架时间戳(没有可留空)Goods_Url