Skip to content

Добавить или заменить типизированный документ заявки

Request

Файл предварительно загружается через /api/file/upload с purpose DOCUMENT; дождитесь успешного ответа upload. Файл должен принадлежать владельцу заявки или текущему администратору. Чужие файлы и файлы, уже использованные в документах любой заявки, включая историю и дополнительные вложения, запрещены. Тип должен быть применим к текущему профилю. Документы будущего юрстатуса передаются в PATCH partner. expected_revision=0 добавляет отсутствующий документ; N>0 заменяет актуальную ревизию N. Новая версия сразу получает APPROVED с датой и автором проверки; предыдущая сохраняется. В ответе — обновлённая карточка. Устаревшая ревизия даёт 409. Повтор того же запроса не создаёт версию и запись аудита повторно, если file_id и результат предыдущей записи всё ещё актуальны. Если после добавления или замены все обязательные актуальные документы имеют APPROVED, проверка заявки завершается автоматически: статус становится DOCUMENTS_VERIFIED, отправка в банк ставится в очередь. При неполном комплекте заявка остаётся в NEW_APPLICATION; при оставшихся документах REUPLOAD_REQUIRED сохраняется NEEDS_CLARIFICATION. После последней замены закрывается связанное действие о перезагрузке документов. Остальные одобренные документы сохраняются. bank_status сбрасывается в NOT_SENT. Пока отправка в банк запланирована или выполняется, изменение запрещено (409). Старый файл не удаляется из хранилища.

Security
bearerAuth or jwtCookie
Path
sourcestringrequired
Enum:"REFERRAL""BUSINESS"
businessTypestringrequired
Enum:"SE""IE""LLC"
businessEntityIdinteger, (int64), >= 1required
document_typestring(RegistrationDocumentType)required
Enum:"PASSPORT_MAIN""PASSPORT_REGISTRATION""IE_POWER_OF_ATTORNEY""LLC_DIRECTOR_APPOINTMENT""LLC_MACHINE_READABLE_POWER_OF_ATTORNEY"
Bodyapplication/jsonrequired
file_idinteger, (int64), >= 1required
expected_revisioninteger, [ 0 .. 2147483646 ]required

0 — добавить отсутствующий документ; N — заменить текущую версию N.

curl -i -X PUT \
  'https://felmee.com/api/admin/business-registry/applications/{source}/{businessType}/{businessEntityId}/documents/by-type/{document_type}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "file_id": 123,
    "expected_revision": 0
  }'

Responses

Успешный результат

Bodyapplication/json
codeErrorstring or nullrequired

Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.

successbooleanrequired

Флаг успешного выполнения запроса

messagestringrequired

Человекочитаемое описание результата

error_codestring or null(ERROR_CODE)required

Код ошибки. Для успешных ответов всегда null.

Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
dataobject or null(BusinessApplicationCard)required

Полезная нагрузка. Может быть объектом, массивом или null.

Response
{ "codeError": "string", "success": true, "message": "string", "error_code": "INVALID_BODY", "data": { "source": "REFERRAL", "business_type": "SE", "business_entity_id": 0, "status": "NEW_APPLICATION", "bank_status": "NOT_SENT", "bank_error_code": "string", "available_rub": 0, "blocked_rub": 0, "balance_transfer_status": "PENDING", "submitted_at": "2019-08-24T14:15:22Z", "partner": { … }, "documents": [ … ], "requisites": { … } } }