快递物流寄件下单api接口调用对接
免费顺丰快递接口api对接调用demo
(1)开发服务
开发自身业务的服务,服务需按照后面接口的定义规则。
(2)查看接口调用的DEMO
物流技术接口提供调用物流接口的DEMO(.Net版本),包括网上在线订单下单、物流轨迹查询等物流行业标准化的下单操作流程与数据查询格式。提交接入处理的相关代码如有不明白的地方可与物流技术接口人协作开发。
(f)接收方判断签名后的数据跟传递过来的DataSign是否一致,如果一致进行业务操作,如果不一直返回错误。
9
///<summary>
///电商Sign签名
///</summary>
///<param name="content">内容</param>
///<param name="keyValue">Appkey</param>
"LogisticCode": "118461988807",
"Success": true,
"State": 3,
"Reason": null,
"Traces": [
{
"AcceptTime": "2014/06/25 08:05:37",
"AcceptStation": "正在派件..(派件人:邓裕富,电话:18718866310)[深圳市]",
在POST请求中会传递5个参数
4个必须参数:
RequestType=请求指令类型
EBusinessID==电商ID
顺丰快递接口api对接调用说明【快递鸟】
常用快递接口,顺丰快递接口api对接调用顺丰快递是常用快递,电商、ERP等企业都需要对接其快递接口api。
对接有两种方式,第一和顺丰快递直接对接,第二,和快递鸟对接,和快递鸟对接可以一次性接入其他常用快递的接口。
快递100有顺丰接口,不过只能查询不能打印电子面单,而且是收费的,菜鸟有电子面单接口,但又不支持顺丰快递。
接口平台:快递鸟免费查询接口接口地址:http://ap /Ebusiness/EbusinessOrd erHandle.aspx支持格式:json请求方式:HTTP POST请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"。
顺丰快递接口api申请JSON请求/返回示例:1.请求{"OrderCode": "","ShipperCode": "SF","LogisticCode": "118650888018"}2.返回没有物流轨迹的{"EBusinessID": "1109259","Traces": [],"OrderCode": "","ShipperCode": "SF","LogisticCode": "118461988807","Success": false,"Reason": null}有物流轨迹的{"EBusinessID": "1109259","OrderCode": "","ShipperCode": "SF","LogisticCode": "118461988807","Success": true,"State": 3,"Reason": null,"Traces": [{"AcceptTime": "2014/06/25 08:05:37","AcceptStation": "正在派件..(派件人:邓裕富,电话:187****6310)[深圳市]","Remark": null},{"AcceptTime": "2014/06/25 04:01:28","AcceptStation": "快件在深圳集散中心,准备送往下一站深圳[深圳市]","Remark": null},{"AcceptTime": "2014/06/25 01:41:06","AcceptStation": "快件在深圳集散中心[深圳市]","Remark": null},{"AcceptTime": "2014/06/24 20:18:58","AcceptStation": "已收件[深圳市]","Remark": null},{"AcceptTime": "2014/06/24 20:55:28","AcceptStation": "快件在深圳,准备送往下一站深圳集散中心[深圳市]", "Remark": null},{"AcceptTime": "2014/06/25 10:23:03","AcceptStation": "派件已签收[深圳市]","Remark": null},{"AcceptTime": "2014/06/25 10:23:03","AcceptStation": "签收人是:已签收[深圳市]","Remark": null}]}注:接口及签名说明1)、支持http传输协议2)、支持的数据传输格式Json/Xml(暂不支持<content/>这种形式)。
免费快递在线下单接口对接文档 (PHP)
1.3.4 应用级输入参数
参数名称 CallBack MemberID
CustomerName
CustomerPwd SendSite ShipperCode LogisticCode OrderCode MonthCode
PayType
ExpType IsNotice Cost OtherCost
描述 请求内容,JSON 格式,须和 DataType 一致
R
电商 ID
R
请求指令类型:1001
R
数据内容签名
O
请求、返回数据类型:2-json;
1.1.3 应用级输入参数
参数名称 WarehouseID WarehouseAddress CallBack MemberID ShipperCode
类型 String String String String String
Bool String
必须要求 R R R R
R O
说明 电商用户 ID 订单编号 快递公司编码 快递单号
成功与否:true,false 失败原因
1.2.6 JSON 请求示例
{ "OrderCode": "201406240005", "ShipperCode": "ZJS", "LogisticCode": "118461988807"
Company Name Tel Receiver Mobile PostCode ProvinceName
类型 String String
String String String String String String String
php快递鸟单号查询api接口免费对接调用
php快递鸟单号查询api接⼝免费对接调⽤快递鸟集成快递单号查询API接⼝,可以同时对接顺丰快递查询,中通、申通、圆通、韵达、百世、EMS等国内外418家物流快递公司接⼝查询等。
这些快递物流企业,提供了快递单号⾃动识别接⼝,快递单号查询接⼝等快递物流服务。
对于电商企业,ERP服务企业,集成此接⼝到⾃⼰的软件中,增加了企业的竞争⼒。
⼀、接⼝应⽤场景1.在电商平台购物后,通过购物订单跟踪物流时,调⽤此API获取物流信息详情2.处理运费对账时,⼀键获取运单物流状态3.批量跟踪及获取运单物流信息对接流程快递鸟⽹站申请接⼝KEY并认证-对接接⼝-调试-上线使⽤三、技术对接快递鸟提供的快递查询接⼝,⽀持418家快递物流查询,涵盖了国内外主流快递服务企业的单号查询,信息及时,数据完整。
登录快递鸟官⽹⽀持多种开发语⾔对接,包括JAVA,C#,PHP等。
根据您的开发语⾔,选择参考对应的代码⽰例,下⾯以PHP代码为例:<?php//电商IDdefined('EBusinessID') or define('EBusinessID', '123456');//电商加密私钥,快递鸟提供,注意保管,不要泄漏defined('AppKey') or define('AppKey', '1234567890');//请求url:测试地址//defined('ReqURL') or define('ReqURL', ':8080/kdniaosandbox/gateway/exterfaceInvoke.json');//请求url:正式地址defined('ReqURL') or define('ReqURL', '/Ebusiness/EbusinessOrderHandle.aspx');$kgs = "JD";//快递公司简称,官⽅有⽂档$number = "12345678";//快递单号//调⽤查询物流轨迹//---------------------------------------------$logisticResult=getOrderTracesByJson($kgs,$number);echo$logisticResult;//解析数据$data = json_decode($logisticResult,true);if($data['Success'] == true){//返回信息成功$str = "";if(isset($data['Traces']) && !empty($data['Traces'])){for($i=0;$i<count($data['Traces']);$i++){$str .= "时间:".$data['Traces'][$i]['AcceptTime']."<br/>地址:".$data['Traces'][$i]['AcceptStation']."<br/>";}}echo "您查询的单号是:".$data['LogisticCode']."<br/>物流信息:<br/>".$str."";}//---------------------------------------------/*** Json⽅式查询订单物流轨迹*/function getOrderTracesByJson($kgs,$number){$requestData= "{'OrderCode':'','ShipperCode':'$kgs','LogisticCode':'$number'}";$datas = array('EBusinessID' => EBusinessID,'RequestType' => '1002','RequestData' => urlencode($requestData) ,'DataType' => '2',);$datas['DataSign'] = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);//根据公司业务处理返回的信息......return$result;}/*** post提交数据* @param string $url 请求Url* @param array $datas 提交的数据* @return url响应返回的html*/function sendPost($url, $datas) {$temps = array();foreach ($datas as$key => $value) {$temps[] = sprintf('%s=%s', $key, $value);}$post_data = implode('&', $temps);$url_info = parse_url($url);if(empty($url_info['port'])){$url_info['port']=80;}$httpheader = "POST " . $url_info['path'] . " HTTP/1.0\r\n"; $httpheader.= "Host:" . $url_info['host'] . "\r\n";$httpheader.= "Content-Type:application/x-www-form-urlencoded\r\n"; $httpheader.= "Content-Length:" . strlen($post_data) . "\r\n"; $httpheader.= "Connection:close\r\n\r\n";$httpheader.= $post_data;$fd = fsockopen($url_info['host'], $url_info['port']);fwrite($fd, $httpheader);$gets = "";$headerFlag = true;while (!feof($fd)) {if (($header = @fgets($fd)) && ($header == "\r\n" || $header == "\n")) {break;}}while (!feof($fd)) {$gets.= fread($fd, 128);}fclose($fd);return$gets;}/*** 电商Sign签名⽣成* @param data 内容* @param appkey Appkey* @return DataSign签名*/function encrypt($data, $appkey) {return urlencode(base64_encode(md5($data.$appkey)));}>。
快递单号查询API接口对接流程
快递单号查询API接口对接后可以在自己的网站点击查询就能查到物流轨迹,像京东淘宝查询物流的功能一样,适合一些自己研发的系统商、微信小程序,还有自己的电商网站。
方法/步骤
进入快递鸟网站下载对接相关的接口文档,和接口demo案例,接口demo案例可以直接调用,不用自己编写代码。
如果需要自己编写,可以参照接口文档
另外即时查询API、物流跟踪API和在途监控API都是查询快递的,可以根据不同情况对接使用
在右上角注册账号登录后进行账号认证,就可以对接接口了
在账号登录后首页可以查看接口ID和接口KEY,复制到demo中的“EBusinessID”和“AppKey”两个参数中,demo就可以使用了
对接完成后就是在调试平台调试接口,对比请求报文和返回报文确认对接是不是正确的。
这里需要注意的是,对接的是什么接口,就查看什么接口的调试报文
测试后就可以正式调用了,正式调用的时候在正式地址调用
最后做一个物流轨迹的数据展现就可以了,如下图。
国际快递查询API接口对接JAVA示例
国际物流快递查询API接口java如何对接国际快递查询接口的需求量很大,例如一些跨境电商B2C网站、快递查询APP、快递柜、跨境物流公司等都会需要用到国际快递接口。
目前市面上的快递接口,以国内快递居多,有些虽然号称支持多家国际快递和国际邮政,但实际调用时,由于国际快递网站变化较多,所以经常出现不稳定的情况。
这里我要介绍的是快递鸟的国际快递接口,他们一直专做国际快递,支持的国内外600多家快递,大部分国外主流快递物流公司的接口可以对接,提供的接口也非常可靠。
国际快递特性(含国际邮政)1.可在两个网站查询到信息:属于万国邮联的国际邮政单号,可以分别在发件国家邮政官网与目的国家邮政官网查询到数据。
相对而言,国内快递一般只需要在一个网站查询数据。
2.海关问题:国际包裹是跨国包裹,需要通过两国的海关查验,有时候会被海关扣押,进而导致时效不如国内快递稳定。
3.运输时间长:国际邮政包裹相对国际快递价格便宜很多,所以运输时间也慢,甚至会需要1到2个月才能签收。
4.多语言问题:由于包裹是跨国的,必然会涉及多语言问题,国内客户需要看到的是中文信息,而国外客户希望看到的是当地语言的物流信息。
国际快递API特性(快递鸟)1.包含发件国与目的国的数据:快递鸟的API中包含的参数有 origin_info(发件国物流信息)和destination_info(目的国物流信息),所以通过该接口可以让用户看到最为完整的物信息。
2.智能识别快递状态:当检测到包裹在海关停滞,或者包裹被退回等信息,快递鸟会返回“exception”(可能异常)的状态,帮助用户第一时间发现异常件,从而尽早处理。
3.按照单号个数计费:由于国际包裹的运输时间很长,完整的运输周期可能需要两个月,而每天至少需要查询两次以上。
所以按照查询单号个数计费而不是按照API调用次数计费,是最为良心的计费方式。
4.多语言API:针对不同的快递商,可以按照语言返回不同的结果。
物流快递单号查询接口种类及对接方法
物流快递单号查询接口种类及对接方法目前快递查询接口有两种方式可以对接,一是和顺丰、圆通、中通、天天、韵达、德邦这些快递公司一一对接接口,二是和快递鸟这样第三方集成接口一次性对接多家常用快递。
第一种耗费时间长,但是是直接和快递公司合作,第二种虽然是间接对接,但是对接简便,对后期的接口维护可以省很多时间和人力成本。
集成接口还有其他公司提供,有其他需要可以去找,快递鸟其实能满足电商、ERP系统商这些企业需求了。
这里就以快递鸟为例说说对接方法。
快递鸟物流查询接口有免费和收费版本,对接周期大概在一天左右,他们有写好的demo,可以直接使用。
一.即时查询接口(免费)1. 接口规则(1)、查询接口支持按照运单号查询(单个查询,并发不超过10个/S)。
(2)、指定的物流运单号选择相应的快递公司编码,格式不对或则编码错误都会返失败的信息。
如EMS物流单号应选择快递公司编码(EMS)(3)、返回的物流跟踪信息按照发生的时间升序排列。
(4)、接口指令1002。
(5)、请求地址:快递鸟2. 系统级和应用级输入参数返回结果参数这个是用户在订阅单号成功且有物流轨迹更新后,快递鸟的推送客户通过下单、订阅接口,把运单号在快递鸟系统订阅。
运单物流信息有更新,快递鸟通过推送接口把更新的信息推送给客户。
推送接口由用户按照快递鸟规则实现。
商户开放接口,快递鸟定时将最新的物流轨迹推送到商户平台。
优点:客户不需要关注轨迹变化,一旦有更新,快递鸟自动推送。
缺点:对客户的服务器性能有所要求,快递鸟定时请求接口,对客户的服务器有一定的影响,客户服务器异常将接受不到最新数据。
快递鸟推送接口根据业务不同,会根据RequestType的分类推送不同的数据,用户需对推送的数据进行分类保存。
原推送接口无需变化,快递鸟会根据推送版本进行推送。
1. 接口规则(1)、客户服务器必须稳定,并且有一定的接受数据能力(需要在5S内给快递鸟返回成功示例,超时会判断推送失败)。
免费物流查询API接口对接流程-快递鸟
目前快递鸟物流查询API接口有两种对接方式,这两种方式都需要先到快递鸟官网上填写申请信息(注册网址:/reg)填写申请信息,信息表格中“日查询次数”要选择对,如果不确认,可以先接入查询接口。
申请完成,登录就可以看到自己的ID和KEY,这个ID和KEY只能一个公司使用,保证数据的稳定性,所以这个ID和KEY都是保密的。
从这一步开始,每日查询次数≤3000次和>3000的对接方式就不一样了。
1.每日查询次数≤3000次(即时查询接口)即时查询接口,是根据快递单号和快递公司编码实时查询物流轨迹信息的接口。
注册后可以参照如下进行开发对接:1.1即时查询接口对接描述/说明(1)根据订单编号和快递公司编码查询物流轨迹信息(支持在快递鸟订单)。
(2)根据快递单号和快递公司编码查询物流轨迹信息。
(3)接口需要指定快递单号的快递公司编码,格式不对或则编码错误都会返失败的信息。
如:EMS物流单号应选择快递公司编码(EMS)查看快递公司编码(4)返回的物流跟踪信息按照发生的时间升序排列。
(5)接口支持的消息接收方式为HTTP POST,请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"。
(6)请求系统级参数说明:备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)。
(7)接口地址:API地址:/Ebusiness/EbusinessOrderHandle.aspx (8)接口参数请求内容字段定义返回参数定义2.每日查询次数>3000(订阅接口)订阅推送接口,用户订阅快递单号,快递鸟系统会定时推送新的物流信息。
注册后填写《用户接入表》(接入表下载网址/download),完善《用户信息登记表》、《物流数据需求表》这两个表格的内容,并发送到service@。
国际快递查询API接口对接JAVA示例
国际快递查询API接⼝对接JAVA⽰例国际物流快递查询API接⼝java如何对接国际快递查询接⼝的需求量很⼤,例如⼀些跨境电商B2C⽹站、快递查询APP、快递柜、跨境物流公司等都会需要⽤到国际快递接⼝。
⽬前市⾯上的快递接⼝,以国内快递居多,有些虽然号称⽀持多家国际快递和国际邮政,但实际调⽤时,由于国际快递⽹站变化较多,所以经常出现不稳定的情况。
这⾥我要介绍的是快递鸟的国际快递接⼝,他们⼀直专做国际快递,⽀持的国内外600多家快递,⼤部分国外主流快递物流公司的接⼝可以对接,提供的接⼝也⾮常可靠。
国际快递特性(含国际邮政)1.可在两个⽹站查询到信息:属于万国邮联的国际邮政单号,可以分别在发件国家邮政官⽹与⽬的国家邮政官⽹查询到数据。
相对⽽⾔,国内快递⼀般只需要在⼀个⽹站查询数据。
2.海关问题:国际包裹是跨国包裹,需要通过两国的海关查验,有时候会被海关扣押,进⽽导致时效不如国内快递稳定。
3.运输时间长:国际邮政包裹相对国际快递价格便宜很多,所以运输时间也慢,甚⾄会需要1到2个⽉才能签收。
4.多语⾔问题:由于包裹是跨国的,必然会涉及多语⾔问题,国内客户需要看到的是中⽂信息,⽽国外客户希望看到的是当地语⾔的物流信息。
国际快递API特性(快递鸟)1.包含发件国与⽬的国的数据:快递鸟的API中包含的参数有 origin_info(发件国物流信息)和destination_info(⽬的国物流信息),所以通过该接⼝可以让⽤户看到最为完整的物信息。
2.智能识别快递状态:当检测到包裹在海关停滞,或者包裹被退回等信息,快递鸟会返回“exception”(可能异常)的状态,帮助⽤户第⼀时间发现异常件,从⽽尽早处理。
3.按照单号个数计费:由于国际包裹的运输时间很长,完整的运输周期可能需要两个⽉,⽽每天⾄少需要查询两次以上。
所以按照查询单号个数计费⽽不是按照API调⽤次数计费,是最为良⼼的计费⽅式。
4.多语⾔API:针对不同的快递商,可以按照语⾔返回不同的结果。
物流退换货取件快递api接口及对接调用方式
电商平台退换货取件快递API接口对接应用场景:电商拼命做好了交易服务,但没有在线退货寄件功能,买家线下寄件太麻烦对平台服务不满。
买家在电商平台退货手动录入单号,经常输入错误导致无法退款,平台人工介入成本太高!卖家在平台不能及时获得轨迹,审核退款时效太慢!平台客服无法及时监控退货的进展,天天收到售后投诉!对接流程:申请快快递鸟账号-申请API-对接-调试-测试-使用1、登录快递鸟官网注册页面注册快递鸟账号2、登录用户管理后台注:登录用户管理后台后获得用户ID和APIKey,此用于保证应用来源的可靠性,避免应用伪造,被不法使用。
进入“我的会员中心”进行实名认证注:1、认证类型、应用类型根据用户实际情况选择即可,接口返回数据与选择结果无关;2、标记为*的为必填,要求上传清晰、jpg格式且小于2M的证件图片;3、技术对接人信息为用户方对接工程师的信息;4、如有其他疑问可进入官网加入商务合作群进行咨询。
认证成功后,进入“产品服务管理”,开通相关会员服务(如选择电子面单)请求系统级参数说明接口参数(请求内容字段定义)适用于快递物流商:顺丰速运SF、百世快递HTKY 、中通快递ZTO 支持、申通快递STO、圆通速递YTO、韵达速递YD 、邮政快递包裹YZPY、EMSEMS、天天快递HHTT 、京东快递JD、优速快递UC 、德邦快递DBL、宅急送ZJS 支持TNT快递TNT 支持UPS UPS 支持DHL DHL 支持FEDEX联邦(国内件)FEDEX 支持FEDEX联邦(国际件)FEDEX_GJ 支持国内A安捷快递AJ 支持阿里跨境电商物流ALKJWL 支持安迅物流AX 支持安邮美国AYUS 支持亚马逊物流AMAZON 支持澳门邮政AOMENYZ 支持安能物流ANE 支持。
接入快递接口API单号识别查询接口demo
接入快递接口API单号识别查询接口demo背景:分享一篇关于在电商系统中同步物流轨迹到本地服务器的文章,当前方案使用了快递鸟集成api做为数据来源接口,这个接口是免费使用的,不过提供的功能还是非常强大的,有专门的售后维护团队。
有多种语言demo可以进行调用1. 需求根据用户输入的订单号,我们的后台识别订单号并根据快递鸟查询快递Api接口,实现自动查询的功能2.应用场景(如图)3、进入“我的会员中心”进行实名认证注:3.1、认证类型、应用类型根据用户实际情况选择即可,接口返回数据与选择结果无关;3.2、标记为*的为必填,要求上传清晰、jpg格式且小于2M的证件图片;3.3、技术对接人信息为用户方对接工程师的信息;3.4、如有其他疑问可进入官网加入商务合作群进行咨询。
认证成功后,进入“产品服务管理”,开通相关会员服务Demo由第三方写好,只需要下载就可以运行用上,(自己做简单的修改)下面是下载Demo的网站,根据自己需要下载6. 下面是java版本的根据单号查询物流跟踪信息的详细代码6.1 创建KdniaoTrackQueryAPI 接口类下面是Demo的main方法测试代码import net.sf.json.JSONArray;import net.sf.json.JSONObject;//测试接口public class Demo {public static void main(String[] args) {KdniaoTrackQueryAPI api = new KdniaoTrackQueryAPI();try {//第一个参数是快递公司简称(YD -- 韵达速递)//第二个参数是需要查询的快递单号String result = api.getOrderTracesByJson("YD", "3827670147715"); JSONObject jsonObject = JSONObject.fromObject(result);String ShipperCode = jsonObject.getString("ShipperCode");String LogisticCode = jsonObject.getString("LogisticCode");JSONArray Traces = jsonObject.getJSONArray("Traces");System.out.print(result+"\n");System.out.println("快递名称"+ShipperCode);System.out.println("快递单号"+LogisticCode);for(int i = 0; i < Traces.size(); i++) {JSONObject object = (JSONObject) Traces.get(i);String AcceptTime = object.getString("AcceptTime");String AcceptStation = object.getString("AcceptStation");System.out.println("时间:"+AcceptTime+"\t"+AcceptStation); }} catch (Exception e) {e.printStackTrace();}}}测试效果实图。
浅谈各种快递单号查询接口种类及对接方法
浅谈各种快递单号查询接口种类及对接方法目前快递查询接口有两种方式可以对接,一是和顺丰、圆通、中通、天天、韵达、德邦这些快递公司一一对接接口,二是和快递鸟这样第三方集成接口一次性对接多家常用快递。
第一种耗费时间长,但是是直接和快递公司合作,第二种虽然是间接对接,但是对接简便,对后期的接口维护可以省很多时间和人力成本。
集成接口还有其他公司提供,有其他需要可以去找,快递鸟其实能满足电商、ERP系统商这些企业需求了。
这里就以快递鸟为例说说对接方法。
快递鸟物流查询接口有免费和收费版本,对接周期大概在一天左右,他们有写好的demo,可以直接使用。
一.即时查询接口1. 接口规则(1)、查询接口支持按照运单号查询(单个查询,并发不超过10个/S)。
(2)、指定的物流运单号选择相应的快递公司编码,格式不对或则编码错误都会返失败的信息。
如EMS物流单号应选择快递公司编码(EMS)(3)、返回的物流跟踪信息按照发生的时间升序排列。
(4)、接口指令1002。
2. 系统级和应用级输入参数返回结果参数4. 示例//请求示例<br>{"OrderCode": "","ShipperCode": "SF","LogisticCode": "118650888018" }//返回示例<br>//没有物流轨迹的{"EBusinessID": "1109259","Traces": [],"OrderCode": "",2.2接收接口这个是用户在订阅单号成功且有物流轨迹更新后,快递鸟的推送客户通过下单、订阅接口,把运单号在快递鸟系统订阅。
运单物流信息有更新,快递鸟通过推送接口把更新的信息推送给客户。
京东物流电子面单接口API-对接说明文档
sr.Close();
backStream.Close();
response.Close();
request.Abort();
}
catch (Exception ex)
{
result = ex.Message;
}
return result;
}
///<summary>
/// <param name="charset">编码方式</param>
/// <returns></returns>
private string base64(String str, String charset)
3.C#对接demo
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using ;
using System.Text;
using System.Web;
namespace KdGoldAPI
3、技术对接及联调(登陆官网使用调试平台进行测试)
4、上线
三.电子面单对接说明
1.接口描述
接口支持的消息接收方式:HTTP POST
请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"
API地址:/Ebusiness/EbusinessOrderHandle.aspx
request.Timeout = 30 * 1000;
常用快递单号物流查询接口通用API(JAVA对接)
常用快递单号物流查询接口通用API (JAVA 对接)快递查询接口通用API 是给发货电商以实现查询快递物流轨迹功能的,接口对接前要先到快递鸟网站申请接口秘钥和APIKEY快递API 的应用场景与用途最常见的应用场景如下:(1)电商网站:例如B2C ,团购,B2B ,批发分销站,C2C ,本地生活交易等网站。
(2)管理系统:订单处理平台,调度平台,发货平台,分销系统,渠道管理系统,客户管理系统,ERP 等。
快递API 的用途如下:(1)让顾客登录网站后,直接在“我的订单”页面上可以看到订单的物流状态。
(2)自动筛选出“已签收”,“疑难件”等状态的单号,减轻物流跟单人员的压力。
(3)更改订单的状态和交易流程,例如单号变为“已签收”,可以让订单转化可以确认退换货等。
(4)评估选择快递公司,根据“已签收”的运单数,可以算出销售人员的业绩,并进行应对的结算。
(5)邮件,短信提醒用户运单的最新状态,可以安抚用户,也可以利用邮件短信二次营销。
对接要求:(1),查询接口支持遵循运输单号查询(个别查询,并发不超过10个/ S )。
(2),指定的物流运输单号选择相应的快递公司编码,格式不对或则编码错误都会返回失败的信息。
例如EMS 物流单号应选择快递公司编码(EMS )(3),返回的物流跟踪信息遵循发生的时间升序排列。
(4),接口指令1002(5),接口提供:快递鸟 (6),请求地址:http ://java 请求示例: 1个2 3 4 5 6 7 8 9 10 import java.io.BufferedReader;import java.io.IOException; import java.io.InputStreamReader;import java.io.OutputStreamWriter;import java.io.UnsupportedEncodingException;import .HttpURLConnection;import .URL;import .URLEncoder;import java.security.MessageDigest;import java.util.HashMap;import java.util.Map;11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 /**** 单日超过500单查询量,建议接入物流轨迹订阅推送接口**/public class KdniaoTrackQueryAPI {//DEMOpublic static void main(String[] args) {KdniaoTrackQueryAPI api = new KdniaoTrackQueryAPI();try {String result = api.getOrderTracesByJson("ANE", "210001633605");System.out.print(result);} catch (Exception e) {e.printStackTrace();}}//电商IDprivate String EBusinessID="申请";//电商加密私钥,注意保管,不要泄漏private String AppKey="申请";//请求urlprivate String ReqURL="/Ebusiness/EbusinessOrderHandle.aspx";/*** Json 方式 查询订单物流轨迹* @throws Exception*/public String getOrderTracesByJson(String expCode, String expNo) throws Exception{String requestData= "{'OrderCode':'','ShipperCode':'" + expCode + "','LogisticCode':'" + expNo + "'}";Map params = new HashMap();params.put("RequestData", urlEncoder(requestData, "UTF-8"));params.put("EBusinessID", EBusinessID);params.put("RequestType", "1002");String dataSign=encrypt(requestData, AppKey, "UTF-8");params.put("DataSign", urlEncoder(dataSign, "UTF-8"));params.put("DataType", "2");String result=sendPost(ReqURL, params);//根据公司业务处理返回的信息......5556575859606162636465666768697071727374757677787980818283848586878889909192939495969798return result;}/*** MD5加密* @param str 内容* @param charset 编码方式* @throws Exception*/@SuppressWarnings("unused")private String MD5(String str, String charset) throws Exception {MessageDigest md = MessageDigest.getInstance("MD5");md.update(str.getBytes(charset));byte[] result = md.digest();StringBuffer sb = new StringBuffer(32);for(int i = 0; i < result.length; i++) {int val = result[i] & 0xff;if(val <= 0xf) {sb.append("0");}sb.append(Integer.toHexString(val));}return sb.toString().toLowerCase();}/*** base64编码* @param str 内容* @param charset 编码方式* @throws UnsupportedEncodingException*/private String base64(String str, String charset) throws UnsupportedEncodingException{ String encoded = base64Encode(str.getBytes(charset));return encoded;}@SuppressWarnings("unused")private String urlEncoder(String str, String charset) throws UnsupportedEncodingException{ String result = URLEncoder.encode(str, charset);return result;}/**99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142* 电商Sign签名生成* @param content 内容* @param keyValue Appkey* @param charset 编码方式* @throws UnsupportedEncodingException ,Exception* @return DataSign签名*/@SuppressWarnings("unused")private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exception{if(keyValue != null){return base64(MD5(content + keyValue, charset), charset);}return base64(MD5(content, charset), charset);}/*** 向指定 URL 发送POST方法的请求* @param url 发送请求的 URL* @param params 请求的参数集合* @return 远程资源的响应结果*/@SuppressWarnings("unused")private String sendPost(String url, Map params) {OutputStreamWriter out = null;BufferedReader in = null;StringBuilder result = new StringBuilder();try{URL realUrl = new URL(url);HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection();// 发送POST请求必须设置如下两行conn.setDoOutput(true);conn.setDoInput(true);// POST方法conn.setRequestMethod("POST");// 设置通用的请求属性conn.setRequestProperty("accept", "*/*");conn.setRequestProperty("connection", "Keep-Alive");conn.setRequestProperty("user-agent","Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");conn.connect();143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186// 获取URLConnection对象对应的输出流out = new OutputStreamWriter(conn.getOutputStream(), "UTF-8");// 发送请求参数if(params != null) {StringBuilder param = new StringBuilder();for(Map.Entry entry : params.entrySet()) {if(param.length()>0){param.append("&");}param.append(entry.getKey());param.append("=");param.append(entry.getValue());//System.out.println(entry.getKey()+":"+entry.getValue());}//System.out.println("param:"+param.toString());out.write(param.toString());}// flush输出流的缓冲out.flush();// 定义BufferedReader输入流来读取URL的响应in = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"));String line;while((line = in.readLine()) != null) {result.append(line);}} catch(Exception e) {e.printStackTrace();}//使用finally块来关闭输出流、输入流finally{try{if(out!=null){out.close();}if(in!=null){in.close();}}catch(IOException ex){ex.printStackTrace();}}return result.toString();188 189190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 private static char[] base64EncodeChars = new char[] {'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H','I', 'J', 'K', 'L', 'M', 'N', 'O', 'P','Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X','Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f','g', 'h', 'i', 'j', 'k', 'l', 'm', 'n','o', 'p', 'q', 'r', 's', 't', 'u', 'v','w', 'x', 'y', 'z', '0', '1', '2', '3','4', '5', '6', '7', '8', '9', '+', '/'};public static String base64Encode(byte[] data) {StringBuffer sb = new StringBuffer();int len = data.length;int i = 0;int b1, b2, b3;while(i < len) {b1 = data[i++] & 0xff;if(i == len){sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[(b1 & 0x3) << 4]);sb.append("==");break;}b2 = data[i++] & 0xff;if(i == len){sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]);sb.append(base64EncodeChars[(b2 & 0x0f) << 2]);sb.append("=");break;}b3 = data[i++] & 0xff;sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]);sb.append(base64EncodeChars[((b2 & 0x0f) << 2) | ((b3 & 0xc0) >>> 6)]);sb.append(base64EncodeChars[b3 & 0x3f]);}return sb.toString();}。
菜鸟物流api接口对接标准
菜鸟物流api接口对接标准菜鸟物流是阿里巴巴集团旗下的一家专业物流服务提供商,致力于为电商行业提供全方位的物流解决方案。
菜鸟物流提供了一系列的API接口,方便企业与菜鸟物流进行系统对接,实现物流信息的及时同步和管理。
下面将详细介绍菜鸟物流API接口对接的标准。
1.确定对接需求:在进行API接口对接之前,首先需要确定对接的具体需求,包括物流信息的同步、订单的下发、运单的打印等功能。
2.申请接口权限:在菜鸟物流官网上申请API接口权限,获取对接所需的AppKey和AppSecret。
3.查询接口文档:下载菜鸟物流提供的API接口文档,了解各个接口的功能和调用方式。
4.选择合适的接口:根据对接需求选择合适的API接口,如物流信息查询接口、订单创建接口、运单打印接口等。
5.确定数据格式:确定接口请求和返回数据的格式,通常采用JSON格式进行数据交互。
6.进行接口调试:使用Postman等工具进行接口调试,验证接口的正确性和稳定性。
7.编写接口代码:根据接口文档编写对应的接口调用代码,实现与菜鸟物流系统的数据交互。
8.进行接口对接测试:在测试环境下进行接口对接测试,确保接口的功能正常。
9.与菜鸟物流对接人员沟通:在遇到问题时及时与菜鸟物流对接人员沟通,协助解决接口对接中的各种技术问题。
10.部署上线:完成接口对接测试后,将代码部署到生产环境上线,实现与菜鸟物流系统的正式对接。
11.完善接口监控:对接成功后,需要建立接口监控机制,及时发现和解决接口异常问题。
12.高可用性设计:在接口对接过程中,需要考虑接口的高可用性设计,保障接口的稳定性和可靠性。
13.数据加密传输:在进行数据传输时,需采用加密算法对数据进行加密,确保数据的安全性。
14.接口调用频率控制:合理控制接口的调用频率,防止接口被滥用导致系统崩溃。
15.接口权限验证:在接口调用时需要进行权限验证,确保只有授权的用户可以调用接口。
16.异常处理机制:对接口调用过程中可能出现的异常情况进行处理,保证系统的稳定性。
圆通快递电子面单接口对接说明全
圆通快递电子面单接口对接说明〔全〕.接口类型说明〕接口支持的消息接收方式:〕请求方法的编码格式():""〕地址:〕接口提供:快递鸟〕快递编码:.请求系统级参数备注:必填〔〕,可选〔〕,报文中该参数在一定条件下可选〔〕。
.接口参数〕请求内容字段定义〕返回参数定义. 例如〕请求例如{"": "","": "","": ,"": ,"": ,"": ,"": {"": "","": "","": "","": "上海","": "上海","": "青浦区","": "明珠路号"},"": {"": "","": "","": "","": "北京","": "北京","": "朝阳区","": "三里屯街道雅秀大厦" },"": [{"": "鞋子","": ,"":}],"": [{"": "","": ""}],"": ,"": ,"": ,"": "小心轻放",""}〕返回例如失败:{"": "","": "","": "订单号已存在,请勿重复操作","":""}成功:{"": "","": {"": "","": "","": "","": "京朝阳(京)","": "","": "上海分拨中心","": "北京"},"":"此处省略打印模板内容","":"","":"调用时传入的","": ,"": "","": "成功"}对接源码;;;;;;;;;;;;**** 和请到官网申请:*{电商"请申请";电商加密私钥,注意保管,不要泄漏"请申请";请求, 正式环境地址:"";*** 方式电子面单**() {"{'': '',""'':'',""'',""'',""'',""'':""{""'':'','':'','':'','':'上海','':'上海','':'青浦区','':'明珠路号'},""'':""{""'':'','':'','':'','':'北京','':'北京','':'朝阳区','':'三里屯街道雅秀大厦'},""'':""[{""'':'鞋子','',''}],""'',""'',""'',""'':'小心轻放',""''}";<, > <, >();("", (, ""));("", );("", "");(, , "");("", (, ""));("", "");(, );根据公司业务处理返回的信息......;}*** 加密* 内容* 编码方式**("")( , ) {("");(());[] ();();[] ;( < ) {("");}(());}()();}*** 编码* 内容* 编码方式**( , ) {(());;}("")( , ) {(, );;}*** 电商签名生成* 内容** 编码方式** 签名*("")( , , ) ,{( ){(( , ), );}((, ), );}*** 向指定发送方法的请求* 发送请求的* 请求的参数集合* 远程资源的响应结果*("")( , <, > ) {;;();{();() ();发送请求必须设置如下两行();();方法("");设置通用的请求属性("", "**");("", "");(""," (; ; )");("", "");();获取对象对应的输出流((), "");发送请求参数( ) {();(<, > : ()) {(()>){("");}(());("");(());(()":"());}(":"());(());}输出流的缓冲();定义输入流来读取的响应(((), ""));;(( ()) ) {();}} ( ) {();}使用块来关闭输出流、输入流{{(){();}(){();}}( ){();}}();}}对接源码<电商('') ('', '请申请');电商加密私钥,注意保管,不要泄漏('') ('', '请申请');请求,接口正式地址:('') ('', '');调用获取物流轨迹构造电子面单提交信息$ [];$[""] "";$[""] "";$[""] ;$[""] ;$ [];$[""] "李先生";$[""] "";$[""] "李先生";$[""] "深圳市";$[""] "福田区";$[""] "赛格广场";$ [];$[""] "李先生";$[""] "";$[""] "李先生";$[""] "深圳市";$[""] "福田区";$[""] "赛格广场";$ [];$[""] "其他";$ [];$[] $;$[""] $;$[""] $;$[""] $;调用电子面单$ ($, );$ ($)兼容〔含〕以下"电子面单接口提交内容:<>".$; $ ($);"<><>电子面单提交结果:<>".$;解析电子面单返回结果$ ($, );"<><>返回码:".$[""]; ($[""] "") {"<>是否成功:".$[""];}{"<>电子面单下单失败";}*** 方式查询订单物流轨迹*($){$ ('' > ,'' > '','' > ($) ,'' > '',);$[''] ($, );$(, $);根据公司业务处理返回的信息......$;}*** 提交数据* $ 请求* $ 提交的数据* 响应返回的*($, $) {$ ();($ $ > $) {$[] ('', $, $);}$ ('', $);$ ($);($['']''){$[''];}$[''];$ " " . $[''] . " \\";$ ":" . $[''] . "\\";$ "\\";$ ":" . ($) . "\\";$ "\\\\";$ $;$ ($[''], $['']);($, $);$ "";$ ;(($)) {(($ ($)) ($ "\\" $ "\")) {;}}(($)) {$ ($, );}($);$;}*** 电商签名生成* 内容** 签名*($, $) {((($.$)));}************************************************************** ** 使用特定对数组中所有元素做处理* $ 要处理的字符串* $ 要执行的函数* $ 是否也应用到上*************************************************************** ($, $, $ ){$ ;($ > ) {(' ');}($ $ > $) {(($)) {($[$], $, $);} {$[$] $($);}($ ($)) {$ $($);($ $) {$[$] $[$];($[$]);}}}$;}************************************************************** ** 将数组转换为字符串〔兼容中文〕* $ 要转换的数组* 转换得到的字符串*************************************************************** ($) {($, '', );$ ($);($);}>。
快递API物流轨迹查询接口接入表
方案说明 2、通过快递鸟电子面单接口直接打印对应快递公司电子面单,同时订阅单号信息。 3、快递鸟定时推送新的物流信息到用户系统。 适用对象 电商 ERP、仓储系统、清关公司、网站管理后台
快递鸟通讯录
商务对接联系人信息 姓名 QQ 手机 职务 邮箱 技术对接联系人信息
姓名
QQ 手机
职务 邮箱 产品对接联系人信息 姓名 QQ 手机 职务 邮箱
1、为什么有些邮政单号查不到物流信息? 答:首先,确认单号所属物流公司,并前往对应快递公司官网确认 单号可用。 然后,确认请求调用的对应物流编码正确无误。 如:邮政小包对应编码 YZPY,EMS 对应编码 EMS。 2、 快递公司那边已经签收了, 为什么快递鸟推送的内容还是派件中
接口问题
状态? 答:首先,确认接收接口是否可以正常访问。然后,确认接口是否 能承受压力,导致接收信息响应时间过长,影响推送的效率。 3、 快递公司那边已经更新了, 为什么即时查询接口的数据没更新? 答:首先,确认单号所属物流公司,确认快递鸟是否支持该物流公 司的物流信息查询。然后,确认调用参数格式。
透露。对于已被盗用的 Key,我们将会作禁用处理。
2、接口支持什么语言? 答:快递鸟接口适用于任何开发语言 3、有没有相关的 demo? 答:快递鸟提供 PHP、java、 语言 DEMO 工具,请前往 /ResourceDownload.aspx 下载 4、订阅推送可以指定多台接收服务器吗? 答:一个用户 ID 只能对应一台推送服务器,如需配置多台,可注册 多个 ID 并提交快递鸟研发人员进行资源配置
订阅频率:*个订阅线程,每秒并发**个请求,每个请求**个单号 联调方案 推送频率:*个推送线程,每秒并发**个请求,每个请求**个单号 推送类型:全量推送 调试结果 优化方案 下次联调时 间 第 2 次联调 联调时间 调试单量 执行人
常用快递API接口方案
params.put("EBusinessID", EBusinessID);
params.put("RequestType", "1001");
String dataSign=encrypt(requestData, AppKey, "UTF-8");
"'Volume':0.0," +
"'Remark':'小心轻放'," +
"'Commodity':" +
"[{" +
"'GoodsName':'鞋子'," +
"'Goodsquantity':1," +
"'GoodsWeight':1.0}]" +
"}";
Map<String, String> params = new HashMap<String, String>();
MessageDigest md = MessageDigest.getInstance("MD5");
md.update(str.getBytes(charset));
byte[] result = md.digest();
StringBuffer sb = new StringBuffer(32);
通途系统API对接物流设置
通途系统第三方对接物流设置
位置:基础设置——物流设置
第一步:打开第三方物流的下拉菜单,选中需要启用的第三方物流上,单击“启用”
第二步:启用后的物流商就会出现在左侧菜单的“第三方物流”下面,选中启用的物流商,编辑API对接信息(如token信息这样的需要找物流商拿),编辑好之后注意“保存“
第三步:在该物流商下启用所需要的邮寄方式,并打开编辑页面,编辑邮寄方式信息
第四步:进入“邮寄方式-编辑“,编辑基本信息
1、完善“同步发货状态时提交的信息“即Carrier信息,不是很清楚的朋友可以问物流商
2、勾选该邮寄方式是否需要退件
3、选择“打印方式“,是在通途内打印还是在通途外打印(通途系统内设有各种邮寄方式
的打印模板);若选择在通途内打印,勾选打印介质为”标签机“
4、选择该邮寄方式适用的仓库
5、填写寄件人信息,有的物流可以不用填写,物流商强制要求的必须填写
所有信息填写完整后,检查并单击“下一步“,进入下一个编辑页面
第五步:进入“失效及运费“编辑页面
1、在“按时效分类“处选择物流类型
2、设置该邮寄方式的“过期天数”
3、设置“运费折扣”及“运费币种”
4、设置“邮寄方式配送范围及收费模型”,注意“全球可达(相同运费)”、“全球可达(不
同运费)”以及“非全球可达”这三种方式的选择,注意最大限重、首重、续重等信息的填写
信息填写完整后,单击“保存并下一步”,进入选择“标签机模板”的页面
第六步:在“标签机模板”选择适用的打印模板,单击“启用”即可
最后单击“保存“,物流设置成功。
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
快递物流寄件下单api接口调用对接
为了让你对接更简单,我会分享源代码,把源码复制到你的项目上,就能快速完成电商售后退货快递寄件下单预约快递员上门取件接口对接,调用快递鸟提供的上门取件API标准接口,成功调用后,快递员会准时上门取件,同时支持快递单号物流轨迹查询,快递鸟物流单号查询api接口不区分开发语言,支持Java,C#,PHP,Python,ObjectC等开发语言的程序调用。
1 接口规范说明
1.1 接口规范及说明
1.1.1 报文及报文编码
报文格式:Json格式
请求方法的编码格式(utf-8):交互协议上统一用UTF-8,避免传递中文数据出现乱码。
1.1.2 接口数据包结构
图例- 数据包结构(系统级{数据})
1.1.3 JSON示例
1.1.4 系统级参数
*快递所有接口统一使用此系统级参数,根据不同的请求接口指令接入不同的接口。
1.1.5 流程示意图
1.1.6 名词定义
1.2 签名说明
1.2.1 关于签名
快递鸟和第三方电子商务公司系统进行对接,有一定的安全机制。
采用IP认证加签名的方式对接,具体方案如下:1. 防止数据被篡改
2. 注:
DataSign生成后,对方接收到数据后,以同样的算法进行签名(推送接口RequestType为101/102不需要进行URL编码),生成摘要,对比两者的摘要是否相同,如果不同,说明传递过程中发生数据篡改。
2.调用接口的身份认证
注册成为快递鸟用户后,会生成对应的用户ID和APIKey,用户ID相当于用户名,APIKey相当于密码。
举例:
1.假设
2.那么DataSign签名的内容为
3.接收方收到数据后,获得
EBusinessID 和RequestData和DataSign等这几个数据。
4.接收方对EBusinessID得到APIKey,RequestData+APIKey的数据进行
md5和base64后的内容就为
OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE=
5.接收方判断签名后的数据跟传递过来的DataSign是否一致,如果一致进行业务操作,如果不一致返回错误。
1.2.2 (C#)DataSign签名加密代码
1.3 接入步骤
1.快递鸟官网注册账号成为快递鸟用户;
快递鸟提供的用户ID是调用接口服务的身份证明,不可更改、不可转用,API Key是应用访问API的签名附加密钥,必须妥善保存。
两者关系类似于用户名和密码,两者都会在签名和业务参数中使用。
2.登陆用户后台,进行实名认证,并开通会员服务;
3.根据技术文档进行开发并在调试平台测试联调;
快递鸟提供各个API接口的DEMO(包括:.Net版本、Java版本、PHP版本)供开发参考。
4.系统发布上线。
注意:测试环境中获取的测试快递单号不可用于实际发货。
2 下单类接口
2.1 上门取件-下单
2.1.1 功能说明
1. 此接口用于通知快递公司快递员上门揽件。
2.1.2 基本信息
2.1.3 接口规则
1. 请求报文中不允许出现以下特殊字符:' " # & + < > % \
2. 预约时提供的收寄方信息必须真实准确。
3. 用户提供的寄件地址若超出快递公司服务范围,则无快递员上门揽件。
4. 因用户原因(如:恶意下单、批量下单长时间不发货等)导致快递公司投诉超过3次,快递鸟将停用此用户接口权限。
5. 预约时间段:9点-17点可预约当天上门,17点-次日9点前,预约次日上门全国(除特殊区域):当前时间:9点前可预约时间段:预约当天任意时间段上门当前时间:11点前可预约时间段:11点后预约当天任意时间段上门当前时间:13点前可预约时间段:13点后任意时间段上门当前时间:15点前可预约时间段:15点后任意时间段上门当前时间:17点前可预约时间段:17点-19点当前时间:17-次日9点前,预约次日任意时间段上门特殊区域:(西北6省(甘肃、青海、宁夏、陕西、新疆、西藏),东北三省(辽宁省、吉林省、黑龙江省),海南省)当前时间:11点前可预约时间段:19点前当前时间:11-17点前可预约时间段:19点前当前时间:17-次日9点前,预约次日19点前
2.1.4 应用场景
电商平台、打单工具、ERP系统、WEB端、APP移动端、小程序、集团统一结算运费
2.1.5 应用级参数
请求示例:
2.1.6 返回参数
2.2 上门取件-订单取消
2.2.1 功能说明
此接口用于取消“上门取件接口”下单成功的订单。
2.2.2 基本信息
2.2.3 接口规则
1. 只支持取消通过上门取件接口下单成功的订单;
2. 已揽件状态后不允许取消;提示“您的订单已揽件,不可取消订单”;
3. 距离预约开始剩余5分钟至预约结束时间加2小时不能取消订单,提示“您的订单在正常服务时间内,不可取消订单”;
4. 其它时间均可取消订单提示“您的订单已取消成功”。
2.2.4 应用级参数
请求示例:
2.2.5 返回参数
返回示例:
2.3 上门取件-订单状态推送
2.3.1 功能说明
接口逻辑说明:向快递公司预约后,由快递公司推送订单状态(包含成功和失败的状态及原因)给快递鸟,快递鸟字段转换后,再通过RequestType :103实时推送给客户;(注:订单状态数据在快递鸟后台保存
7天,推送失败时的重推机制:同轨迹推送接口);商家端:支持客户通过上门取件接口1801接口的预约指令;。