When creating a stock record, it's recommended that all data points returned in the vehicle or taxonomy lookup are sent. However, there'll be instances when the data returned is incomplete and not enough to complete the stock item. This is common with caravans being so unique.
For caravans, you can use the Taxonomy API to get the data you need:
- Start by requesting the style
- Then follow this up with bedroom layout, end layout, and axle configurations
- The list of all of our taxonomy facets is available in our developer documentation
The table below shows the fields needed for stock creation, those you can edit via the API, what's editable in Portal and whether it's a search filter on Autotrader. Everything's editable via the API.
| Vehicle data field | Needed for stock creation | Editable via the API | Editable in Portal | Search filter on Autotrader |
| ownershipCondition | ✓ | ✓ | ✓ | ✓ |
| vin | ✓ | ✓ | ✓ | |
| make* | ✓ | ✓ | ✓ | ✓ |
| model* | ✓ | ✓ | ✓ | ✓ |
| derivative | ✓ | ✓ | ✓ | |
| vehicleType | ✓ | ✓ | ✓ | ✓ |
| bodyType* | ✓ | ✓ | ✓ | ✓ |
| owners | ✓ | ✓ | ✓ | |
| style* | ✓ | ✓ | ✓ | ✓ |
| lengthMM | ✓ | ✓ | ✓ | ✓ |
| heightMM | ✓ | ✓ | ✓ | |
| widthMM | ✓ | ✓ | ✓ | |
| payloadWeightKG | ✓ | ✓ | ✓ | ✓ |
| grossVehicleWeightKG | ✓ | ✓ | ✓ | |
| serviceHistory | ✓ | ✓ | ✓ | |
| yearOfManufacture | ✓ | ✓ | ✓ | ✓ |
| interiorCondition | ✓ | ✓ | ||
| tyreCondition | ✓ | ✓ | ||
| bodyCondition | ✓ | ✓ | ||
| previousOwners | ✓ | ✓ | ✓ | |
| bedroomLayout* | ✓ | ✓ | ✓ | ✓ |
| endLayout* | ✓ | ✓ | ✓ | ✓ |
| berth | ✓ | ✓ | ✓ | ✓ |
| keys | ✓ | ✓ | ✓ |
*If you want to edit one of these data points, you should use the Taxonomy API with the taxonomy facets to get the most accurate data. If you include the vehicle type, make, and model, it will filter the facets to only show valid values.