This feed enables you to manage searchable items within a specific context (store, seller, etc.) and also make vary information regarding this context, including:
- prices
- promotions
- availability
- context-specific attributes
Definition of an Offer
An offer (searchable item) is defined as:
id (from catalog feed) + store_code
item_idmust match the catalog feed SKU (id)store_codedefines the context (website contexte, physical or virtual store, marketplace seller, etc.)
Make sure to only provide offers for items provided in your catalog feed.
Front-end Context Requirement
The store_code must be accessible on your website via:
- Cookie
- JavaScript function
- Variable
- Data Layer
➡️ This allows Sensefuel to synchronize search results with the correct context
If you integrate Sensefuel with our API make sure to provide in each API query the "store_id" parameter.
Example for a search query :
POST https://api.sensefuel.live/discovery/96cd2378-sample-1-b92af0700c54/search
{
"query" : {
"terms" : {
"expression" : "sneakers"
},
"store_id": "dummySeller"
}
//[...]
}Supported Formats
CSV / Text Format
- Encoding: UTF-8 or Latin1
- Separator:
|(pipe) recommended - Should use double quotes for all attributes and values
- Multi-values:
- Allowed for all additional attributes
- Feed is extensible (custom attributes allowed)
- Attribute names must not contain spaces
⚠️ Important:
If your catalog feed is in CSV/Text → local inventory feed must also be CSV/Text
XML Format
- Encoding: UTF-8
- Supported:
- RSS 2.0
- RSS 1.0
- Atom 1.0
Best Practices:
- Use
<![CDATA[value]]>when needed - No empty CDATA
- Multi-values:
- Use repeated tags or eventually within the same tag values separated by a coma.
- Feed is extensible (custom attributes allowed)
- Attribute names must not contain spaces
⚠️ Important:
If your catalog feed is in XML → local inventory feed must also be XML
| Attribute | Criticality | Sensefuel specification or annotations |
| id | Mandatory | Use the product’s SKU (id). Must be a unique value for each product. Maximum 50 characters |
| store_code | Mandatory | Alphanumeric. Thi store code information must be identical with the one provided in API call or available in your website via a cookie, a JavaScript function, a variable or a dataLayer, so Sensefuel can synchronize results with that context. |
| availability | Mandatory | Values allowed : “in stock” "in_stock" and “out of stock” "out_of_stock" out of stock products will be automatically buried in the ranking |
| price | Mandatory | Numeric data only. Currency must be included (ISO 4217). |
| sale_price | Optional | Would be mandatory if the product is discounted in that context (store_code). Sale_price cannot be higher than the price. Numeric data only. Currency must be included (ISO 4217) |