灵医智惠CDSS高级版-病案质控API开发指南v2—同步（环节质控）API¶

产品功能	API	method	建议使用场景	涉及单据
同步（病案质控）API	病案质控提醒API	cdss-reminder-record-sync	全病案的环节质控场景	《数据Schema规范》的全部病历单据
质控消息驳回 API	质控消息驳回API	cdss-hpsdk-reject	全病案的环节质控场景	患者信息，工作人员信息
整改通知消息 API	整改通知消息	cdss-hpsdk-notice	全病案的环节质控场景	患者信息，工作人员信息

同步（环节质控）API功能¶

病案质控提醒API¶

Warning

01cdss.baidu.com仅用于开发、测试和联调，禁止用于真实线上/线下诊疗服务。
临床真实环境请使用医院内网私有化部署的正式服务。

API Protocol: HTTP
HTTP Server: http://01cdss.baidu.com
Request Path: /cdss/platform/api/v2
Request Headers: Authorization: 按照文档生成的签名 《API接口认证指南》
Request Method: POST
Content-Type: application/json; charset=utf-8
Request Body (emr格式参考文档《病案数据Schema规范》)

{
  "method": "cdss-reminder-record-sync",
  "emr": {},
  "params":[
      {
          "id_list":[
              "0xxxx"
          ],                     // 可选，指定执行一个或者多个质控点
          "merge_history": true  // 可选，是否合并历史缺陷，包括人工质控，已整改的缺陷
      }
  ] 
}

Response

{
  "code": 0,
  "message": "",
  "result": [
    {
      "msg_tag": "", // 提醒消息唯一标识
      "level": "notice/warning/error",    // 提醒级别
      "type": "文书",    // 提醒类型
      "defect_type": "编码质控/内涵质控/形式质控", // 缺陷大类
      "message": "入院记录入院时间不存在",    // 提醒详细内容
      "rule_id": "xxx",                    // 质控项id
      "rule_name": "入院记录存在缺项",        // 质控点名称
      "rule_type": "入院记录存在缺项",       // 缺陷类型
      "score": -1, // 扣分值
      "doc_name": "入院记录",  // 主要单据
      "doc_id": "xxxx",    // 主要单据的记录ID
      "defect_src": 0,     // 缺陷来源，0机器缺陷；1人工缺陷
      "defect_status": 0,  // 缺陷状态， 0-申诉通过；1-已整改；2-待整改；3-申诉驳回；4-临床申诉
      "appeal_status": 0,  // 申诉状态，0未申诉；1已申诉
      "appeal_msg": "",    // 申诉原因
      "reject_status": "", // 申诉驳回状态，-1申诉驳回；0未审核；1申诉成功
      "reject_msg": ""     // 申诉驳回原因
    }
  ]
}

质控消息驳回 API¶

质控消息驳回API¶

Warning

01cdss.baidu.com仅用于开发、测试和联调，禁止用于真实线上/线下诊疗服务。
临床真实环境请使用医院内网私有化部署的正式服务。

API Protocol: HTTP
HTTP Server: http://01cdss.baidu.com
Request Path: /cdss/platform/api/v2
Request Headers: Authorization: 按照文档生成的签名 《API接口认证指南》
Request Method: POST
Content-Type: application/json; charset=utf-8
Request Body (emr格式参考文档《病案数据Schema规范》)

{
  "method": "cdss-hpsdk-reject",
  "emr": {}, // 只需传患者信息，工作人员信息
  "params": [
      {
          "ignore": true/false, // 驳回/取消驳回
          "msg_tag": "",        // 提醒消息唯一标识
          "reject_reason": ""   // ignore == true，需填写驳回原因
      }
  ]
}

Response

{
  "code": 0 ,//驳回成功
  "message": ""
}

整改通知消息 API¶

整改通知消息API¶

Warning

01cdss.baidu.com仅用于开发、测试和联调，禁止用于真实线上/线下诊疗服务。
临床真实环境请使用医院内网私有化部署的正式服务。

API Protocol: HTTP
HTTP Server: http://01cdss.baidu.com
Request Path: /cdss/platform/api/v2
Request Headers: Authorization: 按照文档生成的签名 《API接口认证指南》
Request Method: POST
Content-Type: application/json; charset=utf-8
Request Body (emr格式参考文档《病案数据Schema规范》)

{
  "method": "cdss-hpsdk-notice",
  "emr": {}, // 只需传患者信息，工作人员信息
  "params": [
      {
          "page": 1,
          "page_size": 10
      }
  ]
}

Response

{
  "code": 0,
  "result": [
    {
      "total": 11, // 病历数
      "notice_msg_total": 11, // 总消息数
      "data": [
        {
          "rid": "", // 住院号
          "pid": "", // 就诊卡号
          "患者姓名": "",
          "性别": "",
          "入院时间": "",
          "notice_msg": [
            {
              "notice_timestamp": 1639728083, // 通知时间 时间戳
              "notice_type": "", // 质控催办/审核不通过
              "doc": [
                ""
              ], // 质控单据
              "reminder_time": "", // 质控时间
              "rule_name": "", // 质控点名称
              "message": "", // 提醒内容
              // notice_type == "质控催办"
              "urge_reason": "", // 通知消息
              // notice_type == "审核不通过"
              "reject_reason": "", // 驳回理由
              "access_reason": "" // 审核不通过理由
            }
          ]
        }
      ]
    }
  ]
}

错误码定义¶

code	错误类别	含义
0	正常	正常
1xxxx	语法错误	请求URI错误、参数缺失、参数格式错误
2xxxx	权限错误	鉴权失败、流量超过限制等
3xxxx	网络错误	某个网络服务出现连接失败、请求超时等
4xxxx	内部错误	内部异常、数据异常等

code	含义
0	正常（返回结果可能为空）
10100	method不存在
10200	请求参数异常，请仔细对照文档检查请求数据格式
20100	license过期，请联系灵医智惠CDSS商务人员重新申请
20200	权限异常，无权访问该资源
20300	异常流量
30100	服务连接异常，一般是某个依赖服务连接失败
30200	服务超时，请重试或者减少单次检索的数据量
40100	服务数据异常，内部错误
40200	代码抛异常
40300	未知异常
40400	初始化异常，启动失败
40500	配置异常，请检查配置文件
40600	不支持的资源