ipr.ipr.draft.add

Scope: ipr

Кто может вызывать: те же правила, что у ipr.ipr.add: актор готовит карточку себе (userId == текущий пользователь) либо может управлять сотрудником (canManageEmployee: руководитель по оргструктуре, участник группы ИПР/HR, администратор). Подробнее: Роли и права доступа

Проверяет данные для создания карточки ИПР/ПИС так же, как ipr.ipr.add, но карточку не создаёт. Проверенные данные сохраняются как черновик, а в ответе возвращается ссылка на штатную форму создания ИПР с параметром DRAFT_ID: форма открывается с предзаполненными полями, и карточку создаёт пользователь кнопкой «Создать». Сценарий HR-ассистента: ассистент собирает данные, пользователь утверждает их в знакомой форме.

HTTP: POST

Побочные эффекты: Создаёт запись черновика (таблица ithive_ipr_program_draft); у автора остаётся не более 50 неиспользованных черновиков — самые старые удаляются при создании нового. Элементы инфоблока ИПР, компетенции и действия не создаются.

Параметры методаПараметры метода

Состав, типы, алиасы и правила проверки параметров полностью совпадают с ipr.ipr.add.

Проверяются права актора, существование сотрудника, руководителя и шаблона, тип программы, лимит активных программ сотрудника (IPR_ALREADY_EXISTS), формат дат и даты проведения мероприятий в competenceRunOptions.

Как форма использует черновик. Форма создания читает DRAFT_ID и подставляет сотрудника, руководителя, шаблон, срок и дату завершения, отмечает компетенции (с индивидуальными сроками из competenceDeadlines), цели и развивающие действия, наблюдателей и название. Черновик с templateId открывает форму в режиме ИПР/ПИС с выбранным шаблоном: срок в месяцах, целевая функция, целевая должность и согласование берутся из шаблона, как при ручном выборе, а дата завершения, компетенции с их сроками, цели, действия и наблюдатели — из черновика; черновик без templateId открывает форму в режиме свободного выбора компетенций. Открыть черновик может только его автор или привилегированный пользователь; несуществующий или чужой черновик открывает пустую форму с предупреждением. После нажатия «Создать» черновик помечается использованным (usedAt, iprId); повторное открытие использованного черновика тоже даёт пустую форму с предупреждением и ссылкой на созданную карточку, чтобы не создать дубль.

Размер сохраняемого payload ограничен 256 КБ (VALIDATION_ERROR, details.reason = draft_payload_too_large). Черновики не имеют срока действия: неиспользованные хранятся, пока их не вытеснят более новые (не более 50 на автора), использованные остаются как ссылка на созданную карточку.

Права на «Создать» в форме совпадают с ipr.ipr.add: администратор и группа ИПР/HR, руководитель по оргструктуре, текущий руководитель сотрудника, а себе — по настройкам доступа модуля (access_to_ipr / access_to_pis). Ограничение формы: черновик типа PIS без templateId открывается в режиме свободного выбора и создаёт ИПР, поэтому для ПИС всегда передавайте templateId.

Возвращаемые данныеВозвращаемые данные

Структура Структура payload

Это проверенные и приведённые к единому виду параметры запроса — ровно то, что подставляется в форму.

Обработка ошибокОбработка ошибок

Справочник кодов: error-codes.md. Коды и условия совпадают с ipr.ipr.add.

Пример запроса (POST)Пример запроса (POST)

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/ipr.ipr.draft.add.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "userId": 15,
          "managerId": 1,
          "competenceIds": [1049, 1051],
          "deadline": "2026-12-30",
          "competenceGoals": {
            "1049": "Проводить переговоры с ключевыми клиентами без сопровождения руководителя"
          },
          "competenceRunOptions": {
            "1049": { "course_12": { "type": "course", "id": 12, "selected": true } }
          }
        }'
        

Пример ответаПример ответа

{
          "result": {
            "result": {
              "id": 7,
              "url": "/university/ipr/add/?DRAFT_ID=7",
              "userId": 15,
              "createdBy": 1,
              "createdAt": "2026-10-28 12:00:00",
              "usedAt": null,
              "iprId": null,
              "payload": {
                "userId": 15,
                "managerId": 1,
                "competenceIds": [1049, 1051],
                "type": "IPR",
                "templateId": null,
                "title": "",
                "deadline": "2026-12-30",
                "dateClose": "2026-12-30",
                "term": 12,
                "pisPeriod": null,
                "sendBossAgreement": true,
                "positionId": 0,
                "targetPositionId": 0,
                "nextTemplateId": 0,
                "targetFunction": "",
                "observers": [],
                "competenceDeadlines": {},
                "competenceRunOptions": {
                  "1049": { "course_12": { "type": "course", "id": 12, "selected": true } }
                },
                "competenceGoals": {
                  "1049": "Проводить переговоры с ключевыми клиентами без сопровождения руководителя"
                }
              }
            },
            "total": null,
            "next": null,
            "error": null
          }
        }
        

См. такжеСм. также

• ipr.ipr.draft.get
• ipr.ipr.add
• Коды ошибок