When you look at the vehicle details returned by your request via Autotrader Connect's Vehicles API and Stock API, you'll see an attribute called derivativeId.
derivativeId is a unique identifier that Autotrader uses to store details about a vehicle's derivative. The data we store includes:
- Vehicle specification. For example, 0-60mph time, engine power and fuel economy.
- The features for that derivative
- Autotrader's valuation data
- Autotrader's vehicle metrics data. For example, retail rating and days to sell.
If the derivativeId in the API response from Vehicles API or Stock API is either missing or incorrect, this will affect:
- The accuracy of the advert shown on Autotrader
- The valuations or metrics used by dealers
To fix this, you'll need to use the Taxonomy API to get the correct derivativeId and derivative information for that vehicle.
Find out how to use the Taxonomy API
Once you have the correct derivativeId, you'll need to send a PATCH request to the Stock API with the new derivativeId.
You'll also need to overwrite any vehicle specification and feature data on the stock record related to the old derivative ID to make sure the vehicle information is accurate.