API
Кастомные поля сотрудника
expand=custom_fields добавляет в карточку объект custom_fields: значения
полей, которые компания завела сама, по их api_name. Описания полей — типы,
варианты, колонки таблиц — отдаёт GET /developer/v1/employee_custom_fields.
Область та же, employees:read; скрытые правами поля попадают в
redacted_fields. Файлы, изображения и формульные поля пока не отдаются.→ Кастомные поляДокументация
Уточнения в справочнике
Формат ошибки описан по факту: тело —google.rpc.Status с числовым code,
а стабильный строковый код приходит в заголовке X-Error-Reason и в
details[].metadata.code. Добавлены статус 409 и коды документов, файлов,
вебхуков и Ingest.Исправлена семантика событий: переименование человека эмитит только
person.changed; employee.changed покрывает атрибуты занятости. Подписывайтесь
на оба типа, если держите у себя ФИО.Приведены к коду имена полей в примерах: DocumentTemplate.title,
person.full_name, limit вместо page_size, url вместо download_url.→ Ошибки · ВебхукиAPI
Загрузка своего документа
POST /developer/v1/files выдаёт presigned-форму, POST /developer/v1/files/{file_id}/_confirm
подтверждает загрузку, а POST /developer/v1/documents принимает file_id
вместо template_id — и ваш PDF идёт по маршруту как обычный документ.
Область та же, documents:write.Принимается только application/pdf до 50 МБ: файл уходит на подписание
ровно таким, каким вы его прислали.→ Загрузка своего документаAPI
Документы в Developer API
Полный цикл работы с документами: создание из шаблона, маршруты, отправка, согласование, подписание (ЭЦП/КЭД) и скачивание, плюс справочники типов, категорий и шаблонов. Новые области —documents:read и documents:write.Добавлены вебхуки по документам: document.sent, document.completed,
document.rejected и другие.Обновлена структура документации: гайды по
сотрудникам и
документам с рецептами.API
Загрузка данных из внешних систем
Добавлен эндпоинтPOST /developer/v1/ingest/{source_type}: пачка записей
из внешней HR-системы с флагом create_missing.Записи сопоставляются по
external_id — повторная отправка не создаёт дубликаты.