Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.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.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft tại thời điểm 2026-07-27 |
{
"resourceType" : "CodeSystem",
"id" : "vn-task-business-status-cs",
"language" : "vi",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem vn-task-business-status-cs</b></p><a name=\"vn-task-business-status-cs\"> </a><a name=\"hcvn-task-business-status-cs\"> </a><p><b>Properties</b></p><p><b>This code system defines the following properties for its concepts</b></p><table class=\"grid\"><tr><td><b>Name</b></td><td><b>Code</b></td><td><b>URI</b></td><td><b>Type</b></td><td><b>Description</b></td></tr><tr><td>codeSource</td><td>codeSource</td><td>http://fhir.hl7.org.vn/core/CodeSystem/vn-task-business-status-cs#codeSource</td><td>code</td><td>Nguồn của mã: statutory (trích từ danh mục trong văn bản) hoặc project-assigned (do dự án tự đặt).</td></tr></table><p><b>Concepts</b></p><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-task-business-status-cs</code> defines the following codes:</p><table class=\"codes\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td><td><b>codeSource</b></td><td><b>English (English, en)</b></td></tr><tr><td style=\"white-space:nowrap\">REF-SENT<a name=\"vn-task-business-status-cs-REF-SENT\"> </a></td><td>Đã gửi yêu cầu chuyển</td><td>Cơ sở chuyển đi đã phát hành giấy chuyển và gửi tới cơ sở dự kiến tiếp nhận; chưa có phản hồi. Neo vào nghĩa vụ giới thiệu, chuyển người bệnh tại Luật 15/2023/QH15 Điều 60 khoản 10.</td><td>project-assigned</td><td>Referral sent</td></tr><tr><td style=\"white-space:nowrap\">REF-ACCEPTED<a name=\"vn-task-business-status-cs-REF-ACCEPTED\"> </a></td><td>Cơ sở nhận đồng ý tiếp nhận</td><td>Cơ sở dự kiến tiếp nhận đã xác nhận đủ điều kiện chuyên môn và đồng ý nhận người bệnh; người bệnh chưa đến.</td><td>project-assigned</td><td>Referral accepted</td></tr><tr><td style=\"white-space:nowrap\">REF-DECLINED<a name=\"vn-task-business-status-cs-REF-DECLINED\"> </a></td><td>Cơ sở nhận từ chối tiếp nhận</td><td>Cơ sở dự kiến tiếp nhận từ chối; lý do ghi ở Task.statusReason. Trường hợp cấp cứu không được từ chối theo Luật 15/2023/QH15 Điều 61.</td><td>project-assigned</td><td>Referral declined</td></tr><tr><td style=\"white-space:nowrap\">REF-ARRIVED<a name=\"vn-task-business-status-cs-REF-ARRIVED\"> </a></td><td>Người bệnh đã đến cơ sở nhận</td><td>Cơ sở tiếp nhận đã ghi nhận người bệnh đến và mở lượt khám chữa bệnh tương ứng.</td><td>project-assigned</td><td>Patient arrived at receiving facility</td></tr><tr><td style=\"white-space:nowrap\">REF-COMPLETED<a name=\"vn-task-business-status-cs-REF-COMPLETED\"> </a></td><td>Đã hoàn thành KCB tại cơ sở nhận</td><td>Cơ sở tiếp nhận đã kết thúc đợt khám chữa bệnh phát sinh từ yêu cầu chuyển.</td><td>project-assigned</td><td>Care completed at receiving facility</td></tr><tr><td style=\"white-space:nowrap\">REF-RETURNED<a name=\"vn-task-business-status-cs-REF-RETURNED\"> </a></td><td>Đã chuyển người bệnh trở lại cơ sở chuyển đi</td><td>Người bệnh được chuyển về cơ sở ban đầu để tiếp tục theo dõi, điều trị.</td><td>project-assigned</td><td>Patient referred back</td></tr><tr><td style=\"white-space:nowrap\">RX-PENDING<a name=\"vn-task-business-status-cs-RX-PENDING\"> </a></td><td>Chờ cấp phát</td><td>Đơn đã phát hành, còn trong thời hạn lĩnh thuốc, chưa có lần cấp phát nào.</td><td>project-assigned</td><td>Awaiting dispense</td></tr><tr><td style=\"white-space:nowrap\">RX-PARTIAL<a name=\"vn-task-business-status-cs-RX-PARTIAL\"> </a></td><td>Đã cấp phát một phần</td><td>Một phần số thuốc trong đơn đã được cấp phát hoặc bán; phần còn lại vẫn chờ trong thời hạn lĩnh thuốc.</td><td>project-assigned</td><td>Partially dispensed</td></tr><tr><td style=\"white-space:nowrap\">RX-DISPENSED<a name=\"vn-task-business-status-cs-RX-DISPENSED\"> </a></td><td>Đã cấp phát đủ</td><td>Toàn bộ số thuốc trong đơn đã được cấp phát hoặc bán; công việc điều phối kết thúc.</td><td>project-assigned</td><td>Fully dispensed</td></tr><tr><td style=\"white-space:nowrap\">RX-EXPIRED<a name=\"vn-task-business-status-cs-RX-EXPIRED\"> </a></td><td>Quá thời hạn lĩnh thuốc</td><td>Đã quá 05 ngày kể từ ngày kê đơn mà người bệnh chưa lĩnh hết thuốc, theo TT 26/2025/TT-BYT Điều 12 khoản 9 điểm b. Cơ sở bán lẻ không được tiếp tục bán theo đơn này.</td><td>project-assigned</td><td>Dispense window expired</td></tr><tr><td style=\"white-space:nowrap\">RX-CANCELLED<a name=\"vn-task-business-status-cs-RX-CANCELLED\"> </a></td><td>Đơn bị hủy trước khi cấp phát</td><td>Người kê đơn hủy đơn trước khi thuốc được cấp phát; lý do ghi ở Task.statusReason.</td><td>project-assigned</td><td>Prescription cancelled before dispense</td></tr></table></div>"
},
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "L-15-2023"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "TT-26-2025"
}
}
],
"url" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-task-business-status-cs",
"identifier" : [
{
"system" : "urn:ietf:rfc:3986",
"value" : "urn:oid:2.25.161089673617632664299011809196868855799.16.136"
}
],
"version" : "0.9.0",
"name" : "VNTaskBusinessStatusCS",
"title" : "Trạng thái nghiệp vụ công việc điều phối — VN Task Business Status CodeSystem",
"status" : "draft",
"experimental" : false,
"date" : "2026-07-27",
"publisher" : "Omi HealthTech / VN Core FHIR Community Initiative",
"contact" : [
{
"name" : "Omi HealthTech / VN Core FHIR Community Initiative",
"telecom" : [
{
"system" : "url",
"value" : "https://hl7.org.vn"
},
{
"system" : "email",
"value" : "[email protected]"
}
]
},
{
"name" : "Omi HealthTech (OmiGroup)",
"telecom" : [
{
"system" : "url",
"value" : "https://omihealthtech.vn"
},
{
"system" : "url",
"value" : "https://omigroup.vn"
},
{
"system" : "email",
"value" : "[email protected]"
}
]
}
],
"description" : "Trạng thái nghiệp vụ của công việc điều phối trong hai luồng đã có trong VN Core: tiếp nhận chuyển người bệnh (nhóm mã REF, theo Luật 15/2023/QH15 Điều 60 khoản 10) và cấp phát, bán thuốc theo đơn (nhóm mã RX, theo TT 26/2025/TT-BYT Điều 12). Toàn bộ mã do dự án tự đặt (property codeSource = project-assigned) vì chưa có danh mục mã quốc gia cho trạng thái nghiệp vụ điều phối; không suy diễn là mã do Bộ Y tế ban hành. Dùng ở Task.businessStatus, bổ sung cho Task.status vốn chỉ mô tả vòng đời kỹ thuật của công việc. /\nBusiness status of coordination tasks in two workflows already covered by VN Core: patient referral acceptance (REF codes, per Law 15/2023/QH15 Art.60.10) and prescription dispensing (RX codes, per Circular 26/2025/TT-BYT Art.12). All codes are project-assigned as no national code list exists for coordination business status.",
"jurisdiction" : [
{
"coding" : [
{
"system" : "urn:iso:std:iso:3166",
"code" : "VN",
"display" : "Viet Nam"
}
]
}
],
"copyright" : "Omi HealthTech / VN Core FHIR Community Initiative. Mã do dự án tự đặt; nghĩa vụ nền theo Luật 15/2023/QH15 và TT 26/2025/TT-BYT.",
"caseSensitive" : true,
"content" : "complete",
"count" : 11,
"property" : [
{
"code" : "codeSource",
"uri" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-task-business-status-cs#codeSource",
"description" : "Nguồn của mã: statutory (trích từ danh mục trong văn bản) hoặc project-assigned (do dự án tự đặt).",
"type" : "code"
}
],
"concept" : [
{
"code" : "REF-SENT",
"display" : "Đã gửi yêu cầu chuyển",
"definition" : "Cơ sở chuyển đi đã phát hành giấy chuyển và gửi tới cơ sở dự kiến tiếp nhận; chưa có phản hồi. Neo vào nghĩa vụ giới thiệu, chuyển người bệnh tại Luật 15/2023/QH15 Điều 60 khoản 10.",
"designation" : [
{
"language" : "en",
"value" : "Referral sent"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
}
]
},
{
"code" : "REF-ACCEPTED",
"display" : "Cơ sở nhận đồng ý tiếp nhận",
"definition" : "Cơ sở dự kiến tiếp nhận đã xác nhận đủ điều kiện chuyên môn và đồng ý nhận người bệnh; người bệnh chưa đến.",
"designation" : [
{
"language" : "en",
"value" : "Referral accepted"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
}
]
},
{
"code" : "REF-DECLINED",
"display" : "Cơ sở nhận từ chối tiếp nhận",
"definition" : "Cơ sở dự kiến tiếp nhận từ chối; lý do ghi ở Task.statusReason. Trường hợp cấp cứu không được từ chối theo Luật 15/2023/QH15 Điều 61.",
"designation" : [
{
"language" : "en",
"value" : "Referral declined"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
}
]
},
{
"code" : "REF-ARRIVED",
"display" : "Người bệnh đã đến cơ sở nhận",
"definition" : "Cơ sở tiếp nhận đã ghi nhận người bệnh đến và mở lượt khám chữa bệnh tương ứng.",
"designation" : [
{
"language" : "en",
"value" : "Patient arrived at receiving facility"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
}
]
},
{
"code" : "REF-COMPLETED",
"display" : "Đã hoàn thành KCB tại cơ sở nhận",
"definition" : "Cơ sở tiếp nhận đã kết thúc đợt khám chữa bệnh phát sinh từ yêu cầu chuyển.",
"designation" : [
{
"language" : "en",
"value" : "Care completed at receiving facility"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
}
]
},
{
"code" : "REF-RETURNED",
"display" : "Đã chuyển người bệnh trở lại cơ sở chuyển đi",
"definition" : "Người bệnh được chuyển về cơ sở ban đầu để tiếp tục theo dõi, điều trị.",
"designation" : [
{
"language" : "en",
"value" : "Patient referred back"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
}
]
},
{
"code" : "RX-PENDING",
"display" : "Chờ cấp phát",
"definition" : "Đơn đã phát hành, còn trong thời hạn lĩnh thuốc, chưa có lần cấp phát nào.",
"designation" : [
{
"language" : "en",
"value" : "Awaiting dispense"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
}
]
},
{
"code" : "RX-PARTIAL",
"display" : "Đã cấp phát một phần",
"definition" : "Một phần số thuốc trong đơn đã được cấp phát hoặc bán; phần còn lại vẫn chờ trong thời hạn lĩnh thuốc.",
"designation" : [
{
"language" : "en",
"value" : "Partially dispensed"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
}
]
},
{
"code" : "RX-DISPENSED",
"display" : "Đã cấp phát đủ",
"definition" : "Toàn bộ số thuốc trong đơn đã được cấp phát hoặc bán; công việc điều phối kết thúc.",
"designation" : [
{
"language" : "en",
"value" : "Fully dispensed"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
}
]
},
{
"code" : "RX-EXPIRED",
"display" : "Quá thời hạn lĩnh thuốc",
"definition" : "Đã quá 05 ngày kể từ ngày kê đơn mà người bệnh chưa lĩnh hết thuốc, theo TT 26/2025/TT-BYT Điều 12 khoản 9 điểm b. Cơ sở bán lẻ không được tiếp tục bán theo đơn này.",
"designation" : [
{
"language" : "en",
"value" : "Dispense window expired"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
}
]
},
{
"code" : "RX-CANCELLED",
"display" : "Đơn bị hủy trước khi cấp phát",
"definition" : "Người kê đơn hủy đơn trước khi thuốc được cấp phát; lý do ghi ở Task.statusReason.",
"designation" : [
{
"language" : "en",
"value" : "Prescription cancelled before dispense"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
}
]
}
]
}