Cez REST API je možné aj zakladať firmy či obnovovať zo zálohy.
PUT /admin/zalozeni-firmy
Parametre zakladania
| Názov novo zakladanej firmy |
| Novo založená firma má byť naplnená demo dátami (iba pri niektorých typoch organizácií — pozri nižšie) |
| Legislatíva novo založenej spoločnosti (pozri nižšie) |
| Typ organizácie novo založenej spoločnosti (pozri nižšie) |
| IČO spoločnosti, ktoré má byť použité na základné nastavenie (platiteľ DPH, sídlo, spisová značka, …) |
| Daňové identifikačné číslo spoločnosti |
Povinným údajom je iba name. Ak nevyhovujú predvolené hodnoty, treba uviesť aj country a org-type. Ak je uvedené aj ic, pri zakladaní firmy sa doplnia niektoré ďalšie údaje z ARES-u.
⚠️ Ako obvykle, pozor na to, že hodnoty musia byť v URL správne zakódované. Znak + je súčasťou kódu typu organizácie, nie je to oddeľovač.
Odpoveď v prípade úspešne založenej firmy je 201 a URL firmy v hlavičke Location.
Podporované krajiny a typy organizácií
country | org-type | Popis | Demo dáta |
|
| Podnikatelia – podvojné účtovníctvo | áno |
|
| Podnikatelia – daňová evidencia | áno |
|
| Príspevkové organizácie | nie |
|
| Neziskové organizácie | nie |
|
| Podnikatelia – podvojné účtovníctvo | áno |
|
| Podnikatelia – jednoduché účtovníctvo | nie |
Zoznam dostupných organizácií
Zoznam podporovaných štátov a typov organizácií, ktoré daná inštalácia pozná, získate takto:
GET /admin/organization-type-list.xml
⚠️ Uveďte príponu .xml (alebo .json), prípadne pošlite hlavičku Accept. Bez toho volanie skončí chybou 404.
Ukážka jedného 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 ako parameter country, hodnotu z unique-code ako org-type. Podľa príznaku demo zistíte, pri ktorých typoch organizácií je možné použiť use-demo=true.