HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Ví dụ: Đề nghị thanh toán BHYT cho khám sức khỏe định kỳ (hưởng 100%) — Example: insured periodic health check-up claim

Bản thô ttl | Tải xuống


@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# - resource -------------------------------------------------------------------

<http://hl7.org/fhir/Claim/ExampleClaimHealthCheckupBHYT> a fhir:Claim ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "ExampleClaimHealthCheckupBHYT"] ;
  fhir:Resource.meta [
     fhir:Meta.profile [
       fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim" ;
       fhir:index -1 ;
       fhir:link <http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim>
     ]
  ] ;
  fhir:Resource.language [ fhir:value "vi"] ;
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "extensions" ] ;
     fhir:Narrative.div "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: Claim ExampleClaimHealthCheckupBHYT</b></p><a name=\"ExampleClaimHealthCheckupBHYT\"> </a><a name=\"hcExampleClaimHealthCheckupBHYT\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-vn-core-claim.html\">Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile</a></p></div><blockquote><p><b>Tổng chi phí theo nhóm — Claim Cost Summary Extension</b></p><ul><li>totalInsurance: <span title=\"Vietnamese Dong\">₫400.000</span> (VND)</li><li>totalPatientCopay: <span title=\"Vietnamese Dong\">₫0</span> (VND)</li><li>totalPatientSelfPay: <span title=\"Vietnamese Dong\">₫0</span> (VND)</li><li>totalOtherFund: <span title=\"Vietnamese Dong\">₫0</span> (VND)</li></ul></blockquote><blockquote><p><b>Kỳ thanh toán — Claim Payment Period Extension</b></p><ul><li>year: 2026</li><li>month: 7</li></ul></blockquote><p><b>Phương thức thanh toán — Payment Method Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-method-cs 1}\">Phí dịch vụ (FFS)</span></p><p><b>identifier</b>: Mã liên kết hồ sơ BHYT/LK-2026-000512</p><p><b>status</b>: Active</p><p><b>type</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/claim-type professional}\">Professional</span></p><p><b>subType</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-patient-visit-type-cs 1.1}\">KCB đúng cơ sở nơi đăng ký KCB BHYT ban đầu</span></p><p><b>use</b>: Claim</p><p><b>patient</b>: <a href=\"Patient-ExamplePatientNguyenVanAn.html\">Nguyễn Văn An</a></p><p><b>created</b>: 2026-07-20</p><p><b>provider</b>: <a href=\"Organization-ExampleOrganizationChoRay.html\">Bệnh viện Chợ Rẫy</a></p><p><b>priority</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/processpriority normal}\">Normal</span></p><h3>Diagnoses</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Sequence</b></td><td><b>Diagnosis[x]</b></td><td><b>Type</b></td></tr><tr><td style=\"display: none\">*</td><td>1</td><td><span title=\"Codes:{http://hl7.org/fhir/sid/icd-10 Z00.0}\">Khám sức khoẻ tổng quát</span></td><td><span title=\"Codes:{http://terminology.hl7.org/CodeSystem/ex-diagnosistype principal}\">Principal Diagnosis</span></td></tr></table><h3>Insurances</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Sequence</b></td><td><b>Focal</b></td><td><b>Coverage</b></td></tr><tr><td style=\"display: none\">*</td><td>1</td><td>true</td><td><a href=\"Coverage-ExampleCoverageBHYTNew.html\">BHYT Nguyễn Văn An</a></td></tr></table><blockquote><p><b>item</b></p><blockquote><p><b>Thông tin chi phí BHYT — Insurance Cost Info Extension</b></p><ul><li>scope: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs 1}\">Trong phạm vi hưởng BHYT</span></li><li>paymentRatio: 100</li><li>benefitLevel: 100</li></ul></blockquote><p><b>sequence</b>: 1</p><p><b>category</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs 1}\">Khám bệnh</span></p><p><b>productOrService</b>: <span title=\"Codes:\">Khám sức khỏe định kỳ — khám lâm sàng tổng quát</span></p><h3>Nets</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>150000</td><td>Vietnamese đồng</td></tr></table><p><b>encounter</b>: <a href=\"Encounter-ExampleEncounterHealthCheckup.html\">Encounter: extension = Đúng tuyến; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-07-20-KSK-0031; status = finished; class = ambulatory (ActCode#AMB); type = Khám sức khoẻ định kỳ; period = 2026-07-20 08:00:00+0700 --&gt; 2026-07-20 10:30:00+0700; reasonCode = General medical examination</a></p></blockquote><blockquote><p><b>item</b></p><blockquote><p><b>Thông tin chi phí BHYT — Insurance Cost Info Extension</b></p><ul><li>scope: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs 1}\">Trong phạm vi hưởng BHYT</span></li><li>paymentRatio: 100</li><li>benefitLevel: 100</li></ul></blockquote><p><b>sequence</b>: 2</p><p><b>category</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs 3}\">Xét nghiệm</span></p><p><b>productOrService</b>: <span title=\"Codes:\">Xét nghiệm cơ bản đợt khám sức khỏe định kỳ (công thức máu, đường máu, chức năng gan thận)</span></p><h3>Nets</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>250000</td><td>Vietnamese đồng</td></tr></table><p><b>encounter</b>: <a href=\"Encounter-ExampleEncounterHealthCheckup.html\">Encounter: extension = Đúng tuyến; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-07-20-KSK-0031; status = finished; class = ambulatory (ActCode#AMB); type = Khám sức khoẻ định kỳ; period = 2026-07-20 08:00:00+0700 --&gt; 2026-07-20 10:30:00+0700; reasonCode = General medical examination</a></p></blockquote><h3>Totals</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>400000</td><td>Vietnamese đồng</td></tr></table></div>"
  ] ;
  fhir:DomainResource.extension [
     fhir:index -1 ;
     fhir:Element.extension [
       fhir:index -1 ;
       fhir:Extension.url [ fhir:value "totalInsurance" ] ;
       fhir:Extension.valueMoney [
         fhir:Money.value [ fhir:value "400000"^^xsd:decimal ] ;
         fhir:Money.currency [ fhir:value "VND" ]
       ]
     ], [
       fhir:index -1 ;
       fhir:Extension.url [ fhir:value "totalPatientCopay" ] ;
       fhir:Extension.valueMoney [
         fhir:Money.value [ fhir:value "0"^^xsd:decimal ] ;
         fhir:Money.currency [ fhir:value "VND" ]
       ]
     ], [
       fhir:index -1 ;
       fhir:Extension.url [ fhir:value "totalPatientSelfPay" ] ;
       fhir:Extension.valueMoney [
         fhir:Money.value [ fhir:value "0"^^xsd:decimal ] ;
         fhir:Money.currency [ fhir:value "VND" ]
       ]
     ], [
       fhir:index -1 ;
       fhir:Extension.url [ fhir:value "totalOtherFund" ] ;
       fhir:Extension.valueMoney [
         fhir:Money.value [ fhir:value "0"^^xsd:decimal ] ;
         fhir:Money.currency [ fhir:value "VND" ]
       ]
     ] ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-cost-summary" ]
  ], [
     fhir:index -1 ;
     fhir:Element.extension [
       fhir:index -1 ;
       fhir:Extension.url [ fhir:value "year" ] ;
       fhir:Extension.valueInteger [ fhir:value "2026"^^xsd:integer ]
     ], [
       fhir:index -1 ;
       fhir:Extension.url [ fhir:value "month" ] ;
       fhir:Extension.valueInteger [ fhir:value "7"^^xsd:integer ]
     ] ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-payment-period" ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method" ] ;
     fhir:Extension.valueCodeableConcept [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-method-cs" ] ;
         fhir:Coding.code [ fhir:value "1" ] ;
         fhir:Coding.display [ fhir:value "Phí dịch vụ (FFS)" ]
       ]
     ]
  ] ;
  fhir:Claim.identifier [
     fhir:index -1 ;
     fhir:Identifier.type [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs" ] ;
         fhir:Coding.code [ fhir:value "MA_LK" ] ;
         fhir:Coding.display [ fhir:value "Mã liên kết hồ sơ BHYT" ]
       ]
     ] ;
     fhir:Identifier.system [ fhir:value "http://fhir.hl7.org.vn/core/sid/ma-lk" ] ;
     fhir:Identifier.value [ fhir:value "LK-2026-000512" ]
  ] ;
  fhir:Claim.status [ fhir:value "active"] ;
  fhir:Claim.type [
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "http://terminology.hl7.org/CodeSystem/claim-type" ] ;
       fhir:Coding.code [ fhir:value "professional" ] ;
       fhir:Coding.display [ fhir:value "Professional" ]
     ]
  ] ;
  fhir:Claim.subType [
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-patient-visit-type-cs" ] ;
       fhir:Coding.code [ fhir:value "1.1" ] ;
       fhir:Coding.display [ fhir:value "KCB đúng cơ sở nơi đăng ký KCB BHYT ban đầu" ]
     ]
  ] ;
  fhir:Claim.use [ fhir:value "claim"] ;
  fhir:Claim.patient [
     fhir:link <http://hl7.org/fhir/Patient/ExamplePatientNguyenVanAn> ;
     fhir:Reference.reference [ fhir:value "Patient/ExamplePatientNguyenVanAn" ] ;
     fhir:Reference.display [ fhir:value "Nguyễn Văn An" ]
  ] ;
  fhir:Claim.created [ fhir:value "2026-07-20"^^xsd:date] ;
  fhir:Claim.provider [
     fhir:link <http://hl7.org/fhir/Organization/ExampleOrganizationChoRay> ;
     fhir:Reference.reference [ fhir:value "Organization/ExampleOrganizationChoRay" ] ;
     fhir:Reference.display [ fhir:value "Bệnh viện Chợ Rẫy" ]
  ] ;
  fhir:Claim.priority [
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "http://terminology.hl7.org/CodeSystem/processpriority" ] ;
       fhir:Coding.code [ fhir:value "normal" ] ;
       fhir:Coding.display [ fhir:value "Normal" ]
     ]
  ] ;
  fhir:Claim.diagnosis [
     fhir:index -1 ;
     fhir:Claim.diagnosis.sequence [ fhir:value "1"^^xsd:positiveInteger ] ;
     fhir:Claim.diagnosis.diagnosisCodeableConcept [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://hl7.org/fhir/sid/icd-10" ] ;
         fhir:Coding.code [ fhir:value "Z00.0" ] ;
         fhir:Coding.display [ fhir:value "General medical examination" ]
       ] ;
       fhir:CodeableConcept.text [ fhir:value "Khám sức khoẻ tổng quát" ]
     ] ;
     fhir:Claim.diagnosis.type [
       fhir:index -1 ;
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://terminology.hl7.org/CodeSystem/ex-diagnosistype" ] ;
         fhir:Coding.code [ fhir:value "principal" ] ;
         fhir:Coding.display [ fhir:value "Principal Diagnosis" ]
       ]
     ]
  ] ;
  fhir:Claim.insurance [
     fhir:index -1 ;
     fhir:Claim.insurance.sequence [ fhir:value "1"^^xsd:positiveInteger ] ;
     fhir:Claim.insurance.focal [ fhir:value "true"^^xsd:boolean ] ;
     fhir:Claim.insurance.coverage [
       fhir:link <http://hl7.org/fhir/Coverage/ExampleCoverageBHYTNew> ;
       fhir:Reference.reference [ fhir:value "Coverage/ExampleCoverageBHYTNew" ] ;
       fhir:Reference.display [ fhir:value "BHYT Nguyễn Văn An" ]
     ]
  ] ;
  fhir:Claim.item [
     fhir:index -1 ;
     fhir:Element.extension [
       fhir:index -1 ;
       fhir:Element.extension [
         fhir:index -1 ;
         fhir:Extension.url [ fhir:value "scope" ] ;
         fhir:Extension.valueCodeableConcept [
           fhir:CodeableConcept.coding [
             fhir:index -1 ;
             fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs" ] ;
             fhir:Coding.code [ fhir:value "1" ] ;
             fhir:Coding.display [ fhir:value "Trong phạm vi hưởng BHYT" ]
           ]
         ]
       ], [
         fhir:index -1 ;
         fhir:Extension.url [ fhir:value "paymentRatio" ] ;
         fhir:Extension.valueDecimal [ fhir:value "100"^^xsd:decimal ]
       ], [
         fhir:index -1 ;
         fhir:Extension.url [ fhir:value "benefitLevel" ] ;
         fhir:Extension.valueDecimal [ fhir:value "100"^^xsd:decimal ]
       ] ;
       fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info" ]
     ] ;
     fhir:Claim.item.sequence [ fhir:value "1"^^xsd:positiveInteger ] ;
     fhir:Claim.item.category [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs" ] ;
         fhir:Coding.code [ fhir:value "1" ] ;
         fhir:Coding.display [ fhir:value "Khám bệnh" ]
       ]
     ] ;
     fhir:Claim.item.productOrService [
       fhir:CodeableConcept.text [ fhir:value "Khám sức khỏe định kỳ — khám lâm sàng tổng quát" ]
     ] ;
     fhir:Claim.item.net [
       fhir:Money.value [ fhir:value "150000"^^xsd:decimal ] ;
       fhir:Money.currency [ fhir:value "VND" ]
     ] ;
     fhir:Claim.item.encounter [
       fhir:index -1 ;
       fhir:link <http://hl7.org/fhir/Encounter/ExampleEncounterHealthCheckup> ;
       fhir:Reference.reference [ fhir:value "Encounter/ExampleEncounterHealthCheckup" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Element.extension [
       fhir:index -1 ;
       fhir:Element.extension [
         fhir:index -1 ;
         fhir:Extension.url [ fhir:value "scope" ] ;
         fhir:Extension.valueCodeableConcept [
           fhir:CodeableConcept.coding [
             fhir:index -1 ;
             fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs" ] ;
             fhir:Coding.code [ fhir:value "1" ] ;
             fhir:Coding.display [ fhir:value "Trong phạm vi hưởng BHYT" ]
           ]
         ]
       ], [
         fhir:index -1 ;
         fhir:Extension.url [ fhir:value "paymentRatio" ] ;
         fhir:Extension.valueDecimal [ fhir:value "100"^^xsd:decimal ]
       ], [
         fhir:index -1 ;
         fhir:Extension.url [ fhir:value "benefitLevel" ] ;
         fhir:Extension.valueDecimal [ fhir:value "100"^^xsd:decimal ]
       ] ;
       fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info" ]
     ] ;
     fhir:Claim.item.sequence [ fhir:value "2"^^xsd:positiveInteger ] ;
     fhir:Claim.item.category [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs" ] ;
         fhir:Coding.code [ fhir:value "3" ] ;
         fhir:Coding.display [ fhir:value "Xét nghiệm" ]
       ]
     ] ;
     fhir:Claim.item.productOrService [
       fhir:CodeableConcept.text [ fhir:value "Xét nghiệm cơ bản đợt khám sức khỏe định kỳ (công thức máu, đường máu, chức năng gan thận)" ]
     ] ;
     fhir:Claim.item.net [
       fhir:Money.value [ fhir:value "250000"^^xsd:decimal ] ;
       fhir:Money.currency [ fhir:value "VND" ]
     ] ;
     fhir:Claim.item.encounter [
       fhir:index -1 ;
       fhir:link <http://hl7.org/fhir/Encounter/ExampleEncounterHealthCheckup> ;
       fhir:Reference.reference [ fhir:value "Encounter/ExampleEncounterHealthCheckup" ]
     ]
  ] ;
  fhir:Claim.total [
     fhir:Money.value [ fhir:value "400000"^^xsd:decimal ] ;
     fhir:Money.currency [ fhir:value "VND" ]
  ] .

<http://hl7.org/fhir/Patient/ExamplePatientNguyenVanAn> a fhir:Patient .

<http://hl7.org/fhir/Organization/ExampleOrganizationChoRay> a fhir:Organization .

<http://hl7.org/fhir/Coverage/ExampleCoverageBHYTNew> a fhir:Coverage .

<http://hl7.org/fhir/Encounter/ExampleEncounterHealthCheckup> a fhir:Encounter .

# - ontology header ------------------------------------------------------------

<http://hl7.org/fhir/Claim/ExampleClaimHealthCheckupBHYT.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl ;
  owl:versionIRI <http://build.fhir.org/Claim/ExampleClaimHealthCheckupBHYT.ttl> .