랩 커넥터: HL7 v2, CSV 또는 JSON 형식의 검사 결과 보고서를 FHIR 관찰 항목으로 변환하는 방법

실험실은 통합 과정에서 단 하나의 작업을 수행합니다. 바로 환자의 기록에 검사 결과를 다시 입력하거나 참조 범위를 잃어버리거나 아무도 읽지 않는 형식을 만들어내지 않고 보고서를 전달하는 것입니다. Anpheros 실험실 커넥터는 실험실에서 이미 생성된 HL7 v2, CSV 또는 JSON 형식의 보고서를 받아 모든 결과를 LOINC 코드, 단위, 참조 범위, 날짜 및 수행자로 명시된 실험실 이름과 함께 FHIR Observation으로 변환합니다. 이 가이드는 계약서입니다.

개발자를 위한 기술 버전: 실험실 커넥터 · 검사 결과 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": ["매우 드문 마커"], "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 세그먼트는 Observation이 되지 않고 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: HL7 Europe Laboratory Report에서 요구하는 대로 소스 시스템, 보고서 ID 및 수행자가 기록됩니다.

환자가 보는 내용

결과는 개인의 기록에 표시되며, 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부터 시작하며, 첫 달은 무료입니다. 가격을 참조하세요.