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.
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 except ownershipCondition. This is set dependent on other vehicle details such as mileage and plate.
| Vehicle data field | Needed for stock creation | Editable via the API | Editable in Portal | Search filter on Autotrader |
| ownershipCondition | ✓ | |||
| registration | ✓ | ✓ | ✓ | |
| vin | ✓ | ✓ | ✓ | |
| engineNumber | ✓ | ✓ | ✓ | |
| make | ✓ | ✓ | ✓ | ✓ |
| model* | ✓ | ✓ | ✓ | ✓ |
| derivative* | ✓ | ✓ | ✓ | |
| derivativeId* | ✓ | ✓ | ||
| vehicleType | ✓ | ✓ | ||
| trim* | ✓ | ✓ | ✓ | |
| bodyType* | ✓ | ✓ | ✓ | ✓ |
| fuelType* | ✓ | ✓ | ✓ | |
| transmissionType* | ✓ | ✓ | ✓ | |
| wheelbaseType | ✓ | ✓ | ✓ | ✓ |
| roofHeightType | ✓ | ✓ | ||
| drivetrain | ✓ | ✓ | ✓ | |
| seats | ✓ | ✓ | ✓ | ✓ |
| doors* | ✓ | ✓ | ✓ | |
| co2EmissionGPKM | ✓ | ✓ | ✓ | ✓ |
| badgeEngineSizeLitres | ✓ | ✓ | ✓ | ✓ |
| badgeEngineSizeCC | ✓ | ✓ | ✓ | ✓ |
| engineCapacityCC | ✓ | ✓ | ✓ | ✓ |
| enginePowerBHP | ✓ | ✓ | ✓ | ✓ |
| enginePowerPS | ✓ | ✓ | ✓ | ✓ |
| fuelCapacityLitres | ✓ | |||
| owners | ✓ | ✓ | ✓ | |
| firstRegistrationDate | ✓ | ✓ | ✓ | |
| colour | ✓ | ✓ | ✓ | ✓ |
| payloadWeightKG | ✓ | ✓ | ||
| minimumKerbWeightKG | ✓ | ✓ | ||
| grossVehicleWeight | ✓ | ✓ | ||
| odometerReadingMiles | ✓ | ✓ | ✓ | |
| motExpiryDate | ✓ | ✓ | ||
| warrantyMonthsOnPurchase | ✓ | ✓ | ||
| serviceHistory | ✓ | ✓ | ||
| plate | ✓ | ✓ | ✓ | ✓ |
| yearOfManufacture | ✓ | ✓ | ✓ | ✓ |
| interiorCondition | ✓ | ✓ | ||
| tyreCondition | ✓ | ✓ | ||
| bodyCondition | ✓ | ✓ | ||
| v5Certificate | ✓ | ✓ | ✓ | |
| previousOwners | ✓ | ✓ | ✓ | |
| drivePosition | ✓ | ✓ | ||
| AxleConfiguration | ✓ | ✓ | ||
| upholstery | ✓ | ✓ | ||
| interiorColour | ✓ | ✓ | ||
| exteriorFinish | ✓ | ✓ | ||
| lastServiceOdometerReadingMiles | ✓ | ✓ | ||
| lastServiceDate | ✓ | ✓ | ||
| wheelchairAccessible | ✓ | ✓ | ✓ |
*If you need to edit one of these data points, the derivative ID is likely incorrect. In this scenario, you should use the Taxonomy API to select a new derivative ID. Then, call for the new technical data and update the stock record with all data returned.
Changing one of the values individually may cause the derivativeId to be removed due to invalid vehicle data.
After editing the vehicle, check the spec. This will not have changed and could be incorrect.