推送检验报告

POST

/open/v1/lab/reports

请求地址：POST https://hdis.api.yijiangsoft.com/open/v1/lab/reports（院内离线部署时，替换为院内服务器地址）

一次请求不超过 100 份报告，每份报告不超过 500 个检验项，请求体不超过 4 MB。
报告逐条校验、逐条入库，个别报告出错不影响其余报告；以相同 externalId 重推视为覆盖更新。
患者无法匹配时报告照常保存并进入待认领队列，返回 matched: false，无需重推。

请求参数

Body 参数application/json必填

示例

{
    "reports": [
        {
            "externalId": "LIS20260901000123",
            "reportNo": "20260901000123",
            "patient": {
                "idCard": "330102199001011234",
                "name": "张三",
                "hisPatientId": "0000123456"
            },
            "panelName": "肾功能+电解质",
            "specimen": "SERUM",
            "collectedAt": "2026-09-01 07:35:00",
            "reportedAt": "2026-09-01 09:12:00",
            "status": "FINAL",
            "labName": "检验科",
            "reporter": "李四",
            "reviewer": "王五",
            "items": [
                {
                    "itemCode": "0231",
                    "itemName": "血红蛋白",
                    "value": 98,
                    "unit": "g/L",
                    "refLow": 115,
                    "refHigh": 150,
                    "abnormalFlag": "L"
                },
                {
                    "itemCode": "0455",
                    "itemName": "血钾",
                    "value": 5.8,
                    "unit": "mmol/L",
                    "refLow": 3.5,
                    "refHigh": 5.3,
                    "abnormalFlag": "H"
                },
                {
                    "itemCode": "1180",
                    "itemName": "HBsAg",
                    "value": "阴性",
                    "resultType": "QUALITATIVE"
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/open/v1/lab/reports' \
--header 'Content-Type: application/json' \
--data '{
    "reports": [
        {
            "externalId": "LIS20260901000123",
            "reportNo": "20260901000123",
            "patient": {
                "idCard": "330102199001011234",
                "name": "张三",
                "hisPatientId": "0000123456"
            },
            "panelName": "肾功能+电解质",
            "specimen": "SERUM",
            "collectedAt": "2026-09-01 07:35:00",
            "reportedAt": "2026-09-01 09:12:00",
            "status": "FINAL",
            "labName": "检验科",
            "reporter": "李四",
            "reviewer": "王五",
            "items": [
                {
                    "itemCode": "0231",
                    "itemName": "血红蛋白",
                    "value": 98,
                    "unit": "g/L",
                    "refLow": 115,
                    "refHigh": 150,
                    "abnormalFlag": "L"
                },
                {
                    "itemCode": "0455",
                    "itemName": "血钾",
                    "value": 5.8,
                    "unit": "mmol/L",
                    "refLow": 3.5,
                    "refHigh": 5.3,
                    "abnormalFlag": "H"
                },
                {
                    "itemCode": "1180",
                    "itemName": "HBsAg",
                    "value": "阴性",
                    "resultType": "QUALITATIVE"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

业务结果见 code；code 为 200 时逐条结果见 data.results

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "操作成功",
    "data": {
        "total": 2,
        "accepted": 2,
        "rejected": 0,
        "results": [
            {
                "externalId": "LIS20260901000123",
                "status": "CREATED",
                "matched": true,
                "patientRef": "P202600123",
                "itemsMapped": 3,
                "itemsUnmapped": 1
            },
            {
                "externalId": "LIS20260901000124",
                "status": "UPDATED",
                "matched": false,
                "pendingReason": "身份证号在本院透析患者中未找到，已进待认领"
            }
        ]
    },
    "timestamp": 1756684800123
}

修改于 2026-09-15 09:08:29

推送检查报告