Как настраивать фильтры для ускорения интеграции через Коннектор 1С к ELMA365

• передавать только актуальные данные;
• ускорять обмен между системами;
• снижать нагрузку на инфраструктуру;
• контролировать бизнес-логику интеграции.

Фильтрация данных при передаче из 1С в ELMA365.

• Логические операции: равно (eq), не равно (ne), больше/меньше (gt/lt), и (and), или (or), отрицание (not) и др.
• Арифметические операции: сложение (add), вычитание (sub), умножение (mul) и деление (div) прямо в фильтре.
• Группировку и приоритет: используйте скобки (), чтобы сначала выполнилось одно условие, а потом другое.

Важно помнить форматы данных в OData и при составлении фильтров соблюдать синтаксис:

• строки в 'одинарных кавычках' (например, 'Onellect'),

• уникальные идентификаторы как guid’строка’ (например, guid’7426fe18-e7e6-11ec-872c-fa163e21d4b7’),

• даты в формате datetime’yyyy-mm-ddThh:mm:ss’. 

Примеры фильтров из рабочих кейсов для интеграции 1С → ELMA365.

1. Выгрузка актуальных коммерческих предложений. 

Нужны предложения по конкретному контрагенту (например, Onellect) за 2025 год, которые не удалены и имеют сумму более 10 000 рублей.

Фильтр:

DeletionMark eq false and Контрагент/Description eq 'Onellect' and Date ge datetime'2025-01-01T00:00:00' and Date le datetime'2025-12-31T23:59:59' and СуммаДокумента gt 10000

2. Контроль дебиторской задолженности.

Получаем счета, которые не оплачены более 14 дней. Такой фильтр удобно использовать для автоматического контроля просрочек, запуска уведомлений и постановки задач ответственному сотруднику. 

Фильтр:

DeletionMark eq false and СуммаДокумента gt 0 and datedifference(Date, 2026-03-26T00:00:00, 'day') gt 14

3. Выгрузка актов за период по нескольким контрагентам.

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

Фильтр:

DeletionMark eq false and Дата ge datetime'2025-04-01T00:00:00' and Дата le datetime'2025-04-30T23:59:59' and (Контрагент_Key eq guid'uuid-1' or Контрагент_Key eq guid'uuid-2' or Контрагент_Key eq guid'uuid-3')

Фильтрация по ссылочным полям.

В OData можно обращаться к связанным объектам, например, выбрать контрагентов из папки «Покупатели»: Parent/Description eq 'Покупатели'. 

Фильтрация данных при передаче из ELMA365 в 1С.

Для обратного направления передачи данных из ELMA365 в 1С используется JSON-структура фильтров и язык EQL. Это позволяет создавать более сложные и глубокие иерархические правила: задавать комбинированные условия, использовать вложенные конструкции и фильтровать данные по статусам, датам и связям между объектами. Любой фильтр начинается с конструкции: {}.

Какие инструменты доступны в ELMA365:

• Табличные фильтры (tf): готовые наборы условий для разных типов полей.
• Операции условий: равно, множественный выбор, проверка пустого значения. 
• Операции сравнения: больше (gt), больше или равно (gte), меньше (lt), меньше или равно (lte).
• Поиск по частичному совпадению.
• Использование EQL: можно прописать условие максимально быстро (например, [price] = 4000).
• Логические операции: «И» (and), «ИЛИ» (or), а также «НЕ» (not) (инверсия).

Примеры фильтров из рабочих кейсов для интеграции ELMA365 → 1С. 

1. Чистота базы: проверка контрагентов перед выгрузкой.

Не отправляем из ELMA365 в 1С новых контрагентов, если у них не заполнен ИНН.

{ 
  "and": [ 
    {"neq": [{"field": "inn"}, null]}, 
    {"neq": [{"field": "inn"}, {"const": ""}]}, 
    {"eq": [{"field": "exportedTo1C"}, {"const": false}]}, 
    {"eq": [{"field": "__status"}, {"const": 1}]} 
  ] 
}

2. Финансовый контроль заявок на оплату.

Передаем в 1С только согласованные заявки на оплату, которые еще не были отправлены и имеют привязанного контрагента.

{ 
 "and": [ 
    {"eq": [{"field": "__status"}, {"const": 3}]}, 
    {"eq": [{"field": "sentTo1C"}, {"const": false}]}, 
    {"neq": [{"field": "counterparty"}, null]}, 
    {"gte": [{"field": "__createdAt"}, {"const": "2025-01-01T00:00:00Z"}]} 
  ]
}

3. Синхронизация номенклатуры.

Выгружаем только те позиции, которые не были еще синхронизированы с 1С и требуют обновления. Это помогает избежать обмена лишними данными и ускорить синхронизацию. 

{ 
 "and": [ 
   {"eq": [{"field": "syncedTo1C"}, {"const": false}]}, 
     {"neq": [{"field": "__name"}, null]} 
  ] 
} 

Рекомендации по настройке фильтров.

Чтобы интеграция работала стабильно и быстро:

• Всегда ограничивайте выборку: не выгружайте все данные подряд, лучше ограничьте период, конкретные статусы или другие признаки актуальности для вас.
• Проверяйте заполненность ключевых полей: ИНН, GUID, статус документа, связанного контрагента.
• Используйте статусы синхронизации: создавайте кастомные флаги, чтобы исключить повторную передачу данных (например, можетеsentTo1C = false)
• Группируйте сложные условия: используйте скобки и вложенные конструкции, чтобы избежать ошибок логики.

Фильтры в Коннекторе 2.0 не просто техническая настройка, а полноценный инструмент управления интеграцией между 1С и ELMA365. Грамотно настроенные условия позволяют ускорить обмен данными, снизить нагрузку на инфраструктуру, повысить качество данных, сократить количество ошибок и передавать только действительно необходимую информацию. А главное, большинство сценариев можно реализовать без глубокого программирования, используя стандартные конструкции OData и JSON-фильтров ELMA365. 

Если при настройке возникнут сложности или потребуется реализовать нестандартный сценарий, наши специалисты помогут подобрать оптимальное решение и настроить интеграцию под ваши задачи.