国网电子商务平台台怎样对接电子面单接口来打印电子单?

电子面单打印接口对接方法_百度文库
您的浏览器Javascript被禁用,需开启后体验完整功能,
享专业文档下载特权
&赠共享文档下载特权
&10W篇文档免费专享
&每天抽奖多种福利
两大类热门资源免费畅读
续费一年阅读会员,立省24元!
电子面单打印接口对接方法
阅读已结束,下载本文需要
想免费下载本文?
定制HR最喜欢的简历
下载文档到电脑,同时保存到云知识,更方便管理
加入VIP
还剩22页未读,
定制HR最喜欢的简历
你可能喜欢电子面单打印设置-PHP对接API_百度文库
您的浏览器Javascript被禁用,需开启后体验完整功能,
享专业文档下载特权
&赠共享文档下载特权
&10W篇文档免费专享
&每天抽奖多种福利
两大类热门资源免费畅读
续费一年阅读会员,立省24元!
电子面单打印设置-PHP对接API
阅读已结束,下载本文需要
想免费下载本文?
定制HR最喜欢的简历
下载文档到电脑,同时保存到云知识,更方便管理
加入VIP
还剩3页未读,
定制HR最喜欢的简历
你可能喜欢& & 电子面单接口是提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口,满足客户在线发货需求并提供打印面单的服务,客户通过网络选择物流公司发送请求通知贵公司有快递要发货,把数据通过此接口转发到快递鸟,由快递鸟为您通知对应的快递公司快递员上门取件。电子面单成功下单后,快递鸟系统内将自动订阅,一旦轨迹发生变化时,快递鸟将调用客户方推送接收接口。同时若客户使用代收货款服务,快递鸟会将代收货款的货款状态独立推送给用户。
一.接口描述
(1)订单编号(OrderCode)不可重复提交,重复提交系统会返回具体错误代码。(2)接口支持的消息接收方式为HTTP POST,请求方法的编码格式(utf-8):"application/x-www-form-charset=utf-8"。
(3)接口地址:
& & API测试地址:http://testapi.kdniao.cc:8081/api/EOrderService& & API正式地址:http://api.kdniao.cc/api/EOrderService
(4)圆通编码:YTO
二.接口参数
(1)请求系统级参数
参数名称类型说明必须要求
RequestData
请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。
EBusinessID
商户ID,请在我的服务页面查看。
RequestType
请求指令类型:1007
数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后进行URL(utf-8)编码。详细过程请查看Demo。
请求、返回数据类型:只支持JSON格式
备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)。
(2)请求内容字段定义
参数名称类型说明是否必须
用户自定义回调信息
CustomerName
电子面单客户账号(与快递网点申请)
CustomerPwd
电子面单密码
收件网点标识
ShipperCode
快递公司编码
LogisticCode
邮费支付方式:1-现付,2-到付,3-月结,4-第三方支付
快递类型:1-标准快件
是否通知快递员上门揽件:0-通知;1-不通知;不填则默认为0
寄件费(运费)
收件人公司
电话与手机,必填一个
收件人邮编
ProvinceName
收件省(如广东省,不要缺少&省&)
收件市(如深圳市,不要缺少&市&)
ExpAreaName
收件区(如福田区,不要缺少&区&或&县&)
收件人详细地址
发件人公司
电话与手机,必填一个
发件人邮编
ProvinceName
发件省(如广东省,不要缺少&省&)
发件市(如深圳市,不要缺少&市&)
ExpAreaName
发件区(如福田区,不要缺少&区&或&县&)
发件人详细地址
上门取货时间段:"yyyy-MM-dd HH:mm:ss"格式化,本文中所有时间格式相同
物品总重量kg
件数/包裹数
物品总体积m3
AddServices
AddService
增值服务名称
增值服务值
CustomerID
客户标识(选填)
Commoditys
Goodsquantity
GoodsPrice
GoodsWeight
商品重量kg
商品体积m3
IsReturnPrintTemplate
返回电子面单模板:0-不需要;1-需要
(3)返回参数定义
参数名称类型说明必须要求
EBusinessID
ShipperCode
快递公司编码
LogisticCode
MarkDestination
OriginCode
始发地区域编码
OriginName
始发地/始发网点
DestinatioCode
目的地区域编码
DestinatioName
目的地/到达网点
SortingCode
PackageCode
ResultCode
UniquerRequestNumber
PrintTemplate
面单打印模板
EstimatedDeliveryTime
订单预计到货时间yyyy-mm-dd
用户自定义回调信息
&三.接口对接demo
import java.io.BufferedR
import java.io.IOE
import java.io.InputStreamR
import java.io.OutputStreamW
import java.io.UnsupportedEncodingE
import java.net.HttpURLC
import java.net.URL;
import java.net.URLE
import java.util.HashM
import java.util.M
import com.sun.org.apache.xerces.internal.impl.dv.util.Base64;
import java.security.MessageD
* 快递鸟电子面单接口
* ID和Key请到官网申请:http://www.kdniao.com/ServiceApply.aspx
public class KdGoldAPIDemo {
private String EBusinessID="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx";
//电商加密私钥,快递鸟提供,注意保管,不要泄漏
private String AppKey="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx";
//请求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': ''," +
"'ShipperCode':'YTO'," +
"'PayType':1," +
"'ExpType':1," +
"'Cost':1.0," +
"'OtherCost':1.0," +
"'Sender':" +
"'Company':'LV','Name':'Taylor','Mobile':'','ProvinceName':'上海','CityName':'上海','ExpAreaName':'青浦区','Address':'明珠路73号'}," +
"'Receiver':" +
"'Company':'GCCUI','Name':'Yann','Mobile':'','ProvinceName':'北京','CityName':'北京','ExpAreaName':'朝阳区','Address':'三里屯街道雅秀大厦'}," +
"'Commodity':" +
"'GoodsName':'鞋子','Goodsquantity':1,'GoodsWeight':1.0}]," +
"'Weight':1.0," +
"'Quantity':1," +
"'Volume':0.0," +
"'Remark':'小心轻放'," +
"'IsReturnPrintTemplate':1}";
Map&String, String& params = new HashMap&String, String&();
params.put("RequestData", urlEncoder(requestData, "UTF-8"));
params.put("EBusinessID", EBusinessID);
params.put("RequestType", "1007");
String dataSign=encrypt(requestData, AppKey, "UTF-8");
params.put("DataSign", urlEncoder(dataSign, "UTF-8"));
params.put("DataType", "2");
String result=sendPost(ReqURL, params);
//根据公司业务处理返回的信息......
* @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. i++) {
int val = result[i] & 0
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 = Base64.encode(str.getBytes(charset));
@SuppressWarnings("unused")
private String urlEncoder(String str, String charset) throws UnsupportedEncodingException{
String result = URLEncoder.encode(str, charset);
* 电商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&String, String& params) {
OutputStreamWriter out =
BufferedReader in =
StringBuilder result = new StringBuilder();
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 ( MSIE 6.0; Windows NT 5.1;SV1)");
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
conn.connect();
// 获取URLConnection对象对应的输出流
out = new OutputStreamWriter(conn.getOutputStream(), "UTF-8");
// 发送请求参数
if (params != null) {
StringBuilder param = new StringBuilder();
for (Map.Entry&String, String& 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"));
while ((line = in.readLine()) != null) {
result.append(line);
} catch (Exception e) {
e.printStackTrace();
//使用finally块来关闭输出流、输入流
if(out!=null){
out.close();
if(in!=null){
in.close();
catch(IOException ex){
ex.printStackTrace();
return result.toString();
阅读(...) 评论()

我要回帖

更多关于 华能电子商务平台 的文章

 

随机推荐