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

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