ЭДО в Битрикс24: как настроить выгрузку УПД и актов в Контур.Диадок через EDO.FIX4.ORG

Печатная форма договора или счета в PDF закрывает визуальное согласование, но не заменяет юридически значимый ЭДО. Разбираем, как связать данные сделки в CRM с отправкой электронных актов и УПД через операторов без дорогой заказной разработки.

Классический обмен закрывающими документами часто отнимает у компании больше времени, чем само оказание услуги:

1. Менеджер закрывает сделку и отправляет запрос в бухгалтерию.
2. Бухгалтер готовит акт или УПД в учетной системе, распечатывает бумажный комплект и передает на подпись руководителю.
3. Документы отправляются клиенту почтой или курьерской службой.
4. Клиент подписывает оригиналы со своей стороны и отправляет второй экземпляр обратно.
5. Бухгалтерия вручную проверяет возврат и архивирует бумажный комплект.

Даже когда компания начинает формировать печатные акты прямо в CRM, а для доставки подключает электронный документооборот (ЭДО), возникает новый участок ручного труда: сотрудникам приходится вручную перебивать реквизиты, наименования работ, количество и суммы из карточки сделки Битрикс24 в веб-редактор оператора ЭДО. При большом потоке сделок это приводит к опечаткам в номенклатуре и задержкам выставления документов.

Разберем, как устроена выгрузка закрывающих документов из Битрикс24 в систему ЭДО (на примере Контур.Диадок) с помощью приложения Электронный документооборот (EDO.FIX4.ORG), почему для налоговой отчетности нужен регламентированный XML-файл и как автоматизировать процесс от карточки сделки до подписания КЭП.

Открыть видео на YouTube

Коротко

Если компании требуется юридически значимый обмен актами и УПД на базе данных Битрикс24, процесс строится по следующей схеме:

1. Сделка в Битрикс24 как источник данных: в карточке сделки фиксируются товарные позиции, стоимость, ставка НДС, компания-клиент и реквизиты сторон.
2. Утвержденный ФНС формат XML: для признания расходов и налогового учета формализованные первичные документы передаются через операторов ЭДО в строго регламентированной структуре XML, а не в виде произвольных PDF-файлов.
3. Генерация XML в один клик: приложение EDO.FIX4.ORG в Битрикс24 Маркетплейс автоматически собирает данные сделки и реквизитов, формирует валидный XML-документ и прикрепляет его к сделке.
4. Пакетная загрузка и подпись: готовые XML-файлы перетаскиваются в личный кабинет оператора (Контур.Диадок, СБИС и др.) — по одному или пачкой до 30 документов за раз, после чего руководитель подписывает их квалифицированной электронной подписью (КЭП).
5. Доставка через роуминг: если контрагент подключен к другому оператору ЭДО, обмен происходит через межоператорский роуминг без необходимости настраивать отдельные интеграции под каждый сервис.

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

Разница между печатным документом CRM и формализованным ЭДО

В Битрикс24 есть удобный штатный генератор документов CRM. По данным сделки он создает печатную форму акта, счета или договора в формате DOCX/PDF с подстановкой логотипа, подписи и печати.

На практике штатный печатный акт в сделке отлично подходит для первого шага — быстро показать документ клиенту и предварительно согласовать формулировки работ и суммы до отправки в ЭДО.

Интерфейс сделки в Битрикс24: в таймлайне отображается созданный печатный документ для предварительного согласования с клиентом

Однако для официального закрытия сделки и налогового учета между штатным PDF и формализованным документом ЭДО есть принципиальная разница:

• Формализованный XML по стандарту ФНС: налоговая служба утверждает строгий электронный формат первичных учетных документов (УПД и актов). Внутри XML-файла каждое поле — от ИНН, КПП и кода региона до ставок НДС и итоговых сумм — находится в регламентированном узле схемы.
• Проверка квалифицированной электронной подписью (КЭП): аккредитованный оператор ЭДО проверяет действительность сертификата подписи руководителя и фиксирует юридически значимую метку времени.
• Автоматическое распознавание у контрагента: когда клиент получает формализованный XML в своем кабинете ЭДО или загружает его в учетную систему, программа сразу считывает номенклатуру, контрагента и суммы без ручного ввода. Обычный PDF-файл проходит как неформализованное вложение, которое бухгалтерии сложно принять к автоматическому учету.

Почему универсальный XML практичнее прямой API-интеграции

При постановке задачи «связать Битрикс24 и ЭДО» компании часто рассматривают заказную разработку прямого коннектора по REST API к конкретному оператору. На практике такой путь упирается в три ограничения:

1. Десятки разных операторов на рынке: помимо Контур.Диадок, компании работают в СБИС (Тензор), Калуга Астрал, Такском и десятках других сервисов. Прямая интеграция с API одного провайдера занимает месяцы разработки, а при появлении второго оператора задачу приходится решать заново.
2. Высокая стоимость API-ключей: доступ к интеграционному API у крупных операторов ЭДО для внешних систем часто тарифицируется отдельно и обходится в десятки и сотни тысяч рублей еще на старте проекта.
3. Единый государственный стандарт XML: поскольку формат XML для УПД и актов утвержден ФНС, любой аккредитованный оператор ЭДО обязан уметь загружать такие файлы в штатном веб-интерфейсе.

Формирование стандартного XML-файла внутри Битрикс24 дает универсальность: вы используете приложение в рамках стандартной подписки Битрикс24 Маркет Плюс, а полученные файлы можете загружать в любую систему ЭДО и передавать контрагентам через роуминг.

Как устроена работа EDO.FIX4.ORG

Приложение EDO.FIX4.ORG работает со сделками Битрикс24: оно считывает реквизиты вашей организации, реквизиты клиента и таблицу товаров сделки, преобразует их в регламентированный XML-файл на сервере обработки, прикрепляет готовый файл обратно в карточку сделки и уведомляет сотрудника в таймлайне.

Сделка в CRM (товары + реквизиты сторон)
                   │
                   ▼
       Приложение EDO.FIX4.ORG
   (генерация регламентированного XML)
                   │
                   ▼
   Готовый XML-файл и комментарий в сделке
                   │
                   ▼
Загрузка в Контур.Диадок / СБИС (до 30 файлов)
                   │
                   ▼
   Подписание КЭП руководителя в 1 клик
                   │
                   ▼
     Доставка контрагенту (или роуминг)

1. Окно настроек после установки приложения

Приложение устанавливается из каталога Битрикс24 Маркетплейс администратором портала. Поскольку общие параметры задаются один раз, после настройки пункт приложения можно скрыть из левого меню сотрудников (при необходимости оно всегда открывается через верхний глобальный поиск).

Окно с настройками после установки приложения EDO.FIX4.ORG в Битрикс24

На вкладке «Настройка» заполняются три ключевых блока параметров:

• Выберите компанию (компания по умолчанию) — здесь выбирается ваша основная организация из справочника CRM, а также указываются основные реквизиты компании и банковские реквизиты компании. Именно от лица этой компании по умолчанию будет происходить генерация закрывающих документов, если в конкретной сделке не выбрано другое юридическое лицо.
• Сохранять данные о работе приложения в комментариях к сделке (Да / Нет) — при значении Да приложение публикует в ленте (таймлайне) сделки сервисные уведомления о ходе генерации: сообщает об успешном создании XML-файла либо подсказывает, каких данных не хватает в карточке (например, если не заполнены товары, не привязана компания или отсутствует код региона).
• Статус УПД, если не выбрано в сделке (СЧФДОП или ДОП) — задает статус универсального передаточного документа по умолчанию:
  • СЧФДОП (статус 1) — счет-фактура и передаточный документ (акт);
  • ДОП (статус 2) — только передаточный документ (документ об отгрузке товаров или передаче результатов работ без счета-фактуры).

После выбора параметров достаточно нажать кнопку «Сохранить».

2. Подготовка реквизитов и связка с «Быстрым заполнением реквизитов»

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

• Двузначный код региона РФ и детальный юридический адрес (индекс, регион, город, улица, дом);
• Корректный тип организации (ООО или ИП): по требованиям ФНС структура XML-титула для индивидуального предпринимателя отличается от структуры юридического лица. Если для ИП сформировать файл по шаблону организации, Контур.Диадок выдаст ошибку контрольного соотношения ИНН.

Для автоматического формирования этих полей EDO.FIX4.ORG работает в связке со вторым приложением CRM4 — «Быстрое заполнение реквизитов» (INN.FIX4.ORG), использующим сервис DaData:

1. В настройках приложения «Быстрое заполнение реквизитов» включите опцию «Сохранять детальные данные для корректной работы системы ЭДО» (а также адаптацию юридического адреса) и сохраните изменения.
2. Приложение создаст в карточке компании специальный блок дополнительных полей для ЭДО (включая код региона, тип субъекта и разложенный по полочкам адрес).
3. Перейдите в карточку своей компании и карточку компании клиента во вкладку «Автореквизиты» и обновите реквизиты по ИНН, а также добавьте банковские реквизиты (по БИК или названию банка).
4. Важная особенность для ИП: государственные реестры и сервисы автозаполнения по ИНН отдают адрес регистрации индивидуального предпринимателя только до улицы. Поэтому при работе с ИП обязательно проверьте блок адресных полей ЭДО в карточке компании и вручную дозаполните номер дома и квартиру/офис.

Открыть видео на YouTube

3. Поля в карточке сделки и правила формирования данных

В настоящее время приложение генерирует XML-документы только в сущности «Сделка» (смарт-процессы и отдельные счета не используются). При этом действует правило: одна сделка = один закрывающий документ. Если с клиентом проведено несколько мелких работ и нужен единый акт, все товарные позиции необходимо объединить в рамках одной сделки.

Для успешной генерации в сделке должны быть:

• выбрана компания-клиент с заполненными реквизитами ЭДО;
• заполнена вкладка «Товары» (наименование позиции, количество, цена, единица измерения; поддерживаются в том числе сценарии с настройкой «НДС не включать в цену»).

При установке приложение создает в сделке пользовательские поля с префиксом [EDO.FIX4.ORG] (или edo_), которые удобно вывести в отдельный блок карточки:

4. Ручной и автоматический запуск генерации

Запускать создание XML-документа можно как вручную на любом коммерческом тарифе Битрикс24 с подпиской Маркет Плюс, так и автоматически на тарифах с поддержкой роботов и бизнес-процессов.

Ручной запуск менеджером:
Когда товары и реквизиты проверены, сотрудник выставляет в поле Сгенерировать XML значение Да и сохраняет сделку. Сервер приложения получает событие обновления сделки, проверяет полноту реквизитов, формирует файл, загружает его в поле сделки и удаляет временную копию со своего сервера.

В таймлайне сделки появляется сервисный комментарий от приложения EDO.FIX4.ORG: Внимание! XML-файл успешно!, подтверждающий готовность документа.

Интерфейс сделки в Битрикс24: в таймлайне отображается комментарий «EDO.FIX4.ORG: Внимание! XML-файл успешно!»

Автоматический запуск роботом на стадии сделки:
Отдельного кастомного активити в дизайнере бизнес-процессов не требуется, так как приложение реагирует на изменение стандартного поля сделки. На нужной стадии воронки (например, «Услуга оказана» или «Лицензия активирована, акт отправлен») добавляется штатный робот «Изменить элемент», который устанавливает поле Сгенерировать XML = Да. Как только сделка переходит на эту стадию, XML формируется автоматически.

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

Сценарии передачи документов в Контур.Диадок

После того как XML-файл сформирован в сделке, его остается загрузить в личный кабинет оператора ЭДО и подписать электронной подписью.

Интерфейс кабинета ЭДО Контур.Диадок: вкладка «Документы» → «Новый документ» с областью загрузки до 30 файлов за раз

На практике компании используют один из трех сценариев:

Сценарий 1. Поштучная загрузка из карточки сделки

Менеджер скачивает готовый XML-файл из поля сделки на компьютер, открывает Контур.Диадок (Документы → + Новый документ) и перетаскивает файл в окно загрузки. Система автоматически распознает получателя по ИНН, подставляет номер, дату, номенклатуру и сохраняет документ в черновики, откуда руководитель подписывает и отправляет его в один клик.

Сценарий 2. Пакетная выгрузка за день через Битрикс24.Диск (рекомендуемый)

Когда сделок за день проходит много, заходить в каждую карточку вручную неэффективно. В этом случае настраивается простой бизнес-процесс, который при появлении нового XML-файла в сделке автоматически копирует его в выделенную папку на Битрикс24.Диск (с группировкой по датам или контрагентам), синхронизированную с компьютером ответственного сотрудника.

В конце рабочего дня бухгалтер или ассистент открывает папку за текущий день, выделяет сразу до 30 XML-файлов и одним движением перетаскивает их в окно «Новый документ» в Контур.Диадок. Все документы мгновенно попадают в раздел «Черновики», после чего руководитель с токеном КЭП заходит в кабинет один раз за день и нажимает «Подписать и отправить все».

Сценарий 3. Фоновая выгрузка через утилиту Диадок.Коннектор

Для тех, кто хочет исключить даже ручное перетаскивание папок, у оператора Контур.Диадок существует настольная служба для ПК или сервера — Диадок.Коннектор. Она отслеживает локальную папку, куда синхронизируются XML-файлы из Битрикс24, и автоматически загружает новые документы в черновики оператора (условия тарификации и настройки самой утилиты уточняются в техподдержке Контур.Диадок).

Частые ошибки при отправке и ответы на вопросы

В подробном мастер-классе разобраны реальные ситуации, с которыми сталкиваются администраторы и бухгалтеры при настройке связки Битрикс24 и ЭДО:

Открыть видео на YouTube

1. Ошибка в Диадоке: «Неверное значение ИНН, не удовлетворяет контрольному соотношению»

• Когда возникает: при отправке документа, где ваша компания или контрагент является Индивидуальным предпринимателем (ИП).
• Причина: в XML-структуре ФНС титулы для ООО и для ИП различаются. Если в карточке компании не заполнены дополнительные поля типа организации и кода региона, файл формируется по структуре юрлица, а 12-значный ИНН предпринимателя не проходит проверку для ООО.
• Решение: установить приложение «Быстрое заполнение реквизитов» (INN.FIX4.ORG), включить в его настройках сохранение детальных данных для ЭДО, пересохранить реквизиты компании через вкладку «Автореквизиты» и заново запустить генерацию XML в сделке.

2. Неполный адрес компании или ИП в сформированном XML

• Причина: данные для XML забираются из специальных детализированных полей ЭДО в карточке компании. Кроме того, по индивидуальным предпринимателям база налоговой и DaData возвращают адрес только с точностью до улицы.
• Решение: убедиться, что в настройках автореквизитов включена опция детальных данных для ЭДО, обновить реквизиты вашей компании и клиента, а для ИП вручную дописать номер дома и офис/квартиру в полях адреса для ЭДО.

3. В Диадоке загруженный файл определяется как УПД, а нужен Акт

• Причина: утвержденный ФНС формат XML универсален — одна и та же схема описывает и УПД, и акт, и накладную. Внутри файла нет отдельного тега, который принудительно переключал бы интерфейс оператора в режим акта.
• Решение: после перетаскивания XML-файла в Контур.Диадок откройте карточку документа в черновиках и переключите тип отображения с «УПД» на «Акт» штатным переключателем самого сервиса ЭДО.

4. Просьба бухгалтерии дописать «ИП» перед ФИО в строке «Сдал»

• Причина: в визуальной печатной форме, которую строит оператор ЭДО из XML, для организаций пишется «ООО …», а для предпринимателей указываются только фамилия, имя и отчество.
• Решение: объяснить бухгалтерии, что таково требование формата ФНС. В классификаторе электронного документооборота ИП проходит как физическое лицо (экономический субъект без образования юрлица), поэтому подстановка текстовой приставки «ИП» в поле ФИО не предусмотрена схемой валидации.

5. В Диадоке не подставляется получатель при загрузке файла

• Причина: между вашей организацией и контрагентом в сети ЭДО еще не установлено соединение (не принято приглашение к обмену).
• Решение: перед первой отправкой найдите контрагента по ИНН в разделе «Контрагенты» личного кабинета ЭДО и отправьте ему приглашение (в том числе по роумингу). После принятия приглашения все последующие XML-файлы будут автоматически привязываться к карточке этого партнера.

Главное

1. Печатный PDF — для согласования, регламентированный XML — для ЭДО: используйте штатный генератор документов Битрикс24 для быстрой визуальной сверки с клиентом, а закрывающие акты и УПД для операторов ЭДО формируйте в утвержденном ФНС формате XML.
2. Универсальный файл вместо дорогих коннекторов: XML-документ из EDO.FIX4.ORG одинаково принимается в Контур.Диадок, СБИС и других сервисах без покупки платных API-ключей.
3. Проверяйте полноту реквизитов: обязательно используйте автозаполнение реквизитов с кодом региона и типом организации (ООО/ИП), а для ИП проверяйте наличие номера дома в адресе.
4. Пакетная работа экономит время руководителя: собирайте сгенерированные за день XML-файлы в папку на Диске и загружайте их в Диадок пачкой до 30 штук, чтобы подписывать весь дневной реестр одной кнопкой.