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 - Local Development build (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Định danh hợp đồng KCB BHYT — BHYT Healthcare Contract Identifier

Draft tại thời điểm 2026-07-20

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/NamingSystem/vn-bhyt-contract-ns> a fhir:NamingSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "vn-bhyt-contract-ns"] ;
  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: NamingSystem vn-bhyt-contract-ns</b></p><a name=\"vn-bhyt-contract-ns\"> </a><a name=\"hcvn-bhyt-contract-ns\"> </a><h3>Summary</h3><table class=\"grid\"><tr><td>Defining URL</td><td>http://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-contract-ns</td></tr><tr><td>Version</td><td>0.9.0</td></tr><tr><td>Name</td><td>VNBHYTContractNS</td></tr><tr><td>Status</td><td>draft</td></tr><tr><td>Definition</td><td><div><p>Hệ thống định danh VN Core cho hợp đồng khám bệnh, chữa bệnh BHYT giữa cơ quan BHXH và cơ sở KCB. Giá trị định danh phải duy nhất trong phạm vi thỏa thuận giữa các bên hoặc cơ quan cấp mã; NamingSystem này không khẳng định mã hợp đồng có tính duy nhất trên toàn quốc. / VN Core identifier system for BHYT healthcare contracts between a social-insurance authority and a healthcare provider. Identifier values SHALL be unique within the parties' agreement or assigning authority; this NamingSystem does not assert nationwide contract-number uniqueness.</p>\n</div></td></tr><tr><td>Publisher</td><td>Omi HealthTech / VN Core FHIR Community Initiative</td></tr><tr><td>OID</td><td>2.25.161089673617632664299011809196868855799.31.3 (for OID based terminology systems)</td></tr></table><h3>Identifiers</h3><table class=\"grid\"><tr><td><b>Type</b></td><td><b>Value</b></td><td><b>Preferred</b></td></tr><tr><td>URI</td><td>http://fhir.hl7.org.vn/core/sid/bhyt-healthcare-contract</td><td>true</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 "ND-188-2025" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url" ] ;
     fhir:Extension.valueUri [ fhir:value "http://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-contract-ns" ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version" ] ;
     fhir:Extension.valueString [ fhir:value "0.9.0" ]
  ] ;
  fhir:NamingSystem.name [ fhir:value "VNBHYTContractNS"] ;
  fhir:NamingSystem.status [ fhir:value "draft"] ;
  fhir:NamingSystem.kind [ fhir:value "identifier"] ;
  fhir:NamingSystem.date [ fhir:value "2026-07-20"^^xsd:date] ;
  fhir:NamingSystem.publisher [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative"] ;
  fhir:NamingSystem.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:NamingSystem.responsible [ fhir:value "Cơ quan BHXH và cơ sở KCB ký hợp đồng / Contracting BHXH authority and healthcare provider"] ;
  fhir:NamingSystem.description [ fhir:value "Hệ thống định danh VN Core cho hợp đồng khám bệnh, chữa bệnh BHYT giữa cơ quan BHXH và cơ sở KCB. Giá trị định danh phải duy nhất trong phạm vi thỏa thuận giữa các bên hoặc cơ quan cấp mã; NamingSystem này không khẳng định mã hợp đồng có tính duy nhất trên toàn quốc. / VN Core identifier system for BHYT healthcare contracts between a social-insurance authority and a healthcare provider. Identifier values SHALL be unique within the parties' agreement or assigning authority; this NamingSystem does not assert nationwide contract-number uniqueness."] ;
  fhir:NamingSystem.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:NamingSystem.usage [ fhir:value "Dùng cho contractIdentifier của VNCoreQuarterlyHealthcareCostSettlement. Bên cấp mã phải bảo đảm không trùng trong từng thỏa thuận và nên đưa phạm vi cơ quan/thỏa thuận vào value khi trao đổi qua nhiều thỏa thuận; không diễn giải URL này như bằng chứng về một sổ đăng ký hợp đồng quốc gia. / Used for VNCoreQuarterlyHealthcareCostSettlement.contractIdentifier. The assigner SHALL prevent duplicates within each agreement and SHOULD encode the authority/agreement scope in the value for cross-agreement exchange; the URL is not evidence of a national contract registry."] ;
  fhir:NamingSystem.uniqueId [
     fhir:index -1 ;
     fhir:NamingSystem.uniqueId.type [ fhir:value "uri" ] ;
     fhir:NamingSystem.uniqueId.value [ fhir:value "http://fhir.hl7.org.vn/core/sid/bhyt-healthcare-contract" ] ;
     fhir:NamingSystem.uniqueId.preferred [ fhir:value "true"^^xsd:boolean ]
  ] .

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

<http://hl7.org/fhir/NamingSystem/vn-bhyt-contract-ns.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl ;
  owl:versionIRI <http://build.fhir.org/NamingSystem/vn-bhyt-contract-ns.ttl> .