Синхронизация заявок с внешними системами
Данный документ описывает функцию синхронизации заявок с внешними системами (по умолчанию с results.zone) и объясняет, как настроить и использовать эту функцию.
Обзор функции
Функция синхронизации заявок позволяет автоматически передавать данные о заявках из REGPLACE во внешнюю систему (например, results.zone) для дальнейшей обработки, отображения результатов и других целей.
Когда функция включена для мероприятия, система автоматически:
- Отправляет данные о новых заявках, когда их статус меняется на "Зарегистрирована"
- Обновляет данные заявок при изменении любых их атрибутов
- Удаляет заявки из внешней системы, когда их статус меняется с "Зарегистрирована" на любой другой
Как включить синхронизацию
Для включения синхронизации заявок с внешней системой:
- Перейдите в административную панель мероприятия
- Откройте вкладку "API и интеграции"
- Установите флажок "Синхронизировать заявки с внешними сервисами"
- Сохраните изменения
Настройка синхронизации
По умолчанию система использует предустановленные параметры для синхронизации с results.zone. Однако вы можете настроить синхронизацию для работы с другими системами:
Настройка URL-адресов
Вы можете указать собственные URL-адреса для синхронизации:
- URL для синхронизации заявок - адрес, по которому будут отправляться данные отдельных заявок
- URL для массовой синхронизации - адрес для массовой синхронизации всех заявок мероприятия
В URL-адресах можно использовать шаблоны, например:
- https://results.example.com/api/events/%{uuid}/heats - где %{uuid} будет заменен на UUID мероприятия
Настройка авторизации
Для безопасной передачи данных вы можете указать токен авторизации:
- В поле "Токен авторизации" введите токен, предоставленный внешней системой
- Этот токен будет использоваться для аутентификации запросов
Проверка работы синхронизации
После включения синхронизации вы можете проверить ее работу:
- Создайте новую заявку или измените существующую
- Переведите заявку в статус "Готово"
- Проверьте, что данные появились во внешней системе
Массовая синхронизация
Если вы заметили, что некоторые заявки не были синхронизированы или данные во внешней системе устарели, вы можете выполнить массовую синхронизацию:
- Перейдите в административную панель мероприятия
- Откройте вкладку "API и интеграции"
- Нажмите кнопку "Выполнить полную синхронизацию"
Это запустит процесс, который: - Отправит данные всех заявок со статусом "Готово" во внешнюю систему - Удалит из внешней системы все заявки, которые не имеют статус "Готово"
Решение проблем
Заявки не синхронизируются
Если заявки не синхронизируются с внешней системой:
- Убедитесь, что функция синхронизации включена для мероприятия
- Проверьте, что заявки имеют статус "Готово"
- Проверьте правильность URL-адресов и токена авторизации
- Выполните полную синхронизацию
Ошибки синхронизации
Если возникают ошибки при синхронизации:
- Проверьте доступность внешней системы
- Убедитесь в правильности настроек синхронизации
- Обратитесь к администратору системы для проверки логов
Какие данные синхронизируются
При синхронизации передаются следующие данные о заявках:
- Основная информация: UUID, статус, имя, фамилия, отчество, пол
- Информация о команде (для эстафет)
- Дополнительные данные: номер, дата оплаты, дата рождения, стартовый номер, категория
- Контактная информация: клуб/команда, тренер, телефон, email, город
- Информация о медицинской справке
- Контакты для экстренной связи
- Фотография (если есть)
- Дополнительные поля из формы регистрации
Техническая поддержка
Если у вас возникли вопросы или проблемы с функцией синхронизации, обратитесь в техническую поддержку:
- Email: support@reg.place
- Телеграм: @regplace_support_bot
- Телефон: +7 (495) 128-98-35