With the Part Exchange Updates capability on Auto Trader Connect, you will have the ability to add and update part exchange details on deals submitted via Deal Builder on Auto Trader.
Here's a full list of the functionality:
- Add part exchange
- Update part exchange
- Update condition
- Update outstanding finance
- Update offer
Add part exchange
As part of this capability, you can add a part-exchange vehicle to a deal if the consumer wants to include it after the deal is created.
To do this, send a POST request to the Part Exchange API with the advertiser ID of the advertiser the deal is associated with.
The body of the request needs to contain the registration and mileage of the vehicle the consumer would like to part exchange. It can also include details of:
- Any outstanding finance
- The assessed condition of the vehicle by the advertiser
- The offer amount, if the advertiser has made an offer
Check out an example of adding part exchange to a deal
Update part exchange
You can also update any existing part exchange component on a deal. This is usually done once the advertiser has inspected the vehicle to give their appraisal of the condition, any outstanding finance, and their final offer to the consumer for the vehicle.
Update condition
To update a vehicle's condition, you should send a PATCH request to the Part Exchange API, with the part exchange component ID and advertiser ID in the URL.
The body of the request should then contain the condition rating, which should be one of:
- Poor
- Fair
- Good
- Great
- Excellent
For details on when each of these ratings should be used, check out our API developer documentation.
Update outstanding finance
To update whether the part exchange vehicle has outstanding finance, you should send a PATCH request with the part exchange component ID and advertiser ID in the URL.
The body of the request should contain the lender’s name and the outstanding amount of finance in GBP.
To get a list of valid lender names, you should perform a GET request to the settlement lenders endpoint of the Part Exchange API.
Update offer
If the advertiser would like to add or update their offer for the part exchange vehicle, you should send a PATCH request with the part exchange component ID and advertiser ID in the URL.
The body of the request should contain the new offer amount in GBP.
Check out examples of these requests
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.