Skip to content

Общий flow после входа

После получения JWT и RT способ входа больше не влияет на работу кабинета. На главной странице необходимо выполнить GET /api/referral-system/registration с JWT реферального аккаунта и продолжить работу по возвращённому status и registration_step.

Для нового или незавершённого профиля сервер вернёт NOT_STARTED или IN_PROGRESS — необходимо продолжить регистрацию с указанного шага. Если документы уже отправлены, возможны DOCUMENTS_UNDER_REVIEW или DOCUMENTS_REUPLOAD_REQUIRED. После подтверждения документов без заполненных реквизитов возвращается REQUISITES_REQUIRED. Когда документы подтверждены и реквизиты заполнены, сервер вернёт APPROVED; повторно проходить регистрацию не нужно, пользователь остаётся на главной странице реферального кабинета.

  1. GET /api/referral-system/registration — получить текущее состояние и определить экран регистрации. Для новой регистрации возвращает телефон.
  2. Для проверки ИНН и статуса бизнеса используйте общий POST /api/business-registry/verify-by-inn. Старый адрес POST /api/referral-system/verify-by-inn удалён и больше не работает.
  3. POST /api/referral-system/registration/business — начать регистрацию; проверяет ИНН повторно и сохраняет данные.
  4. Для ИП и ООО: POST /api/referral-system/registration/continue — перейти от сведений из реестра к документам. Для самозанятого этот вызов не нужен.
  5. PUT /api/referral-system/registration/documents — передать ID предварительно загруженных документов.
  6. POST /api/referral-system/registration/offer/send-code — запросить SMS-код на телефон аккаунта.
  7. POST /api/referral-system/registration/offer/accept — подтвердить оферту SMS-кодом и отправить документы на проверку. После этого status=DOCUMENTS_UNDER_REVIEW; registration_step остаётся последним (3 для SE, 4 для IE/LLC).
  8. GET /api/referral-system/organization-data — получить сохранённые из реестра данные ООО или ИП независимо от текущего шага. Для SE и аккаунта без регистрации вернётся 404.
  9. Если администратор запросил замену документов, GET /api/referral-system/registration вернёт DOCUMENTS_REUPLOAD_REQUIRED, а PUT /api/referral-system/registration/documents/reupload примет только запрошенные типы файлов.
  10. После подтверждения документов REQUISITES_REQUIRED означает, что нужно заполнить реквизиты через POST /api/referral-system/requisites. Если реквизиты уже были сохранены, статус сразу станет APPROVED.