发货单接口
POST
https://poll.kuaidi100.com/print/billparcels.do
| 参数名 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| 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 | 其他面单特殊 需求参数显示，可以到后台-面单模板选择该模板，下方有对应产生列表 |
| 参数名 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| 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 请求参数示例
1、自定义参数命名格式：#{xxxx}
2、表格标题的设置，右键选择表格属性->标题单元格->第一行
3、表格边框线的显示，右键->表格属性->边框设置为1->间距和边距设置为0
1.6 信息代码含义
| 信息代码 | 信息内容描述 | 原因及建议处理方式 |
|---|---|---|
| 200 | 提交成功 | 提交成功 |
| 400 | 参数错误 | 请根据技术文档请求，注意参数类型及是否必填。 |
| 500 | 服务器错误 | 快递100的服务器出现间歇或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数写错等，也会报此错误 |
| 503 | 签名认证失败 | 请检查加密方式，param + t + key + secret 的顺序进行MD5加密，加密后字符串转大写,不用加上“+”号 |
| 600 | 您不是合法的用户（即授权Key出错） | 账号无可用单量，需要充值 |
| 601 | KEY已过期 | 账号无可用单量，需要充值 |
| 700 | 错误的回调地址 | 检查回调地址，或者联系快递100工作人员 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://poll.kuaidi100.com/print/billparcels.do' \
--data-urlencode 'method=' \
--data-urlencode 'key=' \
--data-urlencode 'sign=' \
--data-urlencode 't=' \
--data-urlencode '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" } ]}'响应示例响应示例
{
"result": true,
"returnCode": "200",
"message": "提交成功",
"data": {
"taskId": ""
}
}请求参数
Body 参数application/x-www-form-urlencoded
method
string
必需
key
string
必需
sign
string
必需
t
string
必需
param
string
必需
示例值:
{ "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
string
由其他字段拼接
示例值:
{ "pageWidth": 100, "pageHeight": 180, "margins": { "top": 5, "bottom": 5, "left": 5, "right": 5 }}
返回响应
扫码加入交 流群