电子面单打印接口说明

1、电子面单打印接口说明对接接口后通过网络选择物流公司发送请求通知贵公司有快递要发货，把数据通过此接口转发到接口，由接口通知对应的快递公司快递员上门取件。电子面单API 有四大功能，可以根据自身情况调用：. 电子面单接口.电子面单余量查询接口.电子面单单号取消.申请电子面单客户号电子面单接口接口规则（1）、 只支持 Json格式 。接口指令1007。（2）、订单编号（OrderCode） 不可重复提交，重复提交系统会返回具体错误代码。（3）、目前接口支持了：顺丰（SF） 、 EMS（ EMS） 、宅急送（ZJS） 、圆通（YTO） 、百世快递（HTKY） 、中通（ZTO） 、韵达（YD）、 申通（

2、STO） 、德邦（DBL）、 优速 （UC） 、京东（JD） 、信丰（XFEX） 、全峰（QFKD） 、跨越速运（KYSY） 、安能小包（ANE） 、快捷快递（FAST） 、国通（GTO） 、天天快递（HHTT） 、邮政快递包裹（YZPY） ，后续更多的快递公司正在对接中。散户模式（无需电子面单客户号）支持快递公司：顺丰（SF） 、 EMS（ EMS） （仅支持广东省内发货）、快捷快递（FAST） 、宅急送（ZJS） 、邮政快递包裹（YZPY） ，后续更多的快递公司正在对接中。（4）、测试地址： HYPERLINK http:/testapi.kdniao.cc:8081/api/eorder

3、service/ http:/testapi.kdniao.cc:8081/api/eorderservice/（5）、正式地址： HYPERLINK http:/api.kdniao.cc/api/EOrderService http:/api.kdniao.cc/api/EOrderService（6）、请求报文中不允许出现以下特殊字符： # & + （7）、接口使用：快递鸟网站注册申请接口API1.2 系统级和应用级输入参数系统级输入参数应用级输入参数类型是否必须描述RequestData （必填参数，请求内容，JSON格式, 须和DataType 一致）CallBackStringO用

4、户自定义回调信息MemberIDStringO会员标识平台方与接口统一用户标识的商家IDmeStringO电子面单客户账号（与快递网点申请或CustomerNa通过接口申请或通过申请电子面单客户号申请）CustomerPwdStringO电子面单密码SendSiteStringO收件网点标识ShipperCodeStringR快递公司编码LogisticCodeStringO快递单号ThrOrderCodeStringO第三方订单号OrderCodeStringR订单编号MonthCodeStringC月结编码PayTypeIntR月结，邮费支付方式:1- 现付，2- 到付，3-4-第三方支付

5、ExpTypeStringR快递类型：1- 标准快 件IsNoticeIntO门揽件：不通知；是否通知快递员上0- 通知；1-不填则默认为1CostDoubleO寄件费（运费）OtherCostDoubleO其他费用CompanyStringO收件人公司NameStringR收件人ReceiverTelStringR电话与手机，必填一个MobileStringPostCodeStringO收件人邮编ProvinceNameStringR收件省（如广东省，不要缺少“省”）CityNameStringR收件市（如深圳市，不要缺少“市”）ExpAreaNameStringO收件区（如福田区，不要缺少

6、“区”或“县”）AddressStringR收件人详细地址SenderCompanyStringO发件人公司NameStringR发件人TelStringR电话与手机，必填一个MobileStringPostCodeStringO发件人邮编ProvinceNameStringR发件省（如广东省，不要缺少“省”）CityNameStringR发件市（如深圳市，不要缺少“市”）ExpAreaNameStringO发件区（如福田区，不要缺少“区”或“县”）AddressStringR发件详细地址StartDateStringO上门取货时间段:yyyy-MM-ddHH:mm:ss格式化，本文中所有时间

7、格式相同EndDateStringOWeightDoubleO物品总重量kgQuantityIntO件数 /包裹数VolumeDoubleO物品总体积m3RemarkStringO备注NameString0增值服务名称AddServiceValueString0增值服务值CustomerIDString0客户标识（ 选填 ）CommodityGoodsNameStringR商品名称GoodsCodeStringO商品编码GoodsquantityIntO件数GoodsPriceDoubleO商品价格GoodsWeightDoubleO商品重量kgGoodsDescStringO商品描述Good

8、sVolDoubleO商品体积m3IsReturnPrintTemplateStringO返回电子面单模板：0- 不需要；1- 需要IsSendMessageIntO是否订阅短信0- 不需要；1- 需要TemplateSizeStringO模板尺寸EBusinessIDStringR商户IDRequestTypeStringR请求指令类型：1007DataSignStringR数据内容签名DataTypeStringR请求、返回数据类型：2-json1.3 返回结果参数同步返回参数名称类型必须要求说明EBusinessIDStringR电商用户IDOrderCodeStringR订单编号Ord

9、erShipperCodeStringR快递公司编码LogisticCodeStringR快递单号MarkDestinatio nStringO大头笔OriginCodeStringO始发地区域编码OriginNameStringO始发地/ 始发网点DestinatioCodeStringO目的地区域编码DestinatioNameStringO目的地/ 到达网点SortingCodeStringO分拣编码PackageCodeStringO集包编码SuccessBoolR成功与否ResultCodeStringR错误编码ReasonStringO失败原因UniquerRequestNumbe

10、rStringR唯一标识PrintTemplateStringO面单打印模板EstimatedDeliveryTimeStringO订单预计到货时间yyyy-mm-ddCallbackStringO用户自定义回调信息SubCountIntO子单数量SubOrdersStringO子单号SubPrintTemplatesStringO子单模板ReceiverSafePhoneStringO收件人安全电话SenderSafePhoneString0寄件人安全电话DialPageStringR拨号页面网址（转换成二维码可扫描拨号）2 电子面单余量查询接口2.1 功能说明用户查询客户号在快递公司的单号

11、剩余量。2.2 接口规则、 接口只支持Json 格式参数，接口指令1127。 只支持POST请求方式，utf-8 编码。、目前支持快递公司：优速 ， 中通 ， 韵达 ，后续更多的快递公司正在对接中。2.3 系统级和应用级输入参数系统级输入参数应用级输入 类型参数必须要求描述RequestData （必 填参数，请求内JSON格式, 须和 DataType 一致）StringShipperCodeR快递公司编码StringCustomerNameR电子面单账号StringCustomerPwdO电子面单密码StringStationCodeO网点编码StringStationNameO网点EBu

12、sinessIDStringR电商IDRequestTypeStringR请求指令类型：1127DataSignStringR数据内容签名DataTypeStringR请求、返回数据类型：2-json ；2.4 返回结果参数参数名称类型必须要求说明EbusinessIDStringR用户IDSuccessBoolR成功与否：true,falseReasonStringO原因ResultCodeStringR返回结果编号EorderBalanc eTotalNumIntO累计充值数量，电子面单总量 （包含已使用/未使用）AvailableNumIntO可用量（剩余量）JSON 请求示例Shipp

13、erCode: UC,CustomerName: 80238728,CustomerPwd: c0bfe0ba86b66bae5426303c53db0a81,StationCode: 3001,StationName: 福田网点JSON 返回示例EBusinessID: 1261602,Success: true,Reason: ,ResultCode: 100,EorderBalance: AvailableNum: 0,TotalNum: 03 电子面单单号取消功能说明通用接口提交快递公司编码、快递单号，则可以取消提交单号。仅支持未揽件状态快递单进行取消，取消后的回收规则以快递公司为准。

14、接口规则(1)、接口指令1147。(2)、目前支持快递公司：优速 ，后续更多的快递公司正在对接中。3.3 系统级和应用级输入参数系统级输入参数类型应用级输入参数必须要求描述RequestData （必填参数，请求内JSON格式, 须DataType 一致）StringShipperCodeR快递公司编码StringExpNoR运单号StringCustomerNameR客户号StringCustomerPwdO客户号密码EBusinessIDStringR电商IDRequestTypeStringR请求指令类型：1147DataSignStringR数据内容签名DataTypeStringR请

15、求、返回数据类型：2-json ；3.4 返回结果参数参数名称类型必须要求说明EbusinessIDStringR用户IDSuccessBoolR成功与否：true,falseResultCodeStringO结果编码ReasonStringO原因3.5 Json请求示例ShipperCode: UC,ExpNo: 900008664480,CustomerName: 80238728,CustomerPwd: c0bfe0ba86b66bae5426303c53db0a8b3.6 Json请求返回示例EBusinessID: 1261602,Success: true,ResultCode:

16、 1004 申请电子面单客户号功能说明打印方通过接口向快递公司申请客户号接口规则、 接口只支持Json 格式参数，接口指令1107。 只支持POST请求方式，utf-8 编码。、测试地址： HYPERLINK http:/testapi.kdniao.cc:8081 http:/testapi.kdniao.cc:8081/api/apiservice、正式地址： HYPERLINK http:/api.kdniao.cc http:/api.kdniao.cc /api/apiservice、目前支持快递公司：优速 ，后续更多的快递公司正在对接中。系统级和应用级输入参数系统级输入参数类型应用

17、级输入参数必须要求描述RequestData 请求内容，JSON格式 , 须和DataType 一致)stringShipperCodeR快递公司编码StationCodeR网点编码StationNameR网点ApplyIDO申请ID(用户记录在快递公司的标识)CompanyO公司NameR联系人TelC电话MobileC手机ProvinceNameR省份ProivnceCodeO省编码CityNameR城市CityCodeO城市编码ExpAreaNameR区县ExpAreaCodeO区县编码AddressR详细地址EBusinessIDStringR电商IDRequestTypeStringR请求指令类型：1107DataSignStringR数据内容签名DataTypeStringR请求、返回数据类型：2-json ；返回结果参数参数名称类型是否必须描述EbusinessIDStringR用户IDSuccessBoolR成功与否：true,falseResultCodeStringO结果编码ReasonStringO原因Json请求示例ShipperCode: UC, Company: XXX, ApplyID: 1261602, Name: