订单命令
<p>[TOC]</p>
<table>
<thead>
<tr>
<th>4G喇叭</th>
<th>4G开关</th>
<th>WiFi喇叭</th>
<th>WiFi开关</th>
</tr>
</thead>
<tbody>
<tr>
<td><font color="red"><strong>&times;</strong></font></td>
<td><font color="green"><strong>&radic;</strong></font></td>
<td><font color="red"><strong>&times;</strong></font></td>
<td><font color="green"><strong>&radic;</strong></font></td>
</tr>
</tbody>
</table>
<p>支持此功能的设备类型:<font color="green"><strong>&radic;</strong></font>-支持 <font color="red"><strong>&times;</strong></font>-不支持</p>
<h2>订单任务说明</h2>
<p>开关设备每个插槽可以启动一个订单任务,订单任务可以是计时、计量,remark可以用来记录订单编号,作为唯一标识。
订单开始会打开插槽开关,订单结束后会自动关闭插槽开关。
订单状态可以用getDevStatus命令获取。
订单结束后会主动上报getDevStatus应答和orderUp应答(orderUp WiFi开关暂不支持)。</p>
<h2>启动订单任务(start)</h2>
<p><strong>简要描述</strong>
启动订单任务。
<strong>特别注意,使用此功能命令时,会与实时开关命令,订单任务相关命令相冲突,必须关闭其任务后,独立启动该任务</strong></p>
<p><strong>命令参数</strong></p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必须</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>method</td>
<td>是</td>
<td>string</td>
<td>start</td>
</tr>
<tr>
<td>slotNum</td>
<td>是</td>
<td>int</td>
<td>插槽编号,从1开始</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>string</td>
<td>订单类型,TIME-计时;POWER-计量</td>
</tr>
<tr>
<td>timeSec</td>
<td>是</td>
<td>int</td>
<td>计时秒数。该参数在type为TIME时有效</td>
</tr>
<tr>
<td>powerKwh</td>
<td>是</td>
<td>double</td>
<td>计量电量,单位度。该参数在type为POWER时有效</td>
</tr>
<tr>
<td>powerMaxSec</td>
<td>是</td>
<td>int</td>
<td>计量最大秒数,总运行秒数到达计量最大秒数,任务停止。0为不限制。该参数在type为POWER时有效</td>
</tr>
<tr>
<td>maxPower</td>
<td>是</td>
<td>int</td>
<td>最大功率,单位W。超过最大功率,任务自动停止。0为使用设备默认值1400(不同设备有不同默认值)</td>
</tr>
<tr>
<td>pullOutStop</td>
<td>是</td>
<td>bool</td>
<td>拔出自停。true-启用;false-禁用</td>
</tr>
<tr>
<td>pullOutStopPower</td>
<td>是</td>
<td>int</td>
<td>拔出自停功率,在拔出自停启用,且当前功率小于拔出自停功率时,任务自动停止。0为使用设备默认拔出自停功率3(不同设备有不同默认值)</td>
</tr>
<tr>
<td>pullOutStopStartSec</td>
<td>是</td>
<td>int</td>
<td>订单启动后拔出自停开始判断秒数,默认0秒</td>
</tr>
<tr>
<td>chargeFullStop</td>
<td>是</td>
<td>bool</td>
<td>充满自停。true-启用;false-禁用</td>
</tr>
<tr>
<td>chargeFullStopPower</td>
<td>是</td>
<td>int</td>
<td>充满自停功率。0为使用设备默认值5(不同设备有不同默认值)</td>
</tr>
<tr>
<td>chageFullStopSec</td>
<td>是</td>
<td>int</td>
<td>充满自停秒数,在充满自停启用,且当前功率小于充满自停功率并持续充满自停秒数后,任务自动停止。0为使用设备默认值60(不同设备有不同默认值)</td>
</tr>
<tr>
<td>chargeFullStopStartSec</td>
<td>是</td>
<td>int</td>
<td>订单启动后充满自停开始判断秒数,默认0秒</td>
</tr>
<tr>
<td>remark</td>
<td>否</td>
<td>string</td>
<td>订单备注,启动订单时传入,可用于记录订单编号</td>
</tr>
<tr>
<td>frameId</td>
<td>否</td>
<td>string</td>
<td>帧ID</td>
</tr>
</tbody>
</table>
<p><strong>命令示例</strong></p>
<pre><code> {
&quot;method&quot;: &quot;start&quot;,
&quot;slotNum&quot;: 1,
&quot;type&quot;: &quot;TIME&quot;,
&quot;maxPower&quot;: 2000,
&quot;pullOutStop&quot;: false,
&quot;pullOutStopPower&quot;: 5,
&quot;pullOutStopStartSec&quot;: 0,
&quot;chargeFullStop&quot;: false,
&quot;chargeFullStopPower&quot;: 10,
&quot;chargeFullStopSec&quot;: 60,
&quot;chargeFullStopStartSec&quot;: 0,
&quot;remark&quot;: &quot;12332123&quot;,
&quot;timeSec&quot;: 600,
&quot;frameId&quot;: &quot;1745462466369&quot;
}</code></pre>
<p><strong>应答参数说明</strong></p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>method</td>
<td>string</td>
<td>getSimCheck</td>
</tr>
<tr>
<td>result</td>
<td>string</td>
<td>返回结果。ok-成功;其他-具体失败原因</td>
</tr>
<tr>
<td>slotNum</td>
<td>int</td>
<td>插槽编号,从1开始</td>
</tr>
<tr>
<td>remark</td>
<td>string</td>
<td>订单备注,启动订单时传入,可用于记录订单编号</td>
</tr>
<tr>
<td>imei</td>
<td>string</td>
<td>设备imei</td>
</tr>
<tr>
<td>frameId</td>
<td>string</td>
<td>同命令frameId</td>
</tr>
<tr>
<td>timestamp</td>
<td>int</td>
<td>秒级时间戳,WiFi款不支持</td>
</tr>
</tbody>
</table>
<p><strong>应答示例</strong></p>
<pre><code>{
&quot;timestamp&quot;: 1745462466,
&quot;imei&quot;: &quot;864536072949900&quot;,
&quot;remark&quot;: &quot;12332123&quot;,
&quot;method&quot;: &quot;start&quot;,
&quot;slotNum&quot;: 1,
&quot;result&quot;: &quot;ok&quot;,
&quot;frameId&quot;: &quot;1745462466369&quot;
}</code></pre>
<p><strong>备注</strong>
无</p>
<h2>结束订单任务(stop)</h2>
<p><strong>简要描述</strong>
结束订单任务。</p>
<p><strong>命令参数</strong></p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必须</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>method</td>
<td>是</td>
<td>string</td>
<td>stop</td>
</tr>
<tr>
<td>slotNum</td>
<td>是</td>
<td>int</td>
<td>插槽编号,从1开始</td>
</tr>
<tr>
<td>frameId</td>
<td>否</td>
<td>string</td>
<td>帧ID</td>
</tr>
</tbody>
</table>
<p><strong>命令示例</strong></p>
<pre><code>{
&quot;method&quot;: &quot;stop&quot;,
&quot;slotNum&quot;: 1,
&quot;frameId&quot;: &quot;1745456483900&quot;
}</code></pre>
<p><strong>应答参数说明</strong></p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>method</td>
<td>string</td>
<td>stop</td>
</tr>
<tr>
<td>result</td>
<td>string</td>
<td>返回结果。ok-成功;其他-具体失败原因</td>
</tr>
<tr>
<td>slotNum</td>
<td>int</td>
<td>插槽编号,从1开始</td>
</tr>
<tr>
<td>imei</td>
<td>string</td>
<td>设备imei</td>
</tr>
<tr>
<td>frameId</td>
<td>string</td>
<td>同命令frameId</td>
</tr>
<tr>
<td>timestamp</td>
<td>int</td>
<td>秒级时间戳,WiFi款不支持</td>
</tr>
</tbody>
</table>
<p><strong>应答示例</strong></p>
<pre><code>{
&quot;method&quot;: &quot;stop&quot;,
&quot;result&quot;: &quot;ok&quot;,
&quot;slotNum&quot;: 1,
&quot;timestamp&quot;: 1745456483,
&quot;imei&quot;: &quot;864536072949900&quot;,
&quot;frameId&quot;: &quot;1745456483900&quot;
}</code></pre>
<p><strong>备注</strong>
无</p>
<h2>获取订单信息(orderUp)</h2>
<p><strong>简要描述</strong>
获取订单信息。(<strong>WiFi开关暂不支持</strong>)</p>
<p><strong>命令参数</strong></p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必须</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>method</td>
<td>是</td>
<td>string</td>
<td>orderUp</td>
</tr>
<tr>
<td>slotNum</td>
<td>是</td>
<td>int</td>
<td>插槽编号,从1开始</td>
</tr>
<tr>
<td>frameId</td>
<td>否</td>
<td>string</td>
<td>帧ID</td>
</tr>
</tbody>
</table>
<p><strong>命令示例</strong></p>
<pre><code>{
&quot;method&quot;: &quot;orderUp&quot;,
&quot;slotNum&quot;: 1,
&quot;frameId&quot;: &quot;1745456483900&quot;
}</code></pre>
<p><strong>应答参数说明</strong></p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>method</td>
<td>string</td>
<td>orderUp</td>
</tr>
<tr>
<td>result</td>
<td>string</td>
<td>返回结果。ok-成功;其他-具体失败原因</td>
</tr>
<tr>
<td>slotNum</td>
<td>int</td>
<td>插槽编号,从1开始</td>
</tr>
<tr>
<td>type</td>
<td>string</td>
<td>订单类型,TIME-计时;POWER-计量</td>
</tr>
<tr>
<td>status</td>
<td>string</td>
<td>订单状态,idle-空闲/结束;working-进行中</td>
</tr>
<tr>
<td>timeSec</td>
<td>int</td>
<td>计时秒数。该参数在type为TIME时有效</td>
</tr>
<tr>
<td>powerKwh</td>
<td>double</td>
<td>计量电量,单位度。该参数在type为POWER时有效</td>
</tr>
<tr>
<td>powerMaxSec</td>
<td>int</td>
<td>计量最大秒数,总运行秒数到达计量最大秒数,任务停止。0为不限制。该参数在type为POWER时有效</td>
</tr>
<tr>
<td>maxPower</td>
<td>int</td>
<td>最大功率,单位W。超过最大功率,任务自动停止。0为使用设备默认值1400(不同设备有不同默认值)</td>
</tr>
<tr>
<td>pullOutStop</td>
<td>bool</td>
<td>拔出自停。true-启用;false-禁用</td>
</tr>
<tr>
<td>pullOutStopPower</td>
<td>int</td>
<td>拔出自停功率,在拔出自停启用,且当前功率小于拔出自停功率时,任务自动停止。0为使用设备默认拔出自停功率3(不同设备有不同默认值)</td>
</tr>
<tr>
<td>pullOutStopStartSec</td>
<td>int</td>
<td>订单启动后拔出自停开始判断秒数,默认0秒</td>
</tr>
<tr>
<td>chargeFullStop</td>
<td>bool</td>
<td>充满自停。true-启用;false-禁用</td>
</tr>
<tr>
<td>chargeFullStopPower</td>
<td>int</td>
<td>充满自停功率。0为使用设备默认值5(不同设备有不同默认值)</td>
</tr>
<tr>
<td>chageFullStopSec</td>
<td>int</td>
<td>充满自停秒数,在充满自停启用,且当前功率小于充满自停功率并持续充满自停秒数后,任务自动停止。0为使用设备默认值60(不同设备有不同默认值)</td>
</tr>
<tr>
<td>chargeFullStopStartSec</td>
<td>int</td>
<td>订单启动后充满自停开始判断秒数,默认0秒</td>
</tr>
<tr>
<td>remark</td>
<td>string</td>
<td>订单备注,启动订单时传入,可用于记录订单编号</td>
</tr>
<tr>
<td>closeReason</td>
<td>string</td>
<td>关闭原因</td>
</tr>
<tr>
<td>totalSec</td>
<td>int</td>
<td>总运行秒数</td>
</tr>
<tr>
<td>totalKwh</td>
<td>double</td>
<td>总运行度数</td>
</tr>
<tr>
<td>details</td>
<td>array</td>
<td>24小时分时段用电量统计详情。数组长度48,从0时0分开始记录每半小时的用电量统计,单位:度。此命令依赖于实时时间,请使用setTime命令同步终端与服务器的时间</td>
</tr>
<tr>
<td>imei</td>
<td>string</td>
<td>设备imei</td>
</tr>
<tr>
<td>frameId</td>
<td>string</td>
<td>同命令frameId</td>
</tr>
<tr>
<td>timestamp</td>
<td>int</td>
<td>秒级时间戳,WiFi款不支持</td>
</tr>
</tbody>
</table>
<p><strong>应答示例</strong></p>
<pre><code>{
&quot;chargeFullStop&quot;: false,
&quot;closeReason&quot;: &quot;CLOSED&quot;,
&quot;method&quot;: &quot;orderUp&quot;,
&quot;status&quot;: &quot;idle&quot;,
&quot;timestamp&quot;: 1745463066,
&quot;details&quot;: [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
&quot;slotNum&quot;: 1,
&quot;imei&quot;: &quot;864536072949900&quot;,
&quot;frameId&quot;: 1745463065,
&quot;totalKwh&quot;: &quot;0.0000&quot;,
&quot;pullOutStop&quot;: false,
&quot;chargeFullStopSec&quot;: 60,
&quot;type&quot;: &quot;TIME&quot;,
&quot;remark&quot;: &quot;12332123&quot;,
&quot;endTime&quot;: 1745463065,
&quot;result&quot;: &quot;ok&quot;,
&quot;startTime&quot;: 1745462466,
&quot;timeSec&quot;: 600,
&quot;totalSec&quot;: 600,
&quot;pullOutStopStartSec&quot;: 0,
&quot;pullOutStopPower&quot;: 5,
&quot;chargeFullStopStartSec&quot;: 0,
&quot;chargeFullStopPower&quot;: 10,
&quot;maxPower&quot;: 2000
}</code></pre>
<p><strong>备注</strong>
无</p>