公卫软件三方软件交互-3.0

# 1、界面交互

可以在 HIS 、电子病历 中增加一些按钮，用于完成一些快捷的操作，该接口采集 Web API 方式，默认使用端口 7683 ，只需要访问指定的网址即可，可以使用浏览器打开来访问，也可以在程序中访问指定网址。本Web 服务由客户端软件提供，而非服务器提供，因此网址的地址应保持使用 localhost ，不能替换成服务器IP 地址。 端口可以根据医院需要调整。

接口访问网址

http://localhost:7683/api/Disease

请求的类型为 application/json; charset=utf-8 ，具体的请求数据和返回结果均采用 JSON 格式。

## 1.1 分析诊断是否需要上报

- 请求数据:
```js
{
	"操作": "分析诊断",
	"疾病类别": "传染病",
	"人员": { // 人员的识别信息
		"工号": "123",
	},
	"科室": { // 一般不需提供，如果就诊无法确定科室，则需要提供
		"编号": "1222"
	},
	"就诊": {
		"类别": "", // 住院 门诊 急诊 体检，根据类别提供 患者
		"患者号": "", // 患者号 就诊号 流水号 三者提供一个即可
		"就诊号": "",
		"流水号": ""
	},
	"类型": "入院诊断", // 门诊 急诊的类型为 诊断，住院患者可以为 入院诊断 出院诊断 // 病理诊断
	"条目": [{
		"名称": "",
		"编码": "",
		"类别": "", // 如主要诊断 其他诊断 中医诊断
	}, ……]
}
```

- 返回数据：
```js
{
	"完成": true,
	"应报": [{
			"病名 ": "乙肝 ",
			"立即上报": false
		},
		{
			"病名 ": "鼠疫 ",
			"立即上报": true
		}
	],
	"错误描述": "",
	"执行记录": ""
}
```

如果没有需要上报的疾病报卡，则返回 完成 : true , 应报为空数组，即 []。
如果有需要上报的传染病，则返回具体的传染病名称及是否需要立即处理，具体格式如：
 [
 {“病名”:“乙肝”, “立即上报” : false},
 {“病名”:“鼠疫”,”立即上报” : true}
]

其中
 病名 ：需要上报的传染病名称，
 立即上报 表示是否要求立即填报，如果该值为true, 则医生必须填报后才能继续其他操作。如果为 false 则可以由医生选择是否立即填报

请在 Content-Type 中指定字符集，默认为DBCS，建议使用 charset=utf-8。

## 1.2 确认是否已经完成填报

这个接口一般用于住院患者出院时确认已完成患者相关的传染病报卡，一般在开出院证时调用。

- 请求数据:
```js
{
	"操作": "待填报",
	"疾病类别": "传染病",
	"包含其他就诊": true,
	"人员": {
		"工号": "123",
	},
	"就诊": {
		"类别": "", //住院门诊急诊体检，根据类别提供患者
		"患者号": "", //患者号就诊号流水号三者提供一个即可
		"就诊号": "",
		"流水号": ""
	}
}
```

- 返回数据 ：

```js
{
 ”完成“ : true , // 执行正确返回 true 如果没有需报传染病， 则 应报 为空数组
 “应报” : [
 {“病名”:“乙肝”, “立即上报” : false},
 {“病名”:“鼠疫”,”立即上报” : true}
 ],
 “错误描述” : “”,
 “执行记录” : “”
}
```

## 1.3 启动公卫软件

1）启动公卫软件填报传染病报卡

- 请求数据 :
```js
{
 ”操作“ : “启动”,
 “调用者” : “系统名称”, // 主要用于区分不同的调用者
 “人员” : {
 “工号” : “112222”
 },
 “开始” : {
 “名称“ ：”填报传染病”,
 “就诊” : {
 “类别” ：”” , // 住院 门诊 急诊 体检，根据类别提供 患者
 “患者号” : “”, // 患者号 就诊号 流水号 三者提供一个即可
 “就诊号” : “”,
 “流水号” : “”
 }
 }
}
```

- 返回数据:

```js
{
 ”完成“ : true , //
 “错误描述” : “”,
 “执行记录” : “”
}
```

2）启动公卫软件完善患者信息

```js
{
 ”操作“ : “启动”,
 “调用者” : “系统名称”, // 主要用于区分不同的调用者
 “人员” : {
 “工号” : “112222”
 },
 “开始” : {
 “名称“ ：”患者信息完善”,
 “就诊” : {
 “类别” ：”” , // 住院 门诊 急诊 体检，根据类别提供 患者
 “患者号” : “”, // 患者号 就诊号 流水号 三者提供一个即可
 “就诊号” : “”,
 “流水号” : “”
 }
 }
}
```

- 返回数据:

```js
{
 ”完成“ : true , //
 “错误描述” : “”,
 “执行记录” : “”
}
```

## 1.4 登入

表明用户已经在该电脑上开始使用，在其他系统用户登录后调用

- 请求数据 :
```js
{
 ”操作“ : “登入”,
 “人员” : {
 “工号” : “112222”,
 “姓名” : “”
 },
 “显示界面” : true
}
```

- 返回数据：
```js
{
 ”完成“ : true , //
 “错误描述” : “”,
 “执行记录” : “”
}
```

## 1.5 登出

表明用户已经在该电脑上停止使用，在其他系统用户退出时调用

- 请求数据 :
```js
{
 “操作” : “登出”,
 “人员” : {
 “工号” : “112222”,
 “姓名” : “”
 },
 “关闭界面” : true
}
```

返回数据：

```js
{
 “完成” : true , //
 “错误描述” : “”,
 “执行记录” :””
}
```

## 1.6 申请单预检

- 请求数据:
```js
{
 “操作” : “申请单预检”,
 “就诊” : {
 “类别” ：”” , // 住院 门诊 急诊 体检，根据类别提供 患者
 “患者号” : “”, // 患者号 就诊号 流水号 三者提供一个即可
 “就诊号” : “”,
 “流水号” : “”
 },
 “申请单” : [
 {
 “名称” : “胸部CT”,
 “类别” : “检查”
 },
 {
 “名称” : “感染5项”,
 “类别” : “检验”
}
 ……
 ]
}
```

- 返回数据:
```js
{
 ”完成“ : true , //
 “需补充患者信息” : true, // 如果为 true 则应调用 1.3 2) 来完善患者的相关信息
 “错误描述” : “”,
 “执行记录” : “”
}
```

#  2 常用业务流程

1）传染病诊断预检

* 调用 1.1 如果返回 应报为

2）申请单预检( 用于门急诊)

* 调用 1.6 如果返回 需补充患者信息为 true ，则调用 1.3 2) 启动补充患者信息界面完善患者信息，如果返回 需补充患者信息为 false ，则直接进行后续操作

#  3 调用示例

C#代码的调用示例如下：

```java
 var web = new WebClient {
 Headers = {[HttpRequestHeader.ContentType] = "application/json; charset=utf-8"}, 
 Encoding = Encoding.UTF8
 };
 var r = web.UploadString("http://localhost:7683/api/Disease ", @"
{
 ““操作”” :“ “分析诊断”“,
 “”疾病类别”“ : ”“传染病”“,
 “”就诊”“ : {
 “”类别”“ ：””门诊”“,
 “”流水号”“: “”202203030001”“
 },
 “”类型”“ : “”诊断”“
 “”条目”“ : [
 {
 “”名称”“ : “”乙肝病毒性肝炎”“
 }
 ]
}
");

```