--- title: Reprocesamiento e importación de base biométrica description: Guía para reprocesar registros biométricos o importar una base biométrica en la plataforma Unico. canonical: https://developer.unico.io/es/dual-api/resources/reprocessing locale: es generated_by: markdown-export --- - [/es/](/es/) - Recursos - Reprocesamiento e importación de base biométrica **En esta página# Reprocesamiento e importación de base biométrica Esta guía cubre cómo realizar el **reprocesamiento** o la **importación de base biométrica** en la plataforma Unico. Detalla los requisitos técnicos y operativos para una integración efectiva y segura siguiendo las mejores prácticas de la plataforma. ### Alcance​ Este material cubre dos tipos de procesos: **Reprocesamiento**: reprocesamiento de registros biométricos de usuarios que ya pasaron por la base del cliente y de Unico para reevaluación o migración entre sistemas. **Importación de base biométrica**: carga inicial o actualización de una base que contiene selfies para verificación de identidad y/o clasificación de riesgo. **Importación de base de documentos**: carga de una base de documentos junto con selfies para verificación por Facematch o CPF Match (solo Brasil). ### Prerrequisitos​ El cliente **debe tener un contrato activo o NDA** firmado con Unico y estar en la fase de integración (excepción si es aprobado por el equipo de gobernanza). El proyecto seguirá **acuerdos formales de TPS (transacciones por segundo)**. Consulte [Acuerdo de TPS](#tps-agreement) a continuación. Antes de obtener credenciales de producción, **la homologación completa de integración es obligatoria** para asegurar la calidad de los datos, el cumplimiento del payload y un rendimiento estable. Se debe crear una **cuenta de servicio dedicada** para el reprocesamiento o importación (por ejemplo, "Reprocessing" o "Legacy_Import"). Se creará una **API Key dedicada** específicamente para el reprocesamiento/importación. **(Opcional)** Se puede crear una subsidiaria dedicada para el reprocesamiento/importación. Este parámetro se identifica en el payload como `subsidiaryId`. Consulte [Parámetros del payload](#payload-parameters) a continuación. La API Key y la cuenta de servicio **se desactivarán** después del período acordado o al completarse el procesamiento. ### Capacidades disponibles​ CapacidadDescripción**Verificación de Identidad**Verifica si la selfie enviada pertenece al titular real del identificador.**Clasificación de riesgo de fraude**Comprueba si existe un historial de comportamiento fraudulento asociado a ese rostro.**Facematch**Verifica si la foto del documento coincide con la selfie enviada.**CPF Match** Brazil onlyVerifica si el CPF proporcionado coincide con el número de CPF impreso en el documento. Nota: no todos los RGs tienen el CPF impreso. ### Requisitos de selfie​ Debe enviarse en formato **base64**. La imagen debe cumplir con el **estándar ICAO** (fondo claro, rostro centrado, sin accesorios que obstruyan la identificación, iluminación adecuada). Dimensiones recomendadas: **1080x1920** (vertical) o **1920x1080** (horizontal). Tamaño máximo: **800 KB** (comprimir con JPEG 92 si es necesario). Orientación: **vertical (portrait)**. ### Requisitos del documento​ **Tipos de documentos admitidos**: consulte [Captura de Documentos y Reutilización — Documentos admitidos](/es/capabilities/document-reuse-and-capture#supported-documents). Las imágenes deben incluir tanto el **anverso como el reverso** del documento, completamente visibles sin recorte. El documento debe ser **legible** — claro, bien iluminado y libre de obstrucciones. ### Acuerdo de TPS​ El TPS máximo acordado para este proyecto es **10 TPS**. Distribuya las solicitudes uniformemente a lo largo del tiempo en lugar de enviarlas en grandes ráfagas. Este límite **no debe superarse** sin aprobación formal del equipo de Unico. Las solicitudes que superen el límite pueden ser descartadas o bloqueadas automáticamente. Si se necesita un aumento temporal, se requiere un **acuerdo formal previo**. ### Integración​ #### Endpoints​ EntornoURL baseAccesoNotasStaging`https://api.id.uat.unico.app`AbiertoObligatorio para pruebasProducción`https://api.id.unico.app`Solo después de homologación aprobadaRequiere control estricto de TPS #### Headers requeridos​ ``` Authorization: Bearer {access_token}APIKEY: {your_api_key}Content-Type: application/json ``` #### Parámetros del payload​ ``` { "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" } ] }} ``` CampoTipoRequeridoDescripción`subject`objectSíDatos de identificación del usuario.`subject.duiType`integerSíIdentificador del tipo de documento. Consulte [valores de `duiType`](#duitype-values) a continuación.`subject.code`stringSíCPF u otro identificador del usuario.`subject.name`stringSíNombre completo del usuario.`subject.email`stringNoCorreo electrónico del usuario.`subject.phone`stringNoNúmero de teléfono del usuario.`subject.birthDate`stringNoFecha de nacimiento del usuario (`DD/MM/YYYY`).`subject.gender`stringNoGénero del usuario (`M` o `F`).`useCase`stringSíNombre del caso de uso ("Reprocessamento" o "Importação de base").`subsidiaryId`stringNoUUID de la subsidiaria (proporcionado por Unico).`imageBase64`base64SíImagen de selfie del usuario convertida a base64.`document`objectNoDatos del documento asociado al proceso.`document.purpose`stringNoPropósito del documento (por ejemplo, `"Reprocessamento"`).`document.documentId`stringNoIdentificador del documento.`document.files`arrayNoLista de archivos de imágenes del documento.`document.files[].data`base64NoImagen del documento convertida a base64.`document.files[].faceDocumentMatch`booleanNoIndica si el rostro en el documento coincide con la selfie enviada. **Valores de `duiType`**PaísCódigoDescripciónAR6Pasaporte argentinoAR7DNI argentinoAR49Licencia de conducir argentina (Licencia Nacional de Conducir)AT34Número de impuesto austríaco (STNR)BE36Número Nacional belga (NN)BR1CPF brasileñoBR5Pasaporte brasileñoBR14CNPJ brasileñoCA28SIN canadienseCH33Número AHV/AVS suizoCL9RUN chilenoCL52Pasaporte chilenoCL57Licencia de conducir chilena (Licencia de Conducir)CO26NIT colombianoCO53Pasaporte colombianoCO55Licencia de conducir colombiana (Licencia de Conducción)CO56Cédula de Ciudadanía colombiana (Cédula de Ciudadanía)DE41Número de Identificación Fiscal alemán (IdNr)DK29CPR danésEC10NI ecuatorianoES50Número de Identidad de Extranjero español (NIE)ES51Documento Nacional de Identidad español (DNI)FI35Código de identidad personal finlandés (HETU)FR46Número de Referencia Fiscal francés (SPI)GB30Número de Seguro Nacional británico (NINO)GT12CUI guatemaltecoID16NIK indonesioIE47Número de Seguro Social Personal irlandés (PPSN)IT37Código Fiscal italiano (CF)LU48Número de Identificación Nacional de Luxemburgo (Matricule)MX2CURP mexicanoMX25RFC mexicano (Persona Física)MX58Licencia de conducir mexicana (Licencia de Conducir)NG8NIN nigerianoNG20Número de Verificación Bancaria nigeriano (BVN)NG43Token BVN nigeriano (hash)NG44Token NIN nigeriano (hash)NL42Número de Servicio al Ciudadano holandés (BSN)NO39Número de Identidad Nacional noruego (Fødselsnummer)PE27RUC peruanoPE40DNI peruanoPE54Pasaporte peruanoPL31PESEL polacoPT45Número de Identificación Fiscal portugués (NIF)SE32Número personal sueco (PNR)SE38Número de Coordinación sueco (Samordningsnummer)TR24Número de Identificación turco (TCKN)US4SSN de Estados UnidosUS11Pasaporte de Estados UnidosUS18Licencia de conducir de Estados UnidosUS21Tarjeta de pasaporte de Estados UnidosUS22Pasaporte de policarbonato de Estados UnidosUS23Tarjeta de identificación de Estados UnidosUY13CI uruguayoZZ15Dirección de correo electrónicoZZ17Número de teléfono—0No especificado—3Identificador interno de Unico #### Notas importantes​ La selfie **debe cumplir con el estándar ICAO** con calidad e iluminación adecuadas. La selfie debe estar en **formato base64**. Evite envíos masivos sin control de TPS, ya que esto puede activar la limitación de tasa (consulte [Manejo de errores](#error-handling) a continuación). Siempre pruebe los datos y la integración en el entorno de staging primero. #### Respuestas​ **Éxito — 200 OK** Sin documentoCon documento (Facematch)``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "unicoId": { "result": "inconclusive" }, "identityFraudsters": { "result": "inconclusive" }} ``` CampoTipoDescripción`id`stringIdentificador del proceso. Almacénelo para consultas futuras o si implementa Validación (1:1) más adelante.`status`integerEstado de la transacción.`unicoId.result`stringRespuesta de la capacidad Verificación de Identidad.`identityFraudsters.result`stringRespuesta de la capacidad Clasificación de riesgo de fraude.``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "score": 0, "status": 3, "unicoId": { "result": "yes" }, "faceDocumentMatch": { "faceMatch": true }, "identityFraudsters": { "result": "yes" }} ``` CampoTipoDescripción`id`stringIdentificador del proceso. Almacénelo para consultas futuras o si implementa Validación (1:1) más adelante.`status`integerEstado de la transacción.`score`numberPuntuación de Facematch.`unicoId.result`stringRespuesta de la capacidad Verificación de Identidad.`faceDocumentMatch.faceMatch`booleanSi la foto del documento coincide con la selfie enviada.`identityFraudsters.result`stringRespuesta de la capacidad Clasificación de riesgo de fraude. **Error de procesamiento de imagen** ``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 5} ``` **Errores comunes** Los códigos en el rango `4xx` indican errores de validación con los datos proporcionados. Los códigos en el rango `5xx` indican fallos del lado del servidor. Código HTTPTipo de errorCausa probableAcción recomendada`400`Bad RequestPayload inválidoValide la estructura y el contenido.`401`UnauthorizedToken expirado o inválidoRegenere el token.`403`ForbiddenAPI Key incorrecta o permisos insuficientesVerifique las credenciales.`429`Too Many RequestsTasa de solicitudes excedidaEspere y respete el límite de TPS.`500+`Internal Server ErrorFallo internoReintente después de unos segundos; abra un ticket si persiste. ### Manejo de errores​ **Rate Limit (HTTP 429)** debe ser monitoreado cuidadosamente. La sobrecarga de solicitudes puede bloquear el pipeline. Siempre respete el TPS acordado con Unico (consulte [Acuerdo de TPS](#tps-agreement)). Para fallos persistentes (5xx), reprocese con control de reintentos/backoff. Última actualización el 8 oct 2026**