阿凡达

阿凡达平台对接外部渠道,如果渠道方需要使用专用接口,即对接使用渠道方的接口文档。如果渠道方没有定制接口需求,则按照阿凡达平台接口文档规范进行交互


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">{ &amp;quot;head&amp;quot;: { &amp;quot;orderNo&amp;quot;: &amp;quot;SF20221215xpllxhr2j6&amp;quot;, &amp;quot;policySource&amp;quot;: &amp;quot;HN_SF&amp;quot;, &amp;quot;reqTime&amp;quot;: 1671096059753, &amp;quot;uuid&amp;quot;: &amp;quot;11405c3b1520455581690b27cb24057f&amp;quot;, &amp;quot;interfaceType&amp;quot;: &amp;quot;jrClock&amp;quot; }, &amp;quot;reqBody&amp;quot;: { &amp;quot;idType&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;idCode&amp;quot;: &amp;quot;422425197010085812&amp;quot;, &amp;quot;policyNo&amp;quot;: &amp;quot;X44011703220001697201&amp;quot;, &amp;quot;clockType&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;clockId&amp;quot;: &amp;quot;20221215171915008&amp;quot;, &amp;quot;clockTime&amp;quot;: 1671095954000 } } </code></pre> <h4>返回</h4> <pre><code class="language-json">{ &amp;quot;respBody&amp;quot;: { &amp;quot;dealCode&amp;quot;: 1, &amp;quot;dealDesc&amp;quot;: &amp;quot;更新成功&amp;quot; } } </code></pre>

页面列表

ITEM_HTML