The request itself is in a node called <LabourCriteria>
. The user types in the labour code on the autoVHC system and this requests the <DMSLabourCode>
from the DMS. Along with the Labour Code, the user also inputs the amount of hours that they feel the technician should be working on the vehicle. This falls into <timeamount>
.
The below request shows a search for a labour code. In this example, the labour code is 336747. As the user is searching for the labour code, the description is left blank.
<SearchLabour xmlns="http://autovhc.co.uk/">
<Request>
<Locale>en-GB</Locale>
<JobCardNumber>2148110740</JobCardNumber>
<CustomerID>60256</CustomerID>
<LocationCode>01</LocationCode>
<LabourCriteria>
<DMSLabourCode>336747</DMSLabourCode>
<description />
<timeamount>2</timeamount>
<LabourCodeSourceDMS>True</LabourCodeSourceDMS>
</LabourCriteria>
<ParametersCollection>
<Parameters>
<DMSParameter>
<Name>USERNAME</Name>
<Value />
</DMSParameter>
<DMSParameter>
<Name>PASSWORD</Name>
<Value />
</DMSParameter>
</Parameters>
</ParametersCollection>
<WildCardSearch>false</WildCardSearch>
</Request>
</SearchLabour>
This example shows what is requested when the user searches via a description, instead of a Labour Code. The below example shows a blank labour code, with the description showing BrakesLabour.
<SearchLabour xmlns="http://autovhc.co.uk/">
<Request>
<Locale>en-GB</Locale>
<JobCardNumber>2148110740</JobCardNumber>
<CustomerID>60256</CustomerID>
<LocationCode>01</LocationCode>
<LabourCriteria>
<DMSLabourCode />
<description>BrakesLabour</description>
<timeamount>2</timeamount>
<LabourCodeSourceDMS>True</LabourCodeSourceDMS>
</LabourCriteria>
<ParametersCollection>
<Parameters>
<DMSParameter>
<Name>USERNAME</Name>
<Value />
</DMSParameter>
<DMSParameter>
<Name>PASSWORD</Name>
<Value />
</DMSParameter>
</Parameters>
</ParametersCollection>
<WildCardSearch>false</WildCardSearch>
</Request>
</SearchLabour>
SearchLabourRequest | ||||
PropertyName | PropertyType | PropertyValue | Description | Mandatory |
Locale | String | en-GB | The .NET CurrentCulture.Name | Yes |
JobCardNumber | String | 11522565 | DMS Work order number | Yes |
CustomerID | String | 11544854 | DMS Unique customer identifier | Yes |
LocationCode | String | M1 | Used by some DMS require this to identify specific dealer data | Yes |
LabourCriteria | LabourTransferObject | (see Response Objects) | autoVHC will partially populate this with Labour code, description, hours | No |
ParametersCollection | DMSParametersCollection | (see below) | No | |
WildCardSearch | Boolean | TRUE | Indicates the user has request to seach the DMS using wild cards | Yes |
DMSParametersCollection | ||||
PropertyName | PropertyType | PropertyValue | Description | Mandatory |
Name | String | Username | The name of the key pair value | Yes |
Value | String | admin | The value of the key pair value | No |