Sidroprice lists

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.

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.