Ostuklikk XML lets you import our products, Estonian product texts, images, prices and stock levels into your online store. To request access, email info@ostuklikk.ee with your company name, store URL and preferred warehouse feed.
1. Choose a warehouse feed
| Feed | Contents |
|---|---|
| Local warehouse | Products available in our Malda warehouse. Shopify location name: Local warehouse. |
| Supplier warehouses | Products in other warehouses. Delivery generally takes 8–18 working days. |
| All warehouses | Local and supplier stock combined, with separate quantities and a breakdown by location. |
Do not import the same product twice from multiple feeds. In the combined feed, distinguish local and supplier delivery information. Do not present supplier delivery times as a promise of dispatch from local stock.
2. Add your personal XML URL to your importer
Each partner receives personal URLs for their permitted feeds. Add the URL as a data source in your store's importer. The product record path is products/product. The URL contains an access key: keep it private and do not publish it on a website. Request a replacement if the key is exposed.
3. Map the data fields
| XML field | Purpose |
|---|---|
| variant_id | Recommended stable import identifier. Use it to match products imported from Ostuklikk only. |
| product_id, sku, barcode | Product identifier, SKU and barcode. If matching by SKU, check for empty or duplicate values. |
| title, description_html | Name and HTML description. Estonian translations are preferred; the original text is used if a translation is missing. |
| vendor, product_type | Vendor and product type. Product type is not a complete category hierarchy. |
| price | Shopify variant selling price in EUR, including VAT. This follows the existing XML pricing logic; no reseller discount or additional VAT is applied. |
| compare_at_price | Shopify comparison price, if available. This is not the partner purchase price. |
| stock | Available quantity in the selected feed. In the combined feed, this is the sum of local and supplier stock. |
| local_stock, supplier_stock | Stock breakdown in the combined feed. local_stock is 0 in the supplier feed. These extra fields are absent from the local feed. |
| warehouses/warehouse | Location identifiers, names, quantities and types in the supplier and combined feeds. |
| supplier_delivery_min_workdays, supplier_delivery_max_workdays | Supplier delivery range: 8–18 working days. |
| weight, weight_unit, weight_grams | Original weight and unit, plus weight in grams. Missing weights are not replaced with estimates. |
| image, images/image | Main image and up to the first 20 product gallery images. |
| product_url | Link to the Estonian product page on Ostuklikk. |
4. Schedule automatic imports
Ostuklikk normally starts updating data every 30 minutes; large datasets or errors may delay completion. Schedule your store's importer to run at least every 30 minutes as well. These are separate schedules, so changes may not reach your store immediately after our update finishes. The XML root attribute generated_at records the generation start time in UTC.
Update prices and quantities on every import. Whether to update descriptions and images depends on whether you want to preserve your own edits.
5. Set stock to zero for products missing from the feed
If an HTTP error, timeout, invalid XML or incomplete XML occurs, abort the import and retain existing data. An error does not mean an empty catalogue. Even for a valid empty feed, verify completeness before setting all quantities to zero. If your importer does not support handling missing products, implement this before enabling automatic sales.
6. Run a test import
Use a small product sample to check prices, quantities, images, special characters, variants and delivery information. Check the missing-product stock settings too. Shopify and WooCommerce require a suitable XML import app or integration; the exact settings depend on the software used.
Errors and access
401: the key is invalid, access is suspended or the feed is not permitted for this partner. 503: the XML is not ready, temporarily unavailable or the last successful dataset is more than three hours old. Retry later and do not reset stock based on this error. This system's access key does not grant access to Shopify administration or orders.
Questions: info@ostuklikk.ee.
Ostuklikk partner administration
Partner administration – sign in. This area is for the Ostuklikk administrator and requires the admin password. Resellers receive their personal XML URLs from Ostuklikk.