Device Management Guide
Device Assignment and Status Updates
When an order is processed, devices are typically assigned either to a patient or a site. This assignment triggers a status update for the order, which can be observed through the Impilo webhook workflows. For more information see the Webhook management guide and the order.Status event type.
Manual Device Assignment
Apart from automatic assignments through order processing, devices can also be manually assigned to patients. This is done using the Associate Device endpoint. Note that in order to associate a device with a patient, all of the following must apply:
- The Patient must be associated with the Customer making the request
- The Device must be owned by the Customer making the request
- The Device must be associated with a non-Impilo site
- The Device must have a current status of
availableAtSite
Device Management Scenarios
Multiple Devices: There is no separate process required for ordering or assigning additional devices to a patient. Impilo’s system supports associating multiple devices with a single patient profile seamlessly.
Device Disassociation: It’s always possible to disassociate a device from a patient, allowing for flexible management depending on the use case requirements.
Device Replacement: In cases where a device is defective, Impilo facilitates a smooth replacement process. The defective device is returned to an Impilo warehouse, and a new device is simultaneously dispatched to ensure minimal disruption in patient care.
Device Association Workflow
Here’s a walkthrough of the typical device association steps in the Impilo system:
- Device Lookup: Use the device lookup endpoint to find specific devices.
- Patient or Site Lookup: Lookup the patient or site using their respective endpoints to ensure the device is associated correctly.
- Device Association Request: Finally, issue a device association request to link the device with the chosen patient or site.
Updating Device Details
To update a device, the following endpoint is utilized:
A DeviceUpdate object is used to specify the changes. This object includes an override status and an optional note. Below is an example of how to format the request body to update a device’s status and include a note about the update.
For example, to block a device from submitting readings to the Impilo platform, a decommissioned
status could be set on a specific device.
Device Status Update Workflow
Fetch a Device by ID
Send a request to the Device endpoint:
Truncated response:
Send a Device Update Request
Send a device update request to change the status of the device:
Fetch the Updated Device by ID
Send another request to the Device endpoint and observe the change:
Truncated response: