Eigene Schemas

Wenn Sie aus einem Dokument etwas lesen müssen, das in den Systemschemas nicht vorhanden ist, definieren Sie Ihr eigenes.

Wann es sinnvoll ist

• Ein Dokument von einem Lieferanten mit einem nicht-standardmäßigen Layout.
• Branchenspezifik: Wiegelisten, Prüfprotokolle, Tankkarten.
• Felder, die Sie in Ihr System benötigen und an anderer Stelle nicht vorkommen.

Bitte beachten Sie, dass ein Dokument aus einem eigenen Schema nicht an die Buchhaltung gesendet oder in Buchhaltungsformate exportiert werden kann – diese lesen feste Felder der Rechnung. Verfügbar bleiben JSON, XML, YAML, CSV, Excel und PDF. In Berichten wird nur das Dokument gezählt, das ein numerisches Feld TotalAmount hat.

Wie es definiert wird

Mit dem Editor im Tab Schemas. Es wird in JSON Schema geschrieben – ein Objekt mit properties, für jedes Feld type und description, Listen als array mit items. Wer den Standard kennt, wird nicht überrascht sein; wer nicht, beginnt mit einer Vorlage (Rechnung, Rechnung mit MwSt., Quittung, Lieferschein, minimal) oder einer Kopie des Systemschemas. Die Felder der Vorlagen haben englische Bezeichnungen, ebenso wie die Systemschemas, sodass das Kontrollformular die Beschreibung finden kann; die Beschreibungen der Felder sind in der Sprache der Benutzeroberfläche und können angepasst werden.

Links, allOf, oneOf, Bedingungen und ähnliche Konstruktionen erlaubt der Editor nicht; das Schema muss ein flacher Baum von Feldern sein. Eine Kopie des Systemschemas bringt auch seine Zuordnung für das Modell mit, sodass sie ebenso gut erkannt wird wie das Muster; mit dem Button Trennen wird es zu einem gewöhnlichen eigenen Schema.

Die Beschreibung des Feldes ist eine Anleitung für das Modell

Dies ist der wichtigste Punkt auf der gesamten Seite. description dient nicht nur dem Menschen, sondern wird auch vom Modell gelesen. Der Unterschied zwischen „Auftragsnummer“ und „Auftragsnummer, beginnt mit Z- und hat sechs Ziffern, üblicherweise in der oberen rechten Ecke beim Barcode“ ist bei der Erfolgsquote enorm.

Grenzen

Die Anzahl der Felder richtet sich nach dem Tarif: 80 für Free und Starter, 160 für Business, 240 für Scale. Auch verschachtelte Felder und Positionen zählen mit. Bezeichnungen und Beschreibungen werden dem Modell bei jedem Dokument übermittelt, sodass ein längeres Schema teurere Verarbeitung bedeutet.

Testen

Der Editor überprüft die Syntax kontinuierlich und lässt das Speichern nicht zu, bis das Schema korrekt ist. Es kann nur an einem echten Dokument getestet werden: Laden Sie es mit dem gewählten Schema hoch oder wählen Sie bei einem bereits bearbeiteten Dokument Erneut verarbeiten. Beides kostet Credits wie die reguläre Verarbeitung.

Änderungen und Löschen

Ein bearbeitetes Schema gilt für die weitere Verarbeitung. Dokumente, die bereits verarbeitet wurden, behalten die Daten so, wie sie entstanden sind. Ein Schema, nach dem mindestens ein Dokument erkannt wurde, kann nicht gelöscht werden – sonst würden die Dokumente die Kontrollvorlage verlieren.