Nastavení firmy, které v aplikaci najdete v sekci Firma → Nastavení, 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 nastavení jak číst, tak zakládat další nastavení platné od zvoleného data i nové počáteční nastavení před tím, které už existuje.

Získání nastavení firmy

Nastavení je dostupné v XML i JSON, celý obsah získáte metodou GET s plnou úrovní detailu:

GET /c/{firma}/nastaveni.xml?detail=full

Výstup XML vypadá následovně:

<?xml version="1.0" encoding="utf-8"?>
<winstrom version="1.0">
  <!-- Nastavení -->
  <nastaveni>
    <!-- ID (celé číslo) -->
    <id>1</id>
    <!-- Poslední změna (datum a čas) -->
    <lastUpdate>2020-12-08T15:49:29.868+01:00</lastUpdate>
    <!-- Změny budou platné od data (datum) -->
    <platiOdData></platiOdData>
    <!-- Jméno (řetězec) - max. délka: 255 -->
    <nazFirmy>Demo firma</nazFirmy>
    ...
  </nastaveni>
  <nastaveni>
    <id>2</id>
    <nazFirmy>Demo firma s.r.o.</nazFirmy>
    ...
  </nastaveni>
</winstrom>

Přehled samotných platností získáte omezením detailu:

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

Nastavení jsou tedy uložena jako jednotlivé verze, podobně jako v desktopové aplikaci:

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. Ostatní neuvedené informace zůstanou totožné jako v původním nastavení.

<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 uvnitř elementu puvodniNastaveni 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>

⚠️ Datum v prvniNastaveniPlatiDoData musí předcházet platnosti stávajícího počátečního nastavení. Pokud ji přesahuje, vrátí server 400 s kódem nastaveniVytvorPrvniNastNeplatneDatum a hlášením, že datum zadaného počátečního nastavení je nekorektní.

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ží.

Související

Související články

Nastavení společnosti - API