Free SF Express Tracking Number e-api interface, docking surface by courier birds [API]

SF Express query interface (API) and electronic side single interface to how butt?
In addition to its own interface by SF butt, but most is used by third-party docking courier birds, and track information inquiry by four SF single number and phone number, order number, if SF is obtained by the following list of courier birds, may direct access via a single number, the specific download Bird express interface technology interface specification document viewing. When ShipperCode to SF, courier and express a single number of non-return channels birds, mandatory, correspond to the recipient / sender's phone number four; ShipperCode to SF, and express a single number is courier birds return channels, do not fill.

First, before access preparation (TO merchant business people)

1. Application Express birds user ID and Key API
1.1 Login courier birds official website registration page http://www.kdniao.com/reg registered courier birds account;
1.2 Log courier birds user management background, go to "My Member Center 'real names certification;
1.3 authentication is successful, enter the "services management", the opening of membership services (packages can open a free test).

2, apply for SF Express account statement
signed under the SF monthly account local needs and SF branch line Collection and Delivery Contract, SF will provide 10 digits after the signing of the SF monthly account settlement for shipping freight;
Note: to get the monthly account does not need to express the official website of birds add background, directly through the interface can pass the value of orders;

3, purchasing printers, printing paper
3.1 printer:
electronic plane ticket template for printer brand, model, etc. not required, as long as the thermal printer can be, common brands such as: Zebra, effective, fast wheat, Han India, Jia Bo.
Express network printer may be provided or purchased on Taobao Jingdong, install the printer driver and the printer provider contact;
3.2 Paper:
Paper SF used are 100mm 150mm (tangent point 90/60), 100mm 180mm (tangent point 110 / 70), 100mm * 210mm (tangent point 90/60/60) three, the paper delivery outlets may be provided or purchased on Taobao Jingdong, select all white thermal paper purchase.

Second, the development of access (TO business technology developers)

1. Download the latest technical documentation and courier birds Raiders docking
technology QQ group / courier birds official website http://kdniao.com/documents download;

2, referring to the development of technical documentation
2.1 on the request content
to java as an example:

About 2.2 SF invoice account value transfer interfaces
MonthCode pass invoice account value SF (PayType when not fill 1,2, 3, 4 when required),
PayType traditional values of payment (comprising: pay 1-, 2- to pay, 3-monthly, 4 third-party payment),
customer number configuration page are staying in two fields (to be correct more than the corresponding two fields) filled out by the shipping business, business to develop their own systems are also proposed to retain the configuration page in case the account to replace it?

2.3 About express type
SF Express Type follows:
Alert Type ExpType pass value
SF fast subscript 1
SF 2 deals
electricity supplier deals 3
4 4
SF next morning 5
SF 6 now
electrically Match List 7
Medicine 11 normal
pharmaceutical thermostat 12
stream 13 P transported
cold transport home 14
fresh 15 match
crabs mail 16
Auto Ji Yun 17
heavy goods 18 Express
Mail train line 20
pharmaceutical special operation (room temperature) 21
pharmaceutical special operation (thermostat) 22
is electrically commercially designed with 28
immediate 220,034
material distribution 35
bill special delivery 36
licenses mail product 110
SF air with 112
line P op 125
night with 134
heavy goods package 154
small ticket LTL 155
pharmaceutical room temperature (LU) 195
SF minute member 202
pharmaceutical Express 203
land minute member 204
deals specifically with the 208
Note : SF merchant account statement can be made whether the corresponding type of delivery, advance and SF division personnel to confirm, in addition to 1,2,5,6, other types of delivery are required to re-sign the agreement individually.

About 2.4 SF value added services pass
insured
field by value: "AddService": [{ " Name": "INSURE", "Value": "1000"}]

Payment collection
field by value:
"the AddService": [{ "the Name": "of COD", "the Value": "1000", "the CustomerID": "1234567891"}]

Picture element
Quantity pass value equals 2 represents picture element, and returns a corresponding number of SubCount subunit, suborders sub numbers alone, SubPrintTemplates subunit html template;

Signed receipt
IsReturnSignBill need to sign back pass 1 represents a single, and will return the corresponding html SignBillPrintTemplate signed receipt template, the default is not required 0;
OperateRequire represents receipt operational requirements (such as: the signature or seal, etc. copy ××× );

Reservation courier door
IsNotice notification indicating whether the courier Onsite Lan pieces, 0 notice, 1 do not notice, the default is 1;
about the need for an appointment courier Onsite Lan pieces:
1, such as a mailing point is not fixed around the country, need courier onsite Lan pieces of the reservation (such cases be sure to make an appointment for user restrictions, you must make an appointment, an appointment only after successful verification by phone code, or will cause a malicious user appointment orders, leading to complaints SF);
2, If so fixed several locations shipments and require daily delivery, the next line may in consultation with the courier regularly targeted set of people onsite Lan pieces, do not need to make an appointment on the interface;
3, the case of a fixed place of shipment, only occasionally made a few votes, Print your own face a single one of the random appointment orders, such as the need to print the entire reservation courier (courier can print depends on whether the local SF express outlets);
Note: In case of malicious appointment, leading to the SF express complaints over the bird 3 times, the bird will express this interface to disable user permissions;

Subscribe to SMS notifications logistics nodes
logistics nodes contain message: Sent text messages, sending pieces of SMS, SMS sign, text messages and other pieces of the problem;
field by value: IsSendMessage 0- do not need, 1 need
SMS notification service for a fee, should contact business colleagues to buy members package before use or SMS packages.

3, the electronic ticket template surface pattern
SF template were 5 specifications, follows
the second joint 150 (the default template, TemplateSize transfer value is empty)

​

Triple 210 (TemplateSize pass value 210)

​

150 new Duplex (TemplateSize pass value 15001)

​

180 new Duplex (TemplateSize pass value 180)

​

Triple 210 (TemplateSize pass value 21001)

​
4、电子面单模板处理
用户可根据自身的实际情况及未来发展的需要来决定是否需要接口返回模板（参数：IsReturnPrintTemplate 0-不需要，1-需要），推荐平台/工具/ERP类用户自行开发设计，直接发货商家使用接口返回的模板，如有特殊需求可自行开发；
4.1 平台性/工具/ERP类用户
因其系统使用商家较多，同一模板无法满足所有商家需求，推荐根据商家需求自行设计面单模板。
优势：灵活性高，不受快递鸟模板变动的影响，商家体验更好
劣势：对用户技术能力有一定要求

4.2 直接发货商家
A、对模板无要求，快递鸟接口返回的模板已能满足的商家，可直接使用。
优势：接入成本低，方便易用，可使用快递鸟批量打印功能
劣势：灵活性不高
B、对模板有一定要求，快递鸟接口返回的模板无法完全满足的商家，可对返回的html模板报文进行处理，或自行设计面单模板样式。
优势：接入成本较低，方便快捷
劣势：对用户技术能力稍有要求

三、接口使用（TO商家系统操作人员）

使用过程中如遇到问题，先联系公司内部技术人员排查，如需快递鸟协助请让技术人员联系。
可能遇到的问题：
1、接口返回“校验码有误”是什么原因？
答：快递公司不支持的特殊字符：' " # & + % \ < >
请确认请求数据（包含收寄方姓名、电话、地址、商品名称等所有订单数据）中是否含有以上特殊字符；

2、电子面单下单返回结果false，错误码106，订单号已下单成功？
答：电子面单下单接口订单号OrderCode不能重复使用，重复使用会报错且返回的面单是此订单号上次下单的内容；

3、电子面单返回“暂无打印模板”是什么原因？
答：默认的模板TemplateSize无需传值，非默认模板传对应模板尺寸，不可传不存在的模板尺寸代码；

4、电子面单生成后可以取消吗？不发货的话单号会作废吗？
答：下单成功后如不需要发货，直接撕掉面单即可，不需要取消（如果一定要取消可对接”电子面单取消接口”），快递员揽件后才收费，单号不收费；

5、调用电子面单时，接口返回“不可派送”？
答：不可派送表示派件地址不在顺丰速运服务范围，具体收派范围可在顺丰速运官网查看http://www.sf-express.com/cn/sc/dynamic_function/range/...，可更换其他快递发货；

6、调用电子面单时，接口返回”您的预约超出今日营业时间，无法上门取件。”？
答：顺丰速运每个区域每个分部上门取件的服务时间不固定，建议更换时间预约，一般预约9：00—17：00内；

顺丰快递单号查询接口对接指南

目的

便于快递鸟用户理解快递单号查询接口作用并正确应用到实际场景。

接口作用

轨迹类接口包含：即时查询接口和物流跟踪接口。

即时查询接口：实时查询某个快递单号当前的物流状态；

物流跟踪接口：监控某个快递单号完整的物流状态。

应用场景

可应用于电商平台、自营商城、ERP、打单工具、楼宇/物业系统、云打印、微信小程序/公众号、APP、OA等需要查看物流信息的场景。

接口逻辑

说明：

快递鸟接口作为数据中转站，不对物流信息做处理，不做语言转换，只对数据字段做转换，分析物流状态；

快递鸟接口返回的物流轨迹信息按照发生时间的升序排列。

应用方法：

接口返回物流信息后直接展示

优势：方便简单

劣势：受网络影响，响应较慢，用户体验欠佳

接口返回物流信息后保存在本地数据库，当用户查询时调用本地数据再做展示

优势：本地调用响应快，不受网络影响，用户体验好

劣势：需本地保存

应用实例

类似微信扫一扫查快递，通过扫一扫功能扫描面单上的条码跟踪物流状态（需结合快递鸟单号识别接口使用）；——适用即时查询接口

前端展示单号轨迹框，由用户填写单号后查询对应物流信息（可结合快递鸟单号识别接口使用）；——适用即时查询接口

输入顺丰快递单号，显示可能属于的快递公司列表

选择顺丰快递公司后，展示详细的物流信息。

电商平台、自营商城等展示订单的物流信息，可监控平台商家是否按时发货；——适用物流跟踪接口

APP上展示订单流转路径；——适用物流跟踪接口

发送物流节点短信通知；——适用物流跟踪接口

数据报表；——适用物流跟踪接口

物流体验：分析每天快件状态，统计揽收率、签收率、问题件率等；——适用物流跟踪接口

退货险：平台根据快件流转的时间、揽件城市、签收城市等数据判断商家是否虚假退货；——适用物流跟踪接口

轨迹拼接：转动公司/平台，将海外订单的物流信息和国内清关后的物流信息拼接在一起，方便买家查询海淘订单；——适用物流跟踪接口

对接指南

1、登录快递鸟官网注册页面注册快递鸟账号

网址：快递单号查询接口_电子面单_APIKey授权申请-快递鸟账号注册

2、登录快递鸟用户管理后台

网址：用户登录_快递鸟API让物流接口对接更简单

注：登录快递鸟用户管理后台后获得用户ID和APIKey，此用于保证应用来源的可靠性，避免应用伪造，被不法使用。

3、进入“我的会员中心”进行实名认证

注：

3.1、认证类型、应用类型根据用户实际情况选择即可，接口返回数据与选择结果无关；

3.2、标记为*的为必填，要求上传清晰、jpg格式且小于2M的证件图片；

3.3、技术对接人信息为用户方对接工程师的信息；

3.4、如有其他疑问可进入官网加入商务合作群进行咨询。

4、认证成功后，进入“产品服务管理”，开通相关会员服务

注：

4.1 Logistics inquiry (free version) membership package for the free edition, after the expiration of one year, as there is data exchange system will be automatically renewed for free in the last 3 months;

4.2 For any other questions can be added into the official website of the Business Cooperation group for consultation.

5, the development of docking

5.1, real-time query (RequestType: 1002/8001)

5.1.1, you need real-name authentication prior request interface, subscribe to a membership service, otherwise it will fail the request and returns the prompt "did not subscribe to the interface";

5.1.2, available for download interface development, "courier birds Interface Technical Documentation" in reference; hoc queries, refer to section 4.1 or 5.1.1 technical documentation;

5.1.3, interface development can download the "Instant Lookup demo" were a reference (.NET only provides, Java, PHP three languages ​​demo);

5.1.4, see the corresponding express courier bird coding can download the "2019 Bird Express interface support Express coded list .xlsx".

5.1.5, access procedure in case of doubt, please refer to the official website of the courier birds to resolve common problems ( http://www.kdniao.com/help), can also be added into the official website of the courier birds docking technology consulting group .

Note: Express birds official website - help with the document address (express logistics api interface documentation download _ electronic side single interface documentation - Express birds code interface documentation)

Express birds API interface DEMO Download: Express birds "DEMO immediate inquiry" to make docking easier