Fulfillment Webhooks

If Tenovi will be providing fulfillment services, after a Device has been requested, Tenovi will send a callback HTTPS POST request to a provided endpoint to indicate the device status (e.g. “Shipped” or “Connected”), tracking link, and the unique hardware_uuid for the physical device that was shipped to the patient.

Fulfillment Webhook Structure

The following data is included in each fulfillment webhook POST request:

Parameter	Description
hwi_device_id	The unique id returned when activating a HWI Device, which should be used to link shipping updates to a particular Patient or HWI Device in the Client’s software.
patient_id	The patient ID associated with this device, if it was provided when the device was requested (see Activating/Requesting Devices)
hardware_uuid	A unique identifier associated with the Tenovi Gateway. This is primarily useful for troubleshooting, or if a replacement Gateway is needed (Tenovi must be provided with the old ID so they can replace it with the new ID after a replacement unit is shipped out). Do NOT use this field to associate measurements with a patient, as it will change if a Gateway is replaced.
sensor_code	The sensor code of the device (see Activating/Requesting Devices for valid sensor codes)
device_name	The name of the Device that was shipped (i.e. “Tenovi Scale”, “Tenovi BPM”, “Tenovi Pulse Ox”, or “Tenovi Glucometer”). See our Device Overview page for a complete listing of avaiable device types.
status	The status of the device. Options are: “Pending Shipment" "Dropship Requested" "Shipped" "Dropshipped" "Delivered" "Returned" "Connected" "Replaced" "Unlinked”
tracking_link	The tracking link for this device, if it has been shipped

Example JSON Payload

{
    "hwi_device_id": "12345678-abcd-1234-abcd-1234567890ab",
    "patient_id": "12345678-1234-12345678",
    "hardware_uuid": "fed091a643ff",
    "sensor_code": "10"
    "device_name": "Tenovi BPM",
    "status ": "Shipped",
    "tracking_link": "https://ups.com/tracking-number"
}