--- title: Criar Processo de Documento description: Capture um novo documento ou reutilize um documento capturado anteriormente vinculado a um processo biométrico. canonical: https://developer.unico.io/pt-BR/dual-api/developers/api-reference/api/post-processes-document locale: pt-BR generated_by: markdown-export --- - [/pt-BR/](/pt-BR/) - [Referência de API](/pt-BR/dual-api/developers/api-reference/) - [API](/pt-BR/dual-api/developers/api-reference/api/) - Criar Processo de Documento **Nesta página# Criar Processo de Documento Este endpoint gerencia dois fluxos de documento que compartilham o mesmo caminho, mas diferem nos parâmetros do body: **Nova captura** — envia imagem(ns) do documento em base64 para processamento (`document.files` obrigatório). **Reutilização** — pula a captura referenciando um documento capturado anteriormente (`document.documentId` obrigatório). O fluxo ativo é determinado pelo fornecimento ou não de `document.documentId` no body da requisição. Antes de criar um processo de documento, use [Obter Documentos Reutilizáveis](/pt-BR/dual-api/developers/api-reference/api/get-document) para verificar se o usuário já possui um documento disponível para reutilização. Para o fluxo completo de integração, consulte [Visão geral da API](/pt-BR/dual-api/developers/api-reference/api/). ### Endpoint​ AmbienteURL**Produção**`POST https://api.id.unico.app/processes/v1`**Sandbox**`POST https://api.id.uat.unico.app/processes/v1` ### Requisição​ Headers HeaderValor`Authorization``Bearer ` (consulte [Autenticação](/pt-BR/dual-api/developers/api-reference/authentication))`APIKEY`Chave de API provisionada com Captura e Reutilização de Documentos habilitadas.`Content-Type``application/json` Parâmetros do body Nova capturaReutilizaçãoCampoTipoObrigatórioDescrição`subject.duiType`integersimIdentificador do tipo de documento. Veja os [valores de `duiType`](#duitype-values) abaixo.`subject.code`stringsimValor do identificador do usuário conforme definido por `subject.duiType`. Sem pontos ou traços.`subject.name`stringnãoNome completo.`subject.gender`stringnão`M` ou `F`.`subject.birthDate`string (ISO 8601)nãoData de nascimento (`YYYY-MM-DD`).`subject.email`stringnãoEndereço de e-mail.`subject.phone`stringnãoNúmero de telefone no formato E.164.`document.purpose`stringsimFinalidade de negócio. Valores: `creditprocess`, `carpurchase`, `paybypaycheck`, `onboarding`, `fgts`.`document.authProcessId`stringsimID do processo biométrico vinculado a esta captura de documento.`document.files`arraysimImagens do documento em base64 (frente e/ou verso).`document.files[].data`stringsimImagem do documento em base64 (PNG, JPEG ou WebP, máx. 800 KB).`subsidiaryId`stringnãoID da filial — obrigatório apenas se existirem múltiplas filiais.CampoTipoObrigatórioDescrição`subject.duiType`integersimIdentificador do tipo de documento. Veja os [valores de `duiType`](#duitype-values) abaixo.`subject.code`stringsimValor do identificador do usuário conforme definido por `subject.duiType`. Sem pontos ou traços.`subject.name`stringnãoNome completo.`subject.gender`stringnão`M` ou `F`.`subject.birthDate`string (ISO 8601)nãoData de nascimento (`YYYY-MM-DD`).`subject.email`stringnãoEndereço de e-mail.`subject.phone`stringnãoNúmero de telefone no formato E.164.`document.purpose`stringsimFinalidade de negócio. Valores: `creditprocess`, `carpurchase`, `paybypaycheck`, `onboarding`, `fgts`.`document.authProcessId`stringsimID do processo biométrico vinculado a este documento.`document.documentId`stringsimID de um documento capturado anteriormente (obtido em [Obter Documentos Reutilizáveis](/pt-BR/dual-api/developers/api-reference/api/get-document)). Quando fornecido, `document.files` pode ser omitido.`subsidiaryId`stringnãoID da filial — obrigatório apenas se existirem múltiplas filiais. **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 ### Exemplo​ Nova captura — cURLNova captura — Node.jsReutilização — cURLReutilização — 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(); ``` ### Respostas​ 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" ] }} ``` CampoTipoDescrição`id`string (UUID)Identificador do processo.`status`integer`3` (finalizado com sucesso), `5` (finalizado com falha).`document.id`stringIdentificador do documento capturado. Use este valor em futuras requisições com `document.documentId` para reutilização.`document.type`stringTipo de documento identificado, como nome de dicionário totalmente qualificado. Veja os [valores de `document.type`](#document-type-values) abaixo.`document.cpfMatch`boolean`true` se o identificador extraído do documento corresponde a `subject.code`.`document.faceMatch`boolean`true` se a foto do documento corresponde à selfie biométrica de `document.authProcessId`.`document.content`objectCampos extraídos via OCR. A estrutura varia conforme o tipo de documento — [clique aqui para detalhes dos campos](/pt-BR/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json).`document.fileUrls`arrayURLs temporárias (validade de 10 minutos) para download das imagens do documento. Apenas os campos extraídos com sucesso estão presentes em `document.content`; o que o OCR não conseguiu ler é omitido em vez de retornado vazio. **Valores de `document.type`**Schema unificadoTodos os tipos de documento que usam o schema unificado — `unified_schema` na [referência de campos](/pt-BR/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json) — são reportados em `document.type` como `unico.moja.dictionary..generic.v1.`, onde `` é o código ISO 3166-1 alpha-2 em minúsculas e `` é o tipo identificado. Por exemplo: `unico.moja.dictionary.ar.generic.v1.IdCard`: Documento de identidade argentino `unico.moja.dictionary.us.generic.v1.PolycarbonatePassport`: Passaporte de policarbonato dos EUA Schemas específicosOs tipos de documento que usam o próprio schema de campos — listados em `specific_document_schemas` na [referência de campos](/pt-BR/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json) — são mostrados na tabela abaixo:PaísValorDocumentoBR`unico.moja.dictionary.br.rg.v2.Rg`RGBR`unico.moja.dictionary.br.cnh.v2.Cnh`CNH (carteira de habilitação)BR`unico.moja.dictionary.br.cin.v1.Cin`CINBR`unico.moja.dictionary.br.passaporte.v1.Passaporte`PassaporteMX`unico.moja.dictionary.mx.ine.v1.Ine`Credencial de eleitor INEMX`unico.moja.dictionary.mx.lpc.v1.Lpc`Licencia para conducir (carteira de habilitação)MX`unico.moja.dictionary.mx.pasaporte.v1.Pasaporte`Passaporte—`unico.moja.dictionary.other.unknown.v1.Unknown`O tipo não pôde ser identificado — `document.content` está vazioNenhuma extração de OCR é realizada e nenhum campo é reportado quando `document.type` é `unico.moja.dictionary.other.unknown.v1.Unknown`. ### Códigos de Erro​ 400 Bad Request403 Forbidden409 Conflict500 Internal Server ErrorCódigoMensagemDescrição`99989`The document is invalid.O objeto `document` possui uma estrutura inválida.`99988`The document is empty.O objeto `document` está ausente no body da requisição.`20900`O base64 informado não é válido.O parâmetro base64 é inválido. Possíveis causas: não é uma imagem ou é uma tentativa de injeção.`20807`A imagem precisa estar no padrão HD ou possuir uma resolução superior a 640 x 480.A resolução da imagem enviada está abaixo do mínimo.`20509`The subject.name field is invalid.`subject.name` contém caracteres inválidos.`20508`The subject.gender field is invalid.`subject.gender` deve ser `M` ou `F`.`20507`O parâmetro subject.code é inválido.Valor de identificador não padrão ou inexistente.`20506`O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.Tamanho da imagem excede 800 KB; comprima em JPEG92.`20505`O base64 informado não é suportado. Os formatos aceitos são png, jpeg e webp.O formato base64 é inválido ou não suportado.`20068`The document.documentId or document.files parameter must be present.Nem `document.documentId` nem `document.files` foram fornecidos.`20067`The document.purpose parameter is invalid.Valor não reconhecido em `document.purpose`.`20066`The document.authProcessId parameter is invalid.Valor inválido em `document.authProcessId`.`20062`The useCase field is invalid.Valor não reconhecido no campo `useCase`.`20021`The subject.phone field is invalid.Formato de `subject.phone` inválido (DDI + DDD + número, 13 caracteres).`20019`The subject.birthDate field is invalid.`subject.birthDate` fora do formato ISO 8601 (`YYYY-MM-DD`).`20009`O parâmetro imagebase64 não foi informado.O parâmetro de imagem do documento está ausente.`20008`The subject.email field is invalid.Formato de e-mail inválido em `subject.email`.`20005`O parâmetro subject.code não foi informado.O parâmetro subject.code está ausente.`20004`O parâmetro subject não foi informado.O parâmetro subject está ausente.`20003`The request body is missing or invalid.Payload nulo ou inválido.`20002`O parâmetro APIKey não foi informado.O parâmetro APIKEY está ausente no header da requisição.`20001`O parâmetro authtoken não foi informado.O parâmetro de token de integração está ausente no header da requisição.`10508`The JWT with the captured face has already been used.O JWT só pode ser usado uma vez.`10507`The JWT with the captured face is expired.JWT expirado; deve ser enviado dentro de 10 minutos.`10506`The imageBase64 field is not a valid JWT from SDK.O `imageBase64` não é um JWT válido gerado pelo SDK.Bearer token ou `APIKEY` ausente, expirado ou inválido. Consulte [Autenticação](/pt-BR/dual-api/developers/api-reference/authentication).CódigoMensagemDescrição`30017`User does not have permission to perform this action.JWT malformado ou usuário sem permissão para realizar esta operação.`10502`O token informado está expirado.O access-token expirou.`10501`O token informado é inválido.O token de autenticação é inválido.`10201`O AppKey informado é inválido.A APIKEY é inválida ou não existe.CódigoMensagemDescrição`20073`The processID already exists.O `processId` informado já existe para este tenant.CódigoMensagemDescrição`99999`Internal failure! Try again laterQuando ocorre um erro interno. ### Próximos passos​ Para verificar se um documento já está disponível antes desta chamada, consulte [Obter Documentos Reutilizáveis](/pt-BR/dual-api/developers/api-reference/api/get-document). Para criação do processo biométrico (necessário para `document.authProcessId`), consulte [Criar Processo](/pt-BR/dual-api/developers/api-reference/api/post-processes). Última atualização em 8 de out. de 2026**