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.9.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.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Hồ sơ tài nguyên: Cuộc hẹn khám bệnh VN Core — VN Core Appointment Profile - Mô tả chi tiết

Draft tại thời điểm 2026-07-27

Các định nghĩa cho vn-core-appointment hồ sơ tài nguyên

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

0. Appointment
Definition

A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s).

ShortA booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s)
Control0..*
Is Modifierfalse
Summaryfalse
Invariantsapp-2: Either start and end are specified, or neither (start.exists() = end.exists())
app-3: Only proposed or cancelled appointments can be missing start/end dates ((start.exists() and end.exists()) or (status in ('proposed' | 'cancelled' | 'waitlist')))
app-4: Cancelation reason is only used for appointments that have been cancelled, or no-show (Appointment.cancelationReason.exists() implies (Appointment.status='no-show' or Appointment.status='cancelled'))
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource (contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty())
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated (contained.meta.versionId.empty() and contained.meta.lastUpdated.empty())
dom-5: If a resource is contained in another resource, it SHALL NOT have a security label (contained.meta.security.empty())
dom-6: A resource should have narrative for robust management (text.`div`.exists())
vn-appointment-patient-participant: Cuộc hẹn phải có một bên tham gia là người bệnh. Kiểm bằng participant.actor.type hoặc tiền tố tham chiếu Patient/ — hệ thống dùng tham chiếu tuyệt đối cần khai participant.actor.type để qua ràng buộc này. (participant.where(actor.type = 'Patient' or actor.reference.contains('Patient/')).exists())
vn-appointment-cancelation-reason: Cuộc hẹn bị hủy phải nêu lý do hủy: người bệnh và cơ sở cần phân biệt hủy do người bệnh, do cơ sở, hay do sự cố kỹ thuật của buổi khám từ xa. ((status = 'cancelled') implies cancelationReason.exists())
app-2: Either start and end are specified, or neither (start.exists() = end.exists())
app-3: Only proposed or cancelled appointments can be missing start/end dates ((start.exists() and end.exists()) or (status in ('proposed' | 'cancelled' | 'waitlist')))
app-4: Cancelation reason is only used for appointments that have been cancelled, or no-show (Appointment.cancelationReason.exists() implies (Appointment.status='no-show' or Appointment.status='cancelled'))
2. Appointment.implicitRules
Definition

A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.

ShortA set of rules under which this content was created
Comments

Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.

Control0..1
Typeuri
Is Modifiertrue because This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
4. Appointment.extension
Definition

An Extension


May be used to represent additional information that is not part of the basic definition of the resource. 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.

ShortExtensionAdditional 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 Appointment.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ url
  • 6. Appointment.extension:careDeliveryMode
    Slice NamecareDeliveryMode
    Definition

    Phương thức cung cấp dịch vụ của buổi hẹn. Để trống hiểu là khám trực tiếp tại cơ sở. Với buổi hẹn từ xa, đường dẫn phòng khám trực tuyến KHÔNG đặt ở đây và không đặt trong resource công bố công khai — xem ghi chú ở patientInstruction.

    ShortPhương thức: trực tiếp | tại nhà | từ xa | hỗ trợ từ xa
    Control0..1
    This element is affected by the following invariants: ele-1
    TypeExtension(Phương thức cung cấp dịch vụ KCB — Care Delivery Mode Extension) (Extension Type: CodeableConcept)
    Is Modifierfalse
    Must Supporttrue
    Summaryfalse
    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())
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    8. Appointment.modifierExtension
    Definition

    May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it 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 is allowed to 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
    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 resource that contains them
    Summaryfalse
    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
    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. Appointment.identifier
    Definition

    Mã để người bệnh tra cứu, đổi hoặc hủy lịch. Chưa có danh mục mã đặt lịch quốc gia nên hệ thống mã do từng cơ sở tự quản lý.


    This records identifiers associated with this appointment concern that are defined by business processes and/or used to refer to it when a direct URL reference to the resource itself is not appropriate (e.g. in CDA documents, or in written / printed documentation).

    ShortMã đặt lịch do cơ sở cấpExternal Ids for this item
    NoteThis is a business identifier, not a resource identifier (see discussion)
    Control0..*
    TypeIdentifier
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    12. Appointment.status
    Definition

    The overall status of the Appointment. Each of the participants has their own participation status which indicates their involvement in the process, however this status indicates the shared status.

    ShortTrạng thái: proposed | pending | booked | arrived | fulfilled | cancelled | noshow | entered-in-error | checked-in | waitlistproposed | pending | booked | arrived | fulfilled | cancelled | noshow | entered-in-error | checked-in | waitlist
    Comments

    If the Appointment's status is "cancelled" then all participants are expected to have their calendars released for the appointment period, and as such any Slots that were marked as BUSY can be re-set to FREE.

    This element is labeled as a modifier because the status contains the code entered-in-error that mark the Appointment as not currently valid.

    Control1..1
    BindingThe codes SHALL be taken from AppointmentStatushttp://hl7.org/fhir/ValueSet/appointmentstatus|4.0.1
    (required to http://hl7.org/fhir/ValueSet/appointmentstatus|4.0.1)

    The free/busy status of an appointment.

    Typecode
    Is Modifiertrue because This element is labelled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    14. Appointment.cancelationReason
    Definition

    The coded reason for the appointment being cancelled. This is often used in reporting/billing/futher processing to determine if further actions are required, or specific fees apply.

    ShortLý do hủy — bắt buộc khi status là cancelledThe coded reason for the appointment being cancelled
    Control0..1
    BindingFor example codes, see AppointmentCancellationReasonhttp://hl7.org/fhir/ValueSet/appointment-cancellation-reason|4.0.1
    (example to http://hl7.org/fhir/ValueSet/appointment-cancellation-reason|4.0.1)
    TypeCodeableConcept
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    16. Appointment.serviceCategory
    Definition

    A broad categorization of the service that is to be performed during this appointment.

    ShortNhóm dịch vụA broad categorization of the service that is to be performed during this appointment
    Control0..*
    BindingFor example codes, see ServiceCategoryhttp://hl7.org/fhir/ValueSet/service-category|4.0.1
    (example to http://hl7.org/fhir/ValueSet/service-category|4.0.1)
    TypeCodeableConcept
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    18. Appointment.serviceType
    Definition

    The specific service that is to be performed during this appointment.

    ShortLoại dịch vụ khám bệnh, chữa bệnhThe specific service that is to be performed during this appointment
    Comments

    For a provider to provider appointment the code "FOLLOWUP" may be appropriate, as this is expected to be discussing some patient that was seen in the past.

    Control0..*
    BindingUnless not suitable, these codes SHALL be taken from For example codes, see Loại dịch vụ y tế tuyến cơ sở — VN Healthcare Service Type ValueSethttp://hl7.org/fhir/ValueSet/service-type|4.0.1
    (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-healthcare-service-type-vs)
    TypeCodeableConcept
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    20. Appointment.specialty
    Definition

    The specialty of a practitioner that would be required to perform the service requested in this appointment.

    ShortChuyên khoaThe specialty of a practitioner that would be required to perform the service requested in this appointment
    Control0..*
    BindingUnless not suitable, these codes SHALL be taken from The codes SHOULD be taken from Chuyên khoa y tế — VN Medical Specialty ValueSethttp://hl7.org/fhir/ValueSet/c80-practice-codes|4.0.1
    (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-specialty-vs)
    TypeCodeableConcept
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    22. Appointment.appointmentType
    Definition

    The style of appointment or patient that has been booked in the slot (not service type).

    ShortLoại cuộc hẹn: khám lần đầu, tái khám, khám sức khỏe định kỳ, cấp cứuThe style of appointment or patient that has been booked in the slot (not service type)
    Control0..1
    BindingThe codes SHOULD be taken from Hl7VSAppointmentReasonCodes (3.0.0)http://terminology.hl7.org/ValueSet/v2-0276
    (preferred to http://terminology.hl7.org/ValueSet/v2-0276|3.0.0)
    TypeCodeableConcept
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    24. Appointment.reasonCode
    Definition

    The coded reason that this appointment is being scheduled. This is more clinical than administrative.

    ShortLý do khám (mã ICD-10 hoặc mô tả)Coded reason this appointment is scheduled
    Control0..*
    BindingUnless not suitable, these codes SHALL be taken from The codes SHOULD be taken from Mã chẩn đoán — VN Core Condition Code ValueSethttp://hl7.org/fhir/ValueSet/encounter-reason|4.0.1
    (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-condition-code-vs)
    TypeCodeableConcept
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    26. Appointment.reasonReference
    Definition

    Reason the appointment has been scheduled to take place, as specified using information from another resource. When the patient arrives and the encounter begins it may be used as the admission diagnosis. The indication will typically be a Condition (with other resources referenced in the evidence.detail), or a Procedure.

    ShortBệnh lý hoặc kết quả dẫn tới cuộc hẹnReason the appointment is to take place (resource)
    Control0..*
    TypeReference(Chẩn đoán VN Core — VN Core Condition Profile, Xét nghiệm VN Core — VN Core Observation Laboratory Profile, Thủ thuật/DVKT VN Core — VN Core Procedure Profile, Condition, Procedure, Observation, ImmunizationRecommendation)
    Is Modifierfalse
    Summaryfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    28. Appointment.priority
    Definition

    The priority of the appointment. Can be used to make informed decisions if needing to re-prioritize appointments. (The iCal Standard specifies 0 as undefined, 1 as highest, 9 as lowest priority).

    ShortMức ưu tiên (số càng nhỏ càng ưu tiên)Used to make informed decisions if needing to re-prioritize
    Comments

    Seeking implementer feedback on this property and how interoperable it is.

    Using an extension to record a CodeableConcept for named values may be tested at a future connectathon.

    Control0..1
    TypeunsignedInt
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summaryfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    30. Appointment.description
    Definition

    Mô tả để người bệnh nhận ra buổi hẹn. KHÔNG ghi chẩn đoán chi tiết hoặc thông tin sức khỏe nhạy cảm: nội dung này thường hiển thị trong thông báo nhắc lịch qua tin nhắn, ngoài môi trường kiểm soát truy cập của bệnh án.


    The brief description of the appointment as would be shown on a subject line in a meeting request, or appointment list. Detailed or expanded information should be put in the comment field.

    ShortMô tả ngắn về cuộc hẹnShown on a subject line in a meeting request, or appointment list
    Control0..1
    Typestring
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Must Supporttrue
    Summaryfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    32. Appointment.start
    Definition

    Date/Time that the appointment is to take place.

    ShortThời điểm bắt đầu dự kiếnWhen appointment is to take place
    Control0..1
    Typeinstant
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    34. Appointment.end
    Definition

    Date/Time that the appointment is to conclude.

    ShortThời điểm kết thúc dự kiếnWhen appointment is to conclude
    Control0..1
    Typeinstant
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    36. Appointment.minutesDuration
    Definition

    Number of minutes that the appointment is to take. This can be less than the duration between the start and end times. For example, where the actual time of appointment is only an estimate or if a 30 minute appointment is being requested, but any time would work. Also, if there is, for example, a planned 15 minute break in the middle of a long appointment, the duration may be 15 minutes less than the difference between the start and end.

    ShortThời lượng dự kiến (phút)Can be less than start/end (e.g. estimate)
    Control0..1
    TypepositiveInt
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summaryfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    38. Appointment.slot
    Definition

    The slots from the participants' schedules that will be filled by the appointment.

    ShortKhung giờ đã giữ cho cuộc hẹnThe slots that this appointment is filling
    Control0..*
    TypeReference(Khung giờ đặt lịch VN Core — VN Core Slot Profile, Slot)
    Is Modifierfalse
    Must Supporttrue
    Summaryfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    40. Appointment.created
    Definition

    The date that this appointment was initially created. This could be different to the meta.lastModified value on the initial entry, as this could have been before the resource was created on the FHIR server, and should remain unchanged over the lifespan of the appointment.

    ShortThời điểm lập bản ghi đặt lịchThe date that this appointment was initially created
    Comments

    This property is required for many use cases where the age of an appointment is considered in processing workflows for scheduling and billing of appointments.

    Control0..1
    TypedateTime
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Must Supporttrue
    Summaryfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    42. Appointment.comment
    Definition

    Additional comments about the appointment.

    ShortGhi chú nội bộ của cơ sởAdditional comments
    Comments

    Additional text to aid in facilitating the appointment. For instance, a comment might be, "patient should proceed immediately to infusion room upon arrival"

    Where this is a planned appointment and the start/end dates are not set then this field can be used to provide additional guidance on the details of the appointment request, including any restrictions on when to book it.

    Control0..1
    Typestring
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summaryfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    44. Appointment.patientInstruction
    Definition

    Hướng dẫn chuẩn bị (nhịn ăn, mang giấy chuyển tuyến, thẻ bảo hiểm y tế). Với buổi hẹn từ xa, đây là nơi ghi cách vào phòng khám trực tuyến; đường dẫn phải là liên kết dùng một lần hoặc có xác thực, không phải liên kết mở công khai.


    While Appointment.comment contains information for internal use, Appointment.patientInstructions is used to capture patient facing information about the Appointment (e.g. please bring your referral or fast from 8pm night before).

    ShortHướng dẫn cho người bệnh trước buổi hẹnDetailed information and instructions for the patient
    Control0..1
    Typestring
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Must Supporttrue
    Summaryfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    46. Appointment.basedOn
    Definition

    The service request this appointment is allocated to assess (e.g. incoming referral or procedure request).

    ShortYêu cầu dịch vụ hoặc giấy chuyển tuyến dẫn tới cuộc hẹnThe service request this appointment is allocated to assess
    Control0..*
    TypeReference(Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile, ServiceRequest)
    Is Modifierfalse
    Must Supporttrue
    Summaryfalse
    Alternate NamesincomingReferral
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    48. Appointment.participant
    Definition

    List of participants involved in the appointment.

    ShortParticipants involved in appointment
    Control1..*
    TypeBackboneElement
    Is Modifierfalse
    Must Supporttrue
    Summaryfalse
    Invariantsapp-1: Either the type or actor on the participant SHALL be specified (type.exists() or actor.exists())
    ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    app-1: Either the type or actor on the participant SHALL be specified (type.exists() or actor.exists())
    50. Appointment.participant.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())
    52. Appointment.participant.type
    Definition

    Role of participant in the appointment.

    ShortVai trò của bên tham giaRole of participant in the appointment
    Comments

    The role of the participant can be used to declare what the actor will be doing in the scope of this appointment.

    If the actor is not specified, then it is expected that the actor will be filled in at a later stage of planning.

    This value SHALL be the same when creating an AppointmentResponse so that they can be matched, and subsequently update the Appointment.

    Control0..*
    BindingUnless not suitable, these codes SHALL be taken from ParticipantTypehttp://hl7.org/fhir/ValueSet/encounter-participant-type|4.0.1
    (extensible to http://hl7.org/fhir/ValueSet/encounter-participant-type|4.0.1)

    Role of participant in encounter.

    TypeCodeableConcept
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    54. Appointment.participant.actor
    Definition

    A Person, Location/HealthcareService or Device that is participating in the appointment.

    ShortBên tham gia: người bệnh, người hành nghề, dịch vụ, địa điểmPerson, Location/HealthcareService or Device
    Control0..1
    TypeReference(Bệnh nhân VN Core — VN Core Patient Profile, Nhân viên y tế VN Core — VN Core Practitioner Profile, Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile, Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile, Dịch vụ y tế VN Core — VN Core HealthcareService Profile, Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile, Thiết bị y tế VN Core — VN Core Device Profile, Patient, Practitioner, PractitionerRole, RelatedPerson, Device, HealthcareService, Location)
    Is Modifierfalse
    Must Supporttrue
    Must Support TypesNo must-support rules about the choice of types/profiles
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    56. Appointment.participant.required
    Definition

    Whether this participant is required to be present at the meeting. This covers a use-case where two doctors need to meet to discuss the results for a specific patient, and the patient is not required to be present.

    Shortrequired | optional | information-only
    Control0..1
    BindingThe codes SHALL be taken from ParticipantRequiredhttp://hl7.org/fhir/ValueSet/participantrequired|4.0.1
    (required to http://hl7.org/fhir/ValueSet/participantrequired|4.0.1)

    Is the Participant required to attend the appointment.

    Typecode
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    58. Appointment.participant.status
    Definition

    Participation status of the actor.

    ShortTrạng thái xác nhận của bên tham gia: accepted | declined | tentative | needs-actionaccepted | declined | tentative | needs-action
    Control1..1
    BindingThe codes SHALL be taken from ParticipationStatushttp://hl7.org/fhir/ValueSet/participationstatus|4.0.1
    (required to http://hl7.org/fhir/ValueSet/participationstatus|4.0.1)

    The Participation status of an appointment.

    Typecode
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Must Supporttrue
    Summarytrue
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    60. Appointment.requestedPeriod
    Definition

    A set of date ranges (potentially including times) that the appointment is preferred to be scheduled within.

    The duration (usually in minutes) could also be provided to indicate the length of the appointment to fill and populate the start/end times for the actual allocated time. However, in other situations the duration may be calculated by the scheduling system.

    ShortKhoảng thời gian người bệnh mong muốn (khi chưa chốt giờ)Potential date/time interval(s) requested to allocate the appointment within
    Comments

    This does not introduce a capacity for recurring appointments.

    Control0..*
    TypePeriod
    Is Modifierfalse
    Summaryfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))

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

    0. Appointment
    Invariantsvn-appointment-patient-participant: Cuộc hẹn phải có một bên tham gia là người bệnh. Kiểm bằng participant.actor.type hoặc tiền tố tham chiếu Patient/ — hệ thống dùng tham chiếu tuyệt đối cần khai participant.actor.type để qua ràng buộc này. (participant.where(actor.type = 'Patient' or actor.reference.contains('Patient/')).exists())
    vn-appointment-cancelation-reason: Cuộc hẹn bị hủy phải nêu lý do hủy: người bệnh và cơ sở cần phân biệt hủy do người bệnh, do cơ sở, hay do sự cố kỹ thuật của buổi khám từ xa. ((status = 'cancelled') implies cancelationReason.exists())
    2. Appointment.extension
    SlicingThis element introduces a set of slices on Appointment.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • value @ url
    • 4. Appointment.extension:careDeliveryMode
      Slice NamecareDeliveryMode
      Definition

      Phương thức cung cấp dịch vụ của buổi hẹn. Để trống hiểu là khám trực tiếp tại cơ sở. Với buổi hẹn từ xa, đường dẫn phòng khám trực tuyến KHÔNG đặt ở đây và không đặt trong resource công bố công khai — xem ghi chú ở patientInstruction.

      ShortPhương thức: trực tiếp | tại nhà | từ xa | hỗ trợ từ xa
      Control0..1
      TypeExtension(Phương thức cung cấp dịch vụ KCB — Care Delivery Mode Extension) (Extension Type: CodeableConcept)
      Must Supporttrue
      6. Appointment.identifier
      Definition

      Mã để người bệnh tra cứu, đổi hoặc hủy lịch. Chưa có danh mục mã đặt lịch quốc gia nên hệ thống mã do từng cơ sở tự quản lý.

      ShortMã đặt lịch do cơ sở cấp
      NoteThis is a business identifier, not a resource identifier (see discussion)
      Must Supporttrue
      8. Appointment.status
      ShortTrạng thái: proposed | pending | booked | arrived | fulfilled | cancelled | noshow | entered-in-error | checked-in | waitlist
      Must Supporttrue
      10. Appointment.cancelationReason
      ShortLý do hủy — bắt buộc khi status là cancelled
      Must Supporttrue
      12. Appointment.serviceCategory
      ShortNhóm dịch vụ
      Must Supporttrue
      14. Appointment.serviceType
      ShortLoại dịch vụ khám bệnh, chữa bệnh
      BindingUnless not suitable, these codes SHALL be taken from Loại dịch vụ y tế tuyến cơ sở — VN Healthcare Service Type ValueSet
      (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-healthcare-service-type-vs)
      Must Supporttrue
      16. Appointment.specialty
      ShortChuyên khoa
      BindingUnless not suitable, these codes SHALL be taken from Chuyên khoa y tế — VN Medical Specialty ValueSet
      (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-specialty-vs)
      Must Supporttrue
      18. Appointment.appointmentType
      ShortLoại cuộc hẹn: khám lần đầu, tái khám, khám sức khỏe định kỳ, cấp cứu
      Must Supporttrue
      20. Appointment.reasonCode
      ShortLý do khám (mã ICD-10 hoặc mô tả)
      BindingUnless not suitable, these codes SHALL be taken from Mã chẩn đoán — VN Core Condition Code ValueSet
      (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-condition-code-vs)
      Must Supporttrue
      22. Appointment.reasonReference
      ShortBệnh lý hoặc kết quả dẫn tới cuộc hẹn
      TypeReference(Chẩn đoán VN Core — VN Core Condition Profile, Xét nghiệm VN Core — VN Core Observation Laboratory Profile, Thủ thuật/DVKT VN Core — VN Core Procedure Profile)
      24. Appointment.priority
      ShortMức ưu tiên (số càng nhỏ càng ưu tiên)
      26. Appointment.description
      Definition

      Mô tả để người bệnh nhận ra buổi hẹn. KHÔNG ghi chẩn đoán chi tiết hoặc thông tin sức khỏe nhạy cảm: nội dung này thường hiển thị trong thông báo nhắc lịch qua tin nhắn, ngoài môi trường kiểm soát truy cập của bệnh án.

      ShortMô tả ngắn về cuộc hẹn
      Must Supporttrue
      28. Appointment.start
      ShortThời điểm bắt đầu dự kiến
      Must Supporttrue
      30. Appointment.end
      ShortThời điểm kết thúc dự kiến
      Must Supporttrue
      32. Appointment.minutesDuration
      ShortThời lượng dự kiến (phút)
      34. Appointment.slot
      ShortKhung giờ đã giữ cho cuộc hẹn
      TypeReference(Khung giờ đặt lịch VN Core — VN Core Slot Profile)
      Must Supporttrue
      36. Appointment.created
      ShortThời điểm lập bản ghi đặt lịch
      Must Supporttrue
      38. Appointment.comment
      ShortGhi chú nội bộ của cơ sở
      40. Appointment.patientInstruction
      Definition

      Hướng dẫn chuẩn bị (nhịn ăn, mang giấy chuyển tuyến, thẻ bảo hiểm y tế). Với buổi hẹn từ xa, đây là nơi ghi cách vào phòng khám trực tuyến; đường dẫn phải là liên kết dùng một lần hoặc có xác thực, không phải liên kết mở công khai.

      ShortHướng dẫn cho người bệnh trước buổi hẹn
      Must Supporttrue
      42. Appointment.basedOn
      ShortYêu cầu dịch vụ hoặc giấy chuyển tuyến dẫn tới cuộc hẹn
      TypeReference(Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile)
      Must Supporttrue
      44. Appointment.participant
      Must Supporttrue
      46. Appointment.participant.type
      ShortVai trò của bên tham gia
      Must Supporttrue
      48. Appointment.participant.actor
      ShortBên tham gia: người bệnh, người hành nghề, dịch vụ, địa điểm
      TypeReference(Bệnh nhân VN Core — VN Core Patient Profile, Nhân viên y tế VN Core — VN Core Practitioner Profile, Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile, Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile, Dịch vụ y tế VN Core — VN Core HealthcareService Profile, Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile, Thiết bị y tế VN Core — VN Core Device Profile)
      Must Supporttrue
      Must Support TypesNo must-support rules about the choice of types/profiles
      50. Appointment.participant.required
      Must Supporttrue
      52. Appointment.participant.status
      ShortTrạng thái xác nhận của bên tham gia: accepted | declined | tentative | needs-action
      Must Supporttrue
      54. Appointment.requestedPeriod
      ShortKhoảng thời gian người bệnh mong muốn (khi chưa chốt giờ)

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

      0. Appointment
      Definition

      A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s).

      ShortA booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s)
      Control0..*
      Is Modifierfalse
      Summaryfalse
      Invariantsapp-2: Either start and end are specified, or neither (start.exists() = end.exists())
      app-3: Only proposed or cancelled appointments can be missing start/end dates ((start.exists() and end.exists()) or (status in ('proposed' | 'cancelled' | 'waitlist')))
      app-4: Cancelation reason is only used for appointments that have been cancelled, or no-show (Appointment.cancelationReason.exists() implies (Appointment.status='no-show' or Appointment.status='cancelled'))
      dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
      dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource (contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty())
      dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated (contained.meta.versionId.empty() and contained.meta.lastUpdated.empty())
      dom-5: If a resource is contained in another resource, it SHALL NOT have a security label (contained.meta.security.empty())
      dom-6: A resource should have narrative for robust management (text.`div`.exists())
      vn-appointment-patient-participant: Cuộc hẹn phải có một bên tham gia là người bệnh. Kiểm bằng participant.actor.type hoặc tiền tố tham chiếu Patient/ — hệ thống dùng tham chiếu tuyệt đối cần khai participant.actor.type để qua ràng buộc này. (participant.where(actor.type = 'Patient' or actor.reference.contains('Patient/')).exists())
      vn-appointment-cancelation-reason: Cuộc hẹn bị hủy phải nêu lý do hủy: người bệnh và cơ sở cần phân biệt hủy do người bệnh, do cơ sở, hay do sự cố kỹ thuật của buổi khám từ xa. ((status = 'cancelled') implies cancelationReason.exists())
      2. Appointment.id
      Definition

      The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.

      ShortLogical id of this artifact
      Comments

      The only time that a resource does not have an id is when it is being submitted to the server using a create operation.

      Control0..1
      Typeid
      Is Modifierfalse
      Summarytrue
      4. Appointment.meta
      Definition

      The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.

      ShortMetadata about the resource
      Control0..1
      TypeMeta
      Is Modifierfalse
      Summarytrue
      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      6. Appointment.implicitRules
      Definition

      A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.

      ShortA set of rules under which this content was created
      Comments

      Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.

      Control0..1
      Typeuri
      Is Modifiertrue because This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Summarytrue
      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      8. Appointment.language
      Definition

      The base language in which the resource is written.

      ShortLanguage of the resource content
      Comments

      Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).

      Control0..1
      BindingThe codes SHOULD be taken from CommonLanguages
      (preferred to http://hl7.org/fhir/ValueSet/languages|4.0.1)

      A human language.

      Additional BindingsPurpose
      AllLanguagesMax Binding
      Typecode
      Is Modifierfalse
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Summaryfalse
      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      10. Appointment.text
      Definition

      A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.

      ShortText summary of the resource, for human interpretation
      Comments

      Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.

      Control0..1
      TypeNarrative
      Is Modifierfalse
      Summaryfalse
      Alternate Namesnarrative, html, xhtml, display
      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      12. Appointment.contained
      Definition

      These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.

      ShortContained, inline Resources
      Comments

      This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.

      Control0..*
      TypeResource
      Is Modifierfalse
      Summaryfalse
      Alternate Namesinline resources, anonymous resources, contained resources
      14. Appointment.extension
      Definition

      An Extension

      ShortExtension
      Control0..*
      TypeExtension
      Is Modifierfalse
      Summaryfalse
      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 Appointment.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
      • value @ url
      • 16. Appointment.extension:careDeliveryMode
        Slice NamecareDeliveryMode
        Definition

        Phương thức cung cấp dịch vụ của buổi hẹn. Để trống hiểu là khám trực tiếp tại cơ sở. Với buổi hẹn từ xa, đường dẫn phòng khám trực tuyến KHÔNG đặt ở đây và không đặt trong resource công bố công khai — xem ghi chú ở patientInstruction.

        ShortPhương thức: trực tiếp | tại nhà | từ xa | hỗ trợ từ xa
        Control0..1
        This element is affected by the following invariants: ele-1
        TypeExtension(Phương thức cung cấp dịch vụ KCB — Care Delivery Mode Extension) (Extension Type: CodeableConcept)
        Is Modifierfalse
        Must Supporttrue
        Summaryfalse
        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())
        18. Appointment.modifierExtension
        Definition

        May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it 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 is allowed to 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
        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 resource that contains them
        Summaryfalse
        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
        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())
        20. Appointment.identifier
        Definition

        Mã để người bệnh tra cứu, đổi hoặc hủy lịch. Chưa có danh mục mã đặt lịch quốc gia nên hệ thống mã do từng cơ sở tự quản lý.

        ShortMã đặt lịch do cơ sở cấp
        NoteThis is a business identifier, not a resource identifier (see discussion)
        Control0..*
        TypeIdentifier
        Is Modifierfalse
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        22. Appointment.status
        Definition

        The overall status of the Appointment. Each of the participants has their own participation status which indicates their involvement in the process, however this status indicates the shared status.

        ShortTrạng thái: proposed | pending | booked | arrived | fulfilled | cancelled | noshow | entered-in-error | checked-in | waitlist
        Comments

        If the Appointment's status is "cancelled" then all participants are expected to have their calendars released for the appointment period, and as such any Slots that were marked as BUSY can be re-set to FREE.

        This element is labeled as a modifier because the status contains the code entered-in-error that mark the Appointment as not currently valid.

        Control1..1
        BindingThe codes SHALL be taken from AppointmentStatus
        (required to http://hl7.org/fhir/ValueSet/appointmentstatus|4.0.1)

        The free/busy status of an appointment.

        Typecode
        Is Modifiertrue because This element is labelled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        24. Appointment.cancelationReason
        Definition

        The coded reason for the appointment being cancelled. This is often used in reporting/billing/futher processing to determine if further actions are required, or specific fees apply.

        ShortLý do hủy — bắt buộc khi status là cancelled
        Control0..1
        BindingFor example codes, see AppointmentCancellationReason
        (example to http://hl7.org/fhir/ValueSet/appointment-cancellation-reason|4.0.1)
        TypeCodeableConcept
        Is Modifierfalse
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        26. Appointment.serviceCategory
        Definition

        A broad categorization of the service that is to be performed during this appointment.

        ShortNhóm dịch vụ
        Control0..*
        BindingFor example codes, see ServiceCategory
        (example to http://hl7.org/fhir/ValueSet/service-category|4.0.1)
        TypeCodeableConcept
        Is Modifierfalse
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        28. Appointment.serviceType
        Definition

        The specific service that is to be performed during this appointment.

        ShortLoại dịch vụ khám bệnh, chữa bệnh
        Comments

        For a provider to provider appointment the code "FOLLOWUP" may be appropriate, as this is expected to be discussing some patient that was seen in the past.

        Control0..*
        BindingUnless not suitable, these codes SHALL be taken from Loại dịch vụ y tế tuyến cơ sở — VN Healthcare Service Type ValueSet
        (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-healthcare-service-type-vs)
        TypeCodeableConcept
        Is Modifierfalse
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        30. Appointment.specialty
        Definition

        The specialty of a practitioner that would be required to perform the service requested in this appointment.

        ShortChuyên khoa
        Control0..*
        BindingUnless not suitable, these codes SHALL be taken from Chuyên khoa y tế — VN Medical Specialty ValueSet
        (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-specialty-vs)
        TypeCodeableConcept
        Is Modifierfalse
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        32. Appointment.appointmentType
        Definition

        The style of appointment or patient that has been booked in the slot (not service type).

        ShortLoại cuộc hẹn: khám lần đầu, tái khám, khám sức khỏe định kỳ, cấp cứu
        Control0..1
        BindingThe codes SHOULD be taken from Hl7VSAppointmentReasonCodes (3.0.0)
        (preferred to http://terminology.hl7.org/ValueSet/v2-0276|3.0.0)
        TypeCodeableConcept
        Is Modifierfalse
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        34. Appointment.reasonCode
        Definition

        The coded reason that this appointment is being scheduled. This is more clinical than administrative.

        ShortLý do khám (mã ICD-10 hoặc mô tả)
        Control0..*
        BindingUnless not suitable, these codes SHALL be taken from Mã chẩn đoán — VN Core Condition Code ValueSet
        (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-condition-code-vs)
        TypeCodeableConcept
        Is Modifierfalse
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        36. Appointment.reasonReference
        Definition

        Reason the appointment has been scheduled to take place, as specified using information from another resource. When the patient arrives and the encounter begins it may be used as the admission diagnosis. The indication will typically be a Condition (with other resources referenced in the evidence.detail), or a Procedure.

        ShortBệnh lý hoặc kết quả dẫn tới cuộc hẹn
        Control0..*
        TypeReference(Chẩn đoán VN Core — VN Core Condition Profile, Xét nghiệm VN Core — VN Core Observation Laboratory Profile, Thủ thuật/DVKT VN Core — VN Core Procedure Profile)
        Is Modifierfalse
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        38. Appointment.priority
        Definition

        The priority of the appointment. Can be used to make informed decisions if needing to re-prioritize appointments. (The iCal Standard specifies 0 as undefined, 1 as highest, 9 as lowest priority).

        ShortMức ưu tiên (số càng nhỏ càng ưu tiên)
        Comments

        Seeking implementer feedback on this property and how interoperable it is.

        Using an extension to record a CodeableConcept for named values may be tested at a future connectathon.

        Control0..1
        TypeunsignedInt
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        40. Appointment.description
        Definition

        Mô tả để người bệnh nhận ra buổi hẹn. KHÔNG ghi chẩn đoán chi tiết hoặc thông tin sức khỏe nhạy cảm: nội dung này thường hiển thị trong thông báo nhắc lịch qua tin nhắn, ngoài môi trường kiểm soát truy cập của bệnh án.

        ShortMô tả ngắn về cuộc hẹn
        Control0..1
        Typestring
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Must Supporttrue
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        42. Appointment.supportingInformation
        Definition

        Additional information to support the appointment provided when making the appointment.

        ShortAdditional information to support the appointment
        Control0..*
        TypeReference(Resource)
        Is Modifierfalse
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        44. Appointment.start
        Definition

        Date/Time that the appointment is to take place.

        ShortThời điểm bắt đầu dự kiến
        Control0..1
        Typeinstant
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        46. Appointment.end
        Definition

        Date/Time that the appointment is to conclude.

        ShortThời điểm kết thúc dự kiến
        Control0..1
        Typeinstant
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        48. Appointment.minutesDuration
        Definition

        Number of minutes that the appointment is to take. This can be less than the duration between the start and end times. For example, where the actual time of appointment is only an estimate or if a 30 minute appointment is being requested, but any time would work. Also, if there is, for example, a planned 15 minute break in the middle of a long appointment, the duration may be 15 minutes less than the difference between the start and end.

        ShortThời lượng dự kiến (phút)
        Control0..1
        TypepositiveInt
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        50. Appointment.slot
        Definition

        The slots from the participants' schedules that will be filled by the appointment.

        ShortKhung giờ đã giữ cho cuộc hẹn
        Control0..*
        TypeReference(Khung giờ đặt lịch VN Core — VN Core Slot Profile)
        Is Modifierfalse
        Must Supporttrue
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        52. Appointment.created
        Definition

        The date that this appointment was initially created. This could be different to the meta.lastModified value on the initial entry, as this could have been before the resource was created on the FHIR server, and should remain unchanged over the lifespan of the appointment.

        ShortThời điểm lập bản ghi đặt lịch
        Comments

        This property is required for many use cases where the age of an appointment is considered in processing workflows for scheduling and billing of appointments.

        Control0..1
        TypedateTime
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Must Supporttrue
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        54. Appointment.comment
        Definition

        Additional comments about the appointment.

        ShortGhi chú nội bộ của cơ sở
        Comments

        Additional text to aid in facilitating the appointment. For instance, a comment might be, "patient should proceed immediately to infusion room upon arrival"

        Where this is a planned appointment and the start/end dates are not set then this field can be used to provide additional guidance on the details of the appointment request, including any restrictions on when to book it.

        Control0..1
        Typestring
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        56. Appointment.patientInstruction
        Definition

        Hướng dẫn chuẩn bị (nhịn ăn, mang giấy chuyển tuyến, thẻ bảo hiểm y tế). Với buổi hẹn từ xa, đây là nơi ghi cách vào phòng khám trực tuyến; đường dẫn phải là liên kết dùng một lần hoặc có xác thực, không phải liên kết mở công khai.

        ShortHướng dẫn cho người bệnh trước buổi hẹn
        Control0..1
        Typestring
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Must Supporttrue
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        58. Appointment.basedOn
        Definition

        The service request this appointment is allocated to assess (e.g. incoming referral or procedure request).

        ShortYêu cầu dịch vụ hoặc giấy chuyển tuyến dẫn tới cuộc hẹn
        Control0..*
        TypeReference(Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile)
        Is Modifierfalse
        Must Supporttrue
        Summaryfalse
        Alternate NamesincomingReferral
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        60. Appointment.participant
        Definition

        List of participants involved in the appointment.

        ShortParticipants involved in appointment
        Control1..*
        TypeBackboneElement
        Is Modifierfalse
        Must Supporttrue
        Summaryfalse
        Invariantsapp-1: Either the type or actor on the participant SHALL be specified (type.exists() or actor.exists())
        ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        62. Appointment.participant.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
        64. Appointment.participant.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())
        66. Appointment.participant.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())
        68. Appointment.participant.type
        Definition

        Role of participant in the appointment.

        ShortVai trò của bên tham gia
        Comments

        The role of the participant can be used to declare what the actor will be doing in the scope of this appointment.

        If the actor is not specified, then it is expected that the actor will be filled in at a later stage of planning.

        This value SHALL be the same when creating an AppointmentResponse so that they can be matched, and subsequently update the Appointment.

        Control0..*
        BindingUnless not suitable, these codes SHALL be taken from ParticipantType
        (extensible to http://hl7.org/fhir/ValueSet/encounter-participant-type|4.0.1)

        Role of participant in encounter.

        TypeCodeableConcept
        Is Modifierfalse
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        70. Appointment.participant.actor
        Definition

        A Person, Location/HealthcareService or Device that is participating in the appointment.

        ShortBên tham gia: người bệnh, người hành nghề, dịch vụ, địa điểm
        Control0..1
        TypeReference(Bệnh nhân VN Core — VN Core Patient Profile, Nhân viên y tế VN Core — VN Core Practitioner Profile, Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile, Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile, Dịch vụ y tế VN Core — VN Core HealthcareService Profile, Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile, Thiết bị y tế VN Core — VN Core Device Profile)
        Is Modifierfalse
        Must Supporttrue
        Must Support TypesNo must-support rules about the choice of types/profiles
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        72. Appointment.participant.required
        Definition

        Whether this participant is required to be present at the meeting. This covers a use-case where two doctors need to meet to discuss the results for a specific patient, and the patient is not required to be present.

        Shortrequired | optional | information-only
        Control0..1
        BindingThe codes SHALL be taken from ParticipantRequired
        (required to http://hl7.org/fhir/ValueSet/participantrequired|4.0.1)

        Is the Participant required to attend the appointment.

        Typecode
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        74. Appointment.participant.status
        Definition

        Participation status of the actor.

        ShortTrạng thái xác nhận của bên tham gia: accepted | declined | tentative | needs-action
        Control1..1
        BindingThe codes SHALL be taken from ParticipationStatus
        (required to http://hl7.org/fhir/ValueSet/participationstatus|4.0.1)

        The Participation status of an appointment.

        Typecode
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Must Supporttrue
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        76. Appointment.participant.period
        Definition

        Participation period of the actor.

        ShortParticipation period of the actor
        Control0..1
        TypePeriod
        Is Modifierfalse
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        78. Appointment.requestedPeriod
        Definition

        A set of date ranges (potentially including times) that the appointment is preferred to be scheduled within.

        The duration (usually in minutes) could also be provided to indicate the length of the appointment to fill and populate the start/end times for the actual allocated time. However, in other situations the duration may be calculated by the scheduling system.

        ShortKhoảng thời gian người bệnh mong muốn (khi chưa chốt giờ)
        Comments

        This does not introduce a capacity for recurring appointments.

        Control0..*
        TypePeriod
        Is Modifierfalse
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))