Scania-fms protocol

Protocol used to fetch vehicle position data from Scania Fleet Management Services.
flespi parses the Scania-fms protocol messages into a JSON object with the fields listed below in the Parameters tab.

Fetch vehicles position information to a channel from Scania Fleet Management Services using Scania API.

To use the channel you need to have an active Control package from a Scania dealer with your 'User ID' and 'Password'.

Obtain the 'Client ID' and 'Secret Key' fields for proper flespi channel configuration:

  1. Open Scania Developer Portal
    In 'Login As' drop-down select 'Scania Data Access User', enter 'User ID' and 'Password', and log in.
  2. Open 'My Application' tab, then click 'Create Application' button, enter application name and description, and hit 'Save'.
  3. Copy generated 'Client ID' and 'Secret key' strings into corresponding channel configuration fields.

After creation please check the channel logs for errors using Toolbox.

flespi channel relies on the LastReported request from the Positions API and the RfmsStatusCurrent request from the rFMS API. All explanations for the error codes can be found in the respective sections of the Scania API.

Note: Scania vehicles will only send data to their servers when the engine is running or ignition is on.

Learn more about getting Scania data into flespi and forwarding it to other platforms in our dedicated blog post.

catalyst.fuel.level
number
Catalyst fuel level
CatalystFuelLevel
channel.id
number
ID of channel that received a message
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
device.self.name
string
Device name reported by the device
CustomerVehicleName
device.type.id
number
ID of device type of device that received a message
driver.id
string
Driver identification card id
Driver1.DriverIdentification,
DriverIdentification
driver.name
string
Driver name
Driver
engine.ignition.status
boolean
Engine ignition or ACC status
Ignition
fuel.consumed
number
liters
Fuel volume totally consumed by vehicle
EngineTotalFuelUsed
fuel.level
number
percentage
Fuel level percentage
FuelLevel1
ident
string
Device unique identifier like serial number, IMEI, etc
message.type
string
Message type
TriggerType
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
GNSSPosition.Altitude
position.direction
number
degrees
Heading angle at position detection moment
GNSSPosition.Heading,
Heading
position.latitude
number
degrees
Latitude coordinate value
GNSSPosition.Latitude,
Latitude
position.longitude
number
degrees
Longitude coordinate value
GNSSPosition.Longitude,
Longitude
position.speed
number
km/h
Instant speed at position detection moment
GNSSPosition.Speed,
Speed
protocol.id
number
ID of protocol
server.timestamp
number
seconds
Timestamp when server received a message
timestamp
number
seconds
Message timestamp
GNSSPosition.PositionDateTime,
TimePosition
vehicle.chassis.number
number
Chassis number
ChassisNumber
vehicle.mileage
number
km
Total calculated mileage
HRTotalVehicleDistance,
Odometer
vehicle.plate.number
string
Vehicle plate number
LicensePlate
vehicle.vin
string
VIN of vehicle
VIN,
Vin