一、发货单接口
1.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
1.2 请求地址
https://poll.kuaidi100.com/print/billparcels.do
请求参数:
参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|
method | 是 | string | 业务类型(默认:billparcels) |
key | 是 | string | 授权码,请<a href=“https://api.kuaidi100.com/register/enterprise” target="_blank">申请企业版</a>获取 |
sign | 是 | string | 32位大写 签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号。secret可在企业管理后台查看。 |
t | 是 | string | 时间戳如:1576123932000 |
param | 是 | param | 由其他字段拼接,通过管理后台的打印发货单模板配置信息获取 |
settings | 否 | string | 由其他字段拼接 |
param数据结构:
参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|
tempid | 是 | string | 通过管理后台的打印发货单模板配置信息获取 |
siid | 是 | string | 打印设备,通过打印机输出的设备码进行获取 |
callBackUrl | 否 | string | 打印状态对调地址 |
tab0 | 否 | tab* | 发货单表格列表内容,JsonArrayString类型,多表格时用tab0,tab1,tab2等追加对象 |
Θimg0 | 否 | object | 多图片时用img0,img1,img2等追加 |
¬type | 是 | string | BASE_64:base64 图片格式;URL:图片地址;QR_CODE:二维码;CODE_128:code128格式的条形码 |
¬content | 是 | string | 图片内容 |
¬width | 是 | number | 图片宽度 |
¬height | 是 | number | 图片高度 |
…… | 否 | string | 其他面单特殊需求参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表 |
settings数据结构:
参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|
pageWidth | 是 | string | 宽,单位mm,默认值:100 |
pageHeight | 否 | string | 高,单位mm ,续打纸张时,该字段设置为null或空串 |
Θmargins | margins | 边距 | |
¬top | 否 | string | 上边距,单位:mm,默认:0 |
¬bottom | 否 | string | 下边距,单位:mm,默认:0 |
¬left | 否 | string | 左边距,单位:mm,默认:0 |
¬right | 否 | string | 右边距,单位:mm,默认:0 |
1.3 请求参数示例
发货单模板示例:
<img src=“https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/75b7a4191ef649808d52556438236929~tplv-k3u1fbpfcp-zoom-1.image” style=“zoom:60%”>
注,发货单模板内容都可以自定义实现,实现规则如下:
1、自定义参数命名格式:#{xxxx}
2、表格标题的设置,右键选择表格属性->标题单元格->第一行
3、表格边框线的显示,右键->表格属性->边框设置为1->间距和边距设置为0
param参数示例:
{
"tempid": "129906826866200576",
"siid": "L2204140087",
"callBackUrl": "http://www.baidu.com/fhd/callback",
"petName": "kd100",
"recName": "小百",
"recPhone": "10086",
"payTime": "2021-01-15 15:40:55",
"expressName": "德邦快递",
"printTime": "2021-01-15 15:41:30",
"printCount": "1",
"address": "广东省深圳市南山区金蝶软件园",
"total": "21",
"remark": "购物小票作为购物凭证,请妥善保管,您有任何疑问,请咨询服务热线 123456798",
"img0": {
"type": "code_128",
"content": "887921256577",
"width": 350,
"height": 100
},
"tab0": [
{
"prodName": "热敏纸",
"count": "5",
"specs": "76*130",
"unitPrice": "30",
"price": "150"
},
{
"prodName": "热敏纸",
"count": "10",
"specs": "100*180",
"unitPrice": "50",
"price": "500"
},
{
"prodName": "续打纸",
"count": "5",
"specs": "",
"unitPrice": "40",
"price": "200"
},
{
"prodName": "云打印机",
"count": "1",
"specs": "二代",
"unitPrice": "499",
"price": "499"
}
]
}
settings参数示例
{
"pageWidth": 100,
"pageHeight": 180,
"margins": {
"top": 5,
"bottom": 5,
"left": 5,
"right": 5
}
}
输出效果如下:
<img src=“https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/8f2d8dbd54754e87b1d8653776d64d12~tplv-k3u1fbpfcp-zoom-1.image” style=“zoom:60%”>
1.4 返回结果
字段 | 类型 | 说明 | 备注 |
---|---|---|---|
result | boolean | 提交结果 | true提交成功,false失败 |
returnCode | string | 返回编码 | |
message | string | 返回报文描述 | |
data | data |
data数据结构
字段 | 类型 | 说明 | 备注 |
---|---|---|---|
taskId | string | 任务ID |
1.5 返回结果示例
{
"result": true,
"returnCode": "200",
"message": "提交成功",
"data": {
"taskId":"" // 任务ID
}
}
1.6 信息代码含义
信息代码 | 信息内容描述 | 原因及建议处理方式 |
---|---|---|
200 | 提交成功 | 提交成功 |
400 | 参数错误 | 请根据技术文档请求,注意参数类型及是否必填。 |
500 | 服务器错误 | 快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误 |
503 | 签名认证失败 | 请检查加密方式,param + t + key + secret 的顺序进行MD5加密,加密后字符串转大写,不用加上“+”号 |
600 | 您不是合法的用户(即授权Key出错) | 账号无可用单量,需要充值 |
601 | KEY已过期 | 账号无可用单量,需要充值 |
700 | 错误的回调地址 | 检查回调地址,或者联系快递100工作人员 |
二、打印回调接口
打印状态变更是会触发回调,回调后如果没有得到合作方正确返回,会重复回调多2次,即最多回调3次。每次回调间隔30分钟。
2.1 接口格式
提供统一格式的HTTP POST,并返回统一格式JSON数据。
请求报头:Content-Type=application/x-www-form-urlencoded;charset=UTF-8
2.2 请求地址
请求参数:
字段 | 类型 | 说明 | 备注 |
---|---|---|---|
taskId | string | 任务ID | |
sign | string | 签名 | 32位大写签名,MD5 (param +salt) |
param | param | 参数主体 |
param数据结构:
字段 | 是否必填 | 类型 | 说明 |
---|---|---|---|
status | 是 | string | 状态编码,200:打印成功,201打印不成功。 |
message | 是 | string | 状态描述 |
2.3 返回结果
字段 | 说明 | 备注 |
---|---|---|
result | 提交结果 | true提交成功,false失败 |
returnCode | 返回编码 | |
message | 返回报文描述 |
2.4 返回结果示例
{
"result":true,
"returnCode":"200",
"message":"成功"
}
2.5 信息代码含义
字段名称 | 字段含义 |
---|---|
result | true表示成功,false表示失败。如果提交回调接口的地址失败,30分钟后重新回调,3次仍旧失败的,自动放弃 |
returnCode | 200: 提交成功 500: 服务器错误 其他错误请自行定义 |
message | 返回的提示 |
其他信息快递100会忽略。
一、发货单API产品介绍
发货单接口提供给电商、企业、商城等打印发货单、发货清单等商品单据。该接口支持用户自定义配置发货单模板,支持添加条码、二维码等信息,实现商品单据的快速打印。
二、发货单API应用场景
- 在商家发货时,自定义发货单模板并打印发货单;
- 同时使用电子面单服务,调用同一台打印机打出电子面单和发货单,节省单据打印时间。
三、发货单API收费模式
1. 收费方式
发货单服务使用预充值付费方式,按单收费,商户在注册快递100账号后可以在企业管理后台<a href=“https://api.kuaidi100.com/service/print” target="_blank">查看套餐</a>并购买单量。
2. 收费价格
发货单服务收费标准是0.1元/单,费用套餐请看下表。
价格/元 | 电子面单与云打印单量 | 赠送 | 单价/元 |
---|---|---|---|
5000 | 60000 | 查询40000单 | 0.05 |
2000 | 35000 | 约0.057 | |
2000 | 20000 | 查询15000单 | 约0.057 |
2000 | 25000 | 云盒/云打印机 | / |
1000 | 10000 | 查询5000单 | 约0.067 |
1000 | 10000 | 云盒/云打印机 | / |
500 | 2000 | 云打印机 | / |
200 | 2000 | 0.1 |
注:电子面单与云打印单量可用于电子面单、发货单和云打印接口服务。
企业每次成功调用接口,都会扣除单量,若单量已经扣除完毕,需要重新充值购买。
3. 开具发票
快递100支持开具增值税发票,用户购买完成后可在企业管理后台-费用中心-支付记录-请求开票。默认开具电子增值税普通发票,1000元以上可支持开具增值税专用发票。
官方文档:
http://api.kuaidi100.com/document/5f0ff9da2977d50a94e1023a.html
http://api.kuaidi100.com/document/5f0ff9e5bc8da837cbd8aefa.html