From 124624ad0c3229a07a6f71121bd3bca610cfdb1f Mon Sep 17 00:00:00 2001 From: Lloyd McKenzie Date: Mon, 26 Jun 2023 15:39:32 -0600 Subject: [PATCH 1/4] Updated to allow use on order revision --- docs/hooks/order-sign.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/hooks/order-sign.md b/docs/hooks/order-sign.md index f0d7852e..07839fa8 100644 --- a/docs/hooks/order-sign.md +++ b/docs/hooks/order-sign.md @@ -14,6 +14,11 @@ The context contains all order details, such as dose, quantity, route, etc, although the order has not yet been signed and therefore still exists in a draft status. Use this hook when your service requires all order details, and the clinician will accept recommended changes. +This hook can also be used when an order or set of orders is being 're-signed' after revision (e.g. change +to status, extending dates, or other changes allowed to signed orders within the system's workflow). In this +case, the orders would typically have a status other than 'draft'. In some cases, the hook might fire with a +mixture of new and revised orderes. + This hook is intended to replace (deprecate) the `medication-prescribe` and `order-review` hooks. ## Context @@ -23,7 +28,7 @@ Field | Optionality | Prefetch Token | Type | Description `userId` | REQUIRED | Yes | *string* | The id of the current user.
For this hook, the user is expected to be of type [Practitioner](https://www.hl7.org/fhir/practitioner.html) or [PractitionerRole](https://www.hl7.org/fhir/practitionerrole.html).
For example, `PractitionerRole/123` or `Practitioner/abc`. `patientId` | REQUIRED | Yes | *string* | The FHIR `Patient.id` of the current patient in context `encounterId` | OPTIONAL | Yes | *string* | The FHIR `Encounter.id` of the current encounter in context -`draftOrders` | REQUIRED | No | *object* | DSTU2 - FHIR Bundle of MedicationOrder, DiagnosticOrder, DeviceUseRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription with _draft_ status
STU3 - FHIR Bundle of MedicationRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription with _draft_ status
R4 - FHIR Bundle of DeviceRequest, MedicationRequest, NutritionOrder, ServiceRequest, VisionPrescription with _draft_ status +`draftOrders` | REQUIRED | No | *object* | DSTU2 - FHIR Bundle of MedicationOrder, DiagnosticOrder, DeviceUseRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription with _draft_ status
STU3 - FHIR Bundle of MedicationRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription with _draft_ status
R4 - FHIR Bundle of DeviceRequest, MedicationRequest, NutritionOrder, ServiceRequest, VisionPrescription (typically with _draft_ status) @@ -543,3 +548,4 @@ Version | Description ---- | ---- 1.0 | Initial Release 1.0.1 | Add DeviceRequest to list of order resources for R4. +1.1.0 | Updated hook to all for use in order-revision situations \ No newline at end of file From ed37f2b06128009200a68020eee084713f060e4f Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 12 Jul 2023 10:59:55 +0200 Subject: [PATCH 2/4] Fix ToC order in governenance Commiters is above PMC --- GOVERNANCE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/GOVERNANCE.md b/GOVERNANCE.md index 0c2e1632..76fcc374 100644 --- a/GOVERNANCE.md +++ b/GOVERNANCE.md @@ -2,8 +2,8 @@ - [Overview](#overview) - [Roles](#roles) - - [Project Management Committee](#project-management-committee) - [Committers](#committers) + - [Project Management Committee](#project-management-committee) - [PMC Chair](#pmc-chair) - [Contributors](#contributors) - [Implementers](#implementers) From a890e71e7f7cf3f7162da1c5e4df0ab2fe97cbf8 Mon Sep 17 00:00:00 2001 From: Isaac Vetter Date: Wed, 12 Jul 2023 11:33:44 -0500 Subject: [PATCH 3/4] fix mispelling --- docs/hooks/order-sign.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hooks/order-sign.md b/docs/hooks/order-sign.md index 07839fa8..0848bfbe 100644 --- a/docs/hooks/order-sign.md +++ b/docs/hooks/order-sign.md @@ -17,7 +17,7 @@ Use this hook when your service requires all order details, and the clinician wi This hook can also be used when an order or set of orders is being 're-signed' after revision (e.g. change to status, extending dates, or other changes allowed to signed orders within the system's workflow). In this case, the orders would typically have a status other than 'draft'. In some cases, the hook might fire with a -mixture of new and revised orderes. +mixture of new and revised orders. This hook is intended to replace (deprecate) the `medication-prescribe` and `order-review` hooks. From 2b90d716f798bf50c7bf9f14215ae52b1ec7c75c Mon Sep 17 00:00:00 2001 From: Isaac Vetter Date: Wed, 19 Jul 2023 12:27:31 -0500 Subject: [PATCH 4/4] same to DSTU2, STU3 don't introduce different workflow capabilities per FHIR version --- docs/hooks/order-sign.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hooks/order-sign.md b/docs/hooks/order-sign.md index 0848bfbe..54a3e116 100644 --- a/docs/hooks/order-sign.md +++ b/docs/hooks/order-sign.md @@ -28,7 +28,7 @@ Field | Optionality | Prefetch Token | Type | Description `userId` | REQUIRED | Yes | *string* | The id of the current user.
For this hook, the user is expected to be of type [Practitioner](https://www.hl7.org/fhir/practitioner.html) or [PractitionerRole](https://www.hl7.org/fhir/practitionerrole.html).
For example, `PractitionerRole/123` or `Practitioner/abc`. `patientId` | REQUIRED | Yes | *string* | The FHIR `Patient.id` of the current patient in context `encounterId` | OPTIONAL | Yes | *string* | The FHIR `Encounter.id` of the current encounter in context -`draftOrders` | REQUIRED | No | *object* | DSTU2 - FHIR Bundle of MedicationOrder, DiagnosticOrder, DeviceUseRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription with _draft_ status
STU3 - FHIR Bundle of MedicationRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription with _draft_ status
R4 - FHIR Bundle of DeviceRequest, MedicationRequest, NutritionOrder, ServiceRequest, VisionPrescription (typically with _draft_ status) +`draftOrders` | REQUIRED | No | *object* | DSTU2 - FHIR Bundle of MedicationOrder, DiagnosticOrder, DeviceUseRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription (typically with _draft_ status)
STU3 - FHIR Bundle of MedicationRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription (typically with _draft_ status)
R4 - FHIR Bundle of DeviceRequest, MedicationRequest, NutritionOrder, ServiceRequest, VisionPrescription (typically with _draft_ status)