Skip to main content

Price Effective Date & Price Date Role (ONIX only)

Virginie Bouilhac
Updated

Definition

Price Effective Date (ONIX 2.1) and Price Date Role (ONIX 3.0) composites allow you to schedule promotional prices with your ONIX feed.
--> Required field.

Best Practice

Rakuten Kobo supports the three price method:

  • Ensure your starting regular price has an end date. Otherwise, our system won’t know to look for a new price.
  • Ensure the promo price has both a start and end date.
  • Ensure your regular price is reinstated by including a new start date. All dates are inclusive: they start at 0:00 and end at 23:59 EST of the specified start and end dates.

Correct Usage (example)

Example of a sample scheduled price reduction, with embedded comments for clarification:

ONIX 2.1 example (with embedded notes for clarification):

<price>
    <j148>41</j148>
    <j151>7.99</j151>
    <j152>USD</j152>
    <j162>20151222</j162>
</price>
<!-- the above price will end at 23:59 EST on Dec 22 -->
<price>
    <j148>41</j148>
    <j151>3.99</j151>
    <j152>USD</j152>
    <j161>20151223</j161>
    <j162>20151230</j162>
</price>
<!-- the promo price starts at 0:00 EST Dec 23 and ends 23:59 EST Dec 30 -->
<price>
    <j148>41</j148>
    <j151>7.99</j151>
    <j152>USD</j152>
    <j161>20151231</j161>
</price>
<!-- the regular price is reinstated at 0:00 EST Dec 31
Onix 3.0 uses the PriceDateRole tags where
PriceDateRole 14 = From Date and PriceDateRole 15 = Until Date -->
<Price>
    <PriceType>01</PriceType>
    <PriceAmount>10.00</PriceAmount>
    <CurrencyCode>USD</CurrencyCode>
    <PriceDate>
        <PriceDateRole>15</PriceDateRole>
        <Date>20151221</Date>
    </PriceDate>
</Price>
<!-- the above price will end at 23:59 EST on Dec 21 -->
<Price>
    <PriceType>01</PriceType>
    <PriceAmount>8.00</PriceAmount>
    <CurrencyCode>USD</CurrencyCode>
    <PriceDate>
        <PriceDateRole>14</PriceDateRole>
        <Date>20151222</Date>
    </PriceDate>
    <PriceDate>
        <PriceDateRole>15</PriceDateRole>
        <Date>20151230</Date>
    </PriceDate>
</Price>
<!-- the promo price starts at 0:00 EST on Dec 22 and ends 23:59 EST Dec 30 -->
<Price>
    <PriceType>01</PriceType>
    <PriceAmount>10.00</PriceAmount>
    <CurrencyCode>USD</CurrencyCode>
    <PriceDate>
        <PriceDateRole>14</PriceDateRole>
        <Date>20151231</Date>
    </PriceDate>
</Price>
<!--the regular price is reinstated at 0:00 EST on Dec 31 -->

Related articles