极兔快递电子面单打印API接口-极兔快递

前言

J&T 极兔速递是一家科技创新型互联网快递物流企业，致力于为用户带来优质的快递和物流体验。

2015年8月由印尼首都雅加达作为起点，进入快递物流市场，目前覆盖了印度尼西亚、越南、马来西亚、泰国、菲律宾、柬埔寨及新加坡七个国家，成为东南亚超过5.5亿人口信赖的综合性物流服务商。

 电子面单打印模板规格列表：

快递公司名称

编码

模板样式

尺寸规格

TemplateSize字段

CustomArea字段

极兔速递	JTSD	一联130	宽76mm 高130mm	传值130	支持
		二联180	宽100mm 高180mm 切点110/70	默认返回，不能传值	支持

1.完成前期准备工作

1.1,去快递鸟免费注册一个对接账号

1.2,免费获得一个apiKey(接口权限验证需要)

1.3,完成实名认证流程

1.4,订购一个免费套餐

1.5,准备打印机、打印纸

• 打印机：

     电子面单模板对打印机品牌、型号等没有要求，只要是热敏打印机即可，常见品牌如：斑马、得力、快麦、汉印、佳博等。

     打印机可由快递网点提供或者在淘宝京东上购买，安装打印机及驱动程序联系打印机提供方；

• 打印纸：

       打印纸可由快递网点提供或者在淘宝京东上购买，购买时可选择全白热敏       纸。

2.API接口

2.1,测试调用地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json

2.2,正式调用地址：http://api.kdniao.com/api/EOrderService

2.3,请求方式：POST

2.4,编码格式(utf-8)：application/x-www-form-urlencoded;charset=utf-8

2.5,返回类型：JSON

2.6,调试页面：http://kdniao.com/UserCenter/v2/SandBox/TrackQuery.aspx

2.7,调试工具：去调试（使用快递鸟账号登录）

3.请求参数（Headers）

参数名称	类型	说明	必须要求
RequestData	String	请求内容需进行URL(utf-8)编码,请求内容JSON格式，须和DataType一致	必填
EBusinessID	String	用户ID，查看用户ID和ApiKey	必填
RequestType	String	请求指令类型：1007	必填
DataSign	String	签名数据，(Body+ApiKey)进行MD5加密，再进行Base64编码，最后进行URL(utf-8)编码	必填
DataType	String	求、返回数据类型：2-json ，默认Json	选填

4.请求参数（Body）

参数名称		类型	说明	是否必须
MemberID		String（50）	ERP系统、电商平台等系统或平台类型用户的会员ID或店铺账号等唯一性标识，用于区分其用户	O
CustomerName		String(50)	电子面单客户号，需要下载《快递鸟电子面单客户号参数对照表.xlsx》，参考对应字段传值	O
CustomerPwd		String(30)		O
SendSite		String(30)		O
SendStaff		String(30)		C
MonthCode		String		C
CustomArea		String(500)	商家自定义区域	C
WareHouseID		String(30)	发货仓编码	O
TransType		Int(1)	运输方式 1- 陆运 2- 空运 不填默认为1	O
ShipperCode		String(10)	快递公司编码 详细编码参考《快递鸟接口支持快递公司编码.xlsx》	R
LogisticCode		String(30)	快递单号(仅宅急送可用)	O
ThrOrderCode		String(50)	第三方订单号 (ShipperCode为JD且ExpType为1时必填)	C
OrderCode		String(30)	订单编号(自定义，不可重复)	R
PayType		Int(1)	邮费支付方式:1-现付，2-到付，3-月结，4-第三方支付(仅SF支持)	R
ExpType		String(2)	快递类型：1-标准快件 ,详细快递类型参考《快递公司快递业务类型.xlsx》	R
IsReturnSignBill		Int(1)	是否要求签回单 1- 要求 0-不要求	O
OperateRequire		String(20)	签回单操作要求(如：签名、盖章、身份证复印件等)	O
Cost		Cost Double(5)	快递运费	O
OtherCost		Double(5)	其他费用	O
Receiver	Company	String(30)	收件人公司	O
	Name	String(30)	收件人	R
	Tel	String(20)	电话与手机，必填一个	R
	Mobile	String(20)
	PostCode	String(10)	收件人邮编	c
	ProvinceName	String(20)	收件省 (如广东省，不要缺少“省”；如是直辖市，请直接传北京、上海等； 如是自治区，请直接传广西壮族自治区等)	R
	CityName	String（20）	收件市(如深圳市，不要缺少“市”； 如果是市辖区，请直接传北京市、上海市等)	R
	ExpAreaName	String（20）	收件区/县(如福田区，不要缺少“区”或“县”)	R
	Address	String(100)	收件人详细地址	R
Sender