Via the REST API you can also create companies or restore from a backup.
PUT /admin/zalozeni-firmy
Creation parameters
| Name of the newly created company |
| Whether the newly created company should be populated with demo data (only for certain organization types — see below) |
| Legislation of the newly created company (see below) |
| Organization type of the newly created company (see below) |
| Company registration number (IČO) to be used for the basic setup (VAT payer status, registered office, file reference, …) |
| Company's tax identification number |
The only required field is name. If the default values don't suit your needs, you also need to specify country and org-type. If ic is also specified, some additional data will be filled in from the ARES registry when the company is created.
⚠️ As usual, make sure the values are correctly encoded in the URL. The + character is part of the organization type code, not a separator.
If the company is created successfully, the response is 201 and the company's URL is in the Location header.
Supported countries and organization types
country | org-type | Description | Demo data |
|
| Businesses — double-entry bookkeeping | yes |
|
| Businesses — tax records (simple bookkeeping) | yes |
|
| Contributory organizations | no |
|
| Non-profit organizations | no |
|
| Businesses — double-entry bookkeeping | yes |
|
| Businesses — single-entry bookkeeping | no |
List of available organizations
You can get a list of supported countries and organization types recognized by a given installation as follows:
GET /admin/organization-type-list.xml
⚠️ Specify the extension .xml (or .json), or send the Accept header. Without this, the call will fail with error 404.
Example of a single record from the output:
<organization-type>
<country-code>CZ</country-code>
<double-entry-bookkeeping>true</double-entry-bookkeeping>
<demo>true</demo>
<country>Česká republika</country>
<description>Společnosti s ručením omezeným, akciové společnosti, veřejné obchodní společnosti, komanditní společnost a fyzické osoby vedoucí účetnictví.</description>
<label>Podnikatelé - podvojné účetnictví</label>
<unique-code>PODNIKATELE+PU</unique-code>
<vat-payer-changeable>true</vat-payer-changeable>
</organization-type>
Use the value from country-code as the country parameter, and the value from unique-code as org-type. The demo flag indicates for which organization types use-demo=true can be used.