深圳社会保险信息系统重构

深圳市社会保险信息系统重构应用软件系统开发项目接口规范V0.5建设单位：深圳市人力资源和社会保障局信息中心承建单位：万达信息股份有限公司监理单位：深圳市中联信息技术有限公司编制日期：2017年8月30日变更履历修改编号版本修改内容修改人修改日期1V0.1文档创建韦俊琳2017-8-302V0.2修改医保生育待遇系统接口邓香海2017-9-103V0.3增加卫计委、药监局等系统接口邓香海2017-9-224V0.4完善医保生育待遇系统接口出入参邓香海2017-10-195V0.5增加医保生育待遇系统接口及调整出入参邓香海2017-10-24目 录接入规范41.1.接口报文规范41.1.1.报文形式41.1.2.报文格式41.1.3.报文体格式说明41.1.4.服务调用规范51.2.结果代码51.3.交易单位列表51.4.接口业务类型定义规则5服务接口61.1.通用接口61.1.1.获取机构测试编码接口(YY001)6附录71.1.字典表73 接入规范1.1. 接口报文规范在进行信息交互时采用统一的报文结构，包括发送报文和接收报文。1.1.1. 报文形式交易报文采取json字符串的形式。数据格式：application/json; charset=UTF-8HTTP请求方法：post方式1.1.2. 报文格式入参出参 safeinfo: V1.0|应用服务器IP地址|用户名|密码, ywlx: 业务类型, jylsh: 交易流水号, input: aac001: , aac003: 姓名 , ireturn: , msgreturn: safeinfo: V1.0|应用服务器IP地址|用户名|密码, ywlx: 业务类型, jylsh: 交易流水号, output: aac001: , aac003: 姓名 , ireturn: , msgreturn: 1.1.3. 报文体格式说明1) 各个数据节点说明数据节点说明SAFEINFO填写V1.0|应用服务器IP地址|用户名|密码YWLX填写各个业务规定的业务类型，如YB900JYLSH消息的主键；格式FFFFYYYYMMDDHHMMSSNNNN，发送单位（见交易单位列表）+年月日时分秒+四位流水号；此编号由业务接口的发起方生成；返回时与发起相同；如“YY”INPUT入参对象，参见对应业务的入参OUTPUT出参对象，参见对应业务的入参IRETURN交易返回码，表示本业务处理成功，否则为本业务处理失败MSGRETURN交易错误信息，返回处理失败的原因或系统信息提示2) 报文中的重点参数说明a. 字符串类型varchar2(d1)。表示总长度为d1的字符串。1.1.4. 服务调用规范1.2. 结果代码结果代码说明EEEEE0报文长度有误EEEEE1报文格式有误SSSSSS网络错误NNNNNN未知系统错误成功业务异常1.3. 交易单位列表代码接入单位名称服务接口地址YY01预约系统1.4. 接口业务类型定义规则接口分类接口规则医保待遇系统接口YB+序号 服务接口1.1. 通用接口1.1.1. 新增测试机构接口(YB900)1) 接口类型实时服务接口2) 接口说明医保待遇系统提供接口，根据机构名称和机构类型获取机构测试编码。3) 接口调用方向主动方被动方预约系统医保待遇系统4) 入参定义序号名称指标是否允许为空数据类型(长度)释义1机构名称AKB021Nvarchar2(200)2机构类别AKB023Nvarchar2(2)字典5) 出参定义序号名称指标是否允许为空数据类型(长度)释义1机构测试编码AKB020Nvarchar2(5)2处理标志FLAGNvarchar2(4)0000 处理成功0001 处理失败3备注AAE013Yvarchar2(100)处理失败时返回失败原因附录1.1. 字典表1