Документация

Как установить файл .epf в 1С, активировать его токеном и что обработка умеет спрашивать у платформы.

Все инструкции по .epf
Главная / Документация

Установка .epf в 1С

CoreBridge — это одна внешняя обработка для вашей 1С. Она сама обращается к платформе и передаёт только те события, которые вы включили. Публиковать 1С в интернет, заводить белый IP и пробрасывать порты не нужно.

Требования

Про четыре конфигурацииСборка своя для каждой конфигурации, но обновления выходят одновременно. Файл для чужой конфигурации не подойдёт — 1С не примет объекты метаданных.

Где взять JWT-токен

Токен — это ключ, которым обработка представляется платформе. Он выдаётся вместе с лицензией сразу после регистрации: отдельно запрашивать или ждать одобрения не нужно. Весь путь занимает пару минут и выглядит так.

Шаг 1. Войдите в личный кабинет

Откройте corebridge.ru/login, введите почту и пароль (1) и нажмите «Войти» (2). Если аккаунт заводили через Яндекс ID — входите той же кнопкой; пароль в этом случае не спрашивается.

Форма входа: подсвечены поле почты и кнопка «Войти»
Форма входа. Забыли пароль — ссылка «Забыли пароль?» под полем.

Шаг 2. Откройте «Файл .epf»

После входа открывается дашборд. В левом меню выберите пункт «Файл .epf» (3) — на этой странице лежит и токен, и сам файл обработки.

Дашборд кабинета: в левом меню подсвечен пункт «Файл .epf»
Дашборд после входа. Кнопка «Скачать .epf» справа вверху ведёт на ту же страницу.

Шаг 3. Выберите свою конфигурацию 1С

Дальше страница ведёт по трём шагам сама. Первый — конфигурация: у каждой своя сборка, и скачать можно только подходящую вашей базе.

Шаг 1 на странице «Файл .epf»: выбор конфигурации 1С
Под названием видно версию сборки и её размер. «Сборки пока нет» означает, что файл для этой конфигурации ещё не публиковался.

Шаг 4. Скопируйте токен

Второй шаг страницы — сам токен. Нажмите «Скопировать»: он попадёт в буфер обмена целиком. Токен длинный и на экране обрезан — копируйте кнопкой, а не выделением мышью, иначе в 1С уедет обрезанная строка.

Шаг 2 на странице «Файл .epf»: JWT-токен и кнопка «Скопировать»
На снимке — образец, не рабочий токен. Рядом видно срок действия: на пробном тарифе лицензия бессрочная.
Если токена на странице нетПолный токен видит только владелец аккаунта — сотрудникам с ролью «менеджер» и «пользователь» страница честно об этом пишет, токен нужно попросить у владельца. Если же написано, что активной лицензии нет, — оформите тариф, токен появится сразу после оплаты.

Шаг 5. Скачайте файл .epf

Третий шаг — сам файл. Ссылка одноразовая и живёт 10 минут: если не успели, просто нажмите кнопку ещё раз. Рядом — кнопка «Инструкция по установке», она ведёт в инструкцию под выбранную конфигурацию.

Шаг 3 на странице «Файл .epf»: кнопка скачивания файла
В имени файла видно конфигурацию и версию сборки — по ним же проверяется обновление.
Токен и файл получены — что дальшеУстановите модуль в 1С по инструкции для вашей конфигурации, затем пройдите мастер подключения. Обе ссылки — в разделе «Инструкции по модулю .epf».

Установка модуля в 1С

Файл можно просто открыть через Файл → Открыть — обработка запустится без установки. Но так её придётся открывать каждый раз вручную, поэтому обычно её добавляют в справочник дополнительных обработок: тогда она доступна всем пользователям базы прямо из меню раздела.

Путь в меню и состав механик в каждой конфигурации свои, поэтому инструкция тоже своя:

Если 1С отказывается открывать файлЧаще всего дело в правах: у пользователя нет роли на интерактивное открытие внешних обработок. Второе по частоте — файл скачан для другой конфигурации.

Первое подключение

При открытии модуля появляется «CoreBridge. Каталог проектов». Нажмите «+ Добавить интеграцию» и пройдите мастер: на первом шаге вставьте скопированный токен в поле JWT-токен и нажмите Проверить подключение — до успешной проверки мастер дальше не пустит.

Дальше мастер спросит категорию, сервис, набор механик и реквизиты 1С, а на пятом шаге запустит обмен. Все пять шагов со скриншотами разобраны в мастере подключения — это общий сценарий для любой интеграции, от Ozon до собственного сайта.

Токен — это доступ к вашим даннымНе пересылайте его в переписке и не храните в общих файлах. Если токен утёк, перевыпустите его в кабинете: прежний перестанет действовать сразу.

API для обработки

Этот раздел нужен, если вы дописываете свою логику поверх платформы или отлаживаете обмен. Обработке .epf он не требуется — она обращается к этим маршрутам сама.

База: https://api.corebridge.ru/api/v1. Авторизация — заголовок Authorization: Bearer <ваш JWT>. Ответы в JSON.

МетодЧто делаетАвторизация
GET /license/checkТариф, срок действия и лимиты по вашему токенуBearer
POST /license/refreshПеревыпуск токена до истечения срокаBearer
GET /eventsОчередь событий для вашей 1С: новые заказы, изменения статусовBearer
POST /events/{id}/ackПодтвердить, что событие обработано в 1СBearer
GET /epf/{config}/versionАктуальная версия сборки. config: ut11, unf, ka, bpне нужна
GET /healthПроверка доступности платформыBearer

Проверка лицензии:

curl -H "Authorization: Bearer $TOKEN" \
  https://api.corebridge.ru/api/v1/license/check

{ "status": "trial", "plan": "trial", "is_perpetual": true, "valid_until": null }

Актуальная версия сборки — без токена:

curl https://api.corebridge.ru/api/v1/epf/ut11/version

{ "version": "0.0.1", "sha256": "ebe154…", "force_update": false }
Как обработка узнаёт об обновленииОна сама спрашивает /epf/{config}/version и сравнивает с той, что установлена. Если у версии стоит force_update, обмен продолжится только после обновления файла — так выпускаются изменения, ломающие совместимость.

Ошибки

Ошибки приходят с кодом в поле error — на него и стоит опираться, а не на текст сообщения: тексты мы правим, коды нет.

КодКогда бываетЧто делать
401Токен не передан, истёк или отозванВзять новый токен в кабинете
402Действие требует платного тарифаОформить тариф
403Доступ закрыт: компания заблокирована или прав не хватаетНаписать на info@corebridge.ru
429Слишком частые запросыУвеличить интервал опроса
5xxСбой на нашей сторонеПовторить с задержкой — событие не потеряется

Что дальше

Инструкции по модулю .epf
Установка под четыре конфигурации, мастер подключения и настройка каждой механики — со скриншотами экранов 1С
Каталог интеграций
33 сервиса и что каждый из них умеет
Тарифы и лимиты
Сколько интеграций и операций входит в каждый план
Сценарии n8n
Своя логика поверх готовых интеграций

Не нашли ответ? Напишите на info@corebridge.ru — отвечаем в течение рабочего дня.