Интеграции Битрикс24

Интеграция Битрикс24 и 1С:ДО: передача согласованных документов

Когда договор согласован в CRM, сотрудник нередко вручную создаёт карточку в 1С:Документообороте и повторно прикрепляет файл. Ошибка в версии или реквизитах обнаруживается уже после передачи. Автоматизацию такого сценария нужно начинать с определения момента, когда документ готов к регистрации, и системы, в которой хранится его окончательная версия. Обещать быстрый универсальный перенос без этих договорённостей преждевременно.

Разделите согласование и регистрацию

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

Зафиксируйте роли двух систем. Условная модель: в Битрикс24 организована подготовка договора, а 1С:ДО отвечает за регистрацию и дальнейшее движение документа. Возможна и обратная схема. Не создавайте два независимых маршрута, которые одновременно считают себя главными. Участники должны понимать, где смотреть актуальный статус и кто принимает решение при расхождении данных.

Проверьте технические возможности до оценки

У 1С:Документооборота есть механизмы взаимодействия с другими решениями, включая веб-сервисы и API; варианты перечислены на официальной странице 1С об интеграциях. Однако конкретная реализация зависит от редакции, версии, доработок и инфраструктуры. Наличие общего механизма не означает, что нужная операция уже доступна без настройки.

Соберите версии систем, перечень используемых расширений, требования к публикации сервиса и сведения о тестовой среде. Выясните, кто администрирует 1С и кто согласует создание служебного доступа. Для Битрикс24 проверьте доступность нужных методов и событий в вашей конфигурации. Техническое обследование должно завершиться подтверждённой схемой, а не предположением, что любые данные можно передать одинаковым способом.

Составьте таблицу сопоставления данных

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

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

Защитите передачу от повторов

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

Возвращайте в CRM идентификатор и ссылку зарегистрированного документа, если выбранная архитектура это допускает. Сохраняйте состояние операции: ожидает, передано, требует разбора. Не заменяйте журнал обмена единственным уведомлением сотруднику. Сообщение можно пропустить, а по журналу должно быть видно, что именно не передалось и какой следующий шаг необходим для восстановления.

Определите правила версий и вложений

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

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

Принимайте интеграцию по исключениям

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

Артём Иващенко

Артём Иващенко

Сооснователь AutoBIT24, золотой партнёр Битрикс24. Более 50 проектов внедрения CRM для бизнеса любого масштаба: от стартапов до производств. Специализация — автоматизация отделов продаж и бизнес-процессов.

Хотите автоматизировать свой бизнес?

Запишитесь на бесплатный разбор вашего отдела продаж — покажем, где теряются заявки и деньги

Записаться на разбор