HL7 Vietnam VN Core FHIR Implementation Guide

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

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

: Loại tổng hợp adjudication BHYT — BHYT Adjudication Category CodeSystem

Active tại thời điểm 2026-04-23

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/CodeSystem/vn-bhyt-adjudication-category-cs> a fhir:CodeSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "vn-bhyt-adjudication-category-cs"] ;
  fhir:Resource.language [ fhir:value "vi"] ;
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "generated" ] ;
     fhir:Narrative.div "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem vn-bhyt-adjudication-category-cs</b></p><a name=\"vn-bhyt-adjudication-category-cs\"> </a><a name=\"hcvn-bhyt-adjudication-category-cs\"> </a><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs</code> defines the following codes:</p><table class=\"codes\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td><td><b>English (English, en)</b></td></tr><tr><td style=\"white-space:nowrap\">patient-self-pay<a name=\"vn-bhyt-adjudication-category-cs-patient-self-pay\"> </a></td><td>Người bệnh tự trả</td><td>Phần người bệnh tự trả ngoài phần cùng chi trả BHYT (`T_BNTT`).</td><td>Patient self-pay</td></tr><tr><td style=\"white-space:nowrap\">other-fund<a name=\"vn-bhyt-adjudication-category-cs-other-fund\"> </a></td><td>Nguồn khác</td><td>Phần chi phí từ nguồn khác (`T_NGUONKHAC`). Breakdown theo nguồn cụ thể cần extension hoặc model bổ sung khi pilot yêu cầu.</td><td>Other source</td></tr><tr><td style=\"white-space:nowrap\">non-covered<a name=\"vn-bhyt-adjudication-category-cs-non-covered\"> </a></td><td>Ngoài phạm vi/ngoài định suất</td><td>Chi phí ngoài phạm vi hoặc ngoài định suất theo hồ sơ BHYT (`T_NGOAIDS`); không đồng nhất với deductible.</td><td>Out-of-scope/out-of-capitation</td></tr><tr><td style=\"white-space:nowrap\">medication-subtotal<a name=\"vn-bhyt-adjudication-category-cs-medication-subtotal\"> </a></td><td>Tổng thuốc, dịch truyền</td><td>Subtotal nhóm thuốc/dịch truyền (`T_THUOC`), dùng cho total/cost summary thay vì line-level adjudication.</td><td>Total medications and infusion fluids</td></tr><tr><td style=\"white-space:nowrap\">supplies-subtotal<a name=\"vn-bhyt-adjudication-category-cs-supplies-subtotal\"> </a></td><td>Tổng vật tư/thiết bị y tế</td><td>Subtotal nhóm vật tư/thiết bị y tế (`T_VTYT`), dùng cho total/cost summary thay vì line-level adjudication.</td><td>Total medical supplies/equipment</td></tr></table></div>"
  ] ;
  fhir:DomainResource.extension [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis" ] ;
     fhir:Extension.valueCoding [
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs" ] ;
       fhir:Coding.code [ fhir:value "QD-3176-2024" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis" ] ;
     fhir:Extension.valueCoding [
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs" ] ;
       fhir:Coding.code [ fhir:value "QD-697-2026" ]
     ]
  ] ;
  fhir:CodeSystem.url [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs"] ;
  fhir:CodeSystem.identifier [
     fhir:index -1 ;
     fhir:Identifier.system [ fhir:value "urn:ietf:rfc:3986" ] ;
     fhir:Identifier.value [ fhir:value "urn:oid:2.25.161089673617632664299011809196868855799.16.5" ]
  ] ;
  fhir:CodeSystem.version [ fhir:value "0.8.0"] ;
  fhir:CodeSystem.name [ fhir:value "VNBHYTAdjudicationCategoryCS"] ;
  fhir:CodeSystem.title [ fhir:value "Loại tổng hợp adjudication BHYT — BHYT Adjudication Category CodeSystem"] ;
  fhir:CodeSystem.status [ fhir:value "active"] ;
  fhir:CodeSystem.experimental [ fhir:value "false"^^xsd:boolean] ;
  fhir:CodeSystem.date [ fhir:value "2026-04-23"^^xsd:date] ;
  fhir:CodeSystem.publisher [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative"] ;
  fhir:CodeSystem.contact [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://hl7.org.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "info@hl7.org.vn" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech (OmiGroup)" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omihealthtech.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omigroup.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "info@hl7.org.vn" ]
     ]
  ] ;
  fhir:CodeSystem.description [ fhir:value "Danh mục bổ sung cho các loại tổng hợp tài chính BHYT không có mã tương đương chính xác trong HL7 Terminology `adjudication`. Các mã này dùng chủ yếu cho `ClaimResponse.total`, `ExplanationOfBenefit.total` hoặc cost summary, không thay thế adjudication logic của payer."] ;
  fhir:CodeSystem.jurisdiction [
     fhir:index -1 ;
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "urn:iso:std:iso:3166" ] ;
       fhir:Coding.code [ fhir:value "VN" ] ;
       fhir:Coding.display [ fhir:value "Viet Nam" ]
     ]
  ] ;
  fhir:CodeSystem.copyright [ fhir:value "VN Core local terminology; based on financial fields in QĐ 3176/QĐ-BYT and QĐ 697/QĐ-BYT mapping requirements."] ;
  fhir:CodeSystem.caseSensitive [ fhir:value "true"^^xsd:boolean] ;
  fhir:CodeSystem.content [ fhir:value "complete"] ;
  fhir:CodeSystem.count [ fhir:value "5"^^xsd:nonNegativeInteger] ;
  fhir:CodeSystem.concept [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "patient-self-pay" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Người bệnh tự trả" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Phần người bệnh tự trả ngoài phần cùng chi trả BHYT (`T_BNTT`)." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Patient self-pay" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "other-fund" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Nguồn khác" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Phần chi phí từ nguồn khác (`T_NGUONKHAC`). Breakdown theo nguồn cụ thể cần extension hoặc model bổ sung khi pilot yêu cầu." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Other source" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "non-covered" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Ngoài phạm vi/ngoài định suất" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Chi phí ngoài phạm vi hoặc ngoài định suất theo hồ sơ BHYT (`T_NGOAIDS`); không đồng nhất với deductible." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Out-of-scope/out-of-capitation" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "medication-subtotal" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Tổng thuốc, dịch truyền" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Subtotal nhóm thuốc/dịch truyền (`T_THUOC`), dùng cho total/cost summary thay vì line-level adjudication." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Total medications and infusion fluids" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "supplies-subtotal" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Tổng vật tư/thiết bị y tế" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Subtotal nhóm vật tư/thiết bị y tế (`T_VTYT`), dùng cho total/cost summary thay vì line-level adjudication." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Total medical supplies/equipment" ]
     ]
  ] .

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

<http://hl7.org/fhir/CodeSystem/vn-bhyt-adjudication-category-cs.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl ;
  owl:versionIRI <http://build.fhir.org/CodeSystem/vn-bhyt-adjudication-category-cs.ttl> .