欢迎!这里是飞印API文档

飞印API文档描述、示例


发送打印消息

简要描述:

  • 发送/批量发送打印数据
  • 通过飞印API发送的信息内容支持2种格式:
    1. 调用方自行组装好消息内容后,发送给飞印
    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 "全局返回码说明")”

页面列表

ITEM_HTML