# Loại đơn vị cấp xã (xã/phường/đặc khu) — Vietnam Ward Type Extension - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Phần mở rộng: Loại đơn vị cấp xã (xã/phường/đặc khu) — Vietnam Ward Type Extension 

Mở rộng phân loại đơn vị hành chính cấp xã trên Address: xã (nông thôn), phường (đô thị), hoặc đặc khu (hải đảo). FHIR Address không có khái niệm phân loại đơn vị cấp xã — extension này bổ sung để phản ánh mô hình chính quyền 2 cấp. Dùng kèm với vn-ext-ward (mã xã/phường) để biểu diễn đầy đủ cấp xã. Căn cứ: Luật 72/2025/QH15 (16/6/2025, hiệu lực 01/7/2025) — Luật Tổ chức chính quyền địa phương; NQ 202/2025/QH15.

**Context of Use**

**Usage info**

**Usages:**

* This Extension is not used by any profiles in this Implementation Guide

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/hl7.fhir.vn.core|current/StructureDefinition/vn-ext-ward-type)

### Các dạng xem hình thức của nội dung phần mở rộng

 [Mô tả profile, differential, snapshot và các biểu diễn liên quan](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

*  [Bảng Differential](#tabs-diff) 
*  [Bảng Snapshot](#tabs-snap) 
*  [Thống kê/Tham chiếu](#tabs-summ) 
*  [Tất cả](#tabs-all) 

#### Terminology Bindings (Differential)

#### Terminology Bindings

#### Constraints

** Summary **

Simple Extension with the type Coding: Mở rộng phân loại đơn vị hành chính cấp xã trên Address: xã (nông thôn), phường (đô thị), hoặc đặc khu (hải đảo). FHIR Address không có khái niệm phân loại đơn vị cấp xã — extension này bổ sung để phản ánh mô hình chính quyền 2 cấp. Dùng kèm với vn-ext-ward (mã xã/phường) để biểu diễn đầy đủ cấp xã. Căn cứ: Luật 72/2025/QH15 (16/6/2025, hiệu lực 01/7/2025) — Luật Tổ chức chính quyền địa phương; NQ 202/2025/QH15.

 **Dạng xem DifferentialDifferential View** 

#### Terminology Bindings (Differential)

 **Dạng xem Snapshot** 

#### Terminology Bindings

#### Constraints

** Summary **

Simple Extension with the type Coding: Mở rộng phân loại đơn vị hành chính cấp xã trên Address: xã (nông thôn), phường (đô thị), hoặc đặc khu (hải đảo). FHIR Address không có khái niệm phân loại đơn vị cấp xã — extension này bổ sung để phản ánh mô hình chính quyền 2 cấp. Dùng kèm với vn-ext-ward (mã xã/phường) để biểu diễn đầy đủ cấp xã. Căn cứ: Luật 72/2025/QH15 (16/6/2025, hiệu lực 01/7/2025) — Luật Tổ chức chính quyền địa phương; NQ 202/2025/QH15.

 

Biểu diễn khác của hồ sơ: [CSV](../StructureDefinition-vn-ext-ward-type.csv), [Excel](../StructureDefinition-vn-ext-ward-type.xlsx), [Schematron](../StructureDefinition-vn-ext-ward-type.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-ext-ward-type",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward-type",
  "version" : "0.5.0",
  "name" : "VNCoreExtWardType",
  "title" : "Loại đơn vị cấp xã (xã/phường/đặc khu) — Vietnam Ward Type Extension",
  "status" : "draft",
  "date" : "2026-04-27",
  "publisher" : "Omi HealthTech / VN Core FHIR Community Initiative",
  "contact" : [{
    "name" : "Omi HealthTech / VN Core FHIR Community Initiative",
    "telecom" : [{
      "system" : "url",
      "value" : "https://hl7.org.vn"
    },
    {
      "system" : "email",
      "value" : "info@hl7.org.vn"
    }]
  },
  {
    "name" : "Omi HealthTech (OmiGroup)",
    "telecom" : [{
      "system" : "url",
      "value" : "https://omihealthtech.vn"
    },
    {
      "system" : "url",
      "value" : "https://omigroup.vn"
    },
    {
      "system" : "email",
      "value" : "healthtech@omigroup.vn"
    }]
  }],
  "description" : "Mở rộng phân loại đơn vị hành chính cấp xã trên Address: xã (nông thôn), phường (đô thị), hoặc đặc khu (hải đảo).\nFHIR Address không có khái niệm phân loại đơn vị cấp xã — extension này bổ sung để phản ánh mô hình chính quyền 2 cấp.\nDùng kèm với vn-ext-ward (mã xã/phường) để biểu diễn đầy đủ cấp xã.\nCăn cứ: Luật 72/2025/QH15 (16/6/2025, hiệu lực 01/7/2025) — Luật Tổ chức chính quyền địa phương; NQ 202/2025/QH15.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  }],
  "kind" : "complex-type",
  "abstract" : false,
  "context" : [{
    "type" : "element",
    "expression" : "Address"
  }],
  "type" : "Extension",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Extension",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Extension",
      "path" : "Extension",
      "short" : "Loại đơn vị cấp xã (xã/phường/đặc khu) — Vietnam Ward Type Extension",
      "definition" : "Mở rộng phân loại đơn vị hành chính cấp xã trên Address: xã (nông thôn), phường (đô thị), hoặc đặc khu (hải đảo).\nFHIR Address không có khái niệm phân loại đơn vị cấp xã — extension này bổ sung để phản ánh mô hình chính quyền 2 cấp.\nDùng kèm với vn-ext-ward (mã xã/phường) để biểu diễn đầy đủ cấp xã.\nCăn cứ: Luật 72/2025/QH15 (16/6/2025, hiệu lực 01/7/2025) — Luật Tổ chức chính quyền địa phương; NQ 202/2025/QH15."
    },
    {
      "id" : "Extension.extension",
      "path" : "Extension.extension",
      "max" : "0"
    },
    {
      "id" : "Extension.url",
      "path" : "Extension.url",
      "fixedUri" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward-type"
    },
    {
      "id" : "Extension.value[x]",
      "path" : "Extension.value[x]",
      "short" : "Loại đơn vị cấp xã",
      "definition" : "Loại đơn vị hành chính cấp xã theo Luật 72/2025/QH15 — xã | phường | đặc khu.",
      "type" : [{
        "code" : "Coding"
      }],
      "binding" : {
        "strength" : "required",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-ward-type-vs"
      }
    }]
  }
}

```
