Passer au contenu principal
Le champ document_subtype dans le rapport de vérification d’identité identifie la variante de document spécifique reconnue par Didit — par exemple un permis de conduire du Queensland par rapport à un permis de conduire générique, ou un permis commercial américain (CDL) par rapport à un permis standard. Cette page énumère toutes les valeurs que ce champ peut renvoyer.
Votre propre workflow n’accepte qu’un sous-ensemble de ces valeurs — selon ce que vous avez sélectionné lors de l’étape de configuration des documents du workflow. Récupérez la liste exacte acceptée pour votre workflow via l’endpoint de récupération de workflow de la Management API (documents_allowed sur le nœud OCR) plutôt que de supposer que chaque valeur ci-dessous est activée pour vous.

​
Format de nommage

Chaque valeur de document_subtype suit l’un de ces deux formats :
  • Catégorie simple — {CATEGORY}, pour les documents que Didit n’a pas besoin de distinguer par région (la plupart des passeports, la plupart des cartes nationales d’identité), par exemple PASSPORT_GENERIC, ID_CARD_GENERIC.
  • Avec préfixe régional — {REGION}_{CATEGORY}, pour les documents dont le format ou la classification varie réellement selon l’État, la province ou le territoire, par exemple QUEENSLAND_DRIVER_LICENSE_GENERIC (Australie) ou CALIFORNIA_COMMERCIAL_DL (États-Unis). Le préfixe de région correspond au nom de l’État ou de la province de délivrance, en majuscules avec les espaces remplacés par des tirets bas.
Un document ne reçoit un sous-type avec préfixe régional que lorsque le registre documentaire de Didit intègre une variante distincte et classifiée séparément pour cette région. L’absence d’une variante avec préfixe régional ne signifie pas que le type de document n’existe pas dans cette région — cela signifie que Didit le signale actuellement sous la catégorie simple au niveau national (voir l’avertissement relatif aux CDL ci-dessous pour un exemple concret).

​
Toutes les valeurs de sous-types

Le tableau ci-dessous constitue l’énumération complète des valeurs de document_subtype que le rapport peut renvoyer, regroupées par famille de document_type. Il inclut déjà les variantes avec préfixe régional — par exemple, DRIVER_LICENSE_GENERIC (la plupart des pays) et CALIFORNIA_DRIVER_LICENSE_GENERIC apparaissent tous deux sous forme de lignes distinctes sous « Permis de conduire ». Un code de catégorie simple n’est pas unique à un pays donné — il est partagé par tous les pays dont l’entrée dans le registre pour ce document ne possède pas de variante propre à une région. ID_CARD_GENERIC, par exemple, couvre les cartes nationales d’identité d’environ 170 pays. Recherchez un code uniquement selon son regroupement document_type et (le cas échéant) son préfixe régional, sans jamais supposer qu’un code correspond à un pays unique.

​
Permis de conduire américains : standard vs. commercial (CDL)

document_type a pour valeur "Driver's License" à la fois pour un permis de conduire standard et pour un permis commercial (CDL) — il ne les différencie jamais. La distinction repose entièrement sur document_subtype. Dans 48 des 51 États et territoires américains classifiés par Didit, un CDL reçoit son propre sous-type {STATE}_COMMERCIAL_DL, distinct du {STATE}_DRIVER_LICENSE_GENERIC de cet État. Considérer un document_subtype se terminant par _COMMERCIAL_DL comme indiquant qu’« il s’agit d’un CDL » est un signal fiable dans ces États.
L’Alaska, le district de Columbia et Hawaï ne disposent pas actuellement d’un sous-type CDL distinct. Un CDL émis par l’une de ces trois juridictions est signalé sous le sous-type standard _DRIVER_LICENSE_GENERIC de cette juridiction — indiscernable d’un permis non commercial à l’aide du seul document_subtype. Si vous avez besoin d’une détection infaillible des CDL pour ces trois juridictions en particulier, contactez-nous pour enregistrer les variantes de documents manquantes, ou appliquez un contrôle hors bande (par exemple, en exigeant du conducteur qu’il fournisse séparément son numéro CDL/DOT pour vérification).

​
extra_fields.dl_categories n’est pas un signal fiable pour les CDL

Certains permis américains produisent également extra_fields.dl_categories — une liste des lettres de catégorie (A, B, C, …) imprimées sur la carte, lues par OCR. N’utilisez pas ce champ comme signal de détection de CDL. Aujourd’hui, ce champ n’est renseigné que pour une infime minorité de configurations de permis de conduire américains, la signification des lettres de classe varie selon les États et n’est pas normalisée selon une distinction entre permis commerciaux et non commerciaux, et les mentions spéciales ou codes de restriction (c’est là que la mention « commerciale » figure effectivement sur de nombreux permis) ne sont actuellement pas du tout exposés dans le rapport. document_subtype reste aujourd’hui le seul signal structuré et fiable pour distinguer un permis standard d’un permis commercial.

​
Rester synchronisé

Les nouvelles familles de document_type sont annoncées dans le journal des modifications mensuel lors de leur déploiement. Les ajouts de document_subtype — par exemple une nouvelle variante régionale d’un type de document existant — ne sont actuellement pas annoncés individuellement ; le registre documentaire de Didit s’enrichit en continu au fil de l’intégration de nouveaux formats de documents. Il n’y a pas de numéro de version dans le payload du webhook pour cette liste. Si votre intégration doit détecter un sous-type qu’elle n’a encore jamais rencontré plutôt que de considérer l’ensemble comme immuable, traitez toute valeur de document_subtype non reconnue par votre code comme « non classifiée, à examiner manuellement » plutôt que de lever une erreur, et consultez régulièrement cette page ou la liste des sous-types acceptés par votre workflow via la Management API.

​
Pages connexes

Dernière modification le 7 novembre 2026