検査結果コネクター：HL7 v2、CSV、JSON形式の検査レポートが1回の申請でFHIR Observationになる方法

ラボラトリーが統合で果たすべき唯一の仕事は、レポートを患者さんの記録に、再入力することなく、参照範囲を失うことなく、誰も読まない形式をでっち上げることなく、取り込むことです。Anpherosラボコネクターは、ラボラトリーがすでに生成しているレポート（HL7 v2、CSV、またはJSON）を受け取り、すべての結果をFHIRのObservationに変換します。これにはLOINCコード、単位、参照範囲、日付、そして担当者としてのラボラトリー名が含まれます。このガイドはその契約書です。

開発者向けの技術情報: ラボコネクター · ラボ結果API は developers.anpheros.com にて、リクエスト、レスポンス、制限事項とともにご覧いただけます。このページは、平易な言葉での説明です。

1つのリクエスト

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セグメントは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で2回送信すると、同じ回答が得られ、重複は発生しません。
• すべての結果にProvenance: ソースシステム、レポートID、担当者は、HL7 Europe Laboratory Reportの要件どおりに記録されます。

患者さんが見るもの

結果は個人の記録に表示され、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から開始され、最初の月は無料です。詳細は料金をご覧ください。