Skip to main content

price

Required Field

This field is required and must not be omitted

Description​

Use this attribute to tell customers what you charge for your product. A price can be overridden by a sale_price during a given time period using sale_price_effective_date or it may be complemented for members by using member_price.

Validation Rules​

  • Must be a number (value) followed by a space and a currency (unit)
  • Number may have two decimals, separated by a . (dot)
  • Currency must be three upper case characters and a valid ISO 4217 currency
  • Zero prices are not allowed

Best Practices​

Do​

  • Price sent in feed should be the same as the price value on your product page
  • Currency sent in feed should match currency on your product page

Don´t​

  • Do not include extra charges in the cost (such as shipping cost)
  • Do not use thousand separators or similar in the value (while we may handle some of these cases we recommend you to just send plain numbers like 10000.50 SEK)

Example Values​

Here are examples of how a valid price value should look like in XML and CSV (with header) respectively.

Valid Value
<g:price>99.99 SEK</g:price>
Click to show more valid XML examples
<g:price>99.99 SEK</g:price>
<g:price>100 SEK</g:price>
<g:price>SEK 100</g:price>
<g:price>99,99 SEK</g:price>
<g:price>10,000.00 SEK</g:price>
<g:price>10 000.00 SEK</g:price>
<g:price>10.000 SEK</g:price>
<g:price>1.144.000 SEK</g:price>

Error Codes​

Below you will find possible error codes generated when validating this field alongside with an example in XML and CSV that would trigger the code. Please refer to the validation rules to understand the cause.

validation_missing_currency
<g:price>100$</g:price>
validation_missing_price_value
<g:price>SEK</g:price>
validation_missing_value
<g:price></g:price>
validation_not_number
<g:price>10.0.00.00 SEK</g:price>
<g:price>10.0.00.00 SEK</g:price>
<g:price>foo SEK</g:price>
validation_not_positive_number
<g:price>-10 SEK</g:price>
<g:price>0 SEK</g:price>
validation_price_out_of_range
<g:price>1000000000 SEK</g:price>
validation_unknown_currency
<g:price>$100</g:price>

Properties​

PropertyValueDescription
Data TypepriceClosest data type in code
NestedFalseDefines if this field consists of one or more sub-fields
Case SensitiveFalseIf small or large letters matter for this field
RepeatableFalseIf you can supply multiple items of this field (it´s a list)
Repeatable limit0If a list, this specifices the max number of items

Changelog​

📅 2022-12-07

Added

Initial definition

References​