Scania-fms protocol

Integration level: params
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.
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.type.id
number
ID of device type of device that received a message
driver.id
string
Driver identification card id
driver.name
string
Driver name
engine.ignition.status
boolean
Engine ignition status
fuel.consumed
number
liters
Fuel volume totally consumed by vehicle
fuel.level
number
percentage
Fuel level percentage
ident
string
Device unique identificator and optional password
message.type
string
Message type
position.altitude
number
meters
Altitude value for position
position.direction
number
degrees
Heading angle at position detection moment
position.latitude
number
degrees
Latitude coordinate value
position.longitude
number
degrees
Longitude coordinate value
position.speed
number
km/h
Instant speed at position detection moment
protocol.id
number
ID of protocol
server.timestamp
number
seconds
Timestamp when server received a message
timestamp
number
seconds
Message timestamp
vehicle.mileage
number
km
Total calculated mileage
vehicle.vin
string
VIN of vehicle

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.