The Datasource described on this page is an illustrative example. The actual fields, structure, and naming will vary based on your brand’s specific data model and integration. Use this as a reference for the type of data needed, not as an exact specification.
Overview
The Stock & Availability Datasource provides real-time inventory data: stock levels per product per location, availability status, restock dates, and low-stock indicators. This ensures personalised recommendations never display out-of-stock products and enables location-specific “available at your store” messaging.
Key Fields
| Field | Type | Description | Example values |
|---|
product_id | String | Product/SKU identifier | "SKU-12345" |
store_id | String | Store or warehouse location | "STR-PARIS-MARAIS" |
quantity_available | Integer | Current stock level | 3 |
in_stock | Boolean | Whether available for purchase | true |
low_stock | Boolean | Below threshold (creates urgency) | true |
restock_date | Date | Expected restock date (if out of stock) | 2024-12-01 |
available_online | Boolean | Available for web/app purchase | true |
available_in_store | Boolean | Available for in-store pickup | true |
size_availability | Object | Stock by size/variant | {"38": 2, "39": 0, "40": 5} |
Connected Use Cases
| Use Case | How Stock is used |
|---|
| Enriched Product Recommendation | Filter out-of-stock, prioritise available products |
| Drive to Store / Web / App | ”Available at your store” or “Order online” logic |
| 1:1 Personalised Digest | Real-time product availability in recommendations |
Data Requirements
| Requirement | Details |
|---|
| Update frequency | Real-time or hourly (stock changes frequently) |
| Minimum fields | product_id, in_stock |
| Recommended fields | All listed above for location-specific availability |
| Format | JSON via Datasources API |
| Volume | One record per product × location combination |
Integration Notes
Stock data is sourced from the brand’s ERP, OMS, or inventory management system. Key considerations:
- Freshness is critical: A recommended out-of-stock product is a negative customer experience
- Size/variant availability enables personalised messaging (“Your size is back in stock!”)
- Low-stock indicators enable urgency messaging (“Only 2 left in your size”)
Stock data must be refreshed frequently. If your stock update frequency is longer than 24 hours, consider disabling stock-based filtering to avoid showing products that sold out overnight.
