发送打印数据
<p><strong>简要描述：</strong> </p>
<ul>
<li>发送打印数据</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://my.feyin.net/api/sendMsg</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>发送打印数据的飞印API请求以及参数请使用 HTTP POST 方法发送，飞印API将根据收到的信息验证请求的有效性反馈对应的状态码。</li>
</ul>
<p><strong>支持的打印格式：</strong></p>
<p>通过飞印API发送的信息内容支持2种格式：</p>
<ol>
<li>自由格式（自定义格式）的文本信息，需根据业务需要自行调整打印输出格式</li>
<li>格式化信息（例如客户订单）</li>
</ol>
<p>如果选择格式化信息，您必须根据飞印中心或 飞印API集成示例代码 提供的例子来需要打印输出的数据和格式。</p>
<p><strong>参数：</strong> </p>
<p>发送打印数据的飞印请求必须包含以下参数，每个有效的飞印API请求必须包含必填参数：</p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">规约</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">reqTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">请求（发生）时间戳，数值型</td>
<td>本次API请求发生的时刻，值为自 1970-1-1 0:0 到现在的 毫秒数 类似于Java语言中的 <code>System.currentTimeMillis()</code> 函数的取值。</td>
</tr>
<tr>
<td style="text-align: left;">securityCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">安全校验码，字符串</td>
<td>调用飞印API的网站/应用系统用 API_KEY 针对请求内容生成的MD5哈希字串，此字串将被飞印API用于请求有效性的验证。 请参考 使用前的准备 了解如何获取 API_KEY 。</td>
</tr>
<tr>
<td style="text-align: left;">memberCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户编码，数值型</td>
<td>您在 飞印中心 注册的帐号对应的（系统自动生成的）商户编码，可登录飞印中心按指引获取。</td>
</tr>
<tr>
<td style="text-align: left;">deviceNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">飞印打印机的设备编码，字符串</td>
<td>打印请求将发送到对应此设备编码的飞印无线打印机。可在 飞印中心 “我的终端”中获取已注册到飞印中心的飞印打印机设备编码，也可通过以下方式直接从打印机本身获取：按一下通电中的飞印打印机背面黑色小按钮，即可打印出一张测试页面，其中包含本机设备编码。</td>
</tr>
<tr>
<td style="text-align: left;">mode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">发送打印信息的格式类型，数值型</td>
<td>1 表示格式化信息，2 表示自由格式（自定义格式）信息。这种方法方便您灵活配置和测试打印信息格式，开发时建议通过一台测试机测试实际打印效果，直到获得满意的输出信息格式化效果。</td>
</tr>
<tr>
<td style="text-align: left;">msgDetail</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">打印的数据/信息内容，字符串</td>
<td>对于 <code>mode=1</code> 的信息，打印输出的数据将按表格下方备注方式排版，当 <code>mode=2</code> 时，用户可自由设置打印格式，空行或空格等全部由调用程序自行控制。</td>
</tr>
<tr>
<td style="text-align: left;">charge</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">订单总金额，数值型</td>
<td>以 “分” 计算的金额，例如：1元 = 100分。只用于发送格式化信息（ mode=1 时）。</td>
</tr>
<tr>
<td style="text-align: left;">customerName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">客户名称，字符串</td>
<td>只用于发送格式化信息（ mode=1 时）。</td>
</tr>
<tr>
<td style="text-align: left;">customerPhone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">客户联系人电话，字符串</td>
<td>只用于发送格式化信息（ mode=1 时）。</td>
</tr>
<tr>
<td style="text-align: left;">customerAddress</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">客户地址，字符串</td>
<td>只用于发送格式化信息（ mode=1 时）。</td>
</tr>
<tr>
<td style="text-align: left;">customerMemo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">客户留言/备注，字符串</td>
<td>只用于发送格式化信息（ mode=1 时）。</td>
</tr>
<tr>
<td style="text-align: left;">msgNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">信息/订单编号，字符串</td>
<td>自定义的打印信息编号，可选，不可重复，一般由调用网站/应用系统自动生成，用于跟踪订单。如果没有设置，飞印API将给每个打印请求自动分配一个。（每个用户域独立）</td>
</tr>
</tbody>
</table>
<p>备注：对于 mode=1 的信息，打印输出的数据将按以下方式排版:</p>
<pre><code class="language-php"> 订单项名称 1@单价 1@数量 1 ||
订单项名称 2@单价 2@数量 2 ||
......||
订单项名称 x@单价 N@数量 N</code></pre>
<p><strong>返回状态码说明</strong> </p>
<p>飞印API的打印数据请求的返回信息包含2类：</p>
<ol>
<li>以整型表示的状态码，表示请求的处理结果</li>
<li>XML格式的字符串信息，表示请求的返回内容/信息</li>
</ol>
<p>飞印API将对每个打印请求返回一个状态码。它们的含义如下：</p>
<table>
<thead>
<tr>
<th style="text-align: left;">返回值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">0</td>
<td>正常</td>
</tr>
<tr>
<td style="text-align: left;">-1</td>
<td>IP地址不允许</td>
</tr>
<tr>
<td style="text-align: left;">-2</td>
<td>关键参数为空或请求方式不对</td>
</tr>
<tr>
<td style="text-align: left;">-3</td>
<td>客户编码不对</td>
</tr>
<tr>
<td style="text-align: left;">-4</td>
<td>安全校验码不正确</td>
</tr>
<tr>
<td style="text-align: left;">-5</td>
<td>请求时间失效</td>
</tr>
<tr>
<td style="text-align: left;">-6</td>
<td>订单内容格式不对</td>
</tr>
<tr>
<td style="text-align: left;">-7</td>
<td>重复的消息 （ msgNo 的值重复）</td>
</tr>
<tr>
<td style="text-align: left;">-8</td>
<td>消息模式不对</td>
</tr>
<tr>
<td style="text-align: left;">-9</td>
<td>服务器错误</td>
</tr>
<tr>
<td style="text-align: left;">-10</td>
<td>服务器内部错误</td>
</tr>
<tr>
<td style="text-align: left;">-111</td>
<td>打印终端不属于该账户</td>
</tr>
<tr>
<td style="text-align: left;">-112</td>
<td>设备服务期已过期，请在飞印公众号中续费（针对2017年之后的新机型）</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>更多例子请看飞印官网的实例代码描述</li>
</ul>