Интеграции
Что подключается к системе, что это даёт и что нужно настроить. Настройки задаются на уровне организации — «Настройки» → соответствующая вкладка.
ФИПС — товарные знаки по номеру
Что даёт. Поиск товарного знака по номеру регистрации или номеру заявки в реестре Роспатента. Заполняются наименование знака, правообладатель, статус, даты заявки, приоритета и регистрации, дата окончания действия, классы МКТУ с разбором товаров и услуг, цвета, изображение знака, адрес для переписки и ссылки на карточки ФИПС.
Что настроить. Ничего — работает из коробки.
Сайт ФИПС отклоняет обычные программные запросы, поэтому обращения идут через управляемый браузер. Запросы выполняются по одному, в очередь: при массовом поиске первый ответ приходит быстро, десятый — заметно позже. Для единичных карточек это незаметно.
TMview — товарные знаки по правообладателю
Что даёт. Массовый поиск российских товарных знаков по названию правообладателя — то, чего поиск по номеру не позволяет. Возвращает номера заявки и регистрации, название знака, правообладателя, статус (зарегистрирован, на рассмотрении, истёк, отозван, отказано, признан недействительным), даты, классы МКТУ и ссылки на карточки ФИПС.
Что настроить. Ничего. При недоступности сервиса поиск возвращает пустой результат с пояснением, а не ошибку.
DaData — реквизиты по ИНН
Что даёт. Автозаполнение реквизитов организации по ИНН: наименование с организационно-правовой формой, ОГРН, адрес. Работает и в вашем интерфейсе, и в публичной анкете, которую заполняет контрагент.
Что настроить. API-ключ DaData в настройках организации. Ключ хранится в зашифрованном виде. Без ключа автозаполнение просто не работает — это не ошибка, поля заполняются вручную. Бесплатный тариф DaData даёт 10 000 запросов в сутки.
Перед обращением к DaData система сначала ищет организацию в вашем собственном реестре договоров — если контрагент у вас уже есть, запрос наружу не уходит.
1С
Два независимых канала.
Фид изменений — основной способ
Что даёт. 1С сама забирает данные о договорах: список изменений с момента последней синхронизации, полный снимок и точечное перечитывание конкретного договора. Инициатива на стороне 1С — достаточно, чтобы у сервера 1С был исходящий доступ в интернет.
Что настроить. Токен интеграции выпускается в интерфейсе и показывается один раз — сохраните его сразу. Токен привязан к одной организации. Ограничение — 120 запросов в минуту на токен.
Ссылки на файлы договоров в фиде временные (по умолчанию час) — скачивайте файл в момент обработки страницы, а не позже.
Два ограничения, о которых нужно знать заранее:
- В фид изменений попадают правки самих договоров. Правки дополнительных соглашений и значений реестра — включая ИНН лицензиара — в него не попадают. Если такие изменения важны, периодически перечитывайте полный снимок.
- В обмене нет сумм: передаются проценты (доля роялти, доли правообладателей), но не начисления, акты, УПД и платежи.
Доставка гарантируется «не менее одного раза»: одно и то же изменение может прийти дважды, поэтому обработка на стороне 1С должна быть идемпотентной. Ключ соответствия — внешний идентификатор договора.
Выгрузка по событию
Что даёт. Система сама отправляет договор в 1С по указанному адресу и ведёт журнал отправок.
Что настроить. Адрес приёмника, логин и пароль, время жизни ссылок на файлы, таймаут, проверку сертификата и признак «включать дополнительные соглашения». Пароль наружу не возвращается — виден только признак, что он задан.
Telegram-бот
Что даёт правообладателю. Привязать договор по коду, увидеть список своих договоров, посмотреть начисленное вознаграждение, сформировать отчёт в DOCX и отправить заявку на выплату. Заявки приходят вам на вкладку «Выплаты».
Что настроить. Токен бота в настройках организации; хранится в зашифрованном виде. Можно использовать общий бот платформы или собственный.
Вебхуки
Что даёт. Уведомления в вашу систему при событиях:
- договор создан, изменён, удалён;
- карточка РИД создана, изменена;
- истекает срок лицензии;
- отчёт готов;
- запись реестра изменена.
Что настроить. Адрес приёмника и набор событий. Доступны история доставок и кнопка тестовой отправки. Уведомления никогда не уходят за пределы вашей организации.
Объектное хранилище
Что даёт. Все файлы — шаблоны, сформированные договоры, загруженные отчёты, документы к расходам, акты — хранятся в S3-совместимом хранилище, а не на диске сервера. Диск контейнера очищается при каждом обновлении системы, поэтому хранилище обязательно.
Что настроить. Адрес, ключ доступа, секретный ключ и имя бакета — на уровне платформы или отдельно для вашей организации. Бакет нужно создать заранее: система его не создаёт, потому что многие провайдеры этого не поддерживают.
Если хранилище указано, но недоступно, система откажет в загрузке файла явной ошибкой, а не сохранит его тихо на временный диск. Это сделано намеренно: молчаливый откат приводил к тому, что файлы пропадали при следующем обновлении, и никто не замечал этого месяцами.