ДОСТУПНО В BUSINESS ПОДПИСКЕ
Метод: ReenrollRequest
С помощью метода ReenrollRequest вы можете повторно назначить курс учащемуся, указать дату начала обучения и срок выполнения курса.
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения, Автор или роль с индивидуальными настройками.
Администратор подразделения или пользователь с ролью с индивидуальными настройками могут переназначать курсы только в тех подразделениях, которыми управляют, и их дочерних подразделений. - это надо?
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
| credentials (обязательный) | object | Учётные данные для авторизации |
| accountUrl (обязательный) | string | Адрес аккаунта |
| email (обязательный) | string | Электронная почта пользователя для авторизации |
| password (обязательный) | string | Пароль пользователя для авторизации |
| enrollmentId (обязательный) | string | ID назначения курса, который нужно переназначить |
| accessDate (обязательный) | date | Дата начала обучения в формате YYYY-MM-DD |
| dueDateType (обязательный) | string | Способ установки срока выполнения курса. Возможные значения: due_date — конкретная дата, due_period — период обучения. что передаём, если переназначение без срока? |
| dueDate (необязательный) | date | Дата завершения обучения в формате YYYY-MM-DD. Используется, если dueDateType имеет значение due_date |
| duePeriod (необязательный) | int | Период, отведённый на выполнение курса. Используется, если dueDateType имеет значение due_period. Измеряется в часах. |
| lockAfterDueDate | boolean | Запрет доступа к курсу после окончания срока выполнения. Возможные значения: true — доступ запрещён, false — доступ разрешён |
- Чтобы получить ID назначения, используйте методы Получение списка назначений или Получение постраничного списка назначений.
- После повторного назначения ID назначения меняется. Перед следующим запросом нужно проверить актуальный
enrollmentId.
Возвращаемые значения
| Параметр | Тип | Описание |
|---|---|---|
| success | boolean | Результат выполнения запроса. Значение true означает, что запрос успешно обработан |
Пример запроса
Повторно назначим курс учащемуся с 12 октября 2026 года. Установим срок выполнения до 30 октября 2026 года и запретим доступ к курсу после окончания срока.
?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soap="http://ispringlearn.ru/go/services/api/soap">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<soap:ReenrollRequest>
<soap:credentials>
<soap:accountUrl>https://example.ispringlearn.ru</soap:accountUrl>
<soap:email>admin@example.com</soap:email>
<soap:password>your_password</soap:password>
</soap:credentials>
<soap:enrollmentId>9c004622-c385-11f1-8bf6-a25b9b197b04</soap:enrollmentId>
<soap:accessDate>2026-10-12</soap:accessDate>
<soap:dueDateType>due_date</soap:dueDateType>
<soap:dueDate>2026-10-30</soap:dueDate>
<soap:lockAfterDueDate>true</soap:lockAfterDueDate>
</soap:ReenrollRequest>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Пример ответа
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://ispringlearn.ru/go/services/api/soap">
<SOAP-ENV:Body>
<ns1:SuccessResult>
<ns1:success>true</ns1:success>
</ns1:SuccessResult>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>