接口已更新并测试完毕,请旧版自动下单用户尽快更新到新版,任何问题欢迎询问,感谢!目录说明
一、自动下单简介、担保交易简介A、自动下单简介:
自动下单接口会大幅提高您的自动化程度,减少人工成本。原理:收货网站需收货时可首先通过接口调用比价器数据,参考定价后通过自动下单接口或担保交易接口发信号到比价器,比价器会按最近一个月的订单取消率低于10%的价低者优先原则自动匹配库存商(不够的话再其余价低者优先),然后返回信号由贵站自动为他们(他)生成订单,接着比价器报警通知他们(他)登录贵站出货,若某个供应商5分钟内未查看订单我们还会自动短信通知他。
特别注意:库存数据今后只有在供应商愿意将他在贵站的用户名在比价器登记并打勾表示愿意向您自动下单时才会显示给您,因此收货网站做好接口后请联系比价器发内部公告给所有供应商,由他们在比价器对贵站进行设置后方能生效;另外请您务必维护好接口及自身品牌,努力增加自动下单量,不然会导致今后愿意向贵站公布数据的供应商越来越少,影响您的收货效率,从而影响国外竞争力。 B、担保交易简介(担保交易系统已包含自动下单功能,担保交易收货商无需额外做自动下单接口):
担保交易接口会大幅提高您的自动化程度,不仅减少人工成本,还可以减少财务成本(支付宝批量付款手续费仅千分之一,每天批量付一次款即可,避免人工错误)。原理:请查看《担保交易指南》。欢迎点此免费自助开通担保交易收货帐号后认真体验一下。注:200元押金是可以随时退还的。
C、非担保交易自动下单与担保交易自动下单的区别:
非担保交易自动下单,供应商必须拥有在贵站的用户名并在比价器设置是否接受贵站自动下单,订单是在贵站管理;担保交易系统包含了自动下单功能,供应商无需在贵站注册也无需额外设置,订单是由您登录比价器管理(可自动发信号到贵站备份),您必须拥有比价器担保交易收货帐号。担保交易系统不仅各项细节追求高效自动化,更重要的是拥有庞大忠实的供应商用户群和订单量,供应商对界面操作及规则熟悉,下单后勿需切换登录到外部网站,他的订单在一个地方统一管理,以上各项对他来说都更方便。因此,价格差距不大时供应商通常会优先向担保交易收货商下单。另外,您可添加多个子帐号并设置不同权限交由不同客服去管理,亦可评价不同客服的工作质量;收货后信号可即时返回给您用于发通知给顾客、财务统计或备份等;还可免费为您做个性化改进。
D、库存数据接口仅限一手自动下单或部分一手担保交易收货商使用,请务必维护好您的接口!
二、网关总序:(点击此处下载php代码开发包,代码同以下演示)(一) 请在比价器注册一个用户名后联系我们授权,审核后我们会告诉您用户编号(参数名为uid)和网关签名密码(参数名apikey)(二) 如何与比价器交换信息? 1、把要请求的数据和apikey一起计算出签名sign,然后再把要请求的数据和sign一起发到网关 http://api.bijiaqi.com/gateway.php 2、请求参数:必要的请求参数有以下3个
3、一次完整的发送数据到比价器的过程示范
var data = {"youdata":456,"uid":123,"cmd":"getprice"}; //这里是您需要发送到比价器的数据
注:以上开发代码请参考 cls.bijiaqi.php ,点此下载,以下示例全部使用cls.bijiaqi.php演示 var sign_data = [],request_data = []; //初始化要签名的变量和发送到比价器网关的参数变量 foreach(var name in data){ //遍历要请求的变量 if(name != "sign" && name != "apikey"){ //sign变量和apikey变量不要纳入计算 sign_data.push(name+"="+data[name]); //把要发送的数据用"参数=参数值"的字符串方式连接起来放入数组 request_data.push(name+"="+urlencode(data[name])); //要发送的数据urlencode变量之后添加到数组 } } sign_data.sort(); //参数排序:因为参数顺序不一样,md5之后的值不一样,所以需要排序 var sign = md5(apikey+sign_data.join("&")); //计算sign,sign_data排序后的数组用"&"连接起来,然后md5得到sign签名值 http.get("http://api.bijiaqi.com/gateway.php"?+request+data.join("&")+"sign="+sign); //发送数据到比价器网关 4、比价器返回结果:比价器返回的结果为utf8编码的xml文件。如下图,数据分为base节点(请求状态)和data节点(数据信息)区域。
<?xml version=”1.0” encoding=”utf-8” ?>
<root> <base><status>fail</status><errno>错误代码</errno><error>错误信息</error></base> <data>其他数据</data> </root> 三、新版自动下单接口(非担保交易)说明:旧版接口已停用,新版功能更强大,请旧版用户尽快改用新接口,任何问题欢迎询问,非常抱歉给您造成不便,感谢您的谅解!(一) 如何调用全区库存或单区库存:点此查看>>> (二) 您发收货需求到比价器来匹配: 1、请求参数列表
《比价器各服务器名称与ID对照表》请点http://www.bijiaqi.com/service/?action=hostlist下载后与贵站的服务器名称对照使用 require "cls.bijiaqi.php"; //引入比价器网关类 $bijiaqi = new bijiaqi("您的UID","您的APIKEY"); $bijiaqi->request(array("cmd"=>"stockorder","serverid"=>1,"extid"=>10011,"price"=>0.005, "custom"=>"dfdszsd^0,0045^".md5("10011|0.005||salt"),"quantity"=>10000, "minquantity"=>2000,"isline"=>0)); 2、数据区域返回格式 <message>OK</message>
3、错误代码列表
(三) 比价器返回信号由您自动为其在贵站生成订单;然后比价器每5分钟过来查询一次订单状态,用于对供应商进行评估和管理 1、自动下单参数列表
2、贵站收到信号后需自动返回以下内容给比价器,以便比价器给供应商自动报警或短信提示他到贵站登录出货: “version=1.2;charset=gbk[字符编码utf8 OR gbk];errno=0[错误编号];error=[错误内容];quantity=[下单成功的数量];price=[下单价格];orderid=[订单编号]”
3、下单成功后比价器会每隔5分钟会到贵站查询该订单状态,用于对供应商的评估和管理。以下是订单状态查询参数列表:
比价器查询状态时请贵站返回以下内容给比价器: “version=1.2;charset=gbk;errno=0;error=;orderid=11111,22222,33333 订单号1,状态码 订单号2,状态码” 说明:详细数据参数从第二行开始,各列之间用”,”分割,第一列是订单号,第二列是状态号 状态号如下: BUYER_SEND_CONFIRM (供应商已发货待查) PROCESSING (以下状态以外的其它状态) * 只有当订单处于以上两种状态时,比价器才会5分钟过来查询一次,处于以下状态时就不再过来查询了 BUYER_CANCEL (供应商取消订单) SELLER_CANCEL (收货网站取消订单) TIMEOUT_CANCEL (订单超时取消) COMPLETED (订单交易成功) PHP代码处理示例:
if($_REQUEST[‘service’]==’status’){
Echo “version=1.2;charset=gbk;errno=0;error=;orderid=11111,22222,33333\r\n”;#输出首行 Foreach(explode(“,”,$_REQUEST[‘orderid’]) AS $orderid){ If($rs = $db->query(“SELECT * FROM order WHERE orderid=”.$db->quote($orderid,”s”))){ If(in_array($rs[‘status’],array(“准备发货”,”XXXX”)){ Echo “$orderid, PROCESSING\r\n”; }else If(in_array($rs[‘status’],array(“供应商确认已经发货”,”XXXX”)){ Echo “$orderid, BUYER_SEND_CONFIRM\r\n”; } else If(in_array($rs[‘status’],array(“供应商取消订单”)){ Echo “$orderid, BUYER_CANCEL \r\n”; } else If(in_array($rs[‘status’],array(“网站取消订单”)){ Echo “$orderid, SELLER_CANCEL\r\n”; } else If(in_array($rs[‘status’],array(“超时取消”)){ Echo “$orderid, TIMEOUT_CANCEL\r\n”; } else If(in_array($rs[‘status’],array(“确认收货”,”订单已经结算”)){ Echo “$orderid, COMPLETED\r\n”; } } } } 四、担保交易接口-老外下单后自动发布到比价器担保交易收货,本接口已包含上述自动下单功能 (演示地址)1、请求参数列表
《比价器各服务器名称与ID对照表》请点http://www.bijiaqi.com/service/?action=hostlist下载后与贵站的服务器名称对照使用 require "cls.bijiaqi.php"; //引入比价器网关类
$bijiaqi = new bijiaqi("您的UID","您的APIKEY"); $bijiaqi->request(array( "cmd"=>"updateneed", "gameid"=>10, "serverid"=>1, "orderid"=>"No.1", "notice"=>"到这里来交易", "price"=>"0.0002", "quantity"=>1000, "minquantity"=>100, "ispublic"=>0, "isline"=>0, "isah"=>1000 //整数倍 )); 2,数据区域返回格式
<need needid="1 [需求编号]" price="0.002 [价格]" quantity="1000 [数量]" minquantity="0 [最小数量]" ispublic="1 [是否发布需求]" isline="0 [交易类型]" />
2、错误代码列表
五、担保交易订单修改接口1、请求参数列表
require "cls.bijiaqi.php"; //引入比价器网关类
$bijiaqi = new bijiaqi("您的UID","您的APIKEY"); $bijiaqi->request(array( "cmd"=>"updateorder", "orderid"=>11, "remark"=>1 )); 2,数据区域返回格式
<order orderid="1 [需求编号]" price="0.002 [价格]" quantity="1000 [数量]" minquantity="0 [最小数量]" isline="0 [交易类型]"
status="订单状态" />
2、错误代码列表
六、担保交易信号返回-订单状态变更时从比价器实时发信号给您自用,您可用它自动通知顾客、财务统计等若您需实现本功能,请您联系客服预先设置好信号的接收地址(参数名为apiipn)。当订单状态变更时,比价器会使用http POST发送信号您预设的地址去,您可以使用apikey校正数据的有效性,PHP示例代码如下:
require "cls.bijiaqi.php"; //引入比价器网关类
下列为订单状态变更的变量清单:
$bijiaqi = new bijiaqi("您的UID","您的APIKEY"); if($_REQUEST['sign'] == $bijiaqi->sign($_POST)){ //orderipn为订单状态通知 if($_REQUEST['cmd'] == "orderipn"){ if($_POST['status']=='COMPLETED'){ //订单改成收货商确认收货后您的处理 echo $_POST['needorderid']; } //orderalipay为批量打款之后接收支付宝返回的信息,方便您做财务处理 }else if($_REQUEST['cmd']=="orderalipay"){ ...... } }
七、如何通过接口自动调用比价器库存数据(点此人工查看比价器库存数据表)比价器库存数据接口仅授权给自动下单收货商和部分一手担保交易收货商使用,请务必维护好您的自动下单或担保交易接口:(一) 调用全区库存数据:既可用于您参考,又可用于您汇总后发布到国外直接销售(若您自己有库存亦可将自己的库存与之汇总) 1、请求参数列表
require "cls.bijiaqi.php"; //引入比价器网关类
$bijiaqi = new bijiaqi("您的UID","您的APIKEY"); $bijiaqi->request(array("cmd"=>"getprice")); 2、数据区域返回格式
<game> <gameid>10 [游戏ID]</gameid> <gamename>魔兽世界(美服) [游戏名称]</gamename> <gamecode>WOWUS [游戏代码]</gamecode> <argprice>0.0306 [全区扫货均价参考]</argprice> <argstockprice>0.0504 [全区库存参考均价]</argstockprice> <stock> <item serverid="1 [服务器ID]" servername="Aegwynn US – Alliance [服务器名称]" quantity="120000 [库存量]" minquantity="5000 [最小下单数量]" stockprice="0.0230 [库存参考价格]" /> </stock> ... <stock> <item serverid="1 [服务器ID]" servername="Aegwynn US – Alliance [服务器名称]" language="de [服务器语言]" price="0.0230 [扫货价格]" /> </stock> </game> 《比价器各服务器名称与ID对照表》请点http://www.bijiaqi.com/service/?action=hostlist下载后与贵站的服务器名称对照使用 3、错误代码列表
(二) 调用单区库存数据 1、请求参数列表
《比价器各服务器名称与ID对照表》请点http://www.bijiaqi.com/service/?action=hostlist下载后与贵站的服务器名称对照使用 require "cls.bijiaqi.php"; //引入比价器网关类
$bijiaqi = new bijiaqi("您的UID","您的APIKEY"); $bijiaqi->request(array("cmd"=>"showserver","serverid"=>1)); 2、数据区域返回格式 <game>
<gameid>10 [游戏ID] </gameid> <gamename>魔兽世界(美服) [游戏名称] </gamename> <gamecode>WOWUS [游戏代码]</gamecode> <avgprice>0.00295 [全区扫货均价参考]</avgprice> <avgstockprice>0.00503 [全区库存参考均价] </avgstockprice> </game> <server> <serverid>402 [服务器ID] </serverid> <servername>Tichondrius US - Horde [服务器名称] </servername> </server> <stock> <item serverid="402 [服务器id] " servername="Tichondrius US - Horde [服务器名称] " stockid="07e86b64 [库存编号] " quantity="75659 [库存数量] " minquantity="5000 [最小下单数量] " stockprice="0.00579 [库存参考价] " online="1 [用户是否登录比价器,1为在线] " failcount="65 [失败订单数] " successcount="955 [成功订单数] " orderopen="1 [用户是否对您开放下单] " ordertype="0 [下单类型,0表示只下您的即时收货订单,1表示非即时收货订单也下] " /> </stock> 3、错误代码列表
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||