API开发文档

 
 
接口1:打印内容
参数 说明
deviceNo 打印机编号
key 密钥
printContent 打印内容
times 固定传1
调用方式:HTTP POST
URL:http://open.printcenter.cn:8080/addOrder
返回结果:JSON字符串
----------S1小票机返回的结果有如下几种:---------- {"responseCode":0,"msg":"订单添加成功,打印完成","orderindex":"xxxxxxxxxxxxxxxxxx"} {"responseCode":1,"msg":"订单添加成功,正在打印中","orderindex":"xxxxxxxxxxxxxxxxxx"} {"responseCode":2,"msg":"订单添加成功,但是打印机缺纸,无法打印","orderindex":"xxxxxxxxxxxxxxxxxx"} {"responseCode":3,"msg":"订单添加成功,但是打印机不在线","orderindex":"xxxxxxxxxxxxxxxxxx"} ----------以上情况无须再次发送订单;下面的情况需要进行错误处理---------- {"responseCode":10,"msg":"内部服务器错误;"} {"responseCode":11,"msg":"参数不正确;"} {"responseCode":12,"msg":"打印机未添加到服务器;"} {"responseCode":13,"msg":"未添加为订单服务器;"} {"responseCode":14,"msg":"订单服务器和打印机不在同一个组;"} {"responseCode":15,"msg":"订单已经存在,不能再次打印;"}


----------USB小票机返回的结果有如下几种:---------- {"responseCode":0,"msg":"已加入打印队列"} {"responseCode":2,"msg":"服务器处理订单失败"}




接口2:查询订单是否打印成功
参数 说明
deviceNo 打印机编号
key 密钥
orderindex 订单索引(orderindex,该值由接口一返回)
调用方式:HTTP POST
URL:http://open.printcenter.cn:8080/queryOrder
返回结果:JSON字符串
----------S1小票机返回的结果有如下几种:---------- {"responseCode":0,"msg":"打印成功"} {"responseCode":1,"msg":"正在打印中"} {"responseCode":2,"msg":"打印机缺纸"} {"responseCode":3,"msg":"打印机下线"} {"responseCode":16,"msg":"订单不存在"}




接口3:查询打印机的状态
参数 说明
deviceNo 打印机编号
key 打印密钥
调用方式:HTTP POST
URL:http://open.printcenter.cn:8080/queryPrinterStatus
返回结果:JSON字符串
----------S1小票机返回的结果有如下几种:---------- {"responseCode":1,"msg":"打印机正常在线"} {"responseCode":2,"msg":"打印机缺纸"} {"responseCode":3,"msg":"打印机下线"}



代码示例

 

php
header("Content-Type: text/html;charset=utf-8");
$DEVICE_NO = '123458615';
$key = '72264';
$content = "^N1^F1\n";
$content .= "^B2 测试打印\n";
$content .= "名称      单价  数量 金额\n";
$content .= "--------------------------------\n";
$content .= "饭       1.0    1   1.0\n";
$content .= "炒饭      10.0   10  10.0\n";
$content .= "蛋炒饭     10.0   10  100.0\n";
$content .= "鸡蛋炒饭    100.0  1   100.0\n";
$content .= "番茄蛋炒饭   1000.0 1   100.0\n";
$content .= "西红柿蛋炒饭  1000.0 1   100.0\n";
$content .= "西红柿鸡蛋炒饭 100.0  10  100.0\n";
$content .= "备注:加辣\n";
$content .= "--------------------------------\n";
$content .= "^H2合计:xx.0元\n";
$content .= "^H2送货地点:广州市南沙区xx路xx号\n";
$content .= "^H2联系电话:13888888888888\n";
$content .= "^H2订餐时间:2014-08-08 08:08:08\n";
$qrlength=chr(strlen('http://www.dzist.com'));
$content .= "^Q".$qrlength."http://www.dzist.com\n";
$result = sendSelfFormatOrderInfo($DEVICE_NO, $key, 1,$content);
var_dump($result);
function sendSelfFormatOrderInfo($device_no,$key,$times,$orderInfo){ // $times打印次数
    $selfMessage = array(
        'deviceNo'=>$device_no,  
        'printContent'=>$orderInfo,
        'key'=>$key,
        'times'=>$times
    );                
    $url = "http://open.printcenter.cn:8080/addOrder";
    $options = array(
        'http' => array(
            'header' => "Content-type: application/x-www-form-urlencoded ",
            'method'  => 'POST',
            'content' => http_build_query($selfMessage),
        ),
    );
    $context  = stream_context_create($options);
    $result = file_get_contents($url, false, $context);
    
    return $result;
}

?>

 

打印机基本指令

S1小票机2.0以上版本适用

一、字体放大

命令^Nn:

该命令位于所有数据前面,用于控制打印张数,可以不加,不加默认打一张。

例如:

^N5

打印机打印测试

Print order data

****************

表示打印 5 张相同订单。

 

 

命令^Hn

该命令位于每行数据首位,用于控制此行字体纵向放大 n 倍,可以不加,不加默认不放大。

例如:

^H2 放大 2 倍

此时“放大 2 倍”这几个字会纵向放大 2 倍,效果见下图。

注意:正常大小的字体,每行最多可以打 16 个汉字或 32 个英文或数字,如果每行超过最大字数限制,会出现多出的字覆盖这行最开始的字,导致看起来乱码,所以使用该命令请确保字数在每行最大字数内,如果超过,请手动回车换行。

 

 

命令^Wn

该命令位于每行数据首位,用于控制此行字体横向放大 n 倍,可以不加,不加默认不放大。

例如:

^W2 放大 2 倍

此时“放大 2 倍”这几个字会横向放大 2 倍,效果见下图。

注意:正常大小的字体,每行最多可以打 16 个汉字或 32 个英文或数字,由于^Wn 命令会横向放大 n 倍,如果每行超过(最大字数/n)限制,会出现多出的字覆盖这行最开始的字,导致看起来乱码,所以使用该命令请确保字数在每行字数在(最大字数/n)内,如果超过,请手动回车换行。如^W4 测试打印机放大,共 7 个汉字,放大后会占用 28 个汉字的位置,已经超过每行最多 16 个汉字。

 

 

命令^Bn

该命令位于每行数据首位,用于控制此行字体横向纵向同时放大 n 倍,可以不加,不加默认不放大。

例如:

^B2 放大 2 倍

此时“放大 2 倍”这几个字会横向纵向同时放大 2 倍,效果见下图。

注意:正常大小的字体,每行最多可以打 16 个汉字或 32 个英文或数字,由于^Bn 命令会横向纵向同时放大 n 倍,如果每行超过(最大字数/n)限制,会出现多出的字覆盖这行最开始的字,导致看起来乱码,所以使用该命令请确保字数在每行字数在(最大字数/n)内,如果超过,请手动回车换行。如 ^B3 测试打印机放大,共 7 个汉字,放大后会占用 21 个汉字的位置,已经超过每行最多 16 个汉字。

 

 

效果图:

 

 

命令^Qn

该命令位于需要打印的宣传关注二维码链接首位,用于将链接自动转换成二维码,达到宣传关注的目的。n 的值为二维码链接的字符长度,用 ASCII 编码表示。此命令,可以不加,不加默认不打。

例如:

^Q +http://weixin.qq.com/r/2Eg2LkzEKRFWrQhN9123

此时 http://weixin.qq.com/r/2Eg2LkzEKRFWrQhN9123 的长度为 43,对应 ASCII 值是’+’,计算机可以自动计算长度,这里为了描述清晰,查出 43 对应的 ASCII 字符。此链接经过转换后的二维码效果见下图。

注意:此二维码最多支持 49 个字符,请不要加入中文。打印机会自动更具字符多少转换成大小不一样的二维码,智能打印在打印纸中间。使用最为广泛的就是微信公众号的关注二维码。

 

 

命令^Pn

该命令位于需要打印的动态支付二维码链接首位,用于将链接自动转换成二维码,达到支付宝等支付的目的(支付成功后,此二维码失效,即:扫描第二次不起作用)。n 的值为二维码链接的长度,用 ASCII 编码表示。此命令,可以不加,不加默认不打。

例如:

^P(https://qr.alipay.com/pmr1bs2a1i1udbumf7

此时“https://qr.alipay.com/pmr1bs2a1i1udbumf7”的长度为 40,对应 ASCII 值是’(’,计算机可以自动计算长度,这里为了描述清晰,查出 40 对应的 ASCII 字符。此链接经过转换后的支付二维码效果见下图。

注意:此动态支付二维码最多支持 49 个字符,请不要加入中文。打印机会自动更具字符多少转换成大小不一样的二维码,智能打印在打印纸中间。使用最为广泛的就是外卖或用餐结束后,结账时无需再使用现金或者刷卡浪费时间,直接使用支付宝扫描,输入密码支付完成即可,效率将非常高。

 

 

命令^On

该命令位于需要打印的动态条码(一维码)链接首位,用于将链接自动转换成扫描枪扫描的一维码,达到迅速录入的目的。n 的值为一维码的长度,用

ASCII 编码表示。此命令,可以不加,不加默认不打。

例如:

^P test12345

此时“test12345”的长度为 9,对应 ASCII 值是’ ’(水平制表符),计算机可以自动计算长度,这里为了描述清晰,查出 9 对应的 ASCII 字符。此条码转换后的效果见下图。

注意:此动态条码最多支持 13 个字符,请不要加入中文。打印机会自动更具字符多少转换成大小不一样的条码,智能打印在打印纸中间。使用最为广泛的就是物流、仓库和超市等地方,达到迅速录入或查找等应用。