Once the method is requested, it should respond with the below XML. There are eight mandatory fields within the autoVHC system that need to be populated. Without information in these fields, the method would fail.

These fields are:

  • VHCDate
  • Make
  • Model
  • VIN
  • JobCardNumber
  • RegistrationNumber
  • CustomerSurName
  • CustomerUUID

Please note; all other fields are optional, however they can be populated with further information if required.

<GetServiceOrderByDateResponse xmlns="http://autovhc.co.uk/">
	<GetServiceOrderByDateResult>
		<Message>Successful<Message />
			<Success>true</Success>
			<ServiceOrders>
				<ServiceOrderTransferObject>
					<VHCDate>20200121</VHCDate>
					<Make>NISSAN</Make>
					<Model>MICRA</Model>
					<VIN>W123XXTTFZ9G52522</VIN>
					<JobCardNumber>JOBCARD2101</JobCardNumber>
					<RegistrationNumber>REG123N</RegistrationNumber>
					<CustomerTitle>Mr</CustomerTitle>
					<CustomerFirstName>First Name</CustomerFirstName>
					<CustomerSurName>Last Name</CustomerSurName>
					<CustomerEmail>test1@test.com</CustomerEmail>
					<CustomerPostCode>TE12 3ST</CustomerPostCode>
					<CustomerTelephoneNumber />
					<CustomerUUID>12345</CustomerUUID>
					<CustomerAddress1>First Line</CustomerAddress1>
					<CustomerAddress2>Second Line</CustomerAddress2>
					<CustomerType />
					<FirstRegistrationDate />
					<NextMotDate>2020909</NextMotDate>
					<NextServiceDate>2020317</NextServiceDate>
					<WorkRequired>TEST</WorkRequired>
					<Mileage>17500</Mileage>
					<DateIn />
					<TimeIn />
					<ServiceOrderItems />
					<AgreedEstimate />
				</ServiceOrderTransferObject>     
			</ServiceOrders>
		</GetServiceOrderByDateResult>
	</GetServiceOrderByDateResponse>
GetServiceOrderByDateResponse
PropertyName PropertyType PropertyValue Description Mandatory
Locale String en-GB Culture code Yes
Message String Call successful A message that will indicate why the request failed, Call Successful if it succeeds Yes
Success Boolean TRUE Will be either True or False depending on the success of the request Yes
ServiceOrders ServiceOrderTransferObject (see below) Yes
ServiceOrderTransferObject
PropertyName PropertyType PropertyValue Description Mandatory
VHCDate String 20120912 Date the vehicle is due at the dealership (YYYYMMDD) Yes
Make String FORD Vehicle manufacturer Yes
Model String FOCUS Vehicle model Yes
VIN String WF0BXXWPRB6U02664 Vehicle VIN or Chassis number Yes
JobCardNumber String 11522565 DMS Work order number Yes
RegistrationNumber String FG58 AXY Vehicle registration number Yes
CustomerTitle String Mr Customer Title No
CustomerFirstName String Jamie Customer First Name No
CustomerSurName String Lawrence-Jenner Customer Surname Yes
CustomerEmail String jamie.jenner@autovhc.co.uk Customer Email No
CustomerPostCode String WR13 6PZ Customer PostCode No
CustomerTelephoneNumber String 01684 554477 Customer Land Line Telephone Number No
CustomerMobileNumber String 07977 115478 Customer Mobile/Cell Number No
CustomerUUID String 11544854 DMS Unique customer identifier No
CustomerAddress1 String 12 Acacia Avenue Customer Address Line 1 No
CustomerAddress2 String Great Malvern Customer Address Line 2 No
CustomerType String RETAIL-001 Customer Account category or type No
FirstRegistrationDate String 20081025 Date vehicle first registered (YYYYMMDD) No
NextMotDate String 20121128 Date of the next government vehicle inspection is due (YYYYMMDD) No
NextServiceDate String 20130528 Date when next vehicle service is due (YYYYMMDD) No
ServiceAdvisor String JLJ The DMS identification of the service advisor who will deal with the customer No
Workshop String MAIN Workshop in which the vehicle will be inspected No
WorkRequired String 35,000 km service Description of required work/reason for the booking No
Mileage String 1154458 Last know odometer reading No
DateIn String 20120912 Date the vehicle is due at the dealership (YYYYMMDD) No
DateOut String 20120912 Date the vehicle is due at the dealership (YYYYMMDD) No
TimeIn String 91500 Time the vehicle is due at the dealership (YYYYMMDD) No
TimeOut String 173000 Time the vehicle is due at the dealership (YYYYMMDD) No
MakeCode String 56 DMS Manufacturer Code No
ModelCode String 78 DMS Model Code No
AgreedEstimate String 250 Value quoted to the customer for completion of the work required No