HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.5.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.5.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 rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

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

 a fhir:CodeSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:id [ fhir:v "vn-bhyt-review-issue-cs"] ; # 
  fhir:language [ fhir:v "vi"] ; # 
  fhir:text [
fhir:status [ fhir:v "generated" ] ;
fhir:div [ fhir:v "<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>"^^rdf:XMLLiteral ]
  ] ; # 
  fhir:url [
fhir:v "http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-review-issue-cs"^^xsd:anyURI ;
fhir:l <http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-review-issue-cs>
  ] ; # 
  fhir:version [ fhir:v "0.5.0"] ; # 
  fhir:name [ fhir:v "VNBHYTReviewIssueCS"] ; # 
  fhir:title [ fhir:v "Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue CodeSystem"] ; # 
  fhir:status [ fhir:v "draft"] ; # 
  fhir:experimental [ fhir:v false] ; # 
  fhir:date [ fhir:v "2026-04-24"^^xsd:date] ; # 
  fhir:publisher [ fhir:v "Omi HealthTech / VN Core FHIR Community Initiative"] ; # 
  fhir:contact ( [
fhir:name [ fhir:v "Omi HealthTech / VN Core FHIR Community Initiative" ] ;
    ( fhir:telecom [
fhir:system [ fhir:v "url" ] ;
fhir:value [ fhir:v "https://hl7.org.vn" ]     ] [
fhir:system [ fhir:v "email" ] ;
fhir:value [ fhir:v "[email protected]" ]     ] )
  ] [
fhir:name [ fhir:v "Omi HealthTech (OmiGroup)" ] ;
    ( fhir:telecom [
fhir:system [ fhir:v "url" ] ;
fhir:value [ fhir:v "https://omihealthtech.vn" ]     ] [
fhir:system [ fhir:v "url" ] ;
fhir:value [ fhir:v "https://omigroup.vn" ]     ] [
fhir:system [ fhir:v "email" ] ;
fhir:value [ fhir:v "[email protected]" ]     ] )
  ] ) ; # 
  fhir:description [ fhir:v "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:jurisdiction ( [
    ( fhir:coding [
fhir:system [
fhir:v "urn:iso:std:iso:3166"^^xsd:anyURI ;
fhir:l <urn:iso:std:iso:3166>       ] ;
fhir:code [ fhir:v "VN" ] ;
fhir:display [ fhir:v "Viet Nam" ]     ] )
  ] ) ; # 
  fhir:purpose [ fhir:v "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:caseSensitive [ fhir:v true] ; # 
  fhir:content [ fhir:v "complete"] ; # 
  fhir:count [ fhir:v "6"^^xsd:nonNegativeInteger] ; # 
  fhir:concept ( [
fhir:code [ fhir:v "GATEWAY_RECEPTION_ERROR" ] ;
fhir:display [ fhir:v "Lỗi tiếp nhận cổng" ] ;
fhir:definition [ fhir:v "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:designation [
fhir:language [ fhir:v "en" ] ;
fhir:value [ fhir:v "Gateway reception error" ]     ] )
  ] [
fhir:code [ fhir:v "FIELD_ADJUSTMENT_REQUIRED" ] ;
fhir:display [ fhir:v "Cần điều chỉnh trường dữ liệu" ] ;
fhir:definition [ fhir:v "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:designation [
fhir:language [ fhir:v "en" ] ;
fhir:value [ fhir:v "Field adjustment required" ]     ] )
  ] [
fhir:code [ fhir:v "LEGAL_NON_COMPLIANT_COST" ] ;
fhir:display [ fhir:v "Chi phí không đúng quy định pháp luật" ] ;
fhir:definition [ fhir:v "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:designation [
fhir:language [ fhir:v "en" ] ;
fhir:value [ fhir:v "Legally non-compliant cost" ]     ] )
  ] [
fhir:code [ fhir:v "MANUAL_REVIEW_REQUIRED" ] ;
fhir:display [ fhir:v "Cần giám định chủ động/trực tiếp" ] ;
fhir:definition [ fhir:v "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:designation [
fhir:language [ fhir:v "en" ] ;
fhir:value [ fhir:v "Manual review required" ]     ] )
  ] [
fhir:code [ fhir:v "PENDING_SETTLEMENT" ] ;
fhir:display [ fhir:v "Chi phí chưa quyết toán" ] ;
fhir:definition [ fhir:v "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:designation [
fhir:language [ fhir:v "en" ] ;
fhir:value [ fhir:v "Pending settlement" ]     ] )
  ] [
fhir:code [ fhir:v "PAYMENT_RECONCILIATION_VARIANCE" ] ;
fhir:display [ fhir:v "Chênh lệch thanh toán/quyết toán" ] ;
fhir:definition [ fhir:v "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:designation [
fhir:language [ fhir:v "en" ] ;
fhir:value [ fhir:v "Payment or settlement reconciliation variance" ]     ] )
  ] ) . #