Langsung ke konten utama
document_subtype pada laporan verifikasi identitas mengidentifikasi varian dokumen spesifik yang dikenali Didit — misalnya SIM Queensland dibandingkan SIM generik, atau Commercial Driver’s License (CDL) AS dibandingkan SIM standar. Halaman ini mencantumkan setiap nilai yang dapat dihasilkan oleh kolom tersebut.
Alur kerja Anda sendiri hanya menerima subset dari nilai-nilai ini — apa pun yang Anda pilih pada langkah pengaturan dokumen alur kerja. Dapatkan daftar persis yang diterima untuk alur kerja Anda menggunakan endpoint pengambilan alur kerja di Management API (documents_allowed pada node OCR) daripada menganggap setiap nilai di bawah ini aktif untuk Anda.

​
Pola penamaan

Setiap nilai document_subtype memiliki salah satu dari dua bentuk berikut:
  • Kategori dasar — {CATEGORY}, untuk dokumen yang tidak perlu dibedakan berdasarkan wilayah oleh Didit (sebagian besar paspor, sebagian besar kartu identitas nasional), misalnya PASSPORT_GENERIC, ID_CARD_GENERIC.
  • Dengan prefiks wilayah — {REGION}_{CATEGORY}, untuk dokumen yang format atau klasifikasinya memang berbeda menurut negara bagian, provinsi, atau wilayah, misalnya QUEENSLAND_DRIVER_LICENSE_GENERIC (Australia) atau CALIFORNIA_COMMERCIAL_DL (Amerika Serikat). Prefiks wilayah adalah nama negara bagian/provinsi penerbit, ditulis dalam huruf besar dengan spasi diganti garis bawah.
Dokumen hanya mendapatkan subtipe dengan prefiks wilayah jika registri dokumen Didit memiliki varian yang berbeda dan diklasifikasikan secara terpisah untuk wilayah tersebut. Ketiadaan varian berprefiks wilayah bukan berarti jenis dokumen tersebut tidak ada di wilayah itu — melainkan Didit saat ini melaporkannya di bawah kategori dasar tingkat negara (lihat catatan tentang CDL di bawah untuk contoh konkretnya).

​
Semua nilai subtipe

Tabel di bawah ini memuat daftar lengkap nilai document_subtype yang dapat dihasilkan oleh laporan, dikelompokkan berdasarkan kelompok document_type. Daftar ini sudah mencakup varian berprefiks wilayah — contohnya DRIVER_LICENSE_GENERIC (sebagian besar negara) dan CALIFORNIA_DRIVER_LICENSE_GENERIC muncul sebagai baris terpisah di bawah Driver’s License. Kode kategori dasar tidak unik untuk satu negara saja — kode tersebut digunakan bersama oleh setiap negara yang entri registrinya untuk dokumen tersebut tidak memiliki varian khusus wilayah. Sebagai contoh, ID_CARD_GENERIC mencakup kartu identitas nasional untuk sekitar 170 negara. Cari kode hanya berdasarkan pengelompokan document_type dan prefiks wilayahnya (jika ada), jangan pernah berasumsi bahwa sebuah kode hanya dipetakan ke satu negara.

​
SIM AS: standar vs. komersial (CDL)

document_type bernilai "Driver's License" baik untuk SIM standar maupun Commercial Driver’s License (CDL) — kolom ini tidak pernah membedakan keduanya. Perbedaannya sepenuhnya berada pada document_subtype. Di 48 dari 51 negara bagian dan wilayah AS yang diklasifikasikan oleh Didit, CDL memiliki subtipe tersendiri {STATE}_COMMERCIAL_DL, berbeda dari {STATE}_DRIVER_LICENSE_GENERIC milik yurisdiksi tersebut. Menganggap document_subtype yang berakhiran _COMMERCIAL_DL sebagai tanda “ini adalah CDL” merupakan sinyal yang andal di negara bagian dan wilayah tersebut.
Alaska, District of Columbia, dan Hawaii saat ini tidak memiliki subtipe CDL terpisah. CDL dari salah satu dari ketiga yurisdiksi ini dilaporkan di bawah subtipe standar _DRIVER_LICENSE_GENERIC yurisdiksi tersebut — tidak dapat dibedakan dari lisensi non-komersial hanya berdasarkan document_subtype. Jika Anda memerlukan deteksi CDL yang benar-benar andal untuk ketiga yurisdiksi ini secara khusus, hubungi kami untuk mendaftarkan varian dokumen yang belum ada, atau terapkan kontrol di luar alur (misalnya, mewajibkan pengemudi untuk memberikan nomor CDL/DOT mereka secara terpisah untuk verifikasi).

​
extra_fields.dl_categories bukan sinyal CDL yang andal

Beberapa SIM AS juga menghasilkan extra_fields.dl_categories — daftar huruf kelas (A, B, C, …) yang tertera pada kartu dan dibaca melalui OCR. Jangan gunakan ini sebagai sinyal CDL Anda. Saat ini, kolom tersebut hanya terisi untuk sebagian kecil konfigurasi SIM AS, arti huruf kelas berbeda-beda di setiap negara bagian dan tidak dinormalisasi terhadap semantik komersial/non-komersial, serta kode pengesahan atau pembatasan (yang sebenarnya menjadi penanda “komersial” pada banyak SIM) saat ini belum ditampilkan di laporan sama sekali. document_subtype adalah satu-satunya sinyal terstruktur dan andal untuk membedakan SIM standar dan komersial saat ini.

​
Tetap tersinkronisasi

Kelompok document_type baru diumumkan dalam log perubahan bulanan saat dirilis. Penambahan document_subtype — misalnya varian wilayah baru dari jenis dokumen yang sudah ada — saat ini tidak diumumkan secara individual; registri dokumen Didit berkembang terus-menerus seiring bertambahnya format dokumen baru yang didukung. Tidak ada nomor versi pada payload webhook untuk daftar ini. Jika integrasi Anda perlu mendeteksi subtipe yang belum pernah dilihat sebelumnya daripada menganggap daftar tersebut bersifat tetap, perlakukan setiap nilai document_subtype yang tidak dikenali kode Anda sebagai “tidak terklasifikasi, tinjau secara manual” daripada memunculkan kesalahan, dan periksa kembali halaman ini atau daftar subtipe yang diterima alur kerja Anda secara berkala melalui Management API.

​
Terkait

Terakhir diubah pada 7 November 2026