Guides

A machine-readable price list: CSV, XML or JSON and what goes in it

How to publish a webshop price list a machine can read: which format, which columns, what address and why a daily export with an archive beats a one-off spreadsheet.

Published: September 21, 2026

WooCommerce pluginA daily price list at a permanent addressCSV, XML and JSON, a per-day archive and a machine-readable index. Part of the same plugin.Open

What machine-readable means

Machine-readable does not mean digital. A PDF price list is digital and useless to a machine: extracting a price means guessing where the columns are.

Machine-readable means every field has a name and a fixed place, and numbers are numbers. In practice that is CSV, XML and JSON.

Which columns make sense

The minimum is item identity and price, but a price list that actually gets used usually carries more:

  • The item code, ideally the same one used in the ERP, and a barcode if one exists.
  • Name and category, because whoever reads the list rarely also has your catalogue.
  • Price with and without tax, so nobody has to guess which is which, plus a currency code.
  • A flag for whether the item is discounted, and the 30-day low where it exists.
  • The item's address in the store, so any row can be checked in one click.

Why a daily export rather than a one-off file

A price list exported by hand goes stale the same day, and whoever received it has no way to know. A daily export at a permanent address solves both.

A per-day archive adds what you do not notice until you need it: the ability to show later what cost what on which day.

What to watch for in CSV

Two things usually break a Croatian CSV: the field separator, and a decimal comma combined with that same separator, which quietly turns one thousand two hundred into one point two.

So in a machine-facing price list numbers use a decimal point and no thousands separator, fields are separated by semicolons, and the encoding is UTF-8.

Frequently asked questions

Is publishing a PDF enough?
For reading by eye yes, for processing no. A PDF forces retyping or guesswork, and both introduce errors.
Does the price list have to be public?
It depends on the purpose. A buyer-facing list makes sense public; one agreed with a single supplier can sit at an unpublished address.
How often should it refresh?
Once a day covers most needs. Stores changing prices several times a day export more often, but then the file must never be served while it is being written.

Get compliant in 15 minutes

Fiskalizator issues fiscal receipts (JIR/ZKI) and e-invoices - for Shopify, WooCommerce or manually. 14-day free trial.

Tell us what you need. Within 24 hours you get a rough price and timeline.

A few sentences are enough: what you sell, which ERP you use and what costs you the most time today. If it is urgent, call.

Weekdays, 9 to 17. We reply within 24 hours.

We reply within 24 hours. Your details reach us only and are not used for anything else.