status.comunit.power

This payload reports the power availability and charging conditions of the asset’s communication unit (CoM Unit). It includes details about the internal battery pack and any external power sources supplying the device.

Payload JSON

With external power information

{
   "eventSubscriptionId":"517db07f-6e95-475e-8cc0-a371f9deed2b",
   "eventType":"status.comunit.power",
   "eventVersion":1,
   "eventId":"c37f8ac9-8206-4f95-afd1-74e442d09c07",
   "assetId":"2412ba2f-4499-4933-a9ce-69f6a38f44ee",
   "unitId":"traxee:358014094033866",
   "registeredOn":"2019-08-24T14:15:22Z",
   "eventData":{
      "batteryPack":{
         "available":true,
         "level":"high",
         "notChargingReason":"noPower",
         "state":"notCharging"
      },
      "externalPower":{
         "available":true,
         "fromReefer":{
            "available":true,
            "suppliedVoltage":12000
         },
         "fromTbs":{
            "available":true,
            "suppliedVoltage":12000
         }
      }
   }
}

Without external power information

{
   "eventSubscriptionId":"517db07f-6e95-475e-8cc0-a371f9deed2b",
   "eventType":"status.comunit.power",
   "eventVersion":1,
   "eventId":"c37f8ac9-8206-4f95-afd1-74e442d09c07",
   "assetId":"2412ba2f-4499-4933-a9ce-69f6a38f44ee",
   "unitId":"traxee:358014094033866",
   "registeredOn":"2019-08-24T14:15:22Z",
   "eventData":{
      "batteryPack":{
         "available":true,
         "level":"high",
         "notChargingReason":"noPower",
         "state":"notCharging",
         "suppliedVoltage":12000
      },
      "externalPower":{
         "available":true
      }
   }
}

Field level Description

FieldTypeOptional/RequiredDescription
eventSubscriptionIdString (UUID)RequiredA unique identifier representing the subscription through which this event was delivered. It ensures traceability between the event and the organization's registered RMS subscription.
eventTypeStringRequiredSpecifies the class of event being published. status.comunit.power indicates that the payload contains the communication unit's power and charging status details.
eventVersionNumberRequiredeventVersion indicates the schema version of the event, allowing producers and consumers to interpret the event consistently as the schema evolves.
eventIdString (UUID)RequiredA globally unique identifier assigned to this specific event instance. Useful for event deduplication, tracking, and audit logging.
assetIdString (UUID)RequiredIdentifies the physical asset (e.g., vehicle, trailer, equipment) associated with this event. Used to correlate telemetry with a specific asset in fleet management systems.
unitIdStringRequiredA unique identifier of the telematics device generating the event. It often includes a namespace (e.g., traxee:) followed by the device's serial or IMEI-like identifier.
registeredOnDateTime (ISO 8601 timestamp, UTC)RequiredThe timestamp representing when the event was detected and recorded by the device.
eventDataObjectRequiredThe eventData section contains all power-related telemetry values and charging conditions.
batteryPackObjectRequiredContains information about the internal battery pack of the communication unit.
batteryPack.availableBooleanRequiredIndicates whether the internal battery pack is installed and detectable by the communication unit.
true — Battery pack is present.
false — No battery pack detected.
batteryPack.levelStringOptionalRepresents the battery's charge level category. Allowed values are
high, medium, low, depending on the system's defined thresholds.
batteryPack.notChargingReasonStringRequired (if state is notCharging)Provides the reason why the battery is not charging. Example:
noPower, temperatureIssue, error — No external power source is available to charge the battery.
batteryPack.stateStringRequired (if available is true)Indicates the current operational charging state of the internal battery. Example:
notCharging — The unit is not charging the battery at the time of measurement.
charging — The unit is charging the battery at the time of measurement.
fullyCharged — The unit battery is fully charged.
externalPowerObjectOptionalThis section describes external power sources connected to the communication unit.
externalPower.availableBooleanRequiredIndicates whether any external power source is connected and detectable.
true — At least one external source is providing power.
false — No external power detected.
externalPower.fromReeferObjectRequiredRepresents external power supplied by the refrigeration unit (reefer), if available.
fromReefer.availableBooleanRequiredIndicates whether the reefer is currently providing power.
fromReefer.suppliedVoltageNumber (millivolts)OptionalVoltage supplied to the communication unit by the reefer system. Example: 12000 = 12V.
externalPower.fromTbsObjectRequiredRepresents external power supplied by the Trailer Braking System (TBS).
fromTbs.availableBooleanRequiredIndicates whether the TBS system is actively providing power.
fromTbs.suppliedVoltageNumber (millivolts)OptionalVoltage delivered from the TBS system to the communication unit. Example: 12000 = 12V.