Documentation
Publishing and public URLs
When lists are published, where files live and how to serve them from your own domain.
When
- Products: every morning before 07:00 (Sidro first pulls changes from WooCommerce, Shopify or the feed). The legal deadline is 08:00.
- Services: right after every price change in Sidro.
- Manually: Publish now or
POST /api/v1/publish. - Fallback: if the daily run is late for any reason, the first request for a public file after midnight triggers it; the morning check retries once more and alerts you if the list is still missing.
Public URLs
All public, no login, CORS enabled — made for automated retrieval (item VII).
| URL | Content |
|---|---|
/c/{code} |
page with all outlets’ price lists and the archive |
/c/{code}/index.json, index.xml |
machine index of outlets and all files (with SHA-256) |
/c/{code}/{outlet}/latest.csv, latest.xml |
latest publication (stable URL) |
/c/{code}/{outlet}/{NAME}.csv, .xml |
a specific publication — never changes |
/c/{code}/{outlet}/uzivo.csv, .xml, .json |
real-time prices (at most one minute old) |
Archive
Files stay public for at least 35 days (the law requires 30), longer on paid plans. After expiry the file is deleted; the publication record (time, item count, checksum) stays in the audit.
Link from your website
The regulation requires publishing on your website. At minimum, a “Cjenici” link in the footer to the public page:
<a href="https://sidro-cjenici.vercel.app/c/your-code" aria-label="Price lists (CSV and XML)">Cjenici</a>
Files on your own domain
To serve the files from your own domain (https://yourshop.hr/cjenici/…), proxy the path to Sidro. The WooCommerce plugin does this for you. Otherwise:
nginx
location /cjenici/ {
proxy_pass https://sidro-cjenici.vercel.app/c/your-code/;
proxy_set_header Host sidro-cjenici.vercel.app;
proxy_ssl_server_name on;
}
Next.js
module.exports = { async rewrites() { return [{ source: '/cjenici/:path*', destination: 'https://sidro-cjenici.vercel.app/c/your-code/:path*' }]; } };
Vercel
{ "rewrites": [{ "source": "/cjenici/:path*", "destination": "https://sidro-cjenici.vercel.app/c/your-code/:path*" }] }
Netlify (_redirects)
/cjenici/* https://sidro-cjenici.vercel.app/c/your-code/:splat 200
Apache and Cloudflare Worker examples are in the Croatian version of this page.