Webservices - Update a Vehicle

The webservice is used to update an existing 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":"UpdateVehicle",

   "VehicleRegNo":"DG23969",

   "Make":"Hyundai",

   "Model":"I20 1,2",

   "Year":"2011",

   "Vin":"NLHBB51BABZ027252",

   "Mileage":"146200",

   "Doors":"",

   "Fuel":"",

   "InfoTyreChange": false,

   "VehicleStatus":"",

   "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",

      "InfoTyreChange": false

   }],

   "WebserviceInfo": {

      "Name": "HELIOSWEBSERVICE",

      "Version": 1,

      "Build": 2001

   },

   "AuthenticationType": "SYSTEM",

   "ErrorCode": 0,

   "ErrorText": "",

   "Success": true,

   "Proxy": {

   "AgentName": "WSPROXY",

   "AgentVersion": "1.00.1015",

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

   "ErrorCode": 0,

   "Success": true

   }

}

 

 
ERRORS

  • Missing data - Vin not in request.
  • Invalid data - Vehicle with the specified Vin does not exist in Helios.
  • Invalid data - CustomerNo does not exist in Helios.
  • Invalid data - VehicleRegNo and Vin do match match i CRM database.
 
 
COMMENTS

 

  • The vehicle can only be updated if the vehicle with the specified Vin already exists in Helios.
  • If CustomerNo is entered in the request, the customer must exist in Helios.
  • Fields not present in the request will not be changed in Helios.
  • VehicleStatus can be set to CUSTOMERVEHICLE, UNREGISTERED or SCRAPPED. If VehicleStatus is not entered in the request it will be set to CUSTOMERVEHICLE.
  • 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.