GetStockVehicles
This method gets all the currently listed stock for a specific dealer.
URL : http://webservice.dealerhub.net/dealerhub/WS/DealerHubV1.cfc?wsdl
Method : GetStockVehicles
Input Parameters :
XMLSecurity
XMLData
There are always 2 parameters passed, these are both XML strings, and the first is XMLSecurity which holds the secuirty 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.
This webservice does not need any value in the XMLData parameter, you can pass it as an empty string.
Example output for a valid call:
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet>
<Vehicle>
<VEHICLEID>534</VEHICLEID>
<VEHICLEIDENTIFIER>YR60LTX</VEHICLEIDENTIFIER>
<COLOR>Shine Red s</COLOR>
<FUEL>Gas</FUEL>
<MODELYEAR>2011</MODELYEAR>
<MILEAGE> 1149 </MILEAGE>
<BODY_TYPE/>
<MAKE>Jeep</MAKE>
<MODEL>Grand Cherokee</MODEL>
<SPECIFICATION>Turbo</SPECIFICATION>
<RETAIL_PRICE>11495</RETAIL_PRICE>
<TRANSMISSION>Manual</TRANSMISSION>
<PREVIOUS_OWNERS>1</PREVIOUS_OWNERS>
<DESCRIPTION>Automatic Windows, Sunroof, Bluetooth, Central Locking</DESCRIPTION>
<TRADE_PRICE>11556.5</TRADE_PRICE>
<REGISTRATION_DATE/>
<Images>
<image>/workspace/carimages_1002/534-1.jpg</image>
<image>/workspace/carimages_1002/534-2.jpg</image>
<image>/workspace/carimages_1002/534-3.jpg</image>
<image>/workspace/carimages_1002/534-4.jpg</image>
<image>/workspace/carimages_1002/534-5.jpg</image>
<image>/workspace/carimages_1002/534-6.jpg</image>
</Images>
</Vehicle>
<Vehicle>
<VEHICLEID>535</VEHICLEID>
<VEHICLEIDENTIFIER>YL08NVH</VEHICLEIDENTIFIER>
<COLOR>White</COLOR>
<FUEL>Gas</FUEL>
<MODELYEAR>2010</MODELYEAR>
<MILEAGE> 10089 </MILEAGE>
<BODY_TYPE/>
<MAKE>GMC</MAKE>
<MODEL>Terrain</MODEL>
<SPECIFICATION>2.0L 4x4</SPECIFICATION>
<RETAIL_PRICE>11995</RETAIL_PRICE>
<TRANSMISSION>Manual</TRANSMISSION>
<PREVIOUS_OWNERS>1</PREVIOUS_OWNERS>
<DESCRIPTION/>
<TRADE_PRICE>10000</TRADE_PRICE>
<REGISTRATION_DATE/>
<Images>
<image>/workspace/carimages_1002/535-1.jpg</image>
<image>/workspace/carimages_1002/535-2.jpg</image>
<image>/workspace/carimages_1002/535-3.jpg</image>
<image>/workspace/carimages_1002/535-4.jpg</image>
<image>/workspace/carimages_1002/535-5.jpg</image>
</Images>
</Vehicle>
</Resultset>
|
Output :
| Group |
Field Name |
Field Type |
Field Description |
| Vehicle |
VEHICLE_ID |
Numeric |
The DealerHub ID for this stock vehicle |
| Vehicle |
VehicleIdentifier |
String |
The registration mark / VIN Number for this vehicle |
| Vehicle |
Color |
String |
The colour of this vehicle |
| Vehicle |
Fuel |
String |
The fuel type of this vehicle |
| Vehicle |
ModelYear |
Numeric |
The year this model was created |
| Vehicle |
Mileage |
Numeric |
The vehicle mileage |
| Vehicle |
Body_type |
String |
The vehicle body type, i.e coupe / 4x4 |
| Vehicle |
Make |
String |
The vehicle Manufacturer |
| Vehicle |
Model |
String |
The vehicle model |
| Vehicle |
Specification |
String |
The vehicle specification |
| Vehicle |
Retail_price |
Numeric |
The vehicles retail price |
| Vehicle |
Transmission |
String |
The vehicles transmission |
| Vehicle |
Previous_owners |
Numeric |
Number of previous owners |
| Vehicle |
Description |
String |
The vehicle description text |
| Vehicle |
Trade_Price |
Numeric |
The trade price. |
| Vehicle |
Registration_date |
String |
The date the vehicle was first registered |
| Vehicle.Images |
image |
String |
Up to 10 image URL's can be found in the images group |
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.
|