自定义模板打印接口

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

如有发票、发货单、面单等打印需求，可使用该接口。通过管理后台模板配置，配置自定义模板，实现自定义打印功能。该接口支持在提交打印请求2天内的打印任务进行复打10次的操作

param数据结构：

参数名	是否必填	类型	说明
tempid	是	string	通过管理后台的打印模板V2信息获取
printType	是	string	打印类型（IMAGE,CLOUD,HTML）。IMAGE:生成图片短链；HTML:生成html短链；CLOUD:使用快递100云打印机打印，使用CLOUD时siid必填
siid	否	string	打印设备，通过打印机输出的设备码进行获取，printType为CLOUD时必填
direction	否	string	打印方向（默认0） 0-正方向 1-反方向；只有printType为CLOUD有作用
callBackUrl	否	string	打印状态回调地址
customParam	否	Map<String,Object>	自定义参数。方式传入为key-value格式

1.6信息代码含义

信息代码	信息内容描述	原因及建议处理方式
-1	服务器错误	快递100的服务器出现间歇或临时性异常，有时如果因为不按规范提交请求，也会报此错误
200	提交成功	提交成功
30001	参数错误	请根据技术文档请求，注意参数类型及是否必填
30002	验证签名失败	检查加密方式，param +t+key+ secret的顺序进行MD5加密，加密后字符串转32位大写,不用加上“+”号
30003	账号信息不正确	检查key是否正确
30004	账号单量不足	单量不足需要充值
30006	参数转换异常	按照描述可以自行检查参数的数据类型是否正确
30007	模板id不正确	检查传入tempId是否正确
30010	打印机状态不正确	打印机当前状态无法打单，需要检查

请求参数

Body 参数application/x-www-form-urlencoded

method

string

必需

业务类型（默认：custom）

key

string

必需

授权码，请申请企业版获取

sign

string

必需

32位大写，签名，用于验证身份，按MD5 (param +t+key+ secret)的顺序进行MD5加密，不需要加上“+”号，secret在企业管理后台获取

string

必需

时间戳如：1576123932000

param

string

由其他字段拼接

必需

示例代码

返回响应

成功(200)

失败(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

返回编码

必需

message

string

返回报文描述

必需

time

integer

必需

data

object

必需

taskId

string

必需

success

boolean

提交结果

必需

true提交成功，false失败

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

最后修改时间： 2 years ago