Update VHC (UpdateWorkOrder) - autoVHC DMS Integration

Purpose: The purpose of the UpdateWorkOrder method is to allow a third party to update a vehicle health check.

Production: https://integrationfacade.autovhc.net/integrationlayerproxyapi.asmx

QA: https://qa-integrationfacade.autovhc.net/integrationlayerproxyapi.asmx

Development: https://dev-integrationfacade.wsautovhc.co.uk/integrationlayerproxyapi.asmx

Method: UpdateWorkOrder

Sequence Diagram:

Request Structure:

Example Code: Click here to download

<UpdateWorkOrder xmlns="http://www.wsautovhc.co.uk">
	<request>
		<CurrencyCode xmlns="http://autovhc.co.uk/">string</CurrencyCode>
		<Locale xmlns="http://autovhc.co.uk/">string</Locale>
		<Username xmlns="http://autovhc.co.uk/">string</Username>
		<Password xmlns="http://autovhc.co.uk/">string</Password>
		<Sitecode xmlns="http://autovhc.co.uk/">string</Sitecode>
		<DeleteVHC xmlns="http://autovhc.co.uk/">string</DeleteVHC>
		<NewVHCDate xmlns="http://autovhc.co.uk/">string</NewVHCDate>
		<NewJobCardNumber xmlns="http://autovhc.co.uk/">string</NewJobCardNumber>
		<ParametersCollection xmlns="http://autovhc.co.uk/">
			<Parameters>
				<DMSParameter xsi:nil="true" />
				<DMSParameter xsi:nil="true" />
			</Parameters>
		</ParametersCollection>
		<ServiceOrder xmlns="http://autovhc.co.uk/">
			<VHCDate>string</VHCDate>
			<Make>string</Make>
			<Model>string</Model>
			<VIN>string</VIN>
			<JobCardNumber>string</JobCardNumber>
			<RegistrationNumber>string</RegistrationNumber>
			<CustomerTitle>string</CustomerTitle>
			<CustomerFirstName>string</CustomerFirstName>
			<CustomerSurName>string</CustomerSurName>
			<CustomerEmail>string</CustomerEmail>
			<CustomerPostCode>string</CustomerPostCode>
			<CustomerTelephoneNumber>string</CustomerTelephoneNumber>
			<CustomerMobileNumber>string</CustomerMobileNumber>
			<CustomerUUID>string</CustomerUUID>
			<CustomerAddress1>string</CustomerAddress1>
			<CustomerAddress2>string</CustomerAddress2>
			<CustomerAddress3>string</CustomerAddress3>
			<CustomerAddress4>string</CustomerAddress4>
			<CustomerContactEmail>string</CustomerContactEmail>
			<CustomerContactHomePhone>string</CustomerContactHomePhone>
			<CustomerContactMail>string</CustomerContactMail>
			<CustomerContactSMS>string</CustomerContactSMS>
			<CustomerType>string</CustomerType>
			<FirstRegistrationDate>string</FirstRegistrationDate>
			<NextMotDate>string</NextMotDate>
			<NextServiceDate>string</NextServiceDate>
			<ServiceAdvisor>string</ServiceAdvisor>
			<Workshop>string</Workshop>
			<WorkRequired>string</WorkRequired>
			<Mileage>string</Mileage>
			<DateIn>string</DateIn>
			<DateOut>string</DateOut>
			<TimeIn>string</TimeIn>
			<TimeOut>string</TimeOut>
			<MakeCode>string</MakeCode>
			<ModelCode>string</ModelCode>
			<AgreedEstimate>string</AgreedEstimate>
			<EngineNumber>string</EngineNumber>
			<CustomerNotes>string</CustomerNotes>
		</ServiceOrder>
	</request>
</UpdateWorkOrder>

UpdateWorkOrderRequest
PropertyName	PropertyType	Example	Description	Mandatory
CurrencyCode	String	GBP	Code for local currency	Yes
Locale	String	en-GB	Culture code	Yes
Username	String	DMSADMIN	VHC Username	Yes
Password	String	DMSPASSWORD	VHC Password	Yes
Sitecode	String	123456	VHC Site Code	Yes
DeleteVHC	Boolean	false	Delete VHC from system	No
NewVHCDate	String	20120913	Changes date of VHC	No
NewJobCardNumber	String	115522565-1	Changes job card number	No
ParametersCollection	DMSParametersCollection	(see below)	Not required at present	No
ServiceOrder	ServiceOrderTransferObject	(see below)		Yes

DMSParametersCollection
PropertyName	PropertyType	Example	Description	Mandatory
Name	String	Username	The name of the key pair value	Yes
Value	String	admin	The value of the key pair value	No

ServiceOrderTransferObject
PropertyName	PropertyType	Example	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
CustomerAddress3	String	Great Malvern	Customer Address Line 3	No
CustomerAddress4	String	Great Malvern	Customer Address Line 4	No
CustomerContactEmail	Boolean	FALSE	Whether or not the customer is to be contacted by Email. No Value will be assumed false Opt Out	No
CustomerContactHomePhone	Boolean	FALSE	Whether or not the customer is to be contacted by Telephone. No Value will be assumed false Opt Out	No
CustomerContactMail	Boolean	FALSE	Whether or not the customer is to be contacted by Mail. No Value will be assumed false Opt Out	No
CustomerContactSMS	Boolean	FALSE	Whether or not the customer is to be contacted by SMS. No Value will be assumed false Opt Out	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 (HH:MM:SS)	No
TimeOut	String	173000	Time the vehicle is due at the dealership (HH:MM:SS)	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
EngineNumber	String	AB12345	The engine’s identifier number	No
CustomerNotes	String	Front Brakes making knocking noise	Any additional information provided by the customer	No

Response Structure:

Example Code: Click here to download

<UpdateWorkOrderResponse xmlns="http://www.wsautovhc.co.uk">
	<UpdateWorkOrderResult>
		<Message xmlns="http://autovhc.co.uk/">string</Message>
		<Success xmlns="http://autovhc.co.uk/">boolean</Success>
	</UpdateWorkOrderResult>
</UpdateWorkOrderResponse>

UpdateWorkOrderResponse
PropertyName	PropertyType	Example	Description	Mandatory
Message	String	Successful Update	Success message	Yes
Success	Boolean	true	If successful, this would say true	Yes

A failed response would show the below code:

<UpdateWorkOrderResponse xmlns="http://www.wsautovhc.co.uk">
	<UpdateWorkOrderResult>
		<Message xmlns="http://autovhc.co.uk/">Unauthorized</Message>
		<Success xmlns="http://autovhc.co.uk/">false</Success>
	</UpdateWorkOrderResult>
</UpdateWorkOrderResponse>

Update VHC & Job

Testing