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

《网店管家云 端版》独立商城接 口V1 .0

1.机制

《esAPI云端版》主动发起请求 网店系统验证请求后返回对应信息。

2.消息格式

所有调用采用http Post方式来获取信息

A 调用URL调用的地址由商家自行定义抓单发货商品三个模块可以分开。

B 系统级参数每个接口都必须传入这3个值。

签名sign

调用API时需要对请求参数进行签名验证 根据参数名称按照字母先后顺序排序:key+value. . . .key+value

需要排列的参数包括u Code mType Secre t,TimeS tamp。其中Sec ret是密钥会在esA PI里面填写商家自己这边需要设置不会进行参数传值

例如将uCode=1,mType =2,Secre t=ABCD TimeS tamp=123456789参数名和参数值链接后得到拼装字符串mType2TimeStamp 123456789u Code1 最后将Se cret拼接到头尾 ABCDmType2TimeStamp123456789uC ode1A BCD。

加密方式:md5进行md5加密后再转化成大写格式是 md5(ABCDmType2TimeStamp123456789uCode1A BCD)最后得到

AC6E8A8F690D1D3595131CE8ADD46F88

*请注意返回字段大小写,严格区分,比如3. 1的<rsp>改成<Rsp>,测试接口必须在广域网下进行。

接口简单测试地址

仅上班时间开放 http://differcom.gnway.cc:86/ecshopnew/data/spider/test.php

1订单列表查询

接口文件接收消息后将符合条件的订单按照如下格式返回

注订单状态为1获取之后可以递交到订单审核管家F2界面。

订单状态为0获取之后在管家原始单 管家F4界面 并不递交到审核界面。

1如果此订单已经获取并且在原始单状态则直接标记此订单为关闭并不再获取。

2如果此订单未获取不做任何处理。

例:

<?xml version=' 1.0' encoding='utf-8'?>

<Order>

<OrderList>

<OrderNO>20148733784879</Order NO>

<OrderNO>201487337824879</OrderNO>

</OrderList>

<OrderCount>2</OrderCount>

<Page>1</ Page>

<Resul t>1</Resul t>

<Cause ></Cause>

</Order>

2订单详细

接口文件接收消息后将符合条件的订单按照如下格式返回

例

<?xml version=' 1.0' encoding='utf-8'?>

<Order>

<Resul t>1</Resul t>

<Cause ></Cause>

<OrderNO>2014050596743</OrderNO>

<DateTime>2014-05-05 20:46:04</DateTime><BuyerID><! [CDATA[freedomktt] ]></BuyerID><BuyerName><! [CDATA[杭州-李] ]></BuyerName><Country><! [CDATA[中国] ]></Country>

<Province><! [CDATA[安徽] ]></Province>

<Ci ty><! [CDATA[安庆] ]></Ci ty>

<Town><! [CDATA[迎江区] ]></Town>

<Adr><! [CDATA[到我的点点滴滴]]></Adr>

<Zip><! [CDATA[331022] ]></Zip>

<Emai l><! [CDATA[1728125@qq.com] ]></Emai l><Phone><! [CDATA[186655123] ]></Phone>

<Total>265</Total>

<logisticsName><! [CDATA[] ]></logisticsName><chargetype><! [CDATA[担保交易] ]></chargetype><PayAccount><! [CDATA[支付宝] ]></PayAccount><PayID><! [CDATA[1] ]></PayID>

<Postage>0.00</Postage>

<CustomerRemark><! [CDATA[] ]></CustomerRemark><Remark><! [CDATA[备注231 23123123] ]></Remark><InvoiceTitle><! [CDATA[] ]></InvoiceTitle><Item>

<GoodsID><! [CDATA[98564] ]></GoodsID>

<GoodsName><! [CDATA[矿泉水] ]></GoodsName><Price>265.00</Price>

<GoodsSpec></GoodsSpec>

<Count>1</Count>

</Item>

<Item>

<GoodsID><! [CDATA[98564] ]></GoodsID>

<GoodsName><! [CDATA[矿泉水] ]></GoodsName><Price>265.00</Price>

<GoodsSpec></GoodsSpec>

<Count>1</Count>

</Item>

</Order>

2 发货通知

当订单发货时 《网店管家》会产生对应的发货通知消息。参数如下

成功 <?xml vers ion='1.0' enc oding='utf-8'?><Rsp><Resul t>1</Resul t></Rsp>

失败 <?xml version='1.0' enc oding='utf-8'?><Rsp><Resul t>0</Resul t><Caus e>拒绝原因</Caus e></Rsp>

3商品查询接口商品接口 此操作为库存同步之前做erp商品和平台商品映射用(平台商品导入到管家,也采用此接口)。参数如下

接口文件接收消息后将符合条件的订单按照如下格式返回