Document copy, printed reports and QR codes

Copying a document

The server can copy a document directly (more efficient and reliable than loading the full record client-side and re-inserting it) — via the sourceId attribute on the new element:

XML

JSON

<winstrom version="1.0">
  <skladovy-pohyb sourceId="1179">
    <datVyst>2022-09-11</datVyst>
  </skladovy-pohyb>
</winstrom>
{
    "winstrom": {
        "skladovy-pohyb": [
            {
                "@sourceId": "1179",
                "datVyst": "2022-09-11"
            }
        ]
    }
}

sourceId is the id of the record to copy; any other fields given (here datVyst) override the copy’s values. A non-existent sourceId returns 400 with code NOT-FOUND.

If the new record’s identifier is given, the call is idempotent — repeating it updates the existing record instead of creating another copy. Without an id (or if it does not exist yet), a copy of sourceId is created. Verify with ?dry-run=true first — the <content /> shows what would be saved.

Printed report export (PDF / XLSX)

There is no print dialog via the API — only the generated output itself.

/c/<company>/<evidence>.pdf                     — report over the whole listing
/c/<company>/<evidence>/<ID>.pdf                 — report for one record
/c/<company>/<evidence>.xls
/c/<company>/<evidence>/<ID>.xls

Specific report: ?report-name=.... Report language: ?report-lang= (cs, sk, en, de). Electronic signature (requires exactly one certificate stored in AbraFlexi): ?report-sign=true.

/c/company/faktura-vydana/1.pdf?report-name=dodaciList
/c/company/faktura-vydana/1.pdf?report-name=dodaciList&report-lang=en
/c/company/faktura-vydana/1.pdf?report-name=dodaciList&report-sign=true

Discover a given evidence’s supported reports: GET /c/{company}/{evidence}/reports — output includes reportId (value to use for report-name), reportName (localized name), isDefault, predvybranyPocet (1 or N — single-record vs. overview report), rozsiritelna (does an extended version exist?), sumovana (supports summation?).

Warning

An unknown report-name returns 500 with Report '…' can't be found — not an empty PDF. Always take the value from the reports list.

ISDOC.PDF format: PDF outputs of invoices (non-listing type) implicitly embed the ISDOC document, which can be used to re-import invoices from ISDOC.

QR code

A standard approved by the Czech Banking Association, readable by most Czech banks’ mobile apps directly from a screen. Supported for both issued documents (payment TO the company) and received documents (payment BY the company); CZ payments only (any currency).

GET /c/<company>/<evidence>/<ID>/qrcode.png?size=200

size is 1–1500 px; the server adds a quiet-zone margin for clean black/white contrast.