This method allows the adding of Vehicle data.
URL : http://webservice.dealerhub.net/dealerhub/WS/DealerHubV1.cfc?wsdl
Method : AddStockVehicle
Input Parameters :
XMLSecurity
XMLData
There are always 2 parameters passed, these are both XML strings, and the
first is XMLSecurity which holds the security information, i.e your access
code and the dealercode that you want to access the data for, and the second
is the XML data you are going to pass in.
Input XML Data fields:
| Group |
Field Name |
Field Type |
Field Description |
| Vehicle |
Regno |
String |
The vehicle registration number |
| Vehicle |
VinNo |
String |
The VIN Number for this vehicle |
| Vehicle |
MMCode |
String |
South Africa Only - MM Code for this vehicle |
| Vehicle |
StockNo |
String |
The stock number of this vehicle |
| Vehicle |
Colour |
String |
The colour of this vehicle |
| Vehicle |
Fuel |
String |
The fuel type of this vehicle |
| Vehicle |
ModelYear |
Numeric |
The model year of this vehicle |
| Vehicle |
Mileage |
Numeric |
The vehicle mileage |
| Vehicle |
Bodytype |
String |
The vehicle body type, i.e coupe / 4x4 |
| Vehicle |
Make |
String |
The vehicle Manufacturer |
| Vehicle |
Model |
String |
The vehicle model |
| Vehicle |
Variant |
String |
The vehicle variant / specification |
| Vehicle |
EngineSize |
String |
The engine size of this vehicle |
| Vehicle |
SIV |
Numeric |
The Stand In Value to the dealer of this vehicle |
| Vehicle |
ServiceHistory |
String |
e.g Full / Part / Franchise, any value is acceptable |
| Vehicle |
Price |
Numeric |
The vehicles retail price |
| Vehicle |
Transmission |
String |
The vehicles transmission |
| Vehicle |
PreviousOwners |
Numeric |
Number of previous owners |
| Vehicle |
Description |
String |
The vehicle description text |
| Vehicle |
Options |
String |
Any additional extras |
| Vehicle |
NewUsed |
String |
New or Used vehicle listing (used is default) |
| Vehicle |
RegistrationDate |
Date |
The date the vehicle was first registered |
| Vehicle |
InstockDate |
Date |
The date the vehicle was put in stock |
| Vehicle |
LocationName |
String |
The location of this vehicle if not at the submitting dealership |
| Vehicle |
Gumtree |
Numeric |
Enter 1 to add to Gumtree, or 0 not to add to Gumtree |
| Vehicle.Images |
image |
String |
Up to 10 image URL's can be found in the images group |
RegNo or VinNo have to be entered, these are the only Mandatory fields
The stock vehicle are passed into through the XMLData packet one
at a time
An example of value XMLData packet:
| <Vehicle>
<REGNO>CA229540</REGNO>
<VINNO>KL1TJ62699B297275</VINNO>
<MMCODE>10030282</MMCODE>
<STOCKNO>GH3444</STOCKNO>
<COLOUR>URBAN GREY</COLOUR>
<FUEL>Petrol</FUEL>
<MODELYEAR>2008</MODELYEAR>
<MILEAGE>39000</MILEAGE>
<BODYTYPE>Coupe<BODYTYPE/>
<MAKE>Chevrolet</MAKE>
<MODEL>Aveo</MODEL>
<VARIANT>1.6 LS Hatch</VARIANT>
<ENGINESIZE>1.6</ENGINESIZE>
<SIV>11495</SIV>
<SERVICEHISTORY>FULL</SERVICEHISTORY>
<PRICE>89995</PRICE>
<TRANSMISSION>Manual</TRANSMISSION>
<PREVIOUS_OWNERS>1</PREVIOUS_OWNERS>
<DESCRIPTION>Automatic Windows, Sunroof,
Bluetooth, Central Locking</DESCRIPTION>
<OPTIONS>SAT NAV</OPTIONS>
<NEWUSED>USED</NEWUSED>
<REGISTRATIONDATE></REGISTRATIONDATE>
<INSTOCKDATE></INSTOCKDATE>
<LOCATIONNAME></LOCATIONNAME>
<Images>
<image>http://uk1.autoslm.net/workspace/carimages_1176/WB10328015ZL83048.jpg</image>
<image>http://uk1.autoslm.net/workspace/carimages_1176/c1.jpg</image>
<image>http://uk1.autoslm.net/workspace/carimages_1176/c2.jpg</image>
</Images>
<GUMTREE>1</GUMTREE>
</Vehicle>
|
Example output for a valid call:
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet>
<MessageCode>1000</MessageCode>
<Messagetxt>Stock Vehicle Added Successfully</Messagetxt>
</ResultSet>
|
Example output for an invalid call / or general error in a webservice call
<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet>
<Error>
<ErrorCode>2</ErrorCode>
<ErrorInfo>No data found </ErrorInfo>
</Error>
</ResultSet> |
There may be multiple errors returned in the XML packet, they are separated by <Error> blocks and each block contains an ErrorCode to allow you to do some processing logic on the numerical value returned, and an ErrorInfo which is used by the developer or administrator to visually see what the problem is with the submission.