Merge pull request #158 from medplum/rahul-hl7-bots

HL7 Lab Integration

package.json

@@ -14,10 +14,10 @@
   "author": "Medplum <hello@medplum.com>",
   "license": "Apache-2.0",
   "devDependencies": {
-    "@medplum/cli": "2.0.17",
-    "@medplum/core": "2.0.17",
-    "@medplum/fhirtypes": "2.0.17",
-    "@medplum/mock": "2.0.17",
+    "@medplum/cli": "2.0.19",
+    "@medplum/core": "2.0.19",
+    "@medplum/fhirtypes": "2.0.19",
+    "@medplum/mock": "2.0.19",
     "@types/node": "18.16.2",
     "@types/node-fetch": "^2.6.2",
     "@types/ssh2-sftp-client": "^9.0.0",

src/examples/lab-integration/README.md

@@ -0,0 +1,15 @@
+# Medplum HL7 Lab Integration Bots
+
+The bots in this directory demonstrate an example HL7v2 lab integration integration. These bots send and receive HL7 files through an SFTP server and can be automatically triggered by Medplum subscriptions.
+
+For our purposes, we'll be focusing on two specific types of messages, the ORM and the ORU.
+
+- **ORM (Order Message)**: These messages are used by healthcare providers to place an order for a lab test or procedure.
+
+- **ORU (Observation Result Message)**: These messages are used to transmit the results of a lab test or procedure from the performing lab back to the ordering provider.
+
+## Overview of Bots
+
+1. **send-orm-message.ts**: This bot demonstrates how to send an HL7 ORM message to a third-party lab using Medplum and SFTP. This can be triggered when a new `ServiceRequest` resource is created in Medplum.
+
+2. **read-oru-message.ts**: This bot demonstrates how to read results from an HL7 ORU message using Medplum and SFTP. This can be triggered to be [run on a timer](https://www.medplum.com/docs/bots/bot-cron-job) to poll for results periodically.