文本打印指令集 · yilianyun-open-api

# 指令集 ### 一、阅读前提 1. 本篇主要介绍易联云文本打印指令，由于设备固件版本问题，以下指令有些可能无法识别，具体详细文档请看[易联云指令详解文档](https://docs.qq.com/sheet/DQkNoTm9uVWFyeEdU?tab=BB08J2) ### 二、指令说明 <table> <colgroup> <col style="width: 10%;"> <col style="width: 16%;"> <col style="width: 38%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 6%;"> <col style="width: 5%;"> <col style="width: 5%;"> </colgroup> <thead> <tr> <th>指令</th> <th>内容</th> <th>说明</th> <th>K4</th> <th>K5&B1</th> <th>K6</th> <th>K7</th> <th>W1</th> <th>M1</th> <th>K8</th> </tr> </thead> <tbody> <tr> <td>设置订单确认</td> <td><MC>confirm_state,sound_time,timeout_state</MC></td> <td>指令放在订单开头；confirm_state：订单确认状态，值为(0、1、2、3、4)，0=关闭，1=开启+自动在订单尾部添加提示+在用户操作后打印提示，2=开启+自动在订单尾部添加提示+不在用户操作后打印提示，3=开启+不自动在订单尾部添加提示+在用户操作后打印提示，4=开启+不自动在订单尾部添加提示+不在用户操作后打印提示；sound_time：超时时长，值为(00000~99999)秒，务必5位长度，不足前置0补齐；timeout_state：超时状态，值为(0、1、2)，0=超时自动上报0，1=超时自动上报1，2=超时不自动上报；注：单击左键与单击右键上报，左键上报内容为0，右键上报内容为1</td> <td>✔</td> <td>×</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>设置自定义订单上报</td> <td><MR>confirm_state,response_url,sound_time,timeout_state</MR></td> <td>指令放在订单开头；confirm_state：订单确认状态，值为(0、1、2、3、4)，0=关闭，1=开启+自动在订单尾部添加提示+在用户操作后打印提示，2=开启+自动在订单尾部添加提示+不在用户操作后打印提示，3=开启+不自动在订单尾部添加提示+在用户操作后打印提示，4=开启+不自动在订单尾部添加提示+不在用户操作后打印提示；response_url：接收推送数据的地址(以http://或https://开头)；sound_time：超时时长，值为(00000~99999)秒，务必5位长度，不足前置0补齐;timeout_state：超时状态，值为(0、1、2)，0=超时自动上报0，1=超时自动上报1，2：超时不自动上报；注：单击左键与单击右键上报，左键上报内容为0，右键上报内容为1</td> <td>✔</td> <td>×</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>设置订单多联打印</td> <td><MN>n</MN></td> <td>指令放在订单开头；n=(1~9)，打印联数</td> <td>✔</td> <td>×</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>设置订单多联打印(新增)</td> <td><MN2>n</MN2></td> <td>指令放在订单开头；n=(001~999)，打印联数。K4、K6机型固件版本a8.6.0及以上，K8机型都支持</td> <td>✔</td> <td>×</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>✔</td> </tr> <tr> <td>设置打印宽度</td> <td><PW>print_width</PW></td> <td>指令放在订单开头；print_width：打印宽度，单位mm，值为(003~108)，务必3位长度，不足前置0补齐，默认值为048</td> <td>×</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> </tr> <tr> <td>设置LOGO打印开关(新增)</td> <td><ML>logo_state</ML></td> <td>指令放在订单开头；logo_state：LOGO打印开关，值为(0、1)，0=关闭，1=开启</td> <td>✔</td> <td>×</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>设置按键打印开关(新增)</td> <td><MP>key_print_state</MP></td> <td>指令放在订单开头；key_print_state：按键打印开关，值为(0、1)，0=关闭，1=开启</td> <td>✔</td> <td>×</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>设置自动切刀订单打印结束的切纸方式(新增)</td> <td><MK>cut_state</MK></td> <td>指令放在订单开头；cut_state：切纸方式，值为(0~3)，0：不切，1=半切，2=全切，3=全切(默认值)</td> <td>×</td> <td>×</td> <td>×</td> <td>✔</td> <td>✔</td> <td>×</td> <td>×</td> </tr> <tr> <td>设置行距(新增)</td> <td><RS>row_spacing</RS></td> <td>指令放在订单开头；row_spacing：行距，值为(00~99)，务必2位长度，不足前置0补齐，默认值为04</td> <td>✔</td> <td>×</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>设置打印高度和方向(新增)</td> <td><PH>print_height,print_direction</PH></td> <td>指令放在订单开头；print_height：间隔纸高度，单位mm，值为(030~999)，务必3位长度，不足前置0补齐；print_direction：打印方向，值为(0、1)</td> <td>×</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> </tr> <tr> <td>设置钱箱(新增)</td> <td><MB>cash_box_state</MB></td> <td>指令放在订单开头；cash_box_state：开钱箱方式，值为(0~2)，0：不开钱箱，1=打印后开钱箱(默认值)，2=打印前开钱箱</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> <td>✔</td> <td>×</td> <td>×</td> </tr> <tr> <td>EAN13条形码</td> <td> str</td> <td>str：EAN13条形码内容，13位数字，中文或其他字符无效，数据不足13位自动补0，补齐13位</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>Code128B条形码</td> <td><BR2>str</BR2></td> <td>str：Code128B条形码内容，支持数字、字母和特殊字符，中文或其他字符无效；注：58mm打印宽度打印机支持14位以内字符长度，72mm打印宽度打印机支持23位以内字符长度</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>Code128C条形码</td> <td><BR3>str</BR3></td> <td>str：Code128C条形码内容，支持数字，字母和特殊字符、中文或其他字符无效；注：58mm打印宽度打印机支持25位以内奇数字符长度和28位以内偶数字符长度，72mm打印宽度打印机支持43位以内奇数字符长度和46位以内偶数字符长度</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>二维码</td> <td><QR>str</QR></td> <td>str：二维码内容，内容不超过192个英文字符或96个中文字符；注：请对应着“打印机主要功能说明文档”查看指令使用注意事项</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体加粗</td> <td><FB>str</FB></td> <td>str：加粗内容，整个字符串有效</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体(中文高32*宽24，英文高32*宽12)</td> <td><FH>str</FH></td> <td>str：加高内容，整个字符串有效，一行最多打印16个中文或者32个英文</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体(中文高24*宽32，英文高24*宽16)</td> <td><FW>str</FW></td> <td>str：加宽内容，整个字符串有效，一行最多打印12个中文或者24个英文</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体(中文高48*宽24，英文高48*宽12)</td> <td><FH2>str</FH2></td> <td>str：加高内容，整个字符串有效，一行最多打印16个中文或者32个英文</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体(中文高24*宽48，英文高24*宽24)</td> <td><FW2>str</FW2></td> <td>str：加宽内容，整个字符串有效，一行最多打印8个中文或者16个英文</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体反色</td> <td><FI>str</FI></td> <td>str：反色内容，整个字符串有效</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> <td>✔</td> </tr> <tr> <td>双色打印</td> <td><PC>print_color</PC></td> <td>print_color:值为(0、1、2、3)，0:同行异色模式-黑色，1:同行异色模式-红色或其他非黑颜色，2:同行同色模式-黑色，3:同行同色模式-红色或其他非黑颜色</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> <td>✔</td> </tr> <tr> <td>字体(中文高32*宽32，英文高32*宽16)</td> <td><FS>str</FS></td> <td>str：加大内容，整个字符串有效，一行最多打印12个中文或者24个英文</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体(中文高48*宽48，英文高48*宽24)</td> <td><FS2>str</FS2></td> <td>str：加大内容，整个字符串有效，一行最多打印8个中文或者16个英文</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>制表(转义字符)</td> <td>\t</td> <td>四字符对齐打印</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>换行(转义字符)</td> <td>\r、\n、\r\n</td> <td>换行打印</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>制表(字符串)(新增)</td> <td>\t</td> <td>四字符对齐打印</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>换行(字符串)(新增)</td> <td>\r、\n、\r\n</td> <td>换行打印</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>二维码(新增)</td> <td><QR2>size,str</QR2></td> <td>size：放大倍数，值为(00~18)，务必2位长度，不足前置0补齐，小于04则使用默认值，大于计算的最大放大倍数值则使用计算的最大放大倍数值；str：二维码内容，内容不超过192个英文字符或96个中文字符；注：请对应着“打印机主要功能说明文档”查看指令使用注意事项</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>EAN13条形码(新增)</td> <td><BR4>br_state,br_height,str</BR4></td> <td>br_state：条形码文字内容打印开关，值为(0、1)，0：关闭，1：开启；br_height：条形码高度，值为(00~99)，务必2位长度，不足前置0补齐，00为使用默认值99；str：EAN13条形码内容，13位数字，中文或其他字符无效，数据不足13位自动补0，补齐13位</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>Code128B条形码(新增)</td> <td><BR5>br_state,br_height,str</BR5></td> <td>br_state：条形码文字内容打印开关，值为(0、1)，0=关闭，1=开启；br_height：条形码高度，值为(00~99)，务必2位长度，不足前置0补齐，00为使用默认值99；str：Code128B条形码内容，支持数字、字母和特殊字符，中文或其他字符无效；注：58mm打印宽度打印机支持14位以内字符长度，72mm打印宽度打印机支持23位以内字符长度</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>Code128C条形码(新增)</td> <td><BR6>br_state,br_height,str</BR6></td> <td>br_state：条形码文字内容打印开关，值为(0、1)，0=关闭，1=开启；br_height：条形码高度，值为(00~99)，务必2位长度，不足前置0补齐，00为使用默认值99；str：Code128C条形码内容，只支持数字。字母和特殊字符、中文或其他字符无效；注：58mm打印宽度打印机支持25位以内奇数字符长度和28位以内偶数字符长度，72mm打印宽度打印机支持43位以内奇数字符长度和46位以内偶数字符长度</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>Code128A条形码(新增)</td> <td><BR7>br_state,br_height,str</BR7></td> <td>br_state：条形码文字内容打印开关，值为(0、1)，0=关闭，1=开启；br_height：条形码高度，值为(00~99)，务必2位长度，不足前置0补齐，00为使用默认值99；str：CODE128A条形码内容，支持数字、大写字母、控制符和特殊字符，中文或其他字符无效；注：58mm打印宽度打印机支持14位以内字符长度，72mm打印宽度打印机支持23位以内字符长度</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>Code128AUTO条形码(新增)</td> <td><BR8>br_state,br_height,str</BR8></td> <td>br_state：条形码文字内容打印开关，值为(0、1)，0=关闭，1=开启；br_height：条形码高度，值为(00~99)，务必2位长度，不足前置0补齐，00为使用默认值99；str：CODE128条形码内容</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>位图打印(新增)</td> <td><BMP>base64_str</BMP></td> <td>base64_str：BMP单色位图文件数据的BSAE64编码字符串注：最终的订单数据大小不能超过数据接收缓存大小</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>位图设置打印(固件版本a7.1.2新增)</td> <td><BMP2>bmp_num,base64_str</BMP2></td> <td>bmp_num：位图编号；BMP单色位图文件数据的BSAE64编码字符串；该指令会把位图固化到打印机中，当base64_str为NULL时，直接打印先前设置的位图，比如<BMP2>0,NULL</BMP2>打印设置的编号0的位图；注：最终的订单数据大小不能超过数据接收缓存大小</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>自动切刀立即切纸(新增)</td> <td><MK2>cut_state</MK2></td> <td>cut_state：切纸方式，值为(0~3)，0=不切，1=半切，2=全切，3=全切</td> <td>×</td> <td>×</td> <td>×</td> <td>✔</td> <td>✔</td> <td>×</td> <td>×</td> </tr> <tr> <td>走纸到下一张间隔纸打印位置(新增)</td> <td><MF>form_feed_state</MF></td> <td>form_feed_state：走纸到下一张间隔纸打印位置，值为(0、1)，1=走纸到下一张间隔纸打印位置；注：一个订单内最多使用99次</td> <td>×</td> <td>✔</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> <td>×</td> </tr> <tr> <td>字体(中文高64*宽64，英文高64*宽32)(新增)</td> <td><FS3>str</FS3></td> <td>str：加大内容，整个字符串有效，一行最多打印6个中文或者12个英文</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体(中文高96*宽96，英文高96*宽48)(新增)</td> <td><FS4>str</FS4></td> <td>str：加大内容，整个字符串有效，一行最多打印4个中文或者8个英文</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体(中文高128*宽128，英文高128*宽64)(新增)</td> <td><FS5>str</FS5></td> <td>str：加大内容，整个字符串有效，一行最多打印3个中文或者6个英文</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体(中文高192*宽192，英文高192*宽96)(新增)</td> <td><FS6>str</FS6></td> <td>str：加大内容，整个字符串有效，一行最多打印2个中文或者4个英文</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体(中文高384*宽384，英文高384*宽192)(新增)</td> <td><FS7>str</FS7></td> <td>str：加大内容，整个字符串有效，一行最多打印1个中文或者2个英文</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>居中对齐(新增)</td> <td><CA>str</CA></td> <td>str：居中对齐的内容</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>左右对齐(新增)</td> <td><LR2>lstr,rstr</LR2></td> <td>lstr：居左的内容；rstr：居右的内容</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>右对齐(新增)</td> <td><RA>str</RA></td> <td>str：右对齐的内容</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>居中对齐</td> <td><center>str</center></td> <td>str：居中对齐的内容；注意：单次打印只解析25次</td> <td>✔</td> <td>×</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>左右对齐</td> <td><LR>lstr,rstr</LR></td> <td>lstr：居左的内容；rstr：居右的内容；注意：单次打印只解析25次</td> <td>✔</td> <td>×</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>右对齐</td> <td><right>str</right></td> <td>str：右对齐的内容；注意：单次打印只解析25次</td> <td>✔</td> <td>×</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>行绝对打印位置</td> <td><AP>absolute_position</AP></td> <td>absolute_position：位置，值为（000-383）,固定3位长度，前置0补齐；一行三列排版示例：<AP>000</AP>列1<AP>192</AP>列2<RA>列3</RA></td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>一行三列或四列排版</td> <td><table><tr><td>列1</td><td>列2</td><td>列3</td><td>列4</td></tr></table></td> <td><table>&lt/table>：表示表格；<tr>&lt/tr>：表示行，一个table可以有多行；<td>&lt/td>：表示列，每行有且只有三个列或四个列；注意：单次打印只解析25次，<table&gt&lt/table>中的<tr&gt&lt/tr>未被限制，可做循环处理。该标签中不允许出现换行符，其它符号，否则无法准确排版</td> <td>✔</td> <td>×</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>设置订单多联打印</td> <td>**n</td> <td>注意：推荐使用<MN></MN>指令</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>字体加高4/3倍+字体加粗</td> <td>@@2</td> <td>注意：推荐使用<FS></FS>指令</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>EAN13条形码</td> <td>str</td> <td>注意：推荐使用 指令</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> <tr> <td>二维码</td> <td><q>str</q></td> <td>注意：推荐使用<QR></QR>指令</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> <td>✔</td> </tr> </tbody> </table>