3.33 上下班打卡接口(特殊渠道产品对接)
<p>[TOC]</p>
<p>请求模式:渠道方→华农阿凡达平台</p>
<p>接口描述:上下班打卡接口(特殊渠道)</p>
<p>测试接口地址:<a href="https://porsche-avatar.chinahuanong.com.cn/avatar/junrun/clock">https://porsche-avatar.chinahuanong.com.cn/avatar/junrun/clock</a></p>
<p>生产接口地址:<a href="https://avatar.chinahuanong.com.cn/avatar/junrun/clock">https://avatar.chinahuanong.com.cn/avatar/junrun/clock</a></p>
<h3>请求头</h3>
<p><code>head</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>渠道代码</td>
<td>policySource</td>
<td>varchar</td>
<td>Y</td>
<td>保险公司分配给 渠道方的渠道编码</td>
</tr>
<tr>
<td>请求时间</td>
<td>reqTime</td>
<td>DateTime</td>
<td>Y</td>
<td>格式为:yyyy-MM-dd HH:mm:ss。</td>
</tr>
<tr>
<td>接口类型</td>
<td>interfaceType</td>
<td>varchar</td>
<td>Y</td>
<td>针对每个接口,使用接口的API信息</td>
</tr>
<tr>
<td>订单号</td>
<td>orderNo</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>唯一标识符</td>
<td>uuid</td>
<td>varchar</td>
<td>Y</td>
<td>单次请求唯一标识符,任一次请求不允许相同</td>
</tr>
</tbody>
</table>
<h3>请求体</h3>
<p><code>reqBody</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>保单号</td>
<td>policyNo</td>
<td>varchar</td>
<td>Y</td>
<td>保单信息的唯一标识</td>
</tr>
<tr>
<td>打卡类型</td>
<td>clockType</td>
<td>varchar</td>
<td>Y</td>
<td>1 上班 0 下班</td>
</tr>
<tr>
<td>打卡时间</td>
<td>clockTime</td>
<td>DateTime</td>
<td>Y</td>
<td>打卡时间格式 (格式:yyyy-MM-dd HH:mm-ss)</td>
</tr>
<tr>
<td>证件类型</td>
<td>idType</td>
<td>varchar</td>
<td>Y</td>
<td>见证件类型码表,如无特殊要求</td>
</tr>
<tr>
<td>证件号码</td>
<td>idCode</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>打卡id</td>
<td>clockId</td>
<td>varchar</td>
<td>Y</td>
<td>同一个保单下同一雇员的打卡id幂等</td>
</tr>
</tbody>
</table>
<h3>响应头</h3>
<p><code>head</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>渠道代码</td>
<td>policySource</td>
<td>varchar</td>
<td>Y</td>
<td>保险公司分配给 渠道方的渠道编码</td>
</tr>
<tr>
<td>响应时间</td>
<td>respTime</td>
<td>DateTime</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>接口类型</td>
<td>interfaceType</td>
<td>varchar</td>
<td>CY</td>
<td>针对每个接口,使用接口的API信息</td>
</tr>
<tr>
<td>订单号</td>
<td>orderNo</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>唯一标识符</td>
<td>uuid</td>
<td>varchar</td>
<td>Y</td>
<td>单次请求唯一标识符,任一次请求不允许相同</td>
</tr>
</tbody>
</table>
<h3>响应体</h3>
<p><code>respBody</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>处理状态码</td>
<td>dealCode</td>
<td>varchar</td>
<td>Y</td>
<td>处理结果状态码</td>
</tr>
<tr>
<td>处理结果描述</td>
<td>dealDesc</td>
<td>varchar</td>
<td>Y</td>
<td>处理结果描述</td>
</tr>
</tbody>
</table>
<h3>报文示例</h3>
<h4>请求</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;orderNo&quot;: &quot;SF20221215xpllxhr2j6&quot;,
&quot;policySource&quot;: &quot;HN_SF&quot;,
&quot;reqTime&quot;: 1671096059753,
&quot;uuid&quot;: &quot;11405c3b1520455581690b27cb24057f&quot;,
&quot;interfaceType&quot;: &quot;jrClock&quot;
},
&quot;reqBody&quot;: {
&quot;idType&quot;: &quot;0&quot;,
&quot;idCode&quot;: &quot;422425197010085812&quot;,
&quot;policyNo&quot;: &quot;X44011703220001697201&quot;,
&quot;clockType&quot;: &quot;1&quot;,
&quot;clockId&quot;: &quot;20221215171915008&quot;,
&quot;clockTime&quot;: 1671095954000
}
}
</code></pre>
<h4>返回</h4>
<pre><code class="language-json">{
&quot;respBody&quot;: {
&quot;dealCode&quot;: 1,
&quot;dealDesc&quot;: &quot;更新成功&quot;
}
}
</code></pre>