scania-fms

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.

Below is the list of parameters that can appear in the messages received by the channel via scania-fms protocol. In most parameters, the name consists of tags split by dots: tag1.tag2.tag3.tag4... Each tag defines a certain area of an application, e.g. any parameter that contains mileage data has the 'mileage' tag in the name and any parameter related to fuel control contains the 'fuel' tag. By default JSON fields of the message received by a channel via this protocol can only contain the below-specified parameters. Any additional parameter will be prefixed by the "custom" tag, e.g. "custom.unspecified-name".

Name Type Unit Description
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
No results found.