Skip to main content

sale_price_effective_date

Optional Field

This field is optional, but omitting it may leave out functionality on Prisjakt for your offers

Description​

Datetime range indicating when sale_price is active. If you don't submit this attribute sale_price always applies.

Effects When Used​

  • This will cause sale_price to be applied only within interval specified by start and end datetime

Validation Rules​

  • Standard: ISO 8601
  • Up to 51 characters
  • Two dates separated with "/" (ISO 8601)
  • Start and end must be within one year from current date

Best Practices​

Do​

  • Start datetime shall be earlier than stop datetime

Don´t​

  • If you don't include time, start time default to 12 AM CET (midnight) of start day and stop time is set to 23:59:59 of stop day
  • Don't set start or end datetime further than one year in the future. This will cause warning in feed validation. Moreover sale_price_effective_date and sale_price won't be used in product listing.

Example Values​

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

Valid Value
<g:sale_price_effective_date>2016-02-24T13:00:00-08:00/2016-02-29T15:30:00+02:00</g:sale_price_effective_date>
<g:sale_price>11.50 SEK</g:sale_price>
Click to show more valid XML examples
<g:sale_price_effective_date>2016-02-24T13:00:00-08:00/2016-02-29T15:30:00+02:00</g:sale_price_effective_date>
<g:sale_price>11.50 SEK</g:sale_price>
<g:sale_price_effective_date></g:sale_price_effective_date>
<g:sale_price>11.50 SEK</g:sale_price>
<g:sale_price_effective_date>2016-02-24/2016-02-26</g:sale_price_effective_date>
<g:sale_price>11.50 SEK</g:sale_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_date_out_of_range
<g:sale_price_effective_date>2050-02-05/2050-02-05</g:sale_price_effective_date>
validation_invalid_format
<g:sale_price_effective_date>2018/2016-02-29</g:sale_price_effective_date>
<g:sale_price></g:sale_price>
validation_missing_value
<g:sale_price_effective_date>2016-02-29T15:30-0800</g:sale_price_effective_date>
<g:sale_price>11.50 GBP</g:sale_price>

Properties​

PropertyValueDescription
Data TypestringClosest 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​

📅 2023-04-06

Added

Start and end are limited to one year from current datetime

📅 2022-12-07

Added

Initial definition

References​