--- title: Создание процесса с документом description: Захватите новый документ или повторно используйте ранее захваченный, привязанный к биометрическому процессу. canonical: https://developer.unico.io/ru/dual-api/developers/api-reference/api/post-processes-document locale: ru generated_by: markdown-export --- - [/ru/](/ru/) - [Справочник API](/ru/dual-api/developers/api-reference/) - [API](/ru/dual-api/developers/api-reference/api/) - Создание процесса с документом **На этой странице# Создание процесса с документом Этот endpoint обрабатывает два документных потока, использующих один и тот же путь, но различающихся параметрами тела запроса: **Новый захват** — отправляет изображения документа в формате base64 для обработки (требуется `document.files`). **Повторное использование** — пропускает захват, ссылаясь на ранее захваченный документ (требуется `document.documentId`). Активный поток определяется наличием `document.documentId` в теле запроса. Перед созданием процесса с документом используйте [Get Reusable Documents](/ru/dual-api/developers/api-reference/api/get-document), чтобы проверить, есть ли у пользователя уже доступный документ. Полный процесс интеграции описан в разделе [Обзор API](/ru/dual-api/developers/api-reference/api/). ### Endpoint​ СредаURL**Production**`POST https://api.id.unico.app/processes/v1`**Sandbox**`POST https://api.id.uat.unico.app/processes/v1` ### Запрос​ Заголовки ЗаголовокЗначение`Authorization``Bearer ` (см. [Аутентификация](/ru/dual-api/developers/api-reference/authentication))`APIKEY`Выданный API-ключ с включёнными функциями захвата и повторного использования документов.`Content-Type``application/json` Параметры тела запроса Новый захватПовторное использованиеПолеТипОбязательноеОписание`subject.duiType`integerдаИдентификатор типа документа. См. [значения `duiType`](#duitype-values) ниже.`subject.code`stringдаЗначение идентификатора пользователя согласно `subject.duiType`. Без точек и дефисов.`subject.name`stringнетПолное имя.`subject.gender`stringнет`M` или `F`.`subject.birthDate`string (ISO 8601)нетДата рождения (`YYYY-MM-DD`).`subject.email`stringнетАдрес электронной почты.`subject.phone`stringнетНомер телефона в формате E.164.`document.purpose`stringдаБизнес-цель. Значения: `creditprocess`, `carpurchase`, `paybypaycheck`, `onboarding`, `fgts`.`document.authProcessId`stringдаИдентификатор биометрического процесса, связанного с захватом этого документа.`document.files`arrayдаИзображения документа в формате base64 (лицевая и/или обратная сторона).`document.files[].data`stringдаИзображение документа в формате base64 (PNG, JPEG или WebP, не более 800 КБ).`subsidiaryId`stringнетИдентификатор филиала — требуется только при наличии нескольких филиалов.ПолеТипОбязательноеОписание`subject.duiType`integerдаИдентификатор типа документа. См. [значения `duiType`](#duitype-values) ниже.`subject.code`stringдаЗначение идентификатора пользователя согласно `subject.duiType`. Без точек и дефисов.`subject.name`stringнетПолное имя.`subject.gender`stringнет`M` или `F`.`subject.birthDate`string (ISO 8601)нетДата рождения (`YYYY-MM-DD`).`subject.email`stringнетАдрес электронной почты.`subject.phone`stringнетНомер телефона в формате E.164.`document.purpose`stringдаБизнес-цель. Значения: `creditprocess`, `carpurchase`, `paybypaycheck`, `onboarding`, `fgts`.`document.authProcessId`stringдаИдентификатор биометрического процесса, связанного с данным документом.`document.documentId`stringдаИдентификатор ранее захваченного документа (полученный из [Get Reusable Documents](/ru/dual-api/developers/api-reference/api/get-document)). При наличии `document.files` можно не указывать.`subsidiaryId`stringнетИдентификатор филиала — требуется только при наличии нескольких филиалов. **Значения `duiType`**СтранаКодОписаниеAR6Аргентинский паспортAR7Аргентинский DNIAR49Аргентинское водительское удостоверение (Licencia Nacional de Conducir)AT34Австрийский налоговый номер (STNR)BE36Бельгийский национальный номер (NN)BR1Бразильский CPFBR5Бразильский паспортBR14Бразильский CNPJCA28Канадский SINCH33Швейцарский номер AHV/AVSCL9Чилийский RUNCL52Чилийский паспортCL57Чилийское водительское удостоверение (Licencia de Conducir)CO26Колумбийский NITCO53Колумбийский паспортCO55Колумбийское водительское удостоверение (Licencia de Conducción)CO56Колумбийское удостоверение личности гражданина (Cédula de Ciudadanía)DE41Немецкий налоговый идентификационный номер (IdNr)DK29Датский CPREC10Эквадорский NIES50Испанский номер иностранца (NIE)ES51Испанский национальный документ, удостоверяющий личность (DNI)FI35Финский код личной идентификации (HETU)FR46Французский налоговый справочный номер (SPI)GB30Британский номер национального страхования (NINO)GT12Гватемальский CUIID16Индонезийский NIKIE47Ирландский номер социального страхования (PPSN)IT37Итальянский налоговый код (Codice Fiscale, CF)LU48Люксембургский национальный идентификационный номер (Matricule)MX2Мексиканский CURPMX25Мексиканский RFC (физическое лицо)MX58Мексиканское водительское удостоверение (Licencia de Conducir)NG8Нигерийский NINNG20Нигерийский номер верификации банковского счёта (BVN)NG43Токен BVN Нигерии (хешированный)NG44Токен NIN Нигерии (хешированный)NL42Голландский идентификационный номер гражданина (BSN)NO39Норвежский национальный идентификационный номер (Fødselsnummer)PE27Перуанский RUCPE40Перуанский DNIPE54Перуанский паспортPL31Польский PESELPT45Португальский налоговый идентификационный номер (NIF)SE32Шведский личный номер (PNR)SE38Шведский координационный номер (Samordningsnummer)TR24Турецкий идентификационный номер (TCKN)US4SSN СШАUS11Паспорт СШАUS18Водительское удостоверение СШАUS21Паспортная карта СШАUS22Поликарбонатный паспорт СШАUS23Идентификационная карта СШАUY13Уругвайский CIZZ15Адрес электронной почтыZZ17Номер телефона—0Не указано—3Внутренний идентификатор Unico ### Пример​ Новый захват — cURLНовый захват — Node.jsПовторное использование — cURLПовторное использование — 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(); ``` ### Ответы​ 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" ] }} ``` ПолеТипОписание`id`string (UUID)Идентификатор процесса.`status`integer`3` (завершён успешно), `5` (завершён с ошибкой).`document.id`stringИдентификатор захваченного документа. Используйте это значение в будущих запросах `document.documentId` для повторного использования.`document.type`stringИдентифицированный тип документа в виде полного имени словаря. См. [значения `document.type`](#document-type-values) ниже.`document.cpfMatch`boolean`true`, если идентификатор, извлечённый из документа, совпадает с `subject.code`.`document.faceMatch`boolean`true`, если лицо на документе совпадает с биометрическим селфи из `document.authProcessId`.`document.content`objectПоля, извлечённые с помощью OCR. Структура зависит от типа документа — [нажмите здесь, чтобы посмотреть описание полей](/ru/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json).`document.fileUrls`arrayВременные URL (действительны 10 минут) для скачивания изображений документа. В `document.content` присутствуют только успешно извлечённые поля; всё, что OCR не смог распознать, опускается, а не возвращается пустым. **Значения `document.type`**Единая схемаВсе типы документов, использующие единую схему — `unified_schema` в [справочнике полей](/ru/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json) — возвращаются в `document.type` в виде `unico.moja.dictionary..generic.v1.`, где `` — код страны ISO 3166-1 alpha-2 в нижнем регистре, а `` — идентифицированный тип. Например: `unico.moja.dictionary.ar.generic.v1.IdCard`: Удостоверение личности Аргентины `unico.moja.dictionary.us.generic.v1.PolycarbonatePassport`: Поликарбонатный паспорт США Отдельные схемыТипы документов, использующие собственную схему полей — перечисленные в `specific_document_schemas` в [справочнике полей](/ru/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json) — приведены в таблице ниже:СтранаЗначениеДокументBR`unico.moja.dictionary.br.rg.v2.Rg`RGBR`unico.moja.dictionary.br.cnh.v2.Cnh`CNH (водительское удостоверение)BR`unico.moja.dictionary.br.cin.v1.Cin`CINBR`unico.moja.dictionary.br.passaporte.v1.Passaporte`ПаспортMX`unico.moja.dictionary.mx.ine.v1.Ine`Избирательное удостоверение INEMX`unico.moja.dictionary.mx.lpc.v1.Lpc`Licencia para conducir (водительское удостоверение)MX`unico.moja.dictionary.mx.pasaporte.v1.Pasaporte`Паспорт—`unico.moja.dictionary.other.unknown.v1.Unknown`Тип не удалось определить — `document.content` пустИзвлечение OCR не выполняется и ни одно поле не возвращается, когда `document.type` равен `unico.moja.dictionary.other.unknown.v1.Unknown`. ### Коды ошибок​ 400 Bad Request403 Forbidden409 Conflict500 Internal Server ErrorКодСообщениеОписание`99989`The document is invalid.Объект `document` имеет неверную структуру.`99988`The document is empty.Объект `document` отсутствует в теле запроса.`20900`O base64 informado não é válido.Параметр base64 недействителен. Возможные причины: это не изображение или попытка инъекции.`20807`A imagem precisa estar no padrão HD ou possuir uma resolução superior a 640 x 480.Разрешение загруженного изображения слишком низкое.`20509`The subject.name field is invalid.`subject.name` содержит недопустимые символы.`20508`The subject.gender field is invalid.`subject.gender` должен быть `M` или `F`.`20507`O parâmetro subject.code é inválido.Нестандартное или несуществующее значение идентификатора.`20506`O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.Размер изображения превышает 800 КБ; выполните сжатие до JPEG92.`20505`O base64 informado não é suportado. Os formatos aceitos são png, jpeg e webp.Формат base64 недействителен или не поддерживается.`20068`The document.documentId or document.files parameter must be present.Не указаны ни `document.documentId`, ни `document.files`.`20067`The document.purpose parameter is invalid.Нераспознанное значение в `document.purpose`.`20066`The document.authProcessId parameter is invalid.Недопустимое значение в `document.authProcessId`.`20062`The useCase field is invalid.Нераспознанное значение в поле `useCase`.`20021`The subject.phone field is invalid.Формат `subject.phone` недействителен (международный код + код региона + номер, 13 символов).`20019`The subject.birthDate field is invalid.`subject.birthDate` не соответствует формату ISO 8601 (`YYYY-MM-DD`).`20009`O parâmetro imagebase64 não foi informado.Отсутствует параметр с изображением документа.`20008`The subject.email field is invalid.Недействительный формат email в `subject.email`.`20005`O parâmetro subject.code não foi informado.Отсутствует параметр subject.code.`20004`O parâmetro subject não foi informado.Отсутствует параметр subject.`20003`The request body is missing or invalid.Тело запроса отсутствует или имеет неверный формат.`20002`O parâmetro APIKey não foi informado.Параметр APIKEY отсутствует в заголовке запроса.`20001`O parâmetro authtoken não foi informado.Параметр токена интеграции отсутствует в заголовке запроса.`10508`The JWT with the captured face has already been used.JWT может быть использован только один раз.`10507`The JWT with the captured face is expired.JWT истёк; должен быть отправлен в течение 10 минут.`10506`The imageBase64 field is not a valid JWT from SDK.`imageBase64` не является действительным JWT, сгенерированным SDK.Bearer-токен или `APIKEY` отсутствует, истёк или недействителен. См. [Аутентификация](/ru/dual-api/developers/api-reference/authentication).КодСообщениеОписание`30017`User does not have permission to perform this action.Некорректный JWT или пользователь без разрешения на выполнение данной операции.`10502`O token informado está expirado.Срок действия токена доступа истёк.`10501`O token informado é inválido.Токен аутентификации недействителен.`10201`O AppKey informado é inválido.APIKEY недействителен или не существует.КодСообщениеОписание`20073`The processID already exists.Указанный `processId` уже существует для данного тенанта.КодСообщениеОписание`99999`Internal failure! Try again laterВнутренняя ошибка сервера. ### Дальнейшие шаги​ Чтобы проверить наличие документа перед этим вызовом, см. [Get Reusable Documents](/ru/dual-api/developers/api-reference/api/get-document). Для создания биометрического процесса (требуется для `document.authProcessId`), см. [Create Process](/ru/dual-api/developers/api-reference/api/post-processes). Последнее обновление 8 окт. 2026 г.**