System Integration — Value

Publish integration System values to topics derived from BMS metadata.

Direction: Publish (send)

Channel

BMS/v1/{integration}/Value/System/{pointType}/{tagPath}

Values published by integrations for Heartbeat points.

MQTT wildcard examples

All integration heartbeat values: BMS/v1/+/Value/System/#

Parameters

Parameter	Description
`integration`	Integration identifier.
`pointType`	Integration-published System point type. Values: `HeartbeatTimestampIntegration`, `HeartbeatEchoIntegration`
`tagPath`	Vendor-defined hierarchical tag path.

Message: Point Value

Content Type: application/json

Live value message. Payload envelope is identical for all point types. The semantic meaning of value is determined by the corresponding metadata message.

Payload

Name	Type	Required	Description
`value`	number or null	Yes	Live reading for the point (float). May be null when the BMS has no valid reading available.
`timestamp`	integer	Yes	Unix timestamp in epoch milliseconds (source event time).
`quality`	integer	Yes	`1` = good quality. Any other integer indicates value is not trustworthy

Example payload

1 {
2   "value": 22.96215,
3   "timestamp": 1743620423000,
4   "quality": 1
5 }

1	{
2	"value": 22.96215,
3	"timestamp": 1743620423000,
4	"quality": 1
5	}