Skip to main content

Device Management

Device Assignment​

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:

  1. Device Lookup: Use the device lookup endpoint to find specific devices.

    GET /api/v3/device/:deviceId
    curl https://app.impiloplatform.com/api/v3/device/1 \
        -H "Impilo-API-Key: <apiKey>" \
        -H "Content-Type: application/json"

  2. Patient or Site Lookup: Lookup the patient or site using their respective endpoints to ensure the device is associated correctly.

    GET /api/v3/patient/:patientId
    curl https://app.impiloplatform.com/api/v3/patient/1 \
        -H "Impilo-API-Key: <apiKey>" \
        -H "Content-Type: application/json"

  3. Device Association Request: Finally, issue a device association request to link the device with the chosen patient or site.

    PATCH /api/v3/device/associate-patient
    curl -X PATCH https://app.impiloplatform.com/api/v3/device/associate-patient \
        -H "Impilo-API-Key: <apiKey>" \
        -H "Content-Type: application/json" \
        -d '{
                "deviceId": 4527,
                "patientExternalIdentifier": "PAT-20240615-7890"
            }'