--- title: Tetapkan Dokumen Proses description: Kirim dokumen identifikasi pengguna dari back-end Anda setelah pengambilan gambar, agar proses dapat diselesaikan. canonical: https://developer.unico.io/id/developers/api-reference/set-process-document locale: id generated_by: markdown-export --- - [/id/](/id/) - Referensi API - Tetapkan Dokumen Proses **Di halaman iniTetapkan Dokumen ProsesPOSTBuat proses tanpa dokumen, biarkan pengguna menyelesaikan pengambilan gambar, lalu kirim dokumen dari back-end Anda. Setelah itu, proses selesai. ### Siklus hidup​ **Back-end Anda** membuat proses dengan [Buat Proses](/id/developers/api-reference/post-processes), tanpa `person.duiType` dan `person.duiValue`. Flow harus mengizinkan dokumen opsional. Proses dimulai dengan state `PROCESS_STATE_CREATED`. **Pengguna** menjalankan perjalanan dan melakukan pengambilan gambar. **Unico API** memindahkan proses ke `AWAITING_FOR_DOCUMENT`, yaitu state yang dikembalikan oleh [Dapatkan Proses](/id/developers/api-reference/get-process) selama proses menunggu dokumen. Anda sudah dapat membaca hasil parsial dari kapabilitas yang tidak bergantung pada `duiValue`. **Back-end Anda** memanggil endpoint ini dengan ID proses di URL dan dokumen di body. Unico API kemudian menyelesaikan proses, dan proses berpindah ke `PROCESS_STATE_FINISHED`. Respons tidak memuat hasil akhirBaca state akhir dan hasilnya dengan [Dapatkan Proses](/id/developers/api-reference/get-process), atau tunggu [webhook](/id/developers/webhooks-and-events). ### Endpoint​ LingkunganURL**Produksi**`POST https://api.idcloud.unico.app/client/v1/process/{processId}/document`**Sandbox**`POST https://api.idcloud.uat.unico.app/client/v1/process/{processId}/document` ### Permintaan​ Headers HeaderNilai`Authorization``Bearer ` (lihat [Autentikasi](/id/developers/start/authentication))`Content-Type``application/json` Kredensial memerlukan izin yang sama dengan yang digunakan untuk memanggil [Buat Proses](/id/developers/api-reference/post-processes). Parameter path ParameterTipeWajibDeskripsi`processId`string (UUID)yaIdentifier proses yang dikembalikan oleh [Buat Proses](/id/developers/api-reference/post-processes). Parameter body FieldTipeWajibDeskripsi`duiType`enumyaTipe dokumen. `DUI_TYPE_UNSPECIFIED` ditolak. Lihat [nilai `duiType`](#duitype-values) di bawah.`duiValue`stringyaNomor dokumen, tanpa format. Maksimal 320 karakter. **Nilai `duiType`**NegaraNilaiDeskripsiAR`DUI_TYPE_AR_PASSPORT`Paspor ArgentinaAR`DUI_TYPE_AR_DNI`DNI ArgentinaAR`DUI_TYPE_AR_LNC`SIM Argentina (Licencia Nacional de Conducir)AT`DUI_TYPE_AT_STNR`Nomor Pajak Austria (STNR)BE`DUI_TYPE_BE_NN`Nomor Nasional Belgia (NN)BR`DUI_TYPE_BR_CPF`CPF BrasilBR`DUI_TYPE_BR_PASSPORT`Paspor BrasilBR`DUI_TYPE_BR_CNPJ`CNPJ BrasilCA`DUI_TYPE_CA_SIN`SIN KanadaCH`DUI_TYPE_CH_AHV`Nomor AHV/AVS SwissCL`DUI_TYPE_CL_RUN`RUN ChiliCL`DUI_TYPE_CL_PASSPORT`Paspor ChiliCL`DUI_TYPE_CL_LICENCIA_CONDUCIR`SIM Chili (Licencia de Conducir)CO`DUI_TYPE_CO_NIT`NIT KolombiaCO`DUI_TYPE_CO_PASSPORT`Paspor KolombiaCO`DUI_TYPE_CO_LICENCIA_CONDUCCION`SIM Kolombia (Licencia de Conducción)CO`DUI_TYPE_CO_CC`Kartu Kewarganegaraan Kolombia (Cédula de Ciudadanía)DE`DUI_TYPE_DE_IDNR`Nomor Identifikasi Pajak Jerman (IdNr)DK`DUI_TYPE_DK_CPR`CPR DenmarkEC`DUI_TYPE_EC_NI`NI EkuadorES`DUI_TYPE_ES_NIE`Nomor Identitas Warga Asing Spanyol (NIE)ES`DUI_TYPE_ES_DNI`Dokumen Identitas Nasional Spanyol (DNI)FI`DUI_TYPE_FI_HETU`Kode Identitas Pribadi Finlandia (HETU)FR`DUI_TYPE_FR_SPI`Nomor Referensi Pajak Prancis (SPI)GB`DUI_TYPE_GB_NINO`Nomor Asuransi Nasional Inggris (NINO)GT`DUI_TYPE_GT_CUI`CUI GuatemalaID`DUI_TYPE_ID_NIK`NIK IndonesiaIE`DUI_TYPE_IE_PPSN`Nomor Layanan Publik Pribadi Irlandia (PPSN)IT`DUI_TYPE_IT_CF`Codice Fiscale Italia (CF)LK`DUI_TYPE_LK_NIC`NIC Sri LankaLU`DUI_TYPE_LU_MATRICULE`Nomor Identifikasi Nasional Luksemburg (Matricule)MX`DUI_TYPE_MX_CURP`CURP MeksikoMX`DUI_TYPE_MX_RFC_PERSONA_FISICA`RFC Meksiko (Perorangan)MX`DUI_TYPE_MX_LICENCIA_CONDUCIR`SIM Meksiko (Licencia de Conducir)NG`DUI_TYPE_NG_NIN`NIN NigeriaNG`DUI_TYPE_NG_BVN`Nomor Verifikasi Bank Nigeria (BVN)NG`DUI_TYPE_NG_BVN_TOKEN`Token BVN Nigeria (hash)NG`DUI_TYPE_NG_NIN_TOKEN`Token NIN Nigeria (hash)NL`DUI_TYPE_NL_BSN`Nomor Layanan Warga Negara Belanda (BSN)NO`DUI_TYPE_NO_FNR`Nomor Identitas Nasional Norwegia (Fødselsnummer)PE`DUI_TYPE_PE_RUC`RUC PeruPE`DUI_TYPE_PE_DNI`DNI PeruPE`DUI_TYPE_PE_PASSPORT`Paspor PeruPL`DUI_TYPE_PL_PESEL`PESEL PolandiaPT`DUI_TYPE_PT_NIF`Nomor Identifikasi Pajak Portugal (NIF)SE`DUI_TYPE_SE_PNR`Nomor Pribadi Swedia (PNR)SE`DUI_TYPE_SE_SAMORDNINGSNUMMER`Nomor Koordinasi Swedia (Samordningsnummer)TR`DUI_TYPE_TR_TCKN`Nomor Identifikasi Turki (TCKN)US`DUI_TYPE_US_SSN`SSN Amerika SerikatUS`DUI_TYPE_US_PASSPORT`Paspor Amerika SerikatUS`DUI_TYPE_US_DRIVER_LICENSE`SIM Amerika SerikatUS`DUI_TYPE_US_PASSPORT_CARD`Kartu Paspor Amerika SerikatUS`DUI_TYPE_US_POLYCARBONATE_PASSPORT`Paspor Polikarbonat Amerika SerikatUS`DUI_TYPE_US_ID_CARD`Kartu Identitas Amerika SerikatUY`DUI_TYPE_UY_CI`CI UruguayZZ`DUI_TYPE_ZZ_EMAIL`Alamat emailZZ`DUI_TYPE_ZZ_PHONE_NUMBER`Nomor telepon Kapan panggilan diterima Proses berada dalam state `AWAITING_FOR_DOCUMENT`: pengguna sudah menyelesaikan pengambilan gambar. Proses belum kedaluwarsa. Flow mengizinkan dokumen opsional. Dokumen bersifat tidak dapat diubah. Panggilan kedua akan gagal, karena proses tidak lagi menunggu dokumen. ### Contoh​ cURLNode.js``` curl -X POST https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/document \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909" }' ``` ``` import fetch from 'node-fetch';const res = await fetch( `https://api.idcloud.unico.app/client/v1/process/${processId}/document`, { method: 'POST', headers: { Authorization: `Bearer ${accessToken}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ duiType: 'DUI_TYPE_BR_CPF', duiValue: '12345678909', }), });const { processId: id, duiType, duiValue } = await res.json(); ``` ### Respons​ 200 OK ``` { "processId": "3116552c-6a3e-4c1f-9d2b-8f0e7a5b4c21", "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909"} ``` FieldTipeDeskripsi`processId`string (UUID)Identifier proses.`duiType`enumTipe dokumen yang terdaftar untuk proses.`duiValue`stringNomor dokumen yang terdaftar untuk proses. Nilai pada contoh hanyalah placeholder. ### Kode Error​ 400 Bad Request401 Unauthorized403 Forbidden404 Not Found429 Too Many Requests500 Internal Server ErrorKodeDeskripsi`3``processId` tidak ada atau tidak valid, `duiType` tidak ditentukan, atau `duiValue` kosong atau lebih dari 320 karakter.`9`Proses tidak sedang menunggu dokumen (termasuk jika dokumen sudah ditetapkan), sudah kedaluwarsa atau selesai, atau flow tidak mengizinkan dokumen opsional.KodePesanDeskripsi—Jwt header is an invalid JSONKetika access token yang digunakan mengandung karakter yang salah.—Jwt is expiredKetika access token yang digunakan sudah kedaluwarsa.KodeDeskripsi`7`Kredensial tidak memiliki izin yang diperlukan oleh [Buat Proses](/id/developers/api-reference/post-processes).KodeDeskripsi`5`Proses tidak ada, atau bukan milik perusahaan Anda.Batas rate tercapai. Ketika sistem Anda menerima error HTTP 429, Anda harus mengimplementasikan mekanisme untuk mencegah kegagalan berantai dan menghindari memperburuk pembatasan. **Praktik terbaik:** **Periode pendinginan (backoff):** Segera hentikan atau kurangi permintaan berikutnya dari sistem Anda. Jangan terus-menerus mencoba ulang permintaan yang gagal dalam loop yang ketat. **Antrean & pembatasan (Queueing & throttling):** Buffer atau antrean permintaan keluar dari sisi Anda untuk mengontrol aliran lalu lintas sebelum mengirimnya kembali. **Exponential backoff dengan jitter:** Saat mencoba ulang, tingkatkan waktu tunggu secara eksponensial antar percobaan (misalnya, 1 s, 2 s, 4 s, 8 s) dan tambahkan penundaan acak kecil ("jitter") untuk mencegah efek kawanan di mana semua permintaan yang diantrean mencoba ulang pada milidetik yang sama persis. peringatanTerus-menerus mengirim permintaan ke endpoint yang dibatasi rate tanpa menerapkan backoff dapat **memperpanjang periode pembatasan** dan sangat memengaruhi throughput operasional sistem Anda. Membatasi permintaan dengan benar dari sisi Anda memastikan integrasi yang lebih lancar dan lebih tangguh. Untuk batas default, peningkatan permintaan, dan detail tambahan, lihat [Batas Rate](/id/developers/start/rate-limits).KodeDeskripsi`13`Dokumen tidak dapat disimpan. catatanDokumen didaftarkan ke layanan identitas sebelum disimpan. Jika pendaftaran tersebut gagal, panggilan akan mengembalikan status dari kegagalan tersebut. ### Selanjutnya​ Untuk membaca state akhir dan hasilnya, lihat [Dapatkan Proses](/id/developers/api-reference/get-process). Untuk mendapatkan notifikasi saat proses selesai, lihat [Webhook dan Event](/id/developers/webhooks-and-events). Terakhir diperbarui pada 8 Okt 2026**