脉景web版-HIS - 流程

log-image

1.脉景web版-HIS-发起门诊2.0版

概述: 调用此接口启动web端并自动登入医生的脉景账号,直接进入门诊页面并传入医生、患者、病历信息相关信息

说明:

1: 如HIS调此接口时,脉景web端已经登录了另一个账号,需要自动登出原账号,再登入此账号。

2: 如当前正在门诊过程中,则结束当前门诊,带入相关信息进入新门诊(3秒延时):

3: 同一HIS病历编号一一对应脉景病历code,多次发起生成不同病历ID(如已有病历,则是对原病历的修改;如已暂存,则是继续门诊; 但多次发起带入内容的机制是一样的,不用考虑脉景已经保存的或待继续病历的内容)

4: 静默登录无需签协议书

5: 医生跳转到脉景web端后,后续流程除了“病历及处方推送”之外,与医生自行打开门诊界面及后续操作一样(保存病历进入门诊报告页)

6: web打开了诊所门户,脉景咨询,签到等弹窗打开的页面未关闭,HIS切换账号并唤起web以后,应关闭这些弹出页面

测试环境接口地址:

https://qaapi.macrocura.com/interface-transformer/his/common/web/record/

预生产环境接口地址:

https://prepapi.macrocura.com/interface-transformer/his/common/web/record/

正式环境接口地址:

https://api.macrocura.com/interface-transformer/his/common/web/record/

请求方法: POST

请求参数位置: HTTP Body

请求参数格式: JSON

请求参数详情:

字段名 类型 是否必填 详细描述
app_id string 应用编码
app_secret string 应用秘钥
previous_his_record_id String 该患者在HIS 系统中上一次的问诊编号。如果是复诊,必传上次的问诊编号,初诊传 null。
his_record_id String 该患者在HIS系统中的当前问诊的编号,不可重复
institution Object 机构信息
department Object 科室信息
doctor Object 医生信息
patient Object 患者信息(如果此患者已存在,则选择已有患者;如此患者不存在则创建新患者)
record Object 病历信息

机构信息:

字段名 类型 说明 是否必填
outer_institution_code String HIS机构编码
outer_institution_name String HIS机构名称(50字限制)

科室信息:

字段名 类型 说明 是否必填
outer_department_code String HIS科室编码
outer_department_name String HIS科室名称(20字限制)

医生信息:

字段名 类型 说明 是否必填
outer_doctor_code String HIS医生编码(HIS系统里医生的工号)
outer_doctor_name String 医生姓名(20字限制)

患者信息:

字段名 类型 说明 是否必填
his_patient_id String(64) HIS患者编码
name String(64) 患者姓名(20字限制)
gender String 患者性别(男,女)
age Int 患者年龄(数值范围:0~120包含边界)
mobile String 患者手机号(限制11位以内数字)
idcard String(64) 患者身份证号 (如填写,限制15位或18位的数字或X)
sscid String(64) 患者医保卡号(50字限制)
province String 患者省份(20字限制)
city String 患者城市(20字限制)
area String 患者所在区(20字限制)
family_address String 患者详细地址 (50字限制)
contacts_name String(64) 患者联系人(20字限制)
contacts_mobile String(16) 患者联系人手机(如填写,限制11位以内数字)

病历信息:

字段名 类型 说明 是否必填
appointment_date Datetime 就诊时间 (示例:2022-08-22)
his_appointment_no String(128) 就诊卡号 (50字限制)
his_register_no String(128) HIS挂号单号 (50字限制)
patient_basic Object 病情信息
diagnose Object 诊断信息

病情信息:

字段名 类型 说明 是否必填
height int 身高(单位cm,数值范围:0~1000cm)
weight Float 体重(数值范围:0~1000kg)
temperature Float 体温(数值范围:0~1000℃)
heart_rate int 心率(数值范围:0~1000)
systolic_blood_pressure int 收缩压(数值范围:0~1000)
diastolic_blood_pressure int 舒张压(数值范围:0~1000)
main_remark String 主诉(1000字限制)
input_remark String 现病史(1000字限制)
objective_remark String 体格检查(1000字限制)
assist_check String 辅助检查(1000字限制)
disease_history String 既往史(1000字限制)

诊断信息:

字段名 类型 说明 是否必填
gbs array 中医诊断(只取3个)
syndrome Object 证型
therapy Object 治法
icd10s array 西医诊断

中医诊断:

字段名 类型 说明 是否必填
code String 中医诊断编码(如果需要,需提前提供映射信息)
name String 中医诊断名称

证型:

字段名 类型 说明 是否必填
code String 证型编码 (如果需要,需提前提供映射信息)
name String 证型名称

治法:

字段名 类型 说明 是否必填
code String 治法编码(如果需要,需提前提供映射信息)
name String 治法名称

西医诊断:

字段名 类型 说明 是否必填
code String 西医诊断编码 (如果需要,需提前提供映射信息)
name String 西医诊断名称

请求参数示例:

   {
    "app_id": "1701765999",
    "app_secret": "1e3b8d456d4914feaf366b7add326a1b",
    "previous_his_record_id": "",
    "his_record_id": 130,
    "institution": {
        "outer_institution_code": "njctzy",
        "outer_institution_name": ""
    },
    "department": {
        "out_department_code": "",
        "out_department_name": ""
    },
    "doctor": {
        "outer_doctor_code": "D0001",
        "outer_doctor_name": ""
    },
    "patient": {
        "his_patient_id": "133",
        "name": "wangzheng212",
        "gender": "女性",
        "age": 27,
        "mobile": "",
        "idcard": "",
        "sscid": "",
        "province": "上海",
        "city": "上海",
        "area": "静安",
        "family_address": "",
        "contacts_name": "",
        "contacts_mobile": ""
    },
    "record": {
        "appointment_date": "2022-07-03",
        "his_appointment_no": "wang",
        "his_register_no": "zheng",
        "patient_basic": {
            "height": "170",
            "weight": "60",
            "temperature": "36.5",
            "heart_rate": "",
            "systolic_blood_pressure": "120",
            "diastolic_blood_pressure": "180",
            "main_remark": "感冒",
            "input_remark": "易感冒",
            "objective_remark": "易感冒",
            "assist_check": "辅助检查",
            "disease_history": "zzz"
        },
        "diagnose": {
            "gbs": [
                {
                    "code": "A04.04.01.02",
                    "name": ""
                },
                {
                    "code": "",
                    "name": "肺衰病"
                }
            ],
            "icd10s": [
                {
                    "code": "A04.04.01.02",
                    "name": ""
                }
            ],
            "syndrome": {
                "code": "B01.07.",
                "name": ""
            },
            "therapy": {
                "code": "B01.07.",
                "name": ""
            }
        }
    }
}

返回结果成功示例:

{
    "code": 20000,
    "success": true,
    "msg": "成功",
    "data": {
        "code": "342b664e-f36b-42d3-8dbf-12c9f25665b0"
    },
    "reason": null
}

说明: 返回结果中code即是这次发起门诊的唯一识别code;继续通过此code访问脉景地址(通过重定向即可),即可实现免密登录并自动进入门诊;

注意: 调试的时候下面地址中的code需要替换成接口拿到的最新的code才能正常访问

测试环境访问脉景地址:

https://qapcwebtest.macrocura.com/emr/index.html?code=342b664e-f36b-42d3-8dbf-12c9f25665b0

预生产环境访问脉景地址:

https://preppcwebtest.macrocura.com/emr/index.html?code=342b664e-f36b-42d3-8dbf-12c9f25665b0

正式环境访问脉景地址:

https://pcwebnew.macrocura.com/emr/?code=342b664e-f36b-42d3-8dbf-12c9f25665b0

发起门诊页面如下:

log-image

输入诊断、症型、开处方后点击完成门诊页面如下:

log-image

返回结果失败示例:

{
    "code": 50000,
    "success": false,
    "msg": "字段类型错误:患者性别参数错误",
    "data": null,
    "reason": null
}





2.脉景web版-HIS-获取病历及处方2.0版

接口描述: HIS调此接口以获取脉景系统的病历及处方信息

测试环境调用地址:

https://qaapi.macrocura.com/interface-transformer/his/common/medical/record/detail/

预生产环境调用地址:

https://qaapi.macrocura.com/interface-transformer/his/common/medical/record/detail/

正式环境调用地址:

https://api.macrocura.com/interface-transformer/his/common/medical/record/detail/

请求方法: Post

请求参数位置: Http Body

请求参数格式: JSON

请求参数详情:

字段名 类型 是否必填 说明
app_id string 应用编码
app_secret string 应用秘钥
outer_institution_code string HIS机构编码
his_record_id string HIS病历编码

请求示例:

{
    "app_id": "1673432354",
    "app_secret": "3aa71e1f97f2598152c6eac5a1815c85",
    "outer_institution_code": "123456789",
    "his_record_id": "2371383e0064453694563e5ffe207f47"

}

返回参数位置: HTTP Body

返回参数格式: JSON

返回参数详情:

字段名 类型 说明
code number 返回的HTTP状态码
msg String 成功或是已知的失败原因时
data array 数据列表

数据列表:

字段名 类型 说明
his_record_id string HIS病历编码
institution Object 机构信息
department Object 科室信息
doctor Object 医生信息
patient Object 患者信息(如果此患者已存在,则选择已有患者;如此患者不存在则创建新患者)
record Object 病历信息

机构信息:

字段名 类型 说明
outer_institution_code String HIS机构编码(决定医生登录的机构,虚拟机构时可不填)
outer_institution_name String HIS机构名称(50字限制)

科室信息:

字段名 类型 说明
outer_department_code String HIS科室编码
outer_department_name String HIS科室名称(20字限制)

医生信息:

字段名 类型 说明
outer_doctor_code String HIS医生编码
outer_doctor_name String 医生姓名(20字限制)

患者信息:

字段名 类型 说明
his_patient_id String(64) HIS患者编码
name String(64) 患者姓名(20字限制)
gender String 患者性别(男,女)
age Int 患者年龄(数值范围:0~120包含边界)
mobile String 患者手机号(如填写,限制11位以内数字)
idcard String(64) 患者身份证号 (如填写,限制15位或18位的数字或X)
sscid String(64) 患者医保卡号(50字限制)
province String 患者省份(20字限制)
city String 患者城市(20字限制)
area String 患者所在区(20字限制)
family_address String 患者详细地址 (50字限制)
contacts_name String(64) 患者联系人(20字限制)
contacts_mobile String(16) 患者联系人手机(如填写,限制11位以内数字)

病历信息:

字段名 类型 说明
appointment_date Datetime 就诊时间 (示例:2022-08-22)
his_appointment_no String(128) 就诊卡号 (50字限制)
his_register_no String(128) HIS挂号单号 (50字限制)
patient_basic Object 病情信息
diagnose Object 诊断信息
tcm_prescription array(object) 中药处方
cpm_prescription array(object) 西中成药处方
treatment array(object) 治疗项目处方
note String 注意事项
invitation_date Date 复诊日期

病情信息:

字段名 类型 说明
height int 身高(单位cm,数值范围:0~1000cm)
weight Float 体重(数值范围:0~1000kg)
temperature Float 体温(数值范围:0~1000℃)
heart_rate int 心率(数值范围:0~1000)
systolic_blood_pressure int 收缩压(数值范围:0~1000)
diastolic_blood_pressure int 舒张压(数值范围:0~1000)
main_remark String 主诉(1000字限制)
input_remark String 现病史(1000字限制)
objective_remark String 体格检查(1000字限制)
assist_check String 辅助检查(1000字限制)
disease_history String 既往史(1000字限制)

诊断信息:

字段名 类型 说明
gbs array 中医诊断(只取3个)
syndromes Object 证型
therapys Object 治法
icd10s array 西医诊断

中医诊断:

字段名 类型 说明
code String 中医诊断编码
name String 中医诊断名称

证型:

字段名 类型 说明
code String 证型编码
name String 证型名称

治法:

字段名 类型 说明
code String 治法编码
name String 治法名称

西医诊断:

字段名 类型 说明
code String 西医诊断编码
name String 西医诊断名称

中药处方:

字段名 类型 说明
id int 脉景处方编码
prescription_reference_name string 处方参考名称
prescription_amount int 处方剂数
prescription_approach string 内服外用
taking_method string 处方服用方法
use_times int 每剂服用次数
processing_method_desc string 加工方法
decoction_capacity string 代煎容量
tcm array 中药

中药:

字段名 类型 说明
sku string 脉景药品编码
medicine_code string HIS药品编码(即商家药品编码,需要提前提供)
pharmacy_short string 药品简称
spu_name string 药品品名
type string 药品剂型,草药、颗粒或超微等
pharmacy_quantity Float 每剂药品数量, 单位为零售单位
pharmacy_unit string 零售单位
grams_of_corresponding_pieces Float 饮片克数
pharmacy_equivalent Float 药效当量(每零售单位相当于多少克饮片)
take_method_id_desc string 煎煮方法

西中成药处方:

字段名 类型 说明
id int 脉景处方编码
cpm Array 西中成药

西中成药:

字段名 类型 说明
sku string 脉景药品编码
medicine_code string HIS药品编码
pharmacy_short string 药品名称
specification string 药品规格装量
pharmacy_quantity Float 药品数量
dosage_route_desc string 用法
take_dosage Float 单次剂量
take_unit Float 剂量单位
medicine_frequency string 用药频次
medical_days Float 用药天数
equivalent Float 药效当量

治疗项目处方(适宜技术):

字段名 类型 说明
group_id string 治疗项目处方id
tame Array 项目内容

项目内容:

字段名 类型 说明
uuid string 脉景项目编码
his_code string HIS项目编码
treat_name string 项目名称 (实际使用的项目名称(1级或2级))
treat_price int 价格
treat_content int 项目内容
treat_count int 次数

返回参数示例:

{
    "code": 201,
    "msg": "成功",
    "success": true,
    "reason": null,
    "data": {
        "record": {
            "patient_basic": {
                "main_remark": "咳嗽2天,加重伴喘息、气促1天",
                "height": 170,
                "input_remark": "阵发性连声咳,咳时痰响,伴有喘息,稍有气促,无发绀,有鼻塞、流涕,无呕吐,无发热,自起病以来,精神食欲可,大小便正常,睡眠可。否认不洁饮食史,否认呛咳及异物吸入史。",
                "temperature": 36.5,
                "diastolic_blood_pressure": 180,
                "assist_check": "缺",
                "objective_remark": "T:36.9℃,R:40次/分,HR:133次/分,Wt:9.9kg,发育正常,营养中等,神志清楚,精神反应可。未见皮疹,手、足、臀部未见疱疹。皮肤弹性正常。全身浅表淋巴结无肿大。鼻翼无煽动。口唇红润,口腔黏膜光滑。咽部充血,双扁桃体I°肿大,未见脓性分泌物。颈软,可见三凹征。双肺呼吸音粗,对称,可闻及干湿啰音。心率133次/分,律齐,心音正常,腹稍隆,腹柔软,未触及包块,肝脾不大,肠鸣音正常。未见手足肿胀,四肢肌张力正常,卡痕阳性。克、布、巴氏征阴性。",
                "systolic_blood_pressure": 120,
                "weight": 60.0,
                "heart_rate": 123,
                "disease_history": "既往体质欠佳。2023.11.13-11.18因“肺炎支原体肺炎、腺病毒感染”在我科治疗,病情好转出院,否认病禽畜接触史,否认手足口病、结核、乙肝等传染病史及接触史。否认食物药物过敏史。否认外伤、手术史。否认输血及血液制品史,按计划免疫接种。"
            },
            "note": null,
            "invitation_date": null,
            "diagnose": {
                "therapy": {
                    "code": null,
                    "name": null
                },
                "syndrome": {
                    "code": null,
                    "name": null
                },
                "icd10s": [],
                "gbs": [
                    {
                        "name": "肺痿",
                        "uuid": "b81dd74b-06b4-4ac4-8714-b1378fb12cec",
                        "code": "A04.04.06"
                    }
                ]
            },
            "appointment_date": "2022-07-26",
            "tcm_prescription": [
                {
                    "prescription_reference_name": null,
                    "prescription_amount": 7,
                    "taking_method": "水煎内服(冷水浸泡,大火开锅改小火20~30分钟,煎两遍混在一起,分2~3次温服)。",
                    "prescription_approach": "内服",
                    "use_times": 2,
                    "tcm": [
                        {
                            "spu_name": "石见穿",
                            "pharmacy_short": "石见穿",
                            "grams_of_corresponding_pieces": 15,
                            "pharmacy_equivalent": 1.0,
                            "sku": "a90ccbf8218211ef8eeb00163e25c208",
                            "pharmacy_unit": "g",
                            "pharmacy_quantity": 15,
                            "take_method_id_desc": "先煎",
                            "type": "草药",
                            "medicine_code": "58365",
                            "take_method_code": "479"
                        }
                    ],
                    "processing_method_desc": "自煎",
                    "id": 1311863,
                    "decoction_capacity": null,
                    "processing_method_code": "1"
                }
            ],
            "treatment": [
                {
                    "group_id": "75a9529ff509495a8d120c94270bee49",
                    "items": [
                        {
                            "uuid": "f15ebe57-706d-4cc5-a2e0-ff24f71fc81c",
                            "treat_name": "针灸",
                            "treat_price": "5.00",
                            "treat_content": "123",
                            "treat_count": 2
                        },
                        {
                            "uuid": "ce97a27e-9ad6-4744-beca-fab7bfb39f16",
                            "treat_name": "针灸子项",
                            "treat_price": "2.00",
                            "treat_content": "43546",
                            "treat_count": 1
                        }
                    ]
                }
            ],
            "his_appointment_no": "wang",
            "his_register_no": "zheng",
            "cpm_prescription": null,
            "group": [
                {
                    "group_code": "0316",
                    "group_name": "大便",
                    "feature_code": "1",
                    "feature_name": "大便调"
                },
                {
                    "group_code": "0317",
                    "group_name": "小便",
                    "feature_code": "1",
                    "feature_name": "小便可"
                }
            ]
        },
        "doctor": {
            "outer_doctor_code": "999",
            "outer_doctor_name": "滕医生"
        },
        "department": {
            "outer_department_name": null,
            "outer_department_code": null
        },
        "institution": {
            "outer_institution_name": "龙游县中医医院",
            "outer_institution_code": "lyxzyyy"
        },
        "his_record_id": "11",
        "patient": {
            "name": "wa12212",
            "age": 27,
            "province": "上海市",
            "contacts_name": "",
            "mobile": "11111111111",
            "area": "静安区",
            "family_address": "",
            "city": "上海市",
            "idcard": "",
            "his_patient_id": "30",
            "contacts_mobile": "",
            "gender": "女",
            "sscid": ""
        }
    }
}
By Macrocura, Copyright © 2020 all right reserved,powered by Gitbook            Last update: 2024-06-26 17:02:42