Zum Inhalt springen

Partner

Ein Partner ist ein externer Absender – typischerweise ein Lieferant –, dessen Dokumente ihr verarbeitet. Partner sind organisationsweit hinterlegt: Ein Partner gehört der Organisation, nicht einem einzelnen Dokumenttyp.

Bei der Erkennung wird der Partner automatisch mitbestimmt – als Teil desselben Erkennungslaufs, ohne separaten Schritt. Grundlage sind die Partner, die im Partner-Klassifizierungsfeld des Schemas hinterlegt sind, samt einer je Partner möglichen Beschreibung, die die Zuordnung steuert.

Das Ergebnis erscheint als partnerName am Lauf (in der API) bzw. in der Ergebnisansicht (in der Oberfläche).

Ein neuer Partner lässt sich je Dokumenttyp im Testmodus hinzufügen (Schalter im Partner-Dialog des Schemas). Ein solcher Partner wird ganz normal erkannt und der Lauf wird verarbeitet und im API-Feed ausgeliefert – in der API-Antwort ist er aber über partnerTestMode: true als Testlauf markiert. So lässt sich ein Partner in Betrieb nehmen, ohne seine Dokumente sofort produktiv weiterzuverarbeiten: Der abrufende Client entscheidet anhand des Flags, ob er den Lauf produktiv übernimmt oder nur zur Kontrolle ablegt. Bewährt sich die Erkennung, wird der Schalter deaktiviert und der Partner ist produktiv.

Der Testmodus gilt je Dokumenttyp: Derselbe Partner kann bei einem Dokumenttyp produktiv und bei einem anderen noch im Testmodus sein. Er ist unabhängig von der Umgebung (prod/test) des Scans, da er sich erst aus der Klassifizierung ergibt.

Sobald mindestens ein Partner konfiguriert ist, gibt es eine automatische Auffang-Kategorie „Unbekannt“: Ein nicht zuordenbarer Absender wird als „Unbekannt“ klassifiziert, statt den Lauf scheitern zu lassen. In der Oberfläche wird das wie „kein Partner erkannt“ (gelbe Warnung) angezeigt, behält aber sein eigenes Label, damit beide Fälle unterscheidbar bleiben.

Ist kein Partner konfiguriert, entfällt die Klassifizierung – ein per API eingereichter Scan schlägt dann mit partner_not_classified fehl, wenn das Feld leer zurückkommt.

Optional lässt sich für die Partner-Klassifizierung eine Mindestkonfidenz festlegen. Liegt die Zuordnung darunter, schlägt ein produktiver Scan mit confidence_below_threshold fehl.

Welche Partner für einen Dokumenttyp in Frage kommen, wird im Schema des Dokumenttyps gepflegt (siehe Schemas). Derselbe Partner kann bei mehreren Dokumenttypen auftauchen – mit je eigener Beschreibung.