发送打印消息
简要描述:
- 发送/批量发送打印数据
- 通过飞印API发送的信息内容支持2种格式:
- 调用方自行组装好消息内容后,发送给飞印
- 模板化信息,指定模板id以及该模板需要的参数内容,由飞印api生成最终的打印消息。
请求URL:
https://api.open.feyin.net/msg?access_token=ACCESS_TOKEN
请求方式:
- POST,JSON BODY提交
参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
device_no | 是 | string | 机器编号,如果是批量发送消息,这里每个机器编号用英文逗号','隔开 |
msg_no | 否 | string | 第三方系统针对本消息的唯一标示,譬如订单id等业务id,以便消息完成打印回调时能准确定位业务, 如果没有指定,飞印平台会自动生成一个唯一的消息id并通过接口返回 |
appid | 否 | string | 开发者在飞印平台创建的第三方应用id,对其他已授权用户的打印机调用时为必选项 |
msg_content | 否 | string | 需要打印的消息内容,在非模板消息时需要指定,详见消息排版说明 |
template_id | 否 | string | 模板id,仅在打印模板消息时需指定,打印模板消息一般标签打印类(比如ZH-3080)机型比较常用,当然普通飞印票据机型也都支持。 |
template_data | 否 | json | 模板数据,非字符串,仅在打印模板消息时需指定 |
请求示例(普通消息)
{
"device_no": "4600408123456789",
"msg_no":"ORDER-201712201500",
"msg_content": "这里是需要打印的详细内容"
}
请求示例(普通消息)批量打印
{
"device_no": "4600408123456789,4600408123456790",
"msg_no":"ORDER-201712201500",
"msg_content": "这里是需要打印的详细内容"
}
请求示例(模板消息)
{
"device_no": "4600408123456789",
"msg_no":"ORDER-201712201500",
"template_id": "bbbbbf0eb8222228c6c5254000bbbbb",
"template_data": {"text1":"公司名称","text2":"二维码地址" ...}
}
这里假设模板bbbbbf0eb8222228c6c5254000bbbbb 对应的模板内容,有 {{ text1 }} 和 {{ text2 }} 等占位符
返回示例
正常情况下,飞印开放平台会返回下述JSON数据:
{
"msg_no":"ORDER-201712201500",
"err_msg":""
}
返回参数说明
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
msg_no | 是 | string | 本次打印消息的唯一标记,如果在api请求时有指定 msg_no, 则此处跟请求时指定的值一样; 如果时未指定,飞印平台会自动生成一个唯一的消息id |
errmsg | 否 | String | 主要针对于批量打印时的出错信息,成功时,这里为空字符串"" |
错误时飞印开放平台会返回错误码等信息,JSON数据示例如下:
{
"errcode":10001,
"errmsg":"invalid appid"
}
JSON数据详见“[全局返回码说明](https://www.showdoc.cc/web/#/feyin?page_id=137418124005771 "全局返回码说明")”