智慧OA考勤


每月汇总

<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>{ &amp;quot;beginTime&amp;quot; : &amp;quot;2023-03-29&amp;quot;, &amp;quot;endTime&amp;quot; : &amp;quot;2023-03-29&amp;quot;, &amp;quot;type&amp;quot; : &amp;quot;Late&amp;quot;, &amp;quot;deptId&amp;quot; : &amp;quot;xxxxx&amp;quot;, &amp;quot;personName&amp;quot; : &amp;quot;xxxx&amp;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>{     &amp;quot;success&amp;quot;: true,     &amp;quot;message&amp;quot;: &amp;quot;&amp;quot;,     &amp;quot;code&amp;quot;: 200,     &amp;quot;result&amp;quot;: {         &amp;quot;records&amp;quot;: [             {                 &amp;quot;deptName&amp;quot;: &amp;quot;市场部&amp;quot;,                 &amp;quot;earlyCount&amp;quot;: null,                 &amp;quot;arriveDays&amp;quot;: 1,                 &amp;quot;offDutyNotSigned&amp;quot;: null,                 &amp;quot;lateDuration&amp;quot;: null,                 &amp;quot;materialityDays&amp;quot;: null,                 &amp;quot;lateCount&amp;quot;: null,                 &amp;quot;absenteeismDays&amp;quot;: null,                 &amp;quot;workDuration&amp;quot;: 450.0,                 &amp;quot;personName&amp;quot;: &amp;quot;杨继光&amp;quot;,                 &amp;quot;restDays&amp;quot;: null,                 &amp;quot;enCode&amp;quot;: null,                 &amp;quot;onDutyNotSigned&amp;quot;: null,                 &amp;quot;personId&amp;quot;: &amp;quot;1519621657825169410&amp;quot;,                 &amp;quot;id&amp;quot;: &amp;quot;1640745561355112450&amp;quot;,                 &amp;quot;earlyDuration&amp;quot;: null             },             {                 &amp;quot;deptName&amp;quot;: &amp;quot;市场部&amp;quot;,                 &amp;quot;earlyCount&amp;quot;: 1,                 &amp;quot;arriveDays&amp;quot;: 5,                 &amp;quot;offDutyNotSigned&amp;quot;: 1,                 &amp;quot;lateDuration&amp;quot;: null,                 &amp;quot;materialityDays&amp;quot;: null,                 &amp;quot;lateCount&amp;quot;: 1,                 &amp;quot;absenteeismDays&amp;quot;: null,                 &amp;quot;workDuration&amp;quot;: 2134.0,                 &amp;quot;personName&amp;quot;: &amp;quot;12&amp;quot;,                 &amp;quot;restDays&amp;quot;: 2,                 &amp;quot;enCode&amp;quot;: null,                 &amp;quot;onDutyNotSigned&amp;quot;: 1,                 &amp;quot;personId&amp;quot;: &amp;quot;1639144950679404545&amp;quot;,                 &amp;quot;id&amp;quot;: &amp;quot;1636291210578386946&amp;quot;,                 &amp;quot;earlyDuration&amp;quot;: null             }         ],         &amp;quot;total&amp;quot;: 2,         &amp;quot;size&amp;quot;: 10,         &amp;quot;current&amp;quot;: 1,         &amp;quot;orders&amp;quot;: [],         &amp;quot;optimizeCountSql&amp;quot;: true,         &amp;quot;searchCount&amp;quot;: true,         &amp;quot;countId&amp;quot;: null,         &amp;quot;maxLimit&amp;quot;: null,         &amp;quot;pages&amp;quot;: 1     },     &amp;quot;data&amp;quot;: null,     &amp;quot;timestamp&amp;quot;: 1680073494138 }</code></pre> <h5>备注</h5> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML