## 业务场景
用于接收业务大厅业务系统推送过来的业务数据。群众在大厅窗口办事后，业务系统将群众办事后的半件数据推送到`业务数据接收接口`，接口接收到数据后，会自动调起窗口的平板打开省办件事项评价页。服务人员引导群众评价该办件事项。
## 业务流程
## 接口地址
`POST|GET` `http://101.32.44.216:9502/notify`
>[info] 该接口地址为临时地址，待业务上线后，线上接口地址另行通知
| 参数名 | 必填 | 类型 | 描述 |
| --- | --- | --- | --- |
| evalProcess | 是 | Integer | 评价阶段（1：受理阶段；2：办结阶段） |
| affairDealNo | 是 | String(10) | 窗口服务人员工号，不能含“-”字符 |
| affairSerialNo | 是 | String(50) | 办件事项办件编号。《广东省政务服务网办事过程数据采集标准V3.0》中up_pro_result_v3. ProjectNo |
| affairCode | 是 | String(32) | 事项目录系统中实施清单编码 |
| affairName | 是 | String(100) | 事项名称 |
| affairDealOfficer | 是 | String(50) | 事项受理人姓名 |
| affairApplyTime | 是 | String(14) | 事项受理时间，格式yyyyMMddHHmmss |
| affairDoneTime | 否 | String(14) | 事项办结时间，格式yyyyMMddHHmmss，但事项办结时必传 |
| affairHandleItem | 否 | Strring(33) | 业务办理项编码，如果该事项为业务办理项则必须上传 |
| departmentCode | 是 | String(20) | 部门编码（数广政务运营平台部门编码），参见附件3-组织机构表 |
| userName | 是 |String(50) | 评价人姓名 |
| contactPhone | 是 | String(50) | 评价人手机号码`明文` |
| passportName | 否 | String(30) | 评价者登录账号 |
| userType | 是 | Integer | 评价者类型：0个人；1法人 |
| certificateType | 是 | Integer | 评价者证件类型 |
| certificateNo | 是 | String(50) | 证件编号`明文` |
拼接后GET请求示例地址
```
http://101.32.44.216:9502/notify?evalProcess=2&affairDealNo=GS123456&affairSerialNo=11440232MB2D06811W4000117051000202010200008&affairCode=11440232MB2D06811W4000117051000&affairName=建设工程消防设计审查&affairDealOfficer=张三&affairApplyTime=20201029151036&affairDoneTime=20201029151036&affairHandleItem=11440232MB2D06811W4440114000000&departmentCode=MB2D06811&userName=李四&contactPhone=13800138000&passportName=guest&userType=0&certificateType=10&certificateNo=440203199910103344
```
拼接后POST请求示例`test.http`
```
POST http://101.32.44.216:9502/notify
Content-Type: application/x-www-form-urlencoded
evalProcess=2&affairDealNo=GS123456&affairSerialNo=11440232MB2D06811W4000117051000202010200008&affairCode=11440232MB2D06811W4000117051000&affairName=建设工程消防设计审查&affairDealOfficer=张三&affairApplyTime=20201029151036&affairDoneTime=20201029151036&affairHandleItem=11440232MB2D06811W4440114000000&departmentCode=MB2D06811&userName=李四&contactPhone=13800138000&passportName=guest&userType=0&certificateType=10&certificateNo=440203199910103344
```
## 返回数据
评价器服务器接收到业务系统的数据后，会返回json数据。
```json
{
"success": true,
"state": 1,
"message": "业务数据接收成功",
"id": "15"
}
```
`success`为成功态，`true`为请求成功，`false`为请求失败；
`state`为状态码，`message`为状态消息，详细状态码对照表如下：
| 状态码 | 描述 |
| --- | --- |
| 1 | 正常，已成功接收到业务数据，系统处理数据后会调起对应的评价器 |
| 206 | 已接收到业务数据，但数据不符合验证规则，数据不被接受 |
| 500 | 服务器发生错误，无法正常处理本次的数据 |
## 附录
### 评价对象编码
| 评价对象编码 | 描述 |
| --- | --- |
| egovAffair | 政务网办件事项 |
| egovGuide | 政务网办事指南 |
| hotline | 热线服务 |
| yssAffair | 粤省事办件事项 |
| hallAffair | 大厅办件事项 |
| ystAffair | 粤商通办件 |
| eAppAffair | 政务APP办件 |
| eAppGuide | 政务APP办事指南 |
### 渠道
| 渠道编码 | 描述 |
| --- | --- |
| web | PC页面 |
| android | 安卓系统APP |
| ios | 苹果系统APP |
| h5 | 移动端H5页面 |
| miniApp | 小程序 |
| hallQr | 大厅动态二维码 |
| hallQrStat | 大厅静态二维码 |
| hallPad | 大厅平板电脑 |
| hallOne | 一体机 |
| hallOther | 大厅其他终端 |
| other | 其他 |
### 证件类型
|证件类型 | 描述 |
| --- | --- |
| 10 | 身份证 |
| 11 | 军官证 |
| 12 | 士兵证 |
| 13 | 警官证 |
| 14 | 港澳居民来往内地通行证 |
| 15 | 台湾居民来往大陆通行 |
| 16 | 香港身份证 |
| 17 | 澳门身份证 |
| 18 | 台湾身份证 |
| 20 | 护照 |
| 21 | 驾照 |
| 40 | 其他有效个人身份证件 |
| 49 | 统一社会信用代码 |
| 50 | 组织机构代码证 |
| 51 | 工商营业执照 |
| 52 | 事业单位登记证书 |
| 53 | 社团登记证书 |
| 54 | 民办非企业单位登记证书 |
| 55 | 工会法人资格证书 |
| 60 | 税务登记证 |
| 80 | 其他有效机构身份证件 |
