圆通快递电子面单接口对接说明全Word文件下载.docx

圆通快递电子面单接口对接说明全Word文件下载.docx

《圆通快递电子面单接口对接说明全Word文件下载.docx》由会员分享，可在线阅读，更多相关《圆通快递电子面单接口对接说明全Word文件下载.docx（25页珍藏版）》请在冰豆网上搜索。

CustomerName

电子面单客户账号（与快递网点申请）

CustomerPwd

电子面单密码

SendSite

收件网点标识

ShipperCode

快递公司编码

LogisticCode

快递单号

OrderCode

订单编号

MonthCode

月结编码

C

PayType

Int

邮费支付方式:

1-现付，2-到付，3-月结，4-第三方支付

ExpType

快递类型：

1-标准快件

IsNotice

是否通知快递员上门揽件：

0-通知；

1-不通知；

不填则默认为0

Cost

Double

寄件费（运费）

OtherCost

其他费用

Receiver

Company

收件人公司

Name

收件人

Tel

电话与手机，必填一个

Mobile

PostCode

收件人邮编

ProvinceName

收件省（如广东省，不要缺少“省”）

CityName

收件市（如深圳市，不要缺少“市”）

ExpAreaName

收件区（如福田区，不要缺少“区”或“县”）

Address

收件人详细地址

Sender

发件人公司

发件人

发件人邮编

发件省（如广东省，不要缺少“省”）

发件市（如深圳市，不要缺少“市”）

发件区（如福田区，不要缺少“区”或“县”）

发件人详细地址

StartDate

上门取货时间段:

yyyy-MM-ddHH:

mm:

ss"

格式化，本文中所有时间格式相同

EndDate

Weight

物品总重量kg

Quantity

件数/包裹数

Volume

物品总体积m3

Remark

备注

AddServices

AddService

增值服务名称

Value

增值服务值

CustomerID

客户标识（选填）

Commoditys

Commodity

GoodsName

商品名称

GoodsCode

商品编码

Goodsquantity

商品数量

GoodsPrice

商品价格

GoodsWeight

商品重量kg

GoodsDesc

商品描述

GoodsVol

商品体积m3

IsReturnPrintTemplate

返回电子面单模板：

0-不需要；

1-需要

2）返回参数定义

用户ID

Order

MarkDestination

大头笔

OriginCode

始发地区域编码

OriginName

始发地/始发网点

DestinatioCode

目的地区域编码

DestinatioName

目的地/到达网点

SortingCode

分拣编码

PackageCode

集包编码

Success

Bool

成功与否

ResultCode

错误编码

Reason

失败原因

UniquerRequestNumber

唯一标识

PrintTemplate

面单打印模板

EstimatedDeliveryTime

订单预计到货时间yyyy-mm-dd

Callback

4.示例

1）JSON请求示例

{

OrderCode"

:

012657700387"

ShipperCode"

HTKY"

PayType"

1,

ExpType"

Cost"

1.0,

OtherCost"

Sender"

{

Company"

LV"

Name"

Taylor"

Mobile"

15018442396"

ProvinceName"

上海"

CityName"

ExpAreaName"

青浦区"

Address"

明珠路73号"

},

Receiver"

GCCUI"

Yann"

北京"

朝阳区"

三里屯街道雅秀大厦"

Commodity"

[

GoodsName"

鞋子"

Goodsquantity"

GoodsWeight"

1.0

}

],

AddService"

COD"

Value"

1020"

Weight"

Quantity"

Volume"

0.0,

Remark"

小心轻放"

IsReturnPrintTemplate"

1

2）JSON返回示例

失败：

EBusinessID"

1237100"

ResultCode"

105"

Reason"

订单号已存在，请勿重复操作"

，

UniquerRequestNumber"

5e66486b-8fbc-4131-b875-9b13d2ad1354"

成功：

Order"

LogisticCode"

50002498503427"

MarkDestination"

京-朝阳（京-1）"

OriginCode"

200000"

OriginName"

上海分拨中心"

PackageCode"

PrintTemplate"

此处省略打印模板HTML内容"

EstimatedDeliveryTime"

2016-03-06"

Callback"

调用时传入的Callback"

Success"

true,

100"

成功"

5.JAVA对接源码

importjava.io.BufferedReader;

importjava.io.IOException;

importjava.io.InputStreamReader;

importjava.io.OutputStreamWriter;

importjava.io.UnsupportedEncodingException;

import.HttpURLConnection;

import.URL;

import.URLEncoder;

importjava.util.HashMap;

importjava.util.Map;

importcom.sun.org.apache.xerces.internal.impl.dv.util.Base64;

importjava.security.MessageDigest;

/**

*

*ID和Key请到官网申请：

*/

publicclassKdGoldAPIDemo{

//电商ID

privateStringEBusinessID="

ID请申请"

;

//电商加密私钥，注意保管，不要泄漏

privateStringAppKey="

KEY请申请"

//请求url,正式环境地址：

//api.kdniao.cc/api/Eorderservice

privateStringReqURL="

//testapi.kdniao.cc:

8081/api/Eorderservice"

/**

*Json方式电子面单

*@throwsException

publicStringorderOnlineByJson（）throwsException{

StringrequestData="

{'

OrderCode'

'

118060839871'

"

+

"

'

ShipperCode'

HHTT'

PayType'

1,"

ExpType'

Cost'

1.0,"

OtherCost'

Sender'

{"

Company'

LV'

'

Name'

Taylor'

Mobile'

15018442396'

ProvinceName'

上海'

CityName'

ExpAreaName'

青浦区'

Address'

明珠路73号'

},"

Receiver'

GCCUI'

Yann'

北京'

朝阳区'

三里屯街道雅秀大厦'

Commodity'

[{"

GoodsName'

鞋子'

Goodsquantity'

1,'

GoodsWeight'

1.0}],"

Weight'

Quantity'

Volume'

0.0,"

Remark'

小心轻放'

IsReturnPrintTemplate'

1}"

Map<

String,String>

params=newHashMap<

（）;

params.put（"

RequestData"

urlEncoder（requestData,"

UTF-8"

））;

EBusinessID）;

RequestType"

"

1007"

）;

StringdataSign=encrypt（requestData,AppKey,"

DataSign"

urlEncoder（dataSign,"

DataType"

2"

Stringresult=sendPost（ReqURL,params）;

//根据公司业务处理返回的信息......

returnresult;

}

*MD5加密

*@paramstr内容

*@paramcharset编码方式

@SuppressWarnings（"

unused"

）

privateStringMD5（Stringstr,Stringcharset）throwsException{

MessageDigestmd=MessageDigest.getInstance（"

MD5"

md.update（str.getBytes（charset））;

byte[]result=md.digest（）;

StringBuffersb=newStringBuffer（32）;

for（inti=0;

i<

result.length;

i++）{

intval=result[i]&

0xff;

if（val<

=0xf）{

sb.append（"

0"

sb.append（Integer.toHexString（val））;

returnsb.toString（）.toLowerCase（）;

*base64编码

*@throwsUnsupportedEncodingException

privateStringbase64（Stringstr,Stringcharset）throwsUnsupportedEncodingException{

Stringencoded=Base64.encode（str.getBytes（charset））;

returnencoded;

}

privateStringurlEncoder（Stringstr,Stringcharset）throwsUnsupportedEncodingException{

Stringresult=URLEncoder.encode（str,charset）;

*电商Sign签名生成

*@paramcontent内容

*@paramkeyValueAppkey

*@throwsUnsupportedEncodingException,Exception

*@returnDataSign签名

privateStringencrypt（Stringcontent,StringkeyValue,Stringcharset）throwsUnsupportedEncodingException,Exception

if（keyValue!

=null）

{

returnbase64（MD5（content+keyValue,charset）,charset）;

}

returnbase64（MD5（content,charset）,charset）;

*向指定URL发送POST方法的请求

*@paramurl发送请求的URL

*@paramparams请求的参数集合

*@return远程资源的响应结果

privateStringsendPost（Stringurl,Map<

params）{

OutputStreamWriterout=null;

BufferedReaderin=null;

StringBuilderresult=newStringBuilder（）;

try{

URLrealUrl=newURL（url）;

HttpURLConnectionconn=（HttpURLConnection）realUrl.openConnection（）;

//发送POST请求必须设置如下两行

conn.setDoOutput（true）;

conn.setDoInput（true）;

//POST方法

conn.setRequestMethod（"

POST"

//设置通用的请求属性

conn.setRequestProperty（"

accept"

*/*"

connection"

Keep-Alive"

user-agent"

Mozilla/4.0（compatible;

MSIE6.0;

WindowsNT5.1;

SV1）"

Content-Type"

application/x-www-form-urlencoded"

conn.connect（）;

//获取URLConnection对象对应的输出流

out=newOutputStreamWriter（conn.getOutputStream（）,"

//发送请求参数

if（params!

=null）{

StringBuilderparam=newStringBuilder（）;

for（Map.Entry<

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（）;

//定义