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

: Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue CodeSystem

Draft tại thời điểm 2026-04-24

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-review-issue-cs> a fhir:CodeSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "vn-bhyt-review-issue-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-review-issue-cs</b></p><a name=\"vn-bhyt-review-issue-cs\"> </a><a name=\"hcvn-bhyt-review-issue-cs\"> </a><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-review-issue-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\">GATEWAY_RECEPTION_ERROR<a name=\"vn-bhyt-review-issue-cs-GATEWAY_RECEPTION_ERROR\"> </a></td><td>Lỗi tiếp nhận cổng</td><td>Lỗi kỹ thuật hoặc cấu trúc hồ sơ do Cổng tiếp nhận trả về trước hoặc trong quá trình xử lý.</td><td>Gateway reception error</td></tr><tr><td style=\"white-space:nowrap\">FIELD_ADJUSTMENT_REQUIRED<a name=\"vn-bhyt-review-issue-cs-FIELD_ADJUSTMENT_REQUIRED\"> </a></td><td>Cần điều chỉnh trường dữ liệu</td><td>Hồ sơ cần chỉnh sửa trường dữ liệu, định danh, ngày giờ hoặc metadata trước khi được tiếp tục xử lý/quyết toán.</td><td>Field adjustment required</td></tr><tr><td style=\"white-space:nowrap\">LEGAL_NON_COMPLIANT_COST<a name=\"vn-bhyt-review-issue-cs-LEGAL_NON_COMPLIANT_COST\"> </a></td><td>Chi phí không đúng quy định pháp luật</td><td>Khoản chi không đáp ứng quy định pháp luật hoặc phạm vi thanh toán BHYT nên bị từ chối/giảm trừ.</td><td>Legally non-compliant cost</td></tr><tr><td style=\"white-space:nowrap\">MANUAL_REVIEW_REQUIRED<a name=\"vn-bhyt-review-issue-cs-MANUAL_REVIEW_REQUIRED\"> </a></td><td>Cần giám định chủ động/trực tiếp</td><td>Trường hợp cần giám định chủ động hoặc đối chiếu hồ sơ/tài liệu bổ sung thay vì chỉ giám định tự động.</td><td>Manual review required</td></tr><tr><td style=\"white-space:nowrap\">PENDING_SETTLEMENT<a name=\"vn-bhyt-review-issue-cs-PENDING_SETTLEMENT\"> </a></td><td>Chi phí chưa quyết toán</td><td>Khoản chi đang treo hoặc chưa đủ điều kiện quyết toán tại kỳ hiện tại.</td><td>Pending settlement</td></tr><tr><td style=\"white-space:nowrap\">PAYMENT_RECONCILIATION_VARIANCE<a name=\"vn-bhyt-review-issue-cs-PAYMENT_RECONCILIATION_VARIANCE\"> </a></td><td>Chênh lệch thanh toán/quyết toán</td><td>Có chênh lệch giữa số đề nghị, số tổng hợp quyết toán và số thanh toán/thu hồi cần đối soát tiếp.</td><td>Payment or settlement reconciliation variance</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 "TT-12-2026-BTC" ]
     ]
  ] ;
  fhir:CodeSystem.url [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-review-issue-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.9" ]
  ] ;
  fhir:CodeSystem.version [ fhir:value "0.8.0"] ;
  fhir:CodeSystem.name [ fhir:value "VNBHYTReviewIssueCS"] ;
  fhir:CodeSystem.title [ fhir:value "Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue CodeSystem"] ;
  fhir:CodeSystem.status [ fhir:value "draft"] ;
  fhir:CodeSystem.experimental [ fhir:value "false"^^xsd:boolean] ;
  fhir:CodeSystem.date [ fhir:value "2026-04-24"^^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 nhóm issue cục bộ dùng để ghi nhận phản hồi giám định/từ chối/yêu cầu điều chỉnh trong `ClaimResponse.error` và `OperationOutcome.issue.details`.\nDanh mục này được rút gọn từ các nhóm tình huống xuất hiện trong TT 12/2026/TT-BTC, đặc biệt phần biên bản giám định, bảng kê chi phí từ chối thanh toán và yêu cầu điều chỉnh dữ liệu qua Cổng tiếp nhận.\nĐây KHÔNG PHẢI catalog payer/gateway chính thức đầy đủ; chỉ là taxonomy baseline ở mức profile/example để tránh mã hóa tự do khi pilot."] ;
  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 "Interim grouping vocabulary for BHYT claim review issues. Use as a baseline for ClaimResponse.error and OperationOutcome.issue.details until an official gateway/payer code list with stable provenance is available."] ;
  fhir:CodeSystem.caseSensitive [ fhir:value "true"^^xsd:boolean] ;
  fhir:CodeSystem.content [ fhir:value "complete"] ;
  fhir:CodeSystem.count [ fhir:value "6"^^xsd:nonNegativeInteger] ;
  fhir:CodeSystem.concept [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "GATEWAY_RECEPTION_ERROR" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Lỗi tiếp nhận cổng" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Lỗi kỹ thuật hoặc cấu trúc hồ sơ do Cổng tiếp nhận trả về trước hoặc trong quá trình xử lý." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Gateway reception error" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "FIELD_ADJUSTMENT_REQUIRED" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Cần điều chỉnh trường dữ liệu" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Hồ sơ cần chỉnh sửa trường dữ liệu, định danh, ngày giờ hoặc metadata trước khi được tiếp tục xử lý/quyết toán." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Field adjustment required" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "LEGAL_NON_COMPLIANT_COST" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Chi phí không đúng quy định pháp luật" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Khoản chi không đáp ứng quy định pháp luật hoặc phạm vi thanh toán BHYT nên bị từ chối/giảm trừ." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Legally non-compliant cost" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "MANUAL_REVIEW_REQUIRED" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Cần giám định chủ động/trực tiếp" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Trường hợp cần giám định chủ động hoặc đối chiếu hồ sơ/tài liệu bổ sung thay vì chỉ giám định tự động." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Manual review required" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "PENDING_SETTLEMENT" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Chi phí chưa quyết toán" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Khoản chi đang treo hoặc chưa đủ điều kiện quyết toán tại kỳ hiện tại." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Pending settlement" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "PAYMENT_RECONCILIATION_VARIANCE" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Chênh lệch thanh toán/quyết toán" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "Có chênh lệch giữa số đề nghị, số tổng hợp quyết toán và số thanh toán/thu hồi cần đối soát tiếp." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Payment or settlement reconciliation variance" ]
     ]
  ] .

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

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