--- title: Wiederverarbeitung und Import biometrischer Datenbanken description: Leitfaden zur Wiederverarbeitung biometrischer Datensätze oder zum Import einer biometrischen Datenbank in die Unico-Plattform. canonical: https://developer.unico.io/de/dual-api/resources/reprocessing locale: de generated_by: markdown-export --- - [/de/](/de/) - Ressourcen - Wiederverarbeitung und Import biometrischer Datenbanken **Auf dieser Seite# Wiederverarbeitung und Import biometrischer Datenbanken Dieser Leitfaden beschreibt, wie Sie eine **Wiederverarbeitung** oder einen **Import biometrischer Datenbanken** auf der Unico-Plattform durchführen. Er beschreibt die technischen und betrieblichen Anforderungen für eine effektive, sichere Integration gemäß den Best Practices der Plattform. ### Umfang​ Dieses Material umfasst zwei Arten von Prozessen: **Wiederverarbeitung**: Erneute Verarbeitung biometrischer Datensätze von Benutzern, die bereits die Datenbank des Kunden und von Unico durchlaufen haben, zur Neubewertung oder Migration zwischen Systemen. **Import biometrischer Datenbanken**: Erstmaliges Hochladen oder Aktualisieren einer Datenbank mit Selfies zur Identitätsprüfung und/oder zur Betrugsrisikoeinstufung. **Import von Dokumentendatenbanken**: Hochladen einer Dokumentendatenbank zusammen mit Selfies für die Facematch- oder CPF-Match-Verifizierung (nur Brasilien). ### Voraussetzungen​ Der Kunde **muss einen aktiven Vertrag oder eine NDA** mit Unico unterzeichnet haben und sich in der Integrationsphase befinden (Ausnahme bei Genehmigung durch das Governance-Team). Das Projekt folgt formellen **TPS-Vereinbarungen (Transaktionen pro Sekunde)**. Siehe [TPS-Vereinbarung](#tps-agreement) unten. Vor Erhalt der Produktionszugangsdaten ist eine **vollständige Integrations-Homologation obligatorisch**, um Datenqualität, Payload-Konformität und stabile Leistung sicherzustellen. Ein **dediziertes Dienstkonto** muss für die Wiederverarbeitung oder den Import erstellt werden (z.B. "Reprocessing" oder "Legacy_Import"). Ein **dedizierter API Key** wird speziell für die Wiederverarbeitung/den Import erstellt. **(Optional)** Eine dedizierte Niederlassung kann für die Wiederverarbeitung/den Import erstellt werden. Dieser Parameter wird im Payload als `subsidiaryId` identifiziert. Siehe [Payload-Parameter](#payload-parameters) unten. Der API Key und das Dienstkonto **werden deaktiviert** nach dem vereinbarten Zeitraum oder Abschluss der Verarbeitung. ### Verfügbare Capabilities​ CapabilityBeschreibung**Identitätsprüfung**Überprüft, ob das eingereichte Selfie dem tatsächlichen Inhaber des Identifikators gehört.**Betrugsrisikoklassifizierung**Prüft, ob eine Historie betrügerischen Verhaltens mit diesem Gesicht verbunden ist.**Facematch**Überprüft, ob das Dokumentfoto mit dem eingereichten Selfie übereinstimmt.**CPF Match** Brazil onlyÜberprüft, ob die angegebene CPF mit der auf dem Dokument gedruckten CPF-Nummer übereinstimmt. Hinweis: Nicht alle RGs haben die CPF aufgedruckt. ### Selfie-Anforderungen​ Muss im **base64**-Format eingereicht werden. Das Bild muss dem **ICAO-Standard** entsprechen (heller Hintergrund, zentriertes Gesicht, keine Accessoires, die die Identifizierung behindern, angemessene Beleuchtung). Empfohlene Abmessungen: **1080x1920** (Hochformat) oder **1920x1080** (Querformat). Maximale Größe: **800 KB** (bei Bedarf mit JPEG 92 komprimieren). Ausrichtung: **Hochformat**. ### Dokumentenanforderungen​ **Unterstützte Dokumenttypen**: Siehe [Dokumentenerfassung und Wiederverwendung — Unterstützte Dokumente](/de/capabilities/document-reuse-and-capture#supported-documents). Die Bilder müssen sowohl die **Vorder- als auch die Rückseite** des Dokuments vollständig und ohne Beschneidung zeigen. Das Dokument muss **lesbar** sein — klar, gut beleuchtet und frei von Verdeckungen. ### TPS-Vereinbarung​ Die maximal vereinbarte TPS für dieses Projekt beträgt **10 TPS**. Verteilen Sie Anfragen gleichmäßig über die Zeit, anstatt sie in großen Schüben zu senden. Dieses Limit **darf nicht überschritten werden** ohne formelle Genehmigung des Unico-Teams. Anfragen über dem Limit können automatisch verworfen oder blockiert werden. Wenn eine vorübergehende Erhöhung erforderlich ist, ist eine **formelle vorherige Vereinbarung** notwendig. ### Integration​ #### Endpunkte​ UmgebungBasis-URLZugangHinweiseStaging`https://api.id.uat.unico.app`OffenObligatorisch für TestsProduktion`https://api.id.unico.app`Nur nach genehmigter HomologationErfordert strikte TPS-Kontrolle #### Erforderliche Header​ ``` Authorization: Bearer {access_token}APIKEY: {your_api_key}Content-Type: application/json ``` #### Payload-Parameter​ ``` { "subject": { "duiType": 1, "code": "11032395702", "name": "User Name", "email": "username@gmail.io", "phone": "21998571922", "birthDate": "30/07/1989", "gender": "M" }, "useCase": "Reprocessamento/Importação", "subsidiaryId": "35d734c4-7fbb-4b2f-a1dc-7e1575514819", "imageBase64": "/9j/4AAQSkZJR...", "document": { "purpose": "Reprocessamento", "documentId": "doc-001", "files": [ { "data": "doc_base64_frente", "faceDocumentMatch": true }, { "data": "doc_base64_verso" } ] }} ``` FeldTypErforderlichBeschreibung`subject`objectJaBenutzeridentifikationsdaten.`subject.duiType`integerJaDokumenttypkennung. Siehe [`duiType`-Werte](#duitype-values) unten.`subject.code`stringJaCPF oder anderer Benutzeridentifikator.`subject.name`stringJaVollständiger Name des Benutzers.`subject.email`stringNeinE-Mail des Benutzers.`subject.phone`stringNeinTelefonnummer des Benutzers.`subject.birthDate`stringNeinGeburtsdatum des Benutzers (`DD/MM/YYYY`).`subject.gender`stringNeinGeschlecht des Benutzers (`M` oder `F`).`useCase`stringJaName des Anwendungsfalls ("Reprocessamento" oder "Importação de base").`subsidiaryId`stringNeinNiederlassungs-UUID (von Unico bereitgestellt).`imageBase64`base64JaSelfie-Bild des Benutzers, in base64 konvertiert.`document`objectNeinDokumentdaten, die dem Prozess zugeordnet sind.`document.purpose`stringNeinDokumentzweck (z.B. `"Reprocessamento"`).`document.documentId`stringNeinDokumentkennung.`document.files`arrayNeinListe der Dokumentbilddateien.`document.files[].data`base64NeinDokumentbild, in base64 konvertiert.`document.files[].faceDocumentMatch`booleanNeinGibt an, ob das Gesicht im Dokument mit dem eingereichten Selfie übereinstimmt. **`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 #### Wichtige Hinweise​ Das Selfie **muss dem ICAO-Standard** mit angemessener Qualität und Beleuchtung entsprechen. Das Selfie muss im **base64-Format** vorliegen. Vermeiden Sie Masseneinreichungen ohne TPS-Kontrolle — dies kann eine Ratenbegrenzung auslösen (siehe [Fehlerbehandlung](#error-handling) unten). Testen Sie Daten und Integration immer zuerst in der Staging-Umgebung. #### Antworten​ **Erfolg — 200 OK** Ohne DokumentMit Dokument (Facematch)``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "unicoId": { "result": "inconclusive" }, "identityFraudsters": { "result": "inconclusive" }} ``` FeldTypBeschreibung`id`stringProzessidentifikator. Speichern Sie ihn für zukünftige Abfragen oder falls Sie später die 1:1-Validierung implementieren.`status`integerTransaktionsstatus.`unicoId.result`stringAntwort der Identitätsprüfungs-Capability.`identityFraudsters.result`stringAntwort der Betrugsrisikoklassifizierungs-Capability.``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "score": 0, "status": 3, "unicoId": { "result": "yes" }, "faceDocumentMatch": { "faceMatch": true }, "identityFraudsters": { "result": "yes" }} ``` FeldTypBeschreibung`id`stringProzessidentifikator. Speichern Sie ihn für zukünftige Abfragen oder falls Sie später die 1:1-Validierung implementieren.`status`integerTransaktionsstatus.`score`numberFacematch-Bewertung.`unicoId.result`stringAntwort der Identitätsprüfungs-Capability.`faceDocumentMatch.faceMatch`booleanOb das Dokumentfoto mit dem eingereichten Selfie übereinstimmt.`identityFraudsters.result`stringAntwort der Betrugsrisikoklassifizierungs-Capability. **Bildverarbeitungsfehler** ``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 5} ``` **Häufige Fehler** Codes im Bereich `4xx` weisen auf Validierungsfehler der bereitgestellten Daten hin. Codes im Bereich `5xx` weisen auf serverseitige Fehler hin. HTTP-CodeFehlertypWahrscheinliche UrsacheEmpfohlene Maßnahme`400`Bad RequestUngültiger PayloadStruktur und Inhalt validieren.`401`UnauthorizedAbgelaufener oder ungültiger TokenToken erneuern.`403`ForbiddenFalscher API Key oder unzureichende BerechtigungenZugangsdaten überprüfen.`429`Too Many RequestsAnfragerate überschrittenWarten und TPS-Limit einhalten.`500+`Internal Server ErrorInterner FehlerNach einigen Sekunden erneut versuchen; bei anhaltendem Fehler ein Ticket eröffnen. ### Fehlerbehandlung​ **Rate Limit (HTTP 429)** muss sorgfältig überwacht werden. Anfragenüberlastung kann die Pipeline blockieren. Halten Sie stets die mit Unico vereinbarten TPS ein (siehe [TPS-Vereinbarung](#tps-agreement)). Bei anhaltenden Fehlern (5xx) führen Sie eine erneute Verarbeitung mit Retry/Backoff-Kontrolle durch. Zuletzt aktualisiert am 8. Okt. 2026**