--- 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/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)LK60Sri-lankische NICLU48Luxemburgische 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**