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.

Overview
Below are schematic versions of the available price fields. Note that not all combinations exist.
Base field
sales_conditions.pricing.asking
sales_conditions.delivery_costs
delivery_packages[].price_absolute
delivery_packages[].price_relative
Audience
(empty)
.consumer
.general
.business
Currency
(empty)
.in_eur
.in_gpb
.in_usd
.in_czk
...
Discounted
(empty)
.before_discount
Details field
.amount
.currency
.formatted
.suffix
.amount_has_vat
.amount_has_dutch_bpm

Alternative price
.alt_amount
.alt_formatted
.alt_suffix
.alt_amount_has_vat
.alt_amount_has_dutch_bpm
Take control yourself
Type
sales_conditions.pricing.asking
Audience
(empty)
.consumer
.general
.business
Currency
.in_eur
.in_gpb
.in_usd
.in_czk
VAT
.incl_vat
.excl_vat
Discount
(empty)
.before_discount
Field
.amount
.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.
Base field
lease_contract
lease_proposals[]
Lease field
.down_payment
.monthly_installment
.original_monthly_installment
.over_distance_penalty
.under_distance_refund
.remaining_balance
.security_deposit
.total_price
Currency
.in_eur
.in_gpb
.in_usd
.in_czk
Details field
.amount
.formatted
Damage repair costs
Base field
condition.damage.repair_costs
Currency
.in_eur
.in_gpb
.in_usd
.in_czk
VAT
.incl_vat
.excl_vat
Details field
.amount
.formatted
Equipment surcharges
Base field
equipment[].surcharge
Currency
.in_eur
.in_gpb
.in_usd
.in_czk
VAT
.incl_vat
.excl_vat
Details field
.amount
.formatted
Price when new
Base field
sales_conditions.pricing.new
Currency
(empty)
.in_eur
.in_gpb
.in_usd
.in_czk
...
Details field
.currency
.net.amount
.net.formatted
.gross.amount
.gross.formatted
Fiscal value
Base field
sales_conditions.pricing.fiscal_value
Currency
(empty)
.in_eur
.in_gpb
.in_usd
.in_czk
...
Details field
.currency
.gross.amount
.gross.formatted