Register or update a tracking device

Registers a new or updates an existing tracking device depending if the device is already known. A device is defined by a unique combination of the externalSystemId and the externalDeviceId. So registering an already existing device will update all the attributes except the DeviceUUID

Request
Security:
Request Body schema: application/json

Tracking Device that needs to be added to the service

externalDeviceId
required
string

The identifier you use to recognize the device/vehicle in your source system

externalSystemId
required
string

Identifier for the source system we use to uniquely recognize the shipper/carrier

active
required
boolean
Default: true

Indicates whether the current tracking device is active or not

carrierCode
required
string

This code is used by the Simacan Control Tower to match a Tracking Device with a carrier

customerDeviceId
required
string
licensePlate
string

License Plate linked with the current tracking device

driverName
string

Driver name linked with the current tracking device

attributes
object

Any freeform additional attributes

Responses
200

Indicates that your request was successful. You will see an entity describing or containing the result of your action

400

Bad Request: You will receive this status, when the data you’ve delivered is not in the correct format. You will see an entity describing what went wrong.

401

Unauthorized: Whenever you will get this status, you have either provided the wrong credentials or none at all. Check if you bearer token has not expired.

403

Forbidden: You will receive this status, when you successfully supplied credentials, but your username does not have the necessary permissions for the resource.

404

Not Found: Whenever you will get a 404, you are probably using a malformed or incorrect URL.

post/
Request samples
application/json
{
  • "externalDeviceId": "string",
  • "externalSystemId": "string",
  • "active": true,
  • "carrierCode": "string",
  • "customerDeviceId": "string",
  • "licensePlate": "string",
  • "driverName": "string",
  • "attributes": { }
}
Response samples
application/json
{
  • "deviceUUID": "b9ed42ff-3ffb-4418-9498-5eb0ba308899",
  • "externalSystemId": "fms-janszoon_transport",
  • "externalDeviceId": "1234",
  • "customerDeviceId": "string",
  • "active": "true",
  • "relation": "janszoon_transport",
  • "carrierCode": "string",
  • "creationDate": "2020-06-07T09:17:43Z",
  • "lastUpdatedDate": "string",
  • "licensePlate": "AB-12-CD",
  • "driverName": "string",
  • "attributes": {
    }
}