西湖区基金监管/门慢审核系统对接接口说明书

作者

1.病历审核接口

1.1.接口概述

向基金监管系统发送患者信息，返回审核结果

1.2.调用地址

http://ip:port/app_wheeljack_manager/medAudit

1.3.交互方式

采用HTTP请求post方式调用，json报文格式数据请求和响应。

交互时序图：
时序图

1.4.请求数据

1.4.1.请求头-Request Headers

参数名称 参数说明 数据格式 是否必传 备注
Net-Type 网络类型 字符串 否 只能传如下两种类型，如果不传，则默认为内网
Private-内网
Public-公网

1.4.2. requestbody

参数名称 参数说明 数据格式 是否必须 备注
sysCode 系统编码 varchar(50) 是 具体对接时，需和业务方约定
secretKey 密钥 varchar(64) 是 具体对接时，需和业务方约定
medBase 病历基本信息
stageType 阶段类型 varchar(10) 是 1-事前 2-事中 3-事后
businessType 业务类型 varchar(10) 是 1-飞检 2-门慢审核
medIstId 机构ID Int 是 具体对接时，需和业务方约定
projectId 项目ID varchar(32) 是 具体对接时，需和业务方约定
finalBilling 最终开单标识 VARCHAR(2) 是 最后确认开单时，传1，否则传0
hisid 院内结算单据号 VARCHAR(100) 是
mdtrtId 就诊ID varchar(64) 是
medClaimId 结算单ID varchar(64) stageType为3是必传
patientNo 住院号 varchar(40)
hospCode 医疗机构编码 varchar(32) 是
hospName 医疗机构名称 varchar(120) 是
hospLevel 医院级别 varchar(32) 否 一级，二级，三级
miCardNo 医保卡号 varchar(120)
idType 证件类型 varchar(18) 居民身份证,港澳台居民居住证,户口本等
idNo 证件号码 varchar(18)
patientName 患者姓名 varchar(60)
genderCode 性别，男/女/未知 varchar(30) 是 必须处理成汉字“男”“女”“未知”
birthDate 出生日期 datetime 是 格式：yyyy-MM-dd
age 年龄 varchar(20) 是
inDate 入院时间 datetime 否 格式：yyyy-MM-dd HH:mm:ss
inAreaName 入院病区名称 varchar(60)
inDeptName 入院科室名称 varchar(60)
outDate 出院时间 datetime 否 格式：yyyy-MM-dd HH:mm:ss
outAreaName 出院病区名称 varchar(60)
outDeptName 出院科室名称 varchar(60)
actualInDays 实际住院天数 varchar(20)
medType 就诊类型 Int 是 1-住院，2-门诊
miClass 就诊详细分类 varchar(60) 普通住院、意外伤害住院、生育保险、门诊慢特病、普通门诊统筹、普通门诊等类型
miIdentity 参保身份 varchar(60)
miTypeId 医保险种 varchar(60) 居民，职工，生育，工伤等
claimTime 结算时间 datetime stageType为3，必传 格式：yyyy-MM-dd HH:mm:ss 如果是事前、事中的病例数据，没有结算时间，需要处理成null，或者传当前时间； 数据库生成的默认值，例如：1900-01-01 00:00:00，也需要处理成null，或者传当前时间
claimType 结算类型 varchar(8) stageType为3，必传 例如正常、退费、冲正
totalFee 总费用 decimal(18,2) 是
mainDiagCode 主要诊断编码 varchar(120) 否
mainDiagName 主要诊断名称 varchar(120) 否 主要诊断名称和其他诊断名称至少填写一个字段
otherDiagCode 其他诊断编码 varchar(2000) 多个用;隔开
otherDiagName 其他诊断名称 varchar(2000) 多个用;隔开
medItemList 收费项目明细
clmItemId 项目明细ID varchar(32) 是 同一批次内必须唯一
chgTime 计费时间 datetime 是 格式：yyyy-MM-dd HH:mm:ss
chgItemTypeCode 收费项目类别编码 varchar(30) 否
chgItemTypeName 收费项目类别名称 varchar(120) 否 只能是如下14种类型：床位费、诊查费、检查费、化验费、治疗费、手术费、护理费、卫生材料费、西药费、中药饮片费、中成药费、一般诊疗费、挂号费、其他费；
chgItemCode 收费项目编码 varchar(1000) stageType为3，必传
chgItemName 收费项目名称 varchar(1000) 是
miItemCode 医保项目编码 varchar(1000) 是
miItemName 医保项目名称 varchar(1000) 是
spec 规格 varchar(120) 药品尽量有
dosageForm 剂型 varchar(120) 药品尽量有
gytjName 给药途径名称，口服、肌肉注射等 varchar(60) 药品尽量有
usageName 用法名称 （给药途径的备注，包括餐前、餐后、空腹、领药、带药、发药、出院带药） varchar(1000) 药品尽量有
freqName 频次名称 varchar(60) 尽量有
doseOnce 每次剂量 varchar(120) 尽量有
qtyTot 项目数量 varchar(30) 是
qtyTotUnit 项目数量单位 varchar(200) 否
unitPrice 单价 decimal(18,2) 是
cost 金额 decimal(18,2) 是
miCate 医保等级，甲乙丙 三种 varchar(30) 否
billingDeptId 开单科室编码 VARCHAR(30) 尽量有
billingDeptName 开单科室名称 VARCHAR(30) 尽量有
doctorId 开单医师编码 VARCHAR(30) 尽量有
doctorName 开单医师姓名 VARCHAR(30) 尽量有
dischargeMedication 出院带药标识 VARCHAR(30) 否 0否，1是，无为空
refundFlagType 退费标识 VARCHAR(2) 否 非退费为:0，退费单据为:1
refundHisid 退费冲销原结算单据号 VARCHAR(100) 否 如进行退费冲销，提供冲销的结算单据号HISID
recordInfoEffectCheck 是否取备案信息审核病历 Int 否 0：否 1：是 如果传空，则默认值为0
recordInfo 备案信息 否
personManagerNo 个人管理编码 varchar(64) 否
idNo 身份证号 varchar(18) 是
patientName 姓名 varchar(32) 否
phone 联系电话 varchar(11) 否
fixmedinsCode 备案医疗机构编号 varchar(32) 是
fixmedinsName 备案医疗机构名称 varchar(64) 是
diseCode 病种编码 varchar(32) 是
diseName 病种名称 varchar(64) 是
recordStartDate 备案起始日期 datetime 否 格式：yyyy-MM-dd
recordEndDate 备案终止日期 datetime 否 格式：yyyy-MM-dd

1.4.3. 参数示例

{
    "sysCode": "plat_001",
    "secretKey": "a852c40dc08042fb8776ca1c3f484ae7",
    "medBase": {
        "stageType": "1",
        "businessType": "1",
        "medIstId": 10001,
        "projectId": "1f7b5c38f61d4fc6a1f9a14628ba4337",
"finalBilling": "0",
"hisid": "211202030104TL25973588",
        "mdtrtId": "211202030104TL25973588",
        "medClaimId": "439884875",
        "patientNo": "13030011303020022794",
        "hospCode": "H21122100057",
        "hospName": "铁岭县中心医院",
        "hospLevel": "一级",
        "miCardNo": "2112009000021120200878941",
        "idType": "居民身份证",
        "idNo": "130728000000000015",
        "patientName": "张三",
        "genderCode": "女",
        "birthDate": "1945-11-23",
        "age": "77",
        "inDate": "2023-11-01 14:19:21",
        "inAreaName": "",
        "inDeptName": "",
        "outDate": "2023-11-01 14:19:21",
        "outAreaName": "",
        "outDeptName": "",
        "actualInDays": "5",
        "medType": 2,
        "miClass": "门诊统筹",
        "miIdentity": "",
        "miTypeId": "职工基本医疗保险",
        "claimTime": "2023-12-05 18:40:00",
        "claimType": "正常",
        "totalFee": "336.21",
        "mainDiagCode": "M54.502",
        "mainDiagName": "腰痛",
        "otherDiagCode": "M03900;M01600",
        "otherDiagName": "高血压病伴并发症;糖尿病"
    },
    "medItemList": [
        {
            "clmItemId": "211200202311011501113797552009",
            "chgTime": "2023-11-01 00:00:00",
            "chgItemTypeCode": "10",
            "chgItemTypeName": "中药饮片费",
            "chgItemCode": "30074",
            "chgItemName": "黄芪",
            "miItemCode": "T001700368",
            "miItemName": "黄芪",
            "spec": "",
            "dosageForm": "",
            "gytjName": "",
            "usageName": "",
            "freqName": "",
            "doseOnce": "1",
            "qtyTot": "126.0000",
            "qtyTotUnit": "",
            "unitPrice": "0.38",
            "cost": "47.25",
            "miCate": "乙类",
"billingDeptId": "code001",
"billingDeptName": "骨科",
"doctorId": "code_002",
"doctorName": "李四",
"dischargeMedication": "1",
"refundFlagType": "1",
"refundHisid": "211204094637TL25952589"
        }
    ],
    "recordInfoEffectCheck": 0,
    "recordInfo": [
        {
            "personManagerNo": "001",
            "idNo": "130728000000000015",
            "patientName": "张三",
            "phone": "18566666666",
            "fixmedinsCode": "H37100300456",
            "fixmedinsName": "威海市中心医院",
            "diseCode": "M00508",
            "diseName": "恶性肿瘤（内分泌治疗）",
            "recordStartDate": "2023-08-30",
            "recordEndDate": ""
        }
    ]
}

1.5. 返回结果

1.5.1. responseBody

参数名称 参数说明 备注
code 处理结果code -1：系统异常； -2：缺少备案信息，数据不完整，无法进行审核 0：请求成功
msg 处理结果描述信息
time 请求结果时间戳
data 结果数据
medicalDetailUrl 病案详情页面url链接 当finalBilling=1 url不进行弹出
admissionId 一次接口交互的流水号
mdtrtId 就诊ID
medClaimId 结算单ID
defectsResult 审核结果
viciousType 违规审核点编码
viciousName 违规审核点名称
detail 违规原因详细描述
illegalInfo 违规信息
illegalType 违规项目类别
illegalAmount 违规数量
illegalProjectNo 违规项目编码
illegalProject 违规项目名称
illegalFee 违规金额

1.5.2. 返回示例

{
    "code": "0",
    "msg": "成功",
    "time": "2021-03-03 10:10:10",
"data": {
"medicalDetailUrl": "http://ip:port/jjjg/freeViewMedicalDetail?encryptData=",
        "admissionId": "211299120220TL25939461",
        "mdtrtId": "211202030104TL25973588",
        "medClaimId": "439884875",
        "defectsResult": [
            {
                "viciousType": "1046",
                "viciousName": "低值耗材",
                "detail": "一次性使用无菌注射器带针属于低值耗材",
                "illegalInfo": {
                    "illegalType": "医用耗材",
                    "illegalAmount": "1",
                    "illegalProjectNo": "C16010110200003071870007810",
                    "illegalProject": "一次性使用无菌注射器带针",
                    "illegalFee": 0.33
                }
            }
        ]
    }
}

发表评论