@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://fhir.hl7.org.vn/core/CodeSystem/vn-benefit-type-cs> a fhir:CodeSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "vn-benefit-type-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-benefit-type-cs</b></p><a name=\"vn-benefit-type-cs\"> </a><a name=\"hcvn-benefit-type-cs\"> </a><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-benefit-type-cs</code> defines the following code:</p><table class=\"codes\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td style=\"white-space:nowrap\">annual-copay-accumulator<a name=\"vn-benefit-type-cs-annual-copay-accumulator\"> </a></td><td>Luỹ kế cùng chi trả trong năm tài chính</td><td>Số tiền cùng chi trả đã luỹ kế trong năm tài chính so với trần miễn cùng chi trả theo NĐ 188/2025/NĐ-CP Điều 18 khoản 2 (6 tháng lương cơ sở — người tham gia đủ 5 năm liên tục có số cùng chi trả trong năm vượt trần được hưởng 100% cho phần còn lại của năm). Dùng trong benefit của phản hồi tra cứu: `allowedMoney` = trần miễn cùng chi trả tại thời điểm tra cứu, `usedMoney` = số đã cùng chi trả luỹ kế tính đến `created`; kỳ tính (năm tài chính) ghi ở `serviced[x]`. KHÁC `benefit-type#copay-maximum` của HL7 (mức cùng chi trả tối đa cho MỘT dịch vụ) — không dùng lẫn.</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:Element.extension [
         fhir:index -1 ;
         fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis-role" ] ;
         fhir:Extension.valueCode [ fhir:value "issuing" ]
       ] ;
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs" ] ;
       fhir:Coding.code [ fhir:value "ND-188-2025" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis" ] ;
     fhir:Extension.valueCoding [
       fhir:Element.extension [
         fhir:index -1 ;
         fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis-role" ] ;
         fhir:Extension.valueCode [ fhir:value "foundational" ]
       ] ;
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs" ] ;
       fhir:Coding.code [ fhir:value "L-51-2024" ]
     ]
  ] ;
  fhir:CodeSystem.url [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-benefit-type-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.8" ]
  ] ;
  fhir:CodeSystem.version [ fhir:value "0.10.0"] ;
  fhir:CodeSystem.name [ fhir:value "VNBenefitTypeCS"] ;
  fhir:CodeSystem.title [ fhir:value "Loại quyền lợi BHYT bổ sung — VN Benefit Type CodeSystem"] ;
  fhir:CodeSystem.status [ fhir:value "draft"] ;
  fhir:CodeSystem.experimental [ fhir:value "false"^^xsd:boolean] ;
  fhir:CodeSystem.date [ fhir:value "2026-08-12"^^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 "Các loại quyền lợi BHYT của Việt Nam KHÔNG có mã tương đương đúng nghĩa trong\n`benefit-type` của HL7, dùng tại `CoverageEligibilityResponse.insurance.item.benefit.type`.\n\nMã đầu tiên thay thế cách dùng sai `benefit-type#copay-maximum` (T-02, review 97b — quyết định\ngovernance 12/08/2026): HL7 R4 định nghĩa `copay-maximum` là mức cùng chi trả tối đa CHO MỘT\nDỊCH VỤ, trong khi nghiệp vụ Việt Nam cần biểu diễn LUỸ KẾ cùng chi trả trong năm tài chính so\nvới trần miễn cùng chi trả (6 tháng lương cơ sở) — một accumulator theo kỳ, không phải mức trần\nper-service. Payer chuẩn FHIR đọc mã HL7 sẽ hiểu thành nghĩa khác; mã quốc gia giữ đúng ngữ nghĩa."] ;
  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.purpose [ fhir:value "Bổ sung — không thay thế — bảng `benefit-type` của HL7: chỉ chứa khái niệm quyền lợi Việt Nam mà mã HL7 không mang đúng nghĩa. Dùng qua VNBenefitTypeVS (union hai hệ)."] ;
  fhir:CodeSystem.copyright [ fhir:value "Căn cứ pháp lý Việt Nam: NĐ 188/2025/NĐ-CP Điều 18 khoản 2; Luật 51/2024/QH15 ngày 27/11/2024."] ;
  fhir:CodeSystem.caseSensitive [ fhir:value "true"^^xsd:boolean] ;
  fhir:CodeSystem.content [ fhir:value "complete"] ;
  fhir:CodeSystem.count [ fhir:value "1"^^xsd:nonNegativeInteger] ;
  fhir:CodeSystem.concept [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "annual-copay-accumulator" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Luỹ kế cùng chi trả trong năm tài chính" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Số tiền cùng chi trả đã luỹ kế trong năm tài chính so với trần miễn cùng chi trả theo NĐ 188/2025/NĐ-CP Điều 18 khoản 2 (6 tháng lương cơ sở — người tham gia đủ 5 năm liên tục có số cùng chi trả trong năm vượt trần được hưởng 100% cho phần còn lại của năm). Dùng trong benefit của phản hồi tra cứu: `allowedMoney` = trần miễn cùng chi trả tại thời điểm tra cứu, `usedMoney` = số đã cùng chi trả luỹ kế tính đến `created`; kỳ tính (năm tài chính) ghi ở `serviced[x]`. KHÁC `benefit-type#copay-maximum` của HL7 (mức cùng chi trả tối đa cho MỘT dịch vụ) — không dùng lẫn." ]
  ] .

# - ontology header ------------------------------------------------------------

<http://fhir.hl7.org.vn/core/CodeSystem/vn-benefit-type-cs.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl .

# -------------------------------------------------------------------------------------

