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. With motorhomes it's likely the vehicle originally started off as a van and the vehicle data on the registration may still be that.
The data returned is likely not enough to complete the stock item. But you can use the taxonomy API to get the required data:
Start by requesting the make and model
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 | ✓ | ✓ | ||
| engineNumber | ✓ | ✓ | ✓ | |
| make* | ✓ | ✓ | ✓ | ✓ |
| model* | ✓ | ✓ | ✓ | ✓ |
| derivative | ✓ | ✓ | ✓ | ✓ |
| vehicleType | ✓ | ✓ | ✓ | ✓ |
| fuelType* | ✓ | ✓ | ✓ | ✓ |
| transmissionType* | ✓ | ✓ | ✓ | ✓ |
| drivetrain | ✓ | ✓ | ✓ | ✓ |
| seats | ✓ | ✓ | ✓ | |
| engineCapacityCC | ✓ | ✓ | ✓ | ✓ |
| enginePowerBHP | ✓ | ✓ | ✓ | ✓ |
| emissionClass | ✓ | ✓ | ✓ | |
| owners | ✓ | ✓ | ✓ | |
| firstRegistrationDate | ✓ | ✓ | ✓ | |
| lengthMM | ✓ | ✓ | ✓ | ✓ |
| heightMM | ✓ | ✓ | ✓ | |
| widthMM | ✓ | ✓ | ✓ | |
| payloadWeightKG | ✓ | ✓ | ✓ | |
| minimumKerbWeightKG | ✓ | ✓ | ✓ | ✓ |
| grossVehicleWeightKG | ✓ | ✓ | ✓ | ✓ |
| odometerReadingMiles | ✓ | ✓ | ✓ | ✓ |
| motExpiryDate | ✓ | ✓ | ✓ | |
| serviceHistory | ✓ | ✓ | ||
| plate | ✓ | ✓ | ✓ | ✓ |
| yearOfManufacture | ✓ | ✓ | ✓ | ✓ |
| interiorCondition | ✓ | ✓ | ||
| tyreCondition | ✓ | ✓ | ||
| bodyCondition | ✓ | ✓ | ||
| v5Certificate | ✓ | ✓ | ||
| previousOwners | ✓ | ✓ | ✓ | |
| driverPosition | ✓ | ✓ | ✓ | ✓ |
| axleConfiguration* | ✓ | ✓ | ||
| chassisMake | ✓ | ✓ | ✓ | ✓ |
| chassisModel | ✓ | ✓ | ✓ | ✓ |
| bedroomLayout* | ✓ | ✓ | ✓ | ✓ |
| endLayout* | ✓ | ✓ | ✓ | ✓ |
| berths | ✓ | ✓ | ✓ | ✓ |
| 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.