Přes REST API je možné i zakládat firmy či obnovovat ze zálohy.
PUT /admin/zalozeni-firmy
Parametry zakládání
| Název nově zakládané firmy |
| Nově založená firma má být naplněna demo daty (pouze u některých typů organizací — viz níže) |
| Legislativa nově založené společnosti (viz níže) |
| Typ organizace nově založené společnosti (viz níže) |
| IČO společnosti, které má být použito pro základní nastavení (plátce DPH, sídlo, spisová značka, …) |
| Daňové identifikační číslo společnosti |
Povinným údajem je pouze name. Pokud nevyhovují výchozí hodnoty, je třeba uvést i country a org-type. Pokud je uvedeno i ic, při zakládání firmy se doplní některé další údaje z ARESu.
⚠️ Jako obvykle pozor na to, že hodnoty musí být v URL správně zakódovány. Znak + je součástí kódu typu organizace, není to oddělovač.
Odpověď v případě úspěšně založené firmy je 201 a URL firmy v hlavičce Location.
Podporované země a typy organizací
country | org-type | Popis | Demo data |
|
| Podnikatelé – podvojné účetnictví | ano |
|
| Podnikatelé – daňová evidence | ano |
|
| Příspěvkové organizace | ne |
|
| Neziskové organizace | ne |
|
| Podnikatelé – podvojné účetnictví | ano |
|
| Podnikatelé – jednoduché účetnictví | ne |
Seznam dostupných organizací
Seznam podporovaných států a typů organizací, které daná instalace zná, získáte takto:
GET /admin/organization-type-list.xml
⚠️ Uveďte příponu .xml (nebo .json), případně pošlete hlavičku Accept. Bez toho volání skončí chybou 404.
Ukázka jednoho záznamu z výstupu:
<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>
Hodnotu z country-code použijete jako parametr country, hodnotu z unique-code jako org-type. Podle příznaku demo poznáte, u kterých typů organizací lze použít use-demo=true.