Skip to content

DMS Integration

Authentication is performed using OAuth 2.0 Bearer Token.

Interface Mapping

The search interface for search and detail queries must return the following fields per vehicle. For the search, at least vehicleNo must be populated, which is used at Belbo as an internal key between the DMS and belbo:



Attribute Type Description
letterSalutation String Salutation for letters, e.g., "Dear Sir or Madam".
salutationCode String Code for the salutation, e.g., "MR" or "MRS".
customerNo String Unique customer number.
firstname String Customer's first name.
lastname String Customer's last name.
phoneNumber String Customer's phone number.
email String Customer's email address.
company String Name of the company, if applicable.
city String Customer's city or town of residence.
postalCode String Customer's postal code.
street String Customer's street and house number.
lastServiceText String Description of the last service event.
licensePlate String Vehicle license plate.
category String Vehicle category, e.g., "Car" or "Truck".
mileage Integer Current vehicle mileage.
nextEmissionCheck Date Date of the next emissions test.
vehicleMake String Vehicle make, e.g., "BMW".
vehicleModel String Vehicle model, e.g., "3 Series".
vehicleNo String Vehicle license plate number.
vin String Vehicle Identification Number (VIN).
serialNumber String Serial number of the vehicle or associated part.