收件

1. 收件不是单独的业务功能，是提取业务保存后的后续步骤，因为每个提取流程都会用到，所以单独
   

2. 从提取业务传递过来的数据项

   信息项名称	赋值
   职工姓名	（020108）xm
   身份证号	（020108）zjhm
   业务办理机构	登录操作员的orgcode
   提取表主键	提取保存接口返回提取表主键或单位开户返回的单位账号

3. 收件业务类型

   业务名称	业务类型	收件类型
   购买商品房提取	1103	T1
   购买二手房提取	1104	T2
   租房提取	1113	T8
   结清公积金贷款提取	1121	CD
   部分冲还公积金贷款提取	1122	TA
   一年两次还商贷	1131	TB
   退休提取	1201	TF
   封存提取	1202	TG
   单位开户	0301	BB

4. 收件调用的是第三方的接口，所以收件接口的host最好放在配置文件中，以方便修改。

5. 下面的接口，因为是第三方接口，所以当调用失败后，一般再调第二次，如果两次都失败，则提示：收件服务请求失败，请将文件拍照保存，在业务系统进行收件补录。

6. 测试host:待提供

7. 页面设计图

   

8. 业务处理步骤

   1. 第一步：调用获取令牌接口
      
      1. GET /sword/call/getAppToken/yzgjjwt/ztpad
         
      2. 返回示例 { "code": 200, "message": "获取令牌成功", "data": { "tokenName": "nsauthorization", "user": { "appId": "bzgjjwt", "NAME": "wt" }, "tokenValue": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzd29yZCI6IjMwZWM0MDg1ODczZDMzMDMzYmQyZWNlYzQ1OTBjNTYwZmNmZTlmYjQxODA2MTMyYzI3YjAxMzI5YmI1N2E1ZjJjYzhkNjBiMzZhNmZhNTY5MDE0YjFkOTJmZWJiZDY0ZmRhNDcxYWEwOWMyMTJlNTFmMDJjZjYxMTc3Y2Y2M2Y3IiwiZXhwIjoxNjU4MjE0MTQ5LCJpYXQiOjE2NTgyMTIzNDksIk5BTUUiOiJ3dCJ9.pXzNMctG8Y3LHvxlYfy3vfgSSZFdBD8SaJvHcreceyw" } }
      3. code:200 ok;201 created;401 Unauthorized;403 Forbidden;404 Not Found
      4. 获取tokenValue，作为令牌，后续的接口都需要用到
         

   2. 第二步:调用接口创建档案，并获取档案采集页面的地址

      1. POST /sword/wt/GetCreateDataAction
      2. header(下面接口都要加): nsauthorization=令牌；secret=
         

      3. body示例

         {
             "AJTM": "张三",                 //姓名（如果是单位开户业务，传单位名称）
             "BLQD": "ztpad",                //固定值：ztpad  
             "DWMC": "",                     //单位开户时，传单位名称；其他不传
             "DWZH": "",                     //单位开户时，传单位账号；其他不传
             "GRXM": "张三",                 //提取业务时，传职工姓名；其他不传
             "HDDZ": "",                     //不传
             "JKLX": "scan/query",          //收件是scan，查询是query
             "SFZH": "358459199005263215",  //提取业务时，传职工身份证号；其他不传
             "YWBLJGDM": "999",             //业务办理机构
             "YWLSH": "20220719001",        //提取业务时，提取表主键；单位开户时，单位账号
             "YWLXDM": "WT001",             //收件类型，根据业务类型到收件业务类型表中找对应收件类型
             "YWRQ": "20220719",            //当前日期，格式如示例
             "YWSSJGDM": "999"              //还是业务办理机构
         }
         

      4. 返回示例

         {
             "code": 200,
             "data": "http://localhost:81/mobileVue?uuid=ed20d7d6-6674-494d-9620-0e2f339dbcce",
             "message": "创建档案成功"
         }

      5. 获取data提请的地址，打开网页

   3. 第三步：提交（点击提交按钮）

      1. 检查上传图片数量

         1. 接口： POST /sword/wt/GetFileNumAction

         2. body 示例

            {
                "YWLSH": "20220719001",    //提取表主键
                "YWLXDM": "WT001"          //收件类型
            }
            

         3. 返回 示例

            {
                "code": 200, 
                "data": 1, 
                "message": "获取成功"
            }

         4. 如果data == 0,提示：未搜索到扫描图片，请先上传图片；否则，下一步。

      2. 提交

         1. 接口：/sword/wt/CheckUpDataAction
            
         2. 请求body示例 { "YWLSH": "20220719001", "YWLXDM": "WT001" }
         3. 返回示例 { "code": 200, "data": {}, "message": "同步成功" }
         4. 提交成功后，收件流程结束