一、电子面单下单接口

通过快递公司或网点、菜鸟与淘宝提供的电子面单账号，进行快递下单和打单。支持只下单，或者生成图片使用本地打印设备打印输出面单，以及调用快递100云打印设备打印输出面单。

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并统一返回JSON格式数据。

1.2 请求地址

https://api.kuaidi100.com/label/order

请求参数（header）

请求参数（body）

param数据结构：

1.3 请求参数示例

method = order
key = ** ** *
	sign = ** ** *
	t = 1470304729724
param = {
	"partnerId": "123456",
	"partnerKey": "",
	"code": "",
	"kuaidicom": "zhaijisong",
	"recMan": {
		"name": "张三",
		"mobile": "13888888888",
		"printAddr": "广东深圳市南山区金蝶软件园",
		"company": ""
	},
	"sendMan": {
		"name": "李四",
		"mobile": "13888888888",
		"printAddr": "广东深圳市南山区金蝶软件园",
		"company": ""
	},
	"cargo": "test",
	"tempId": "60f6c17c7c223700131d8bc3",
	"childTempId": "61bff9efc66fb00013a1b168",
	"backTempId": "61bffa26c66fb00013a1b16c",
	"payType": "SHIPPER",
	"expType": "标准快递",
	"remark": "测试下单,请勿发货",
	"collection": "0",
	"needChild": "0",
	"needBack": "0",
	"count": 1,
	"printType": "CLOUD",
	"siid": "KX100*******",
	"needDesensitization": true,
	"needLogo": true,
	"needOcr": false
}

1.4 返回结果

data数据结构

注意：当net入参为taobao/cainiao/jdalpha/pinduoduoWx/douyin/kuaishou/weipinhui时，printType将不起作用，label返回的结果除了jdalpha是jpg，其他都是pdf格式

1.5 返回结果示例

成功示例

{
	"code": 200,
	"data": {
		"kuaidinum": "ZJS8888888888",
		"bulkpen": "371-转9999-C482",
		"sameCity": "1",
		"sameProv": "1",
		"taskId": "7EEAFD6CBEF64FEBAA10022BD32378BC"
	},
	"message": "success",
	"time": 0,
	"success": true
}    

失败示例

{
	"code": 30005,
	"message": "电子面单账号校验失败，请确认账号信息是否正确",
	"time": 0,
	"success": false
}

1.6 返回信息代码含义

二、电子面单复打接口

该接口支持在提交打印请求2天内且打印方式（printType）为“CLOUD”的打印任务进行复打10次的操作。

2.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

2.2 请求地址

https://api.kuaidi100.com/label/order

请求参数：

param数据结构：

2.3 返回结果

2.4 提供数据内容

打印设备复打成功返回示例

{
	"code": 200,
	"message": "success",
	"time": 0,
	"success": true
} 

错误示例：

{
	"code": 30009,
	"message": "查无此单",
	"time": 0,
	"success": false
} 

2.5 返回信息代码含义

三、打印状态回调

通过上述接口提交的打印请求，进行打印状态返回。

3.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

3.2 请求地址

由贵司在电子面单打印请求中通过callBackUrl字段提供

<form method="post" name="" action="[callbackUrl]">
    <input type="text" name="taskId" value="{XXX}" />
    <input type="text" name="param" value="{XXX}" />
<input type="text" name="sign" value="签名字符串" />
<input type="text" name="pushType" value="printStatus" />
</form>

请求参数：

param数据结构：

请求参数示例

taskId=***
param={"message":"打印成功","status":"200"}
sign=***
pushType=printStatus

3.3 返回结果

3.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功"
}

说明：

其他信息快递100会忽略。

四、OCR识别结果回调

通过上述接口提交的第三方平台打单，开启ocr后（needOcr为true时），会通过callBackUrl推送。

4.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

4.2 请求地址

由贵司在电子面单打印请求中通过callBackUrl字段提供

<form method="post" name="" action="[callbackUrl]">
    <input type="text" name="taskId" value="{XXX}" />
    <input type="text" name="param" value="{XXX}" />
    <input type="text" name="sign" value="签名字符串" />
    <input type="text" name="type" value="ocr" />
</form>

请求参数：

param数据结构：

4.3 返回结果

4.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功"
}

说明：

其他信息快递100会忽略。

五、订阅/ocr异常结果回调

开启订阅或ocr后，如果当前账号没有余额，将会通过callBackUrl推送

5.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

5.2 请求地址

由贵司在电子面单下单请求中通过callBackUrl字段提供

<form method="post" name="" action="[callbackUrl]">
    <input type="text" name="taskId" value="{XXX}" />
    <input type="text" name="param" value="{XXX}" />
    <input type="text" name="sign" value="签名字符串" />
    <input type="text" name="type" value="exception" />
</form>

请求参数：

5.3 返回结果

5.4 返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "提交成功"
}

说明：

其他信息快递100会忽略。