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
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
| 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ú — 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 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). |
| Short | Nghĩa vụ ghi trường: giấy chứng sinh, mã bệnh chính, phản hồi thẻ BHYT — Logical Model |
| Control | 0..* |
| Is Modifier | false |
| Logical Model | Instances 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 |
| Short | Nơ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. |
| Control | 1..1 |
| Type | BackboneElement |
| Invariants | ele-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. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 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. |
| Short | Additional 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-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()) |
| Slicing | This element introduces a set of slices on vnBirthCertificateResidencyLm.noiCuTru.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 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). |
| Short | Extensions 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| 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 Names | extensions, user content, modifiers |
| Invariants | ele-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ú. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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 |
| Short | Mã đơ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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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 |
| Short | Mã đơ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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 16. vnBirthCertificateResidencyLm.giayChungSinh | |
| Definition | Bản ghi giấy chứng sinh |
| Short | Bản ghi giấy chứng sinh |
| Control | 1..1 |
| Type | BackboneElement |
| Invariants | ele-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. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 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. |
| Short | Additional 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-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()) |
| Slicing | This element introduces a set of slices on vnBirthCertificateResidencyLm.giayChungSinh.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 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). |
| Short | Extensions 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| 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 Names | extensions, user content, modifiers |
| Invariants | ele-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 |
| Short | Mã 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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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 |
| Short | Chẩ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. |
| Control | 1..1 |
| Type | BackboneElement |
| Invariants | ele-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. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 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. |
| Short | Additional 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-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()) |
| Slicing | This element introduces a set of slices on vnBirthCertificateResidencyLm.chanDoan.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 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). |
| Short | Extensions 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| 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 Names | extensions, user content, modifiers |
| Invariants | ele-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 |
| Short | Mã 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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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ẻ |
| Short | Phả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. |
| Control | 1..1 |
| Type | BackboneElement |
| Invariants | ele-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. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 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. |
| Short | Additional 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-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()) |
| Slicing | This element introduces a set of slices on vnBirthCertificateResidencyLm.phanHoiTheBhyt.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 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). |
| Short | Extensions 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| 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 Names | extensions, user content, modifiers |
| Invariants | ele-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ế |
| Short | Tì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à |
| Control | 1..1 |
| Type | boolean |
| Primitive Value | This 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ế |
| Short | Thông tin thẻ bảo hiểm y tế |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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ú — 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 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). |
| Short | Nghĩa vụ ghi trường: giấy chứng sinh, mã bệnh chính, phản hồi thẻ BHYT — Logical Model |
| Logical Model | Instances 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 |
| Short | Nơ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. |
| Control | 1..1 |
| Type | BackboneElement |
| 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ú. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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 |
| Short | Mã đơ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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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 |
| Short | Mã đơ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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 10. vnBirthCertificateResidencyLm.giayChungSinh | |
| Definition | Bản ghi giấy chứng sinh |
| Short | Bản ghi giấy chứng sinh |
| Control | 1..1 |
| Type | BackboneElement |
| 12. vnBirthCertificateResidencyLm.giayChungSinh.maGiayChungSinh | |
| Definition | Mã giấy chứng sinh |
| Short | Mã 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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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 |
| Short | Chẩ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. |
| Control | 1..1 |
| Type | BackboneElement |
| 16. vnBirthCertificateResidencyLm.chanDoan.maBenhChinh | |
| Definition | Mã bệnh chính theo ICD-10 |
| Short | Mã 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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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ẻ |
| Short | Phả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. |
| Control | 1..1 |
| Type | BackboneElement |
| 20. vnBirthCertificateResidencyLm.phanHoiTheBhyt.tinhTrangThe | |
| Definition | Tình trạng thẻ bảo hiểm y tế |
| Short | Tì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à |
| Control | 1..1 |
| Type | boolean |
| Primitive Value | This 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ế |
| Short | Thông tin thẻ bảo hiểm y tế |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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ú — 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 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). |
| Short | Nghĩa vụ ghi trường: giấy chứng sinh, mã bệnh chính, phản hồi thẻ BHYT — Logical Model |
| Control | 0..* |
| Is Modifier | false |
| Logical Model | Instances 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 |
| Short | Nơ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. |
| Control | 1..1 |
| Type | BackboneElement |
| Invariants | ele-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. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 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. |
| Short | Additional 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-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()) |
| Slicing | This element introduces a set of slices on vnBirthCertificateResidencyLm.noiCuTru.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 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). |
| Short | Extensions 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| 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 Names | extensions, user content, modifiers |
| Invariants | ele-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ú. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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 |
| Short | Mã đơ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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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 |
| Short | Mã đơ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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 16. vnBirthCertificateResidencyLm.giayChungSinh | |
| Definition | Bản ghi giấy chứng sinh |
| Short | Bản ghi giấy chứng sinh |
| Control | 1..1 |
| Type | BackboneElement |
| Invariants | ele-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. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 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. |
| Short | Additional 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-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()) |
| Slicing | This element introduces a set of slices on vnBirthCertificateResidencyLm.giayChungSinh.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 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). |
| Short | Extensions 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| 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 Names | extensions, user content, modifiers |
| Invariants | ele-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 |
| Short | Mã 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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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 |
| Short | Chẩ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. |
| Control | 1..1 |
| Type | BackboneElement |
| Invariants | ele-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. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 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. |
| Short | Additional 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-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()) |
| Slicing | This element introduces a set of slices on vnBirthCertificateResidencyLm.chanDoan.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 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). |
| Short | Extensions 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| 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 Names | extensions, user content, modifiers |
| Invariants | ele-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 |
| Short | Mã 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. |
| Control | 1..1 |
| Type | string |
| Primitive Value | This 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ẻ |
| Short | Phả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. |
| Control | 1..1 |
| Type | BackboneElement |
| Invariants | ele-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. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 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. |
| Short | Additional 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-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()) |
| Slicing | This element introduces a set of slices on vnBirthCertificateResidencyLm.phanHoiTheBhyt.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 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). |
| Short | Extensions 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. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| 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 Names | extensions, user content, modifiers |
| Invariants | ele-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ế |
| Short | Tì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à |
| Control | 1..1 |
| Type | boolean |
| Primitive Value | This 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ế |
| Short | Thông tin thẻ bảo hiểm y tế |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |