Availability feed

Availability Feed provides up-to-date information about product availability.

Use the Availability Feed to update product availability and pricing without reprocessing the full Item Feed.

The Availability Feed is a lightweight alternative to the full Item Feed for high-frequency updates. Use it when updating the main Item Feed regularly is not practical because of file size, server load, or other technical limitations.

This feed lets you sync fast-changing data, such as stock status and current price, without regenerating your entire product catalog.

Use this feed to:

  • Update stock status in near real-time.
  • Reflect flash sales or price changes quickly.
  • Reduce bandwidth and processing by sending only essential fields.

Full example

<?xml version="1.0" encoding="UTF-8" ?>
<perselio_availability_feed>
    <item>
        <id>ps5-ea-sports-fc-26-standard</id>
        <available>true</available>
        <in_stock_count>24</in_stock_count>
        <in_stock_text>In stock</in_stock_text>
        <availability_text>Delivery tomorrow</availability_text>
        <shipped_in_days>1</shipped_in_days>
        <price>59.99</price>
        <price_old>69.99</price_old>
    </item>
    <item>
        <id>sku-other-product-id</id>
        <available>false</available>
        <in_stock_count>0</in_stock_count>
        <in_stock_text>Out of stock</in_stock_text>
        <availability_text>Expected in 2 weeks</availability_text>
        <shipped_in_days>14</shipped_in_days>
        <price>24.50</price>
    </item>
</perselio_availability_feed>

Minimal example

<?xml version="1.0" encoding="utf-8"?>
<items>
  <item>
    <id>>ps5-ea-sports-fc-26-standard</id>
    <available>true</available>
  </item>
  <item>
    <id>sku-other-product-id<</id>
    <available>true</available>
  </item>
</items>

Field definition

FieldRequiredDescription
idYesUnique identifier of the product. Must match the ID in the Item Feed.
availableYesBoolean value (true / false) indicating if the item is ready for purchase.
priceNoThe current selling price of the item. Use a dot as a decimal separator.
price_oldNoThe original price of the item, used to display discounts.
in_stock_countNoThe exact number of units currently available in stock.
in_stock_textNoHuman-readable stock status (e.g., "In stock", "Out of stock").
availability_textNoText describing delivery expectations (e.g., "Delivery tomorrow").
shipped_in_daysNoNumeric value representing the number of days until the product is shipped.

Technical Guidelines

  • ID Consistency: The <id> field is the primary key. If the ID in this feed does not exist in the main Item Feed, the system will not be able to apply the updates.
  • Frequency: Run this feed as often as your catalogue size and feed generation process allow. Larger catalogues usually take longer to generate and process, and we aim to provide the best possible processing speed based on your catalogue size and feed generation performance.