--- title: Reprocessamento e Importação de Base Biométrica description: Guia para reprocessamento de registros biométricos ou importação de base biométrica na plataforma Unico. canonical: https://developer.unico.io/pt-BR/dual-api/resources/reprocessing locale: pt-BR generated_by: markdown-export --- - [/pt-BR/](/pt-BR/) - Recursos - Reprocessamento e Importação de Base Biométrica **Nesta página# Reprocessamento e Importação de Base Biométrica Este guia aborda como realizar **reprocessamento** ou **importação de base biométrica** na plataforma Unico. Ele detalha os requisitos técnicos e operacionais para uma integração eficaz e segura, seguindo as melhores práticas da plataforma. ### Escopo​ Este material cobre dois tipos de processos: **Reprocessamento**: reprocessamento de registros biométricos de usuários que já passaram pela base do cliente e da Unico para reavaliação ou migração entre sistemas. **Importação de Base Biométrica**: upload inicial ou atualização de uma base contendo selfies para fins de verificação de identidade e/ou classificação de risco. **Importação de Base de Documentos**: upload de uma base de documentos junto com selfies para fins de verificação por Facematch ou CPF Match (somente Brasil). ### Pré-requisitos​ O cliente **deve ter um contrato ativo ou NDA** assinado com a Unico e estar na fase de integração (exceção se aprovado pela equipe de governança). O projeto seguirá **acordos formais de TPS (transações por segundo)**. Veja [Acordo de TPS](#acordo-de-tps) abaixo. Antes de obter credenciais de produção, **a homologação completa da integração é obrigatória** para garantir qualidade dos dados, conformidade do payload e desempenho estável. Uma **conta de serviço dedicada** deve ser criada para o reprocessamento ou importação (ex.: "Reprocessamento" ou "Legacy_Import"). Uma **API Key dedicada** será criada especificamente para o reprocessamento/importação. **(Opcional)** Uma subsidiária dedicada pode ser criada para o reprocessamento/importação. Este parâmetro é identificado no payload como `subsidiaryId`. Veja [Parâmetros do payload](#par%C3%A2metros-do-payload) abaixo. A API Key e a conta de serviço **serão desativadas** após o período acordado ou conclusão do processamento. ### Capacidades disponíveis​ CapacidadeDescrição**Verificação de Identidade**Verifica se a selfie enviada pertence ao real titular do identificador.**Classificação de risco de fraude**Verifica se há histórico de comportamento fraudulento associado àquele rosto.**Facematch**Verifica se a foto do documento corresponde à selfie enviada.**CPF Match** Brazil onlyVerifica se o CPF fornecido corresponde ao número de CPF impresso no documento. Observação: nem todos os RGs possuem o CPF impresso. ### Requisitos da selfie​ Deve ser enviada em formato **base64**. A imagem deve seguir o **padrão ICAO** (fundo claro, rosto centralizado, sem acessórios que obstruam a identificação, iluminação adequada). Dimensões recomendadas: **1080x1920** (retrato) ou **1920x1080** (paisagem). Tamanho máximo: **800 KB** (comprima com JPEG 92 se necessário). Orientação: **retrato**. ### Requisitos do documento​ **Tipos de documento suportados**: veja [Captura de Documentos e Reutilização — Documentos suportados](/pt-BR/capabilities/document-reuse-and-capture#supported-documents). As imagens devem incluir a **frente e o verso** do documento, totalmente visíveis e sem cortes. O documento deve estar **legível** — nítido, bem iluminado e livre de obstruções. ### Acordo de TPS​ O TPS máximo acordado para este projeto é de **10 TPS**. Distribua as requisições de forma uniforme ao longo do tempo em vez de enviá-las em grandes rajadas. Este limite **não deve ser excedido** sem aprovação formal da equipe Unico. Requisições acima do limite podem ser automaticamente descartadas ou bloqueadas. Se um aumento temporário for necessário, é exigido um **acordo formal prévio**. ### Integração​ #### Endpoints​ AmbienteURL BaseAcessoObservaçõesStaging`https://api.id.uat.unico.app`AbertoObrigatório para testesProdução`https://api.id.unico.app`Somente após homologação aprovadaRequer controle rigoroso de TPS #### Headers obrigatórios​ ``` Authorization: Bearer {access_token}APIKEY: {your_api_key}Content-Type: application/json ``` #### Parâmetros do 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" } ] }} ``` CampoTipoObrigatórioDescrição`subject`objectSimDados de identificação do usuário.`subject.duiType`integerSimIdentificador do tipo de documento. Veja os [valores de `duiType`](#duitype-values) abaixo.`subject.code`stringSimCPF ou outro identificador do usuário.`subject.name`stringSimNome completo do usuário.`subject.email`stringNãoE-mail do usuário.`subject.phone`stringNãoNúmero de telefone do usuário.`subject.birthDate`stringNãoData de nascimento do usuário (`DD/MM/YYYY`).`subject.gender`stringNãoGênero do usuário (`M` ou `F`).`useCase`stringSimNome do caso de uso ("Reprocessamento" ou "Importação de base").`subsidiaryId`stringNãoUUID da subsidiária (fornecido pela Unico).`imageBase64`base64SimImagem de selfie do usuário convertida em base64.`document`objectNãoDados do documento associado ao processo.`document.purpose`stringNãoFinalidade do documento (ex.: `"Reprocessamento"`).`document.documentId`stringNãoIdentificador do documento.`document.files`arrayNãoLista de arquivos de imagem do documento.`document.files[].data`base64NãoImagem do documento convertida em base64.`document.files[].faceDocumentMatch`booleanNãoIndica se o rosto no documento corresponde à selfie enviada. **Valores de `duiType`**PaísCódigoDescriçãoAR6Passaporte ArgentinoAR7DNI ArgentinoAR49Carteira de motorista Argentina (Licencia Nacional de Conducir)AT34Número de Contribuinte Austríaco (STNR)BE36Número Nacional Belga (NN)BR1CPF BrasileiroBR5Passaporte BrasileiroBR14CNPJ BrasileiroCA28SIN CanadenseCH33Número AHV/AVS SuíçoCL9RUN ChilenoCL52Passaporte ChilenoCL57Carteira de motorista Chilena (Licencia de Conducir)CO26NIT ColombianoCO53Passaporte ColombianoCO55Carteira de motorista Colombiana (Licencia de Conducción)CO56Cédula de Cidadania Colombiana (Cédula de Ciudadanía)DE41Número de Identificação Fiscal Alemão (IdNr)DK29CPR DinamarquêsEC10NI EquatorianoES50Número de Identidade de Estrangeiro Espanhol (NIE)ES51Documento Nacional de Identidade Espanhol (DNI)FI35Código de Identidade Pessoal Finlandês (HETU)FR46Número de Referência Fiscal Francês (SPI)GB30Número de Seguro Nacional Britânico (NINO)GT12CUI GuatemaltecoID16NIK IndonésioIE47Número de Serviço Público Pessoal Irlandês (PPSN)IT37Codice Fiscale Italiano (CF)LU48Número de Identificação Nacional de Luxemburgo (Matricule)MX2CURP MexicanoMX25RFC Mexicano (Pessoa Física)MX58Carteira de motorista Mexicana (Licencia de Conducir)NG8NIN NigerianoNG20Número de Verificação Bancária Nigeriano (BVN)NG43Token de BVN Nigeriano (hash)NG44Token de NIN Nigeriano (hash)NL42Número de Serviço ao Cidadão Holandês (BSN)NO39Número de Identidade Nacional Norueguês (Fødselsnummer)PE27RUC PeruanoPE40DNI PeruanoPE54Passaporte PeruanoPL31PESEL PolonêsPT45Número de Identificação Fiscal Português (NIF)SE32Número Pessoal Sueco (PNR)SE38Número de Coordenação Sueco (Samordningsnummer)TR24Número de Identificação Turco (TCKN)US4SSN dos Estados UnidosUS11Passaporte dos Estados UnidosUS18Carteira de motorista dos Estados UnidosUS21Cartão de Passaporte dos Estados UnidosUS22Passaporte de Policarbonato dos Estados UnidosUS23Carteira de Identidade dos Estados UnidosUY13CI UruguaiaZZ15Endereço de e-mailZZ17Número de telefone—0Não especificado—3Identificador interno Unico #### Observações importantes​ A selfie **deve estar em conformidade com o padrão ICAO** com qualidade e iluminação adequadas. A selfie deve estar em **formato base64**. Evite envios em massa sem controle de TPS — isso pode acionar limitação de taxa (veja [Tratamento de erros](#tratamento-de-erros) abaixo). Sempre teste dados e integração no ambiente de staging primeiro. #### Respostas​ **Sucesso — 200 OK** Sem documentoCom documento (Facematch)``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "unicoId": { "result": "inconclusive" }, "identityFraudsters": { "result": "inconclusive" }} ``` CampoTipoDescrição`id`stringIdentificador do processo. Armazene-o para consultas futuras ou caso implemente Validação 1:1 posteriormente.`status`integerStatus da transação.`unicoId.result`stringResposta da capacidade Verificação de Identidade.`identityFraudsters.result`stringResposta da capacidade Classificação de risco de fraude.``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "score": 0, "status": 3, "unicoId": { "result": "yes" }, "faceDocumentMatch": { "faceMatch": true }, "identityFraudsters": { "result": "yes" }} ``` CampoTipoDescrição`id`stringIdentificador do processo. Armazene-o para consultas futuras ou caso implemente Validação 1:1 posteriormente.`status`integerStatus da transação.`score`numberPontuação do Facematch.`unicoId.result`stringResposta da capacidade Verificação de Identidade.`faceDocumentMatch.faceMatch`booleanSe a foto do documento corresponde à selfie enviada.`identityFraudsters.result`stringResposta da capacidade Classificação de risco de fraude. **Erro de processamento de imagem** ``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 5} ``` **Erros comuns** Códigos na faixa `4xx` indicam erros de validação nos dados fornecidos. Códigos na faixa `5xx` indicam falhas no lado do servidor. Código HTTPTipo de ErroCausa ProvávelAção Recomendada`400`Bad RequestPayload inválidoValide a estrutura e o conteúdo.`401`UnauthorizedToken expirado ou inválidoRegenere o token.`403`ForbiddenAPI Key incorreta ou permissões insuficientesVerifique as credenciais.`429`Too Many RequestsTaxa de requisições excedidaAguarde e respeite o limite de TPS.`500+`Internal Server ErrorFalha internaTente novamente após alguns segundos; abra um ticket se persistir. ### Tratamento de erros​ **Rate Limit (HTTP 429)** deve ser monitorado com atenção. Sobrecarga de requisições pode bloquear o pipeline. Sempre respeite o TPS acordado com a Unico (veja [Acordo de TPS](#acordo-de-tps)). Para falhas persistentes (5xx), reprocesse com controle de retry/backoff. Última atualização em 8 de out. de 2026**