《网店管家》接口说明.doc

网店管家网络商城接口 2.0网店管家商城接口包括两个部分，一是订单下载接口，由网店管家的附件“网店蜘蛛”实现，二是订单状态、库存同步、客户资料、发货通知接口，由网店管家的附件“管家助理”实现。接口采用Post方法实现，采用UTF8编码。订单下载需要网店蜘蛛1.5，设置如下。实现发货同步，库存同步需要管家助理，在系统-系统设置-订单同步接口（库存同步接口）设置如下（如出现接口不可用，联系管家技术员）：一. 订单下载接口1.机制网店蜘蛛或网店管家主动发起获取订单请求，网店系统验证请求后，返回信息。结果信息为XML格式，每次返回一个，订单获取分为2步，第一次订单查询（参数mOrderSearch），获取订单列表，如（图一），第二次获取订单明细（参数mGetOrder），如（图2，图3）HTTP网店系统XML网店蜘蛛2.消息格式1）订单查询参数说明uCode接入码，用于验证请求的有效性。接入码的值在网店系统和网店蜘蛛中设置。mType请求类别。订单查询时该值为：mOrderSearchTimeStamp1起始时间（时间戳），0表示不限制起始时间TimeStamp2截止时间（时间戳），0表示不限制截止时间接口文件接收消息后，将符合条件的订单按照如下格式返回标记定义说明OrderCount订单数量OrderNO订单号不能重复例如，要查询当前所有已经付款的订单：http:/www.XS/interface.asp? uCode=123456& mType=mOrderSearch&TimeStamp1=0&TimeStamp2=0&OrderStatus=1返回结果示例如下（图一）：2）订单下载参数说明uCode接入码，用于验证请求的有效性。接入码的值在网店系统和网店蜘蛛中设置。mType请求类别。订单查询时该值为：mGetOrderOrderNO订单号接口文件接收消息后，将符合条件的订单按照如下格式返回标记定义说明OrderNO订单号不能重复DateTime成交日期日期BuyerID买家用户名BuyerName买家姓名Country国家Province省/州City市/县Town区/镇Adr地址Zip邮编EmailEmailPhone联系电话Total货款总额IntPostage货运费用IntPayAccount支付方式PayID支付编号LogisticsName发货方式Chargetype结算方式CustomerRemark客户备注Remark客服备注Item成交商品集GoodsID库存编码GoodsName货品名称GoodsSpec货品规格Count数量Price单价一个符合规范的订单描述（图2.图3）：接上图：二. 货品和库存同步当库存发送变化时，网店管家会产生一条库存同步消息。参数如下：参数说明uCode接入码，用于验证请求的有效性。接入码的值在网店系统和网店管家中设置，必须一致。mType请求类别，同步库存时，该值为“mUpdateStock”。GoodsNO货品编号BarCode货品条码(主条码)Stock库存量成功：1失败：0拒绝原因初始建立货品时，可以先同步一条货品信息：（不建议开发）参数说明uCode接入码，用于验证请求的有效性。接入码的值在网店系统和网店管家中设置，必须一致。mTypemNewGoodsGoodsNO货品编号GoodsName货品名称GoodsSpec货品规格GoodsUnit货品单位dPriceDetail零售价dPricewholesale1批发价1dPricewholesale2批发价2dPricewholesale3批发价3Stock库存量bMultiSpec是否存在多规格Remark备注成功：1失败：0拒绝原因同步规格库存：参数说明uCode接入码，用于验证请求的有效性。接入码的值在网店系统和网店管家中设置，必须一致。mTypemUpdateSpecStockGoodsNO货品编号BarCode货品规格的条码Stock库存量成功：1失败：0拒绝原因删除货品(功能未开放)：参数说明uCode接入码，用于验证请求的有效性。接入码的值在网店系统和网店管家中设置，必须一致。mTypemDelGoodsGoodsNO货品编号成功：1失败：0拒绝原因删除货品的规格（未开放）：参数说明uCode接入码，用于验证请求的有效性。接入码的值在网店系统和网店管家中设置，必须一致。mTypemDelGoodsGoodsNO货品编号GoodsSpec货品规格成功：1失败：0拒绝原因三. 发货通知当订单发货时，网店管家会产生对应的发货通知消息。参数如下：参数说明uCode接入码，用于验证请求的有效性。接入码的值在网店系统和网店管家中设置，必须一致。mType请求类别，发货通知时，该值为“mSndGoods”。OrderID订单编号OrderNO原始订单编号CustomerID客户网名SndStyle发货方式BillID货运单号SndDate发货时间成功：1失败：0拒绝原因四. 订单状态同步(未开放)当订单状态发生变化时，网店管家会产生对应的同步消息。参数如下：参数说明uCode接入码，用于验证请求的有效性。接入码的值在网店系统和网店管家中设置，必须一致。mType请求类别，发货通知时，该值为“mChgStatus”。OrderID订单编号sStatus状态成功：1失败：0拒绝原因五. 客户资料同步（未开放）客户资料接口用于同步客户的积分和预存款资料。参数说明uCode接入码，用于验证请求的有效性。接入码的值在网店系统和网店管家中设置，必须一致。mType请求类别，发货通知时，该值为“mCustomerInfo”。CustomerID客户编号sScores积分sBalance预存款成功：1失败：0拒绝原因六. 接口测试（接口测试成功后 库存同步及发货同步有效，必写！）网店管家启动消息同步之前，会测试接口有效性。参数如下：参数说明uCode接入码，用于验证请求的有效性。接入码的值在网店系统和网店管家中设置，必须一致。mType请求类别，测试时，该值为“mTe