Clean Car Discount & Fee (NZ ONLY)
As of 1st April 2022, Waka Kotahi have introduced a new Clean Car Discount/Rebate or Fee for qualifying vehicles.
The Clean Car Fee and Rebate calculations are calculated by Waka Kotahi and AutoPlay are not responsible for the values returned by the Clean Car lookup.
The Clean Car Fee or Rebate applies to most new vehicles and used vehicles being registered in NZ for the first time. Vehicles must;
- Be registered for the first time in NZ from 1 April 2022*
- Have a safety rating of 3 or more stars on Rightcar at the time of registration*
- Purchased for less than $80,000 including GST and on-road costs (the purchase price)*
- Not have already had a rebate or fee applied*
- Have CO2 emissions of between zero to 146 grams per km*
INFORMATION CURRENT AS AT 1st APRIL 2022. PLEASE CHECK THE NZTA/WAKA KOTAHI WEBSITE FOR THE MOST RECENT INFORMATION
To read more about how the Clean Car Programme works visit NZTA/Waka Kotahi here - https://www.nzta.govt.nz/vehicles/clean-car-programme/clean-car-discount/clean-car-discount-eligibility-criteria/eligibility-criteria-for-vehicles-first-registered-from-1-april-2022/
Clean Car Rebates/Discounts must be applied for by the purchaser after buying their vehicle. Clean Car Fees are paid at time of purchase.
In March 2022 AutoPlay will be releasing changes designed to help dealerships meet their obligations under the Clean Car Discount and Fee scheme. This entails;
- Changes to the Waka Kotahi Vehicle Lookup
- Changes to the Listing Detail screen in AutoPlayAuto.com
- Additional fields available in Data API's
- Additional fields presented on AutoPlay Vehicle Display Pages
- Additional functionality on Write Up Forms in AutoPlayAuto.com
NOTE - All screenshots/mockups are for illustration purposes only and do not contain real data from the Waka Kotahi/LTSA database.
Retrieving Clean Car Discount or Fee Information
All relevant Clean Car Discount / Fee information will be automatically retrieved by AutoPlay as part of the existing Fuel Saver/Right Car lookup. When listings are first manually loaded to AutoPlay, or are received from the DMS/VMS, AutoPlay will automatically run the Clean Car Lookup based on the VIN, Rego or Chassis Number.
If the fields are blank the Clean Car lookup will continue to be run on a WEEKLY basis every Monday at 6am for any listing in AutoPlay that has blank fields for Fuel, Safety, CO2 or Clean Car data.
The lookup process will select listings based on the following criteria:
* 1. Car listing type
* 2. Listing is current, pending or on hold
* 3. Fuel Stars is 0 or fuel saver error occurred
* 4. VIN or Plate is present
* 5. NZ listings
* 6. Created in the last 6 months
* 7. Clean Car data is NOT updated for manually entered listings
If the fields are populated the Clean Car lookup will be run on a WEEKLY basis every Monday at 7am to check for the latest data.
If the fields are populated the Clean Car lookup will be run on a WEEKLY basis every Monday at 7am to check for the latest data.
The recheck lookup process for listing already populated will select listings based on the following criteria:
* 1. Fuel saver is over 1 month old
* 2. Listing is current, pending or on hold
* 3. VIN or Plate is present
* 4. NZ listings
* 5. Clean Car data is NOT updated for manually entered listings
The Clean Car Discount & Fee information is retrieved from the following fields within the Waka Kotahi lookup;
| Waka Kotahi Field Name | Waka Kotahi Sample Field & Explanation | AutoPlay Field Name |
| CleanVehicleInd string(20) | Text indicator to allow differentiation of clean vehicle values. SAMPLE VALUES "Rebate", "Possible Rebate", "None", "Possible Fee", "Fee", "Null" (if unknown) "None" is mapped in AutoPlay to "Not Applicable" and is defined as the vehicle can be found in the Clean Car database, but it does not qualify for a fee or a rebate. "Null" is mapped in AutoPlay to "Data Temporarily Unavailable". This only means that we cannot currently find the data within the Waka Kotahi lookup. It may be that this vehicle has yet to go through compliance and will be populated at a later date, or the database cannot currently be reached. | Clean Car Rebate/Fee Applicable (drop down with "Rebate", "Fee", "Not Applicable" and "Data Temporarily Unavailable" |
| CleanVehicle and CleanVehicleMax Decimal | $ Rebate (negative) or Fee (positive). When used in conjunction with CleanVehicleMax represents a range (can be the result when searching by Chassis or Model Code). Values include GST. SAMPLE VALUES "-500", "500" etc | Clean Car Rebate/Fee and Clean Car Rebate/Fee Max - shown as a $ value (+/-) |
| CleanVehicleText string (150) | Text version of Fee or Rebate SAMPLE VALUES "Rebate of $1,710 upon application", "Fee of $1,410 upon registration", "No rebate or fee applies" | Clean Car Details |
| CleanVehicleDisclaimerLong string | Text description of the CCD Disclaimer. Is ONLY used when there is a Clean Car Discount or Clean Car Fee applicable. When the vehicle does not qualify for a Clean Car Discount or Fee the CO2Disclaimer is used instead. SAMPLE VALUES "This information is guidance on how environmentally friendly the vehicle is and whether a fee or rebate applies based on the CO2 rating. The lower the emissions - the higher the rebate, the higher the emissions - the higher the fee. Vehicles are only eligible for a rebate if sold for less than $80,000 including GST and on road costs and have a 3-star safety rating or above. The fees and rebates in this notice are estimates. The amount of the fee will be confirmed at the time of the first registration in New Zealand and the rebate will be confirmed upon application." | Clean Car Disclaimer |
The information pulled through from Waka Kotahi is displayed in the existing 'FUEL & SAFETY' section on each individual listing, alongside the existing Fuel Economy and Safety Rating information (now displayed as a Safety Badge).
The Clean Car information and CO2 Emissions info can be overridden by ticking the 'Manual Entry' checkbox as shown with the blue tick above. When this option is ticked it will allow the user to manually overwrite whatever the Waka Kotahi lookup is returning - whether the fields are populated with information you believe is incorrect or the data is blank. This can only be ticked by users who are Managers in the Manage Listings role within AutoPlay, and all activity is recorded in the auditing information captured from this screen. When ticked the automatic checking of the listings Clean Car info will be disabled for the lifetime of that listing, or until the box is unchecked.
To allow the vehicle to be automatically populated with the Waka Kotahi provided data again users can uncheck the 'Manual Entry' check box. This will wipe the info currently typed into the Clean Car fields and immediately prompt a lookup to return whatever data is available from Waka Kotahi. Once agreed manually typed data will be lost forever - even if Waka Kotahi does not return any values.
As part of the Clean Car programme AutoPlay has expanded the CO2 fields to include 3 fields that are relevant to the Clean Car rebate/fee calculations. These fields are not editable and are added to the 'FUEL & SAFETY' section in AutoPlayAuto.com within the Listing Detail screen.
CO2Emissions
Waka Kotahi Field Name | Waka Kotahi Field Type | Waka Kotahi Field Explanation | Waka Kotahi Sample Data | AutoPlay Field Name |
string (or integer when excluding "grams/km") | Field detailing the emissions based on grams per km | "142 grams/km" | CO2 Emissions | |
CO2Disclaimer | string | Text description of the CO2 Disclaimer. When a vehicle does NOT qualify for the Clean Car Discount or Fee the explanation why is detailed here (in place of CleanVehicleDisclaimerLong) | "This car has already been registered in New Zealand and is not eligible for a Clean Car fee or rebate." "The CO2 value for this vehicle is unknown and may be assigned at time of certification." "This car is ineligible for a rebate because the sale price is expected to be over $80k." "This car is ineligible for a rebate because the safety rating is less than 3 stars." | CO2 Disclaimer |
CO2StarRatingText | string | Field detailing the star rating out of 6 stars | "4.5 stars out of 6" | CO2 Star Rating |
API Changes - New Fields Available
In addition to the changes in AutoPlayAuto.com, AutoPlay are making a number of changes to the Data.autoplay.co.nz and other API's.
| AutoPlayAuto.com Field Name | API Field Name | Explanation |
| Clean Car Rebate / Fee Applicable | Listing_Clean_Vehicle_Ind | A field containing values that indicate whether a Fee or Rebate applies. Values are; - Fee - Rebate - Not Applicable (vehicle data found, but no rebate/fee applies - Data Temporarily Unavailable (no data found in vehicle lookup) Example - "Fee" |
| Clean Car Rebate / Fee & Clean Car Rebate / Fee Max | Listing_Clean_Vehicle Listing_Clean_Vehicle_Max | The Listing_Clean_Vehicle field is a field containing the + or - value for the rebate/fee as determined by the Waka Kotahi lookup. This value will be a + if a Fee is applicable, or a - if a Discount/Rebate is applicable. The field will be blank if no Rebate or Fee applies, or no data is available for the specified listing. If the vehicle lookup has specified a range instead of a single number the Listing_Clean_Vehicle_Max field will be populated with the upper band of the Clean Vehicle Discount or Fee range (with Listing_Clean_Vehicle providing the lower range) Example - "1140" |
| Listing Price | Listing_Price Listing_Price_CCD_Inclusive Listing_Price_CCD_Inclusive_Max | The Listing Price field in AutoPlayAuto.com as well as the corresponding Listing_Price field in the in the AutoPlay API remain unchanged - these fields EXCLUDE any Clean Car Fee or Rebate. New fields exist in the AutoPlay API only called Listing_Price_CCD_Inclusive and Listing_Price_CCD_Inclusive_Max. These fields are automatically calculated by adding the Listing_Price and the Clean_Car_Discount_or_Fee_Applicable (or Clean_Car_Discount_or_Fee_Applicable_Max) to give a total inclusive figure of what the vehicle will cost the customer including the Clean Car Fee. When the Clean Car Max is populated this gives the upper band of pricing for the vehicle. It is unlikely a Max value will be returned from AutoPlay provided the vehicle lookup is completed on a VIN or Rego. The Listing_Price_CCD_Inclusive will only ever automatically apply the Clean Car FEE. Clean Car Discounts are not automatically applied as they are not automatically granted at time of purchase - the customer must apply for the rebate themselves post purchase. Example - "29990" |
| Clean Car Details | Listing_Clean_Vehicle_Text | A text field explaining the Fee or Rebate applicable. Example - "Rebate of $1,710 upon application", "Fee of $1,410 upon registration", "No rebate or fee applies" |
| Clean Car Disclaimer | Listing_Clean_Vehicle_Disclaimer_Long | A paragraph that is used when the vehicle qualifies for a Clean Car Rebate or Fee. Example - "This information is guidance on how environmentally friendly the vehicle is and whether a fee or rebate applies based on the CO2 rating. The lower the emissions - the higher the rebate, the higher the emissions - the higher the fee. Vehicles are only eligible for a rebate if sold for less than $80,000 including GST and on road costs and have a 3-star safety rating or above. The fees and rebates in this notice are estimates. The amount of the fee will be confirmed at the time of the first registration in New Zealand and the rebate will be confirmed upon application." When the vehicle DOES NOT qualify for a rebate or fee Listing_CO2_Disclaimer is used instead |
| CO2 Emissions | Listing_CO2 or Listing_CO2_Text | Listing_CO2 returns a integer whilst Listing_CO2_Text returns the integer value plus 'grams/km'. Note - if previously using Listing_CO2_Yearly it is recomended this yearly usage is swapped out for the grams per KM featured in the Listing_CO2 field. Example - "235 grams/km" |
| CO2 Disclaimer | Listing_CO2_Disclaimer | A sentence that is used when the vehicle does NOT qualify for a Clean Car Rebate or Fee. Example - "This car has already been registered in New Zealand and is not eligible for a Clean Car fee or rebate." "The CO2 value for this vehicle is unknown and may be assigned at time of certification." "This car is ineligible for a rebate because the sale price is expected to be over $80k." "This car is ineligible for a rebate because the safety rating is less than 3 stars." When the vehicle DOES qualify for a rebate or fee Listing_Clean_Vehicle_Disclaimer_Long is used instead |
| CO2 Star Rating | Listing_CO2_Stars_Text | AutoPlay have made a decision not to build a star graphic for CO2 Stars as there is already star graphics/badges available for Fuel Economy and Safety ratings. Instead AutoPlay will provide the 'Listing_CO2_Stars_Text' field which supplies the star rating in text format. Example "3.5 stars out of 6" If required end users of the API can build their own CO2 Star Ratings from the Listing_CO2_Stars field (note - this is out of 6 and served in have star increments. e.g 7 = 3 and 1/2 stars). |
| Safety Badge | Listing_Safety_Promo_Badge | Returns a png graphic used for a Safety badge as provided by Waka Kotahi. Can be used to replace a self built star graphic or text description. Example 'safety-star-5.png' the Full URL to get that promo badge would be |
AutoPlay Vehicle Display Pages
AutoPlay have also created new fields in the AutoPlay Vehicle Display Pages to handle the new Clean Car Discount/Fee requirements. These include;
1. Customisable Price Display
- The default behaviour for the AutoPlay plug in Vehicle Display Page is to show the price EXCLUDING the Clean Car Discount/Fee as per current behaviour. If Dealers take no action the price will continue to exclude any fee. A new line detailing that the listing 'Excludes Clean Car Fee of $XXXX' will be displayed.
- There is also the option to INCLUDE the Fee as part of the Listing Price. In this scenario the sentence located below the price will be modified to display "Includes Clean Car Fee of $XXX". Note that as the Clean Car Fee is paid at the time of purchase some dealers may consider it appropriate to include in the listing price to more accurately represent the cost to the customer. This is not a mandatory requirement as long as the Clean Car Fee is displayed.
- The Rebate will never be added to the inclusive price as it is applied for at a later date by the customer post purchase
- When the Inclusive option is set for the stock page this will add to the Special Price as well if the dealer utilises this field
- To enable the Clean Car Fee INCLUSIVE contact support@autoplay.co.nz. The setting is controlled at the stock page level and must be set for the entirety of the stock page - it cannot differ by listing or by dealer in the case of multi dealer vehicle display pages. The setting can be deployed by the AutoPlay development team to the stock page config settings without requiring a local web developer to make any changes to the website code itself.
- When the vehicle does qualify for a Rebate the MORE INFO button displays a Clean Car Disclaimer.
- When the vehicle either does not qualify for the Clean Car Discount or Fee OR there is no data retrievable from the Waka Kotahi lookup the price is displayed as it normally would be with no mention of Clean Car details at the top of the screen. When the vehicle has data returned but does not qualify for a rebate or fee there is additional info explaining this lower down on the page in the 'Clean Car Rating' section
2. Clean Car Rating Section
The AutoPlay Vehicle Display Pages now include a Clean Car Rating section by default under the following circumstances;
- Clean Car Fee Applies
- Clean Car Rebate Applies
- Clean Car Rebate or Fee Not Applicable
The Clean Car Rating section does NOT appear if there is no data available from the Waka Kotahi Lookup (and no manual over-ride has been applied)
Clean Car Rebate
Clean Car Fee
Clean Car Not Applicable
3. Searching For Clean Car Fee & Rebates On AutoPlay Vehicle Display Pages
We have also made it easier on AutoPlay Vehicle Display Pages for customers to search for vehicles that have a rebate or fee applied. Listings with a Rebate or Fee will be flagged with the Clean Car Rebate/Fee banner.
There is also a search function to more easily identify the Fee/Rebate as pictured above. In addition if the Vehicle Display pages have been configured to show the Clean Car Fee inclusive fee in the price searching within the search page.
3rd Party Exports
Each export that AutoPlay sends to 3rd party channels will need to adhere to the rules of the individual listing website.
- AutoTrader - supplied to AutoTrader in the AutoPlay Data API
- Driven - supplied to Driven in the AutoPlay Data API
- Hougarden - supplied to Hougarden in the AutoPlay Data API
- Trade Me - TBC
AutoPlayAuto.com Write Up Forms
AutoPlay are making several changes to help dealers manage their Write Up Form. Each listing included within the Write Up form will have any Clean Car Rebate or Fee displayed on the listing tile to ensure the Salesperson remembers that a Fee or Rebate applies. This tile will display whether their is a Clean Car Fee, Clean Car Rebate, No Fee or Rebate Applies or when there is No Info Available.
By default the Write Up Form will not automatically calculate the Clean Car Fee as part of the Write Up calculations. However there is a role attribute on the Write Up Form role called 'Include Clean Car Fee in Write Up Calculation'.
With this role enabled when there is a Clean Car Fee a field will be added to the 'Purchase' section, and automatically added to the purchase price. Clean Car Rebates are applied for by the customer post purchase and will not be included in the calculation.
The Clean Car Fee field has been automatically added to the Default Write Up Form under the Purchase Price when the 'Include Clean Car Fee in Write Up Calculation' is enabled. In addition the Write Up Form will have notes on whether a Fee or Rebate applies as a extra reminder.
If you have a custom Write Up Form and require the Clean Car Fees to be automatically added to your purchase price please contact support@autoplay.co.nz asap to organise. We are working through Custom Write Up Forms based on the amount of usage each form receives but due to the number of customised forms and the limited time to complete this project, we cannot guarantee all the forms will be complete by 1st April. If you require your form to be prioritised please contact our support team.
In the interim the existing FEES section can be used to manually enter Clean Car Fees, and NOTES can be used to add any specific notes about the Clean Car Fee or Discounts.
A new update with the 22.6.1 June release allows users to do a Clean Car lookup that is independant of the Fuel Saver lookup so the existing listing data will not be overwritten.
Related Articles
How To Update Fuel Saver Information (NZ ONLY)
Fuel Saver data is automatically pulled through into AutoPlay when a listing is loaded with a valid Registration, VIN or Chassis No. If you load a listing without a valid VIN, Rego or Chassis you can manually retrieve this data at any time. Watch the ...Enhancements to Motorhome and Caravan listings screen
With the release of 21.3.1 AutoPlay has now enhanced the Motorhome and Caravan listings Make and Model drop down options. Make has become a Drop Down option pulling from the AutoPlay Make database. If any of your dealership models are not able to be ...How To Load Motorhome & Caravan Listings (incl Export to NZMCD)
AutoPlay can be used as the portal to get listings on to https:/www.nzmcd.co.nz. Vehicles loaded to AutoPlay for dealers signed up to NZMCD are automatically sent to the website for display. There are two ways to get Listings on to NZMCD.co.nz ...How To Manage Default Comments
Default Comments are text comments that can be automatically added to every listing in AutoPlayAuto.com in addition to any comment added to the individual listing. You can added Default Comments in several ways. 1. My Company Default Comments - Text ...AutoPlay VDP (Vehicle Display Page) Provisioning
Overview The AutoPlay VDP Pages are the next evolution from the APSR pages that are on many AutoPlay data clients websites. The VDP pages have been refreshed and modernised to offer a much more configurable experience to complement dealership ...