《网店管家云端版》独立接口开发文档

《《网店管家云端版》独立接口开发文档》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、《网店管家云端版》独立商城接口V1.0修改时间修改人内容2014-11-06王岸商品接口添加返回字段2014-12-03王岸商品接口新增价格和数量返回,新增商品导入(从平台下载,在管家建立商品)1.机制《esAPI云端版》主动发起请求，网店系统验证请求后，返回信息对应信息。网店系统HTTPesAPI云端版XML2.消息格式所有调用采用httpPost方式来获取信息A．调用URL：调用的地址由商家自行定义，抓单，发货，商品三个模块可以分开。B．系统级参数：每个接口都必须传入这3个值。参数说明uCode接入码，用于验证请

2、求的有效性。主要用于区分店铺。mType方法名，不同接口分别传入不同的方法值。Sign验证码，用于双方做安全验证。TimeStamp标准时间戳商家自行调整误差范围，建议在十分钟外不允许调用签名sign调用API时需要对请求参数进行签名验证，根据参数名称按照字母先后顺序排序:key+value....key+value需要排列的参数包括uCode，mType，Secret,TimeStamp。其中Secret是密钥，会在esAPI里面填写，商家自己这边需要设置，不会进行参数传值     例如：将uCode=1,mTyp

3、e=2,Secret=ABCD，TimeStamp=123456789参数名和参数值链接后，得到拼装字符串mType2TimeStamp123456789uCode1，最后将Secret拼接到头尾，ABCDmType2TimeStamp123456789uCode1ABCD。     加密方式:     md5：进行md5加密后，再转化成大写，格式是：md5(ABCDmType2TimeStamp123456789uCode1ABCD)，最后得到AC6E8A8F690D1D3595131CE8ADD46F88*请注意

4、返回字段大小写,严格区分,比如3.1的改成1）订单列表查询参数说明mType订单查询时该值为：mOrderSearchOrderStatus订单状态，状态有3种。1，表示已付款（含货到付款）；0，表示未付款；-1表示问题单（问题单在管家里面如果没有递交会做关闭订单处理，递交的不做处理）PageSize返回数量Page返回页数PS：当前采用分页返回，数量和页数会一起传，如果不传，则返回所有的结果集接口文件接收消息后，将符合条件的订单按照如下格式返回标记定义说明OrderCount订单数量订单总数量，

5、esAPI自行计算是否有多页Result是否成功1，成功，0失败Cause失败原因如果失败，返回原因Page订单第几页OrderList订单数组OrderNOG20148733784879 不能重复，如34234234,注：订单状态为1，获取之后可以递交到订单审核（管家F2界面）。订单状态为0，获取之后在管家原始单（管家F4界面），并不递交到审核界面。1）如果此订单已经获取，并且在原始单状态，则直接标记此订单为关闭，并不再获取。2）如果此订单未获取，不做任何处理。例:

6、g='gb2312'?>201487337848792014873378248792112）订单详细参数说明mType订单查询时该值为：mGetOrderOrderNO订单号接口文件接收消息后，将符合条件的订单按照如下格式返回标记

7、定义例子说明OrderNO订单号20111114102179不能重复Result是否成功1，成功，0失败Cause失败原因如果失败，返回原因DateTime成交日期2011-11-1410:26:03日期BuyerID买家用户名DemovipooBuyerName买家姓名郭收货人姓名Country国家中国Province省/州浙江City市/县杭州Town区/镇西湖区Adr地址OOXXOOOXXZip邮编310000EmailEmail17281255@qq.comPhone联系电话1868060513Total货款

8、总额IntPostage货运费用IntPayAccount支付方式PayID支付编号LogisticsName发货方式申通Chargetype结算方式担保,货到付款订单请设为“货到付款”CustomerRemark客户备注InvoiceTitle发票抬头Remark客服备注Item成交商品集GoodsIDG49B7B00DB597F-6 库存编