开放平台

接口说明：

美达罗捷API平台地址： https://api.bjguntong.com；仅接受https连接方式

在请求头设置数据传输格式为： application/x-www-form-urlencoded

所有请求包含三个固定必传参数：

字段名	说明
mobilePhone	申请AppKey时注册的联系人手机号
timestamp	当前时间戳，以ms为单位
sign	签名(注)

注：

请使用 mobilePhone + apiKey + timestamp 拼接成字符串，然后进行MD5加密。apiKey为商户首次申请注册后由美达罗捷提供的开发者秘钥，用来进行API调用。加密后获得的32位字符串就是sign(签名)。

添加打印机: POST /printer/add

功能描述：

在系统中添加打印机。

添加规则：

拿到打印机后可获得打印机mac,使用mac作为打印机唯一标识对打印机进行注册。添加注册后，打印机接入系统，可以进行打印。

传入参数：

字段名	说明	是否必填
mobilePhone	申请AppKey时注册的联系人手机号	是
timestamp	当前时间戳，以ms为单位	是
sign	签名(注)	是
type	打印机类型：1：wifi打印机；3:4G(gprs)打印机；5:二合一打印机。默认为1。	是
wifiSn	打印机的wifi网卡序列号	否
gprsSn	打印机的4G(gprs)网卡序列号	否
name	打印机名称	是

返回参数：

字段名	类型	说明
code	Integer	返回代码。成功：200。其他是失败。
data	Object	返回内容
macSn	String	生成的打印机mac序列号
success	boolean	是否成功。成功：true，失败:false。
msg	String	返回消息

打印订单内容: POST /order/print

功能描述：

通过格式设定，编辑打印内容，通过打印机进行打印。打印可以设置打印语言为中文或外文，支持多语言打印。可以设置打印订单份数，支持批量打印。对于语音打印机，在每次打印时，会播报语音“您有新的订单”。

传入参数：

字段名	说明	是否必填
mobilePhone	申请AppKey时注册的联系人手机号	是
timestamp	当前时间戳，以ms为单位	是
sign	签名(注)	是
macSn	打印机的mac序列号	是
content	经过排版后的打印内容（字符串）（注）	是
language	打印的语言选择（1：中文；2：外文。默认不填该选项，就是中文）	否
copy	打印份数（默认不填就是1份）	否

打印排版格式说明：

<Content></Content> : 内容根节点，所有打印内容必须包含在<Content>内；

: 新起一行。每行内容需包含在 内；

<CB></CB>: 居中放大；

:字体放大；

<C></C>:居中；

<L></L>:字体变高；

<W></W>:字体变宽；

<RIGHT></RIGHT>：右对齐；

<BOLD></BOLD>:字体加粗；

<QRCODE></QRCODE>:打印二维码；

<CODE128></CODE128>:打印条形码;（采用Code128编码）

打印内容示例：

String test = "<content>";

test += " 这是一个测试";

test += " 中间有字<BOLD>变粗</BOLD>正常";

test += " 这行<CB>是</CB>纯文<RIGHT>字</RIGHT>";

test += " 这行既要变高又变宽，看看效果";

test += “<QRCODE>abcdefghijklmn</QRCODE>”;

test += "</content>";

注意：以下是系统保留字符，如需要在内容中使用，请替换成其他合法字符。

<	小于号
>	大于号
&	和号
'	单引号
"	双引号

返回参数：

字段名	类型	说明
code	Integer	返回代码。成功：200。其他是失败。
data	String	订单ID号
success	boolean	是否成功。成功：true，失败:false。
msg	String	返回消息

取消订单内容: POST /order/cancelPrint

功能描述：

打印客户的取消订单内容

打印规则：

打印取消订单的内容编辑规则与订单打印相同。不同之处在于，对于语音打印机，在每次打印时，会播报语音“您有订单被取消了”。

传入参数：

字段名	说明	是否必填
mobilePhone	申请AppKey时注册的联系人手机号	是
timestamp	当前时间戳，以ms为单位	是
sign	签名(注)	是
macSn	打印机的mac序列号	是
content	经过排版后的打印内容（字符串）（注）	是
language	打印的语言选择（1：中文；2：外文。默认不填该选项，就是中文）	否

返回参数：

字段名	类型	说明
code	Integer	返回代码。成功：200。其他是失败。
data	String	订单ID号
success	boolean	是否成功。成功：true，失败:false。
msg	String	返回消息

获取打印机状态: GET /printer/status

功能描述：

获取打印机当前状态

状态描述：

打印机连上系统后，可能在线，或者关机。根据打印机类型，分为WIFI打印机、4G打印机、二合一打印机，可以返回每一块网卡的是否在线状态。

传入参数：

字段名	说明	是否必填
mobilePhone	申请AppKey时注册的联系人手机号	是
timestamp	当前时间戳，以ms为单位	是
sign	签名(注)	是
macSn	打印机的mac序列号	是

返回参数：

字段名	类型	说明
code	Integer	返回代码。成功：200。其他是失败。
data	String	返回视图类
status	Integer	打印机状态（注）
statusText	String	打印机状态文字说明
success	boolean	是否成功。成功：true，失败:false。
msg	String	返回消息

注：Status说明：

数字代表状态信息：0：打印机离线； 1：打印机wifi在线； 3：打印机gprs（4G）在线；5：打印机wifi 和 gprs（4G）都在线；

获取商户下所有打印机状态: GET /printer/tenantStatus

功能描述：

获取该商户下所有打印机当前状态。

方法说明：

对于在系统中注册的商户（开发者），可以批量获得名下所有连接的打印机，获取打印机状态。

传入参数：

字段名	说明	是否必填
mobilePhone	申请AppKey时注册的联系人手机号	是
timestamp	当前时间戳，以ms为单位	是
sign	签名(注)	是

返回参数：

字段名	类型	说明
code	Integer	返回代码。成功：200。其他是失败。
data	Array	打印机数组
macSn	String	打印机的macSn
status	Integer	打印机状态（注）
statusText	String	打印机状态文字说明
success	boolean	是否成功。成功：true，失败:false。
msg	String	返回消息

注：Status说明：

数字代表状态信息：0：打印机离线； 1：打印机wifi在线； 3：打印机gprs（4G）在线；5：打印机wifi 和 gprs（4G）都在线；

删除打印机: POST /printer/delete

功能描述：

从系统中删除指定打印机。

方法说明：

使用macSn，删除对应的打印机。删除打印机后，打印机从系统中清除。

传入参数：

字段名	说明	是否必填
mobilePhone	申请AppKey时注册的联系人手机号	是
timestamp	当前时间戳，以ms为单位	是
sign	签名(注)	是
macSn	打印机的mac序列号	是

返回参数：

字段名	类型	说明
code	Integer	返回代码。成功：200。其他是失败。
data	Object	返回内容
success	boolean	是否成功。成功：true，失败:false。
msg	String	返回消息