Skip to main content

Importing records via API

How do I find out which records can be imported via API?

Written by Petr Pech

Not every record type can be written to via the API. Whether an import is supported is indicated by the importStatus field in the list of record types.


List of record types

GET /c/{firma}/evidence-list.xml

For each record type, you'll find its machine name (evidencePath), its English name, and three useful flags:

Field

Meaning

importStatus

Whether and how you can import into the record type — values below.

extIdSupported

Whether the record type supports external identifiers.

evidenceType, formCode

The record type and the form code used for print reports.


importStatus values

Value

Meaning

SUPPORTED

Import is supported and documented — for example, faktura-vydana.

NOT_DIRECT

Cannot be imported directly, only via the parent record. This applies to document items — attempting a direct import will result in the message Import není povolen.

DISALLOWED

Import is not allowed at all. These are computed views such as stav-uctu, individualni-cenik, or zurnal.

NOT_DOCUMENTED

Import is not documented. It may work, but the behavior may change.

💡 The list can be filtered like any other record type, so you can pull only those you can write to right away. You can see the same thing in the web interface at /c/{firma}/evidence-list, in the Import support column.

ℹ️ To find out which properties a given record type has, use /c/{firma}/{evidence}/properties.xml; for a list of linked record types, use /relations.xml.


Related

Did this answer your question?