With the Price Updates capability on Auto Trader Connect, you can update the price of dealer's stock shown on our site through the Stock API.
Here’s a full list of the functionality:
- Stock price update
- Update supplied price
- Update forecourt price
- Override admin fee
- Update VAT status
Stock price update
To update prices, you need to make a PATCH request to our Stock API. You need to include the Stock ID of the record you want to update and the Auto Trader Advertiser ID.
Only send a price update when the price has changed for that vehicle.
Your payload should only include the price data. This will make it easier to diagnose issues in case of errors.
There are three different price values that you will be able to update:
1. Update supplied price
The supplied price field determines the price that is shown on the Auto Trader website.
The supplied price plus admin fee field, makes up the price shown on Auto Trader. So this should be the vehicle price without any fees.
2. Update forecourt price
This is the price that is shown on the dealer’s physical forecourt, if different from the price on Auto Trader. If the dealer does not have different prices, then this should be set to the same as supplied price.
3. Override admin fee
Dealers can set an admin fee for all stock at their location with Auto Trader. If they need to override this for a particular stock item, then it can be updated.
VAT (Value Added Tax) Status
This status shows if the price of the vehicle includes VAT. This can be set for both supplied price and forecourt price separately and will be shown on the advert on the Auto Trader website.
There are three valid values for VAT status:
- Inc VAT
- Ex VAT
- No VAT
For vans, this is a required field and the vehicle be rejected if it is advertised without a value. The VAT status will show next to the price. For example, £4500 +VAT.
For cars, this is not needed. You can optionally send a VAT status, or leave it as null.
Check out examples of price update calls
Error Handling
When using the APIs above, you may get error response codes that you need to handle. This makes sure you have a smooth service for both you, as a partner, and your end user.