《常用快递API使用说明》由会员分享，可在线阅读，更多相关《常用快递API使用说明（31页珍藏版）》请在金锄头文库上搜索。
1、常用快递 API 使用说明电商企业从接收订单-配货- 打印快递单到后期的快递员收件-快递配送-轨迹查询- 签收短信通知等，都需要快递接口的接入。整理目前较为常见的接口 demo 如下：对接流程：快递鸟网站申请接口对接联调测试上线1.预约取件-在线预约寄件接口规则请求报文中不允许出现以下特殊字符： # & + 快件揽收后不允许再预约。预约时提供的收寄方信息必须真实准确。用户提供的寄件地址若超出快递公司收派范围，则无快递员上门揽件。因用户原因导致快递公司投诉超过 3 次，将停用此用户接口权限。支持情况支持预约取件的快递公司：顺丰、中通、百世、圆通、优速、龙邦、韵达、快捷、天天、全峰、EMS 、安能
2、。应用场景电商平台、打单工具、ERP 系统、WEB 端、APP 移动端应用级参数名称 类型(字符长度) 是否必须 描述WarehouseID String(50) O 仓库标识(备用字段)WarehouseAddress String(50) O 仓库地址(备用字段)CallBack String(50) O 用户自定义回调信息MemberID String(50) O 会员标识(备用字段)ShipperCode String(20) R 快递公司编码LogisticCode String(30) O 快递单号OrderCode String(30) R 订单编号(自定义，不可重复 )PayT
3、ype Int(1) R运费支付方式:1-现付，2- 到付，3- 月结，4- 第三方付MonthCode String(20) C 月结编号ExpType Int(2) R 快递类型：1-标准快件Cost Double(5) O 快递运费OtherCost Double(5) O 其他费用Receiver.Company String(30) O 收件人公司Receiver.Name String(30) R 收件人Receiver.Tel String(20)Receiver.Mobile String(20)R 电话与手机，必填一个Receiver.PostCode String(10)
4、C 收件地邮编(ShipperCode 为EMS、YZPY 时必填)Receiver.ProvinceName String(20) R收件省( 如 广 东 省 ， 不 要 缺 少 “省” ， 如 果 是 直 辖 市 ， 请 直 接 传 北 京 、上海等)Receiver.CityName String(20) R 收件市(如深圳市，不要缺少 “市”)Receiver.ExpAreaName String(20) O 收件区/县(如福田区，不要缺少“区”或“县 ”)Receiver.Address String(100) R 收件人详细地址Sender.Company String(30) O
5、 发件人公司Sender.Name String(30) R 发件人Sender.Tel String(20)Sender.Mobile String(20)R 电话与手机，必填一个Sender.PostCode String(10) O 发件地邮编(ShipperCode 为EMS、YZPY 时必填)Sender.ProvinceName String(20) R发件省( 如 广 东 省 ， 不 要 缺 少 “省” ，如果是直辖市，请直接传北京、上海等)Sender.CityName String(20) R 发件市(如深圳市，不要缺少 “市”)Sender.ExpAreaName Stri
6、ng(20) O 发件区/县(如福田区，不要缺少“区”或“县 ”)Sender.Address String(100) R 发件人详细地址StartDateEndDateDate O上门揽件时间段，格式：YYYY-MM-DD HH24:MM:SSWeight Double(10,3) O 包裹总重量 kgQuantity Int(2) O包 裹 数 ， 一 个 包 裹 对 应 一 个 运 单号 ， 如 果 是 大 于 1 个 包 裹 ， 返 回则 按 照 子 母 件 的 方 式 返 回 母 运 单号和子运单号Volume Double(20,3) O 包裹总体积 m3Remark String
7、(100) O 备注AddService.Name String(20) O 增值服务名称AddService.Value String(30) O 增值服务值AddService.CustomerID String(30) O 客户标识Commodity.GoodsName String(100) R 商品名称Commodity.GoodsCode String(20) O 商品编码Commodity.Goodsquantity Int(5) O 商品件数Commodity.GoodsPrice Double(10) O 商品价格Commodity.GoodsWeight Double(10
8、,3) O 商品重量 kgCommodity.GoodsDesc String(50) O 商品描述Commodity.GoodsVol Double(15,3) O 商品体积 m3请求示例:OrderCode: 012657018199,ShipperCode: SF, PayType: 1,MonthCode: 7553045845,ExpType: 1,Cost: 1.0,OtherCost: 1.0,Sender: Company: LV,Name: Taylor, Mobile: 15018442396,ProvinceName: 上海, CityName: 上 海 , ExpAre
9、aName: 青浦区, Address: 明珠路,Receiver: Company: GCCUI,快递鸟快递接口技术文档Name: Yann, Mobile: 15018442396,ProvinceName: 北京, CityName: 北 京 , ExpAreaName: 朝阳区, Address: 三里屯街道,Commodity: GoodsName: 鞋子, Goodsquantity: 1,GoodsWeight: 1.0,AddService: Name: COD,Value: 1020,Weight: 1.0,Quantity: 1,Volume: 0.0,Remark: 小心
10、轻放 返回参数名称 类型(字符长度) 是否必须 描述EBusinessID String(10) R 用户 IDOrder.OrderCode String(30) R 订单编号Order.ShipperCode String(10) R 快递公司编码Order.LogisticCode String(30) O 快递单号Success Bool(10) R 成功与否(true/false)ResultCode String(5) R 返回编号Reason String(50) O 失败原因UniquerRequestNumber String(50) R 唯一标识返回示例:快递鸟快递接口技术
11、文档EBusinessID: 1237100,Success: true, Order: OrderCode: 012657018199, ShipperCode : SF , LogisticCode : ,ResultCode: 100,Reason: Demoimport java.io.BufferedReader;import java.io.IOException; import java.io.InputStreamReader;import java.io.OutputStreamWriter;import java.io.UnsupportedEncodingExceptio
12、n;import .HttpURLConnection;import .URL;import .URLEncoder;import java.util.HashMap;import java.util.Map;import com.sun.org.apache.xerces.internal.impl.dv.util.Base64;import java.security.MessageDigest; public class KdGoldAPIDemo /电商 IDprivate String EBusinessID=申请;/电商加密私钥，注意保管，不要泄漏private String Ap
13、pKey=申请;/测试请求 urlprivate string ReqURL = http:/testapi.kdniao.cc:8081/api/oorderservice;/正式请求 url/private string ReqURL = http:/api.kdniao.cc/api/OOrderService;/* Json 方式 在线下单* throws Exception */public String orderOnlineByJson() throws ExceptionString requestData= OrderCode: 012657700312, +ShipperC
14、ode:YTO, +PayType:1, +ExpType:1, +Cost:1.0, +OtherCost:1.0, +Sender: +快递鸟快递接口技术文档 +Company:LV,Name:Taylor,Mobile:15018442396,ProvinceName:上海,CityName:上海,ExpAreaName:青浦区,Address:明珠路 73 号, +Receiver: + +Company:GCCUI,Name:Yann,Mobile:15018442396,ProvinceName:北京,CityName:北京,ExpAreaName:朝阳区,Address:三里屯街
15、道雅秀大厦, +Commodity: + +GoodsName:鞋子,Goodsquantity:1,GoodsWeight:1.0, +AddService: + +Name:COD,Value:1020, +Weight:1.0, +Quantity:1, +Volume:0.0, +Remark:小心轻放, +Commodity: + +GoodsName:鞋子, +Goodsquantity:1, +GoodsWeight:1.0 +;Map params = new HashMap();params.put(RequestData, urlEncoder(requestData, UTF-8);params.put(EBusinessID, EBusinessID);params.put(Reque
