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

Ambiente	URL
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

Header	Valor
Authorization	Bearer <access_token> (consulte Autenticação)
Content-Type	application/json

Parâmetros de path

Campo	Tipo	Obrigatório	Descrição
processId	string	sim	ID do processo retornado em process.id na criação.

Parâmetros do corpo

Campo	Tipo	Obrigatório	Descrição
duiType	enum	sim	Tipo de documento. Valores: DUI_TYPE_BR_CPF, DUI_TYPE_MX_CURP, DUI_TYPE_US_SSN. Este endpoint aceita um subconjunto dos tipos de documento aceitos por Criar Processo — os Fluxos Personalizados que permitem criação opcional de documento são validados atualmente contra essa lista mais restrita.
duiValue	string	sim	Nú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

cURL

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"
  }'

Node.js

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"
    }
  }
}

Campo	Tipo	Descrição
process.id	string	Identificador do processo.
process.person.duiType	string	Tipo de documento definido no processo.
process.person.duiValue	string	Valor do documento definido no processo.

400 Bad Request

Retornado quando o payload da requisição está malformado, campos obrigatórios estão ausentes ou o estado do processo não permite a operação.

401 Unauthorized

Token Bearer ausente, expirado ou inválido. Consulte Autenticação.

404 Not Found

Processo não encontrado.

429 Too Many Requests

Limite de taxa atingido. Nenhum código de erro detalhado é fornecido — apenas o status HTTP.

Códigos de Erro

400 Bad Request

Código	Mensagem	Descriçã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.

401 Unauthorized

Mensagem	Descrição
Jwt header is an invalid JSON	Quando o access token utilizado contém caracteres incorretos.
Jwt is expired	Quando o access token utilizado está expirado.

404 Not Found

Código	Mensagem	Descrição
5	error getting process: rpc error: code = NotFound desc = process not found	Quando o ID do processo não foi encontrado.

429 Too Many Requests

Nenhum código de erro detalhado é fornecido para este status — apenas o código de status HTTP.

500 Internal Server Error

Código	Mensagem	Descriçã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 para buscar o resultado, ou aguarde o webhook.