HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Mô hình logic: Nghĩa vụ ghi trường: giấy chứng sinh, mã bệnh chính, phản hồi thẻ BHYT — Logical Model - Mô tả chi tiết

Draft tại thời điểm 2026-09-22

Các định nghĩa cho vnBirthCertificateResidencyLm mô hình logic

Guidance on how to interpret the contents of this table can be foundhere

0. vnBirthCertificateResidencyLm
Definition

Logical model gom ba nhóm nghĩa vụ ghi trường còn lại của đợt đối chiếu nhóm (A), mỗi nhóm một văn bản nguồn — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của các profile tương ứng.

Nhóm địa chỉ và giấy chứng sinh theo QĐ 2919/QĐ-BYT Phụ lục I: bảng chỉ tiêu đánh dấu X vào ba trường nơi cư trú — NOI_CU_TRU (địa chỉ đầy đủ, tối đa 1024 ký tự), MATINH_CU_TRU (mã đơn vị hành chính cấp tỉnh, 2 ký tự) và MAXA_CU_TRU (mã đơn vị hành chính cấp xã/phường, 5 ký tự) — cùng mã giấy chứng sinh MA_GCS. Hai mã hành chính tách riêng khỏi địa chỉ chữ là có lý do: địa chỉ chữ để người đọc, còn mã để máy đối chiếu với danh mục đơn vị hành chính.

Nhóm mã bệnh theo QĐ 3176/QĐ-BYT Bảng 1 chỉ tiêu 27: 'Ghi mã bệnh chính theo mã ICD-10 do Bộ trưởng Bộ Y tế ban hành'. Chỉ tiêu 28 MA_BENH_KT (bệnh kèm theo) là trường riêng và không mang cùng nghĩa vụ — bệnh chính có đúng MỘT, bệnh kèm theo có thể nhiều hoặc không có.

Nhóm phản hồi tra cứu thẻ theo TT 48/2017/TT-BYT Điều 6 khoản 2 điểm a: Cổng Thông tin giám định BHYT 'phải phản hồi thông tin về tình trạng, thông tin thẻ bảo hiểm y tế của người đó'. Cùng điểm a còn buộc cung cấp lịch sử khám chữa bệnh 6 tháng gần nhất, nhưng đó là dữ liệu KHÁC — không thuộc phản hồi quyền lợi, nên không đưa vào model này. / Logical model gathering the remaining field-level obligations of documentary conformance group (A).

ShortNghĩa vụ ghi trường: giấy chứng sinh, mã bệnh chính, phản hồi thẻ BHYT — Logical Model
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. vnBirthCertificateResidencyLm.noiCuTru
Definition

Nơi cư trú ghi trên giấy chứng sinh

ShortNơi cư trú ghi trên giấy chứng sinh
Comments

Ba trường của chỉ tiêu 8 đều mang dấu X trong cột bắt buộc của bảng. Chúng bổ sung nhau chứ không thay thế: địa chỉ chữ cho người đọc, hai mã hành chính cho máy đối chiếu danh mục.

Control1..1
TypeBackboneElement
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
4. vnBirthCertificateResidencyLm.noiCuTru.id
Definition

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

ShortUnique id for inter-element referencing
Control0..1
Typestring
Is Modifierfalse
XML FormatIn the XML format, this property is represented as an attribute.
Summaryfalse
6. vnBirthCertificateResidencyLm.noiCuTru.extension
Definition

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

ShortAdditional content defined by implementations
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Control0..*
TypeExtension
Is Modifierfalse
Summaryfalse
Alternate Namesextensions, user content
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
SlicingThis element introduces a set of slices on vnBirthCertificateResidencyLm.noiCuTru.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ url
  • 8. vnBirthCertificateResidencyLm.noiCuTru.modifierExtension
    Definition

    May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

    Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

    ShortExtensions that cannot be ignored even if unrecognized
    Comments

    There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

    Control0..*
    TypeExtension
    Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
    Summarytrue
    Requirements

    Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

    Alternate Namesextensions, user content, modifiers
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    10. vnBirthCertificateResidencyLm.noiCuTru.diaChiDayDu
    Definition

    Địa chỉ nơi cư trú

    ShortĐịa chỉ nơi cư trú
    Comments

    'Ghi địa chỉ nơi cư trú (thường trú hoặc tạm trú hoặc nơi ở hiện tại)' — văn bản chấp nhận cả ba loại nơi cư trú, không đòi riêng thường trú.

    Control1..1
    Typestring
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    12. vnBirthCertificateResidencyLm.noiCuTru.maTinh
    Definition

    Mã đơn vị hành chính cấp tỉnh

    ShortMã đơn vị hành chính cấp tỉnh
    Comments

    'Ghi theo 02 ký tự của mã đơn vị hành chính' — độ dài cố định là ràng buộc của bảng chỉ tiêu, và nó khớp danh mục 34 tỉnh/thành sau NQ 202/2025/QH15.

    Control1..1
    Typestring
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    14. vnBirthCertificateResidencyLm.noiCuTru.maXa
    Definition

    Mã đơn vị hành chính cấp xã, phường

    ShortMã đơn vị hành chính cấp xã, phường
    Comments

    5 ký tự. Cấp xã là cấp hành chính thứ hai và cuối cùng sau mô hình hai cấp — không có mã cấp huyện trong bảng này.

    Control1..1
    Typestring
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    16. vnBirthCertificateResidencyLm.giayChungSinh
    Definition

    Bản ghi giấy chứng sinh

    ShortBản ghi giấy chứng sinh
    Control1..1
    TypeBackboneElement
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    18. vnBirthCertificateResidencyLm.giayChungSinh.id
    Definition

    Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

    ShortUnique id for inter-element referencing
    Control0..1
    Typestring
    Is Modifierfalse
    XML FormatIn the XML format, this property is represented as an attribute.
    Summaryfalse
    20. vnBirthCertificateResidencyLm.giayChungSinh.extension
    Definition

    May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

    ShortAdditional content defined by implementations
    Comments

    There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

    Control0..*
    TypeExtension
    Is Modifierfalse
    Summaryfalse
    Alternate Namesextensions, user content
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    SlicingThis element introduces a set of slices on vnBirthCertificateResidencyLm.giayChungSinh.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • value @ url
    • 22. vnBirthCertificateResidencyLm.giayChungSinh.modifierExtension
      Definition

      May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

      Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

      ShortExtensions that cannot be ignored even if unrecognized
      Comments

      There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

      Control0..*
      TypeExtension
      Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
      Summarytrue
      Requirements

      Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

      Alternate Namesextensions, user content, modifiers
      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
      24. vnBirthCertificateResidencyLm.giayChungSinh.maGiayChungSinh
      Definition

      Mã giấy chứng sinh

      ShortMã giấy chứng sinh
      Comments

      Mã định danh của giấy chứng sinh, là khoá để liên thông bản điện tử với hộ tịch.

      Control1..1
      Typestring
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      26. vnBirthCertificateResidencyLm.chanDoan
      Definition

      Chẩn đoán bệnh chính của đợt khám bệnh, chữa bệnh

      ShortChẩn đoán bệnh chính của đợt khám bệnh, chữa bệnh
      Comments

      Chỉ tiêu 27 MA_BENH_CHINH độ dài 7 ký tự, khác chỉ tiêu 28 MA_BENH_KT (bệnh kèm theo, 100 ký tự — nhiều mã nối nhau). Bệnh chính có đúng MỘT nên cardinality 1..1; bệnh kèm theo không thuộc model này.

      Control1..1
      TypeBackboneElement
      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      28. vnBirthCertificateResidencyLm.chanDoan.id
      Definition

      Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

      ShortUnique id for inter-element referencing
      Control0..1
      Typestring
      Is Modifierfalse
      XML FormatIn the XML format, this property is represented as an attribute.
      Summaryfalse
      30. vnBirthCertificateResidencyLm.chanDoan.extension
      Definition

      May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

      ShortAdditional content defined by implementations
      Comments

      There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

      Control0..*
      TypeExtension
      Is Modifierfalse
      Summaryfalse
      Alternate Namesextensions, user content
      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
      SlicingThis element introduces a set of slices on vnBirthCertificateResidencyLm.chanDoan.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
      • value @ url
      • 32. vnBirthCertificateResidencyLm.chanDoan.modifierExtension
        Definition

        May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

        Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

        ShortExtensions that cannot be ignored even if unrecognized
        Comments

        There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

        Control0..*
        TypeExtension
        Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
        Summarytrue
        Requirements

        Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

        Alternate Namesextensions, user content, modifiers
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
        34. vnBirthCertificateResidencyLm.chanDoan.maBenhChinh
        Definition

        Mã bệnh chính theo ICD-10

        ShortMã bệnh chính theo ICD-10
        Comments

        'Ghi mã bệnh chính theo mã ICD-10 do Bộ trưởng Bộ Y tế ban hành'. Căn cứ hiện hành của danh mục ICD-10 là TT 06/2026/TT-BYT cùng QĐ 1849/QĐ-BYT; QĐ 4469/QĐ-BYT mà QĐ 3176/QĐ-BYT dẫn nay chỉ còn là nguồn gốc cho dữ liệu lập trước 01/07/2026.

        Control1..1
        Typestring
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        36. vnBirthCertificateResidencyLm.phanHoiTheBhyt
        Definition

        Phản hồi của Cổng Thông tin giám định BHYT khi cơ sở tra cứu thẻ

        ShortPhản hồi của Cổng Thông tin giám định BHYT khi cơ sở tra cứu thẻ
        Comments

        'NGAY KHI nhận được thông tin do cơ sở khám bệnh, chữa bệnh thực hiện kiểm tra tình trạng, thông tin thẻ bảo hiểm y tế của người đến khám bệnh, chữa bệnh, Cổng Thông tin giám định bảo hiểm y tế PHẢI phản hồi thông tin về tình trạng, thông tin thẻ bảo hiểm y tế của người đó.' Nghĩa vụ đặt lên Cổng chứ không lên cơ sở KBCB — profile này mô hình hoá phía phản hồi.

        Control1..1
        TypeBackboneElement
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        38. vnBirthCertificateResidencyLm.phanHoiTheBhyt.id
        Definition

        Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

        ShortUnique id for inter-element referencing
        Control0..1
        Typestring
        Is Modifierfalse
        XML FormatIn the XML format, this property is represented as an attribute.
        Summaryfalse
        40. vnBirthCertificateResidencyLm.phanHoiTheBhyt.extension
        Definition

        May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

        ShortAdditional content defined by implementations
        Comments

        There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

        Control0..*
        TypeExtension
        Is Modifierfalse
        Summaryfalse
        Alternate Namesextensions, user content
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
        SlicingThis element introduces a set of slices on vnBirthCertificateResidencyLm.phanHoiTheBhyt.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
        • value @ url
        • 42. vnBirthCertificateResidencyLm.phanHoiTheBhyt.modifierExtension
          Definition

          May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

          Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

          ShortExtensions that cannot be ignored even if unrecognized
          Comments

          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

          Control0..*
          TypeExtension
          Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
          Summarytrue
          Requirements

          Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

          Alternate Namesextensions, user content, modifiers
          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
          44. vnBirthCertificateResidencyLm.phanHoiTheBhyt.tinhTrangThe
          Definition

          Tình trạng thẻ bảo hiểm y tế

          ShortTình trạng thẻ bảo hiểm y tế
          Comments

          Thẻ còn hiệu lực hay không tại thời điểm tra cứu — trên CoverageEligibilityResponse là insurance.inforce.

          Control1..1
          Typeboolean
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
          46. vnBirthCertificateResidencyLm.phanHoiTheBhyt.thongTinThe
          Definition

          Thông tin thẻ bảo hiểm y tế

          ShortThông tin thẻ bảo hiểm y tế
          Control1..1
          Typestring
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension

          Guidance on how to interpret the contents of this table can be foundhere

          0. vnBirthCertificateResidencyLm
          Definition

          Logical model gom ba nhóm nghĩa vụ ghi trường còn lại của đợt đối chiếu nhóm (A), mỗi nhóm một văn bản nguồn — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của các profile tương ứng.

          Nhóm địa chỉ và giấy chứng sinh theo QĐ 2919/QĐ-BYT Phụ lục I: bảng chỉ tiêu đánh dấu X vào ba trường nơi cư trú — NOI_CU_TRU (địa chỉ đầy đủ, tối đa 1024 ký tự), MATINH_CU_TRU (mã đơn vị hành chính cấp tỉnh, 2 ký tự) và MAXA_CU_TRU (mã đơn vị hành chính cấp xã/phường, 5 ký tự) — cùng mã giấy chứng sinh MA_GCS. Hai mã hành chính tách riêng khỏi địa chỉ chữ là có lý do: địa chỉ chữ để người đọc, còn mã để máy đối chiếu với danh mục đơn vị hành chính.

          Nhóm mã bệnh theo QĐ 3176/QĐ-BYT Bảng 1 chỉ tiêu 27: 'Ghi mã bệnh chính theo mã ICD-10 do Bộ trưởng Bộ Y tế ban hành'. Chỉ tiêu 28 MA_BENH_KT (bệnh kèm theo) là trường riêng và không mang cùng nghĩa vụ — bệnh chính có đúng MỘT, bệnh kèm theo có thể nhiều hoặc không có.

          Nhóm phản hồi tra cứu thẻ theo TT 48/2017/TT-BYT Điều 6 khoản 2 điểm a: Cổng Thông tin giám định BHYT 'phải phản hồi thông tin về tình trạng, thông tin thẻ bảo hiểm y tế của người đó'. Cùng điểm a còn buộc cung cấp lịch sử khám chữa bệnh 6 tháng gần nhất, nhưng đó là dữ liệu KHÁC — không thuộc phản hồi quyền lợi, nên không đưa vào model này. / Logical model gathering the remaining field-level obligations of documentary conformance group (A).

          ShortNghĩa vụ ghi trường: giấy chứng sinh, mã bệnh chính, phản hồi thẻ BHYT — Logical Model
          Logical ModelInstances of this logical model are not marked to be the target of a Reference
          2. vnBirthCertificateResidencyLm.noiCuTru
          Definition

          Nơi cư trú ghi trên giấy chứng sinh

          ShortNơi cư trú ghi trên giấy chứng sinh
          Comments

          Ba trường của chỉ tiêu 8 đều mang dấu X trong cột bắt buộc của bảng. Chúng bổ sung nhau chứ không thay thế: địa chỉ chữ cho người đọc, hai mã hành chính cho máy đối chiếu danh mục.

          Control1..1
          TypeBackboneElement
          4. vnBirthCertificateResidencyLm.noiCuTru.diaChiDayDu
          Definition

          Địa chỉ nơi cư trú

          ShortĐịa chỉ nơi cư trú
          Comments

          'Ghi địa chỉ nơi cư trú (thường trú hoặc tạm trú hoặc nơi ở hiện tại)' — văn bản chấp nhận cả ba loại nơi cư trú, không đòi riêng thường trú.

          Control1..1
          Typestring
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
          6. vnBirthCertificateResidencyLm.noiCuTru.maTinh
          Definition

          Mã đơn vị hành chính cấp tỉnh

          ShortMã đơn vị hành chính cấp tỉnh
          Comments

          'Ghi theo 02 ký tự của mã đơn vị hành chính' — độ dài cố định là ràng buộc của bảng chỉ tiêu, và nó khớp danh mục 34 tỉnh/thành sau NQ 202/2025/QH15.

          Control1..1
          Typestring
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
          8. vnBirthCertificateResidencyLm.noiCuTru.maXa
          Definition

          Mã đơn vị hành chính cấp xã, phường

          ShortMã đơn vị hành chính cấp xã, phường
          Comments

          5 ký tự. Cấp xã là cấp hành chính thứ hai và cuối cùng sau mô hình hai cấp — không có mã cấp huyện trong bảng này.

          Control1..1
          Typestring
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
          10. vnBirthCertificateResidencyLm.giayChungSinh
          Definition

          Bản ghi giấy chứng sinh

          ShortBản ghi giấy chứng sinh
          Control1..1
          TypeBackboneElement
          12. vnBirthCertificateResidencyLm.giayChungSinh.maGiayChungSinh
          Definition

          Mã giấy chứng sinh

          ShortMã giấy chứng sinh
          Comments

          Mã định danh của giấy chứng sinh, là khoá để liên thông bản điện tử với hộ tịch.

          Control1..1
          Typestring
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
          14. vnBirthCertificateResidencyLm.chanDoan
          Definition

          Chẩn đoán bệnh chính của đợt khám bệnh, chữa bệnh

          ShortChẩn đoán bệnh chính của đợt khám bệnh, chữa bệnh
          Comments

          Chỉ tiêu 27 MA_BENH_CHINH độ dài 7 ký tự, khác chỉ tiêu 28 MA_BENH_KT (bệnh kèm theo, 100 ký tự — nhiều mã nối nhau). Bệnh chính có đúng MỘT nên cardinality 1..1; bệnh kèm theo không thuộc model này.

          Control1..1
          TypeBackboneElement
          16. vnBirthCertificateResidencyLm.chanDoan.maBenhChinh
          Definition

          Mã bệnh chính theo ICD-10

          ShortMã bệnh chính theo ICD-10
          Comments

          'Ghi mã bệnh chính theo mã ICD-10 do Bộ trưởng Bộ Y tế ban hành'. Căn cứ hiện hành của danh mục ICD-10 là TT 06/2026/TT-BYT cùng QĐ 1849/QĐ-BYT; QĐ 4469/QĐ-BYT mà QĐ 3176/QĐ-BYT dẫn nay chỉ còn là nguồn gốc cho dữ liệu lập trước 01/07/2026.

          Control1..1
          Typestring
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
          18. vnBirthCertificateResidencyLm.phanHoiTheBhyt
          Definition

          Phản hồi của Cổng Thông tin giám định BHYT khi cơ sở tra cứu thẻ

          ShortPhản hồi của Cổng Thông tin giám định BHYT khi cơ sở tra cứu thẻ
          Comments

          'NGAY KHI nhận được thông tin do cơ sở khám bệnh, chữa bệnh thực hiện kiểm tra tình trạng, thông tin thẻ bảo hiểm y tế của người đến khám bệnh, chữa bệnh, Cổng Thông tin giám định bảo hiểm y tế PHẢI phản hồi thông tin về tình trạng, thông tin thẻ bảo hiểm y tế của người đó.' Nghĩa vụ đặt lên Cổng chứ không lên cơ sở KBCB — profile này mô hình hoá phía phản hồi.

          Control1..1
          TypeBackboneElement
          20. vnBirthCertificateResidencyLm.phanHoiTheBhyt.tinhTrangThe
          Definition

          Tình trạng thẻ bảo hiểm y tế

          ShortTình trạng thẻ bảo hiểm y tế
          Comments

          Thẻ còn hiệu lực hay không tại thời điểm tra cứu — trên CoverageEligibilityResponse là insurance.inforce.

          Control1..1
          Typeboolean
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
          22. vnBirthCertificateResidencyLm.phanHoiTheBhyt.thongTinThe
          Definition

          Thông tin thẻ bảo hiểm y tế

          ShortThông tin thẻ bảo hiểm y tế
          Control1..1
          Typestring
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension

          Guidance on how to interpret the contents of this table can be foundhere

          0. vnBirthCertificateResidencyLm
          Definition

          Logical model gom ba nhóm nghĩa vụ ghi trường còn lại của đợt đối chiếu nhóm (A), mỗi nhóm một văn bản nguồn — làm bảng chỉ tiêu văn bản để đối chiếu cardinality của các profile tương ứng.

          Nhóm địa chỉ và giấy chứng sinh theo QĐ 2919/QĐ-BYT Phụ lục I: bảng chỉ tiêu đánh dấu X vào ba trường nơi cư trú — NOI_CU_TRU (địa chỉ đầy đủ, tối đa 1024 ký tự), MATINH_CU_TRU (mã đơn vị hành chính cấp tỉnh, 2 ký tự) và MAXA_CU_TRU (mã đơn vị hành chính cấp xã/phường, 5 ký tự) — cùng mã giấy chứng sinh MA_GCS. Hai mã hành chính tách riêng khỏi địa chỉ chữ là có lý do: địa chỉ chữ để người đọc, còn mã để máy đối chiếu với danh mục đơn vị hành chính.

          Nhóm mã bệnh theo QĐ 3176/QĐ-BYT Bảng 1 chỉ tiêu 27: 'Ghi mã bệnh chính theo mã ICD-10 do Bộ trưởng Bộ Y tế ban hành'. Chỉ tiêu 28 MA_BENH_KT (bệnh kèm theo) là trường riêng và không mang cùng nghĩa vụ — bệnh chính có đúng MỘT, bệnh kèm theo có thể nhiều hoặc không có.

          Nhóm phản hồi tra cứu thẻ theo TT 48/2017/TT-BYT Điều 6 khoản 2 điểm a: Cổng Thông tin giám định BHYT 'phải phản hồi thông tin về tình trạng, thông tin thẻ bảo hiểm y tế của người đó'. Cùng điểm a còn buộc cung cấp lịch sử khám chữa bệnh 6 tháng gần nhất, nhưng đó là dữ liệu KHÁC — không thuộc phản hồi quyền lợi, nên không đưa vào model này. / Logical model gathering the remaining field-level obligations of documentary conformance group (A).

          ShortNghĩa vụ ghi trường: giấy chứng sinh, mã bệnh chính, phản hồi thẻ BHYT — Logical Model
          Control0..*
          Is Modifierfalse
          Logical ModelInstances of this logical model are not marked to be the target of a Reference
          2. vnBirthCertificateResidencyLm.noiCuTru
          Definition

          Nơi cư trú ghi trên giấy chứng sinh

          ShortNơi cư trú ghi trên giấy chứng sinh
          Comments

          Ba trường của chỉ tiêu 8 đều mang dấu X trong cột bắt buộc của bảng. Chúng bổ sung nhau chứ không thay thế: địa chỉ chữ cho người đọc, hai mã hành chính cho máy đối chiếu danh mục.

          Control1..1
          TypeBackboneElement
          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          4. vnBirthCertificateResidencyLm.noiCuTru.id
          Definition

          Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

          ShortUnique id for inter-element referencing
          Control0..1
          Typestring
          Is Modifierfalse
          XML FormatIn the XML format, this property is represented as an attribute.
          Summaryfalse
          6. vnBirthCertificateResidencyLm.noiCuTru.extension
          Definition

          May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

          ShortAdditional content defined by implementations
          Comments

          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

          Control0..*
          TypeExtension
          Is Modifierfalse
          Summaryfalse
          Alternate Namesextensions, user content
          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
          SlicingThis element introduces a set of slices on vnBirthCertificateResidencyLm.noiCuTru.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
          • value @ url
          • 8. vnBirthCertificateResidencyLm.noiCuTru.modifierExtension
            Definition

            May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

            Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

            ShortExtensions that cannot be ignored even if unrecognized
            Comments

            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

            Control0..*
            TypeExtension
            Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
            Summarytrue
            Requirements

            Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

            Alternate Namesextensions, user content, modifiers
            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
            10. vnBirthCertificateResidencyLm.noiCuTru.diaChiDayDu
            Definition

            Địa chỉ nơi cư trú

            ShortĐịa chỉ nơi cư trú
            Comments

            'Ghi địa chỉ nơi cư trú (thường trú hoặc tạm trú hoặc nơi ở hiện tại)' — văn bản chấp nhận cả ba loại nơi cư trú, không đòi riêng thường trú.

            Control1..1
            Typestring
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            12. vnBirthCertificateResidencyLm.noiCuTru.maTinh
            Definition

            Mã đơn vị hành chính cấp tỉnh

            ShortMã đơn vị hành chính cấp tỉnh
            Comments

            'Ghi theo 02 ký tự của mã đơn vị hành chính' — độ dài cố định là ràng buộc của bảng chỉ tiêu, và nó khớp danh mục 34 tỉnh/thành sau NQ 202/2025/QH15.

            Control1..1
            Typestring
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            14. vnBirthCertificateResidencyLm.noiCuTru.maXa
            Definition

            Mã đơn vị hành chính cấp xã, phường

            ShortMã đơn vị hành chính cấp xã, phường
            Comments

            5 ký tự. Cấp xã là cấp hành chính thứ hai và cuối cùng sau mô hình hai cấp — không có mã cấp huyện trong bảng này.

            Control1..1
            Typestring
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            16. vnBirthCertificateResidencyLm.giayChungSinh
            Definition

            Bản ghi giấy chứng sinh

            ShortBản ghi giấy chứng sinh
            Control1..1
            TypeBackboneElement
            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            18. vnBirthCertificateResidencyLm.giayChungSinh.id
            Definition

            Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

            ShortUnique id for inter-element referencing
            Control0..1
            Typestring
            Is Modifierfalse
            XML FormatIn the XML format, this property is represented as an attribute.
            Summaryfalse
            20. vnBirthCertificateResidencyLm.giayChungSinh.extension
            Definition

            May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

            ShortAdditional content defined by implementations
            Comments

            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

            Control0..*
            TypeExtension
            Is Modifierfalse
            Summaryfalse
            Alternate Namesextensions, user content
            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
            SlicingThis element introduces a set of slices on vnBirthCertificateResidencyLm.giayChungSinh.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
            • value @ url
            • 22. vnBirthCertificateResidencyLm.giayChungSinh.modifierExtension
              Definition

              May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

              Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

              ShortExtensions that cannot be ignored even if unrecognized
              Comments

              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

              Control0..*
              TypeExtension
              Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
              Summarytrue
              Requirements

              Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

              Alternate Namesextensions, user content, modifiers
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
              24. vnBirthCertificateResidencyLm.giayChungSinh.maGiayChungSinh
              Definition

              Mã giấy chứng sinh

              ShortMã giấy chứng sinh
              Comments

              Mã định danh của giấy chứng sinh, là khoá để liên thông bản điện tử với hộ tịch.

              Control1..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              26. vnBirthCertificateResidencyLm.chanDoan
              Definition

              Chẩn đoán bệnh chính của đợt khám bệnh, chữa bệnh

              ShortChẩn đoán bệnh chính của đợt khám bệnh, chữa bệnh
              Comments

              Chỉ tiêu 27 MA_BENH_CHINH độ dài 7 ký tự, khác chỉ tiêu 28 MA_BENH_KT (bệnh kèm theo, 100 ký tự — nhiều mã nối nhau). Bệnh chính có đúng MỘT nên cardinality 1..1; bệnh kèm theo không thuộc model này.

              Control1..1
              TypeBackboneElement
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              28. vnBirthCertificateResidencyLm.chanDoan.id
              Definition

              Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

              ShortUnique id for inter-element referencing
              Control0..1
              Typestring
              Is Modifierfalse
              XML FormatIn the XML format, this property is represented as an attribute.
              Summaryfalse
              30. vnBirthCertificateResidencyLm.chanDoan.extension
              Definition

              May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

              ShortAdditional content defined by implementations
              Comments

              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

              Control0..*
              TypeExtension
              Is Modifierfalse
              Summaryfalse
              Alternate Namesextensions, user content
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
              SlicingThis element introduces a set of slices on vnBirthCertificateResidencyLm.chanDoan.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
              • value @ url
              • 32. vnBirthCertificateResidencyLm.chanDoan.modifierExtension
                Definition

                May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                ShortExtensions that cannot be ignored even if unrecognized
                Comments

                There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                Control0..*
                TypeExtension
                Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                Summarytrue
                Requirements

                Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                Alternate Namesextensions, user content, modifiers
                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                34. vnBirthCertificateResidencyLm.chanDoan.maBenhChinh
                Definition

                Mã bệnh chính theo ICD-10

                ShortMã bệnh chính theo ICD-10
                Comments

                'Ghi mã bệnh chính theo mã ICD-10 do Bộ trưởng Bộ Y tế ban hành'. Căn cứ hiện hành của danh mục ICD-10 là TT 06/2026/TT-BYT cùng QĐ 1849/QĐ-BYT; QĐ 4469/QĐ-BYT mà QĐ 3176/QĐ-BYT dẫn nay chỉ còn là nguồn gốc cho dữ liệu lập trước 01/07/2026.

                Control1..1
                Typestring
                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                36. vnBirthCertificateResidencyLm.phanHoiTheBhyt
                Definition

                Phản hồi của Cổng Thông tin giám định BHYT khi cơ sở tra cứu thẻ

                ShortPhản hồi của Cổng Thông tin giám định BHYT khi cơ sở tra cứu thẻ
                Comments

                'NGAY KHI nhận được thông tin do cơ sở khám bệnh, chữa bệnh thực hiện kiểm tra tình trạng, thông tin thẻ bảo hiểm y tế của người đến khám bệnh, chữa bệnh, Cổng Thông tin giám định bảo hiểm y tế PHẢI phản hồi thông tin về tình trạng, thông tin thẻ bảo hiểm y tế của người đó.' Nghĩa vụ đặt lên Cổng chứ không lên cơ sở KBCB — profile này mô hình hoá phía phản hồi.

                Control1..1
                TypeBackboneElement
                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                38. vnBirthCertificateResidencyLm.phanHoiTheBhyt.id
                Definition

                Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                ShortUnique id for inter-element referencing
                Control0..1
                Typestring
                Is Modifierfalse
                XML FormatIn the XML format, this property is represented as an attribute.
                Summaryfalse
                40. vnBirthCertificateResidencyLm.phanHoiTheBhyt.extension
                Definition

                May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                ShortAdditional content defined by implementations
                Comments

                There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                Control0..*
                TypeExtension
                Is Modifierfalse
                Summaryfalse
                Alternate Namesextensions, user content
                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                SlicingThis element introduces a set of slices on vnBirthCertificateResidencyLm.phanHoiTheBhyt.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                • value @ url
                • 42. vnBirthCertificateResidencyLm.phanHoiTheBhyt.modifierExtension
                  Definition

                  May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                  Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                  ShortExtensions that cannot be ignored even if unrecognized
                  Comments

                  There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                  Control0..*
                  TypeExtension
                  Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                  Summarytrue
                  Requirements

                  Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                  Alternate Namesextensions, user content, modifiers
                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                  ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                  44. vnBirthCertificateResidencyLm.phanHoiTheBhyt.tinhTrangThe
                  Definition

                  Tình trạng thẻ bảo hiểm y tế

                  ShortTình trạng thẻ bảo hiểm y tế
                  Comments

                  Thẻ còn hiệu lực hay không tại thời điểm tra cứu — trên CoverageEligibilityResponse là insurance.inforce.

                  Control1..1
                  Typeboolean
                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                  46. vnBirthCertificateResidencyLm.phanHoiTheBhyt.thongTinThe
                  Definition

                  Thông tin thẻ bảo hiểm y tế

                  ShortThông tin thẻ bảo hiểm y tế
                  Control1..1
                  Typestring
                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension