Order scan integration

Introduction

The automatic prescription scan offered by POSOS can be accessed either:

• In the form of a call to an application offering a complete import and validation interface to the prescription (Scan & Go)
• In the form of an API call

How does it work?

Integration relies on a succession of HTTP calls made from a web browser.

The transcription result is then sent to your software via a specific flow (FHIR, PN13 or dedicated API) explained in prescription-import documentation.

Context call URLs

The basic url is https://api.{env}.posos.co where {env} is the following environment: preprod for validation, production for live.

https://partner-connect.preprod.posos.co

Good to know: The service account private key is different for each environment. We’ll send you the production key once testing is complete.

Getting an identity token

See Identity token authentication

Detailed operation

This API retrieves a URL to the Scan & Go interface. See Scan & Go API documentation to understand the parameters to be sent.

Example call

POST https://partner-connect.preprod.posos.co/api/partners/patient/scan-token
Authorization: Bearer <token>
Content-type: application/json
 
{
	"first_name": "John",
	"last_name": "Carter",
	"rpps": "abcde1234",
	"facilitySlug": "hopital-demo",
	"patientId": "123456"
}

Scan & Go application

Prerequisites

The URL opens a web application based on a NextJS / ReactJS technical stack. It requires the use of a browser or a recent webview. Compatible versions are :

• Chrome 64+
• Edge 79+ version
• Firefox 67+ version
• Opera 51+
• Safari 12+

Application experience

Import screen

This screen shows the options for sending the document to be transcribed.

• By QR Code + Application: the user opens Posos application on their smartphone, presses “scan a prescription” then is prompted to scan the QR Code and then their prescription.
• Drag-and-drop file upload:** to send files stored locally on the workstation.
• Webcam photography:** to use the workstation’s webcam to photograph a document.

Validation screen

On this screen, the user is invited to check each prescription line and specify the specialty and presentation, if applicable. They can also update structured dosages, and add or remove drugs.

Send to DPI screen

Clicking on “Import to DPI” will trigger the sending process to your software.

Notification of import completion

Your software will be notified of the end of the prescription import in one of two ways. Depending on how you’ve integrated the application, you can choose either of the following methods:

Good to know: this notification allows you to update your user interface, while waiting for the prescription data stream (via FHIR call or push, depending on the integration mode you’ve chosen).

iframe or popup

Browsers allow communication between different iframes or popups via the window.postMessage API. Your software must listen to the messages sent by Posos application and react accordingly. Here’s the format of the messages sent:

Here’s an example code:

const callback = function (event) {
  const origin = event.origin || event.originalEvent.origin;
  if (origin !== "https://scan-complete.preprod.posos.co") {
    return;
  }
  if (event.data?.status) {
    if (event.data.status === "success") {
      // Import successful
      // event.data.prescription is the prescription
    } else {
      // Import failed
      // event.data.prescription is not defined
    }
  }
};
 
// Compatibility with IE8 / IE9 + other browsers
const eventFunction = window.addEventListener ? "addEventListener" : "attachEvent";
const listener = window[eventFunction];
const eventName = eventFunction == "attachEvent" ? "onmessage" : "message";
 
 
listener(eventName, callback)

Change page URL method

This method modifies the page URL. #success or #error depending on the import result.