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

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

## : Mapping 63 → 34 tỉnh/thành (NQ 202/2025) — VN Province Legacy-to-New ConceptMap

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

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:ConceptMap ;
      fhir:nodeRole fhir:treeRoot ;
      fhir:id [ fhir:v "vn-cm-province-legacy-to-new"] ; #
      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: ConceptMap vn-cm-province-legacy-to-new</b></p><a name=\"vn-cm-province-legacy-to-new\"> </a><a name=\"hcvn-cm-province-legacy-to-new\"> </a><p>Mapping from (not specified) to (not specified)</p><br/><p><b>Group 1 </b>Mapping from <a href=\"CodeSystem-vn-province-cs.html\">Danh mục Tỉnh/Thành phố Việt Nam — Vietnam Province CodeSystem</a> to <a href=\"CodeSystem-vn-province-cs.html\">Danh mục Tỉnh/Thành phố Việt Nam — Vietnam Province CodeSystem</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>01 (Thành phố Hà Nội)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>01 (Thành phố Hà Nội)</td><td/></tr><tr><td>04 (Tỉnh Cao Bằng)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>04 (Tỉnh Cao Bằng)</td><td/></tr><tr><td>11 (Tỉnh Điện Biên)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>11 (Tỉnh Điện Biên)</td><td/></tr><tr><td>12 (Tỉnh Lai Châu)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>12 (Tỉnh Lai Châu)</td><td/></tr><tr><td>14 (Tỉnh Sơn La)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>14 (Tỉnh Sơn La)</td><td/></tr><tr><td>20 (Tỉnh Lạng Sơn)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>20 (Tỉnh Lạng Sơn)</td><td/></tr><tr><td>22 (Tỉnh Quảng Ninh)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>22 (Tỉnh Quảng Ninh)</td><td/></tr><tr><td>38 (Tỉnh Thanh Hóa)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>38 (Tỉnh Thanh Hóa)</td><td/></tr><tr><td>40 (Tỉnh Nghệ An)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>40 (Tỉnh Nghệ An)</td><td/></tr><tr><td>42 (Tỉnh Hà Tĩnh)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>42 (Tỉnh Hà Tĩnh)</td><td/></tr><tr><td>46 (Thành phố Huế)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>46 (Thành phố Huế)</td><td/></tr><tr><td>79 (Thành phố Hồ Chí Minh)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower\" title=\"narrower\">narrower</a></td><td>79 (Thành phố Hồ Chí Minh)</td><td>TP HCM mới = TP HCM cũ + Bà Rịa Vũng Tàu (#77) + Bình Dương (#74)</td></tr><tr><td>77 (Tỉnh Bà Rịa - Vũng Tàu (inactive))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower\" title=\"narrower\">narrower</a></td><td>79 (Thành phố Hồ Chí Minh)</td><td>Sáp nhập vào TP HCM mới theo NQ 202/2025</td></tr><tr><td>74 (Tỉnh Bình Dương (inactive))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower\" title=\"narrower\">narrower</a></td><td>79 (Thành phố Hồ Chí Minh)</td><td>Sáp nhập vào TP HCM mới theo NQ 202/2025</td></tr><tr><td>31 (Thành phố Hải Phòng)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower\" title=\"narrower\">narrower</a></td><td>31 (Thành phố Hải Phòng)</td><td>TP Hải Phòng mới = HP cũ + Hải Dương (#30)</td></tr><tr><td>30 (Tỉnh Hải Dương (inactive))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower\" title=\"narrower\">narrower</a></td><td>31 (Thành phố Hải Phòng)</td><td>Sáp nhập vào Hải Phòng mới theo NQ 202/2025</td></tr><tr><td>48 (Thành phố Đà Nẵng)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower\" title=\"narrower\">narrower</a></td><td>48 (Thành phố Đà Nẵng)</td><td>TP Đà Nẵng mới = ĐN cũ + Quảng Nam (#49)</td></tr><tr><td>49 (Tỉnh Quảng Nam (inactive))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower\" title=\"narrower\">narrower</a></td><td>48 (Thành phố Đà Nẵng)</td><td>Sáp nhập vào Đà Nẵng mới theo NQ 202/2025</td></tr><tr><td>92 (Thành phố Cần Thơ)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower\" title=\"narrower\">narrower</a></td><td>92 (Thành phố Cần Thơ)</td><td>TP Cần Thơ mới = CT cũ + Hậu Giang (#93) + Sóc Trăng (#94)</td></tr><tr><td>93 (Tỉnh Hậu Giang (inactive))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower\" title=\"narrower\">narrower</a></td><td>92 (Thành phố Cần Thơ)</td><td>Sáp nhập vào Cần Thơ mới theo NQ 202/2025</td></tr><tr><td>94 (Tỉnh Sóc Trăng (inactive))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower\" title=\"narrower\">narrower</a></td><td>92 (Thành phố Cần Thơ)</td><td>Sáp nhập vào Cần Thơ mới theo NQ 202/2025</td></tr></table></div>"^^rdf:XMLLiteral ]
      ] ; #
      fhir:url [
    fhir:v "http://fhir.hl7.org.vn/core/ConceptMap/vn-cm-province-legacy-to-new"^^xsd:anyURI ;
    fhir:l <http://fhir.hl7.org.vn/core/ConceptMap/vn-cm-province-legacy-to-new>
      ] ; #
      fhir:version [ fhir:v "0.5.0"] ; #
      fhir:name [ fhir:v "VNCMProvinceLegacyToNew"] ; #
      fhir:title [ fhir:v "Mapping 63 → 34 tỉnh/thành (NQ 202/2025) — VN Province Legacy-to-New ConceptMap"] ; #
      fhir:status [ fhir:v "draft"] ; #
      fhir:experimental [ fhir:v true] ; #
      fhir:date [ fhir:v "2026-04-27"^^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 "info@hl7.org.vn" ]     ] )
      ] [
    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 "healthtech@omigroup.vn" ]     ] )
      ] ) ; #
      fhir:description [ fhir:v "ConceptMap NON-AUTHORITATIVE DRAFT chuyển đổi 63 mã tỉnh/thành cũ (trước 01/07/2025) sang 34 mã tỉnh/thành mới theo:\n- **NQ 202/2025/QH15** (Sắp xếp đơn vị hành chính cấp tỉnh) — hiệu lực 01/07/2025\n- **QĐ 19/2025/QĐ-TTg** (Bảng danh mục và mã số ĐVHC) — Phụ lục I 34 tỉnh\n\nCác trường hợp trong mapping:\n- `equivalent`: 11 tỉnh/TP giữ nguyên (mã cũ = mã mới)\n- `narrower`: tỉnh cũ thuộc nhóm sáp nhập, mã cũ nhỏ hơn (specific) so với tỉnh mới (broader)\n- `disjoint`: trường hợp không xác định được mapping (nếu có)\n\n**Cảnh báo**: TCTK và Bộ Nội vụ chưa publish ConceptMap chính thức 63→34. Bản này là draft research-based, dùng cho:\n- Tham chiếu data legacy khi convert sang ĐVHC mới\n- Backward compatibility cho dữ liệu BHYT trước 01/07/2025\n- KHÔNG dùng cho thanh toán BHYT chính thức trước khi BHXH/Bộ Y tế xác nhận."] ; #
      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 "Hỗ trợ chuyển đổi data legacy từ 63 mã tỉnh cũ (trước 01/07/2025) sang 34 mã tỉnh mới sau sắp xếp ĐVHC theo NQ 202/2025."] ; #
      fhir:copyright [ fhir:v "Bảng mapping research-based từ QĐ 19/2025/QĐ-TTg Phụ lục I (Thủ tướng Chính phủ ban hành 25/06/2025) và xaydungchinhsach.chinhphu.vn. Status: non-authoritative draft."] ; #
      fhir:group ( [
    fhir:source [
    fhir:v "http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs"^^xsd:anyURI ;
    fhir:l <http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs>     ] ;
    fhir:target [
    fhir:v "http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs"^^xsd:anyURI ;
    fhir:l <http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs>     ] ;
        ( fhir:element [
    fhir:code [ fhir:v "01" ] ;
    fhir:display [ fhir:v "Thành phố Hà Nội" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "01" ] ;
    fhir:display [ fhir:v "Thành phố Hà Nội" ] ;
    fhir:equivalence [ fhir:v "equivalent" ]       ] )     ] [
    fhir:code [ fhir:v "04" ] ;
    fhir:display [ fhir:v "Tỉnh Cao Bằng" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "04" ] ;
    fhir:display [ fhir:v "Tỉnh Cao Bằng" ] ;
    fhir:equivalence [ fhir:v "equivalent" ]       ] )     ] [
    fhir:code [ fhir:v "11" ] ;
    fhir:display [ fhir:v "Tỉnh Điện Biên" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "11" ] ;
    fhir:display [ fhir:v "Tỉnh Điện Biên" ] ;
    fhir:equivalence [ fhir:v "equivalent" ]       ] )     ] [
    fhir:code [ fhir:v "12" ] ;
    fhir:display [ fhir:v "Tỉnh Lai Châu" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "12" ] ;
    fhir:display [ fhir:v "Tỉnh Lai Châu" ] ;
    fhir:equivalence [ fhir:v "equivalent" ]       ] )     ] [
    fhir:code [ fhir:v "14" ] ;
    fhir:display [ fhir:v "Tỉnh Sơn La" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "14" ] ;
    fhir:display [ fhir:v "Tỉnh Sơn La" ] ;
    fhir:equivalence [ fhir:v "equivalent" ]       ] )     ] [
    fhir:code [ fhir:v "20" ] ;
    fhir:display [ fhir:v "Tỉnh Lạng Sơn" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "20" ] ;
    fhir:display [ fhir:v "Tỉnh Lạng Sơn" ] ;
    fhir:equivalence [ fhir:v "equivalent" ]       ] )     ] [
    fhir:code [ fhir:v "22" ] ;
    fhir:display [ fhir:v "Tỉnh Quảng Ninh" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "22" ] ;
    fhir:display [ fhir:v "Tỉnh Quảng Ninh" ] ;
    fhir:equivalence [ fhir:v "equivalent" ]       ] )     ] [
    fhir:code [ fhir:v "38" ] ;
    fhir:display [ fhir:v "Tỉnh Thanh Hóa" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "38" ] ;
    fhir:display [ fhir:v "Tỉnh Thanh Hóa" ] ;
    fhir:equivalence [ fhir:v "equivalent" ]       ] )     ] [
    fhir:code [ fhir:v "40" ] ;
    fhir:display [ fhir:v "Tỉnh Nghệ An" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "40" ] ;
    fhir:display [ fhir:v "Tỉnh Nghệ An" ] ;
    fhir:equivalence [ fhir:v "equivalent" ]       ] )     ] [
    fhir:code [ fhir:v "42" ] ;
    fhir:display [ fhir:v "Tỉnh Hà Tĩnh" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "42" ] ;
    fhir:display [ fhir:v "Tỉnh Hà Tĩnh" ] ;
    fhir:equivalence [ fhir:v "equivalent" ]       ] )     ] [
    fhir:code [ fhir:v "46" ] ;
    fhir:display [ fhir:v "Thành phố Huế" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "46" ] ;
    fhir:display [ fhir:v "Thành phố Huế" ] ;
    fhir:equivalence [ fhir:v "equivalent" ]       ] )     ] [
    fhir:code [ fhir:v "79" ] ;
    fhir:display [ fhir:v "Thành phố Hồ Chí Minh" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "79" ] ;
    fhir:display [ fhir:v "Thành phố Hồ Chí Minh" ] ;
    fhir:equivalence [ fhir:v "narrower" ] ;
    fhir:comment [ fhir:v "TP HCM mới = TP HCM cũ + Bà Rịa Vũng Tàu (#77) + Bình Dương (#74)" ]       ] )     ] [
    fhir:code [ fhir:v "77" ] ;
    fhir:display [ fhir:v "Tỉnh Bà Rịa - Vũng Tàu (inactive)" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "79" ] ;
    fhir:display [ fhir:v "Thành phố Hồ Chí Minh" ] ;
    fhir:equivalence [ fhir:v "narrower" ] ;
    fhir:comment [ fhir:v "Sáp nhập vào TP HCM mới theo NQ 202/2025" ]       ] )     ] [
    fhir:code [ fhir:v "74" ] ;
    fhir:display [ fhir:v "Tỉnh Bình Dương (inactive)" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "79" ] ;
    fhir:display [ fhir:v "Thành phố Hồ Chí Minh" ] ;
    fhir:equivalence [ fhir:v "narrower" ] ;
    fhir:comment [ fhir:v "Sáp nhập vào TP HCM mới theo NQ 202/2025" ]       ] )     ] [
    fhir:code [ fhir:v "31" ] ;
    fhir:display [ fhir:v "Thành phố Hải Phòng" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "31" ] ;
    fhir:display [ fhir:v "Thành phố Hải Phòng" ] ;
    fhir:equivalence [ fhir:v "narrower" ] ;
    fhir:comment [ fhir:v "TP Hải Phòng mới = HP cũ + Hải Dương (#30)" ]       ] )     ] [
    fhir:code [ fhir:v "30" ] ;
    fhir:display [ fhir:v "Tỉnh Hải Dương (inactive)" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "31" ] ;
    fhir:display [ fhir:v "Thành phố Hải Phòng" ] ;
    fhir:equivalence [ fhir:v "narrower" ] ;
    fhir:comment [ fhir:v "Sáp nhập vào Hải Phòng mới theo NQ 202/2025" ]       ] )     ] [
    fhir:code [ fhir:v "48" ] ;
    fhir:display [ fhir:v "Thành phố Đà Nẵng" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "48" ] ;
    fhir:display [ fhir:v "Thành phố Đà Nẵng" ] ;
    fhir:equivalence [ fhir:v "narrower" ] ;
    fhir:comment [ fhir:v "TP Đà Nẵng mới = ĐN cũ + Quảng Nam (#49)" ]       ] )     ] [
    fhir:code [ fhir:v "49" ] ;
    fhir:display [ fhir:v "Tỉnh Quảng Nam (inactive)" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "48" ] ;
    fhir:display [ fhir:v "Thành phố Đà Nẵng" ] ;
    fhir:equivalence [ fhir:v "narrower" ] ;
    fhir:comment [ fhir:v "Sáp nhập vào Đà Nẵng mới theo NQ 202/2025" ]       ] )     ] [
    fhir:code [ fhir:v "92" ] ;
    fhir:display [ fhir:v "Thành phố Cần Thơ" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "92" ] ;
    fhir:display [ fhir:v "Thành phố Cần Thơ" ] ;
    fhir:equivalence [ fhir:v "narrower" ] ;
    fhir:comment [ fhir:v "TP Cần Thơ mới = CT cũ + Hậu Giang (#93) + Sóc Trăng (#94)" ]       ] )     ] [
    fhir:code [ fhir:v "93" ] ;
    fhir:display [ fhir:v "Tỉnh Hậu Giang (inactive)" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "92" ] ;
    fhir:display [ fhir:v "Thành phố Cần Thơ" ] ;
    fhir:equivalence [ fhir:v "narrower" ] ;
    fhir:comment [ fhir:v "Sáp nhập vào Cần Thơ mới theo NQ 202/2025" ]       ] )     ] [
    fhir:code [ fhir:v "94" ] ;
    fhir:display [ fhir:v "Tỉnh Sóc Trăng (inactive)" ] ;
          ( fhir:target [
    fhir:code [ fhir:v "92" ] ;
    fhir:display [ fhir:v "Thành phố Cần Thơ" ] ;
    fhir:equivalence [ fhir:v "narrower" ] ;
    fhir:comment [ fhir:v "Sáp nhập vào Cần Thơ mới theo NQ 202/2025" ]       ] )     ] )
      ] ) . #