Vlastní schémata
Když potřebujete z dokladu číst něco, co v systémových schématech není, definujete si vlastní.
Kdy to má smysl
- Doklad od jednoho dodavatele s nestandardním rozvržením.
- Odvětvová specialita: vážní lístky, protokoly o zkoušce, palivové karty.
- Pole, které potřebujete do svého systému a nikde jinde se nevyskytuje.
Počítejte s tím, že doklad z vlastního schématu nejde poslat do účetnictví ani
exportovat do účetních formátů — ty čtou pevná pole faktury. Zůstává JSON, XML,
YAML, CSV, Excel a PDF. Do přehledů se počítá jen doklad, který má číselné pole
TotalAmount.
Jak se definuje
Editorem v záložce Schémata. Píše se v JSON Schema — objekt s properties,
u každého pole type a description, seznamy jako array s items. Kdo standard
zná, nebude překvapen; kdo ne, začne z předlohy (faktura, faktura s DPH, účtenka,
dodací list, minimální) nebo z kopie systémového schématu. Pole předloh mají anglické
názvy stejně jako systémová schémata, takže k nim formulář kontroly najde popisek;
popisy polí jsou v jazyce rozhraní a dají se přepsat.
Odkazy, allOf, oneOf, podmínky a podobné konstrukce editor nepustí; schéma
musí být plochý strom polí. Kopie systémového schématu si nese i jeho zadání
pro model, takže rozpoznává stejně dobře jako vzor; tlačítkem Odpojit se z ní
stane obyčejné vlastní schéma.
Popis pole je návod pro model
Tohle je nejdůležitější věc na celé stránce. description neslouží jen člověku,
čte ho i model. Rozdíl mezi „číslo zakázky" a „číslo zakázky, začíná Z- a má
šest číslic, bývá v pravém horním rohu u čárového kódu" je v úspěšnosti obrovský.
Limity
Počet polí se řídí tarifem: 80 na Free a Starter, 160 na Business, 240 na Scale. Počítají se i vnořená pole a pole položek. Názvy a popisy se posílají modelu u každého dokladu, takže delší schéma znamená dražší zpracování.
Zkoušení
Editor kontroluje syntaxi průběžně a nepustí uložení, dokud schéma nesedí. Vyzkoušet ho jde jen na skutečném dokladu: nahrajte ho s vybraným schématem, nebo u hotového dokladu zvolte Zpracovat znovu. Obojí stojí kredity jako běžné zpracování.
Změny a mazání
Upravené schéma platí pro další zpracování. Doklady, které už prošly, si drží data tak, jak vznikla. Schéma, podle kterého se rozpoznal aspoň jeden doklad, smazat nejde — doklady by přišly o formulář kontroly.