Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

ラボコネクター

ラボレポート全体をCSV、HL7 v2 ORU^R01、またはJSONとして送信し、LOINCコードと参照範囲付きのラボObservationを取得。

ラボ（またはラボレポートを保持している組織）は、リクエスト全体でレポートを送信し、プラットフォームは各結果を患者の検査結果Observationに変換します。

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        (optional; recorded in Provenance)
Idempotency-Key: <report id>          (optional; a retry returns the same answer)

フォーマット

CSV ヘッダー行付き。区切り文字は , ; またはタブ。小数点コンマ、ISO形式の日付 DD.MM.YYYY または DD/MM/YYYY が使用可能です。認識されるカラム（ルーマニア語または英語）は以下の通りです：マーカー (analiza, test, marker, name) — または LOINC code カラムのみの場合、LOINC 名がマーカーになります — 値 (rezultat, valoare, value, result)、単位 (um, unitate, unit)、参照範囲 (interval, referinta: 70-100, <5, >3.5) または ref_low/ref_high、日付 (data, recoltare)、オプションの LOINC (loinc, code)、注釈。

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

HL7 v2 ORU^R01 (ER7 テキスト、セグメントは CR または LF で区切られます): OBX-3 識別子 (code^text^LN は LOINC; ローカルコード (^L, ^99zzz) またはその他のコーディングシステムは、ラボ独自のコードとして urn:anpheros:lab-code に保持されます)、OBX-5 値 (NM, SN、またはテキスト)、OBX-6 単位、OBX-7 参照範囲、OBX-8 異常フラグ → interpretation、OBX-11 ステータス、OBX-14 または OBR-7 日付; OBR-3/MSH-10 は Provenance のレポート ID になります。

ラボ。 各結果は、HL7 Europe Laboratory Report 2.1.0 が要求するように performer で生成元を名付けます：あなたが代表する組織 (X-Anpheros-Acting-As)、または HL7 の場合は MSH-4 (送信施設)、あるいは JSON の laboratory (トップレベルまたは項目ごと)。CSV はラボを含みません。そのような結果は、パフォーマーが欠落していることで検証されますが、それが真実です。

テキストレポート、ドキュメント、および日付の欠落。 テキストレポートが OBX ごとに 1 行で送信される場合 (TX/FT、同じ OBX-3)、結果は 1 つになり、行は結合されます。OBX-5 (ED、またはエンコードされた任意の Base64) のドキュメント全体は、結果として保存されません。応答は警告を発し、ドキュメントは /documents に属します。OBR-7 がない場合、結果は OBR-14 (検体受付) によって日付が付けられ、警告が表示されます。

時刻とタイムゾーン。 タイムゾーンのない v2 の時刻は、送信者のローカル時刻であり、UTC ではありません。OBX-14/OBR-7 (20260901081000+0300) と共に送信されるオフセットは保持されます (2026-09-01T08:10:00+03:00)。オフセットがない場合、MSH-7 のオフセットが使用され、その旨の警告が表示されます。オフセットがどこにもない場合、結果は日付のみを保持し、それにも警告が表示されます。CSV の時刻 (01.09.2026 08:10) はタイムゾーンを持たないため、日付のみとして保存されます。2026 年 10 月 17 日までは、そのような時刻は UTC としてラベル付けされていました。その時点でインポートされた結果は識別子を保持し、レポートが再度送信された場合でも認識されます。

まだ保留中 (OBX-11 I)、取得不可能 (X)、削除済み (D)、または誤り (W) の HL7 結果、および値のない OBX セグメントは、Observation にはなりません。それぞれが warnings で名前が付けられます。

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, "date": "2026-09-01", "code": "3016-3"}]}。

返却されるもの

{"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"}]}

マーカーは、レポートにLOINCコードが記載されている場合、または名前がプラットフォームの用語（ルーマニア語および英語の名前と一般的なエイリアス）と一致する場合にLOINCにマッピングされます。それ以外の場合は、ラボのコードがurn:anpheros:lab-codeの下にレポートの正確なテキストとともに保持され、unmappedにリストされるため、側でマッピングを改善できます。ラボ独自のコードは、そのラボと一緒の場合にのみ一意です。ソースシステムは、各ObservationのProvenance（X-Anpheros-Source-System）に記録されます。
名前はLOINCの名前および同義語（例: Hemoglobin A1c、Glycated hemoglobin、HDL cholesterol、LDL-C）と照合されます。複数の概念に一致する名前、または概念が持たない修飾子（urine、non-HDL、free、ratio…）を持つ名前は推測されません。ラボのコードが保持され、unmappedにリストされます。システムにLOINCコードがある場合は、常に送信してください。
Ureaとurea nitrogen (BUN)は異なる測定値です。Uree / Ureaはurea（LOINC 3091-6、またはmmol/Lの場合は22664-7）にマッピングされ、BUN / Urea nitrogen / Azot ureicはurea nitrogen（3094-0、またはmmol/Lの場合は14937-7）にマッピングされます。値は変換されません。
LDL cholesterol: メソッドのない名前は2089-1にマッピングされます。calculated / calculat / Friedewaldは計算LDL（13457-7）にマッピングされます。directは直接アッセイ（18262-6）にマッピングされます。メソッドは、Bilirubina directaのdirectのような修飾子であり、総ビリルビンではなく、ラボのコードが保持されます。
Glucose: ラボレポートの単なる「Glicemie」/「Glucose」は血清または血漿（LOINC 2345-7）にマッピングされます。毛細血管、指先穿刺、または全血（「capilar」、「sânge integral」）を示す名前は全血（2339-0）にマッピングされます。レポートのLOINCコードは常に優先されます。
各行には、レポートの内容（レポートID、レポートの名前とコード、日付、値、単位）から構築された安定した識別子（urn:anpheros:lab-import:v2）が付けられます。プラットフォームが選択したLOINCコードからは付けられないため、同じレポートを再送信しても、既にインポートされた行はスキップされます（skipped）。マッピングが改善された後でも同様です。これらのいずれかが異なる行（別のレポート、別の採取時間、別の値）は、別々に保持されます。2026年10月14日より前にインポートされた結果は、元の識別子を保持し、名前、日付、値、単位、レポートIDによって認識されます。レポートIDがない場合（CSV）、そのような一致はwarningsで報告されます。レポートID（HL7 OBR-3/MSH-10、JSON origin）を送信して、レポートを個別に管理してください。
各Observationには、author_type = import、ソースシステム、およびレポートIDを含むProvenanceが付随します。WebhookはObservationごとにresource.createdでトリガーされます。患者はアプリで結果を確認でき、同意したどのアプリでも結果を読むことができます。
リクエストあたり最大500行。

両方のSDK: labs.importCsv、labs.importHl7、labs.importItems。

CSVおよびHL7 v2レポートからFHIR Observationへのマッピング例、マッピングされていないマーカー、および再送信されたレポート: How to import laboratory results into a FHIR record。

ラボデータがラボ、クリニック、アプリ、AI間でどのように移動するか、およびラボ結果APIで確認すべきこと: Laboratory results API。

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card