TL;DR?
The most important field is the asking price: sales_conditions.pricing.asking.formatted
. You must show it together with sales_conditions.pricing.asking.suffix
.
For searching use sales_conditions.pricing.asking.in_eur.amount
.
Pricing can be surprisingly complicated, especially in regions with additional tax schemes such as the Netherlands (BPM). There are quite a few things to consider when displaying a price: VAT, currency, discounts, delivery costs, other taxes, advertiser preferences, prices on request, legislation, localization, et cetera.
To make things as easy as possible, ILSA will always return the correct price to show based on your target audience.
When displaying the asking price, use these two fields:
sales_conditions.pricing.asking.formatted
. This contains the asking price, correctly formatted for the locale. For example “€ 15.000”.sales_conditions.pricing.asking.suffix
. This contains additional important information to show next to the price. For example “plus VAT” or “Margin vehicle”.
These fields will take into consideration all variables, including the audience.
If you prefer to format the price yourself, you can use the .amount
and .currency
fields.
In some cases an alternative price is available which could be of use to your visitor, for example the price excluding VAT. The corresponding fields are sales_conditions.pricing.asking.alt_formatted
and sales_conditions.pricing.asking.alt_suffix
. It is of course up to you if and how you want to display this second price.
In case the vehicle has been discounted by the advertiser, the original price is available in sales_conditions.pricing.asking.before_discount.formatted
, allowing you to show a before and after price.
Filtering on prices can be done using sales_conditions.pricing.asking.in_eur.amount
. This will again take into consideration the audience, but will make sure filtering is done in euros. In a future update ILSA will also be able to automatically convert foreign currencies.
If you need specific prices, for example to calculate a monthly price even more fields are available. For example sales_conditions.pricing.asking.business.in_eur.excl_vat.amount
.
sales_conditions.delivery_costs info
delivery_packages[].price_absolute info
delivery_packages[].price_relative info
.consumer
.general
.business
.in_eur
.in_gpb
.in_usd
.in_czk
...
.before_discount
.currency info
.formatted info
.suffix info
.amount_has_vat info
.amount_has_dutch_bpm info
.alt_formatted
.alt_suffix
.alt_amount_has_vat
.alt_amount_has_dutch_bpm
Take control yourself
.consumer
.general
.business
.in_gpb
.in_usd
.in_czk
.excl_vat
.before_discount
.formatted
Lease prices
If the vehicle is currently leased, lease_contract contains information about that contract. lease_proposals[] contains offers for which you can lease the vehicle.lease_proposals[]
.monthly_installment
.original_monthly_installment info
.over_distance_penalty
.under_distance_refund
.remaining_balance
.security_deposit
.total_price
.in_gpb
.in_usd
.in_czk
.formatted
Damage repair costs
.in_gpb
.in_usd
.in_czk
.excl_vat
.formatted
Equipment surcharges
.in_gpb
.in_usd
.in_czk
.excl_vat
.formatted
Price when new
.in_eur
.in_gpb
.in_usd
.in_czk
...
.net.amount
.net.formatted
.gross.amount
.gross.formatted
Fiscal value
.in_eur
.in_gpb
.in_usd
.in_czk
...
.gross.amount
.gross.formatted