B2BPRO.KZ | Рекламное агентство в Алматы

Интеграция Битрикс24 с ЭДО: как наладить обмен документами в Казахстане

Сотрудница с планшетом рядом с ноутбуком, из которого вылетают документы и возвращаются подписанными, объёмная надпись Битрикс24: обмен документами между Битрикс24 и ЭДО

Типичная картина в казахстанской компании, которая уже год живёт в Битрикс24: менеджер закрывает сделку в CRM, скачивает договор в PDF, открывает сервис электронного документооборота в соседней вкладке, заново вбивает туда БИН клиента, прикладывает файл и отправляет на подпись. Через три дня клиент подписывает. Об этом знает только тот, кто догадался зайти в ЭДО. В карточке сделки по-прежнему висит стадия «Договор отправлен», а руководитель на планёрке спрашивает, почему сделка стоит.

Портал и система ЭДО по отдельности работают исправно. Проблема в том, что между ними нет обмена, и роль моста играет человек. Такой мост ошибается, уходит в отпуск и забывает поменять стадию. Ниже о том, как устроена интеграция Битрикс24 с ЭДО в Казахстане, какие варианты реально доступны облачному порталу и где проекты чаще всего застревают.

Что именно должно ходить между CRM и ЭДО

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

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

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

Третье движение: подписанный экземпляр возвращается в портал. Через год при споре о сроках или объёме работ кто-то должен открыть сделку и увидеть там финальную подписанную версию, а не черновик.

Четвёртое движение касается документов, которые живут в государственных системах. Электронные счета-фактуры и электронные акты выполненных работ в Казахстане выписываются в ИС ЭСФ, и это отдельный контур со своими правилами доступа. Его часто путают с коммерческим ЭДО, хотя технически это разные истории.

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

С чего начинается любой обмен: документы в CRM Битрикс24

Отправлять в ЭДО имеет смысл только документ, который собран без ручного копирования. В облачном Битрикс24 для этого есть штатный генератор. В карточке сделки, лида, контакта, компании и счёта есть кнопка «Документ»: менеджер выбирает шаблон, и CRM подставляет в него реквизиты клиента, сумму, товары и реквизиты вашей компании.

Шаблоны работают на кодовых словах, то есть метках в фигурных скобках, которые при создании документа заменяются значениями полей. Полный список кодов открывается прямо в портале: в настройках шаблонов есть пункт «Список полей». Свой шаблон загружается в формате DOCX, стандартные шаблоны счёта и акта можно отредактировать под себя. Всё это описано в официальной справке Битрикс24 и работает на облачных тарифах без доработок.

Для интеграции с ЭДО это важно по простой причине. Если договор собирается из карточки, то БИН, наименование и email контрагента уже лежат в CRM в структурированном виде. Их можно передать сервису подписи автоматически, и менеджеру не придётся вводить реквизиты второй раз. Если же договоры по-прежнему пишутся вручную в Word, первым шагом будет навести порядок в шаблонах, а интеграция подождёт.

У генератора есть и REST-методы семейства crm.documentgenerator: через них внешний скрипт может создать документ по шаблону, получить ссылку на PDF и забрать файл. Это пригодится, когда штатного приложения ЭДО не хватит и понадобится своя связка.

Готовые интеграции Битрикс24 с ЭДО для Казахстана

Для российского рынка в Маркетплейсе Битрикс24 десятки приложений под местных операторов. Для Казахстана выбор уже, и это нормально: здесь другие операторы, другая инфраструктура ЭЦП и подпись через NCALayer или eGov Mobile.

Documentolog Business

Самый заметный вариант. По официальному анонсу Битрикс24 Казахстан, интеграция с сервисом Documentolog Business доступна пользователям с 3 июля 2025 года. Заявленные возможности такие: документы формируются, согласовываются и отправляются из карточки клиента или сделки, подписываются через ЭЦП, eGov QR или SMS, а статус отправленного документа виден в интерфейсе Битрикс24. Сценарий подключения в анонсе описан в четыре шага: добавить приложение, авторизоваться в Documentolog, выбрать документ и отправить его на подписание.

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

Doodocs и другие сервисы

Doodocs, ещё один казахстанский сервис ЭДО, на своём сайте заявляет интеграцию с корпоративным порталом Битрикс24, открытый API, шаблоны документов и маршрутов, подпись через ЭЦП и eGov Mobile. Глубину этой интеграции под свой процесс стоит проверить на демо до оплаты: спросите, умеет ли она менять стадию сделки по факту подписи или только отправляет файл.

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

Когда готового приложения не хватает

Штатные связки хорошо справляются с типовым сценарием «сделка, договор, подпись». Своя интеграция нужна, когда процесс нестандартный. Например, документ должен уходить не из сделки, а из смарт-процесса «Договоры», где у одного клиента десятки договоров. Или подпись клиента должна автоматически запускать следующий этап: выставление счёта, создание задачи юристу, уведомление в чат отдела. Или у компании уже есть корпоративный контракт с оператором ЭДО, для которого в Маркетплейсе приложения нет.

Архитектура у таких решений почти всегда одинаковая. Облачный Битрикс24 не исполняет ваш серверный код, поэтому посредником становится небольшой коннектор на внешнем сервере. Схема такая:

  • сделка переходит на стадию «Договор на подпись», робот или бизнес-процесс отправляет HTTP-запрос коннектору;
  • коннектор через REST API забирает из портала сгенерированный PDF и реквизиты контрагента и передаёт их в API оператора ЭДО;
  • оператор сообщает коннектору об изменении статуса (или коннектор сам опрашивает его по расписанию);
  • коннектор через входящий вебхук записывает статус в поле сделки, прикладывает подписанный файл и двигает стадию.

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

ЭСФ и ЭАВР: отдельный контур, в который нельзя войти через приложение

Частый запрос от собственников звучит так: «хочу видеть в сделке, выписан ли по ней счёт-фактура и подписал ли клиент акт». Звучит как продолжение интеграции с ЭДО, но устроено иначе. Электронные счета-фактуры и электронные акты выполненных работ живут в государственной информационной системе ИС ЭСФ. Доступ к её API идёт через авторизацию с ЭЦП, и выписывает документы там обычно бухгалтер из учётной системы.

Мы проходили этот путь на собственном портале. Цель была скромная: подтягивать в Битрикс24 информацию о том, когда выписан акт и когда контрагент его подтвердил. Путь через учётную систему отпал сразу, потому что бухгалтер на аутсорсе ведёт много компаний в одной базе и открывать к ней внешний доступ не станет. Подключение напрямую к API ИС ЭСФ удалось: авторизация с ЭЦП прошла, сервис сессий отвечал реальными данными компании. А вот методы, которые отдают сами документы, возвращали пустой ответ, хотя в кабинете документы были. Пришлось писать в поддержку КГД.

Вывод из этого опыта практический. Если задача касается ЭСФ и ЭАВР, закладывайте время на согласования с государственной стороной и не обещайте команде срок, который зависит не от вас. Второй вывод: не заводите в CRM структуру, которую некому вести вручную. Мы сознательно не стали создавать смарт-процесс для актов, пока данные не начнут приходить автоматически, потому что бухгалтер на аутсорсе работать в портале клиента не будет, а менеджеры не должны переписывать туда реестр актов.

Коммерческий ЭДО (договоры, допсоглашения, коммерческие акты между компаниями) и государственный контур ЭСФ стоит планировать как два разных проекта. Первый даёт быстрый результат отделу продаж, второй нужен в основном финансовой службе.

Пример: как это выглядит в работе

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

После перестройки процесс стал другим. Шаблоны договоров переведены в генератор документов, реквизиты подтягиваются из карточки компании. На стадии «Согласование» бизнес-процесс ставит задачу юристу с документом во вложении. После согласования менеджер одной кнопкой отправляет договор через сервис ЭДО, а подписанный экземпляр и статус возвращаются в сделку. Стадия меняется автоматически, и руководитель видит в воронке, сколько договоров ждут подписи клиента и как давно.

Самый заметный эффект в таких проектах связан не со скоростью подписи. Руководитель перестаёт спрашивать «где договор», потому что ответ виден в воронке. Менеджер перестаёт тратить время на перекладывание файлов. А при проверке или споре подписанный документ находится за минуту в карточке сделки.

Где интеграция Битрикс24 с ЭДО обычно ломается

За проекты по внедрению мы собрали набор повторяющихся проблем. Почти ни одна из них не техническая.

Грязные реквизиты в CRM. Если у половины компаний не заполнен БИН или указан email бухгалтера вместо email подписанта, документ уйдёт не туда или не уйдёт вовсе. Перед запуском проверьте базу: какой процент карточек содержит всё, что нужно сервису ЭДО. Иногда первым этапом проекта становится чистка контрагентов.

Нет ответственного за обратный поток. Отправку настраивают все, а про то, что происходит после отказа клиента, забывают. В итоге отклонённый договор висит в статусе «на подписи» неделями. Решите заранее, куда падает отказ: задача менеджеру, возврат на стадию согласования, уведомление юристу.

Подпись со стороны компании. Клиент подписывает быстро, а директор со своей стороны подписывает раз в неделю пачкой. Определите, кто подписывает какие документы и есть ли у этих людей рабочие ключи ЭЦП на нужном устройстве. Мобильная подпись через eGov заметно ускоряет этот шаг, если сервис её поддерживает.

Файлы расходятся. Подписанный документ лежит в ЭДО, черновик в CRM, ещё одна версия в почте. Договоритесь, что источник правды один: подписанный экземпляр в карточке сделки, всё остальное считается рабочими копиями.

Права доступа. Договоры с суммами и условиями видны всем, у кого есть доступ к CRM. Перед массовой загрузкой документов в сделки пересмотрите роли: менеджер должен видеть свои сделки, а не чужие.

Какие вопросы задать сервису ЭДО до подключения

Демонстрация у любого сервиса выглядит гладко, поэтому полезно прийти на неё со своим списком. Ответы на эти вопросы экономят недели переделок после запуска.

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

Как статус подписи попадает в Битрикс24? Хорошо, если он пишется в поле или в ленту карточки и на это событие можно повесить робота. Хуже, если статус виден только внутри окна приложения: тогда автоматическая смена стадии не получится.

Возвращается ли подписанный файл в портал? Уточните, приходит ли в карточку сам документ с подписями или только ссылка на него в кабинете оператора. Ссылка перестанет работать, если вы когда-нибудь смените сервис.

Кому нужна учётная запись в сервисе? Спросите, должен ли каждый менеджер иметь свой аккаунт и свою подписку, или отправлять документы может общий аккаунт компании, а подписывает только директор.

Что будет, если клиент не зарегистрирован в этом сервисе? Для продаж новым клиентам это главный вопрос. Если контрагенту приходится регистрироваться и разбираться с чужим интерфейсом, часть клиентов вернётся к бумаге, и выигрыш по времени пропадёт.

Как выгрузить архив при отказе от сервиса? Подписанные договоры хранятся годами, а подрядчики меняются. Выясните формат выгрузки заранее, пока вы ещё выбираете, а не уходите.

План внедрения на четыре недели

Для компании среднего размера разумный порядок выглядит так.

Первая неделя уходит на инвентаризацию. Составьте список документов, которые подписываются с контрагентами, и отметьте, сколько их в месяц и кто их готовит. Проверьте, заполнены ли в CRM реквизиты, нужные для отправки. Выберите сервис ЭДО и уточните у него, как именно работает связка с Битрикс24.

Вторая неделя посвящена шаблонам. Переведите два-три самых частых документа в генератор CRM, проверьте, что все кодовые слова подставляются корректно, включая реквизиты вашей компании.

Третья неделя начинается с пилота. Подключите сервис на одну воронку и двух-трёх менеджеров. Прогоните реальные сделки, а не тестовые, потому что именно на реальных клиентах всплывают неправильные email и отсутствующие ЭЦП.

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

Если после пилота выясняется, что готового приложения не хватает, у вас на руках уже будет точное описание процесса. С ним заказ собственного коннектора обходится дешевле и занимает меньше времени, чем разработка «с нуля по устной задаче». Если хотите пройти этот путь с подрядчиком, посмотрите наши услуги по внедрению и настройке Битрикс24: мы начинаем с аудита портала и описания процесса, а затем подбираем связку с ЭДО под ваш документооборот.

Как понять, что интеграция окупилась

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

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

Частые вопросы

Можно ли подписывать документы ЭЦП прямо из облачного Битрикс24 в Казахстане?

Да, через приложения сервисов ЭДО. Например, интеграция с Documentolog Business, запущенная Битрикс24 Казахстан в июле 2025 года, позволяет отправлять документы из карточки сделки и подписывать их через ЭЦП, eGov QR или SMS.

Нужна ли программистская доработка для интеграции Битрикс24 с ЭДО?

Для типового сценария «договор из сделки уходит на подпись» обычно хватает готового приложения. Доработка нужна, если документы живут в смарт-процессах, подпись должна запускать цепочку действий или у вашего оператора ЭДО нет приложения в Маркетплейсе.

Можно ли получать в Битрикс24 статусы ЭСФ и электронных актов?

Технически это делается через API ИС ЭСФ с авторизацией по ЭЦП и отдельным коннектором на внешнем сервере. На практике такой проект зависит от доступа к API со стороны государственной системы, поэтому его стоит планировать отдельно от коммерческого ЭДО.

Что сделать в CRM до подключения ЭДО?

Перевести основные документы в шаблоны генератора CRM и проверить реквизиты контрагентов: БИН, наименование и email подписанта. Без этого интеграция будет отправлять документы с ошибками.

Где хранить подписанные документы: в ЭДО или в CRM?

Юридически значимый экземпляр остаётся в сервисе ЭДО, но его копия должна попадать в карточку сделки. Так менеджеры и руководитель находят документ за минуту, не заходя в другую систему.

Прокрутить вверх