前言
J&T 极兔速递是一家科技创新型互联网快递物流企业,致力于为用户带来优质的快递和物流体验。
2015年8月由印尼首都雅加达作为起点,进入快递物流市场,目前覆盖了印度尼西亚、越南、马来西亚、泰国、菲律宾、柬埔寨及新加坡七个国家,成为东南亚超过5.5亿人口信赖的综合性物流服务商。
电子面单打印模板规格列表:
快递公司名称 |
编码 |
模板样式 |
尺寸规格 |
TemplateSize字段 |
CustomArea字段 |
极兔速递
|
JTSD
|
一联130 |
宽76mm |
传值130 |
支持 |
二联180 |
宽100mm |
默认返回,不能传值 |
支持 |
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 |