参数名称

类型

必须要求

说明

RequestData

String

R

请求内容，JSON或XML格式,须和DataType一致

EBusinessID

String

R

电商ID

RequestType

String

R

请求指令类型：1007

DataSign

String

R

数据内容签名

DataType

String

O

请求、返回数据类型：1-xml,2-json；默认为xml格式

参数名称

类型

是否必须

描述

CallBack

String

O

用户自定义回调信息

MemberID

String

O

会员标识

平台方与快递鸟统一用户标识的商家ID

CustomerName

String

O

电子面单客户账号

（与快递网点申请）

CustomerPwd

String

O

电子面单密码

SendSite

String

O

收件网点标识

ShipperCode

String

R

快递公司编码

LogisticCode

String

O

快递单号

OrderCode

String

R

订单编号

MonthCode

String

C

月结编码

PayType

Int

R

邮费支付方式:

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

ExpType

String

R

快递类型：1-标准快件

IsNotice

Int

O

是否通知快递员上门揽件：0-不通知；1-通知；不填则默认为1

Cost

Double

O

寄件费（运费）

OtherCost

Double

O

其他费用

Receiver

Company

String

O

收件人公司

Name

String

R

收件人

Tel

String

R

电话与手机，必填一个

Mobile

String

PostCode

String

O

收件人邮编

ProvinceName

String

R

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

CityName

String

R

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

ExpAreaName

String

O

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

Address

String

R

收件人详细地址

Sender

Company

String

O

发件人公司

Name

String

R

发件人

Tel

String

R

电话与手机，必填一个

Mobile

String

PostCode

String

O

发件人邮编

ProvinceName

String

O

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

CityName

String

R

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

ExpAreaName

String

O

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

Address

String

R

发件详细地址

StartDate

String

O

上门取货时间段:

"yyyy-MM-dd HH:mm:ss"格式化，本文中所有时间格式相同

EndDate

String

O

Weight

Double

O

物品总重量kg

Quantity

Int

O

件数/包裹数

Volume

Double

O

物品总体积m3

Remark

String

O

备注

AddService

Name

String

0

增值服务名称

Value

String

0

增值服务值

CustomerID

String

0

客户标识(选填)

Commodity

GoodsName

String

R

商品名称

GoodsCode

String

O

商品编码

Goodsquantity

Int

O

件数

GoodsPrice

Double

O

商品价格

GoodsWeight

Double

O

商品重量kg

GoodsDesc

String

O

商品描述

GoodsVol

Double

O

商品体积m3

IsReturnPrintTemplate

String

O

返回电子面单模板：

0-不需要；1-需要

参数名称

类型

必须要求

说明

EBusinessID

String

R

电商用户ID

Order

OrderCode

String

R

订单编号

ShipperCode

String

R

快递公司编码

LogisticCode

String

R

快递单号

MarkDestination

String

O

大头笔

OriginCode

String

O

始发地区域编码

OriginName

String

O

始发地/始发网点

DestinatioCode

String

O

目的地区域编码

DestinatioName

String

O

目的地/到达网点

SortingCode

String

O

分拣编码

PackageCode

String

O

集包编码

Success

Bool

R

成功与否

ResultCode

String

R

错误编码

Reason

String

O

失败原因

UniquerRequestNumber

String

R

唯一标识

PrintTemplate

String

O

面单打印模板

EstimatedDeliveryTime

String

O

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

Callback

String

O

用户自定义回调信息

{

"OrderCode":  "012657700387",

"ShipperCode": "HTKY",

"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

}

],

"AddService": [

{

"Name": "COD",

"Value": "1020"

}

],

"Weight": 1.0,

"Quantity": 1,

"Volume": 0.0,

"Remark": "小心轻放",

"IsReturnPrintTemplate":1

}

{

"EBusinessID":  "1237100",

"Order": {

"OrderCode":  "012657700387",

"ShipperCode":  "HTKY",

"LogisticCode":  "50002498503427",

"MarkDestination": "京-朝阳(京-1)",

"OriginCode":  "200000",

"OriginName": "上海分拨中心",

"PackageCode": "北京"

},

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

"EstimatedDeliveryTime":"2016-03-06",

"Callback":"调用时传入的Callback",

"Success": true,

"ResultCode": "100",

"Reason": "成功"

}

///<summary>

///电商Sign签名

///</summary>

///<param  name="content">内容</param>

///<param  name="keyValue">Appkey</param>

///<param  name="charset">URL编码 </param>

///<returns>DataSign签名</returns>

Public  String Encrypt (String content, String keyValue, String charset)

{

if  (keyValue != null)

{

return  base64(MD5(content + keyValue, charset), charset);

}

return  base64(MD5(content, charset), charset);

}

///<summary>

/// 字符串MD5加密

///</summary>

///<param  name="Text">要加密的字符串</param>

///<returns>密文</returns>

Private  string MD5(string Text, string charset)

{

byte[]  buffer = System.Text.Encoding.GetEncoding(charset).GetBytes(Text);

try

{

System.Security.Cryptography.MD5CryptoServiceProvider  check;

check  = new System.Security.Cryptography.MD5CryptoServiceProvider();

byte[]  somme = check.ComputeHash(buffer);

string  ret = "";

foreach  (byte a in somme)

{

if (a  < 16)

ret  += "0" + a.ToString("X");

else

ret  += a.ToString("X");

}

return ret.ToLower();

}

catch

{

throw;

}

}

Private  static string base64(String str, String charset)

{

returnConvert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));

}