Formáty exportu

Tady popisujeme soubory, které si z cifra stáhnete: export všech dat jedním souborem ZIP, rozpočet jako CSV, dokumenty PDF a originály — jejich strukturu, kódování a formát čísel a dat. Tentýž popis je v souboru README.txt v každém exportu.

Export všech dat jedním souborem ZIP

Vlastník účtu stáhne všechna data firmy v Nastavení → Export dat jako jeden soubor cifro-export-[adresa firmy]-[RRRR-MM-DD].zip (čl. 16 obchodních podmínek). Export je zdarma, nejvýše 5 exportů za hodinu. Funguje i po skončení zkušebního období, při pozastavení, dokud vlastník nepřijme nové podmínky, a ještě 30 dní po skončení smlouvy. Každý export se zapíše do záznamu o činnosti; soubor se na serveru po stažení smaže.

  • README.txt — tento popis a souhrn exportu: kdy vznikl, kolik čeho obsahuje, co nešlo přečíst a co export vědomě vynechal.
  • ceniky/[id].json a ceniky/[id].csv — ceníky; CSV má sloupce Kód · Popis · MJ · Cena (Kč) · Původ řádku · Porovnal s originálem · Porovnáno. ceniky/originaly/ — nahrané soubory ceníků, ceniky/revize.json — revize ceníku podle dokladů.
  • zakazky/[id].json — rozpočty s položkami, zdroji cen, stavem, stvrzením, odpovědí investora a změnovými listy (zmenove_listy); zakazky/[id].csv ve stejném tvaru jako tlačítko CSV u rozpočtu (níže); zakazky/[id].pdf jen u stvrzených rozpočtů; zakazky/[id]/verze/ — snímky verzí při stvrzení a revizi; zakazky/originaly/ — nahrané výkazy výměr.
  • poptavky/[id].json — poptávky a nabídky dodavatelů (offers, i snímek prověrky vítěze proverka_vyber), poptavky/originaly/ — nahrané nabídky.
  • dodavatele.json a dodavatele.csv — adresář subdodavatelů i s uloženými výsledky prověrek v rejstřících (proverka; v CSV štítek, datum a výpadek rejstříku).
  • nastaveni.json — údaje firmy, firemní pravidla, šablona poptávky, branding a další nastavení účtu; logo.[přípona] — logo firmy.
  • naucene-opravy.json — naučené opravy párování (odkaz na řádek vašeho ceníku, nikdy cena); mereni-parovani.json — řada měření párování; historie/ — historické rozpočty; oznameni.json — oznámení podle smlouvy, která služba firmě poslala.
  • cinnost.csv — záznam o činnosti uživatelů v účtu: Čas · ID uživatele · E-mail · Akce · Detail, bez IP adres.
  • uzivatele.csv — uživatelé a jejich role: ID · Jméno · E-mail · Role · Aktivní · Deaktivován, bez otisků hesel.
  • prijeti-podminek.json — záznamy o přijetí obchodních podmínek firmou (verze, otisk SHA-256, kdo, kdy, IP adresa).
  • kos/ — co leží v koši (do 30 dní od smazání), ve stejné struktuře jako v účtu, i s originály.
  • nezarazene-originaly/ — nahrané soubory, které k žádnému záznamu nepatří (například z doby, kdy si záznamy jméno souboru neukládaly).
  • ostatni/ — soubory účtu, které export nezná jménem; jsou v něm doslova, aby nic nevypadlo.

Formáty souborů v exportu

  • JSON v kódování UTF-8, odsazený; data a časy ve tvaru ISO 8601 (2026-09-25T14:30:00+02:00), čísla s desetinnou tečkou.
  • CSV v kódování UTF-8 se značkou BOM, oddělovač středník; čísla s desetinnou čárkou bez oddělovače tisíců. Text, který začíná znakem =, +, -, @, tabulátorem nebo koncem řádku, dostane na začátek apostrof — tabulkový procesor ho nespustí jako vzorec.
  • PDF stvrzených rozpočtů je určené ke čtení a tisku; strojově čitelné jsou JSON a CSV.
  • Originály jsou bajt po bajtu tak, jak jste je nahráli (PDF, JPG, PNG, WEBP, CSV, XLSX nebo XLSM).

Rozpočet jako CSV

Stáhnete ho u rozpočtu tlačítkem CSV; v exportu ZIP je u každého rozpočtu. Otevře se v Excelu i v jiném tabulkovém procesoru.

  • Kódování UTF-8 se značkou BOM na začátku souboru (podle ní Excel pozná češtinu), oddělovač středník, text s oddělovačem nebo uvozovkami je v uvozovkách.
  • Čísla s desetinnou čárkou, bez oddělovače tisíců. Částky (cena řádku celkem, součty pod tabulkou a změnové listy) mají dvě desetinná místa (1234,50); množství, cena za MJ a přirážka v procentech jsou v uložené přesnosti — aspoň dvě, nejvýš 6 desetinných míst (2,375); sazba DPH je celé číslo (21). Datum dokumentu (řádek Vystaveno: nebo Koncept ze dne:) ve tvaru den.měsíc.rok bez mezer (25.9.2026). Data uvnitř textu — v řádku Stav: a ve sloupci Zdroj — mají tvar s mezerami (25. 9. 2026), čas stvrzení v řádku Stav: navíc hodiny a minuty (25. 9. 2026 14:30).
  • Úvodní řádky: Rozpočet: a název, Klient: (je-li vyplněný), Stav: se stavem rozpočtu (nestvrzený nese značku KONCEPT, stvrzený jméno a čas stvrzení) a datum dokumentu (Vystaveno:, u konceptu Koncept ze dne:).
  • Tabulka položek po prázdném řádku. Sloupce podle režimu DPH rozpočtu:
    • plátce DPH, běžný režim: # · Kód · Popis · MJ · Množství · Cena/MJ · DPH % · Celkem bez DPH · Zdroj
    • zhotovitel, který není plátcem DPH: # · Kód · Popis · MJ · Množství · Cena/MJ · Celkem · Zdroj
    • přenesení daňové povinnosti (§ 92e zákona o DPH): # · Kód · Popis · MJ · Množství · Cena/MJ · Celkem bez DPH · Zdroj
  • Nadpis oddílu rozpočtu je řádek s textem velkými písmeny ve sloupci Popis. Sloupec Zdroj uvádí řádek ceníku, na který položka odkazuje, „nabídka subdodavatele“ s datem nahrání, nebo „cena se liší od řádku ceníku“; u položky bez zdroje je prázdný.
  • Součty pod tabulkou: popisek v předposledním sloupci, částka v posledním (základ, přirážka, DPH podle sazeb a celkem); u neplátce a u přenesení daňové povinnosti ještě věta o režimu. Stvrzené změnové listy jsou pod součty s novou celkovou cenou.
  • Text, který začíná znakem =, +, -, @, tabulátorem nebo koncem řádku, dostane na začátek apostrof — tabulkový procesor ho pak nespustí jako vzorec.

Dokumenty PDF

Rozpočet (ve třech šablonách, jedna z nich jako příloha smlouvy) a protokol o nacenění si stáhnete jako PDF. Stvrzené změnové listy jsou v PDF i CSV rozpočtu jako řádek s dopadem na cenu; samostatné PDF změnového listu služba nevydává, položky listů jsou v zakazky/[id].json exportu ZIP. Dokumenty PDF jsou určené ke čtení a tisku, ne ke strojovému zpracování; strojově čitelné jsou CSV a JSON. Export ZIP nese PDF stvrzených rozpočtů.

Originály nahraných souborů

Ceník, výkaz výměr i nabídku dodavatele, které jste nahráli, si otevřete nebo stáhnete odkazem „Otevřít originál“ u ceníku, rozpočtu a poptávky — v původním formátu (PDF, JPG, PNG, WEBP, CSV, XLSX nebo XLSM), bez úprav. Ve službě je vidíte a upravujete; v exportu ZIP jsou všechny pohromadě.

Co export neobsahuje

Jen interní data provozovatele (čl. 16.3 obchodních podmínek): zdrojový kód a pokyny (prompty) služby, parametry a postupy párování, bezpečnostní a technické záznamy služby (přihlášení, provozní záznam Rychlého dotazu, evidence tipů, příznaky nočního úklidu) a údaje o nákladech na AI. Otisky hesel export nenese. Přechodu k jinému poskytovateli to nebrání.