Supplier stock feeds

A stock feed is a read-only XML file that lists one supplier's products and how many of each you currently have on hand. You enable it, copy a URL, and send that URL to the supplier. They pull it once a night and see how their products are selling through at your store. This is useful when a brand markets in your market but doesn't sell direct there — your stock movement is their best signal.

Turning it on

Open the supplier under Purchasing → Suppliers and find the Stock feed card. Click Enable. Stokk mints a URL like:

https://<your-stokk>/api/feeds/<token>/stock.xml

Copy it and send it to your supplier contact. That's the whole setup — there is no schedule to configure. The file is built fresh each time it's pulled, so whoever fetches it always gets current numbers.

What's in the feed

For each product mapped to the supplier, the feed includes:

• vendor_code— the supplier's own article code for the product.
• product_name — the product description.
• free — total units on hand across all your locations.

The feed never includes cost, margin, or any other internal figure — only quantities.

Which products show up

Every SKU mapped to that supplier that is open for purchasing. If you close a SKU for purchasing at the warehouse (the Status toggle on the supplier's product grid, or in Inventory), it drops out of the feed. Discontinued products are excluded too.

If the URL leaks

Anyone holding the URL can read the feed, so treat it like a shared link. If it ends up somewhere it shouldn't, click Rotate token on the Stock feed card. The old URL stops working immediately — send the supplier the new one. Click Disable to switch the feed off entirely.