Zum Hauptinhalt springen
document_subtype im Bericht zur Ausweisverifizierung identifiziert die spezifische Dokumentvariante, die Didit erkannt hat – beispielsweise einen Führerschein aus Queensland gegenüber einem allgemeinen Führerschein oder einen US-amerikanischen Commercial Driver’s License (CDL) gegenüber einem Standard-Führerschein. Diese Seite listet jeden Wert auf, den das Feld zurückgeben kann.
Ihr eigener Workflow akzeptiert nur eine Teilmenge davon – je nachdem, was Sie im Schritt „Dokumenteinstellungen“ des Workflows ausgewählt haben. Rufen Sie die genaue Liste der akzeptierten Dokumente für Ihren Workflow über den Workflow-Abruf-Endpoint der Management-API (documents_allowed auf dem OCR-Knoten) ab, anstatt davon auszugehen, dass jeder der unten aufgeführten Werte für Sie aktiviert ist.

​
Namensmuster

Jeder document_subtype-Wert weist eines von zwei Formaten auf:
  • Einfache Kategorie – {CATEGORY}, für Dokumente, die Didit nicht nach Region unterscheiden muss (die meisten Reisepässe, die meisten Personalausweise), beispielsweise PASSPORT_GENERIC, ID_CARD_GENERIC.
  • Mit Regionspräfix – {REGION}_{CATEGORY}, für Dokumente, deren Format oder Klassifizierung sich je nach Bundesstaat, Provinz oder Territorium tatsächlich unterscheidet, beispielsweise QUEENSLAND_DRIVER_LICENSE_GENERIC (Australien) oder CALIFORNIA_COMMERCIAL_DL (Vereinigte Staaten). Das Regionspräfix ist der Name des ausstellenden Bundesstaates bzw. der Provinz in Großbuchstaben, wobei Leerzeichen durch Unterstriche ersetzt werden.
Ein Dokument erhält nur dann einen Subtyp mit Regionspräfix, wenn das Dokumentenregister von Didit eine eindeutige, separat klassifizierte Variante für diese Region führt. Das Fehlen einer Variante mit Regionspräfix bedeutet nicht, dass der Dokumenttyp in dieser Region nicht existiert – es bedeutet, dass Didit ihn derzeit stattdessen unter der einfachen Kategorie auf Länderebene meldet (siehe den CDL-Hinweis unten für ein konkretes Beispiel).

​
Alle Subtyp-Werte

Die nachfolgende Tabelle enthält die vollständige Aufzählung der document_subtype-Werte, die der Bericht zurückgeben kann, gruppiert nach der document_type-Familie. Sie enthält bereits die Varianten mit Regionspräfix – so erscheinen beispielsweise sowohl DRIVER_LICENSE_GENERIC (die meisten Länder) als auch CALIFORNIA_DRIVER_LICENSE_GENERIC als separate Zeilen unter „Führerschein“. Ein einfacher Kategorie-Code ist nicht spezifisch für ein einzelnes Land – er wird von jedem Land geteilt, dessen Registereintrag für dieses Dokument keine regionsspezifische Variante aufweist. ID_CARD_GENERIC deckt beispielsweise nationale Personalausweise für rund 170 Länder ab. Schlagen Sie einen Code nur anhand seiner document_type-Gruppierung und (falls vorhanden) seines Regionspräfixes nach, und gehen Sie niemals davon aus, dass ein Code genau einem Land zugeordnet ist.

​
US-Führerscheine: Standard vs. kommerziell (CDL)

document_type lautet sowohl für einen Standard-Führerschein als auch für einen Commercial Driver’s License (CDL) "Driver's License" – das Feld unterscheidet diese niemals. Die Unterscheidung findet vollständig in document_subtype statt. In 48 der 51 US-Bundesstaaten und -Territorien, die Didit klassifiziert, erhält ein CDL einen eigenen Subtyp {STATE}_COMMERCIAL_DL, der sich vom {STATE}_DRIVER_LICENSE_GENERIC dieser Jurisdiktion unterscheidet. Ein document_subtype, der auf _COMMERCIAL_DL endet, als „dies ist ein CDL“ zu behandeln, ist in diesen Jurisdiktionen ein verlässliches Signal.
Alaska, der District of Columbia und Hawaii verfügen derzeit über keinen separaten CDL-Subtyp. Ein CDL aus einer dieser drei Jurisdiktionen wird unter dem standardmäßigen Subtyp _DRIVER_LICENSE_GENERIC dieser Jurisdiktion gemeldet – allein anhand von document_subtype ist er von einem nicht-kommerziellen Führerschein nicht zu unterscheiden. Wenn Sie speziell für diese drei Jurisdiktionen eine lückenlose CDL-Erkennung benötigen, kontaktieren Sie uns, um die fehlenden Dokumentvarianten zu registrieren, oder wenden Sie eine Kontrolle außerhalb des Systems an (beispielsweise indem Sie vom Fahrer verlangen, seine CDL-/DOT-Nummer zur Verifizierung separat anzugeben).

​
extra_fields.dl_categories ist kein verlässliches CDL-Signal

Einige US-Führerscheine liefern auch extra_fields.dl_categories – eine per OCR gelesene Liste der auf der Karte aufgedruckten Klassenbuchstaben (A, B, C, …). Verwenden Sie dies nicht als Ihr CDL-Signal. Derzeit wird dieses Feld nur bei einem sehr kleinen Teil der US-Führerscheinkonfigurationen befüllt, die Bedeutungen der Klassenbuchstaben variieren je nach Bundesstaat und sind nicht auf die Bedeutung „kommerziell/nicht-kommerziell“ normiert, und Vermerk- oder Beschränkungscodes (in denen „kommerziell“ auf vielen Führerscheinen tatsächlich gekennzeichnet wird) werden im Bericht derzeit überhaupt nicht offengelegt. document_subtype ist heute das einzige strukturierte, verlässliche Signal zur Unterscheidung zwischen Standard- und kommerziellem Führerschein.

​
Auf dem aktuellen Stand bleiben

Neue document_type-Familien werden im monatlichen Changelog angekündigt, sobald sie veröffentlicht werden. Ergänzungen bei document_subtype – beispielsweise eine neue Regionsvariante eines bestehenden Dokumenttyps – werden derzeit nicht einzeln angekündigt; das Dokumentenregister von Didit wächst kontinuierlich mit der Einführung neuer Dokumentformate. Für diese Liste gibt es keine Versionsnummer in der Webhook-Payload. Wenn Ihre Integration einen Subtyp erkennen muss, den sie noch nie zuvor gesehen hat, anstatt von einer festen Menge auszugehen, behandeln Sie jeden document_subtype-Wert, den Ihr Code nicht erkennt, als „nicht klassifiziert, manuelle Prüfung erforderlich“, anstatt einen Fehler auszugeben, und prüfen Sie diese Seite oder die Liste der akzeptierten Subtypen Ihres Workflows regelmäßig über die Management-API.

​
Verwandte Themen

Zuletzt geändert am 7. November 2026