This article covers getting product cards (not prices/stock — see Updating prices and stock for that) into the Base catalog. Building on Basic principles, here are the three concrete options.
Option 1 — XML feed import
Base can cyclically import product cards from an XML feed in the Heureka or Shoptet specification. On request, we can also read custom elements from such a feed, but this currently has to be configured on our side — contact the implementation team.
- Import frequency: typically once a day, up to three times a day for enterprise accounts.
- Downside: in this mode you have no write-side API methods — the feed content drives everything.
Option 2 — fully via API
If you want to control product creation and updates programmatically, use addInventoryProduct. Sending a product with an existing ID updates that card, so the same method handles both creation and updates.
Before creating a product, you need the category and manufacturer IDs (see Categories, manufacturers and tags) — both are set on the product as a reference to an existing ID, not as text.
Hybrid option — feed for cards, API just for Base IDs
If you create cards via a feed/e-commerce integration but want to continuously retrieve the internal Base IDs of newly created products (e.g. to hook your own stock sync onto them), use getInventoryProductLogs — it returns a log of events for products (and their variants) in the catalog, including newly assigned IDs.
Sync frequency
| Data type | Typical frequency |
|---|
| Product card import/update (feed) | ~1×/day (up to 3× for enterprise) |
| Price and stock updates | ~4–5×/hour |
If you also need to sync delivery times, or have a specific requirement for the feed structure, contact the implementation team — we already have approaches worked out for that.