常用电子面单接口API demo下载

一.电子面单接口类型及定义

1. 快递电子面单接口：快递公司自己开发的电子面单服务， 商家使用必须快递公司上门做系统对接，使用一家快递则需要对接一次。

2.菜鸟电子面单接口：可一次对接15家快递公司， 无需和每一家快递公司做对接。支持快递有四通一达、EMS、宅急送、德邦、优速、天天、快捷、全峰等15家常用快递公司，其中不包括顺丰。

3.快递鸟电子面单接口：可一次对接15家快递公司， 无需和每一家快递公司做对接。支持快递有四通一达、顺丰、EMS、宅急送、德邦、优速等15家快递公司，对顺丰有电子面单服务需求的可以选择顺丰自有的电子面单或者是快递鸟电子面单。

 

二.开通使用流程

1.快递电子面单

a. 和多家快递公司申请账号

b.分别进行接口对接

c.电子面单服务用户向快递网点申请开通及确认合作细节

 

2.菜鸟电子面单

a.向菜鸟提交对接申请

b.和菜鸟进行接口对接

c.电子面单服务用户向菜鸟申请账号

d.电子面单服务用户向快递网点申请开通及确认合作细节

 

3.快递鸟电子面单

a. 进入快递鸟网站申请账号，获取专属的ID和KEY

b.和快递鸟进行接口对接

 

接口类型较多，以下先附上快递鸟电子面单接口调用方式，希望对大家有所帮助。后面将逐个对菜鸟电子面单、顺丰电子面单等接口调用方式做整理说明。

三.接口规则

(1)、只支持Json格式。接口指令1007。

(2)、订单编号(OrderCode)不可重复提交，重复提交系统会返回具体错误代码。

(3)、目前接口支持了：顺丰（SF）、EMS（EMS）、宅急送（ZJS）、圆通（YTO）、百世快递（HTKY）、中通（ZTO）、韵达（YD）、申通（STO）、德邦（DBL）、优速（UC）、京东（JD）、信丰（XFEX）、全峰（QFKD）、跨越速运（KYSY）、安能小包（ANE）、快捷快递（FAST）、国通（GTO）、天天快递（HHTT）、邮政快递包裹（YZPY），后续更多的快递公司正在对接中。

 

散户模式（无需电子面单客户号）支持快递公司：顺丰（SF）、EMS（EMS）（仅支持广东省内发货）、快捷快递（FAST）、宅急送（ZJS）、邮政快递包裹（YZPY），后续更多的快递公司正在对接中。

(4)、请求报文中不允许出现以下特殊字符： '   "  #    &    +   <   >

四.系统级和应用级输入参数

系统级	应用级输入参数			类型	是否必须	描述
RequestData（必填参数，请求内容，JSON格式,须和DataType一致）	CallBack			String	O	用户自定义回调信息
	MemberID			String	O	会员标识 平台方与快递鸟统一用户标识的商家ID
	CustomerName			String	O	电子面单客户账号 （与快递网点申请或通过快递鸟官网申请或通过申请电子面单客户号申请）
	CustomerPwd			String	O	电子面单密码
	SendSite			String	O	收件网点标识
	ShipperCode			String	R	快递公司编码
	LogisticCode			String	O	快递单号
	ThrOrderCode			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	R	发件省（如广东省，不要缺少“省”）
		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-需要
	IsSendMessage			Int	O	是否订阅短信 0-不需要；1-需要
	TemplateSize			String	O	模板尺寸
EBusinessID				String	R	商户ID
RequestType				String	R	请求指令类型：1007
DataSign				String	R	数据内容签名
DataType				String	R	请求、返回数据类型： 2-json

 

五.返回结果参数

同步返回

参数名称		类型	必须要求	说明
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	用户自定义回调信息
SubCount		Int	O	子单数量
SubOrders		String	O	子单号
SubPrintTemplates		String	O	子单模板
ReceiverSafePhone		String	O	收件人安全电话
SenderSafePhone		String	0	寄件人安全电话
DialPage		String	R	拨号页面网址（转换成二维码可扫描拨号）

 

demo下载:见附件