--- title: Definir Documento del Proceso description: Envía el documento de identificación del usuario desde tu back-end después de la captura, para que el proceso pueda finalizar. canonical: https://developer.unico.io/es/developers/api-reference/set-process-document locale: es generated_by: markdown-export --- - [/es/](/es/) - Referencia de API - Definir Documento del Proceso **En esta páginaDefinir Documento del ProcesoPOSTCrea un proceso sin documento, deja que el usuario complete la captura y luego envía el documento desde tu back-end. El proceso finaliza después de eso. ### Ciclo de vida​ **Tu back-end** crea el proceso con [Crear Proceso](/es/developers/api-reference/post-processes), sin `person.duiType` ni `person.duiValue`. El flow debe permitir un documento opcional. El proceso comienza como `PROCESS_STATE_CREATED`. **El usuario** recorre el flujo y realiza la captura. **La Unico API** mueve el proceso a `AWAITING_FOR_DOCUMENT`, el estado que [Obtener Proceso](/es/developers/api-reference/get-process) devuelve mientras el proceso espera el documento. Ya puedes leer los resultados parciales de las capacidades que no dependen de `duiValue`. **Tu back-end** llama a este endpoint con el ID del proceso en la URL y el documento en el cuerpo. La Unico API entonces finaliza el proceso, que pasa a `PROCESS_STATE_FINISHED`. La respuesta no incluye el resultado finalLee el estado y el resultado finales con [Obtener Proceso](/es/developers/api-reference/get-process), o espera el [webhook](/es/developers/webhooks-and-events). ### Endpoint​ EntornoURL**Producción**`POST https://api.idcloud.unico.app/client/v1/process/{processId}/document`**Sandbox**`POST https://api.idcloud.uat.unico.app/client/v1/process/{processId}/document` ### Solicitud​ Headers HeaderValor`Authorization``Bearer ` (ver [Autenticación](/es/developers/start/authentication))`Content-Type``application/json` Las credenciales necesitan el mismo permiso usado para llamar a [Crear Proceso](/es/developers/api-reference/post-processes). Parámetros de ruta ParámetroTipoObligatorioDescripción`processId`string (UUID)síIdentificador del proceso devuelto por [Crear Proceso](/es/developers/api-reference/post-processes). Parámetros del cuerpo CampoTipoObligatorioDescripción`duiType`enumsíTipo de documento. `DUI_TYPE_UNSPECIFIED` se rechaza. Ver [valores de `duiType`](#duitype-values) a continuación.`duiValue`stringsíNúmero del documento, sin formato. Hasta 320 caracteres. **Valores de `duiType`**PaísValorDescripciónAR`DUI_TYPE_AR_PASSPORT`Pasaporte argentinoAR`DUI_TYPE_AR_DNI`DNI argentinoAR`DUI_TYPE_AR_LNC`Licencia de conducir argentina (Licencia Nacional de Conducir)AT`DUI_TYPE_AT_STNR`Número de impuesto austríaco (STNR)BE`DUI_TYPE_BE_NN`Número Nacional belga (NN)BR`DUI_TYPE_BR_CPF`CPF brasileñoBR`DUI_TYPE_BR_PASSPORT`Pasaporte brasileñoBR`DUI_TYPE_BR_CNPJ`CNPJ brasileñoCA`DUI_TYPE_CA_SIN`SIN canadienseCH`DUI_TYPE_CH_AHV`Número AHV/AVS suizoCL`DUI_TYPE_CL_RUN`RUN chilenoCL`DUI_TYPE_CL_PASSPORT`Pasaporte chilenoCL`DUI_TYPE_CL_LICENCIA_CONDUCIR`Licencia de conducir chilena (Licencia de Conducir)CO`DUI_TYPE_CO_NIT`NIT colombianoCO`DUI_TYPE_CO_PASSPORT`Pasaporte colombianoCO`DUI_TYPE_CO_LICENCIA_CONDUCCION`Licencia de conducir colombiana (Licencia de Conducción)CO`DUI_TYPE_CO_CC`Cédula de Ciudadanía colombiana (Cédula de Ciudadanía)DE`DUI_TYPE_DE_IDNR`Número de Identificación Fiscal alemán (IdNr)DK`DUI_TYPE_DK_CPR`CPR danésEC`DUI_TYPE_EC_NI`NI ecuatorianoES`DUI_TYPE_ES_NIE`Número de Identidad de Extranjero español (NIE)ES`DUI_TYPE_ES_DNI`Documento Nacional de Identidad español (DNI)FI`DUI_TYPE_FI_HETU`Código de identidad personal finlandés (HETU)FR`DUI_TYPE_FR_SPI`Número de Referencia Fiscal francés (SPI)GB`DUI_TYPE_GB_NINO`Número de Seguro Nacional británico (NINO)GT`DUI_TYPE_GT_CUI`CUI guatemaltecoID`DUI_TYPE_ID_NIK`NIK indonesioIE`DUI_TYPE_IE_PPSN`Número de Seguro Social Personal irlandés (PPSN)IT`DUI_TYPE_IT_CF`Código Fiscal italiano (CF)LK`DUI_TYPE_LK_NIC`NIC de Sri LankaLU`DUI_TYPE_LU_MATRICULE`Número de Identificación Nacional de Luxemburgo (Matricule)MX`DUI_TYPE_MX_CURP`CURP mexicanoMX`DUI_TYPE_MX_RFC_PERSONA_FISICA`RFC mexicano (Persona Física)MX`DUI_TYPE_MX_LICENCIA_CONDUCIR`Licencia de conducir mexicana (Licencia de Conducir)NG`DUI_TYPE_NG_NIN`NIN nigerianoNG`DUI_TYPE_NG_BVN`Número de Verificación Bancaria nigeriano (BVN)NG`DUI_TYPE_NG_BVN_TOKEN`Token BVN nigeriano (hash)NG`DUI_TYPE_NG_NIN_TOKEN`Token NIN nigeriano (hash)NL`DUI_TYPE_NL_BSN`Número de Servicio al Ciudadano holandés (BSN)NO`DUI_TYPE_NO_FNR`Número de Identidad Nacional noruego (Fødselsnummer)PE`DUI_TYPE_PE_RUC`RUC peruanoPE`DUI_TYPE_PE_DNI`DNI peruanoPE`DUI_TYPE_PE_PASSPORT`Pasaporte peruanoPL`DUI_TYPE_PL_PESEL`PESEL polacoPT`DUI_TYPE_PT_NIF`Número de Identificación Fiscal portugués (NIF)SE`DUI_TYPE_SE_PNR`Número personal sueco (PNR)SE`DUI_TYPE_SE_SAMORDNINGSNUMMER`Número de Coordinación sueco (Samordningsnummer)TR`DUI_TYPE_TR_TCKN`Número de Identificación turco (TCKN)US`DUI_TYPE_US_SSN`SSN de Estados UnidosUS`DUI_TYPE_US_PASSPORT`Pasaporte de Estados UnidosUS`DUI_TYPE_US_DRIVER_LICENSE`Licencia de conducir de Estados UnidosUS`DUI_TYPE_US_PASSPORT_CARD`Tarjeta de pasaporte de Estados UnidosUS`DUI_TYPE_US_POLYCARBONATE_PASSPORT`Pasaporte de policarbonato de Estados UnidosUS`DUI_TYPE_US_ID_CARD`Tarjeta de identificación de Estados UnidosUY`DUI_TYPE_UY_CI`CI uruguayoZZ`DUI_TYPE_ZZ_EMAIL`Dirección de correo electrónicoZZ`DUI_TYPE_ZZ_PHONE_NUMBER`Número de teléfono Cuándo se acepta la llamada El proceso está en `AWAITING_FOR_DOCUMENT`: el usuario ya completó la captura. El proceso no ha expirado. El flow permite un documento opcional. El documento es inmutable. Una segunda llamada falla, porque el proceso ya no está esperando un documento. ### Ejemplo​ cURLNode.js``` curl -X POST https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/document \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909" }' ``` ``` import fetch from 'node-fetch';const res = await fetch( `https://api.idcloud.unico.app/client/v1/process/${processId}/document`, { method: 'POST', headers: { Authorization: `Bearer ${accessToken}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ duiType: 'DUI_TYPE_BR_CPF', duiValue: '12345678909', }), });const { processId: id, duiType, duiValue } = await res.json(); ``` ### Respuestas​ 200 OK ``` { "processId": "3116552c-6a3e-4c1f-9d2b-8f0e7a5b4c21", "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909"} ``` CampoTipoDescripción`processId`string (UUID)Identificador del proceso.`duiType`enumTipo de documento registrado para el proceso.`duiValue`stringNúmero del documento registrado para el proceso. Los valores del ejemplo son ilustrativos. ### Códigos de Error​ 400 Bad Request401 Unauthorized403 Forbidden404 Not Found429 Too Many Requests500 Internal Server ErrorCódigoDescripción`3``processId` falta o no es válido, `duiType` no está especificado, o `duiValue` está vacío o tiene más de 320 caracteres.`9`El proceso no está esperando un documento (esto incluye un documento ya definido), ha expirado o finalizado, o el flow no permite un documento opcional.CódigoMensajeDescripción—Jwt header is an invalid JSONCuando el access token utilizado contiene caracteres incorrectos.—Jwt is expiredCuando el access token utilizado ha expirado.CódigoDescripción`7`Las credenciales no tienen el permiso requerido por [Crear Proceso](/es/developers/api-reference/post-processes).CódigoDescripción`5`El proceso no existe o no pertenece a tu empresa.Se alcanzó el límite de tasa. Cuando su sistema recibe un error HTTP 429, debe implementar mecanismos para prevenir fallos en cascada y evitar empeorar la restricción. **Mejores prácticas:** **Período de enfriamiento (backoff):** Detenga o reduzca inmediatamente las solicitudes posteriores de su sistema. No reintente continuamente las solicitudes fallidas en un bucle cerrado. **Cola y limitación (Queueing & throttling):** Almacene en búfer o ponga en cola las solicitudes salientes de su lado para controlar el flujo de tráfico antes de reenviarlas. **Backoff exponencial con jitter:** Al reintentar, aumente el tiempo de espera exponencialmente entre intentos (por ejemplo, 1 s, 2 s, 4 s, 8 s) y agregue un pequeño retraso aleatorio ("jitter") para evitar un efecto de manada donde todas las solicitudes en cola reintentan en el mismo milisegundo exacto. advertenciaEnviar solicitudes continuamente a un endpoint con límite de tasa sin aplicar backoff puede **prolongar el período de restricción** e impactar gravemente el rendimiento operativo de su sistema. Limitar adecuadamente las solicitudes de su lado garantiza una integración más fluida y resiliente. Para conocer los límites predeterminados, aumentar solicitudes y obtener detalles adicionales, consulte [Límites de tasa](/es/developers/start/rate-limits).CódigoDescripción`13`No se pudo guardar el documento. notaEl documento se registra en el servicio de identidad antes de almacenarse. Si ese registro falla, la llamada devuelve el estado de esa falla. ### Qué sigue​ Para leer el estado y el resultado finales, ver [Obtener Proceso](/es/developers/api-reference/get-process). Para recibir una notificación cuando el proceso finalice, ver [Webhooks and Events](/es/developers/webhooks-and-events). Última actualización el 8 oct 2026**