vn-ext-org-lifecycle-relation
type: StructureDefinition
node role: treeRoot
id:
  v: vn-ext-org-lifecycle-relation
language:
  v: vi
text:
  status:
    v: extensions
  div:
    v: Generated Narrative: StructureDefinition vn-ext-org-lifecycle-relation Name Flags Card. Type Description & Constraints<img src="[binary]" alt="doco" style="background-color: inherit"/> <a href="StructureDefinition-vn-ext-org-lifecycle-relation-definitions.html#Extension" title="Extension ghi nhận quan hệ vòng đời giữa cơ sở y tế hiện tại và một cơ sở khác khi mã/định danh cơ sở thay đổi do sáp nhập, chia tách, đổi tên hoặc thay mã (vd hệ quả của sắp xếp đơn vị hành chính theo NQ 202/2025/QH15). Generic cho mọi cơ sở y tế VN.#xA;Mỗi lần lặp mô tả MỘT quan hệ: loại quan hệ (relationType), cơ sở liên quan (target), thời điểm hiệu lực (period), căn cứ pháp lý (legalBasis) và các hạng mục được kế thừa (carryOver).#xA;Khi cơ sở tiền nhiệm đã giải thể và không còn Organization resource phân giải được, target có thể dùng Reference.identifier để tham chiếu logic theo mã CSKCB cũ.#xA;Căn cứ: NQ 202/2025/QH15 (sắp xếp ĐVHC) + NĐ 102/2025/NĐ-CP (CSDL quốc gia về y tế).">Extension 0..* Extension Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension #xD; extension 2..* Extension Extension #xD; Slices for extension Content/Rules for all slices #xD; extension:relationType S 1..1 Extension Loại quan hệ (tiền nhiệm/kế nhiệm/sáp nhập/tách) #xD; extension 0..0 Extension #xD; url 1..1 uri "relationType" #xD; value[x] 0..1 Coding Value of extension Binding: Tập giá trị loại quan hệ vòng đời mã cơ sở y tế — Organization Lifecycle Relation Type ValueSet (required) #xD; extension:target S 1..1 Extension Cơ sở liên quan (mã trước/sau) #xD; extension 0..0 Extension #xD; url 1..1 uri "target" #xD; value[x] 0..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Value of extension #xD; extension:period 0..1 Extension Khoảng/thời điểm hiệu lực của quan hệ #xD; extension 0..0 Extension #xD; url 1..1 uri "period" #xD; value[x] 0..1 Period Value of extension #xD; extension:legalBasis 0..* Extension Căn cứ pháp lý của thay đổi (vd QĐ sáp nhập) #xD; extens…
extension:
  url:
    v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis
    l: vn-ext-legal-basis
  value: Coding
    system:
      v: http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs
      l: vn-legal-document-ref-cs
    code:
      v: NQ-202-2025
extension:
  url:
    v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis
    l: vn-ext-legal-basis
  value: Coding
    system:
      v: http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs
      l: vn-legal-document-ref-cs
    code:
      v: ND-102-2025
url:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation
  l: vn-ext-org-lifecycle-relation
version:
  v: 0.6.0
name:
  v: VNCoreExtOrgLifecycleRelation
title:
  v: Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension
status:
  v: draft
date:
  v: 2026-05-30
publisher:
  v: Omi HealthTech / VN Core FHIR Community Initiative
contact:
  name:
    v: Omi HealthTech / VN Core FHIR Community Initiative
  telecom:
    system:
      v: url
    value:
      v: https://hl7.org.vn
  telecom:
    system:
      v: email
contact:
  name:
    v: Omi HealthTech (OmiGroup)
  telecom:
    system:
      v: url
    value:
      v: https://omihealthtech.vn
  telecom:
    system:
      v: url
    value:
      v: https://omigroup.vn
  telecom:
    system:
      v: email
description:
  v: Extension ghi nhận quan hệ vòng đời giữa cơ sở y tế hiện tại và một cơ sở khác khi mã/định danh cơ sở thay đổi do sáp nhập, chia tách, đổi tên hoặc thay mã (vd hệ quả của sắp xếp đơn vị hành chính theo NQ 202/2025/QH15). Generic cho mọi cơ sở y tế VN. Mỗi lần lặp mô tả MỘT quan hệ: loại quan hệ (relationType), cơ sở liên quan (target), thời điểm hiệu lực (period), căn cứ pháp lý (legalBasis) và các hạng mục được kế thừa (carryOver). Khi cơ sở tiền nhiệm đã giải thể và không còn Organization resource phân giải được, target có thể dùng Reference.identifier để tham chiếu logic theo mã CSKCB cũ. Căn cứ: NQ 202/2025/QH15 (sắp xếp ĐVHC) + NĐ 102/2025/NĐ-CP (CSDL quốc gia về y tế).
jurisdiction:
  coding:
    system:
      v: urn:iso:std:iso:3166
      l: 3166
    code:
      v: VN
    display:
      v: Viet Nam
fhir version:
  v: 4.0.1
mapping:
  identity:
    v: rim
  uri:
    v: http://hl7.org/v3
    l: v3
  name:
    v: RIM Mapping
kind:
  v: complex-type
abstract:
  v: false
context:
  type:
    v: element
  expression:
    v: Organization
type:
  v: Extension
  l: Extension
base definition:
  v: http://hl7.org/fhir/StructureDefinition/Extension
  l: Extension
derivation:
  v: constraint
snapshot:
  extension:
    url:
      v: http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version
      l: snapshot-base-version
    value: String
      v: 4.0.1
  element:
    id:
      v: Extension
    path:
      v: Extension
    short:
      v: Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension
    definition:
      v: Extension ghi nhận quan hệ vòng đời giữa cơ sở y tế hiện tại và một cơ sở khác khi mã/định danh cơ sở thay đổi do sáp nhập, chia tách, đổi tên hoặc thay mã (vd hệ quả của sắp xếp đơn vị hành chính theo NQ 202/2025/QH15). Generic cho mọi cơ sở y tế VN. Mỗi lần lặp mô tả MỘT quan hệ: loại quan hệ (relationType), cơ sở liên quan (target), thời điểm hiệu lực (period), căn cứ pháp lý (legalBasis) và các hạng mục được kế thừa (carryOver). Khi cơ sở tiền nhiệm đã giải thể và không còn Organization resource phân giải được, target có thể dùng Reference.identifier để tham chiếu logic theo mã CSKCB cũ. Căn cứ: NQ 202/2025/QH15 (sắp xếp ĐVHC) + NĐ 102/2025/NĐ-CP (CSDL quốc gia về y tế).
    min:
      v: 0
    max:
      v: *
    base:
      path:
        v: Extension
      min:
        v: 0
      max:
        v: *
    condition:
      v: ele-1
    constraint:
      key:
        v: ele-1
      severity:
        v: error
      human:
        v: All FHIR elements must have a @value or children
      expression:
        v: hasValue() or (children().count() > id.count())
      xpath:
        v: @value|f:*|h:div
      source:
        v: http://hl7.org/fhir/StructureDefinition/Element
        l: Element
    constraint:
      key:
        v: ext-1
      severity:
        v: error
      human:
        v: Must have either extensions or value[x], not both
      expression:
        v: extension.exists() != value.exists()
      xpath:
        v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
      source:
        v: http://hl7.org/fhir/StructureDefinition/Extension
        l: Extension
    is modifier:
      v: false
  element:
    id:
      v: Extension.id
    path:
      v: Extension.id
    representation:
      v: xmlAttr
    short:
      v: Unique id for inter-element referencing
    definition:
      v: Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
    min:
      v: 0
    max:
      v: 1
    base:
      path:
        v: Element.id
      min:
        v: 0
      max:
        v: 1
    type:
      extension:
        value: Url
      code:
        v: http://hl7.org/fhirpath/System.String
        l: System.String
    is modifier:
      v: false
    is summary:
      v: false

Url
v: string
l: string

identity:
  v: rim
map:
  v: n/a

id:
  v: Extension.extension
path:
  v: Extension.extension
slicing:
  discriminator:
    type:
      v: value
    path:
      v: url
  description:
    v: Extensions are always sliced by (at least) url
  rules:
    v: open
short:
  v: Extension
definition:
  v: An Extension
min:
  v: 2
max:
  v: *
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
constraint:
  key:
    v: ext-1
  severity:
    v: error
  human:
    v: Must have either extensions or value[x], not both
  expression:
    v: extension.exists() != value.exists()
  xpath:
    v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  source:
    v: http://hl7.org/fhir/StructureDefinition/Extension
    l: Extension
is modifier:
  v: false
is summary:
  v: false

id:
  v: Extension.extension:relationType
path:
  v: Extension.extension
slice name:
  v: relationType
short:
  v: Loại quan hệ (tiền nhiệm/kế nhiệm/sáp nhập/tách)
definition:
  v: An Extension
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
constraint:
  key:
    v: ext-1
  severity:
    v: error
  human:
    v: Must have either extensions or value[x], not both
  expression:
    v: extension.exists() != value.exists()
  xpath:
    v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  source:
    v: http://hl7.org/fhir/StructureDefinition/Extension
    l: Extension
must support:
  v: true
is modifier:
  v: false
is summary:
  v: false

id:
  v: Extension.extension:relationType.id
path:
  v: Extension.extension.id
representation:
  v: xmlAttr
short:
  v: Unique id for inter-element referencing
definition:
  v: Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.id
  min:
    v: 0
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: string
      l: string
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: Extension.extension:relationType.extension
path:
  v: Extension.extension.extension
slicing:
  discriminator:
    type:
      v: value
    path:
      v: url
  description:
    v: Extensions are always sliced by (at least) url
  rules:
    v: open
short:
  v: Extension
definition:
  v: An Extension
min:
  v: 0
max:
  v: 0
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
constraint:
  key:
    v: ext-1
  severity:
    v: error
  human:
    v: Must have either extensions or value[x], not both
  expression:
    v: extension.exists() != value.exists()
  xpath:
    v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  source:
    v: http://hl7.org/fhir/StructureDefinition/Extension
    l: Extension
is modifier:
  v: false
is summary:
  v: false

id:
  v: Extension.extension:relationType.url
path:
  v: Extension.extension.url
representation:
  v: xmlAttr
short:
  v: identifies the meaning of the extension
definition:
  v: Source of the definition for the extension code - a logical name or a URL.
comment:
  v: The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: uri
      l: uri
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
fixed: Uri
  v: relationType
  l: relationType
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:relationType.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Value of extension
definition:
  v: Value of extension - must be one of a constrained set of the data types (see [Extensibility](http://hl7.org/fhir/R4/extensibility.html) for a list).
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Coding
    l: Coding
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: false
binding:
  strength:
    v: required
  value set:
    v: http://fhir.hl7.org.vn/core/ValueSet/vn-org-lifecycle-relation-vs
    l: vn-org-lifecycle-relation-vs
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:target
path:
  v: Extension.extension
slice name:
  v: target
short:
  v: Cơ sở liên quan (mã trước/sau)
definition:
  v: An Extension
comment:
  v: Tham chiếu cơ sở liên quan. Nếu cơ sở tiền nhiệm đã giải thể, dùng Reference.identifier (mã CSKCB cũ) làm tham chiếu logic.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
constraint:
  key:
    v: ext-1
  severity:
    v: error
  human:
    v: Must have either extensions or value[x], not both
  expression:
    v: extension.exists() != value.exists()
  xpath:
    v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  source:
    v: http://hl7.org/fhir/StructureDefinition/Extension
    l: Extension
must support:
  v: true
is modifier:
  v: false
is summary:
  v: false

id:
  v: Extension.extension:target.id
path:
  v: Extension.extension.id
representation:
  v: xmlAttr
short:
  v: Unique id for inter-element referencing
definition:
  v: Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.id
  min:
    v: 0
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: string
      l: string
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: Extension.extension:target.extension
path:
  v: Extension.extension.extension
slicing:
  discriminator:
    type:
      v: value
    path:
      v: url
  description:
    v: Extensions are always sliced by (at least) url
  rules:
    v: open
short:
  v: Extension
definition:
  v: An Extension
min:
  v: 0
max:
  v: 0
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
constraint:
  key:
    v: ext-1
  severity:
    v: error
  human:
    v: Must have either extensions or value[x], not both
  expression:
    v: extension.exists() != value.exists()
  xpath:
    v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  source:
    v: http://hl7.org/fhir/StructureDefinition/Extension
    l: Extension
is modifier:
  v: false
is summary:
  v: false

id:
  v: Extension.extension:target.url
path:
  v: Extension.extension.url
representation:
  v: xmlAttr
short:
  v: identifies the meaning of the extension
definition:
  v: Source of the definition for the extension code - a logical name or a URL.
comment:
  v: The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: uri
      l: uri
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
fixed: Uri
  v: target
  l: target
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:target.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Value of extension
definition:
  v: Value of extension - must be one of a constrained set of the data types (see [Extensibility](http://hl7.org/fhir/R4/extensibility.html) for a list).
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Reference
    l: Reference
  target profile:
    v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization
    l: vn-core-organization
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:period
path:
  v: Extension.extension
slice name:
  v: period
short:
  v: Khoảng/thời điểm hiệu lực của quan hệ
definition:
  v: An Extension
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
constraint:
  key:
    v: ext-1
  severity:
    v: error
  human:
    v: Must have either extensions or value[x], not both
  expression:
    v: extension.exists() != value.exists()
  xpath:
    v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  source:
    v: http://hl7.org/fhir/StructureDefinition/Extension
    l: Extension
is modifier:
  v: false
is summary:
  v: false

id:
  v: Extension.extension:period.id
path:
  v: Extension.extension.id
representation:
  v: xmlAttr
short:
  v: Unique id for inter-element referencing
definition:
  v: Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.id
  min:
    v: 0
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: string
      l: string
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: Extension.extension:period.extension
path:
  v: Extension.extension.extension
slicing:
  discriminator:
    type:
      v: value
    path:
      v: url
  description:
    v: Extensions are always sliced by (at least) url
  rules:
    v: open
short:
  v: Extension
definition:
  v: An Extension
min:
  v: 0
max:
  v: 0
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
constraint:
  key:
    v: ext-1
  severity:
    v: error
  human:
    v: Must have either extensions or value[x], not both
  expression:
    v: extension.exists() != value.exists()
  xpath:
    v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  source:
    v: http://hl7.org/fhir/StructureDefinition/Extension
    l: Extension
is modifier:
  v: false
is summary:
  v: false

id:
  v: Extension.extension:period.url
path:
  v: Extension.extension.url
representation:
  v: xmlAttr
short:
  v: identifies the meaning of the extension
definition:
  v: Source of the definition for the extension code - a logical name or a URL.
comment:
  v: The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: uri
      l: uri
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
fixed: Uri
  v: period
  l: period
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:period.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Value of extension
definition:
  v: Value of extension - must be one of a constrained set of the data types (see [Extensibility](http://hl7.org/fhir/R4/extensibility.html) for a list).
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Period
    l: Period
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:legalBasis
path:
  v: Extension.extension
slice name:
  v: legalBasis
short:
  v: Căn cứ pháp lý của thay đổi (vd QĐ sáp nhập)
definition:
  v: An Extension
min:
  v: 0
max:
  v: *
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
constraint:
  key:
    v: ext-1
  severity:
    v: error
  human:
    v: Must have either extensions or value[x], not both
  expression:
    v: extension.exists() != value.exists()
  xpath:
    v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  source:
    v: http://hl7.org/fhir/StructureDefinition/Extension
    l: Extension
is modifier:
  v: false
is summary:
  v: false

id:
  v: Extension.extension:legalBasis.id
path:
  v: Extension.extension.id
representation:
  v: xmlAttr
short:
  v: Unique id for inter-element referencing
definition:
  v: Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.id
  min:
    v: 0
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: string
      l: string
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: Extension.extension:legalBasis.extension
path:
  v: Extension.extension.extension
slicing:
  discriminator:
    type:
      v: value
    path:
      v: url
  description:
    v: Extensions are always sliced by (at least) url
  rules:
    v: open
short:
  v: Extension
definition:
  v: An Extension
min:
  v: 0
max:
  v: 0
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
constraint:
  key:
    v: ext-1
  severity:
    v: error
  human:
    v: Must have either extensions or value[x], not both
  expression:
    v: extension.exists() != value.exists()
  xpath:
    v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  source:
    v: http://hl7.org/fhir/StructureDefinition/Extension
    l: Extension
is modifier:
  v: false
is summary:
  v: false

id:
  v: Extension.extension:legalBasis.url
path:
  v: Extension.extension.url
representation:
  v: xmlAttr
short:
  v: identifies the meaning of the extension
definition:
  v: Source of the definition for the extension code - a logical name or a URL.
comment:
  v: The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: uri
      l: uri
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
fixed: Uri
  v: legalBasis
  l: legalBasis
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:legalBasis.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Value of extension
definition:
  v: Value of extension - must be one of a constrained set of the data types (see [Extensibility](http://hl7.org/fhir/R4/extensibility.html) for a list).
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Coding
    l: Coding
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: false
binding:
  strength:
    v: extensible
  value set:
    v: http://fhir.hl7.org.vn/core/ValueSet/vn-legal-document-ref-vs
    l: vn-legal-document-ref-vs
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:carryOver
path:
  v: Extension.extension
slice name:
  v: carryOver
short:
  v: Hạng mục được kế thừa (giấy phép, hợp đồng BHYT, ĐK KCB ban đầu...)
definition:
  v: An Extension
min:
  v: 0
max:
  v: *
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
constraint:
  key:
    v: ext-1
  severity:
    v: error
  human:
    v: Must have either extensions or value[x], not both
  expression:
    v: extension.exists() != value.exists()
  xpath:
    v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  source:
    v: http://hl7.org/fhir/StructureDefinition/Extension
    l: Extension
is modifier:
  v: false
is summary:
  v: false

id:
  v: Extension.extension:carryOver.id
path:
  v: Extension.extension.id
representation:
  v: xmlAttr
short:
  v: Unique id for inter-element referencing
definition:
  v: Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.id
  min:
    v: 0
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: string
      l: string
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: Extension.extension:carryOver.extension
path:
  v: Extension.extension.extension
slicing:
  discriminator:
    type:
      v: value
    path:
      v: url
  description:
    v: Extensions are always sliced by (at least) url
  rules:
    v: open
short:
  v: Extension
definition:
  v: An Extension
min:
  v: 0
max:
  v: 0
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
constraint:
  key:
    v: ext-1
  severity:
    v: error
  human:
    v: Must have either extensions or value[x], not both
  expression:
    v: extension.exists() != value.exists()
  xpath:
    v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  source:
    v: http://hl7.org/fhir/StructureDefinition/Extension
    l: Extension
is modifier:
  v: false
is summary:
  v: false

id:
  v: Extension.extension:carryOver.url
path:
  v: Extension.extension.url
representation:
  v: xmlAttr
short:
  v: identifies the meaning of the extension
definition:
  v: Source of the definition for the extension code - a logical name or a URL.
comment:
  v: The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: uri
      l: uri
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
fixed: Uri
  v: carryOver
  l: carryOver
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:carryOver.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Value of extension
definition:
  v: Value of extension - must be one of a constrained set of the data types (see [Extensibility](http://hl7.org/fhir/R4/extensibility.html) for a list).
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Coding
    l: Coding
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: false
binding:
  strength:
    v: required
  value set:
    v: http://fhir.hl7.org.vn/core/ValueSet/vn-org-carry-over-item-vs
    l: vn-org-carry-over-item-vs
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.url
path:
  v: Extension.url
representation:
  v: xmlAttr
short:
  v: identifies the meaning of the extension
definition:
  v: Source of the definition for the extension code - a logical name or a URL.
comment:
  v: The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: uri
      l: uri
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
fixed: Uri
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation
  l: vn-ext-org-lifecycle-relation
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.value[x]
path:
  v: Extension.value[x]
short:
  v: Value of extension
definition:
  v: Value of extension - must be one of a constrained set of the data types (see [Extensibility](http://hl7.org/fhir/R4/extensibility.html) for a list).
min:
  v: 0
max:
  v: 0
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: base64Binary
    l: base64Binary
type:
  code:
    v: boolean
    l: boolean
type:
  code:
    v: canonical
    l: canonical
type:
  code:
    v: code
    l: code
type:
  code:
    v: date
    l: date
type:
  code:
    v: dateTime
    l: dateTime
type:
  code:
    v: decimal
    l: decimal
type:
  code:
    v: id
    l: id
type:
  code:
    v: instant
    l: instant
type:
  code:
    v: integer
    l: integer
type:
  code:
    v: markdown
    l: markdown
type:
  code:
    v: oid
    l: oid
type:
  code:
    v: positiveInt
    l: positiveInt
type:
  code:
    v: string
    l: string
type:
  code:
    v: time
    l: time
type:
  code:
    v: unsignedInt
    l: unsignedInt
type:
  code:
    v: uri
    l: uri
type:
  code:
    v: url
    l: url
type:
  code:
    v: uuid
    l: uuid
type:
  code:
    v: Address
    l: Address
type:
  code:
    v: Age
    l: Age
type:
  code:
    v: Annotation
    l: Annotation
type:
  code:
    v: Attachment
    l: Attachment
type:
  code:
    v: CodeableConcept
    l: CodeableConcept
type:
  code:
    v: Coding
    l: Coding
type:
  code:
    v: ContactPoint
    l: ContactPoint
type:
  code:
    v: Count
    l: Count
type:
  code:
    v: Distance
    l: Distance
type:
  code:
    v: Duration
    l: Duration
type:
  code:
    v: HumanName
    l: HumanName
type:
  code:
    v: Identifier
    l: Identifier
type:
  code:
    v: Money
    l: Money
type:
  code:
    v: Period
    l: Period
type:
  code:
    v: Quantity
    l: Quantity
type:
  code:
    v: Range
    l: Range
type:
  code:
    v: Ratio
    l: Ratio
type:
  code:
    v: Reference
    l: Reference
type:
  code:
    v: SampledData
    l: SampledData
type:
  code:
    v: Signature
    l: Signature
type:
  code:
    v: Timing
    l: Timing
type:
  code:
    v: ContactDetail
    l: ContactDetail
type:
  code:
    v: Contributor
    l: Contributor
type:
  code:
    v: DataRequirement
    l: DataRequirement
type:
  code:
    v: Expression
    l: Expression
type:
  code:
    v: ParameterDefinition
    l: ParameterDefinition
type:
  code:
    v: RelatedArtifact
    l: RelatedArtifact

code:
  v: TriggerDefinition
  l: TriggerDefinition

code:
  v: UsageContext
  l: UsageContext

code:
  v: Dosage
  l: Dosage

code:
  v: Meta
  l: Meta

key:
  v: ele-1
severity:
  v: error
human:
  v: All FHIR elements must have a @value or children
expression:
  v: hasValue() or (children().count() > id.count())
xpath:
  v: @value|f:*|h:div
source:
  v: http://hl7.org/fhir/StructureDefinition/Element
  l: Element

v: false

v: false

identity:
  v: rim
map:
  v: N/A

element:
  id:
    v: Extension
  path:
    v: Extension
  short:
    v: Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension
  definition:
    v: Extension ghi nhận quan hệ vòng đời giữa cơ sở y tế hiện tại và một cơ sở khác khi mã/định danh cơ sở thay đổi do sáp nhập, chia tách, đổi tên hoặc thay mã (vd hệ quả của sắp xếp đơn vị hành chính theo NQ 202/2025/QH15). Generic cho mọi cơ sở y tế VN. Mỗi lần lặp mô tả MỘT quan hệ: loại quan hệ (relationType), cơ sở liên quan (target), thời điểm hiệu lực (period), căn cứ pháp lý (legalBasis) và các hạng mục được kế thừa (carryOver). Khi cơ sở tiền nhiệm đã giải thể và không còn Organization resource phân giải được, target có thể dùng Reference.identifier để tham chiếu logic theo mã CSKCB cũ. Căn cứ: NQ 202/2025/QH15 (sắp xếp ĐVHC) + NĐ 102/2025/NĐ-CP (CSDL quốc gia về y tế).
element:
  id:
    v: Extension.extension
  path:
    v: Extension.extension
  min:
    v: 2
element:
  id:
    v: Extension.extension:relationType
  path:
    v: Extension.extension
  slice name:
    v: relationType
  short:
    v: Loại quan hệ (tiền nhiệm/kế nhiệm/sáp nhập/tách)
  min:
    v: 1
  max:
    v: 1
  must support:
    v: true
element:
  id:
    v: Extension.extension:relationType.extension
  path:
    v: Extension.extension.extension
  max:
    v: 0
element:
  id:
    v: Extension.extension:relationType.url
  path:
    v: Extension.extension.url
  fixed: Uri
    v: relationType
    l: relationType
element:
  id:
    v: Extension.extension:relationType.value[x]
  path:
    v: Extension.extension.value[x]
  type:
    code:
      v: Coding
      l: Coding
  binding:
    strength:
      v: required
    value set:
      v: http://fhir.hl7.org.vn/core/ValueSet/vn-org-lifecycle-relation-vs
      l: vn-org-lifecycle-relation-vs
element:
  id:
    v: Extension.extension:target
  path:
    v: Extension.extension
  slice name:
    v: target
  short:
    v: Cơ sở liên quan (mã trước/sau)
  comment:
    v: Tham chiếu cơ sở liên quan. Nếu cơ sở tiền nhiệm đã giải thể, dùng Reference.identifier (mã CSKCB cũ) làm tham chiếu logic.
  min:
    v: 1
  max:
    v: 1
  must support:
    v: true
element:
  id:
    v: Extension.extension:target.extension
  path:
    v: Extension.extension.extension
  max:
    v: 0
element:
  id:
    v: Extension.extension:target.url
  path:
    v: Extension.extension.url
  fixed: Uri
    v: target
    l: target
element:
  id:
    v: Extension.extension:target.value[x]
  path:
    v: Extension.extension.value[x]
  type:
    code:
      v: Reference
      l: Reference
    target profile:
      v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization
      l: vn-core-organization
element:
  id:
    v: Extension.extension:period
  path:
    v: Extension.extension
  slice name:
    v: period
  short:
    v: Khoảng/thời điểm hiệu lực của quan hệ
  min:
    v: 0
  max:
    v: 1
element:
  id:
    v: Extension.extension:period.extension
  path:
    v: Extension.extension.extension
  max:
    v: 0
element:
  id:
    v: Extension.extension:period.url
  path:
    v: Extension.extension.url
  fixed: Uri
    v: period
    l: period
element:
  id:
    v: Extension.extension:period.value[x]
  path:
    v: Extension.extension.value[x]
  type:
    code:
      v: Period
      l: Period
element:
  id:
    v: Extension.extension:legalBasis
  path:
    v: Extension.extension
  slice name:
    v: legalBasis
  short:
    v: Căn cứ pháp lý của thay đổi (vd QĐ sáp nhập)
  min:
    v: 0
  max:
    v: *
element:
  id:
    v: Extension.extension:legalBasis.extension
  path:
    v: Extension.extension.extension
  max:
    v: 0
element:
  id:
    v: Extension.extension:legalBasis.url
  path:
    v: Extension.extension.url
  fixed: Uri
    v: legalBasis
    l: legalBasis
element:
  id:
    v: Extension.extension:legalBasis.value[x]
  path:
    v: Extension.extension.value[x]
  type:
    code:
      v: Coding
      l: Coding
  binding:
    strength:
      v: extensible
    value set:
      v: http://fhir.hl7.org.vn/core/ValueSet/vn-legal-document-ref-vs
      l: vn-legal-document-ref-vs
element:
  id:
    v: Extension.extension:carryOver
  path:
    v: Extension.extension
  slice name:
    v: carryOver
  short:
    v: Hạng mục được kế thừa (giấy phép, hợp đồng BHYT, ĐK KCB ban đầu...)
  min:
    v: 0
  max:
    v: *
element:
  id:
    v: Extension.extension:carryOver.extension

v: Extension.extension.extension

v: 0

id:
  v: Extension.extension:carryOver.url
path:
  v: Extension.extension.url
fixed: Uri
  v: carryOver
  l: carryOver

id:
  v: Extension.extension:carryOver.value[x]
path:
  v: Extension.extension.value[x]
type:
  code:
    v: Coding
    l: Coding
binding:
  strength:
    v: required
  value set:
    v: http://fhir.hl7.org.vn/core/ValueSet/vn-org-carry-over-item-vs
    l: vn-org-carry-over-item-vs

id:
  v: Extension.url
path:
  v: Extension.url
fixed: Uri
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation
  l: vn-ext-org-lifecycle-relation

id:
  v: Extension.value[x]
path:
  v: Extension.value[x]
max:
  v: 0