Přeskočit na hlavní obsah

Nastavení společnosti - API

Jak přes REST API vytvořit nové nastavení firmy platné od určitého data, případně nové počáteční nastavení před tím existujícím.

Autor: Petr Pech

Nastavení firmy je v ABRA Flexi vedeno po časových platnostech — každý záznam evidence nastaveni platí od určitého data. Přes REST API lze zakládat jak další nastavení platné od zvoleného data, tak nové počáteční nastavení před tím, které už existuje.

Přehled existujících platností získáte běžným výpisem evidence:

GET /c/{firma}/nastaveni.xml?detail=custom:platiOdData


Nové nastavení platné od určitého data

Pokud vytváříme nové nastavení platné od určitého data, je potřeba uvést původní nastavení, ze kterého má nové nastavení vycházet. Slouží k tomu vlastnost puvodniNastaveni.

<winstrom version="1.0"> 
<nastaveni>
<puvodniNastaveni>
<id>1</id>
</puvodniNastaveni>
<platiOdData>2026-12-29</platiOdData>
<uliceNazev>Přestěhovaná</uliceNazev>
<!-- Další vlastnosti evidence "nastaveni", které chceme uložit. -->
</nastaveni>
</winstrom>

Požadavek pošlete metodou PUT nebo POST na /c/{firma}/nastaveni.xml.


Počáteční (první) nastavení

Chceme-li vytvořit počáteční nastavení firmy před již existujícím počátečním nastavením, je potřeba uvést další dvě vlastnosti:

Vlastnost

Význam

prvniNastaveni

Příznak, že vytváříme první nastavení. Hodnota true.

prvniNastaveniPlatiDoData

Datum, do kdy má toto nastavení platit. Bude automaticky nastaven již existujícímu počátečnímu nastavení jako platiOdData.

<winstrom version="1.0"> 
<nastaveni>
<puvodniNastaveni>
<id>1</id>
<prvniNastaveni>true</prvniNastaveni>
<prvniNastaveniPlatiDoData>2026-12-22</prvniNastaveniPlatiDoData>
</puvodniNastaveni>
<!-- Vlastnosti evidence "nastaveni", které chceme uložit. -->
</nastaveni>
</winstrom>


Na co si dát pozor

⚠️ Vlastnosti puvodniNastaveni, prvniNastaveni a prvniNastaveniPlatiDoData slouží pouze pro import — v seznamu polí evidence (/c/{firma}/nastaveni/properties) je nenajdete a při exportu se nevracejí.

💡 Než požadavek pošlete naostro, vyzkoušejte si ho v režimu testovacího uložení doplněním parametru ?dry-run=true. Server data zvaliduje, ale nic neuloží.

Dostali jste odpověď na svou otázku?