Webservices - Insert a Vehicle

The webservice is used to insert a vehicle in the database.

03 August,2022

 

 
REQUEST

{

   "Proxy": {   

      "Function":"HeliosWs",

      "HostName":"xxxxx",

      "UserName":"yyyyy",

      "Password":"zzzzz",

      "ReportName":"webservice"

   },

 

   "AuthenticationType":"SYSTEM",

   "UserName":"16984205",

   "Password":"8G56A2NrB",

   "Function":"InsertVehicle",

   "VehicleRegNo":"DG23969",

   "Make":"Hyundai",

   "Model":"I20 1,2",

   "Year":"2011",

   "Vin":"NLHBB51BABZ027252",

   "FirstRegDate":"",

   "Mileage":"146200",

   "Doors":"",

   "Fuel":"",

   "InfoTyreChange": false,

   "CustomerNo":"44570088",

   "VehicleUserNo":"",

   "VehicleUserName":"",

   "VehicleUserName2":"",

   "VehicleUserPhone":"",

   "VehicleUserMobile":""

}

 

 
RESPONSE

{

   "VehicleList": [   {

      "VehicleRegNo": "DG23969",

      "Make": "HYUNDAI",

      "Model": "I20 1,2",

      "Year": "2011",

      "Vin": "NLHBB51BABZ027252",

      "Type": "Personbil",

      "Variant": "1,2",

      "ModelCode": "E53659",

      "FirstRegDate": "2011-03-01T00:00:00Z",

      "LastMotDate": "2017-01-26T00:00:00Z",

      "NextMotDate": "2019-01-26T00:00:00Z",

      "Mileage": "146200",

      "Doors": "",

      "Fuel": "Benzin",

      "SalesVehicle": false,

      "CustomerNo": "44570088",

      "Name": "RST ApS"

   }],

   "WebserviceInfo": {

      "Name": "HELIOSWEBSERVICE",

      "Version": 1,

      "Build": 2001

   },

   "AuthenticationType": "SYSTEM",

   "ErrorCode": 0,

   "ErrorText": "",

   "Success": true,

   "Proxy": {

      "AgentName": "WSPROXY",

      "AgentVersion": "1.00.1112",

      "AgentCopyright": "Copyright (C) 2017-2018 Torben Ring. All rights reserved.",

      "ErrorCode": 0,

      "Success": true

   }

}

 

 
ERRORS

  • Missing data - VehicleRegNo, Vin or CustomerNo not in request.
  • Already exists - VehicleRegNo or Vin already exists in Helios.
  • Invalid data - CustomerNo does not exist in Helios.
  • Invalid data - VehicleRegNo and Vin do match match i CRM database.
 
 
COMMENTS

  • The vehicle cannot be created if the Vehicle No. or Vin already exists in Helios.
  • VehicleRegNo and CustomerNo must be entered in the request.
  • If Vin is not entered in request, vehicle must be found in CRM database in order for Vin to be found here.
  • If VehicleRegNo is found in CRM database, Vin must match VIN in CRM database.
  • CustomerNo must exist in Helios.
  • Type, Variant, ModelCode, FirstRegDate, LastMotDate and Next MotDate are downloaded from CRM database if VehicleRegNo is found in CRM database.
  • If VehicleUserNo is entered in the request and this number exists in Helios' customer database, user information will be taken from there and inserted on the vehicle.
  • If VehicleUserNo does not exist in Helios customer database, the users name, name2, phone og mobile no. can be entered in the request.