Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.6.0 - Draft for Community Review
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.6.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft tại thời điểm 2026-06-10 |
Các định nghĩa cho vnHealthCheckupG12EnvelopeLm mô hình logic
Guidance on how to interpret the contents of this table can be foundhere
| 0. vnHealthCheckupG12EnvelopeLm | |
| Definition | Logical model cho bản tin tiếp nhận dữ liệu khám bệnh từ Bảo hiểm xã hội Việt Nam, đồng bộ qua Trung tâm Dữ liệu Quốc gia (TTDLQG / NDOP — CP.NET) về CSDL sức khỏe Bộ Y tế. API: POST /api/integrate/v1/G12. Luồng: BHXH tạo XML (cấu trúc do TTDLQG cung cấp) → base64 → ký số (dịch vụ Ban Cơ yếu) → gửi qua AgentNode. Xác thực: API Key do TTDLQG cấp. X-Service = G12. KHÁC với BHYT Gateway thanh toán (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface đồng bộ dữ liệu khám bệnh BHXH → CSDL sức khỏe cá nhân. INFORMATIVE / non-normative: mô hình ánh xạ transport envelope NDOP G12 (không phải FHIR resource normative) — mapping aid cho implementer. Căn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 03 đặc tả API. |
| Short | Bản tin BHXH → TTDLQG (dịch vụ G12) — Logical Model (Phụ lục 03) |
| Control | 0..* |
| Is Modifier | false |
| Logical Model | Instances of this logical model are not marked to be the target of a Reference |
| 2. vnHealthCheckupG12EnvelopeLm.contentType | |
| Definition | content-type - application/json |
| Short | content-type - application/json |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 4. vnHealthCheckupG12EnvelopeLm.authorization | |
| Definition | authorization - API Key do TTDLQG cấp |
| Short | authorization - API Key do TTDLQG cấp |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 6. vnHealthCheckupG12EnvelopeLm.dataType | |
| Definition | data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ) |
| Short | data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 8. vnHealthCheckupG12EnvelopeLm.requestId | |
| Definition | request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống |
| Short | request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 10. vnHealthCheckupG12EnvelopeLm.requestTime | |
| Definition | request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout |
| Short | request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 12. vnHealthCheckupG12EnvelopeLm.xService | |
| Definition | X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12 |
| Short | X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12 |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 14. vnHealthCheckupG12EnvelopeLm.fileName | |
| Definition | fileName - Tên bản tin đã ký số |
| Short | fileName - Tên bản tin đã ký số |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 16. vnHealthCheckupG12EnvelopeLm.fileContent | |
| Definition | fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh) |
| Short | fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 18. vnHealthCheckupG12EnvelopeLm.statusCode | |
| Definition | statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG) |
| Short | statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 20. vnHealthCheckupG12EnvelopeLm.errorCode | |
| Definition | errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại |
| Short | errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 22. vnHealthCheckupG12EnvelopeLm.responseTime | |
| Definition | responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss) |
| Short | responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss) |
| Control | 0..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. vnHealthCheckupG12EnvelopeLm | |
| Definition | Logical model cho bản tin tiếp nhận dữ liệu khám bệnh từ Bảo hiểm xã hội Việt Nam, đồng bộ qua Trung tâm Dữ liệu Quốc gia (TTDLQG / NDOP — CP.NET) về CSDL sức khỏe Bộ Y tế. API: POST /api/integrate/v1/G12. Luồng: BHXH tạo XML (cấu trúc do TTDLQG cung cấp) → base64 → ký số (dịch vụ Ban Cơ yếu) → gửi qua AgentNode. Xác thực: API Key do TTDLQG cấp. X-Service = G12. KHÁC với BHYT Gateway thanh toán (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface đồng bộ dữ liệu khám bệnh BHXH → CSDL sức khỏe cá nhân. INFORMATIVE / non-normative: mô hình ánh xạ transport envelope NDOP G12 (không phải FHIR resource normative) — mapping aid cho implementer. Căn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 03 đặc tả API. |
| Short | Bản tin BHXH → TTDLQG (dịch vụ G12) — Logical Model (Phụ lục 03) |
| Logical Model | Instances of this logical model are not marked to be the target of a Reference |
| 2. vnHealthCheckupG12EnvelopeLm.contentType | |
| Definition | content-type - application/json |
| Short | content-type - application/json |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 4. vnHealthCheckupG12EnvelopeLm.authorization | |
| Definition | authorization - API Key do TTDLQG cấp |
| Short | authorization - API Key do TTDLQG cấp |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 6. vnHealthCheckupG12EnvelopeLm.dataType | |
| Definition | data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ) |
| Short | data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 8. vnHealthCheckupG12EnvelopeLm.requestId | |
| Definition | request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống |
| Short | request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 10. vnHealthCheckupG12EnvelopeLm.requestTime | |
| Definition | request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout |
| Short | request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 12. vnHealthCheckupG12EnvelopeLm.xService | |
| Definition | X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12 |
| Short | X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12 |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 14. vnHealthCheckupG12EnvelopeLm.fileName | |
| Definition | fileName - Tên bản tin đã ký số |
| Short | fileName - Tên bản tin đã ký số |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 16. vnHealthCheckupG12EnvelopeLm.fileContent | |
| Definition | fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh) |
| Short | fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 18. vnHealthCheckupG12EnvelopeLm.statusCode | |
| Definition | statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG) |
| Short | statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 20. vnHealthCheckupG12EnvelopeLm.errorCode | |
| Definition | errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại |
| Short | errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 22. vnHealthCheckupG12EnvelopeLm.responseTime | |
| Definition | responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss) |
| Short | responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss) |
| Control | 0..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. vnHealthCheckupG12EnvelopeLm | |
| Definition | Logical model cho bản tin tiếp nhận dữ liệu khám bệnh từ Bảo hiểm xã hội Việt Nam, đồng bộ qua Trung tâm Dữ liệu Quốc gia (TTDLQG / NDOP — CP.NET) về CSDL sức khỏe Bộ Y tế. API: POST /api/integrate/v1/G12. Luồng: BHXH tạo XML (cấu trúc do TTDLQG cung cấp) → base64 → ký số (dịch vụ Ban Cơ yếu) → gửi qua AgentNode. Xác thực: API Key do TTDLQG cấp. X-Service = G12. KHÁC với BHYT Gateway thanh toán (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface đồng bộ dữ liệu khám bệnh BHXH → CSDL sức khỏe cá nhân. INFORMATIVE / non-normative: mô hình ánh xạ transport envelope NDOP G12 (không phải FHIR resource normative) — mapping aid cho implementer. Căn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 03 đặc tả API. |
| Short | Bản tin BHXH → TTDLQG (dịch vụ G12) — Logical Model (Phụ lục 03) |
| Control | 0..* |
| Is Modifier | false |
| Logical Model | Instances of this logical model are not marked to be the target of a Reference |
| 2. vnHealthCheckupG12EnvelopeLm.contentType | |
| Definition | content-type - application/json |
| Short | content-type - application/json |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 4. vnHealthCheckupG12EnvelopeLm.authorization | |
| Definition | authorization - API Key do TTDLQG cấp |
| Short | authorization - API Key do TTDLQG cấp |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 6. vnHealthCheckupG12EnvelopeLm.dataType | |
| Definition | data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ) |
| Short | data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 8. vnHealthCheckupG12EnvelopeLm.requestId | |
| Definition | request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống |
| Short | request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 10. vnHealthCheckupG12EnvelopeLm.requestTime | |
| Definition | request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout |
| Short | request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 12. vnHealthCheckupG12EnvelopeLm.xService | |
| Definition | X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12 |
| Short | X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12 |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 14. vnHealthCheckupG12EnvelopeLm.fileName | |
| Definition | fileName - Tên bản tin đã ký số |
| Short | fileName - Tên bản tin đã ký số |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 16. vnHealthCheckupG12EnvelopeLm.fileContent | |
| Definition | fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh) |
| Short | fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 18. vnHealthCheckupG12EnvelopeLm.statusCode | |
| Definition | statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG) |
| Short | statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 20. vnHealthCheckupG12EnvelopeLm.errorCode | |
| Definition | errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại |
| Short | errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 22. vnHealthCheckupG12EnvelopeLm.responseTime | |
| Definition | responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss) |
| Short | responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
