常用电子面单接口对接技术文档

参数名称

类型

必须要求

说明

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));

}