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

V záložce Schémata. Začít jde třemi způsoby: návrhem z ukázkového dokladu (viz níž), z předlohy (faktura, faktura s DPH, účtenka, dodací list, minimální) nebo z kopie systémového schématu.

Schéma se upravuje formulářem. Každé pole má název, typ a popis:

• Text, Číslo, Celé číslo, Ano / ne jsou jednoduché hodnoty. Data, IČO, čísla účtů a PSČ patří do textu, i když jsou z číslic.
• Skupina polí drží údaje, které patří k sobě, třeba dodavatele s názvem a IČO.
• Seznam je pro opakující se řádky. Položkou bývá skupina polí (položky faktury, jednotlivá vážení), nebo jen text či číslo (seznam čísel objednávek).

Pole jde šipkami přesouvat a košem odebrat. Pole bez názvu nebo dvě se stejným názvem uložit nejde, v definici by se slila do jednoho.

Název pole je klíč ve výstupu, tedy v JSON, XML i hlavičce CSV. Pište ho anglicky bez mezer, třeba IssueDate. Pole pojmenovaná jako v systémových schématech (DocumentNumber, Supplier, TotalAmount a další) dostanou popisek ve formuláři kontroly; pole předloh jsou pojmenovaná právě tak. Popisy jsou v jazyce rozhraní a dají se přepsat.

Přepínačem Kód (JSON Schema) se totéž schéma ukáže jako JSON: objekt s properties, u každého pole type a description, seznamy jako array s items. Úpravy v kódu i ve formuláři jsou jedna a táž definice, přepínat jde kdykoli. Co formulář neumí ukázat, třeba výčet hodnot (enum), zůstane v definici i po úpravě ve formuláři. Schéma s konstrukcí, kterou formulář věrně ukázat neumí, třeba pole se dvěma typy, se otevře rovnou v kódu.

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.

Návrh z ukázkového dokladu

Tlačítko Navrhnout z dokladu pod Nové schéma. Vyberete jeden doklad toho druhu, který chcete vytěžovat, třeba vážní lístek, a model navrhne pole s popisy. Návrh se otevře ve formuláři jako nové schéma. Zkontrolujte názvy, typy a hlavně popisy, podle nich bude model doklady číst, a schéma uložte. Dokud ho neuložíte, nikde nic nevznikne a doklad se neukládá.

• Model čte nejvýš první tři strany, na rozvržení dokladu to stačí.
• Stojí to kredit za každou přečtenou stranu, tedy nejvýš tři kredity. OCR při tom neběží.
• Když návrh nevznikne, kredity se vrátí.
• Návrh má nejvýš 60 polí, i když tarif dovolí víc. Když je na dokladu údajů víc, méně důležitá vynechá a řekne to; další pole přidáte ve formuláři.
• Hodnoty z ukázky se do návrhu nedostanou. Popis říká, co do pole patří, ne co stálo na ukázkovém dokladu.

Za co se kredity strhly, najdete v historii aktivity jako záznam o návrhu schématu.

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 schéma průběžně a nepustí uložení, dokud 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.