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 |