文档
测试

打印小票【必接】

POST
printreceipt

请求参数

参数名
类型
描述
必填
appid
String
应用 ID
必填
sn
String
打印机编号
必填
content
text
小票打印内容,详见格式说明
必填
copy
int
打印份数
必填

响应参数

参数名
类型
描述
必填
code
int
错误码,成功返回 200
必填
message
String
错误描述
必填
data
Object
对象,业务数据
可选
appid
String
应用 ID
必填
sn
String
打印机编号
必填
ord_id
String
打印单据号
必填
received_time
String
打印机接收成功时间,yyyy-MM-dd HH:mm:ss,是否成功,可调用查询打印状态接口查询 打印结果;接收失败不返回(如打印机离线,超时)。
可选

说明 / 示例

### 排版控制标签说明 - #### 字体控制标签 ``` <B></B>:字体加粗 <H2></H2>:字体倍高 <W2></W2>:字体倍宽 <WH2></WH2>:字体倍高倍宽(放大一倍) <BH2></BH2>:字体倍高,加粗 <BW2></BW2>:字体倍宽,加粗 <B2></B2>:字体倍高倍宽(放大一倍),加粗 <CODE128></CODE128>:条码,code128码 <CODE39></CODE39>:条码,code39码 <EAN13></EAN13>:条码,EAN13码 <QR></QR>:二维码(一个订单,最多只能打印一个二维码) 注:条码与二维码是一种特殊的字体控制标签 ``` - #### 位置控制标签 ``` <BR> :换行符 <C></C>:居中 <R></R>:右对齐 ``` ### 说明 - 打印内容中有出现 <>/三个字符的,需要转义。 - 控制标签如有嵌套,位置标签在外层,字体在内层,如**加粗居中**: ``` <C><B>加粗居中</B></C> ``` - 同类控制标签不可以嵌套。 - 最多两层嵌套,即外层位置控制标签内层字体控制标签。 --- ### 请求示例 JSON ``` { "version":"1.0", "charset": "UTF-8", "nonce_str": "zRVPpgdLEPXwRrRx", "timestamp":"1607479186", "sign_type":"MD5", "sign": "FB5C12416C3A5854A72C52321C223FE7", "appid":"jp7d283754d75b1d88", "sn":"Prn3A3FADD13002", "content": "<C><B2>****#001****</B2></C><BR><C><B>(堂食)</B></C><BR>................................<BR><C><B>大众饭堂</B></C><BR>下单时间:2020-12-25 15:29:28<BR>订单编号:160888136999516832<BR>................................<BR>价格 数量 金额<BR><H2>1.一分测试</H2><BR><H2>0.01 x1 0.01</H2><BR>................................<BR><H2>合计金额: 0.01</H2><BR>................................<BR><C><B2>****#001****</B2></C><BR><C><QR>https://m.poslite.cn/dc/shop.html?appid=jb25112e65f20e7dfe</QR></C><BR><C>点餐请扫码</C><BR>", "copy":1 } ``` ### 返回示例 #### 成功返回 JSON ``` { "code": 200, "message": "success", "data": { "appid": "jp7d283754d75b1d88", "sn": "SN1234", "ord_id": "1608880332512", "send_time": "2020-12-28 14:03:25" } } ``` 有 send_time 返回,表示打印任务已发送;==是否打印成功,需要调用打印状态查询接口查询== 没有 send_time 返回,表示打印任务发送失败 #### 失败返回 JSON ``` { "code": 5004, "message": "business.error.printer.sn.notAdded" } ``` 打印机未添加