实验室连接器：如何在一个请求中将 HL7 v2、CSV 或 JSON 格式的实验室报告转换为 FHIR 观察结果

实验室在集成中只有一个任务：将报告录入患者的病历中，无需重新输入，不丢失参考范围，也不创建无人阅读的格式。Anpheros 实验室连接器接收实验室已生成的报告（HL7 v2、CSV 或 JSON），并将每个结果转换为 FHIR Observation，包含 LOINC 代码、单位、参考范围、日期以及作为执行者的实验室名称。本指南即是此项服务的合同。

面向开发者的技术版本： 实验室连接器 · 实验室结果 API 托管在 developers.anpheros.com，包含请求、响应和限制。本页面为通俗易懂的版本。

单个请求

POST /v1/patients/{patient_id}/labs/import
Authorization: Bearer <project key>
Content-Type: text/csv | x-application/hl7-v2+er7 | application/json
X-Anpheros-Source-System: labx        (可选；记录在 Provenance 中)
Idempotency-Key: <report id>          (可选；重试将返回相同答案)

响应说明了操作结果：

{"created": 3, "skipped": 0, "unmapped": ["Marker foarte rar"], "warnings": [],
 "observations": [{"id": "…", "marker": "TSH", "code": "3016-3", "system": "http://loinc.org",
                   "value": 2.1, "unit": "mUI/L", "date": "2026-09-01"}]}

格式

HL7 v2 ORU^R01，以 ER7 文本格式。OBX-3 是标识符（code^text^LN 是 LOINC；本地代码将保留为实验室自己的代码），OBX-5 是值，OBX-6 是单位，OBX-7 是参考范围，OBX-8 是异常标志（将转换为 interpretation），OBX-11 是状态，OBX-14 或 OBR-7 是日期。MSH-4 命名发送方机构，该机构将成为执行者；OBR-3 和 MSH-10 将成为 Provenance 中的报告 ID。待处理、已删除或错误的（I、X、D、W）结果以及没有值的 OBX 段不会生成 Observations，并将列在 warnings 中。

CSV 带有标题行；分隔符为 ,、; 或制表符，接受小数点逗号，日期格式为 ISO、DD.MM.YYYY 或 DD/MM/YYYY。可识别的列（罗马尼亚语或英语）：marker、value、unit、reference range（70-100、<5、>3.5）或 ref_low/ref_high、date、可选的 LOINC 代码、note。CSV 文件不包含实验室信息，因此执行者会缺失，除非您发送 X-Anpheros-Acting-As。

Analiza;Rezultat;UM;Interval de referinta;Data
Hemoglobina glicozilata (HbA1c);6,4;%;4,0-5,6;01.09.2026
TSH;2,1;mUI/L;0,4-4,0;01.09.2026

JSON 当您已有结构化数据时：{"date": "2026-09-01", "origin": "report-77", "laboratory": "Synevo", "items": [{"marker": "TSH", "value": 2.1, "unit": "mUI/L", "ref_low": 0.4, "ref_high": 4.0, "code": "3016-3"}]}。

重要的映射规则

• 优先使用 LOINC 代码，否则按名称映射。 名称将与罗马尼亚语和英语的 LOINC 名称及同义词进行匹配。如果一个名称匹配多个概念，或包含概念不具备的限定词（如尿液、非 HDL、游离、比率），则不会进行猜测：它将保留实验室自己的代码，并使用 urn:anpheros:lab-code 前缀，同时出现在 unmapped 中，以便您可以在自己的系统上改进映射。如果可以提供 LOINC 代码，请务必发送。
• 值绝不进行转换。 尿素和尿素氮是不同的代码；直接 LDL 和计算 LDL 是不同的代码；来自血清的葡萄糖和来自毛细血管的葡萄糖是不同的代码。连接器将根据名称和方法选择正确的代码，并保持数字不变。
• 时间保留其时区。 带偏移量的 v2 时间将被保留；不带偏移量的，将使用 MSH-7 的偏移量并发出警告；如果任何地方都没有偏移量，则只存储日期。CSV 时间不包含时区，将作为日期存储。
• 幂等性。 使用相同的 Idempotency-Key 重复发送同一份报告，将获得相同的响应且不会产生重复记录。
• 每次结果都包含 Provenance 信息： 源系统、报告 ID 和执行者，符合 HL7 Europe 实验室报告的要求。

患者将看到的内容

结果将显示在患者的病历中，如果他们使用 Anpheros Daily，还会在手机上实时显示，包括参考范围和与之前报告的趋势。无需扫描，无需重新输入。如果结果异常，患者会看到标志；应用程序不会进行解释。

测试

沙盒环境是免费的，并且已包含合成患者的实验室历史记录。向其中一位患者发送一份报告，然后将其读回：

curl -X POST "$BASE/v1/patients/$PID/labs/import" -H "Authorization: Bearer $KEY" \
     -H "Content-Type: text/csv" --data-binary @report.csv
curl "$BASE/fhir/R4/Observation?patient=$PID&category=laboratory&_sort=-date" -H "Authorization: Bearer $KEY"

完整规范，包括 HL7 Europe 的符合性说明，请访问 developers.anpheros.com/guides/lab-connector。

常见问题

我们是否需要更改 LIS 的输出？

不需要。请按原样发送 ORU^R01 消息或 CSV 导出。如果您可以添加 LOINC 代码，请这样做；否则，连接器将按名称进行映射，并告知您无法映射的内容。

对于无法映射的结果怎么办？

它们将以实验室自己的代码和报告中的确切文本形式存储，因此不会丢失任何信息，并列在 unmapped 中，以便您下次可以添加 LOINC 代码。

是否保留参考范围和异常标志？

是的：范围将存储到 referenceRange，标志存储到 interpretation，单位将以 UCUM 格式存储，值绝不会被转换。

实验室是否可以发送非其创建的患者的结果？

仅在获得患者同意的情况下，或以项目代表的组织身份通过 X-Anpheros-Acting-As 进行。项目只能查看其创建的患者；其他所有内容都需要授权。

集成是否收费？

沙盒环境是免费的。生产环境的费用为每个组织每月 49 欧元起，首月免费；请参阅 定价。