--- title: Definir Documento do Processo description: Defina o documento de identificação em um processo criado sem um. Aciona capacidades que requerem um documento. canonical: https://developer.unico.io/pt-BR/dual-api/developers/api-reference/web-sdk/post-process-document locale: pt-BR generated_by: markdown-export --- - [/pt-BR/](/pt-BR/) - [Referência de API](/pt-BR/dual-api/developers/api-reference/) - [Web e Nativo](/pt-BR/dual-api/developers/api-reference/web-sdk/) - Set Process Document **Nesta página# Definir Documento do Processo Define o documento de identificação (CPF, CURP, SSN ou outro `duiType`) em um processo que foi criado sem um. Uma vez definido, o documento é imutável. Disponível apenas para processos cujo Fluxo Personalizado permite criação sem documento — ou seja, processos no estado `AWAITING_FOR_DOCUMENT`. ### Endpoint​ AmbienteURL**Produção**`POST https://api.idcloud.unico.app/client/v1/process/{processId}/document`**Sandbox**`POST https://api.idcloud.uat.unico.app/client/v1/process/{processId}/document` ### Requisição​ Headers HeaderValor`Authorization``Bearer ` (veja [Autenticação](/pt-BR/dual-api/developers/api-reference/authentication))`Content-Type``application/json` Parâmetros de caminho CampoTipoObrigatórioDescrição`processId`stringsimID do processo retornado em `process.id` na criação. Parâmetros do corpo CampoTipoObrigatórioDescrição`duiType`enumsimTipo de documento. Valores: `DUI_TYPE_BR_CPF`, `DUI_TYPE_MX_CURP`, `DUI_TYPE_US_SSN`. Este endpoint suporta um subconjunto dos tipos de documento aceitos por [Criar Processo](/pt-BR/dual-api/developers/api-reference/web-sdk/post-process) — Fluxos Personalizados que permitem criação de documento opcional são atualmente validados contra esta lista mais restrita.`duiValue`stringsimNúmero do documento, sem formatação. Máximo de 320 caracteres (acomoda identificadores codificados ou compostos; números de documento padrão como CPF ou CURP são significativamente menores). ### Exemplo​ cURLNode.js``` curl -X POST https://api.idcloud.unico.app/client/v1/process/abc-123/document \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678901" }' ``` ``` import fetch from 'node-fetch';const res = await fetch( 'https://api.idcloud.unico.app/client/v1/process/abc-123/document', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.UNICO_ACCESS_TOKEN}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ duiType: 'DUI_TYPE_BR_CPF', duiValue: '12345678901', }), });const { process: proc } = await res.json();// proc.id, proc.person.duiType, proc.person.duiValue ``` ### Respostas​ 200 OK ``` { "process": { "id": "abc-123", "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678901" } }} ``` CampoTipoDescrição`process.id`stringIdentificador do processo.`process.person.duiType`stringTipo de documento definido no processo.`process.person.duiValue`stringValor do documento definido no processo. ### Códigos de Erro​ 400 Bad Request401 Unauthorized404 Not Found429 Too Many Requests500 Internal Server ErrorCódigoMensagemDescrição`3``process id is invalid`Quando o ID do processo é inválido.`3``dui_type is required`Quando o tipo de documento não é fornecido.`3``dui_value is required`Quando o número do documento não é fornecido.`3``dui_value exceeds maximum length`Quando o número do documento excede o limite máximo de caracteres.`9``process is not awaiting for document`Quando o processo especificado não aceita envio de documento.`9``process expired`Quando o processo especificado expirou.`9``document already set, cannot be modified`Quando o processo já possui um documento vinculado.`9``process already finished`Quando o processo já foi finalizado.`9``flow does not allow optional document`Quando o documento é obrigatório para o fluxo executado pelo processo.Bearer token ausente, expirado ou inválido. Veja [Autenticação](/pt-BR/dual-api/developers/api-reference/authentication).MensagemDescriçãoJwt header is an invalid JSONQuando o access token utilizado contém caracteres incorretos.Jwt is expiredQuando o access token utilizado expirou.CódigoMensagemDescrição`5``error getting process: rpc error: code = NotFound desc = process not found`Quando o ID do processo não foi encontrado.Limite de requisições atingido. Quando seu sistema recebe um erro HTTP 429, você deve implementar mecanismos para prevenir falhas em cascata e evitar agravar a restrição.**Boas práticas:** **Período de espera (backoff):** Interrompa ou limite imediatamente as requisições subsequentes do seu sistema. Não tente reenviar requisições falhas continuamente em um loop apertado. **Enfileiramento e controle de fluxo:** Armazene ou enfileire as requisições de saída do seu lado para controlar o fluxo de tráfego antes de reenviá-las. **Backoff exponencial com jitter:** Ao tentar novamente, aumente o tempo de espera exponencialmente entre as tentativas (ex.: 1 s, 2 s, 4 s, 8 s) e adicione um pequeno atraso aleatório ("jitter") para evitar um efeito manada onde todas as requisições enfileiradas tentam novamente no exato mesmo milissegundo. avisoContinuar acessando um endpoint com limite de taxa sem aplicar backoff pode **prolongar o período de restrição** e impactar severamente a taxa de transferência operacional do seu sistema. Controlar adequadamente as requisições do seu lado garante uma integração mais suave e resiliente.Para limites padrão, aumento de requisições e detalhes adicionais, veja [Limites de Taxa](/pt-BR/dual-api/developers/api-reference/rate-limits).CódigoMensagemDescrição`99999``Internal failure! Try again later`Quando ocorre um erro interno. ### Próximos passos​ Após definir o documento, o processo continua seu pipeline. Chame [Obter Processo](/pt-BR/dual-api/developers/api-reference/web-sdk/get-process) para buscar o resultado, ou aguarde o [webhook](/pt-BR/developers/webhooks-and-events). Última atualização em 8 de out. de 2026**