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 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="vn-task-business-status-cs"/>
<language value="vi"/>
<text>
<status value="generated"/>
<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>
</text>
<extension
url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
<valueCoding>
<system
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
<code value="L-15-2023"/>
</valueCoding>
</extension>
<extension
url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
<valueCoding>
<system
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
<code value="TT-26-2025"/>
</valueCoding>
</extension>
<url
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-task-business-status-cs"/>
<identifier>
<system value="urn:ietf:rfc:3986"/>
<value
value="urn:oid:2.25.161089673617632664299011809196868855799.16.136"/>
</identifier>
<version value="0.9.0"/>
<name value="VNTaskBusinessStatusCS"/>
<title
value="Trạng thái nghiệp vụ công việc điều phối — VN Task Business Status CodeSystem"/>
<status value="draft"/>
<experimental value="false"/>
<date value="2026-07-27"/>
<publisher value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<contact>
<name value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<telecom>
<system value="url"/>
<value value="https://hl7.org.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="[email protected]"/>
</telecom>
</contact>
<contact>
<name value="Omi HealthTech (OmiGroup)"/>
<telecom>
<system value="url"/>
<value value="https://omihealthtech.vn"/>
</telecom>
<telecom>
<system value="url"/>
<value value="https://omigroup.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="[email protected]"/>
</telecom>
</contact>
<description
value="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. /
Business 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 value="urn:iso:std:iso:3166"/>
<code value="VN"/>
<display value="Viet Nam"/>
</coding>
</jurisdiction>
<copyright
value="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 value="true"/>
<content value="complete"/>
<count value="11"/>
<property>
<code value="codeSource"/>
<uri
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-task-business-status-cs#codeSource"/>
<description
value="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 value="code"/>
</property>
<concept>
<code value="REF-SENT"/>
<display value="Đã gửi yêu cầu chuyển"/>
<definition
value="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 value="en"/>
<value value="Referral sent"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
</concept>
<concept>
<code value="REF-ACCEPTED"/>
<display value="Cơ sở nhận đồng ý tiếp nhận"/>
<definition
value="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 value="en"/>
<value value="Referral accepted"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
</concept>
<concept>
<code value="REF-DECLINED"/>
<display value="Cơ sở nhận từ chối tiếp nhận"/>
<definition
value="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 value="en"/>
<value value="Referral declined"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
</concept>
<concept>
<code value="REF-ARRIVED"/>
<display value="Người bệnh đã đến cơ sở nhận"/>
<definition
value="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 value="en"/>
<value value="Patient arrived at receiving facility"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
</concept>
<concept>
<code value="REF-COMPLETED"/>
<display value="Đã hoàn thành KCB tại cơ sở nhận"/>
<definition
value="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 value="en"/>
<value value="Care completed at receiving facility"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
</concept>
<concept>
<code value="REF-RETURNED"/>
<display value="Đã chuyển người bệnh trở lại cơ sở chuyển đi"/>
<definition
value="Người bệnh được chuyển về cơ sở ban đầu để tiếp tục theo dõi, điều trị."/>
<designation>
<language value="en"/>
<value value="Patient referred back"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
</concept>
<concept>
<code value="RX-PENDING"/>
<display value="Chờ cấp phát"/>
<definition
value="Đơ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 value="en"/>
<value value="Awaiting dispense"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
</concept>
<concept>
<code value="RX-PARTIAL"/>
<display value="Đã cấp phát một phần"/>
<definition
value="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 value="en"/>
<value value="Partially dispensed"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
</concept>
<concept>
<code value="RX-DISPENSED"/>
<display value="Đã cấp phát đủ"/>
<definition
value="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 value="en"/>
<value value="Fully dispensed"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
</concept>
<concept>
<code value="RX-EXPIRED"/>
<display value="Quá thời hạn lĩnh thuốc"/>
<definition
value="Đã 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 value="en"/>
<value value="Dispense window expired"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
</concept>
<concept>
<code value="RX-CANCELLED"/>
<display value="Đơn bị hủy trước khi cấp phát"/>
<definition
value="Người kê đơn hủy đơn trước khi thuốc được cấp phát; lý do ghi ở Task.statusReason."/>
<designation>
<language value="en"/>
<value value="Prescription cancelled before dispense"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
</concept>
</CodeSystem>