Перейти к содержанию

Роботы и бизнес-процессы

Роботы и бизнес-процессы

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

Каждый робот возвращает результат «Сообщение об ошибке»: пустая строка — всё успешно; при проблеме вернётся текст с префиксом «Ошибка: …». Используйте это значение в следующих шагах бизнес-процесса для ветвлений и уведомлений ответственных.

Какие роботы входят в ЭДО24

Робот Что делает Параметры
Загрузить черновики в ЭДО Отправляет в ЭДО все исходящие документы элемента CRM в статусе «Черновик» нет
Загрузить документы из crm в ЭДО Загружает в ЭДО документ(ы) элемента CRM по выбранному источнику Тип документа, Источник документа, Код поля с файлом
Сформировать УПД Формирует УПД по сделке (на полную сумму или по товарным позициям) и загружает его в ЭДО нет

Робот «Сформировать УПД» работает только со сделками — для других сущностей вернёт ошибку. Робот «Загрузить документы из crm в ЭДО» работает со сделками и смарт-счетами; контрагент (компания или контакт) обязателен и для него. Через Диадок можно отправлять типы документов: счёт, договор, акт, УПД и неформализованный документ.

Создание УПД расходует оба тарифных лимита: «Документы в месяц» и «УПД в месяц». В лимит «Документы в месяц» попадают документы, созданные из формы и из смарт-процесса (включая созданные роботом «Сформировать УПД»); документы, отправленные роботами из черновиков/ленты, и импорт из ЭДО не считаются. Мягко удалённые документы квоты не расходуют.

Как добавить робота в бизнес-процесс

  1. Откройте раздел CRM → Роботы и бизнес-процессы (либо редактор роботов прямо на стадии сделки/смарт-процесса).
  2. В списке роботов найдите блок ЭДО24 и выберите нужного робота.
  3. Заполните параметры (см. таблицу выше) и сохраните робота на нужной стадии.
  4. В следующем шаге бизнес-процесса используйте возвращаемое значение «Сообщение об ошибке»: если оно непустое — отправьте уведомление ответственному или верните сделку на предыдущую стадию.

Для робота Загрузить документы из crm в ЭДО параметры:

  • Тип документа — какой документ загрузить (счёт, договор, УПД и т.д.). Для УПД файл документа должен быть в формате XML.
  • Источник документа — «Документ из поля» (файл берётся из указанного поля сделки) или «Последний документ из ленты».
  • Код поля элемента с файлом — заполняется, если выбран источник «Документ из поля»: укажите код поля сделки, в котором лежит файл документа.

Робот «Сформировать УПД»: какие данные должны быть предзаполнены

Робот создаёт УПД по сделке и сразу отправляет его контрагенту (отдельного шага «создать черновик» нет). Валюта документа — всегда рубли (RUB). Все реквизиты должны быть готовы до запуска бизнес-процесса: часть значений берётся из настроек приложения, часть — из сделки. Если чего-то не хватает, робот не формирует документ и возвращает понятный текст ошибки (см. таблицу ниже).

1. Настройки приложения (Настройки → блок «Генерация УПД»)

Данные Обязательно Комментарий
Компания-продавец по умолчанию ✅ От чьего имени выставляется УПД. Без неё робот вернёт ошибку «Не задан продавец по умолчанию»
Реквизиты продавца ✅ Карточка реквизитов у компании-продавца должна существовать. Пустой ИНН в проверку не попадает и уйдёт прямо в документ — обязательно заполните ИНН
Провайдер ЭДО ✅ Диадок / СБИС (Saby) — куда уйдёт документ. Если провайдер по умолчанию не выбран, берётся первый подключённый; подключён должен быть хотя бы один
Подписант ⚠️ желательно Берётся подписант компании-продавца либо подписант по умолчанию из настроек. Если не задан — УПД уйдёт без блока подписанта, контрагент может отказаться его принимать
Функция документа (СЧФДОП / ДОП) ❌ СЧФДОП (по умолчанию) — счёт-фактура + передаточный документ; ДОП — только передаточный документ (НДС в шапке гасится)
Ставка НДС по умолчанию ⚠️ Используется, когда позиция формируется «на полную сумму сделки» (см. ниже)
Тексты по умолчанию (содержание операции, наименование документа о передаче, документ отгрузки и др.) ❌ Подставляются в соответствующие поля УПД. «Содержание операции» без настройки — «Товары переданы»
Единица измерения по умолчанию — Роботом не используется (нужна только при ручном создании УПД из формы)

Для провайдера СБИС дополнительно должна быть выбрана организация-отправитель в настройках интеграции СБИС.

2. Данные сделки

Данные Обязательно Комментарий
Контрагент (компания или контакт) ✅ Покупатель по УПД. Без контрагента УПД не формируется
Реквизиты контрагента ✅ Карточка реквизитов у компании/контакта должна существовать (не оставляйте ИНН пустым — он попадёт в документ)
Товарные позиции сделки или сумма сделки ✅ Откуда берутся товары — см. правило ниже

Правило выбора позиций:

  • Если в привязке полей настроено поле «Название товара по умолчанию» и у сделки оно заполнено — робот создаёт одну позицию на всю сумму сделки (количество 1, ед. «шт», ставка НДС из настроек, НДС включён в цену). В этом варианте сумма сделки обязательна.
  • Иначе робот берёт все товарные позиции сделки (товары): название — из позиции или связанного товара, цена — с НДС или без в зависимости от флага позиции, единица измерения конвертируется в единицы УПД (незнакомая единица заменяется на «шт»), количество округляется по правилам УПД: до целого для «шт», «пара», «упак», «компл», «набор», до 0,01 — для остальных; пустое количество принимается за 1. Если у позиции ставка НДС не указана, подставляется «Без НДС»; неизвестное системе значение ставки заменяется на 20%.
  • Нет ни привязки с заполненным полем, ни товарных позиций — робот вернёт ошибку «У сделки нет товарных позиций для формирования УПД».

Ставки НДС: поддерживаются стандартные ставки (Без НДС, 0%, 5%, 7%, 9,09%, 10%, 16,67%, 18%, 18,3%, 20%, 22%) и их расчётные аналоги. Ставка «НДС у налогового агента» не поддерживается — робот откажется формировать позицию и вернёт ошибку «Неизвестная ставка НДС».

3. Привязка полей сделки (необязательно)

Привязка Что даёт
Название товара по умолчанию Включает режим «одна позиция на полную сумму сделки» (см. выше)

Привязки для ручной формы

Привязки «Номер УПД» и «Основание передачи» используются только при создании УПД вручную из формы. Робот «Сформировать УПД» всегда генерирует номер по шаблону из настроек и берёт содержание операции/основание из блока «Генерация УПД».

Типичные ошибки робота и что проверить

Текст ошибки (в возвращаемом значении) Что сделать
«Не задан продавец по умолчанию …» Заполните «Генерацию УПД» в настройках: выберите компанию-продавца
«У продавца/контрагента … не заполнены реквизиты (ИНН) …» Заведите реквизиты у соответствующей компании/контакта и заполните ИНН
«У сделки не задан контрагент …» Привяжите к сделке компанию или контакт
«У сделки не задана сумма (opportunity) …» Заполните сумму сделки (режим «на полную сумму») или отключите привязку «Название товара по умолчанию» и заполните товары
«У сделки нет товарных позиций …» Заполните товары в сделке либо настройте привязку «Название товара по умолчанию»
«Неизвестная ставка НДС …» Замените ставку «НДС у налогового агента» у позиции или в поле «Ставка НДС по умолчанию» на стандартную
«Не задан провайдер ЭДО …» Подключите провайдера ЭДО в настройках приложения
«Не задан шаблон номера документа. Укажите шаблон в настройках интеграции …» Задайте шаблон номера документов в настройках интеграции (по умолчанию — {ID}-{MONTH}.{YEAR})
«Не выбрана организация-отправитель СБИС …» Выберите организацию-отправителя в настройках интеграции СБИС
«Не выбран ящик Диадок получателя.» Убедитесь, что контрагент подключён к вашему Диадоку (при необходимости включите авто-приглашение контрагентов)
«Достигнут лимит документов (N в месяц).» Освободите квоту (мягко удалённые документы не считаются) или увеличьте тариф
«Достигнут лимит УПД (N в месяц).» То же для лимита УПД
«Создание УПД поддерживает только сделки.» Запускайте робота в бизнес-процессе сделки — для смарт-счётов и контактов формирование УПД не поддерживается

Связанные страницы

Обращайтесь к нашим специалистам

По любым вопросам настройки и расширения имеющегося функционала приложений обращайтесь в нашу службу поддержки.

Мы всегда поможем вам решить вашу задачу.