shanpin
/
doc


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525
							<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
   <meta http-equiv="content-type" content="text/html;charset=UTF-8">
   <style type="text/css">
   <!-- 
@import url(md.css);
-->
   </style>
   
   
</head>
<body>
    <h1>1 员工方案列表</h1>

<ul>
<li>列表数据的员工基本信息来自 <code>员工表</code> , 不管用户是否配置了方案.</li>
<li>方案数据来自 <code>员工方案表</code>, 配置员工方案数据主要是操作 <code>员工方案表</code> 的数据.</li>
</ul>

<h3>方案列表请求</h3>

<ul>
<li><p>列表URI</p>

<pre><code>/he/shebao_plan/list        GET / POST
</code></pre></li>
<li><p>列表查询参数</p>

<pre><code>提交参数采用 Form 表单 或 JSON 的格式.
</code></pre>

<table><thead>
<tr>
<th align="left">字段</th>
<th align="left">字段名称</th>
<th align="left">类型</th>
<th align="left">长度</th>
<th align="left">必须有值</th>
<th align="left">必传</th>
</tr>
</thead><tbody>
<tr>
<td align="left"><a href="common.html#page">curr</a></td>
<td align="left">当前页码</td>
<td align="left">int</td>
<td align="left">1 ~ 1000</td>
<td align="left"></td>
<td align="left"></td>
</tr>
<tr>
<td align="left">user_name</td>
<td align="left">员工姓名</td>
<td align="left">string</td>
<td align="left">0 ~ 16</td>
<td align="left"></td>
<td align="left"></td>
</tr>
</tbody></table></li>
</ul>

<h3>方案列表响应</h3>

<ul>
<li><p>data字段</p>

<table><thead>
<tr>
<th align="left">字段</th>
<th align="left">类型</th>
<th align="left">字段名称</th>
</tr>
</thead><tbody>
<tr>
<td align="left"><a href="#spl_planList">planList</a></td>
<td align="left">List</td>
<td align="left">员工方案列表的数据</td>
</tr>
<tr>
<td align="left"><a href="#spl_cityDayList">cityDayList</a></td>
<td align="left">List</td>
<td align="left">城市数据和参保月数据</td>
</tr>
<tr>
<td align="left"><a href="common.html#page">page</a></td>
<td align="left">Object</td>
<td align="left">见通用文档</td>
</tr>
<tr>
<td align="left">user_name</td>
<td align="left">String</td>
<td align="left">列表查询参数</td>
</tr>
<tr>
<td align="left"><a href="common.html#hukou">hukous</a></td>
<td align="left">Array</td>
<td align="left">见通用文档</td>
</tr>
</tbody></table>

<div id="spl_planList"></div> 

<ul>
<li><p>字段 planList</p>

<pre><code>List
    TWxyjEmployeePlan plan;        // 员工方案列表的数据
            /** 员工方案表的ID */
            int id;
            /** 企业员工的标识 */
            int company_userid;
            /** 城市的代码 */
            int city_code;
            /** 基础参保方案标识 */
            int param_id;
            /** 企业标识 */
            int ent_id;
            /** 户藉标识 */
            int hukou;
            /** 基数的方案    1:自定义  2:最低工资   3:实际工资(暂不支持) */
            int radix_type;
            /** 社保基数 */
            double shebao_radix;
            /** 社保调基时间 */
            String shebao_uptime;
            /** 是否参保社保 */
             int shebao_buy;
            /** 是否参缴公积金 */
            int fund_buy;
            /** 公积金基数 */
            double fund_radix;
            /** 公积金企业比例 */
            double fund_eratio;
            /** 积金个人比例 */
            double fund_pratio;
            /**  */
            String update_time;

    String city_name;               // 城市名称
    String shebao_name;            // 社保方案名称
    String hukou_name;            // 户藉名称
    int user_id;                  // 员工表的ID
    String user_name;            // 员工姓名
    String id_card;            // 员工身份证号码
    String nation;        // 民族
    String phone;        // 手机号
    int gender;        // 性别     0:女  1:男
    int ustatus;        // 员工状态.
</code></pre></li>
</ul>

<div id="spl_cityDayList"></div> 

<ul>
<li><p>字段 cityDayList</p>

<pre><code>int city_code;           城市代码
String city_name;        城市名称
int dec_day;             城市方案的减员日期
</code></pre></li>
</ul></li>
<li><p>员工方案列表的数据示例</p>

<pre><code>{
    &quot;code&quot;: 200,
    &quot;msg&quot;: &quot;&quot;,
    &quot;data&quot;: {
        &quot;cityDayList&quot;: [{
            &quot;city_code&quot;: 1001,
            &quot;city_name&quot;: &quot;广州&quot;,
            &quot;dec_day&quot;: 14
        },
        {
            &quot;city_code&quot;: 1014,
            &quot;city_name&quot;: &quot;深圳&quot;,
            &quot;dec_day&quot;: 14
        },
        {
            &quot;city_code&quot;: 1101,
            &quot;city_name&quot;: &quot;北京&quot;,
            &quot;dec_day&quot;: 12
        }],
        &quot;hukous&quot;: [&quot;LOCAL_CITY&quot;,
            &quot;LOCAL_VILLAGE&quot;,
            &quot;NONLOCAL_CITY&quot;,
            &quot;NONLOCAL_VILLAGE&quot;],
        &quot;user_name&quot;: &quot;&quot;,
        &quot;planList&quot;: [{
            &quot;plan&quot;: {
                &quot;id&quot;: 1,
                &quot;company_userid&quot;: 1,
                &quot;city_code&quot;: 1001,
                &quot;param_id&quot;: 1,
                &quot;ent_id&quot;: 1,
                &quot;hukou&quot;: 1,
                &quot;radix_type&quot;: 2,
                &quot;shebao_radix&quot;: 0.0,
                &quot;shebao_uptime&quot;: &quot;2018-03-28&quot;,
                &quot;shebao_buy&quot;: 1,
                &quot;fund_buy&quot;: 1,
                &quot;fund_radix&quot;: 15000.0,
                &quot;fund_eratio&quot;: 5.0,
                &quot;fund_pratio&quot;: 12.0,
                &quot;update_time&quot;: &quot;2018-04-09 16:15&quot;
            },
            &quot;city_name&quot;: &quot;广州&quot;,
            &quot;shebao_name&quot;: &quot;标准&quot;,
            &quot;hukou_name&quot;: &quot;本市城镇&quot;,
            &quot;user_id&quot;: 1,
            &quot;user_name&quot;: &quot;赖先生&quot;,
            &quot;id_card&quot;: &quot;123456789012345678&quot;,
            &quot;nation&quot;: &quot;汉&quot;,
            &quot;phone&quot;: &quot;12345678901&quot;,
            &quot;gender&quot;: 1,
            &quot;ustatus&quot;: 1
        },
        {
            &quot;plan&quot;: {
                &quot;id&quot;: 2,
                &quot;company_userid&quot;: 2,
                &quot;city_code&quot;: 1014,
                &quot;param_id&quot;: 18,
                &quot;ent_id&quot;: 1,
                &quot;hukou&quot;: 2,
                &quot;radix_type&quot;: 1,
                &quot;shebao_radix&quot;: 1989.0,
                &quot;shebao_uptime&quot;: &quot;2018-03-28&quot;,
                &quot;shebao_buy&quot;: 0,
                &quot;fund_buy&quot;: 1,
                &quot;fund_radix&quot;: 15000.0,
                &quot;fund_eratio&quot;: 8.0,
                &quot;fund_pratio&quot;: 12.0,
                &quot;update_time&quot;: &quot;2018-03-28 14:56&quot;
            },
            &quot;city_name&quot;: &quot;深圳&quot;,
            &quot;shebao_name&quot;: &quot;二档&quot;,
            &quot;hukou_name&quot;: &quot;本市农村&quot;,
            &quot;user_id&quot;: 2,
            &quot;user_name&quot;: &quot;刘小姐&quot;,
            &quot;id_card&quot;: &quot;123456789012345681&quot;,
            &quot;nation&quot;: &quot;汉&quot;,
            &quot;phone&quot;: &quot;12345678901&quot;,
            &quot;gender&quot;: 0,
            &quot;ustatus&quot;: 1
        }],
        &quot;page&quot;: {
            &quot;size&quot;: 2,
            &quot;first&quot;: 1,
            &quot;curr&quot;: 1,
            &quot;last&quot;: 2,
            &quot;total&quot;: 4,
            &quot;start&quot;: 0,
            &quot;finish&quot;: 2
        }
    }
}
</code></pre></li>
</ul>

<hr>

<h1>2 查看指定用户的参保方案</h1>

<blockquote>
<p>由于列表的数据是由员工表的数据列出, 所以存在员工没有配置方案的情况, 此时 planId 值传 0, company_userid 需要有效值 <br>
有参保方案的员工, 查看时需要 planId 的有效值.</p>
</blockquote>

<h3>查看请求</h3>

<h5>URI</h5>

<pre><code>/he/shebao_plan/view      POST
</code></pre>

<h5>参数</h5>

<pre><code>int planId                方案的ID
int company_userid        员工的ID
</code></pre>

<h3>查看响应</h3>

<h5>响应的代码</h5>

<pre><code>200    成功查询数据
600    参数有错.
</code></pre>

<h5>响应的数据结构</h5>

<ul>
<li><p>data的主要字段</p>

<table><thead>
<tr>
<th align="left">字段</th>
<th align="left">类型</th>
<th align="left">字段名称</th>
</tr>
</thead><tbody>
<tr>
<td align="left"><a href="common.html#hukou">hukous</a></td>
<td align="left">Array</td>
<td align="left">见通用文档</td>
</tr>
<tr>
<td align="left"><a href="#spl_planList">plan</a></td>
<td align="left">Object</td>
<td align="left">方案数据</td>
</tr>
<tr>
<td align="left">user</td>
<td align="left">Object</td>
<td align="left">用户参保相关的数据</td>
</tr>
<tr>
<td align="left"><a href="#spl_cityDayList">cityDayList</a></td>
<td align="left">List</td>
<td align="left">员工所属企业的城市方案列表</td>
</tr>
<tr>
<td align="left">city_params</td>
<td align="left">List</td>
<td align="left">城市的社保参数基本信息</td>
</tr>
</tbody></table></li>
<li><p>子字段 user</p>

<pre><code>int user_id             员工的ID
String user_name        员工的姓名
String id_card          身份证号码
String nation           民族
String phone            手机号
boolean gender          性别: 男:true  女:false
</code></pre></li>
<li><p>子字段 city_params</p>

<pre><code>String city_name        城市名称
int city_code           城市代码
int param_id            社保配置数据的ID
String shebao_name      社保配置数据的名称
</code></pre></li>
</ul>

<h5>响应的数据示例</h5>

<pre><code>{
    &quot;msg&quot;: &quot;&quot;,
    &quot;code&quot;: 200,
    &quot;data&quot;: {
        &quot;city_params&quot;: [{
            &quot;city_name&quot;: &quot;广州&quot;,
            &quot;city_code&quot;: 1001,
            &quot;param_id&quot;: 1,
            &quot;shebao_name&quot;: &quot;标准&quot;
        }],
        &quot;cityDayList&quot;: [{
            &quot;city_code&quot;: 1001,
            &quot;city_name&quot;: &quot;广州&quot;,
            &quot;dec_day&quot;: 14
        },
        {
            &quot;city_code&quot;: 1014,
            &quot;city_name&quot;: &quot;深圳&quot;,
            &quot;dec_day&quot;: 14
        },
        {
            &quot;city_code&quot;: 1101,
            &quot;city_name&quot;: &quot;北京&quot;,
            &quot;dec_day&quot;: 12
        }],
        &quot;hukous&quot;: [&quot;LOCAL_CITY&quot;,
            &quot;LOCAL_VILLAGE&quot;,
            &quot;NONLOCAL_CITY&quot;,
            &quot;NONLOCAL_VILLAGE&quot;],
        &quot;plan&quot;: {
            &quot;id&quot;: 1,
            &quot;company_userid&quot;: 1,
            &quot;city_code&quot;: 1001,
            &quot;param_id&quot;: 1,
            &quot;ent_id&quot;: 1,
            &quot;hukou&quot;: 1,
            &quot;radix_type&quot;: 2,
            &quot;shebao_radix&quot;: 0.0,
            &quot;shebao_uptime&quot;: &quot;2018-03-28&quot;,
            &quot;shebao_buy&quot;: 1,
            &quot;fund_buy&quot;: 1,
            &quot;fund_radix&quot;: 15000.0,
            &quot;fund_eratio&quot;: 5.0,
            &quot;fund_pratio&quot;: 12.0,
            &quot;update_time&quot;: &quot;2018-04-09 16:15&quot;
        },
        &quot;user&quot;: {
            &quot;user_id&quot;: 1,
            &quot;user_name&quot;: &quot;赖先生&quot;,
            &quot;id_card&quot;: &quot;123456789012345678&quot;,
            &quot;nation&quot;: &quot;汉&quot;,
            &quot;phone&quot;: &quot;12345678901&quot;,
            &quot;gender&quot;: true
        }
    }
}
</code></pre>

<hr>

<h1>3 修改用户的参保方案</h1>

<h3>3.1 请求修改</h3>

<p>社保, 公积金一起提交过来做修改更新.</p>

<ul>
<li><p>URI</p>

<pre><code>/he/shebao_plan/edit     POST
</code></pre></li>
<li><p>参数 (以下参数都是必传)</p>

<pre><code class="java">    <span class="javadoc">/** 企业员工方案标识 */
    int plan_id;
    /** 企业员工的标识 */
    int company_userid;
    /** 城市的代码 */
    int city_code;
    /** 基础参保方案标识 */
    int param_id;
    /** 户藉标识 */
    int hukou;
    /** 基数的方案 */
    int radix_type;
    /** 社保基数 */
    double shebao_radix;
    /** 社保调基时间 */
    String shebao_uptime;
    /** 是否参保社保 */
    int shebao_buy;
    /** 是否参缴公积金 */
    int fund_buy;
    /** 公积金基数 */
    double fund_radix;
    /** 公积金企业比例 */
    double fund_eratio;
    /** 积金个人比例 */
    double fund_pratio;
</code></pre></li>
</ul>

<h3>3.2 响应修改</h3>

<p>修改成功返回 plan_id 的值.</p>

<ol>
<li>修改前进行参数校验; </li>
<li><strong>plan_id无值</strong>: 则根据身份证查找数据记录,如果存在, 响应异常信息. 如果未存在,则新增此参保方案.</li>
<li><strong>plan_id有值</strong>: 进行数据判断是否存在, 不存在会提示异常信息.</li>
</ol>

<ul>
<li><p>状态码</p>

<pre><code>200    修改成功.
500    参数检查 及 数据存在与否检查 提示.
</code></pre></li>
<li><p>响应数据</p>

<ul>
<li><p>有异常</p>

<pre><code>{
    &quot;data&quot;: null,
    &quot;msg&quot;: &quot;员工的五险一金方案不存在，已经终止修改。&quot;,
    &quot;code&quot;: 500
}
</code></pre></li>
<li><p>成功修改</p>

<pre><code class="json">{<span class="attribute">
    "data</span>": <span class="value"><span class="number">60</span></span>,<span class="attribute">
    "msg</span>": <span class="value"><span class="string">""</span></span>,<span class="attribute">
    "code</span>": <span class="value"><span class="number">200</span>
}</span>
</code></pre></li>
</ul></li>
</ul>

<hr>

<h1>4 快捷设置状态</h1>

<h3>4.1 请求修改</h3>

<p>社保, 公积金的参缴状态快速配置</p>

<ul>
<li><p>URI</p>

<pre><code>/he/shebao_plan/edit/status     POST
</code></pre></li>
<li><p>参数 (以下参数都是必传)</p>

<pre><code>Integer status        // 1: 开启参缴    0: 不参缴
Integer wxyj          // 1: 社保        2: 公积金
String user_ids       // 员工ID列表, 逗号间隔
</code></pre></li>
</ul>

<h3>4.2 响应</h3>

<p>返回修改成功的数量.</p>

<pre><code>{
    &quot;data&quot;: 10,    // 成功修改10个员工的参缴状态.
    &quot;msg&quot;: &quot;&quot;,
    &quot;code&quot;: 200
}
</code></pre>

<hr>

<script src="md.js"></script>

</body>
</html>