核对平台与救助系统接口方案V1

1、居民家庭经济状况核对平台与救助系统对接接口方案(VI.3)江西省“数字民政应用平台项目组文档控制更改记录日期作者版本更改参考1.01.1调整格式，完善内容1.2增加FTP文件传输支持1.3完善FTP文件传输支持审阅姓名单位和职位签字分发拷贝号姓名区域第1页第一章引言1.1编写目的居民家庭经济状况核对平台接收委托数据，需要与其他系统进行数据交互。为实现和规范双方系统数据交换，特制定本方案。1.2文档概述1.2.1文档使用者专项救助部门1.2.2咨询方文档编写方式及使用工具Word2010Visio20101.2.3文档定义说明与符号数据：广义数据，包含数字，时间，字母，文字，二进制文件等需要计算

2、机系统处理保存的各种形式的数据。居民家庭经济状况核对平台：文档中简称“核对平台二专项救助部门救助业务系统：文档中简称“救助系统1.2.4文档参考资料江西数据民政项目开发规范第 页第二章方案综述2.1方案设计目标及遵循规范救助系统在认定申请人资格的过程中要求核查申请对象的收入和财产信息，此时需要委托核对平台对申请对象进行核查。核对系统在完成核查后要向救助系统反馈核对报告，以供救助系统对申请对象进行资格认定。本方案的设计目标：救助系统向核对平台发起核查请求，核对平台向救助系统反馈核查报告，同时核对平台向救助系统提供相对应的查询服务接口。接口方案的设计遵循以下原则：安全性原则：保证传输过程中数据的安

3、全。完整性原则：保证发送数据和返回数据一一对应。2.2方案功能综述核对平台向救助系统提供统一的申请服务接口和查询服务接口。救助系统通过申请服务接口发起核查请求，通过查询服务接口查询核查反馈结果。第三章业务需求描述3.1接口方案数据流程描述救助系统在认定救助对象的过程中要求核查申请对象的收入和财产信息，需要委托核对平台对申请对象进行核查。核对系统在完成核对后向救助系统反馈核对报告，以供救助系统对申请对象进行资格认定。救助系统与核对平台对接的操作流程如下：救助系统受理申请后，经过初步的甄选，需要进行申请对象的核对时,向核对平台发起核查请求。救助系统需要向核对平台提供申请对象的户主信息、家庭成员信息

4、、身份证复印件、公证书复印件、委托书复印件等必要信息。核对平台对救助系统提供的信息进行检查，对于满足核查条件的申请对象，核查平台进行核查；对于缺少相关信息或相关信息不符的申请对象，核对平台将相关申请信息和退回原因给救助系统，并将核对平台中已有的单据进行作废处理，由救助系统重新进行发起核对请求。核对平台核查完成后生成核对报告，在核对平台中进行打印并盖章，由工作人员反馈给救助部门相关人员，同时核对平台将电子的核对报告通过网络反馈给救助系统。核对平台对救助系统提供的核对报告是具有政府认证有法律效力的文件。救助系统的流程不依赖与核对平台系统的流程，即核对平台是通过线下的流程向救助系统提供核对报告。当核

5、对平台未在规定的时间向救助系统提供核对报告时，救助系统能够根据实际的情况进行下一步的审批流程。救助系统会向核对平台批次发起核对请求，核对平台向救助系统提供以批次家庭为单位的核对报告。救助系统根据核对平台反馈的核查报告，审批之后能够通过相对应的服务将审批结果反馈给核对平台系统。第四章功能设计4.1系统流程设计4.1.1救助部门批次委托请求流程务器的路径规范将附件信息放到FTP服务器上，核对平台取回附件信息时,系统不判断附件的完整性，由工作人员人工判定。判定如果有文件损坏，由工作人员退回。4. 1. 3救助部门查询退回委托家庭数据流程第 #页4.1.2救助部门查询核对结果流程第 页注：救助部门查询

6、反馈结果需指定批次委托编号。救助系统査询核对平台退回数据流程（简图）救助系统核对平台接收请求根据数据规范 组装请求报文/新富是否有退回数据/请求核对平台退回数据服务处理请求反馈报文反馈退回结果调用核对平台服务返写退回状态修改退回状态结束注：救助部门取回退回数据后需要通过核对平台服务修改退回数据状态。4.1.4救助部门审批结果反馈流程第 页救助系统反馈核对平台审批结果流程（简图）核对平台根据数据规范 组装反馈审批 结果报文接收请求处理反馈结果请求核对平台反馈审批结果服务处理请求反馈 结果 v反馈请求结果处理后续业务救助系统4.2事务机制系统尽可能保证数据传输的一致性，但是因为网络环境的复杂性，异

7、构系统进行数据交换时可能会造成事务的不一致。如救助系统向核对平台发起核查请求时，核对平台向社会救助返回请求成功消息，之后救助系统更新请求状态为已请求核查。如果在核对平台向社会救助反馈请求结果消息时，网第 #页络中断导致相对应的消息没有传递给救助系统，造成救助系统相对应的单据请求状态没有更新，核查平台与救助系统就出现事务不一致。如果出现此情况需要由操作人员或系统管理员进行人为干预。4.3结构化数据传输本方案核对平台接口服务釆用UAP平台开发webservice,并将webservice部署到专网上供专项救助部门进行远程调用，结构化数据传输格式釆用json数据格式。4.4文件传输文件传输能够釆用两

8、种方式，1、釆用base64位编码，对文件进行编码，直接在报文中进行传输。2、文件釆用FTP方式按照设定的规则传输到指定的FTP服务器目录，同时报文中附件信息中的附件内容记录文件的FTP标识。釆用FTP方式进行文件传输时，系统不对文件的完整性及正确性进行校验，由工作人员受理时进行人工判定。4.5安全要求核对平台服务接口调用，由核对平台进行权限的分配后，专项救助部门进行远程服务的调用。专项救助部门不得将相关的权限私自赋予其他单位。第五章接口字段规范5.1核对请求服务数据项描述5.1.1请求数据项头部信息(head)中文名称标识字段类型长度是否可空备注请求用户名usernameString20Ne

9、icp_super密码passwordString不限N由核对提供数据条数datacountString3N可转数字请求时间requestdateString19Nyyyy-MM-ddhh：mm：ss报文IDmesidString20N报文id批次信息(batch)中文名称标识字段类型长度是否可空备注申请区划pk_orgString20N批次委托编号batchentrustsnumString20N救助业务helptypenameString20N参看标准代码表核对类型chktypeString50N参看标准代码表委托日期entrustdateString19N可转日期yyyy-mm-dd委托

10、人chkstartpeopleString20N委托户数chkhousetotalStringN可转整数委托人数chkpeopletotalStringN可转整数核对收入开始日期chkfastasetdateString19Nyyyy-mm-ddhh：MM：ss第io页第 页核对收入截至日期chklastasetdateString19Nyyyy_mm_ddhh：MM：ss核对财产截至日期chkasetdateString19Nyyyy-mm-ddhh：MM：ss批次附件信息batchfileJson结构不限N批次户信息datumJson结构不限N附件信息(batchfile)中文名称标识字段

11、类型长度是否可空备注行号rownumString20N附件主键uuidString20Y由核对系统生成附件类型filetypestring20N委托书、身份证件复印件、授权声明等附件名称filenamestring50N附件内容filecontentstring不限NBase64编码或约定FTP路径标识（参考文件格式）上传日期uploaddatestring19Y附件格式fileformatstring50N文件名后缀备注notestring200Y注：附件类型系统没有强制要求,专项救助部门能够设置为任意文本,建议采用规范化和简洁、明确的描述,如委托书、身份证件复印件、授权声明等。4）户主信息

12、（datum）中文名称标识字段类型长度是否可空备注申请单据编号applynumstring20N家庭委托编号trustnumberString20N户主名称chknameString50N证件类型cardtypeString20N参看标准代码表证件号码cardnumString50N户籍类型famtypeString20N参看标准代码表户籍所属省famofareaString50N户籍所属市famofcityString50N户籍所属县famofcountyString50N户籍所属街道famofstreeString50N户籍所属社区famofcommString50N户籍地详细地址fama

13、ddressString50N救助申请日期applydateString19Nyyyy-mm-ddhh：MM：ss居住地址liveaddressString50N联系电话telString50Y移动电话phoneString50Y社保一卡通号socialcardnumString50Y家庭人数famnumint8N申报家庭人均半年总收入tofamavgassetdouble16N申报家庭人均资产tofamavgasetdouble16Y申报家庭半年总收入tofamallassetdouble16N申报家庭总资产tofamasetdouble16Y备注noteString255Y家庭成员信息fa

14、milyinfoJson格式不限N家庭附件信息fileinfoJson格式不限N收入信息asetinfoJson格式不限Y货币财产信息moneyasetJson格式不限Y房产信息houseinfoasetJson格式不限Y车辆信息carinfoasetJson格式不限Y其他财产信息othmoneyasetJson格式不限Y家庭成员信息(familyinfo)中文名称标识字段类型长度是否可空备注行号rownumString50N姓名namestring50N出生年月birthdayString19N年龄ageint8N证件类型cardtypestring20N参看标准代码表证件号cardnums

15、tring50N性别sexstring20N参看标准代码表与户主关系relationstring20N参看标准代码表户籍类型famtypestring20N参看标准代码表联系电话telstring50Y社保一卡通号socialcardnumstring50Y文化程度edulevlestring20Y参看标准代码表健康状况healthstustring20Y参看标准代码表婚姻状况marriagestustring20Y参看标准代码表劳动能力workabilitystring20Y参看标准代码表就业情况jobstustring20Y参看标准代码表工作单位workunitstring50Y第 页户籍

16、地址addressareastring255Y居住地址liveareastring255Y收入信息(asetinfo)中文名称标识字段类型长度是否可空备注行号rownumString50N姓名ownerString20N共有人partownerString50Y收入大类asettypeString50N参看标准代码表收入小类asetcomedetailString50N参看标准代码表收入年月asetmonthString1N参看标准代码表收入金额asetmoneyString16N可转数字是否计入财产isasetString1N参看标准代码表备注noteString50Y货币财产(moneya

17、set)中文名称标识字段类型长度是否可空备注行号rownumString50N所有人ownerstring20N共有人partownerstring50Y货币财产类型cointypestring50N参看标准代码表开户/发行单位organstring50Y币种moneytypestring50N参看标准代码表金额amountdouble16N是否计入财产isasetint1N参看标准代码表备注notestring255Y房产信息(houseinfoaset)中文名称标识字段类型长度是否可空备注行号rownumString50N所有人ownerstring20N共有人partownerstrin

18、g50Y房产性质housetypestring50N参看标准代码表房产用途usetypestring255N参看标准代码表地址houesaddrstring255N面积nareadouble16N购买时间buydateString50Y产权办理时间propertydateString50Y购买价costmoneydouble16Y房产证颁发部门issueunitstring50Y房产证编号housecodestring50Y是否计入财产isasetint1N参看标准代码表备注notestring255Y车辆信息(carinfoaset)中文名称标识字段类型长度是否可空备注行号rownumStr

19、ing50N第【6页所有人ownerString20N共有人partownerString50Y车辆品牌carbrandString50N车牌号carcodeString50N买入时间buydateString50N买入价格buymoneydouble50N是否计入财产isasetint1N参看标准代码表行驶里程mileageint8Y备注noteString255Y其他固定财产(othmoneyaset)中文名称标识字段类型长度是否可空备注行号rownumString50N所有人ownerstring20N共有人partownerstring50Y财产类型asettypestring50N财

20、产名称asetnamestring50N金额amountdouble16Y备注notestring255Y是否计入财产isasetint1N参看标准代码表5.1.2返回请求结果数据项中文名称标识字段类型长度是否可空备注返回代码returnCodestring10N参看标准代码表返回结果returnValuestring100N第 页第 页5.2核对结果查询服务数据项描述5.2.1请求数据项1.头部信息(head)中文名称标识字段类型长度是否可空备注请求用户名usernameString20Neicp_super密码passwordString不限N123456数据条数datacountStri

21、ng3N可转数字请求时间requestdateString19Nyyyy-MM-ddhh：mm：ss报文IDmesidString20N报文id2.批次信息中文名称标识字段类型长度是否可空备注申请区划pk_orgString20N批次委托编号batchentrustsnumString20N救助业务helptypenameString20N参看标准代码表核对类型chktypeString50N参看标准代码表5.2.2返回请求结果数据项中文名称标识字段类型长度是否可空备注批次委托编号batchentrustsnumString20N家庭委托编号trustnumberstring20N核对报告名称

22、reportnameStirng100N核对报告编号reportnumstring20Y核对报告内容reportdetailsStringIMNBase64编码或约定FTP路径标识(参考文件格式)核对报告路径reportpathString200N核对报告路径核对报告详细数据reportdataJson结构200Y参考与各救助部门反馈数据格式5.3核对退回结果查询服务数据项描述5.3.1请求数据项头部信息(head)中文名称标识字段类型长度是否可空备注请求用户名usernameString20Neicp_super密码passwordString不限N123456数据条数datacountSt

23、ring3N可转数字请求时间requestdateString19Nyyyy-MM-ddhh：mm：ss报文IDmesidString20N报文id批次信息中文名称标识字段类型长度是否可空备注申请区划pk_orgString20N救助业务helptypenameString20N参看标准代码表核对类型chktypeString50N参看标准代码表注：申请区划为市级行政区划代码3.2返回请求结果数据项中文名称标识字段类型长度是否可空备注家庭委托编号trustnumberstring20N核对编号checknumstring20N驳回意见rejectopinionstring200Y5.4核对退回

24、结果状态回写服务数据项描述5.4.1请求数据项5.头部信息(head)中文名称标识字段类型长度是否可空备注请求用户名usernameString20Neicp_super密码passwordString不限N123456数据条数datacountString3N可转数字请求时间requestdateString19Nyyyy-MM-ddhh：mm：ss报文IDmesidString20N报文id6.批次信息中文名称标识字段类型长度是否可空备注申请区划String20N家庭委托编号trustnumberstring20N核对编号checknumstring20N5.5核对接收救助系统认定结果服务

25、数据项描述5.5.1请求数据项1.头部信息(head)中文名称标识字段类型长度是否可空备注请求用户名usernameString20Neicp_super密码passwordString不限N123456数据条数datacountString3N可转数字请求时间requestdateString19Nyyyy-MM-ddhh：mm：ss报文IDmesidString20N报文id2.救助认定结果信息(affirmresults)中文名称标识字段类型长度是否可空备注行政区划pk_orgString20N家庭委托编号trustnumberstring50N救助业务helptypenamestrin

26、g20N参看标准代码表核对类型chktypestring20N参看标准代码表户主名称chknameStirng100N证件类型cardtypestring20N参看标准代码表证件号cardnumString18N反馈人姓名backnamestring50N反馈时间backdateString20N反馈状态编码statuscodeString2N参看反馈状态编码反馈状态内容statusvalueString20Y反馈信息feedbackmsgString500Y第 页第 页5.5.2反馈数据项核对反馈数据项：中文名称标识字段类型长度是否可空备注行政区划pk_orgString20N救助业务hel

27、ptypenameString20N家庭委托编号trustnumberString20N核对类型chktypeString20N返回代码returncodeString20N参看标准代码表5.6数据格式(JSON)5.6.1核对请求服务数据格式核对请求数据交换的JSON格式分为两个部分,head和batch其中，head和batch的格式如下：(注意：所有的JSON格式必须遵从严格的JSON规范,key、va/ue必须加収引号)head：(username：请求用户，password”：”请求密码,requestdate：请求时间”，msgid”：”报文ID”，”datacount”：”数据条

28、数,”batch”：(”pk_org”：”申请区划”,Hbatchentrustsnum：批次委托编号，helptypename：救助业务，entrustdate：”委托日期”，chkstartpeople：委托人，chkhousetotal：委托户数”，chkpeopletotal：委托人数二chktype：”核对类型”，wchkfastasetdatew：”核对收入开始日期”,HchklastasetdateH：M核对收入截至日期”,”chkasetdate”：”核对财产截至日期”，batchfile：rownum：行号”，uuid：附件主键”，filecontent”：”附件内容”，fi

29、lename：”附件名称二uploaddate：”上传日期二filetype：”附件类型二fileformat：”附件格式”，note：备注1,datum：(wapplynum”：核对申请编号，trustnumber：”家庭委托编号”，chkname：”户主名称”，cardtype：”证件类型二cardnum：”证件号码”，famtype”：户籍类型”，MfamofareaM：户籍所属省，famofcity：n户籍所属市，famofcounty：户籍所属县二famofstree：”户籍所属街道”，famofcomm：户籍所属社区二famaddressH：户籍地详细地址”，applydate：M

30、救助申请日期，liveaddress：”居住地址二tel：”联系电话二phone：”移动电话二socialcardnum：”社保通号”，famnum”：家庭人数”，tofamavgasset：”申报家庭人均收入”，tofamavgaset：”申报家庭人均资产”，tofamallasset：申报家庭总收入”，tofamasetM：”申报家庭总资产”，note”：”备注，familyinfo：(rownum：”行号”，name：姓名，age：年龄”,cardtype”证件类型二cardnum：证件号”，birthday：出生日期”，sex”：”性别二relation”：”与户主关系”，famtyp

31、e：”户籍类型二tel：”联系电活二socialcardnum：社保通号”,HedulevleH：文化程度”，HhealthstuM：,r健康状况”，marriagestu：H婚姻状况”，workability：劳动能力二jobstu：”就业情况”，workunitM：工作单位二addressarea：户籍地址，MliveareaM：居住地址”,fileinfo”：(rownumM：行号二uuid：-附件主键二filecontent：”附件内容”，filenamew：附件名称”，uploaddate：上传日期”，filetype”：”附件类型”，fileformat：-附件格式二note：w备

32、注”(,asetinfo：rownum：行号”，owner：姓名，asettype”：收入大类二asetcomedetail：”收入小类asetmonth：收入年月”，wasetmoneyM：M收入金额”，isaset,r：”是否计入财产”，note*：”备注”moneyaset：(rownum：行号”，owner：,所有人二Mpartownerw：共有人”，cointypew：货币财产类型二organ：”开户/发行单位，moneytype1：币种”，amount”：金额”，isaset：”是否计入财产”，note”：”备注,Mcarinfoaset：(rownum：行号”，owner”：”所

33、有人”，partowner：共有人二carbrandw：”车辆品牌”，carcodc：车牌号，buydate：,买入时间二wbuymoneyB：买入价格,isaset”：是否计入财产”，mileage：行驶里程”，note”：”备注”.第 页houseinfoaset：rownum,r：”行号”,owner”：”所有人二partowner：共有人，housetype：”房产性质二usetype：”房产用途”，Mhouesaddr：地址”，narea：”面积二buydate：购买时间”，propertydateM：w产权办理时间”,costmoney：购买价”，issueunit：”房产证颁发部

34、门二isaset：”是否计入财产”，note：”备注”，housecode”：”房产证编号”,othmoneyaset”：(rownum：”行号，owner：-所有人二partowner：共有人”，wasettypeM：财产类型”，Hasetname：财产名称二amount：金额”，note：”备注二isaset：是否计入财产返回委托数据结果json格式：returnCodeH：H返回代码，returnValue1：返回内容5.6.2核对结果查询服务数据格式查询请求json报文：(head”：(username：请求用户”，password”：”请求密码,Mrequestdatew：请求时间”

35、,msgid”：”报文ID”，datacount：w是否内部”,datum：(wpk_orgw：M申请区划”，batchentrustsnum：委托批次号”,helptypename：救助业务”，”chktype”：”核对类型”核对反馈json报文：trustnumber：”家庭委托编号”，assistchecknum：核对编号”，reportname：”核对报告名称”，returntype：返回类型”，reportnum：核对报吿编号，reportdetails：核对报告内容”，reportpath：核对报告路径”，reportdata：”核对报告数据项(json)I5.6.3核对退回结果查

36、询服务数据项描述查询请求json报文：(head：)username：”请求用户”，password：”请求密码”，requestdate：”请求时间”，MmsgidM：M报文ID”，datacount”：”是否内部,datum：(”pk_org”：”申请区划”，heIptypename：救助业务，chktype：”核对类型核对反馈json报文：entrustnum：”家庭委托编号,assistchecknum：核对编号”,rejectopinion：驳回意见”5.6.4核对退回结果状态回写服务数据项描述查询请求json报文：head：username：”请求用户”，HpasswordM：请求

37、密码”，nrequestdateM：请求时间，msgid：报文ID,datacount：”是否内部”,datum：（entrustnum：家庭委托编号”，assistchecknum：核对编号5.6.5）核对接收救助系统认定结果服务数据格式反馈结果请求报文：（wpk_orgM：行政区划二helptypenameM：救助业务”，trustnumber：家庭委托编号”，chktype”：”核对类型”，chkname：户主姓名”，cardtype：身份证件类型”，cardnum：身份证件号码”，backname：反馈人姓名，backdate”：”反馈时间，statuscode：”反馈状态编码”，st

38、atusvalue：”反馈状态内容，Hfeedbackmsg：反馈信息”核对反馈json报文：(npk_orgM：行政区划”,helptypename救助业务,Mtrustnumberw：w家庭委托编号，”chktype”：”核对类型”,nreturncoden：n返回代码5.7文件传输(FTP)5.7.1FTP服务FTP服务由核对方进行搭建，并开发在民政内网中。核对方提供FTP用户并对用户权限进行规划分配。救助部门需要将文件按照指定的目录存放,并确保文件的完整性。核对方取走文件后需要将FTP服务中的文件删除。5.7.2FTP文件服务架构第3()页第 页5.7.3文件存储规范文件存储规范按照一个批次一个文件夹，文件夹名称以批次委托编号命名；批次上的附件直接存储在批次文件夹下根目录下，批次中家庭附件以家庭委托编号创建文件夹，家庭附件直接放在家庭文件夹下；一个批次文件传输完成后，需要在批次文件夹根目录中生成传输完毕表示文件。文件服务器目录结构为：FTP服务器核对方提供救