--- title: Dokumentenprozess erstellen description: Ein neues Dokument erfassen oder ein zuvor erfasstes, das mit einem biometrischen Prozess verknüpft ist, wiederverwenden. canonical: https://developer.unico.io/de/dual-api/developers/api-reference/api/post-processes-document locale: de generated_by: markdown-export --- - [/de/](/de/) - [API-Referenz](/de/dual-api/developers/api-reference/) - [API](/de/dual-api/developers/api-reference/api/) - Dokumentenprozess erstellen **Auf dieser Seite# Dokumentenprozess erstellen Dieser Endpunkt verarbeitet zwei Dokumentenabläufe, die denselben Pfad verwenden, sich aber in den Body-Parametern unterscheiden: **Neue Erfassung** — übermittelt Dokumentbild(er) in base64 zur Verarbeitung (`document.files` erforderlich). **Wiederverwendung** — überspringt die Erfassung durch Verweis auf ein zuvor erfasstes Dokument (`document.documentId` erforderlich). Der aktive Ablauf wird dadurch bestimmt, ob `document.documentId` im Anfrage-Body angegeben ist. Verwenden Sie vor der Erstellung eines Dokumentenprozesses [Wiederverwendbare Dokumente abrufen](/de/dual-api/developers/api-reference/api/get-document), um zu prüfen, ob der Benutzer bereits ein Dokument zur Wiederverwendung verfügbar hat. Den vollständigen Integrationsablauf finden Sie in der [API-Übersicht](/de/dual-api/developers/api-reference/api/). ### Endpunkt​ UmgebungURL**Produktion**`POST https://api.id.unico.app/processes/v1`**Sandbox**`POST https://api.id.uat.unico.app/processes/v1` ### Anfrage​ Header HeaderWert`Authorization``Bearer ` (siehe [Authentifizierung](/de/dual-api/developers/api-reference/authentication))`APIKEY`Bereitgestellter API-Schlüssel mit aktivierter Dokumentenerfassung und Wiederverwendung.`Content-Type``application/json` Body-Parameter Neue ErfassungWiederverwendungFeldTypErforderlichBeschreibung`subject.duiType`integerjaDokumenttypkennung. Siehe [`duiType`-Werte](#duitype-values) unten.`subject.code`stringjaBenutzerkennung gemäß `subject.duiType`. Ohne Punkte oder Bindestriche.`subject.name`stringneinVollständiger Name.`subject.gender`stringnein`M` oder `F`.`subject.birthDate`string (ISO 8601)neinGeburtsdatum (`YYYY-MM-DD`).`subject.email`stringneinE-Mail-Adresse.`subject.phone`stringneinTelefonnummer im E.164-Format.`document.purpose`stringjaGeschäftszweck. Werte: `creditprocess`, `carpurchase`, `paybypaycheck`, `onboarding`, `fgts`.`document.authProcessId`stringjaID des biometrischen Prozesses, der mit dieser Dokumentenerfassung verknüpft ist.`document.files`arrayjaDokumentbilder in base64 (Vorder- und/oder Rückseite).`document.files[].data`stringjaDokumentbild in base64 (PNG, JPEG oder WebP, max. 800 KB).`subsidiaryId`stringneinZweig-ID — nur erforderlich, wenn mehrere Zweige vorhanden sind.FeldTypErforderlichBeschreibung`subject.duiType`integerjaDokumenttypkennung. Siehe [`duiType`-Werte](#duitype-values) unten.`subject.code`stringjaBenutzerkennung gemäß `subject.duiType`. Ohne Punkte oder Bindestriche.`subject.name`stringneinVollständiger Name.`subject.gender`stringnein`M` oder `F`.`subject.birthDate`string (ISO 8601)neinGeburtsdatum (`YYYY-MM-DD`).`subject.email`stringneinE-Mail-Adresse.`subject.phone`stringneinTelefonnummer im E.164-Format.`document.purpose`stringjaGeschäftszweck. Werte: `creditprocess`, `carpurchase`, `paybypaycheck`, `onboarding`, `fgts`.`document.authProcessId`stringjaID des biometrischen Prozesses, der mit diesem Dokument verknüpft ist.`document.documentId`stringjaID eines zuvor erfassten Dokuments (abgerufen über [Wiederverwendbare Dokumente abrufen](/de/dual-api/developers/api-reference/api/get-document)). Wenn angegeben, kann `document.files` weggelassen werden.`subsidiaryId`stringneinZweig-ID — nur erforderlich, wenn mehrere Zweige vorhanden sind. **`duiType`-Werte**LandCodeBeschreibungAR6Argentinischer ReisepassAR7Argentinische DNIAR49Argentinischer Führerschein (Licencia Nacional de Conducir)AT34Österreichische Steuernummer (STNR)BE36Belgische Nationalnummer (NN)BR1Brasilianische CPFBR5Brasilianischer ReisepassBR14Brasilianische CNPJCA28Kanadische SINCH33Schweizer AHV/AVS-NummerCL9Chilenische RUNCL52Chilenischer ReisepassCL57Chilenischer Führerschein (Licencia de Conducir)CO26Kolumbianische NITCO53Kolumbianischer ReisepassCO55Kolumbianischer Führerschein (Licencia de Conducción)CO56Kolumbianischer Bürgerausweis (Cédula de Ciudadanía)DE41Deutsche Steuer-Identifikationsnummer (IdNr)DK29Dänische CPREC10Ecuadorianische NIES50Spanische Ausländer-Identifikationsnummer (NIE)ES51Spanischer Personalausweis (DNI)FI35Finnische Personenkennung (HETU)FR46Französische Steuerreferenznummer (SPI)GB30Britische Sozialversicherungsnummer (NINO)GT12Guatemaltekische CUIID16Indonesische NIKIE47Irische Sozialversicherungsnummer (PPSN)IT37Italienischer Codice Fiscale (CF)LU48Luxemburgische nationale Identifikationsnummer (Matricule)MX2Mexikanische CURPMX25Mexikanische RFC (Persona Física)MX58Mexikanischer Führerschein (Licencia de Conducir)NG8Nigerianische NINNG20Nigerianische Bankverifizierungsnummer (BVN)NG43Nigerianisches BVN-Token (gehasht)NG44Nigerianisches NIN-Token (gehasht)NL42Niederländische Bürgerservicenummer (BSN)NO39Norwegische nationale Identitätsnummer (Fødselsnummer)PE27Peruanische RUCPE40Peruanische DNIPE54Peruanischer ReisepassPL31Polnische PESELPT45Portugiesische Steueridentifikationsnummer (NIF)SE32Schwedische Personennummer (PNR)SE38Schwedische Koordinierungsnummer (Samordningsnummer)TR24Türkische Identifikationsnummer (TCKN)US4US-amerikanische SSNUS11US-amerikanischer ReisepassUS18US-amerikanischer FührerscheinUS21US-amerikanische PasskarteUS22US-amerikanischer Polycarbonat-ReisepassUS23US-amerikanische ID-KarteUY13Uruguayische CIZZ15E-Mail-AdresseZZ17Telefonnummer—0Nicht angegeben—3Interner Unico-Identifikator ### Beispiel​ Neue Erfassung — cURLNeue Erfassung — Node.jsWiederverwendung — cURLWiederverwendung — Node.js``` curl -X POST https://api.id.unico.app/processes/v1 \ -H "Authorization: Bearer $TOKEN" \ -H "APIKEY: $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "subject": { "duiType": 1, "code": "12345678909", "name": "Luke Skywalker" }, "document": { "purpose": "onboarding", "authProcessId": "80371b2a-3ac7-432e-866d-57fe37896ac6", "files": [ { "data": "/9j/4AAQSkZJR..." } ] } }' ``` ``` import fetch from 'node-fetch';const res = await fetch('https://api.id.unico.app/processes/v1', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.UNICO_ACCESS_TOKEN}`, 'APIKEY': process.env.UNICO_API_KEY, 'Content-Type': 'application/json' }, body: JSON.stringify({ subject: { duiType: 1, code: '12345678909', name: 'Luke Skywalker' }, document: { purpose: 'onboarding', authProcessId: '80371b2a-3ac7-432e-866d-57fe37896ac6', files: [{ data: documentImageBase64 }] } })});const result = await res.json(); ``` ``` curl -X POST https://api.id.unico.app/processes/v1 \ -H "Authorization: Bearer $TOKEN" \ -H "APIKEY: $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "subject": { "duiType": 1, "code": "12345678909" }, "document": { "purpose": "onboarding", "authProcessId": "80371b2a-3ac7-432e-866d-57fe37896ac6", "documentId": "doc-abc-123" } }' ``` ``` import fetch from 'node-fetch';const res = await fetch('https://api.id.unico.app/processes/v1', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.UNICO_ACCESS_TOKEN}`, 'APIKEY': process.env.UNICO_API_KEY, 'Content-Type': 'application/json' }, body: JSON.stringify({ subject: { duiType: 1, code: '12345678909' }, document: { purpose: 'onboarding', authProcessId: '80371b2a-3ac7-432e-866d-57fe37896ac6', documentId: 'doc-abc-123' } })});const result = await res.json(); ``` ### Antworten​ 200 OK ``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "document": { "id": "doc-abc-123", "type": "unico.moja.dictionary.br.cnh.v2.Cnh", "cpfMatch": true, "faceMatch": true, "content": { "numero": "12345678", "nomeCivil": "Luke Skywalker", "dataNascimento": "2000-05-20T00:00:00Z", "categoria": "B", "dataExpiracao": "2030-05-20T00:00:00Z" }, "fileUrls": [ "https://storage.unico.app/documents/doc-abc-123/front.jpg" ] }} ``` FeldTypBeschreibung`id`string (UUID)Prozesskennung.`status`integer`3` (erfolgreich abgeschlossen), `5` (mit Fehler abgeschlossen).`document.id`stringKennung des erfassten Dokuments. Verwenden Sie diesen Wert in zukünftigen `document.documentId`-Anfragen zur Wiederverwendung.`document.type`stringIdentifizierter Dokumenttyp als vollständig qualifizierter Wörterbuchname. Siehe [`document.type`-Werte](#document-type-values) unten.`document.cpfMatch`boolean`true`, wenn die aus dem Dokument extrahierte Kennung mit `subject.code` übereinstimmt.`document.faceMatch`boolean`true`, wenn das Gesicht im Dokument mit dem biometrischen Selfie aus `document.authProcessId` übereinstimmt.`document.content`objectPer OCR extrahierte Felder. Struktur variiert je nach Dokumenttyp — [hier klicken für Felddetails](/de/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json).`document.fileUrls`arrayTemporäre URLs (10-minütige Gültigkeit) zum Herunterladen der Dokumentbilder. In `document.content` sind nur die erfolgreich extrahierten Felder enthalten; alles, was die OCR nicht lesen konnte, wird weggelassen und nicht leer zurückgegeben. **`document.type`-Werte**Einheitliches SchemaAlle Dokumenttypen, die das einheitliche Schema verwenden — `unified_schema` in der [Feldreferenz](/de/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json) — werden in `document.type` als `unico.moja.dictionary..generic.v1.` zurückgegeben, wobei `` der ISO 3166-1 alpha-2 Code in Kleinbuchstaben und `` der identifizierte Typ ist. Zum Beispiel: `unico.moja.dictionary.ar.generic.v1.IdCard`: Argentinischer Personalausweis `unico.moja.dictionary.us.generic.v1.PolycarbonatePassport`: US-Reisepass aus Polycarbonat Spezifische SchemataDokumenttypen, die ihr eigenes Feldschema verwenden — aufgeführt unter `specific_document_schemas` in der [Feldreferenz](/de/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json) — sind in der folgenden Tabelle aufgelistet:LandWertDokumentBR`unico.moja.dictionary.br.rg.v2.Rg`RGBR`unico.moja.dictionary.br.cnh.v2.Cnh`CNH (Führerschein)BR`unico.moja.dictionary.br.cin.v1.Cin`CINBR`unico.moja.dictionary.br.passaporte.v1.Passaporte`ReisepassMX`unico.moja.dictionary.mx.ine.v1.Ine`INE-WählerausweisMX`unico.moja.dictionary.mx.lpc.v1.Lpc`Licencia para conducir (Führerschein)MX`unico.moja.dictionary.mx.pasaporte.v1.Pasaporte`Reisepass—`unico.moja.dictionary.other.unknown.v1.Unknown`Typ konnte nicht identifiziert werden — `document.content` ist leerEs erfolgt keine OCR-Extraktion und es wird kein Feld zurückgegeben, wenn `document.type` `unico.moja.dictionary.other.unknown.v1.Unknown` ist. ### Fehlercodes​ 400 Bad Request403 Forbidden409 Conflict500 Internal Server ErrorCodeMeldungBeschreibung`99989`The document is invalid.Das `document`-Objekt hat eine ungültige Struktur.`99988`The document is empty.Das `document`-Objekt fehlt im Anfrage-Body.`20900`O base64 informado não é válido.Der base64-Parameter ist ungültig. Mögliche Ursachen: kein Bild oder Injektionsversuch.`20807`A imagem precisa estar no padrão HD ou possuir uma resolução superior a 640 x 480.Die Auflösung des hochgeladenen Bildes ist zu niedrig.`20509`The subject.name field is invalid.`subject.name` enthält ungültige Zeichen.`20508`The subject.gender field is invalid.`subject.gender` muss `M` oder `F` sein.`20507`O parâmetro subject.code é inválido.Nicht standardmäßiger oder nicht vorhandener Kennungswert.`20506`O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.Bildgröße überschreitet 800 KB; mit JPEG92 komprimieren.`20505`O base64 informado não é suportado. Os formatos aceitos são png, jpeg e webp.Das base64-Format ist ungültig oder nicht unterstützt.`20068`The document.documentId or document.files parameter must be present.Weder `document.documentId` noch `document.files` wurden angegeben.`20067`The document.purpose parameter is invalid.Unbekannter Wert in `document.purpose`.`20066`The document.authProcessId parameter is invalid.Ungültiger Wert in `document.authProcessId`.`20062`The useCase field is invalid.Unbekannter Wert im Feld `useCase`.`20021`The subject.phone field is invalid.Format von `subject.phone` ist ungültig (IDD + Vorwahl + Nummer, 13 Zeichen).`20019`The subject.birthDate field is invalid.`subject.birthDate` entspricht nicht dem ISO-8601-Format (`YYYY-MM-DD`).`20009`O parâmetro imagebase64 não foi informado.Der Dokumentbildparameter fehlt.`20008`The subject.email field is invalid.Ungültiges E-Mail-Format in `subject.email`.`20005`O parâmetro subject.code não foi informado.Der Parameter subject.code fehlt.`20004`O parâmetro subject não foi informado.Der Parameter subject fehlt.`20003`The request body is missing or invalid.Null oder ungültiger Payload.`20002`O parâmetro APIKey não foi informado.Der APIKEY-Parameter fehlt im Anfrage-Header.`20001`O parâmetro authtoken não foi informado.Der Integrationstoken-Parameter fehlt im Anfrage-Header.`10508`The JWT with the captured face has already been used.Das JWT kann nur einmal verwendet werden.`10507`The JWT with the captured face is expired.JWT abgelaufen; muss innerhalb von 10 Minuten gesendet werden.`10506`The imageBase64 field is not a valid JWT from SDK.Das `imageBase64` ist kein gültiger JWT des SDK.Bearer-Token oder `APIKEY` fehlt, ist abgelaufen oder ungültig. Siehe [Authentifizierung](/de/dual-api/developers/api-reference/authentication).CodeMeldungBeschreibung`30017`User does not have permission to perform this action.Fehlerhafter JWT oder Benutzer ohne Berechtigung für diesen Vorgang.`10502`O token informado está expirado.Der Access-Token ist abgelaufen.`10501`O token informado é inválido.Das Authentifizierungstoken ist ungültig.`10201`O AppKey informado é inválido.Der APIKEY ist ungültig oder existiert nicht.CodeMeldungBeschreibung`20073`The processID already exists.Die angegebene `processId` existiert bereits für diesen Mandanten.CodeMeldungBeschreibung`99999`Internal failure! Try again laterBei einem internen Fehler. ### Nächste Schritte​ Um zu prüfen, ob ein Dokument vor diesem Aufruf bereits verfügbar ist, siehe [Wiederverwendbare Dokumente abrufen](/de/dual-api/developers/api-reference/api/get-document). Zur Erstellung des biometrischen Prozesses (erforderlich für `document.authProcessId`) siehe [Prozess erstellen](/de/dual-api/developers/api-reference/api/post-processes). Zuletzt aktualisiert am 8. Okt. 2026**