电商接入顺丰电子面单接口操作手册.docx
13页
电商接入顺丰电子面单接口操作手册电商接入顺丰电子面单接口操作手册 一.接口描述 1）接口支持的消息接收方式：HTTP POST 2）请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8" 3）API地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx 4）接口所属：快递鸟 5）订单编号不可重复提交，重复提交系统会返回具体错误代码 二.请求系统级参数 参数名称 类型 说明 必须要求 RequestData String 请求内容需进行URL(utf-8)编码请求内容JSON格式，须和DataType一致 R EBusinessID String 商户ID，请在我的服务页面查看 RequestType String 请求指令类型：1007 DataSign DataType String 数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码详细过程请查看Demo R R R O String 请求、返回数据类型：只支持JSON格式 备注：R-必填，O-可选，C-报文中该参数在一定条件下可选。
三.接口参数 1.请求内容字段定义 参数名称 CallBack MemberID CustomerName CustomerPwd SendSite ShipperCode LogisticCode OrderCode MonthCode PayType ExpType IsNotice 类型 String String String String String String String String String Int String Int 说明 用户自定义回调信息 会员标识 电子面单客户账号 电子面单密码 收件网点标识 快递公司编码 快递单号 订单编号 月结编码 邮费支付方式:1-现付，2-到付，3-月结，4-第三方支付 快递类型：1-标准快件 是否通知快递员上门揽件：0-不通知；1-通知；不填则默认为1 是否必须 O O O O O R O R C R R O Cost OtherCost Company Name Tel Mobile Receiver PostCode Double 寄件费 Double 其他费用 String String String String String 收件人公司 收件人 O O O R 与，必填一个 R 收件人邮编 收件省 收件市 收件区 收件人详细地址 发件人公司 发件人 O R R O R O R ProvinceName String CityName String ExpAreaName String Address Company Name Tel Mobile Sender PostCode String String String String String String 与，必填一个 R 发件人邮编 发件省 发件市 发件区 发件人详细地址 O R R O R ProvinceName String CityName String ExpAreaName String Address StartDate EndDate Weight Quantity Volume Remark String String String 上门取货时间段:"yyyy-MM-dd HH:mm:ss"格式化，本文中O 所有时间格式相同 O O O O O AddServices Double 物品总重量kg Int 件数/包裹数 Double 物品总体积m3 String 备注 Name AddService Value CustomerID String String String 增值服务名称 增值服务值 客户标识 Commoditys O O O Commodity GoodsName GoodsCode String String 商品名称 商品编码 R O Goodsquantity Int GoodsPrice 商品数量 O O O O O O Double 商品价格 GoodsWeight Double 商品重量kg GoodsDesc GoodsVol IsReturnPrintTemplate String 商品描述 Double 商品体积m3 String 返回电子面单模板：0-不需要；1-需要 2.返回参数定义 参数名称 EBusinessID OrderCode ShipperCode LogisticCode MarkDestination OriginCode OriginName DestinatioCode DestinatioName SortingCode PackageCode Success ResultCode Reason UniquerRequestNumber PrintTemplate EstimatedDeliveryTime Callback 类型 String String String String String String String String String String String Bool String String String String String String 说明 用户ID 订单编号 快递公司编码 快递单号 大头笔 始发地区域编码 始发地/始发网点 目的地区域编码 目的地/到达网点 分拣编码 集包编码 成功与否 错误编码 失败原因 唯一标识 面单打印模板 订单预计到货时间yyyy-mm-dd 用户自定义回调信息 必须要求 R R R R O O O O O O O R R O R O O O Order 四.JAVA对接源码 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.util.HashMap; import java.util.Map; import com.sun.org.apache.xerces.internal.impl.dv.util.Base64; import java.security.MessageDigest; /** * * 快递鸟电子面单接口 * * ID和Key请到官网申请： */ public class KdGoldAPIDemo { /** //电商ID private String EBusinessID="请申请 //电商加密私钥，注意保管，不要泄漏 private String AppKey="请申请 //请求url, 正式环境地址：http://api.kdniao.cc/api/Eorderservice private String ReqURL="http://testapi.kdniao.cc:8081/api/Eorderservice"; * Json方式 电子面单 * @throws Exception */ public String orderOnlineByJson throws Exception{ String requestData= "{'OrderCode': '118060839871'," + "'ShipperCode':'SF'," + "'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':'三里屯街道雅秀大厦'}," + "'Commodity':" + "[{" + "'GoodsName':'鞋子','Goodsquantity':1,'GoodsWeight':1.0}]," + "'Weight':1.0," + "'Quantity':1," + "'Volume':0.0," + "'Remark':'小心轻放'," + "'IsReturnPrintTemplate':1}"; } /** Map
