Условный пример: в CRM заказ помечен как оплаченный, а в учётной системе это означает лишь «выставлен счёт». Соединение работает, записи обновляются, сотрудники спорят. Интеграция честно переносит недоразумение с одного экрана на другой.
Интеграция — обмен данными между программами. Перед её разработкой нужен небольшой словарь: какое значение из первой системы чему соответствует во второй и по какому правилу. Здесь важна не похожесть названий, а одинаковый смысл.
Начните с бизнес-определения
Возьмите одно поле, от которого зависит действие сотрудника. Например, «готов к выдаче». Запишите, какое событие позволяет поставить это значение: товар собран, документы проверены или клиент подтвердил время?
Укажите, кто подтверждает событие и где его можно проверить. Если отделы не договорились об определении, соединять их поля автоматически рано. Круг не станет треугольником оттого, что его очень уверенно передали.
Отдельно запишите, зачем получателю нужно поле. Иногда ему требуется подтверждение готовности, а не все промежуточные внутренние статусы отправителя.
Опишите формат и соответствия
Для каждой пары полей достаточно понятного описания:
- название и назначение в обеих системах;
- тип значения: текст, число, дата, список или связь с другой записью;
- разрешённые варианты и их соответствия;
- что означает отсутствие значения;
- кто согласует изменение правила.
Одинаковая подпись не гарантирует одинаковый тип. В документации по полям CRM Битрикс24 описаны идентификаторы и типы: специалист должен сверить реальные поля конкретного портала, а не угадывать их по экрану.
Не путайте «нет», «неизвестно» и «не передавали»
Пустое значение может означать, что данных ещё нет, их очистили или отправитель вообще не включил поле в сообщение. Это разные ситуации. Решение «всё пустое превращаем в ноль» способно изменить смысл заказа.
Согласуйте поведение при неизвестном значении списка: остановить обработку для разбора, сохранить исходное значение отдельно или применить утверждённое соответствие. Не подставляйте случайный первый вариант.
Для компании в Казахстане включите в примеры используемые языки, форматы контактов и даты. Названия на разных языках не следует принимать за технические идентификаторы.
Проверьте правило на маленькой выборке
Подготовьте обезличенные примеры: обычное значение, пустое поле, новый вариант списка, исправление ранее переданных данных. Для каждого заранее запишите ожидаемый результат и действие сотрудника.
В Битрикс24 и другой системе проверьте не только наличие записи, но и её смысл. Перед внедрением уточните возможности API — интерфейса для обмена между программами, права и ограничения выбранных продуктов. Смена CRM для этого не обязательна.
QQDev разрабатывает интеграции через API. На странице разработки интеграций можно обсудить вашу пару систем и границы обмена. Начните с одного поля, из-за которого команда спорит: хороший словарь часто экономит больше обсуждений, чем ещё одна кнопка.