--- title: Prozessdokument setzen description: Das Ausweisdokument für einen ohne Dokument erstellten Prozess setzen. Löst Fähigkeiten aus, die ein Dokument erfordern. canonical: https://developer.unico.io/de/dual-api/developers/api-reference/web-sdk/post-process-document locale: de generated_by: markdown-export --- - [/de/](/de/) - [API-Referenz](/de/dual-api/developers/api-reference/) - [Web & Nativ](/de/dual-api/developers/api-reference/web-sdk/) - Set Process Document **Auf dieser Seite# Prozessdokument setzen Setzt das Ausweisdokument (CPF, CURP, SSN oder anderer `duiType`) für einen Prozess, der ohne Dokument erstellt wurde. Einmal gesetzt, ist das Dokument unveränderlich. Nur verfügbar für Prozesse, deren Custom Flow die Erstellung ohne Dokument erlaubt -- d. h. Prozesse im Status `AWAITING_FOR_DOCUMENT`. ### 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` ### Anfrage​ Headers HeaderWert`Authorization``Bearer ` (siehe [Authentifizierung](/de/dual-api/developers/api-reference/authentication))`Content-Type``application/json` Pfadparameter FeldTypErforderlichBeschreibung`processId`stringjaProzess-ID, die bei der Erstellung in `process.id` zurückgegeben wurde. Body-Parameter FeldTypErforderlichBeschreibung`duiType`enumjaDokumenttyp. Werte: `DUI_TYPE_BR_CPF`, `DUI_TYPE_MX_CURP`, `DUI_TYPE_US_SSN`. Dieser Endpunkt unterstützt eine Teilmenge der von [Prozess erstellen](/de/dual-api/developers/api-reference/web-sdk/post-process) akzeptierten Dokumenttypen -- Custom Flows, die optionale Dokumenterstellung erlauben, werden derzeit gegen diese engere Liste validiert.`duiValue`stringjaDokumentnummer, ohne Formatierung. Maximal 320 Zeichen (unterstützt kodierte oder zusammengesetzte Kennungen; Standard-Dokumentnummern wie CPF oder CURP sind deutlich kürzer). ### Beispiel​ cURLNode.js``` curl -X POST https://api.idcloud.unico.app/client/v1/process/abc-123/document \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678901" }' ``` ``` import fetch from 'node-fetch';const res = await fetch( 'https://api.idcloud.unico.app/client/v1/process/abc-123/document', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.UNICO_ACCESS_TOKEN}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ duiType: 'DUI_TYPE_BR_CPF', duiValue: '12345678901', }), });const { process: proc } = await res.json();// proc.id, proc.person.duiType, proc.person.duiValue ``` ### Antworten​ 200 OK ``` { "process": { "id": "abc-123", "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678901" } }} ``` FeldTypBeschreibung`process.id`stringProzesskennung.`process.person.duiType`stringFür den Prozess gesetzter Dokumenttyp.`process.person.duiValue`stringFür den Prozess gesetzter Dokumentwert. ### Fehlercodes​ 400 Bad Request401 Unauthorized404 Not Found429 Too Many Requests500 Internal Server ErrorCodeNachrichtBeschreibung`3``process id is invalid`Wenn die Prozess-ID ungültig ist.`3``dui_type is required`Wenn der Dokumenttyp nicht angegeben wurde.`3``dui_value is required`Wenn die Dokumentnummer nicht angegeben wurde.`3``dui_value exceeds maximum length`Wenn die Dokumentnummer die maximale Zeichenanzahl überschreitet.`9``process is not awaiting for document`Wenn der angegebene Prozess keine Dokumenteinreichung akzeptiert.`9``process expired`Wenn der angegebene Prozess abgelaufen ist.`9``document already set, cannot be modified`Wenn dem Prozess bereits ein Dokument zugeordnet ist.`9``process already finished`Wenn der Prozess bereits abgeschlossen wurde.`9``flow does not allow optional document`Wenn das Dokument für den vom Prozess ausgeführten Flow obligatorisch ist.Bearer-Token fehlt, ist abgelaufen oder ungültig. Siehe [Authentifizierung](/de/dual-api/developers/api-reference/authentication).NachrichtBeschreibungJwt header is an invalid JSONWenn das verwendete Access-Token falsche Zeichen enthält.Jwt is expiredWenn das verwendete Access-Token abgelaufen ist.CodeNachrichtBeschreibung`5``error getting process: rpc error: code = NotFound desc = process not found`Wenn die Prozess-ID nicht gefunden wurde.Rate-Limit erreicht. Wenn Ihr System einen HTTP-429-Fehler empfängt, müssen Sie Mechanismen implementieren, um Kaskadenausfä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 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. **Exponentielles Backoff mit Jitter:** Erhöhen Sie beim Wiederholen 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 wartenden Anfragen exakt zur gleichen Millisekunde erneut gesendet werden. WarnungDas kontinuierliche Ansteuern eines rate-limitierten Endpunkts ohne Backoff kann **die Einschränkungsdauer verlängern** und den operativen Durchsatz Ihres Systems erheblich beeinträchtigen. Ordnungsgemäßes Drosseln der Anfragen auf Ihrer Seite gewährleistet eine reibungslosere und widerstandsfähigere Integration.Für Standardlimits, Erhöhungsanfragen und weitere Details siehe [Rate-Limits](/de/dual-api/developers/api-reference/rate-limits).CodeNachrichtBeschreibung`99999``Internal failure! Try again later`Wenn ein interner Fehler auftritt. ### Nächste Schritte​ Nach dem Setzen des Dokuments setzt der Prozess seine Pipeline fort. Rufen Sie [Prozess abrufen](/de/dual-api/developers/api-reference/web-sdk/get-process) auf, um das Ergebnis abzurufen, oder warten Sie auf den [Webhook](/de/developers/webhooks-and-events). Zuletzt aktualisiert am 8. Okt. 2026**