--- title: Prozessdokument festlegen description: Senden Sie das Identifikationsdokument des Nutzers nach der Erfassung von Ihrem Back-end, damit der Prozess abgeschlossen werden kann. canonical: https://developer.unico.io/de/developers/api-reference/set-process-document locale: de generated_by: markdown-export --- - [/de/](/de/) - API-Referenz - Prozessdokument festlegen **Auf dieser SeiteProzessdokument festlegenPOSTErstellen Sie einen Prozess ohne Dokument, lassen Sie den Nutzer die Erfassung abschließen und senden Sie anschließend das Dokument von Ihrem Back-end. Danach wird der Prozess abgeschlossen. ### Lebenszyklus​ **Ihr Back-end** erstellt den Prozess mit [Prozess erstellen](/de/developers/api-reference/post-processes), ohne `person.duiType` und `person.duiValue`. Der Flow muss ein optionales Dokument erlauben. Der Prozess beginnt als `PROCESS_STATE_CREATED`. **Der Nutzer** durchläuft die Journey und führt die Erfassung durch. **Die Unico API** versetzt den Prozess in `AWAITING_FOR_DOCUMENT`, den Zustand, den [Prozess abrufen](/de/developers/api-reference/get-process) zurückgibt, während der Prozess auf das Dokument wartet. Sie können bereits die Teilergebnisse der Funktionen lesen, die nicht von `duiValue` abhängen. **Ihr Back-end** ruft diesen Endpunkt mit der Prozess-ID in der URL und dem Dokument im Body auf. Die Unico API schließt den Prozess dann ab, und er wechselt zu `PROCESS_STATE_FINISHED`. Die Antwort enthält nicht das endgültige ErgebnisLesen Sie den endgültigen Zustand und das Ergebnis mit [Prozess abrufen](/de/developers/api-reference/get-process) oder warten Sie auf den [Webhook](/de/developers/webhooks-and-events). ### Endpunkt​ UmgebungURL**Produktion**`POST https://api.idcloud.unico.app/client/v1/process/{processId}/document`**Sandbox**`POST https://api.idcloud.uat.unico.app/client/v1/process/{processId}/document` ### Request​ Headers HeaderWert`Authorization``Bearer ` (siehe [Authentifizierung](/de/developers/start/authentication))`Content-Type``application/json` Die Zugangsdaten benötigen dieselbe Berechtigung, die für den Aufruf von [Prozess erstellen](/de/developers/api-reference/post-processes) verwendet wird. Pfadparameter ParameterTypErforderlichBeschreibung`processId`string (UUID)jaProzesskennung, die von [Prozess erstellen](/de/developers/api-reference/post-processes) zurückgegeben wird. Body-Parameter FeldTypErforderlichBeschreibung`duiType`enumjaDokumenttyp. `DUI_TYPE_UNSPECIFIED` wird abgelehnt. Siehe [`duiType`-Werte](#duitype-values) unten.`duiValue`stringjaDokumentnummer, ohne Formatierung. Bis zu 320 Zeichen. **`duiType`-Werte**LandWertBeschreibungAR`DUI_TYPE_AR_PASSPORT`Argentinischer ReisepassAR`DUI_TYPE_AR_DNI`Argentinische DNIAR`DUI_TYPE_AR_LNC`Argentinischer Führerschein (Licencia Nacional de Conducir)AT`DUI_TYPE_AT_STNR`Österreichische Steuernummer (STNR)BE`DUI_TYPE_BE_NN`Belgische Nationalnummer (NN)BR`DUI_TYPE_BR_CPF`Brasilianische CPFBR`DUI_TYPE_BR_PASSPORT`Brasilianischer ReisepassBR`DUI_TYPE_BR_CNPJ`Brasilianische CNPJCA`DUI_TYPE_CA_SIN`Kanadische SINCH`DUI_TYPE_CH_AHV`Schweizer AHV/AVS-NummerCL`DUI_TYPE_CL_RUN`Chilenische RUNCL`DUI_TYPE_CL_PASSPORT`Chilenischer ReisepassCL`DUI_TYPE_CL_LICENCIA_CONDUCIR`Chilenischer Führerschein (Licencia de Conducir)CO`DUI_TYPE_CO_NIT`Kolumbianische NITCO`DUI_TYPE_CO_PASSPORT`Kolumbianischer ReisepassCO`DUI_TYPE_CO_LICENCIA_CONDUCCION`Kolumbianischer Führerschein (Licencia de Conducción)CO`DUI_TYPE_CO_CC`Kolumbianischer Bürgerausweis (Cédula de Ciudadanía)DE`DUI_TYPE_DE_IDNR`Deutsche Steuer-Identifikationsnummer (IdNr)DK`DUI_TYPE_DK_CPR`Dänische CPREC`DUI_TYPE_EC_NI`Ecuadorianische NIES`DUI_TYPE_ES_NIE`Spanische Ausländer-Identifikationsnummer (NIE)ES`DUI_TYPE_ES_DNI`Spanischer Personalausweis (DNI)FI`DUI_TYPE_FI_HETU`Finnische Personenkennung (HETU)FR`DUI_TYPE_FR_SPI`Französische Steuerreferenznummer (SPI)GB`DUI_TYPE_GB_NINO`Britische Sozialversicherungsnummer (NINO)GT`DUI_TYPE_GT_CUI`Guatemaltekische CUIID`DUI_TYPE_ID_NIK`Indonesische NIKIE`DUI_TYPE_IE_PPSN`Irische Sozialversicherungsnummer (PPSN)IT`DUI_TYPE_IT_CF`Italienischer Codice Fiscale (CF)LK`DUI_TYPE_LK_NIC`Sri-lankische NICLU`DUI_TYPE_LU_MATRICULE`Luxemburgische nationale Identifikationsnummer (Matricule)MX`DUI_TYPE_MX_CURP`Mexikanische CURPMX`DUI_TYPE_MX_RFC_PERSONA_FISICA`Mexikanische RFC (Persona Física)MX`DUI_TYPE_MX_LICENCIA_CONDUCIR`Mexikanischer Führerschein (Licencia de Conducir)NG`DUI_TYPE_NG_NIN`Nigerianische NINNG`DUI_TYPE_NG_BVN`Nigerianische Bankverifizierungsnummer (BVN)NG`DUI_TYPE_NG_BVN_TOKEN`Nigerianisches BVN-Token (gehasht)NG`DUI_TYPE_NG_NIN_TOKEN`Nigerianisches NIN-Token (gehasht)NL`DUI_TYPE_NL_BSN`Niederländische Bürgerservicenummer (BSN)NO`DUI_TYPE_NO_FNR`Norwegische nationale Identitätsnummer (Fødselsnummer)PE`DUI_TYPE_PE_RUC`Peruanische RUCPE`DUI_TYPE_PE_DNI`Peruanische DNIPE`DUI_TYPE_PE_PASSPORT`Peruanischer ReisepassPL`DUI_TYPE_PL_PESEL`Polnische PESELPT`DUI_TYPE_PT_NIF`Portugiesische Steueridentifikationsnummer (NIF)SE`DUI_TYPE_SE_PNR`Schwedische Personennummer (PNR)SE`DUI_TYPE_SE_SAMORDNINGSNUMMER`Schwedische Koordinierungsnummer (Samordningsnummer)TR`DUI_TYPE_TR_TCKN`Türkische Identifikationsnummer (TCKN)US`DUI_TYPE_US_SSN`US-amerikanische SSNUS`DUI_TYPE_US_PASSPORT`US-amerikanischer ReisepassUS`DUI_TYPE_US_DRIVER_LICENSE`US-amerikanischer FührerscheinUS`DUI_TYPE_US_PASSPORT_CARD`US-amerikanische PasskarteUS`DUI_TYPE_US_POLYCARBONATE_PASSPORT`US-amerikanischer Polycarbonat-ReisepassUS`DUI_TYPE_US_ID_CARD`US-amerikanische ID-KarteUY`DUI_TYPE_UY_CI`Uruguayische CIZZ`DUI_TYPE_ZZ_EMAIL`E-Mail-AdresseZZ`DUI_TYPE_ZZ_PHONE_NUMBER`Telefonnummer Wann der Aufruf akzeptiert wird Der Prozess befindet sich in `AWAITING_FOR_DOCUMENT`: Der Nutzer hat die Erfassung bereits abgeschlossen. Der Prozess ist nicht abgelaufen. Der Flow erlaubt ein optionales Dokument. Das Dokument ist unveränderlich. Ein zweiter Aufruf schlägt fehl, da der Prozess nicht mehr auf ein Dokument wartet. ### Beispiel​ 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(); ``` ### Antworten​ 200 OK ``` { "processId": "3116552c-6a3e-4c1f-9d2b-8f0e7a5b4c21", "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909"} ``` FeldTypBeschreibung`processId`string (UUID)Prozesskennung.`duiType`enumFür den Prozess registrierter Dokumenttyp.`duiValue`stringFür den Prozess registrierte Dokumentnummer. Die Beispielwerte sind Platzhalter. ### Fehlercodes​ 400 Bad Request401 Unauthorized403 Forbidden404 Not Found429 Too Many Requests500 Internal Server ErrorCodeBeschreibung`3``processId` fehlt oder ist ungültig, `duiType` ist nicht angegeben, oder `duiValue` ist leer oder länger als 320 Zeichen.`9`Der Prozess wartet nicht auf ein Dokument (dies schließt ein bereits festgelegtes Dokument ein), ist abgelaufen oder abgeschlossen, oder der Flow erlaubt kein optionales Dokument.CodeNachrichtBeschreibung—Jwt header is an invalid JSONWenn das verwendete Access-Token ungültige Zeichen enthält.—Jwt is expiredWenn das verwendete Access-Token abgelaufen ist.CodeBeschreibung`7`Den Zugangsdaten fehlt die Berechtigung, die von [Prozess erstellen](/de/developers/api-reference/post-processes) verlangt wird.CodeBeschreibung`5`Der Prozess existiert nicht oder gehört nicht zu Ihrem Unternehmen.Rate-Limit erreicht. Wenn Ihr System einen HTTP-429-Fehler erhält, müssen Sie Mechanismen implementieren, um kaskadierende Ausfälle zu verhindern und eine Verschärfung der Einschränkung zu vermeiden. **Best Practices:** **Abkühlphase (Backoff):** Stoppen oder drosseln Sie nachfolgende Anfragen aus Ihrem System sofort. Wiederholen Sie fehlgeschlagene Anfragen nicht kontinuierlich in einer engen Schleife. **Warteschlange & Drosselung:** Puffern oder reihen Sie ausgehende Anfragen auf Ihrer Seite ein, um den Datenverkehr zu kontrollieren, bevor Sie sie erneut senden. **Exponentieller Backoff mit Jitter:** Erhöhen Sie beim erneuten Versuch die Wartezeit zwischen den Versuchen exponentiell (z. B. 1 s, 2 s, 4 s, 8 s) und fügen Sie eine kleine zufällige Verzögerung ("Jitter") hinzu, um einen Herdeneffekt zu vermeiden, bei dem alle in der Warteschlange befindlichen Anfragen exakt zur gleichen Millisekunde erneut versucht werden. WarnungDas kontinuierliche Ansprechen eines rate-limitierten Endpunkts ohne Backoff kann **die Einschränkungsperiode verlängern** und den operativen Durchsatz Ihres Systems erheblich beeinträchtigen. Eine ordnungsgemäße Drosselung der Anfragen auf Ihrer Seite gewährleistet eine reibungslosere und widerstandsfähigere Integration. Informationen zu Standardlimits, Erhöhung von Anfragen und weiteren Details finden Sie unter [Rate Limits](/de/developers/start/rate-limits).CodeBeschreibung`13`Das Dokument konnte nicht gespeichert werden. HinweisDas Dokument wird beim Identitätsdienst registriert, bevor es gespeichert wird. Wenn diese Registrierung fehlschlägt, gibt der Aufruf den Status dieses Fehlers zurück. ### Nächste Schritte​ Um den endgültigen Zustand und das Ergebnis zu lesen, siehe [Prozess abrufen](/de/developers/api-reference/get-process). Um benachrichtigt zu werden, wenn der Prozess abgeschlossen ist, siehe [Webhooks und Events](/de/developers/webhooks-and-events). Zuletzt aktualisiert am 8. Okt. 2026**