每月汇总
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>每月汇总</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://ip:port/attendance/stat/monthlySummary</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>http GET</li>
</ul>
<h5>请求类型</h5>
<ul>
<li>Content-Type: from-data</li>
</ul>
<h5>参数</h5>
<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;"><del>month</del></td>
<td style="text-align: left;"><del>否</del></td>
<td style="text-align: left;"><del>string</del></td>
<td><del>日期 每月汇总必传</del> (已废弃)</td>
</tr>
<tr>
<td style="text-align: left;">beginTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开始日期 每月汇总必传(默认传当天)</td>
</tr>
<tr>
<td style="text-align: left;">endTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>结束日期 每月汇总必传(默认传当天)</td>
</tr>
<tr>
<td style="text-align: left;">deptId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>部门ID</td>
</tr>
<tr>
<td style="text-align: left;">personName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>人员名称(支持模糊查询)</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>考勤类型</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
&quot;beginTime&quot; : &quot;2023-03-29&quot;,
&quot;endTime&quot; : &quot;2023-03-29&quot;,
&quot;type&quot; : &quot;Late&quot;,
&quot;deptId&quot; : &quot;xxxxx&quot;,
&quot;personName&quot; : &quot;xxxx&quot;
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td>状态码(是否成功)</td>
</tr>
<tr>
<td style="text-align: left;">success</td>
<td style="text-align: left;">boolean</td>
<td>成功标志</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td>返回信息</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">string</td>
<td>时间戳</td>
</tr>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">object</td>
<td>返回数据</td>
</tr>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">string</td>
<td>ID</td>
</tr>
<tr>
<td style="text-align: left;">personId</td>
<td style="text-align: left;">string</td>
<td>人员ID</td>
</tr>
<tr>
<td style="text-align: left;">personName</td>
<td style="text-align: left;">string</td>
<td>人员姓名</td>
</tr>
<tr>
<td style="text-align: left;">deptName</td>
<td style="text-align: left;">string</td>
<td>部门名称</td>
</tr>
<tr>
<td style="text-align: left;">enCode</td>
<td style="text-align: left;">string</td>
<td>工号</td>
</tr>
<tr>
<td style="text-align: left;">arriveDays</td>
<td style="text-align: left;">int</td>
<td>应到天数(应出勤天数)</td>
</tr>
<tr>
<td style="text-align: left;">restDays</td>
<td style="text-align: left;">int</td>
<td>休息天数</td>
</tr>
<tr>
<td style="text-align: left;">materialityDays</td>
<td style="text-align: left;">int</td>
<td>实到天数(出勤天数)</td>
</tr>
<tr>
<td style="text-align: left;">workDuration</td>
<td style="text-align: left;">double</td>
<td>工作时长(小时)</td>
</tr>
<tr>
<td style="text-align: left;">lateCount</td>
<td style="text-align: left;">int</td>
<td>迟到次数</td>
</tr>
<tr>
<td style="text-align: left;">lateDuration</td>
<td style="text-align: left;">double</td>
<td>迟到时长(小时)</td>
</tr>
<tr>
<td style="text-align: left;">absenteeismDays</td>
<td style="text-align: left;">int</td>
<td>旷工天数</td>
</tr>
<tr>
<td style="text-align: left;">earlyCount</td>
<td style="text-align: left;">int</td>
<td>早退次数</td>
</tr>
<tr>
<td style="text-align: left;">earlyDuration</td>
<td style="text-align: left;">double</td>
<td>早退时长(小时)</td>
</tr>
<tr>
<td style="text-align: left;">onDutyNotSigned</td>
<td style="text-align: left;">int</td>
<td>上班缺卡次数</td>
</tr>
<tr>
<td style="text-align: left;">offDutyNotSigned</td>
<td style="text-align: left;">int</td>
<td>下班缺卡次数</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;success&quot;: true,
&quot;message&quot;: &quot;&quot;,
&quot;code&quot;: 200,
&quot;result&quot;: {
&quot;records&quot;: [
{
&quot;deptName&quot;: &quot;市场部&quot;,
&quot;earlyCount&quot;: null,
&quot;arriveDays&quot;: 1,
&quot;offDutyNotSigned&quot;: null,
&quot;lateDuration&quot;: null,
&quot;materialityDays&quot;: null,
&quot;lateCount&quot;: null,
&quot;absenteeismDays&quot;: null,
&quot;workDuration&quot;: 450.0,
&quot;personName&quot;: &quot;杨继光&quot;,
&quot;restDays&quot;: null,
&quot;enCode&quot;: null,
&quot;onDutyNotSigned&quot;: null,
&quot;personId&quot;: &quot;1519621657825169410&quot;,
&quot;id&quot;: &quot;1640745561355112450&quot;,
&quot;earlyDuration&quot;: null
},
{
&quot;deptName&quot;: &quot;市场部&quot;,
&quot;earlyCount&quot;: 1,
&quot;arriveDays&quot;: 5,
&quot;offDutyNotSigned&quot;: 1,
&quot;lateDuration&quot;: null,
&quot;materialityDays&quot;: null,
&quot;lateCount&quot;: 1,
&quot;absenteeismDays&quot;: null,
&quot;workDuration&quot;: 2134.0,
&quot;personName&quot;: &quot;12&quot;,
&quot;restDays&quot;: 2,
&quot;enCode&quot;: null,
&quot;onDutyNotSigned&quot;: 1,
&quot;personId&quot;: &quot;1639144950679404545&quot;,
&quot;id&quot;: &quot;1636291210578386946&quot;,
&quot;earlyDuration&quot;: null
}
],
&quot;total&quot;: 2,
&quot;size&quot;: 10,
&quot;current&quot;: 1,
&quot;orders&quot;: [],
&quot;optimizeCountSql&quot;: true,
&quot;searchCount&quot;: true,
&quot;countId&quot;: null,
&quot;maxLimit&quot;: null,
&quot;pages&quot;: 1
},
&quot;data&quot;: null,
&quot;timestamp&quot;: 1680073494138
}</code></pre>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>