HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.5.0 - Draft for Community Review

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## Ví dụ ClaimResponse: Ví dụ: Kết quả BHYT — Từ chối một phần (thuốc ngoài danh mục)

Profile: Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile

identifier: Mã phản hồi XML1 của Cổng tiếp nhận BHYT/XML1-20260322-000042

status: Active

type: Institutional

use: Claim

patient: Nguyễn Văn An

created: 2026-03-22

insurer: Bảo hiểm xã hội Việt Nam

request: Claim: extension = ,,Phí dịch vụ (FFS); identifier = Mã liên kết hồ sơ BHYT: VNMALK#LK-2026-000101; status = active; type = Institutional; subType = KCB đúng cơ sở nơi đăng ký KCB BHYT ban đầu; use = claim; created = 2026-03-17; priority = Normal

outcome: Partial Processing

> item

> itemSequence: 1

> > adjudication

> > category: Submitted Amount

> > ### Amounts

> > - | Value | Currency
> > * | 150000 | Vietnamese đồng

> > adjudication

> > category: Eligible Amount

> > ### Amounts

> > - | Value | Currency
> > * | 150000 | Vietnamese đồng

> > adjudication

> > category: CoPay

> > ### Amounts

> > - | Value | Currency
> > * | 30000 | Vietnamese đồng

> > adjudication

> > category: Benefit Amount

> > ### Amounts

> > - | Value | Currency
> > * | 120000 | Vietnamese đồng

> item

> itemSequence: 2

> > adjudication

> > category: Submitted Amount

> > ### Amounts

> > - | Value | Currency
> > * | 850000 | Vietnamese đồng

> > adjudication

> > category: Eligible Amount

> > ### Amounts

> > - | Value | Currency
> > * | 850000 | Vietnamese đồng

> > adjudication

> > category: CoPay

> > ### Amounts

> > - | Value | Currency
> > * | 170000 | Vietnamese đồng

> > adjudication

> > category: Benefit Amount

> > ### Amounts

> > - | Value | Currency
> > * | 680000 | Vietnamese đồng

> item

> itemSequence: 3

> > adjudication

> > category: Submitted Amount

> > ### Amounts

> > - | Value | Currency
> > * | 3200000 | Vietnamese đồng

> > adjudication

> > category: Eligible Amount

> > ### Amounts

> > - | Value | Currency
> > * | 2400000 | Vietnamese đồng

> > adjudication

> > category: CoPay

> > ### Amounts

> > - | Value | Currency
> > * | 480000 | Vietnamese đồng

> > adjudication

> > category: Benefit Amount

> > ### Amounts

> > - | Value | Currency
> > * | 1920000 | Vietnamese đồng

> total

> category: Submitted Amount

> ### Amounts

> - | Value | Currency
> * | 4200000 | Vietnamese đồng

> total

> category: Eligible Amount

> ### Amounts

> - | Value | Currency
> * | 3400000 | Vietnamese đồng

> total

> category: CoPay

> ### Amounts

> - | Value | Currency
> * | 680000 | Vietnamese đồng

> total

> category: Benefit Amount

> ### Amounts

> - | Value | Currency
> * | 2720000 | Vietnamese đồng

> payment

> type: Partial

> ### Amounts

> - | Value | Currency
> * | 2720000 | Vietnamese đồng

### Errors

- | ItemSequence | Code
* | 3 | Chi phí không đúng quy định pháp luật