--- title: Передача документа процесса description: Отправка документа, удостоверяющего личность пользователя, с вашего бэкенда после захвата, чтобы процесс мог завершиться. canonical: https://developer.unico.io/ru/developers/api-reference/set-process-document locale: ru generated_by: markdown-export --- - [/ru/](/ru/) - Справочник API - Передача документа процесса **На этой страницеПередача документа процессаPOSTСоздайте процесс без документа, дайте пользователю завершить захват, а затем отправьте документ с вашего бэкенда. После этого процесс завершается. ### Жизненный цикл​ **Ваш бэкенд** создаёт процесс через [Создать процесс](/ru/developers/api-reference/post-processes) без `person.duiType` и `person.duiValue`. Поток должен допускать опциональный документ. Процесс начинается в состоянии `PROCESS_STATE_CREATED`. **Пользователь** проходит сценарий и выполняет захват. **Unico API** переводит процесс в состояние `AWAITING_FOR_DOCUMENT` — его возвращает [Получение процесса](/ru/developers/api-reference/get-process), пока процесс ожидает документ. Вы уже можете прочитать частичные результаты возможностей, которые не зависят от `duiValue`. **Ваш бэкенд** вызывает этот эндпоинт с ID процесса в URL и документом в теле запроса. Затем Unico API завершает процесс, и он переходит в состояние `PROCESS_STATE_FINISHED`. Ответ не содержит итогового результатаПолучите итоговое состояние и результат через [Получение процесса](/ru/developers/api-reference/get-process) или дождитесь [вебхука](/ru/developers/webhooks-and-events). ### Эндпоинт​ СредаURL**Production**`POST https://api.idcloud.unico.app/client/v1/process/{processId}/document`**Sandbox**`POST https://api.idcloud.uat.unico.app/client/v1/process/{processId}/document` ### Запрос​ Заголовки ЗаголовокЗначение`Authorization``Bearer ` (см. [Аутентификация](/ru/developers/start/authentication))`Content-Type``application/json` Учётным данным требуется то же разрешение, что и для вызова [Создать процесс](/ru/developers/api-reference/post-processes). Параметры пути ПараметрТипОбязателенОписание`processId`string (UUID)даИдентификатор процесса, возвращённый [Создать процесс](/ru/developers/api-reference/post-processes). Параметры тела запроса ПолеТипОбязателенОписание`duiType`enumдаТип документа. `DUI_TYPE_UNSPECIFIED` отклоняется. См. [значения `duiType`](#duitype-values) ниже.`duiValue`stringдаНомер документа без форматирования. До 320 символов. **Значения `duiType`**СтранаЗначениеОписаниеAR`DUI_TYPE_AR_PASSPORT`Аргентинский паспортAR`DUI_TYPE_AR_DNI`Аргентинский DNIAR`DUI_TYPE_AR_LNC`Аргентинское водительское удостоверение (Licencia Nacional de Conducir)AT`DUI_TYPE_AT_STNR`Австрийский налоговый номер (STNR)BE`DUI_TYPE_BE_NN`Бельгийский национальный номер (NN)BR`DUI_TYPE_BR_CPF`Бразильский CPFBR`DUI_TYPE_BR_PASSPORT`Бразильский паспортBR`DUI_TYPE_BR_CNPJ`Бразильский CNPJCA`DUI_TYPE_CA_SIN`Канадский SINCH`DUI_TYPE_CH_AHV`Швейцарский номер AHV/AVSCL`DUI_TYPE_CL_RUN`Чилийский RUNCL`DUI_TYPE_CL_PASSPORT`Чилийский паспортCL`DUI_TYPE_CL_LICENCIA_CONDUCIR`Чилийское водительское удостоверение (Licencia de Conducir)CO`DUI_TYPE_CO_NIT`Колумбийский NITCO`DUI_TYPE_CO_PASSPORT`Колумбийский паспортCO`DUI_TYPE_CO_LICENCIA_CONDUCCION`Колумбийское водительское удостоверение (Licencia de Conducción)CO`DUI_TYPE_CO_CC`Колумбийское удостоверение личности гражданина (Cédula de Ciudadanía)DE`DUI_TYPE_DE_IDNR`Немецкий налоговый идентификационный номер (IdNr)DK`DUI_TYPE_DK_CPR`Датский CPREC`DUI_TYPE_EC_NI`Эквадорский NIES`DUI_TYPE_ES_NIE`Испанский номер иностранца (NIE)ES`DUI_TYPE_ES_DNI`Испанский национальный документ, удостоверяющий личность (DNI)FI`DUI_TYPE_FI_HETU`Финский код личной идентификации (HETU)FR`DUI_TYPE_FR_SPI`Французский налоговый справочный номер (SPI)GB`DUI_TYPE_GB_NINO`Британский номер национального страхования (NINO)GT`DUI_TYPE_GT_CUI`Гватемальский CUIID`DUI_TYPE_ID_NIK`Индонезийский NIKIE`DUI_TYPE_IE_PPSN`Ирландский номер социального страхования (PPSN)IT`DUI_TYPE_IT_CF`Итальянский налоговый код (Codice Fiscale, CF)LK`DUI_TYPE_LK_NIC`Шри-ланкийский NICLU`DUI_TYPE_LU_MATRICULE`Люксембургский национальный идентификационный номер (Matricule)MX`DUI_TYPE_MX_CURP`Мексиканский CURPMX`DUI_TYPE_MX_RFC_PERSONA_FISICA`Мексиканский RFC (физическое лицо)MX`DUI_TYPE_MX_LICENCIA_CONDUCIR`Мексиканское водительское удостоверение (Licencia de Conducir)NG`DUI_TYPE_NG_NIN`Нигерийский NINNG`DUI_TYPE_NG_BVN`Нигерийский номер верификации банковского счёта (BVN)NG`DUI_TYPE_NG_BVN_TOKEN`Токен BVN Нигерии (хешированный)NG`DUI_TYPE_NG_NIN_TOKEN`Токен NIN Нигерии (хешированный)NL`DUI_TYPE_NL_BSN`Голландский идентификационный номер гражданина (BSN)NO`DUI_TYPE_NO_FNR`Норвежский национальный идентификационный номер (Fødselsnummer)PE`DUI_TYPE_PE_RUC`Перуанский RUCPE`DUI_TYPE_PE_DNI`Перуанский DNIPE`DUI_TYPE_PE_PASSPORT`Перуанский паспортPL`DUI_TYPE_PL_PESEL`Польский PESELPT`DUI_TYPE_PT_NIF`Португальский налоговый идентификационный номер (NIF)SE`DUI_TYPE_SE_PNR`Шведский личный номер (PNR)SE`DUI_TYPE_SE_SAMORDNINGSNUMMER`Шведский координационный номер (Samordningsnummer)TR`DUI_TYPE_TR_TCKN`Турецкий идентификационный номер (TCKN)US`DUI_TYPE_US_SSN`SSN СШАUS`DUI_TYPE_US_PASSPORT`Паспорт СШАUS`DUI_TYPE_US_DRIVER_LICENSE`Водительское удостоверение СШАUS`DUI_TYPE_US_PASSPORT_CARD`Паспортная карта СШАUS`DUI_TYPE_US_POLYCARBONATE_PASSPORT`Поликарбонатный паспорт СШАUS`DUI_TYPE_US_ID_CARD`Идентификационная карта СШАUY`DUI_TYPE_UY_CI`Уругвайский CIZZ`DUI_TYPE_ZZ_EMAIL`Адрес электронной почтыZZ`DUI_TYPE_ZZ_PHONE_NUMBER`Номер телефона Когда вызов принимается Процесс находится в состоянии `AWAITING_FOR_DOCUMENT`: пользователь уже завершил захват. Срок действия процесса не истёк. Поток допускает опциональный документ. Документ неизменяем. Повторный вызов завершается ошибкой, потому что процесс больше не ожидает документ. ### Пример​ 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(); ``` ### Ответы​ 200 OK ``` { "processId": "3116552c-6a3e-4c1f-9d2b-8f0e7a5b4c21", "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909"} ``` ПолеТипОписание`processId`string (UUID)Идентификатор процесса.`duiType`enumТип документа, зарегистрированный для процесса.`duiValue`stringНомер документа, зарегистрированный для процесса. Значения в примере являются заглушками. ### Коды ошибок​ 400 Bad Request401 Unauthorized403 Forbidden404 Not Found429 Too Many Requests500 Internal Server ErrorКодОписание`3``processId` отсутствует или недействителен, `duiType` не указан, либо `duiValue` пуст или длиннее 320 символов.`9`Процесс не ожидает документ (в том числе если документ уже передан), истёк или завершён, либо поток не допускает опциональный документ.КодСообщениеОписание—Jwt header is an invalid JSONКогда использованный токен доступа содержит некорректные символы.—Jwt is expiredКогда использованный токен доступа истёк.КодОписание`7`У учётных данных нет разрешения, необходимого для [Создать процесс](/ru/developers/api-reference/post-processes).КодОписание`5`Процесс не существует или не принадлежит вашей компании.Достигнут лимит запросов. Когда ваша система получает ошибку HTTP 429, необходимо реализовать механизмы для предотвращения каскадных сбоев и избежания усугубления ограничения. **Лучшие практики:** **Период ожидания (backoff):** Немедленно остановите или снизьте частоту последующих запросов из вашей системы. Не повторяйте неудачные запросы непрерывно в тесном цикле. **Очередь и ограничение (Queueing & throttling):** Буферизируйте или ставьте в очередь исходящие запросы на вашей стороне для контроля потока трафика перед их повторной отправкой. **Экспоненциальный backoff с джиттером:** При повторных попытках увеличивайте время ожидания экспоненциально между попытками (например, 1 с, 2 с, 4 с, 8 с) и добавляйте небольшую случайную задержку ("джиттер"), чтобы предотвратить эффект стада, когда все запросы из очереди повторяются в одну и ту же миллисекунду. предупреждениеНепрерывная отправка запросов к эндпоинту с ограничением частоты без применения backoff может **продлить период ограничения** и серьезно снизить операционную пропускную способность вашей системы. Правильное ограничение запросов на вашей стороне обеспечивает более плавную и устойчивую интеграцию. Информацию о лимитах по умолчанию, увеличении запросов и дополнительные сведения см. в разделе [Лимиты запросов](/ru/developers/start/rate-limits).КодОписание`13`Не удалось сохранить документ. примечаниеПеред сохранением документ регистрируется в сервисе идентификации. Если эта регистрация не удалась, вызов возвращает статус этой ошибки. ### Что дальше​ Чтобы получить итоговое состояние и результат, см. [Получение процесса](/ru/developers/api-reference/get-process). Чтобы получать уведомление о завершении процесса, см. [Вебхуки и события](/ru/developers/webhooks-and-events). Последнее обновление 8 окт. 2026 г.**