Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
This article pertains to:
Status
colourGreen
titleInform (v2)

...

Connecting a Smart Meter device via the Validic Marketplace is easy. Instead of the typical cloud account linking workflow, users simply enter their Smart Meter device’s unique IMEI number and they’re done.

...

This page details how the Direct Connection APIs work for Smart Meter. To learn more about the Inform integration to Smart Meter, please submit a request to your Validic Customer Success Executive or contact our support team at support@validic.com.

...

User Authorization for Smart Meter Cellular Devices

Table of Contents
minLevel2
maxLevel4
outlinefalse
typelist
printablefalse

Overview

End users cannot purchase Smart Meter cellular devices directly from Smart Meter. These devices must be acquired through a client who has signed a contract with Smart Meter. Validic Inform does not have access to the PHI necessary to ship devices, therefore Inform clients using Smart Meter cellular devices are responsible for acquiring the devices and distributing them to patients/users.

...

Let’s get into the individual steps.

Provision User in Validic Inform

Sample Request

Content-Type: application/x-www-form-urlencoded

...

    "updated_at": "2023-07-06T21:19:08Z"

}

Establish User Device Connection via Direct Connection API

Sample Request

Content-Type: application/json

...

   "device_type": "blood_glucose"

}

 

 

Sample Response202 Accepted

{
"credentials": {
"device_id": "123453782873223",
"device_type": "blood_glucose",
"device_name": null
},
"type": "smart_meter",
"created_at": "2023-10-01T15:53:41Z"
}

Note

When enabled, Smart Meter also appears in your Validic Inform Marketplace. If users connect via the marketplace, they will be routed to a screen to enter their 15-digit IMEI number manually, which will also connect them to Smart Meter.

If you want to prevent users from seeing Smart Meter as an option in the marketplace you’ll want to either avoid routing the user to the marketplace or hide the Smart Meter (smart_meter) source from your user user’s view using the Custom Marketplace.

Disconnect User

Disconnecting the user from Smart Meter can be done in two ways:

  1. Disconnect a single device IMEI from the user - this leaves any other Smart Meter device IMEIs connected to the user and only removes the IMEI indicated.

  2. Disconnect all device IMEIs from the user - this disconnects all Smart Meter device IMEIs from the user at once.

Disconnect a single device

Sample Request

POST https://syncmydevice.com/direct/auth/smart_meter/disconnect/:IMEI?token=:token

...

POST 'https://syncmydevice.com/direct/auth/smart_meter/disconnect/123453782873223?token=02f0c59b63310f7cec951aSAMPLEdd15481ec1dfd5f7e1f6927'

 

 

Sample Response202 Accepted

{
"credentials": {
"device_id": "123453782873223",
"device_type": "blood_glucose",
"device_name": null
},
"type": "smart_meter",
"created_at": "2023-10-01T15:53:41Z",
"deleted_at": "2023-10-10T17:47:15Z",
"deleted_reason": "User disconnected from Direct Endpoint"
}

Disconnect all devices

Sample Request

POST https://syncmydevice.com/direct/auth/smart_meter/disconnect_all?token=:token

...

POST 'https://syncmydevice.com/direct/auth/smart_meter/disconnect_all?token=02f0c59b63310f7cec951aSAMPLEdd15481ec1dfd5f7e1f6927'

 

 

Sample Response202 Accepted

{
"meta": {
"total": 2
},
"connections": [
{
"credentials": {
"device_id": "111111111111111",
"device_type": "blood_pressure",
"device_name": ""
},
"type": "smart_meter",
"created_at": "2023-10-01T15:46:15Z",
"deleted_at": "2023-10-10T17:49:21Z",
"deleted_reason": "User disconnected from Direct Endpoint"
},
{
"credentials": {
"device_id": "222222222222222",
"device_type": "weight_scale",
"device_name": ""
},
"type": "smart_meter",
"created_at": "2023-10-01T15:46:26Z",
"deleted_at": "2023-10-10T17:49:21Z",
"deleted_reason": "User disconnected from Direct Endpoint"
}
]
}

Smart Meter Data

The Smart Meter Inform integration has the source ‘type’: smart_meter

...