Okazje.info feed for Shopify

Okazje reads one XML file from a hosted URL. You hand the address over once (by e-mail to integracja@okazje.info.pl or in the Panel Sprzedawcy's Integracja section), and Okazje confirms the start of the integration by e-mail. The file's root is a bare <okazje> wrapping <offers>, with one <offer> per variant.

The PDF allows ISO-8859-2, UTF-8 or Windows-1250; the template declares and emits UTF-8. It states no download cadence and no item or size caps. Feedflock hosts the file on a stable URL and regenerates it every hour, so whenever Okazje fetches it, it reads current prices and stock.

Okazje wants every variant as a separate offer with its own id, and the id is load-bearing: a duplicate reads only one of the offers, and a changed id re-points the listing to another product. The template uses the Shopify variant ID, which never changes and is never reused. The URL has the same rule: unique per offer including variants, which is why the default deep-links with ?variant=.

Variant detail travels in attributes: colour variants must carry Kolor, and sizes go in Rozmiar. The PDF shows several sizes joined with a semicolon in one value, while the template sends one offer per size with a single value. For fashion, the PDF asks for the brand at the start of the offer name and the manufacturer code at its end, and a category path that carries the gender.

The price is the gross selling price in PLN as a bare number: grosze separated by a dot or a comma, no digit grouping, no unit. The PDF names 8.200.45, 8 200.45 and 8200.45 zł as errors. The template renders the Shopify variant price straight through, so none of these can occur.

A promotion is two elements, not one: old_price carries the pre-markdown price and marks the offer as promotional, and min_price_30d (the Omnibus lowest price of the 30 days before the markdown) becomes required the moment old_price is present; without it the offer is not labelled Promocja. The template fires both on the same condition, so they never drift apart. One honest caveat: by default min_price_30d falls back to the compare-at price, which is a "was" price, not a measured 30-day minimum, so keep the real minimum in the custom.min_price_30d metafield if you have it.

Okazje's failure mode is silent non-display: nothing rejects the file, the offer just never shows. An offer without a description is absent from search results, one without a producer is not displayed at all, and one without an image is not displayed either. The template marks all of these required, and the readiness check lists any that resolve empty.

The category is your shop's own path, with any separator, as Okazje publishes no tree of its own. Precision matters: general buckets such as Promocje, Pozostałe, Akcesoria, Wyprzedaż, Główna or Home make correct assignment impossible and keep the offer off the site. And logistics stay deliberately thin: the feed carries no delivery price, carrier or COD, only the required weight, in kilograms with the unit, from which Okazje estimates an approximate delivery cost.