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