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