1 前言

快递鸟API旨在为电商、电商平台、物流工具、打单工具、仓储系统、移动APP等系统提供专业、稳定、优质的API 接口服务，满足不同用户的物流管理需求。

本文档就各个API接口使用常见问题提供解答，方便用户快速对接及使用快递鸟服务。

2 快递鸟接口

2.1常见疑问TOP1

问题：顺丰单号调用轨迹查询接口，返回“此单无物流信息”是什么原因?

1、通过快递鸟渠道下单返回顺丰单号，需ShipperCode快递公司编码+ LogisticCode快递单号查询，但签收后7天，顺丰不再返回物流信息，因此签收7天后，无法查询;

2、非快递鸟渠道下单返回的顺丰单号，需ShipperCode快递公司编码+LogisticCode快递单号+CustomerName手机号查询，CustomerName传值收件人或寄件人手机号后四位数字。请求报文格式{'LogisticCode':'233823364856','ShipperCode':'SF','CustomerName':'1234'};

3、顺丰单号若第一种查询方式无法满足业务使用，可直接采取第二种查询方式。

 

问题：京东快递调用轨迹查询接口，返回“无效的输入[CustomerName不能为空]”是什么原因?

1、京东快递轨迹查询接口已升级，查询时，必须在CustomerName字段传商家编码(由发货方提供)，且快递单号必须是通过该商家编码下单获取的方可查询;

2、商家编码，也叫青龙配送编码，格式：数字+字母+数字，9位数字加一个字母，共10位，举例：001K123450，发货方需要联系当地京东站点获取;

3、请求报文格式为：{'LogisticCode':'JDVC12345644444','ShipperCode':'JD','CustomerName':'001K123450'}.

 

问题：电子面单接口下单返回“缺少电子面单账号”如何处理?电子面单账号怎么申请?

一、测试环境下单可以使用快递鸟提供的测试账号，请查看官网(http://www.kdniao.com/documents)下载电子面单客户号参数对照表查看;

二、正式环境下，顺丰速运(SF)，EMS(广东省内发全国)，宅急送(ZJS)，邮政快递包裹(YZPY)、邮政国内标快(YZBK)、联昊通速递(LHT)、全一快递(UAPEX)不需要申请账号，可直接下单;

三、优速快递(UC)、韵达速递(YD)、圆通速递(YTO)、远成快运(YCWL)、安能快递(ANE)、百世快递(HTKY)、中通快递(ZTO)7家快递公司可在快递鸟官网上在线申请申请路径：登录快递鸟官网后台—电子面单—我的物流服务商—申请新的物流服务商。(说明：用户在快递鸟后台申请成功后快递鸟会直接把信息提交给快递公司总部，一般先是快递公司总部审核，审核通过之后会下发到您当地网点，然后网点最后进行审核。其间历时一般2-3个工作日，如果在这个时间内没有审核完成，建议您联系下您网点进行快速审核);

四、其他快递公司电子面单账号需要线下联系快递网点申请。(第三点中可通过快递鸟后台申请账号的快递公司用户也可以线下直接到网点申请账号)

五、若网点不清楚如何审核快递鸟后台申请的账号、不清楚如何线下直接开通电子面单账号，您可以在快递鸟官网加技术对接群进入群文件下载《快递鸟各快递公司申请电子面单账号方法》给到网点参考，若网点仍无法处理可联系快递公司总部协助。

 

2.2通用类

问题：你们有哪些接口?

快递鸟目前提供：查询类接口(即时查询、物流跟踪、单号识别)、下单类接口(电子面单、订单取消、预约取件、单号余量查询)、增值类接口(在途监控、隐私快递、智选物流、代收货款 、短信服务)等接口 。

日查询次数<=3000次对接即时查询接口，日查询次数>3000次对接物流跟踪接口。网站上标记为免费的接口永久免费使用(http://kdniao.com/api-all)。

 

问题：接口怎么对接?

1、注册账号http://www.kdniao.com/reg;

2、登录用户后台，实名认证，开通相应会员服务;

3、技术对接(在线开发文档：http://www.kdniao.com/documents);

4、发布上线。

 

问题： EBusinessID跟APIKey是什么在哪里获取?

EBusinessID跟APIKey您在快递鸟网站注册之后快递鸟分配的密钥(对应官网上的用户ID和API key)，用于保证应用来源的可靠性，避免应用伪造，被不法使用，可以注册登录快递鸟后台获取。

 

问题：快递鸟接口有并发要求吗?

即时查询接口：并发不超过10次/秒

物流跟踪订阅接口：并发不超过30次/秒

电子面单接口：并发不超过20次/秒

 

问题：请求接口返回“EBusinessID不能为空”“EBusinessID字段非法”“EBusinessID必须为数字”“非法参数[【DataSign参数不合法】”?

正式和沙箱的用户ID不可以混用，否自会报错。

此处的用户ID和API key只可用于沙箱请求地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json

此处的用户ID和API Key 可用于正式请求地址和demo中自带地址。

 

问题：调用接口返回“未申请开通接口”“当前无可用套餐”是为什么?

您好，调用快递鸟接口前需要先注册登录快递鸟后台实名认证，然后在产品管理服务中(http://www.kdniao.com/UserCenter/v2/Memberships.aspx)开通相关会员服务才可使用。

 

问题：调用接口返回“无可用套餐”是为什么?

1、即时查询接口(RequestType：1002)每日查询量有3000次的限制，超过3000次后无法请求，请求返回“无可用套餐”,次日可以正常请求。

2、订购会员服务到期后无法请求接口，请求返回“无可用套餐”，需要重新订购。

 

问题：使用你们接口要签协议吗?

您好，接口注册及申请页面(http://kdniao.com/reg)有电子协议，如有其他需求，可以签订接口合作协议，详细可联系快递鸟市场商务人员。

 

问题：使用接口前一定要先实名认证吗?

不认证可以申请开通免费接口，但是无法进行对接。请注册后前往：http://www.kdniao.com/UserCenter/Verified.aspx完成实名制认证。

 

问题：你们支持的快递公司有哪些?快递公司编码列表可以发一份吗?

支持的快递编码下载链接：http://www.kdniao.com/documents

《2019快递鸟接口支持快递公司编码.xlsx 》

 

问题：对接快递鸟接口是否需要授权?

只需要申请账号获得ID和KEY即可对接。

 

问题：快递鸟和快递100的免费接口有哪些区别?

快递100免费接口的有限制：

1、每天最多2000次，不能频繁请求;

2、不支持EMS、顺丰、圆通、申通、中通和韵达几家;

3、要添加友情链接(必需)。

快递鸟免费接口：

1、即时查询接口每日调用次数最多3000次，物流跟踪接口不限量;

2、支持圆通、中通、韵达、EMS等常用快递公司;

3、不需要添加友情链接。

 

问题：你们接口或服务器升级会不会造成接口不可用情况?

不会，服务器集群，入口负载均衡，更新时采用灰度发布策略。

 

问题：数据更新实时性如何?

即时查询接口：实时获取当前最新轨迹信息，数据与官网信息一致。

物流跟踪接口：快递鸟普通用户一般推送时效为2-12小时，在此范围内没有接收到推送，请耐心等待一下。

 

问题：数据准确性，会不会存在物流状态不准确的问题?

轨迹信息准确度大于99.9%。物流轨迹信息保持与快递公司官网一致，偶尔存在快递公司提供的接口数据与官网不一致的情况，不一致情况小于0.1%。

 

问题：快递鸟的开发语言是asp.net?

快递鸟支持但不限于asp.net，在不跨域的情况下我们支持所有的开发语言。

 

问题：百世汇通，百世物流，百世快递，这个百世快递是另一家，还是这两家中的一个啊?

百世汇通目前更名为百世快递和百世快运，前者是快递，后者是物流。

百世快递在快递鸟对应的编码为：HTKY，百世物流在快递鸟对应的编码为：BTWL。

 

2.3即时查询

问题：即时查询怎么对接?

1、注册账号http://www.kdniao.com/reg;

2、登录用户后台，实名认证，开通相应会员服务;

3、技术对接(在线开发文档：http://www.kdniao.com/documents);

4、发布上线。

问题：即时查询超过3000会怎么提醒?

即时查询超3000次提醒：

{

"EBusinessID": "127****",

"Success": false,

"Reason": "业务错误[没有可用套餐]"

}

您可以登录用户后台查看当天使用量：

(http://www.kdniao.com/UserCenter/v2/Public/ProductDashboard.aspx?guid=6d25d765-c978-40d5-a63c-0f5e7835336b)。

 

问题：日查询次数超过3000次怎么办?

每日调用超过3000次以后，请对接免费接口：物流跟踪(http://www.kdniao.com/api-follow)，物流跟踪接口无次数限制;或者订购包含在途监控接口在内的套餐服务，功能同即时查询且支持更多物流状态，查询单量无限制。

 

问题：快递鸟有通过单号查询收寄方信息的接口吗?

您好，快递鸟目前没有此功能的接口，您可以在快递鸟官网(http://www.kdniao.com)了解下快递鸟所有接口。

 

问题：快递鸟有查询运费的接口吗?

您好，快递鸟目前没有此功能的接口，您可以在快递鸟官网(http://www.kdniao.com)了解下快递鸟所有接口。

 

问题：即时查询接口和物流跟踪接口有什么区别?

1、实现的原理不一样：

即时查询接口，根据快递编码和快递单号，实时请求查询物流轨迹信息。

物流跟踪接口，根据快递编码和快递单号，订阅推送模式，获取轨迹信息。

2、实现的方式不一样：

即时查询接口，每一次轨迹更新，需要主动查询。

物流跟踪接口，订阅推送模式，先发起订阅，并提供回调地址快递鸟配置，订阅一次后，快递鸟会持续往回调地址推送更新的轨迹信息，直到签收。

3、查询单量不一样：

根据购买不同套餐可用单量不同。

 

问题：即时查询接口、物流跟踪接口、在途监控接口，这三个接口有什么区别?

1、即时查询、物流跟踪、在途监控，都是轨迹查询类接口;

2、免费用户，调用的轨迹查询接口为：即时查询接口、物流跟踪接口;

3、收费用户，调用的轨迹查询接口为：在途监控接口。

问题：快递鸟有没有能【一个请求完成多个运单的物流信息查询】的即时查询接口?

即时查询接口不支持批量交易，需分批次多次调用接口，支持10次/S的并发请求。

 

问题：想问一下，关于即时查询接口的。物流轨迹，从接口返回的数据是不是已经按时间来降序排列的了?

快递鸟已对轨迹数据格式化处理，按时间的升序排序，用户如需降序显示需自行处理。

 

问题：即时查询接口返回“暂无轨迹信息”是什么原因?

1、确认您的单号是哪家快递公司的，若您的单号是顺丰、申通、百世、天天的单号，请回到顶部 查看常见疑问TOP1;

2、确认您的快递公司编码和快递公司单号是否传值匹配正确;

3、确认您的单号在快递公司官网是否已经存在物流信息，快递鸟物流轨迹与快递公司官网同步;

4、确认您单号所属的快递公司是否属于快递鸟支持范围内，请在快递鸟官网(http://www.kdniao.com/documents)下载《快递鸟支持快递公司编码列表》进行确认;

排除1、2、3、4两种可能后，请联系快递鸟技术支持进行确认。

2.4物流跟踪

 

问题：怎么对接物流跟踪接口?

物流跟踪接入流程：

1、注册账号http://kdniao.com/reg;

2、登录用户后台，实名认证，开通相应会员服务;

3、技术对接(在线开发技术文档：http://kdniao.com/documents);

3.1、开发订阅接口(可下载订阅demo进行参考http://kdniao.com/documents)

3.2、开发推送接口(无demo提供，需要自行开发，开发思路见下一个问题)

4、沙箱调试平台测试推送接口并且配置回调地址，测试通过调用成功之后才能成功配置回调地址;

5、发布上线(使用正式地址订阅真实单号，快递鸟后台在推送时效内推送真实的物流轨迹至已配置好的回调地址上)。

 

问题：物流跟踪是需要我们自己开发接收接口是吗?

对接物流跟踪接口，你需要开发订阅接口(将单号和快递公司编码订阅给快递鸟。http://www.kdniao.com/documents-demo有订阅接口的.net,php和java版本demo，你可以参考下，还有自己开发一个推送接口(接收快递鸟推送的物流轨迹)，开发完后登录调试平台调试推送接口，调试成功后可在调试平台自助配置推送接口。

 

问题：物流跟踪的推送接口怎么做?

推送接口是用于接收我们推送的物流信息的，推送接口是我们调用你的接口，你只需要接收参数，在调试平台配置你的回调地址就行，RequestData中包含应用级参数，即物流轨迹，推送时会推送requestType、requestData和DataSign三个参数(详情看技术文档)，您开发一个推送接口接收这三个参数即可。

 

问题：快递鸟的物流跟踪API实现原理是什么?

订阅接口的工作原理是：用户将快递单号订阅给我们，我们即刻加入队列去物流公司官方接口查询，查询有轨迹就给用户推送。如果没有更新数据，两个小时后会再次去物流公司官方接口查询，有新数据就将全量数据推送给用户，如果没有更新数据，两个小时后再重复上述动作，直到运单签收。

 

问题：快递鸟主动推送时，物流信息接收接口由用户提供。物流信息接收接口有什么要求啊?

我们要求用户提供的推送接口是能直接接收推送信息的，不需要进行登录等操作。

推送接口要在5S内对快递鸟请求做出响应，返回所需的推送返回参数。需要推送接口在接收到数据后，储存并马上返回响应。如果客户对数据进行处理，再做出响应。会造成网络超时，传输效率低下。返回数据的格式统一使用JSON格式：

{

"EBusinessID": "1237100",

"UpdateTime": "2017-03-11 16:26:11",

"Success": true,

"Reason": ""

}

 

问题：推送过来的数据处理失败并返回失败结果，快递鸟会重新推送吗 ?

在没有返回信息或者返回不符合规定的情况下，会判断为推送失败。推送失败后会重试推送2次，首次间隔15分钟，二次间隔30分钟，两次都失败就不会再推送，直到下次有轨迹更新才会再次推送。建议您严格按照技术文档进行返回

 

问题：一次推送回来的订阅订单数量最多有多少和订阅的数量相同吗 ?

单次推送1-10单。

 

问题：可以帮我修改一下推送的地址嘛?

用户可登录快递鸟官网，在沙箱调试平台上将推送接口调通，然后自助配置推送接口。

(配置地址: http://www.kdniao.com/UserCenter/v2/SandBox/PushQueryParam.aspx)

 

问题：同一个物流单号可以订阅多次吗?

正常情况下，同一个单号多次订阅，系统不会进行多次推送。

 

问题：订阅了单号后未接收到推送信息?

1、请您先确认用户订阅的地址是否为(http://api.kdniao.com/api/dist)，只有在正式环境下进行订阅才会有推送。

2、确认您的快递公司编码和快递公司单号是否传值匹配正确;

3、确认您的单号在快递公司官网是否已经存在物流信息，快递鸟物流轨迹与快递公司官网同步;

4、确认您单号所属的快递公司是否属于快递鸟支持范围内，请在快递鸟官网(http://www.kdniao.com/documents)下载《快递鸟支持快递公司编码列表》进行确认;

5、快递鸟普通用户一般推送时效为2-12小时，在此范围内没有接收到推送，请耐心等待一下。

排除以上可能后，请联系快递鸟技术支持进行确认。

 

问题：传了OrderCode字段，推送为什么没有推送;CallBack回调参数怎么用?

OrderCode是保留字段，不会直接返回，CallBack字段是放您希望回传的参数值。您订阅时在CallBack字段中传入OrderCode的值，会在推送时的CallBack字段回传。

 

问题：物流跟踪服务器IP是固定的吗?

快递鸟推送服务器IP组：

120.78.151.70

112.74.35.160

203.195.139.247

193.112.206.22

111.230.92.50

193.112.211.113

2.5电子面单

 

问题：怎么对接电子面单接口?

电子面单接入流程：

1、注册账号http://kdniao.com/reg;

2、登录用户后台，实名认证，开通相应会员服务;

3、技术对接(在线开发文档：http://kdniao.com/documents);

4、发布上线。

 

问题：我将电子面单账户通过接口传给你们，安全性有保障吗?

电子面单账号是不做存储的，直接传给快递公司系统，并且我们和快递公司的系统对接都有签约，有保密条款，电子面单提交的信息由于三方(客户、快递鸟、物流公司)故障排查需要，仅暂存数日，技术上也做了安全保障措施，可通过https通信保障安全，目前与邮政、联通等合作推出隐私实名发件，会最大程度保障信息安全。

 

问题：电子面单下单接口账号密码如何获取?

1. 测试环境下可以使用快递鸟提供的测试账号，请查看官网(http://kdniao.com/documents)电子面单客户号参数对照表;

2. 正式环境下，顺丰速运(SF)，EMS(广东省内发全国)，宅急送(ZJS)，邮政快递包裹(YZPY)、邮政国内标快(YZBK)、联昊通、全一快递(UAPEX)不需要申请账号，可直接下单;

3. 优速快递(UC)、韵达速递(YD)、圆通速递(YTO)、远成快运(YCWL)、安能快递(ANE)、百世快递(HTKY)、中通快递(ZTO)等7家快递公司可在快递鸟官网上在线申请(申请路径：快递鸟官网—电子面单—我的快递公司—申请新的快递公司);

4. 其他快递公司电子面单账号需要线下联系快递网点申请。

 

问题：在快递鸟官网申请电子面单账号之后一直在审核中，什么时候能审核完?

用户在快递鸟后台申请成功后快递鸟会直接把信息提交给快递公司总部，先是快递公司总部审核，审核通过之后会下发到您当地网点，然后网点最后进行审核。其间历时一般2-3个工作日，如果在这个时间内没有审核完成，建议您联系下您网点进行快速审核。

 

问题：在快递公司申请到了电子面单账号，怎么添加到快递鸟?

快递鸟用户对接了电子面单接口后，申请新的快递公司无需在快递鸟后台添加，直接请求接口即可。次数显示的是用户调用过的快递公司列表，不是先添加再请求。

 

问题：在快递鸟官网申请电子面单账号审核通过了，在哪里看我电子面单账号信息?

审核通过后，快递鸟会通过短信的方式发送账号信息给用户申请时提供的手机号码，请注意查收!

 

问题：电子面单的纸张尺寸大小是不是都是一样的?有哪几种常用尺寸?

每家快递公司的尺寸不一定是一样的，具体您可以下载技术文档查看每家快递公司对应的尺寸。

 

问题：对于打印设备有什么要求吗?有没有推荐的设备?

电子面单需要使用热敏打印机和热敏打印纸进行面单打印。我们这边测试使用的打印机是斑马Gk888t打印机，您可以参考一下。

 

问题：电子面单接口返回的数据需要用什么渲染打印?

电子面单接口调用成功后接口会直接返回HTML电子面单模板，可以直接使用浏览器打印，或者使用HTML控件进行打印。

 

问题：电子面单上数量、备注字段有赋值但是面单上没显示?

您需要在取回模板后自己进行处理，对相应字段进行赋值。

 

问题：电子面单接口返回“校验码有误”、个别下单返回“非法参数[DataSign[MzY4MzEzYTg1OGI5Yzc0MjdjNDYxMmRjYzI3ZGIzZWE=]不合法”

快递公司不支持的特殊字符：' " # & + % \ < > 请确认请求报文中是否含有特殊字符。

 

问题：电子面单接口测试环境顺丰、韵达的可以测通，像申通、安能、宅急送等测试报错是什么原因?

测试环境是由快递公司维护，经常调整会不稳定甚至不可用，正式环境可以正常使用。测试环境是提供给用户调通接口的，所有快递公司的逻辑一样，只要一家调通接口就没有问题了，测试的话您试下顺丰、韵达就好哈

 

问题：电子面单下单返回结果false,错误码106，订单号已下单成功，但是也返回了面单是怎么回事?

电子面单下单接口订单号OrderCode不能重复使用，重复使用会报错且返回的面单是此订单号上次下单的内容。

 

问题：请求接口返回：值不能为 null。参数名: RequestType?

传值方式错误，只有requestData是使用json格式的。其他系统级参数用&拼接。

 

问题:“请求的数据格式不正确””RequestData格式有问题”怎么解决?

1、注意商品信息字段属于数组格式，注意传参。

2、请求的数据是json的格式，您可以进行json在线解析看下具体的格式错在哪

(解析可参考网址：https://www.json.cn)

3、您可登录沙箱调试平台-调试示例(http://kdniao.com/UserCenter/v2/SandBox/Index.aspx)调试对应接口查看正确的请求报文，跟您的请求报文进行对比。

 

问题：电子面单接口如何实现批量打印?

电子面单接口不支持批量交易，可分批次多次调用接口。要实现批量打印效果可使用打印控件。网上这类控件挺多的，其中使用比较广泛用户体验度比较好的有lodop打印控件，您可以了解一下。另外快递鸟有提供批量打印组件和调用demo,您可以下载使用(http://www.kdniao.com/product-eorder-specific)。

 

问题：电子面单批量打印功能报“数据验证不通过”是什么原因?

批量打印dmeo中GetIp()获取到的IP是否和外网IP(连接打印机那台电脑的外网ip，可通过百度搜索ip38查看)一致，若不一致您可以改写demo中GetIp()的方法，直至一致为止。

 

问题：电子面单批量打印功能报“C-lodop没准备好”是什么原因?

核实是否安装启动了快递鸟提供的lodop控件，控件下载地址：http://www.kdniao.com/documents-instrument

 

问题：电子面单批量打印功能报“暂无打印模板”是什么原因?

批量打印中的字段Ordercode的值一定要和电子面单接口正式环境下单的Ordercode一致，不支持测试的订单号打印。

 

问题：电子面单批量打印功能报“打印明细不能为空”是什么原因?

快递鸟没有接收到用户传的RequestData，需要用户自行排查。

 

问题：电子面单批量打印功能已经有模板了，但是没有调起控件和打印机打印是为什么?

1、批量打印中的字段PortName(打印机名称)传值有误。

2、核实是否安装启动了快递鸟提供的lodop控件，控件下载地址：http://www.kdniao.com/documents-instrument

3、核实打印机是否连接并设置为默认打印机。

 

问题：电子面单接口下单返回”单号不足”“余量不足”“没有可用单号”“没有库存”是什么意思?

申请电子面单账号是一般是有预存的单号，当单号不足时需要联系网点进行充值。

 

问题：返回IP未授权是什么错?

1、看是否到网点申请账号，确认账号是否正确;

2、确认单号是否充足，不足则联系网点进行充值。

 

问题：电子面单返回“暂无打印模板”是什么错?

默认的模板尺寸无需传TemplateSize值，非默认模板传对应模板尺寸，具体的模板尺寸下载《快递鸟接口技术文档》进行查看。

 

问题：电子面单返回“RequestData格式有误”“未知异常”怎们解决?

请详细查看快递鸟接口技术文档，文档中有数组形式的参数需要谨慎，以及sting类型的参数需要注意引号的使用。

 

问题：申通电子面单下单报错“客户密码不正确!”怎么解决?

联系网点确认拿到正确的客户简称、客户密码和所属网点，分别在CustomerName、CustomerPwd、SendSite字段请求， 网点系统中对应的值如下图。若网点不清楚如何操作，可在快递鸟官网加技术对接群进入群文件下载《快递鸟各快递公司申请电子面单账号方法》给到网点参考开通，若网点仍无法处理可联系快递公司总部协助。

每家快递公司对应的账号信息传值的字段不同，具体字段可在官网(http://www.kdniao.com/documents)下载《电子面单客户号参数对照表》进行查看。

问题：电子面单接口下单返回“203填写的快递公司电子面单账号密码有误，请核实确认"是什么原因?

是电子面单账户异常，例如中通，如果是通过快递鸟后台申请的中通客户号，核实收到的短信内容，将正确的客户号通过接口字段传给快递鸟;如果是线下通过网点申请的需要联系网点确认拿到正确的商家ID和商家接口密码，若网点不清楚如何操作，您可以在快递鸟官网加技术对接群进入群文件下载《快递鸟各快递公司申请电子面单账号方法》给到网点参考开通，若网点仍无法处理可联系快递公司总部协助。

 

问题：电子面单下单返回“数据验证签名失败”是什么意思?

1、通常情况下是特殊字符影响，确认请求报文中是否存在特殊字符：' " # & + % < >， \ 有则去掉后重试。

2、不存在特殊字符的情况下，联系网点确认电子面单账号是否正确。

 

问题：韵达电子面单接口下单返回“错误：合作方ID不存在”或者"错误：签名不正确”是什么意思?

韵达下单报这个错，是电子面单账户异常，需要联系网点拿到正确的客户ID和接口联调密码。

联系网点拿到正确的账号和接口联调密码，若网点不清楚如何操作，您可以在快递鸟官网加技术对接群进入群文件下载《快递鸟各快递公司申请电子面单账号方法》给到网点参考开通，若网点仍无法处理可联系快递公司总部协助。

账号正确样式如：

问题：圆通电子面单接口下单返“请将和网点申请的密钥串填在MonthCode字段”;“该客户没有生成秘钥,请联系负责网点生成秘钥后重试!”;“203填写的快递公司电子面单账号密码有误，请核实确认”是什么意思?

联系网点拿到正确的商家代码和密钥串分别传在CustomerName字段和MonthCode字段，若网点不清楚如何操作，您可以在快递鸟官网加技术对接群进入群文件下载《快递鸟各快递公司申请电子面单账号方法》给到网点参考开通，若网点仍无法处理可联系快递公司总部协助。网点系统中对应账号如图：

问题：电子面单下单返回“登录验证失败!”怎么回事?

天天快递下单报这个错，是电子面单账户异常，需要联系网点拿到正确的客户账号和客户密码。正确样式如下：CustomerName、SendSite为中文。

问题：电子面单生成后可以取消吗?不发货的话单号会作废吗?

快递鸟目前支持韵达速递、百世快递、顺丰速运、优速单号取消，快递公司持续增加中。

快递公司有单号回收机制，未使用的单号会自动回收。所以用户下单后不寄送的话，单号会撤销的，具体回收规则请与快递公司网点确认。

 

问题：哪些快递公司支持子母件(一票多件)下单?需要怎么传值?

1、目前顺丰速运、优速快递、跨越速运、德邦快递、京东快递、速尔快递支持子母件下单;

2、传值时Quantity字段传包裹数大于1即表示子母件，例如：Quantity值为3。

 

问题：韵达电子面单接口无法返回集包地、下单报错【反序列化】?

是您的电子面单账号配置有问题，用户如果首次申请账号时候没有选择订单来源：快递鸟， 下单不会返回集包地，网点无法直接重新配置，只能联系快递公司总部去修改，快递公司总部联系电话：4008209669转1转2，改成明文即可。

 

问题：京东电子面单接口返回“缺少京东平台订单【ThrOrderCode】”?

当为京东平台订单时，需在请求参数ThrOrderCode中填入京东订单号，您需要咨询京东的工作人员才可以申请到。

 

问题：京东电子面单接口返回“进入人工预分拣，请稍后”是什么意思?

说明京东正在判断是否能送到，15分钟后重新请求，若仍然失败需要换别的快递公司或者更换地址。

 

问题：京东电子面单接口返回“订单超区”是什么意思?

说明地址不送达建议您更换地址或者更换快递公司进行发货。

 

问题：电子面单接口下京东的单返回返回"Reason": "商家编码与JOSPIN 不匹配"是什么原因?

是京东系统开启了商家编码校验功能，导致商家编码报错返回，直接联系京

东站点，维护工作人员，配置商家编码即可。

 

问题：快递鸟电子面单接口支持重复打印面单吗?需要如何操作?

支持的，所有订单信息不变，原订单号重新下单即会返回第一次下单的响应结果，且单号不变。

 

问题：电子面单打印字体不清楚怎么办?

快递鸟推荐您使用如下几种解决方案：

电源线电压不稳定，会导致打印模糊，如有其他电源线可更换试试;

更换一卷打印纸;

调高打印机浓度;

重新安装打印机驱动程序(不要百度，建议咨询商家索要);

擦下打印头;

检查浏览器打印参数的配置，建议使用IE、火狐浏览器。配置如下：

问题：电子面单打印超页、边框不齐、打印缩小怎么解决?

这是您打印机或者和浏览器配置的问题，需要您研究熟悉打印机和浏览器配置，每种打印机和浏览器配置方式不同，可参考一下以下配置：

1、打印机(例如：斑马Gk888t)设置：

2、浏览器设置：

火狐

IE：

问题：电子面单代收货款、保价等增值服务如何传值?

技术文档有对增值字段进行详细描述，可下载技术文档进行参考，相关字段如下：

传值如下：

"AddService": [

{

"Name": " INSURE ",

"Value": "1000"

},

{

"Name": "COD",

"Value": "1020"

}

],

问题：快递鸟支持签回单业务吗?

目前快递鸟只支持顺丰。德邦签回单业务，具体传值可以参考快递鸟接口技术文档，相关字段如下：

2.6单号识别

问题：识别出多个快递公司的原因?

如果同一个单号符合多个快递公司的单号规则，在这种情况下返回的快递公司不是唯一的。

 

问题：识别错误快递公司的原因?

识别不到或识别错误的单号，需要将这个单号进行订阅，获取到轨迹后，单号识别接口学习机制会完善这类单号的识别。

 

问题：识别不到快递公司的原因?

每一类的快递单号都有单号规则，不同的快递公司单号规则不同，单号识别接口是基于大数据的处理识别单号，比如新类型的单号出来，没有使用，会识别不了，所以需要咱们加入到新的识别规则中去，您这边有疑问的单号提供给技术支持这边帮您核实处理。

2.7预约取件

 

问题：取件接口可以返回单号吗?

目前预约取件接口中只有顺丰会返回快递单号，其他快递公司需要快递员上门后提供。如需打单发货，可以考虑对接快递鸟电子面单接口，每家快递公司均会返回单号。

 

问题：预约取件和电子面单接口的区别?

预约取件接口只是请快递员上门取件，不会返回面单模板信息。

电子面单接口包含预约取件的功能，并且可以返回快递单号和快递模板，用户可以直接打印模板进行发货。