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.
For plant machinery, you can use the Taxonomy API to get the data you need:
Start by requesting the style, sub-style, make and model
The taxonomy facets can then be used to get the rest of the data required for creating the stock
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 | ✓ | ✓ | ✓ | ✓ |
| make | ✓ | ✓ | ✓ | |
| model | ✓ | ✓ | ✓ | |
| derivative | ✓ | ✓ | ✓ | ✓ |
| vehicleType | ✓ | ✓ | ✓ | ✓ |
| fuelType | ✓ | ✓ | ✓ | |
| topSpeedMPH | ✓ | ✓ | ✓ | ✓ |
| enginePowerBHP | ✓ | ✓ | ✓ | |
| enginePowerPS | ✓ | ✓ | ✓ | |
| firstRegistrationDate | ✓ | ✓ | ✓ | |
| colour | ✓ | ✓ | ✓ | |
| style | ✓ | ✓ | ✓ | ✓ |
| subStyle | ✓ | ✓ | ✓ | ✓ |
| lengthMM | ✓ | ✓ | ✓ | |
| heightMM | ✓ | ✓ | ✓ | |
| widthMM | ✓ | ✓ | ✓ | ✓ |
| payloadLengthMM | ✓ | ✓ | ||
| payloadWidthMM | ✓ | ✓ | ||
| PayloadHeightMM | ✓ | ✓ | ||
| PayloadWeightKG | ✓ | ✓ | ✓ | |
| minimumKerbWeightKG | ✓ | ✓ | ✓ | ✓ |
| grossVehicleWeightKG | ✓ | ✓ | ✓ | ✓ |
| hoursUsed | ✓ | ✓ | ✓ | ✓ |
| yearOfManufacture | ✓ | ✓ | ✓ | |
| interiorCondition | ✓ | ✓ | ✓ | |
| tyreCondition | ✓ | ✓ | ||
| bodyCondition | ✓ | ✓ | ||
| driverPosition | ✓ | ✓ | ||
| axleConfiguration | ✓ | ✓ | ✓ |
*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.