Помощь и часто задаваемые вопросы

Для пользователей

Как зарегистрироваться?
Для регистрации вам понадобится email и СНИЛС. Перейдите на страницу регистрации, заполните форму и подтвердите email. СНИЛС обязателен и не может быть изменен после регистрации.
Как проверить подлинность документа?
Каждый документ имеет уникальный идентификатор (UUID) и QR-код. Вы можете проверить документ, отсканировав QR-код или введя UUID на главной странице в разделе "Проверить документ".
Как скачать документ?
В личном кабинете найдите нужный документ и нажмите кнопку "Скачать". Документ будет доступен для скачивания после генерации PDF (обычно это занимает несколько минут).
Можно ли скрыть документ из портфолио?
Да, вы можете управлять видимостью документов в личном кабинете. Скрытые документы не будут видны в публичном портфолио, но останутся доступными для вас.
Что делать, если документ не генерируется?
Генерация PDF происходит асинхронно и может занять некоторое время. Если документ не появился в течение часа, обратитесь в поддержку или к организации, выдавшей документ.
Как присоединиться к организации?
Есть два способа: по приглашению и по заявке.

По приглашению: администратор организации отправляет вам приглашение на email. Примите или отклоните его в личном кабинете в блоке «У вас приглашения».

По заявке: в разделе «Мои организации» нажмите «Найти организацию», найдите нужную и подайте заявку. Владелец или администратор рассмотрит её и одобрит или отклонит.
Где посмотреть статус заявки на вступление?
В личном кабинете на главной странице в блоке «Мои заявки» отображаются все ваши pending-заявки. Там можно увидеть организацию, дату подачи и при необходимости отменить заявку. Результат рассмотрения (одобрено или отклонено) придёт на вашу почту.
Как связаться с техподдержкой?
Войдите в личный кабинет и перейдите в раздел «Поддержка». Вы можете создать заявку, описать проблему или вопрос и вести диалог с поддержкой в формате чата. Ответы приходят на вашу почту. На странице «Контакты» также указаны email и время работы поддержки.

Для организаций

Как создать организацию?
В разделе «Мои организации» нажмите «Новая организация». Заполните форму: название, ИНН (10–12 цифр), ОГРН (13–15 цифр) для юрлица или данные представителя для неформальной организации. После отправки организация попадёт на модерацию. После одобрения администратором вы сможете создавать шаблоны и выдавать документы.
Как пригласить участников в организацию?
Откройте управление организацией → вкладка «Команда» → кнопка «Пригласить». Укажите email, выберите роль (администратор или участник) и отправьте приглашение. Получатель получит письмо со ссылкой и сможет принять или отклонить приглашение в личном кабинете. Ссылка действительна 7 дней.
Как создать мероприятие и настроить участников?
  1. Мероприятия → Создать мероприятие. Заполните название, дату, описание.
  2. Статусы: черновик, опубликовано, активно, завершено, отменено, закрыто. Регистрация — только при «Активно».
  3. Участники: вкладка «Участники» — добавить вручную по email, или через интеграцию (см. Яндекс.Формы, JSON API).
  4. Категории документов — для выдачи разных документов разным группам (организаторам, участникам, финалистам).
  5. Закрытое мероприятие — изменения недоступны.
Какие форматы данных для массовой выдачи?
  • Обязательные колонки: snils, name (ФИО).
  • Опционально: email, любые поля шаблона.
  • Форматы: CSV, Excel (.xlsx, .xls), JSON, текст (табуляция или запятые).
  • Пример CSV: первая строка snils,name,email, затем строки 123-456-789 01,Иванов Иван Иванович,ivan@mail.ru.
  • СНИЛС: формат XXX-XXX-XXX XX, проверяется контрольная сумма.
  • Перед выдачей — предпросмотр и валидация; исправьте ошибки в файле при необходимости.
Как создать шаблон документа?
После одобрения организации перейдите в раздел "Управление организацией" → "Шаблоны" → "Создать шаблон". Используйте графический редактор для создания шаблона или загрузите готовый PDF.
Как выдать документ массово?
Используйте функцию "Массовая выдача" и загрузите CSV файл со списком получателей. Формат CSV: первая строка - заголовки (snils, name, ...), следующие строки - данные получателей.
Можно ли отозвать выданный документ?
Да, вы можете отозвать документ в разделе "Документы" организации. Отозванный документ будет помечен как недействительный при проверке.

Интеграции (регистрация на мероприятия извне)

Яндекс.Формы

Пошаговая настройка
  1. Откройте мероприятие → вкладка «Интеграции» → «Включить интеграцию».
  2. Скопируйте URL (кнопка «Скопировать URL» для Яндекс.Форм).
  3. В Яндекс.Форме: Настройки → Интеграции → «Отправить HTTP-запрос».
  4. URL — вставьте скопированную ссылку. Метод: POST. Заголовки: Content-Type: text/plain.
  5. Тело запроса: {{ID формы}}|{{Ответ "ФИО"}}|{{Ответ "Email"}} или с СНИЛС: …|{{Ответ "СНИЛС"}}.
  6. Формат тела: IDформы|ФИО|email или IDформы|ФИО|email|СНИЛС.
  7. Важно: Яндекс.Формы работают только по IPv6 — убедитесь, что хостинг поддерживает IPv6.
  8. Журнал запросов — в карточке мероприятия на вкладке «Интеграции».

JSON API

Endpoint и заголовки

Endpoint: POST /api/public/webhook-register/json/{token}

Токен скопируйте в карточке мероприятия → Интеграции → «URL для JSON API».

Заголовки: Content-Type: application/json (обязателен). Опционально: X-Idempotency-Key — уникальный ключ для защиты от дублирования.

Тело (JSON):

{"email":"user@example.com","name":"Иванов Иван Иванович","snils":"123-456-789 00"}
Поля запроса
ПолеОписание
emailОбязателен для новых пользователей
nameФИО
snilsОпционально
last_name, first_name, middle_nameАльтернатива полю name
Коды ошибок (result_detail)
КодОписание
event_not_foundТокен не найден
event_not_activeМероприятие не активно
invalid_jsonНекорректный JSON
missing_email_and_snilsНе указаны email и СНИЛС
invalid_emailНекорректный email
invalid_snilsНекорректный СНИЛС
only_snils_user_not_foundТолько СНИЛС, пользователь не найден

Идемпотентность: при повторной отправке с тем же idempotency_key (в теле или заголовке X-Idempotency-Key) сервер вернёт успех без повторной регистрации.

Примеры кода

PHP (cURL):

$ch = curl_init($webhookUrl);
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => json_encode(['email'=>$email,'name'=>$name,'snils'=>$snils]),
  CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
  CURLOPT_RETURNTRANSFER => true
]);
$result = json_decode(curl_exec($ch), true);

PHP (file_get_contents):

$context = stream_context_create([
  'http' => [
    'method' => 'POST',
    'header' => "Content-Type: application/json\r\n",
    'content' => json_encode(['email'=>$email,'name'=>$name])
  ]
]);
$response = file_get_contents($webhookUrl, false, $context);
$result = json_decode($response, true);

PHP (форма с POST):

$data = [
  'email' => trim($_POST['email'] ?? ''),
  'name' => trim($_POST['last_name'].' '.$_POST['first_name'].' '.$_POST['middle_name']),
  'snils' => trim($_POST['snils'] ?? '') ?: null
];
$ch = curl_init($webhookUrl);
curl_setopt_array($ch, [
  CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode($data),
  CURLOPT_HTTPHEADER => ['Content-Type: application/json'], CURLOPT_RETURNTRANSFER => true
]);
$result = json_decode(curl_exec($ch), true);

JavaScript (fetch):

const res = await fetch(webhookUrl, {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({email, name, snils})
});
const result = await res.json();

JavaScript (fetch с idempotency_key):

const idempotencyKey = 'form-' + Date.now() + '-' + Math.random().toString(36).slice(2);
const res = await fetch(webhookUrl, {
  method: 'POST',
  headers: {'Content-Type': 'application/json', 'X-Idempotency-Key': idempotencyKey},
  body: JSON.stringify({email, name, snils, idempotency_key: idempotencyKey})
});
const result = await res.json();

JavaScript (XMLHttpRequest):

const xhr = new XMLHttpRequest();
xhr.open('POST', webhookUrl);
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.onload = () => { const result = JSON.parse(xhr.responseText); /* ... */ };
xhr.send(JSON.stringify({email, name, snils}));

Техподдержка и заявки

Как создать заявку?
Перейдите в раздел «Поддержка» → «Создать заявку». Заполните тему и сообщение, отправьте. Вся переписка ведётся в чате заявки; ответы также приходят на вашу почту.
Что указывать в теме и сообщении?
В теме кратко опишите проблему (например: «Не приходит письмо подтверждения»). В сообщении укажите: что вы делали, какой результат ожидали, что получили. При необходимости прикрепите скриншоты.
Как вести диалог?
Ответы операторов отображаются в чате заявки. Вы можете отвечать прямо в чате или по email — всё синхронизируется. Новые сообщения отмечены в интерфейсе.
Какие статусы у заявки?
Открыта — создана, ожидает ответа. В работе — специалист взял в работу. Решена — решение найдено. Закрыта — обращение завершено.
Сроки ответа
Обычно первый ответ — в течение рабочих суток. Срочные вопросы обрабатываются приоритетно. Подробнее — на странице «Контакты».

Ссылки: Поддержка · Контакты

Технические вопросы

Какой формат СНИЛС используется?
СНИЛС должен быть в формате XXX-XXX-XXX XX (например, 123-456-789 00). Система автоматически проверит контрольную сумму.
Безопасны ли мои данные?
Да, мы используем современные методы защиты данных: шифрование паролей, защиту от SQL-инъекций, CSRF защиту. Все данные хранятся в защищенной базе данных.
Можно ли экспортировать свои документы?
Да, вы можете скачать каждый документ отдельно в формате PDF. Также доступна функция экспорта списка документов.