严重精神障碍患者管理治疗数据直报系统

**资料版本：**V2.3

**日 期：**2022年01月

**密 级：**🞎公开资料 🞎内部资料 🗹保密资料 🞎机密资料

**状 态：**🗹初稿 🞎讨论稿 🞎发布

**严重精神障碍患者管理治疗数据直报系统**

**HIS系统集成说明**

**四川互宜达科技有限公司**

四川互宜达科技有限公司版权所有，保留一切权利。
未经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档的部分或全部，并以任何形式传播。

# 1.说明

* 视图中字段名称含【编码】的，需要传入his标准字典项，便于做数据对照。
* 注：本文中API接口中的admCd、页面集成URL中的p1、视图中的TreatID为同一含义，为院内就诊唯一识别号（就诊记录流水号，非患者ID，每次就诊都应不一致）。

# 2.API接口定义
## 2.1报告卡填报验证接口

*  功能说明：根据HIS 提供的院内就诊唯一识别号（门诊\住院）、身份证号、患者姓名、诊断编码或诊断编码串（多条）、就诊类型、就诊日期，判断是否需要填报报告卡
*  请求地址：
* http://192.168.10.95/rest/ThridCtr/checkPatRptCard
*  请求方式：POST
*  请求参数

| 字段  | 类型  | 是否必须  | 说明 |
|---|---|---|---|
| admCd | String | 是 | 院内就诊唯一识别号（就诊记录流水号，非患者ID） |
| idCard | String | 是 | 身份证号码 |
| patId | String | 是 | 患者ID |
| visitTp | String | 是 | 门诊类型1：门诊  2：住院 |
| patNam | String | 是 | 患者姓名 |
| patSex | String | 是 | 性别（his标准字典项） |
| icdCode | Json | 是 |  院内诊断编码  {"code":“诊断编码“,"nam":“诊断名称“,"isMain":true, // 是否主要诊断}|
| deptId | String | 是 | 患者所在科室编码（his标准字典项） |
| docID | String | 是 | 医生HIS工号（唯一识别）（his标准字典项） |
| docNam | String | 是 | 医生姓名（说明：门诊为门诊医生，住院为住院经治医生） |
| visitDate   | String | 是 | 就诊日期，门诊为患者就诊日期，非挂号日期；住院时为入院日期。格式：YYYY-MM-DD |
| inNumber | String | 住院必须 | 住院次数 |
| costType | String | 是 | 费别 |
| inCode | String | 住院必须 | 住院号 |

*  请求样例
```js
{
	"admCd": "",
	"idCard": "",
	"patId": "",
	"patNam": "",
	"patSex": "",
	"icdCode":[{
			"code": "",
			"nam": "",
			"isMain": true,
		},
		{
			"code": "",
			"nam": "",
			"isMain": false,
		}
	],
	"deptId": "",
	"docId": "",
	"docNam": "",
	"visitTp": "",
	"visitDate": "",
	"inNumber": "",
	"costType": "",
	"inCode": ""
}
```

* 返回参数：
| 字段  | 类型  | 是否必须  | 说明 |
|---|---|---|---|
| code | int | 是 | 状态值 |
| message | String | 是 | 返回说明 |
| sign | boolean | 是 | 需要填报返回true,不需要填报返回false |

* 返回样例
```js
{
	"code": 200,
	"data": {
		"sign": true
	},
	"message": "OK"
}
```

## 2.2 报告卡填报查询接口

*  功能说明：根据HIS 提供的院内就诊唯一识别号（门诊\住院）、身份证号、患者姓名、诊断编码或诊断编码串（多条）、就诊类型、就诊日期，判断是否需要填报报告卡
*  请求地址：
* http://192.168.10.95/rest/ThridCtr/queryPatRptCard
*  请求方式：POST
*  请求参数：
| 字段  | 类型  | 是否必须  | 说明 |
|---|---|---|---|
| admCd | String | 是 | 院内就诊唯一识别号（就诊记录流水号，非患者ID） |
| idCard | String | 是 | 身份证号码 |

* 请求样例
```js
{
	"admCd": "",
	"idCard": "",
}
```

* 返回参数：
| 字段  | 类型  | 是否必须  | 说明 |
|---|---|---|---|
| code | int | 是 | 状态值 |
| message | String | 是 | 返回说明 |
| data |  | 是 | 返回系统中需要填报的报卡记录 |

* 返回样例
```js
{
	"code": 200,
    "data": {
		"sign": true
	},
	"message": "OK"
}
```
## 2.3 报告卡查询接口

*  功能说明：根据HIS提供的院内身份证号，查询前置机系统报告卡及出院单信息。
*  请求地址：
* http://192.168.10.95/rest/ThridCtr/queryPatCards
*  请求方式：POST
*  请求参数：
| 字段  | 类型  | 是否必须  | 说明 |
|---|---|---|---|
| idCards | Array | 是 | 身份证号码数组 |

* 请求样例
```js
{
   "idCards": ["530381199603275185","530381199603275185"]
}
```

* 返回参数：

| 字段  | 类型  | 是否必须  | 说明 |
|---|---|---|---|
| code | int | 是 | 状态值 200 成功 4000错误 |
| message | String | 是 | 返回说明 |
| data |  | 是 | 返回系统中需要填报的报卡记录 |

* 返回样例

**返回样例**
```js
{
	"code": 200,
	"data": {
		"530381199603275185": [ // 身份证号返回结果节点
			{ // 患者报告卡信息
				"fillCardDate": "2021-12-19", //填卡时间
				"linkNum": "51010600930670", // 报告卡号
				"patLeftRpt": [ // 患者出院单信息
					{
						"AdmissionDate": "2021-10-08", // 入院时间
						"createTime": "2021-12-19 21:06:03", // 创建时间
						"DischargeDate": "2021-12-07", // 出院时间
						"State": "已审核", // 在库状态
						"patName": "高春雨", // 患者姓名
						"patDisease": "精神分裂症，未定型", // 出院诊断
						"relateLinkNum": "51010600930670" // 报告卡号
					}
				],
				"createTime": "2021-12-19 21:04:47", // 创建时间
				"State": "已审核", // 在库状态（待完善、待审核、已审核）
				"patName": "高春雨", // 患者信息
				"patDisease": "精神分裂症，未定型" // 患者诊断
			}
		],
		"530381199603275185": [ // 查询身份证号返回结果节点
			{ // 患者报告卡信息
				"fillCardDate": "2021-12-19", //填卡时间
				"linkNum": "51010600930670", // 报告卡号
				"patLeftRpt": [ // 患者出院单信息
					{
						"AdmissionDate": "2021-10-08", // 入院时间
						"createTime": "2021-12-19 21:06:03", // 创建时间
						"DischargeDate": "2021-12-07", // 出院时间
						"State": "已审核", // 在库状态
						"patName": "高春雨", // 患者姓名
						"patDisease": "精神分裂症，未定型", // 出院诊断
						"relateLinkNum": "51010600930670" // 报告卡号
					}
				],
				"createTime": "2021-12-19 21:04:47", // 创建时间
				"State": "已审核", // 在库状态
				"patName": "高春雨", // 患者信息
				"patDisease": "精神分裂症，未定型" // 患者诊断
			}
		]
	}
	"message": "OK"
}
```
## 2.4 出院单填报查询接口

*  功能说明：根据HIS 提供的院内就诊唯一识别号（门诊\住院）、身份证号，查询前置机报卡信息
*  请求地址：
* http://192.168.10.95/rest/ThridCtr/queryPatLeftRpt
*  请求方式：POST
*  请求参数：
| 字段  | 类型  | 是否必须  | 说明 |
|---|---|---|---|
| admCd | String | 是 | 院内就诊唯一识别号（就诊记录流水号，非患者ID） |
| idCard | String | 是 | 身份证号码 |

* 请求样例
```js
{
	"admCd": "",
	"idCard": "",
}
```

* 返回参数：
| 字段  | 类型  | 是否必须  | 说明 |
|---|---|---|---|
| code | int | 是 | 状态值 |
| message | String | 是 | 返回说明 |
| data |  | 是 | 返回系统中已经填报的报告卡记录 |

* 返回样例
```js
{
	"code": 200,
	"data": [{ // 患者报告卡信息
		"linkNum": "",
		"createTime": "2022-01-20 02:42:09",
		"fillCardDate": "2022-01-19",
		"patIdCard": "510823199304286896",
		"State": "待审核",
		"patName": "xxxx",
		"patDisease": "阿尔茨海默病性痴呆（Ｇ30.－）",
		"admCd": "12345678"
	}],
	"message": "OK"
}
```

# 3. 界面集成模式

医生用户使用诊间医生工作站或住院医生工作站等HIS系统时，在发现患者诊断符合严重精神障碍六大类疾病时，可通过HIS界面跳转至直报系统录入界面进行报卡。因此需HIS系统提供访问直报系统的功能入口，如按钮、菜单功能项及自动化填报界面跳转功能。

![](/media/202403//1711415917.6707497.png)

直报系统为B/S架构业务应用，因此访问时需调用URL并传递相关参数，供直报系统界面调用HIS视图数据，定义如下：

界面路径示例：

http://ip:port/start/index.html#/quick/index/appid=bWLlOUJWLHP7aDm71rcWGxyHbj0IYdpahiUr86CfwwCmVQ2rGUl2EYdFK0n2ccIwnAHfmKzGTBXBnulU0H9mWr9bVjUReeiqmrK/type=1/owner=00000/p1=00202432/visitTp=1/depId=0123

| 名称 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| appid | 单点登陆识别码 | String | 如果不需要做单点登陆则固定传入示例代码，如果需要单点登陆，由 HIS 厂商提供登陆 KEY 验证接口。 |
| type | 业务类型 | String | 传入 1 代表患者报告卡，2 代表患者出院信息单 |
| owner | HIS 系统用户工号 | String |  |
| p1 | 院内就诊唯一识别号 | String |  |
| visitTp | 门诊类型1：门诊  2：住院 | String |  |
| depId | 患者所在科室 | String |  |

业务集成示意图：

![](/media/202403//1711415917.6833336.png)

# 4 重精患者管理治疗数据直报系统院内信息视图

## 4.1 视图列表
| 视图名称 | 视图描述 |
|---|---|
| V_PAT_RPTCARD | 患者报告卡 |
| V_PAT_LEFTRPT | 患者出院信息 |
| V_PAT_DRUG_MZ | 患者门诊用药 |
| V_PAT_DRUG_ZY | 患者住院用药 |
| USER_NAME | 医生用户信息 |
| DEPT_NAME | 院内科室信息 |

# 5 视图方法

## 5.1 V_PAT_RPTCARD患者报告卡所需医院就诊数据项

1其中带*号项目为需进行编码化传递的数据，只需传入医院系统中对应字典编码，术语经过注册和映射后，我方会进行转码处理。如医院不存在相应的编码，可直接传入我方提供的项目编码。

2带【】号项目作为业务关键信息在返回时**不能为空**，其他项目应尽量在医院系统中获取到相应信息进行填充，以提升用户使用效率

| 名称 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| TreatID | 患者就诊唯一标识码（门诊号或住院号） | String |  |
| OrganCd              | 机构编码 | String |  |
| PatNam               | 【患者姓名】 | String |  |
| IDCode               | 【身份证号】 | String |  |
| GenderCd             | 【性别编码】 | String |  |
| BrithDate                  | 出生日期 | String | yyyy-MM-dd |
| NationCd             | 民族编码* | String |  |
| NationalityCd | 国籍编码* | String |  |
| RegistertypeCd       | 户别编码* | String |  |
| MarriageCd           | 婚姻状况编码* | String |  |
| EmployCd             | 就业情况编码* | String |  |
| EducationCd          | 文化程度编码* | String |  |
| FamilyHisCd    | 有无两系三代精神疾病家族史* | String |  |
| GuardianNam          | 监护人/联系人姓名 | String |  |
| GuardianTel          | 监护人/联系人电话 | String |  |
| GuardianTelVice      | 监护人/联系人电话（副）| String |  |
| RelationshipCd       | 监护人/联系人与患者关系* | String |  |
| DProvinceCd          | 户籍地-省* | String |  |
| DCityCd              | 户籍地-市* | String |  |
| DCountyCd            | 户籍地-县* | String |  |
| DTownCd              | 户籍地-乡镇* | String |  |
| DAddress             | 户籍地-详细地址 | String |  |
| LProvinceCd          | 目前常住地-省* | String |  |
| LCityCd              | 目前常住地-市* | String |  |
| LCountyCd            | 目前常住地-县* | String |  |
| LTownCd              | 目前常住地-乡镇* | String |  |
| LAddress             | 目前常住地-详细地址 | String |  |
| FirstOnsetYear       | 初次发病日期-年（YYYY） | String |  |
| FirstOnsetMon        | 初次发病日期-月（MM） | String |  |
| FirstOnsetDay        | 初次发病日期-日（DD） | String |  |
| SenderBodyStr        | 送诊主体编码字符串* | String | 送诊主体编码字符串*", 可传入单个值，当送诊主体为多个时可用“,”符号进行连接，举例：SendClinSub001,SendClinSub004 |
| SenderOther          | 送诊主体其他描述 | String |  |
| IfCureCd           | 建档前是否已进行抗精神病药物治* | String |  |
| FirstCureYear        | 首次抗精神病药物治疗时间-年（YYYY） | String |  |
| FirstCureMon         | 首次抗精神病药物治疗时间-月（MM） | String |  |
| FirstCureDay         | 首次抗精神病药物治疗时间-日（DD） | String |  |
| LockStateCd          | 既往关锁情况编码* | String |  |
| HospStateHis         | 曾住精神专科/综合医院精神科次数 | String |  |
| RiskActCd            | 既往危险行为编码字符串*,  | String |  |
| RiskCd               | 既往危险评估编码*, | String |  |
| DiseaseCd            | 【诊断编码】*, | String |  |
| DiagnosisDate        | 【确诊日期】, | String | yyyy-MM-dd |
| DivisionCd           | 【报告来源】*, | String |  |
| IfNomedication       | 【是否勿需用药编码】* | String | 传入“否”的编码时，下一项用药情况不填写 |
| MedicineList         | 【用药情况】 | String | MedicineList备注|

传入药品的示例如下：
D001001|qn|无|无|30mg, 注：表示只是晚上用药
D001001|qd|40mg|无|无, 注：表示只是早上用药
D001001|bid|40mg|无|30mg, 注：表示只是早晚用药
D001001|tid|40mg|20ml|30mg, 注：表示早中晚用药
D001001|z|1|20ml|无, 注：表示只是以周为单位用药1为用药频率20ml为用药剂量
D001001|y|1|20ml|无, 注：表示只是以月为单位用药1为用药频率20ml为用药剂量
D001001|lz|1|20ml|无 注：表示只是2周为单位用药1为用药频率20ml为用药剂量
解读：其中绿色标识为HIS定义,互宜达做映射转码

## 5.2 V_PAT_LEFTRPT患者出院信息单所需医院就诊数据项
1 其中带*号项目为需进行编码化传递的数据，只需传入医院系统中对应字典编码，术语经过注册和映射后，我方会进行转码处理。如医院不存在相应的编码，可直接传入我方提供的项目编码。
2 带【】号项目作为业务关键信息在返回时不能为空，其他项目应尽量在医院系统中获取到相应信息进行填充，以提升用户使用效率

| 名称 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| TreatID | 患者就诊唯一标识码（门诊号或住院号） | String |  |
| OrganCd          | 机构编码 | String |  |
| PatNam           | 【患者姓名】 | String |  |
| IDCode           | 【身份证号】 | String |  |
| GenderCd         | 【性别编码】 | String |  |
| BirthDate              | 出生日期 | String | yyyy-MM-dd |
| NationalityCd | 【国籍编码】 | String |  |
| InPatNo          | 【病案号】 | String |  |
| AdmissionDate    | 【入院日期】 | String | yyyy-MM-dd |
| DischargeDate    | 【出院日期】 | String | yyyy-MM-dd |
| InMentalHos    | 曾住精神专科/综合医院精神科次数 | String |  |
| DischgDiagCd        | 【诊断编码】* | String |  |
| DischgDiagNam | 【HIS诊断名称】 | String |  |
| RiskActCd        | 既往危险行为编码字符串* | String |  |
| RiskCd           | 危险评估编码* | String |  |
| DiagnosisDate    | 【确诊日期】 | String | yyyy-MM-dd |
| EffectCd         | 住院疗效编码* | String |  |
| MeasuresCd       | 康复措施编码字符串* | String |  |
| OtherMeasure     | 康复措施其他描述 | String |  |
| IfNomedication1  | 【目前用药是否勿需用药编码】* | String | 传入“否”的编码时，下一项“目前用药情况”不填写。 |
| MedicineList1    | 【目前用药情况】* | String | 详见MedicineList1备注|
| IfNomedication2  | 【出院用药指导是否勿需用药编码】* | String | 传入“否”的编码时，下一项“用药指导”不填写 |
| MedicineList2    | 【出院用药指导】* | String | 最多传入6条用药记录。信息连接方式与目前用药情况相同，略 |
| DeptNam | 出院科室 | String |  |

MedicineList1备注：
最多传入6条用药记录，记录之间使用“,”进行连接。
 单条用药记录的各个数据项使用“|”进行连接，数据项分别为：
【药品编码】|【药品频次】| 【 用药明细早 或 服药周期用药频率 】|【用药明细中 或 服药周期剂量】 |【用药明细晚 或 无】
传入药品的示例如下：
D001001|qn|无|无|30mg, 注：表示只是晚上用药
D001001|qd|40mg|无|无, 注：表示只是早上用药
D001001|bid|40mg|无|30mg, 注：表示只是早晚用药
D001001|tid|40mg|20ml|30mg, 注：表示早中晚用药
D001001|z|1|20ml|无, 注：表示只是以周为单位用药1为用药频率20ml为用药剂量
D001001|y|1|20ml|无, 注：表示只是以月为单位用药1为用药频率20ml为用药剂量
D001001|lz|1|20ml|无 注：表示只是2周为单位用药1为用药频率20ml为用药剂量
解读：其中绿色标识为HIS定义,互宜达做映射转码

## 5.3 V_PAT_DRUG_MZ 门诊用药信息
用于医生使用院内系统工号登录直报系统。

| 名称 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| TreatID | 就诊号 | String |  |
| VisitTp         | 就诊类型 | String | 1 门诊 2 是住院 |
| DrugCode | 药品编号 | String |  |
| DrugNam | 药品名称 | String |  |
| Frequency | 频次 | String |  |
| Dose | 单次剂量 | String |  |
| DoseUnit | 单词剂量单位 | String |  |
| DrugMedWay | 用药方式 | String |  |

## 5.4  V_PAT_DRUG_ZY 住院用药信息
用于医生使用院内系统工号登录直报系统。

| 名称 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| TreatID | 就诊号 | String |  |
| VisitTp         | 就诊类型 | String | 1 门诊 2 是住院 |
| DrugCode | 药品编号 | String |  |
| DrugNam | 药品名称 | String |  |
| Frequency | 频次 | String |  |
| Dose | 单次剂量 | String |  |
| DoseUnit | 单词剂量单位 | String |  |
| DrugMedWay | 用药方式 | String |  |

## 5.5 USER_NAME医生用户信息
用于医生使用院内系统工号登录直报系统。

| 名称 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| NAME | 医生用户姓名 | String |  |
| USER_NAME         | 登录名 | String | 可采用his工号 |
| DEPTID | 用户科室编号 | String | His科室编号 |
| DEPT_NAME | 用户科室名称 | String |  |

## 5.6 DEPT_NAME 科室信息
用于医生使用院内系统获取对应科室信息。

| 名称 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| DEPTID | 用户科室编号 | String | His科室编号 |
| DEPT_NAME | 用户科室名称 | String |  |
| DEPT_TEL | 科室联系电话 | String |  |

## 5.7 V_PAT_LEFTRPT_INFO 出院信息
用于医生使用院内系统获取对应科室信息。

| 名称 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| TreatID | 就诊号 | String | 院内就诊唯一识别号（就诊记录流水号，非患者ID） |
| IDCode               | 身份证 | String |  |
| IsReadmission | 本次是否24小时再次入院、中转入院 | String | 返回true 或者false （本次入院时间和上次出院时间在24小时以内时为true，超过24小时为） |
| AdmissionDate | 入院时间 | String | YYYY-MM-DD HH:MM:SS |
| DischargeDate | 出院时间 | String | YYYY-MM-DD HH:MM:SS |

# 6 HIS系统页面集成示例

页面集成需求：门诊集成【患者报告卡】填报业务；住院集成【患者报告卡】、【出院信息单】填报业务：

其中【患者报告卡】业务需具备强制填报和主动填报入口。

强制填报：his先调用接口【2.1. 报告卡填报验证接口】，当接口返回true时，his系统自动打开患者报告卡集成界面；

主动填报：his系统具备通过按钮或菜单等其他形式支持直接患者报告卡集成界面（注：该处**不**调用接口【2.1. 报告卡填报验证接口】）；

其中【出院信息单】：his系统具备通过按钮或菜单等其他形式支持直接打开患者出院信息单集成界面。

集成示例参考（仅供参考，每家HIS系统不一致，且每家医院使用模式可能有所差异，需视具体情况沟通确认）：

1、患者报告卡：

1.1、门诊：

1.1.1、强制填报：门诊保存处方操作时调用【2.1.报告卡填报验证接口】，当返回true时，自动打开患者报告卡集成界面。

1. 1. 2、主动填报：门诊就诊界面上有一按钮可直接打开患者报告卡集成界面。

2.1、住院：

2.1.1、强制填报：集成在一个既能取到诊断又能取到医嘱信息的操作上，如保存医嘱或保存病案首页；

2.1.2、主动填报：住院就诊界面上有一按钮可直接打开患者报告卡集成界面。

2、出院信息单：只有住院业务才会有。住院就诊界面上有一按钮可直接打开出院信息单集成界面。

# 本次新增内容说明（仅针对成都四院说明）

新增接口：2.3.报告卡查询接口，2.4.出院单填报查询接口

新增视图：5.7. V\_PAT\_LEFTRPT\_INFO 出院信息

使用说明：

* 门诊和住院的病案首页界面的主动打开填报页面的【患者报告卡】按钮入口，调用接口【2.3.报告卡查询接口】，根据每个患者所返回的**// 患者报告卡信息** 节点的**State**信息进行his界面打开处理。

1、当**// 患者报告卡信息** 节点为空时，则自动打开报告卡填报页面

2、当存在“待完善”时，则提示“该患者尚存在待完善的患者报告卡，请继续完善”，再自动打开报告卡填报页面；

3、当**不**存在“待完善”**且**有其他值时，则提示“该患者已有患者报告卡，是否继续填报？”，用户点击“是”打开报告卡填报页面，点击“否”，则结束操作；

* 住院患者在医生进行出院通知时，根据所选择的患者信息调用接口【2.4.出院单填报查询接口】，根据返回的每个患者进行提示，若返回的有信息，则提示“【xx，xx】患者已有患者报告卡，请填写出院信息单”， 【xx，xx】可能一次为多个患者，每个患者用逗号隔开。

# 7 对接医院

| 医院 | 研发 | 工单 |
| --- | --- | --- |
| 成都市第四人民医院 | 张超 | 2407337,2408345 |
|  |  |  |
|  |  |  |