Все инструкции по .epf

Как настроить произвольную интеграцию («Иное»)

Механика для случая, когда нужного сервиса нет в списке готовых интеграций. Вы сами конструируете набор полей, а модуль отправляет их на платформу в едином формате. Дальше данные попадают в ваш персональный воркфлоу n8n, где вы настраиваете отправку в любой внешний сервис.

Направление — только 1С → внешний сервис.


Когда это нужно

  • Внешний сервис, для которого нет готового адаптера.
  • Собственная система учёта, ERP партнёра, отраслевой сервис.
  • Нестандартный формат обмена под конкретного контрагента.

Если ваш сервис есть в списке адаптеров — используйте готовую механику, она проще.


Шаг 1. Запустить мастер

Каталог проектов → «+ Добавить интеграцию». Шаги 1–2 — см. Мастер подключения.

Шаг 3А → категория other (Иное). Шаг 3Б → сервис custom (Произвольная интеграция).


Шаг 2. Механики

Шаг 3В: категория «Иное»
Шаг 3В: категория «Иное»

Чекбоксов механик здесь нет — строка состояния показывает Категория: Иное Сервис: custom Выбрано: 0 / 0. Это нормально: механика подставляется автоматически. Просто нажмите «Далее →».

Шаг 3Г★ Рекомендуемые. Шаг 4 — название проекта. Шаг 5«✓ Завершить и запустить».


Шаг 3. Собрать схему полей

Рабочий стол проекта → строка «Иное»⚙ Настройка. Откроется CoreBridge. Произвольная интеграция.

Конструктор схемы полей
Конструктор схемы полей

Общие параметры

ПараметрЗначенияНазначение
Триггерmanual / document / cycleКогда отправлять: вручную, по документу, по расписанию
Интервал цикла, минчислоПериод для триггера cycle. По умолчанию 30
Пропускать пустые поляДа / НетНе включать в отправку поля без значения

Быстрый старт: «Демо-схема»

Кнопка «Демо-схема» заполняет таблицу примером под выбранную вкладку. Самый быстрый способ понять формат — нажать её и посмотреть результат.

Добавление поля вручную

Блок «Добавить поле»:

ПолеНазначение
Имя поляКак поле будет называться в отправляемых данных, например order_number
ИсточникОткуда брать значение (см. таблицу ниже)
Значение/ключКонстанта или ключ источника
Обяз.Обязательное ли поле
По умолчаниюЗначение, если источник недоступен

Нажмите «+ Добавить поле» — строка появится в таблице.

Типы источников

ИсточникЧто даётТребует контекст документа
custom_requisiteКонстанта, которую вы задаёте в поле «Значение/ключ»Нет
system_fieldСистемное значение: current_date, идентификатор интеграции, конфигурацияНет
doc_fieldРеквизит документаДа
contractor_fieldРеквизит контрагентаДа
nomenclature_listСписок номенклатуры документаДа
warehouse_fieldРеквизит складаДа
contract_fieldРеквизит договораДа

Источники, требующие контекста документа, при триггерах manual и cycle подставят значение из колонки «По умолчанию» и выдадут предупреждение — отправка при этом не сорвётся.

Таблица схемы

Собранные поля: имя поля, источник, значение/ключ, обяз., по умолчанию. Лишнюю строку удаляет кнопка «Удалить поле».


Шаг 4. Проверить и отправить

Результат отправки
Результат отправки
КнопкаДействие
Предпросмотр JSONПоказать, что именно уйдёт на платформу — поле «ПревьюJSON»
СохранитьСохранить схему
Отправить (тест)Отправить пробное сообщение прямо сейчас
ЖурналОткрыть журнал отправок

Блок «Результат / статус»

ПолеЧто показывает
СтатусСостояние схемы, например Демо-схема: 4 полей (вкладка «marketplace»)
РезультатОтправкиИтог отправки: ✓ Отправлено. event_id=evt_cst_… либо текст ошибки

Успешная отправка возвращает event_id, начинающийся с evt_cst_ — по нему запись можно найти в журнале.

Рекомендуемый порядок: соберите схему → «Предпросмотр JSON»«Сохранить»«Отправить (тест)» → проверьте РезультатОтправки.


Шаг 5. Журнал «Иное»

Рабочий стол → строка «Иное»▶ Рабочее место. Либо кнопка «Журнал» на форме настройки.

Журнал «Иное»
Журнал «Иное»

Фильтры

Поля С / По, Статус (ok/warn/error/empty), кнопка «Обновить».

Таблица

КолонкаЗначение
ВремяВремя отправки
ВкладкаГруппа сервиса: marketplace, site, crm, services, social, analytics
Триггерmanual / document / cycle
ДокументДокумент-источник, если отправка шла по документу
event_idИдентификатор события, evt_cst_…
Статусok, warn, error, empty
КодКод ошибки
СообщениеТекст сообщения

Внизу — блок «Детали» и итоги: «Записей», «Успешно», «Ошибок».


Что происходит с данными дальше

  1. Модуль собирает поля по вашей схеме.
  2. Отправляет их на платформу в фиксированном конверте: идентификатор интеграции, вкладка, триггер, версия схемы и блок данных с вашими полями.
  3. Платформа проверяет конверт (но не структуру ваших полей — она произвольная) и передаёт данные в ваш персональный воркфлоу n8n.
  4. В воркфлоу вы настраиваете преобразование и отправку в целевой сервис.

То есть в 1С вы решаете что отправлять, а в n8n — куда и в каком виде.


Частые проблемы

СимптомРешение
На Шаге 3В нет чекбоксов механикОжидаемо для категории «Иное» — механика подставляется автоматически. Нажмите «Далее →»
Ошибка «недопустимая вкладка (tab_key)»Вкладка не выбрана или указана неверно. Допустимые значения: marketplace, site, crm, services, social, analytics. Проще всего нажать «Демо-схема» — она подставит корректную вкладку
Ошибка о пустых данныхВ схеме нет ни одного поля со значением. Добавьте хотя бы одно поле с источником custom_requisite
Ошибка о превышении размераОтправляемые данные слишком велики. Сократите число полей или объём списка номенклатуры
Ошибка о превышении частотыСлишком много отправок подряд. Увеличьте «Интервал цикла, мин»
Поля документа приходят пустымиТриггер manual или cycle — контекста документа нет. Используйте триггер document либо задайте значения в колонке «По умолчанию»
Схема не сохраняетсяНажмите «Сохранить» до «Отправить (тест)»
Журнал пустойНажмите «Обновить»; проверьте период С / По
Отправка прошла, но в сервисе ничего нетДанные дошли до платформы (есть event_id). Дальше смотрите ваш воркфлоу n8n — маппинг в целевой API настраивается там

Смотрите также

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