Разделы руководства
Не получается: найдите причину по симптому
Нет действия или шаблона, поле пустое, строки не повторяются, ошибка БП либо неверное оформление. Порядок проверки и сведения для поддержки.
В этой инструкции Разделов: 12
Начните с места, где остановилась работа. Если файл вообще не создаётся, проверьте запуск и ошибку генерации. Если файл готов, но содержит неверные данные, сравните источник, выражение в шаблоне и значение в карточке.
Не открывается приложение
- Вернитесь в свой Битрикс24 и откройте установленную «Фабрику документов» из списка приложений.
- Дождитесь завершения установки или обновления. Сообщение «Не удалось завершить установку» нужно исправить до работы с CRM.
- Если есть отдельное рабочее окно приложения, проверьте его содержимое: промежуточная страница запуска может оставаться под ним.
- Сохраните видимый текст ошибки и время. Если повторный запуск из портала не помог, передайте их администратору или поддержке.
В карточке нет «Сформировать документ»
Попросите администратора открыть «Настройки» → «Встройки в карточках CRM» → «Открыть настройки встроек». Нужный тип карточки или смарт-процесс должен быть отмечен. После «Сохранить и зарегистрировать» заново откройте карточку. Полная настройка.
В списке нет моего шаблона
- Найдите его в «Шаблоны» приложения.
- Проверьте состояние и текущую версию.
- Сравните «Сущности шаблона» с типом открытой карточки. Совместимость со сделкой не означает совместимость с лидом или смарт-процессом.
- Если редактировали личный черновик DOCX, проверьте, опубликована ли нужная версия. Сохранение черновика не меняет рабочий шаблон.
Генерация завершилась ошибкой
- Откройте «Генерации».
- Найдите попытку по времени и названию шаблона.
- Прочитайте столбец «Ошибка».
- Проверьте сообщения анализа в карточке шаблона.
- Исправьте указанную причину и запустите новую генерацию.

Не запускайте многократно одно и то же действие, пока причина не понятна. Каждый новый запуск создаёт отдельный результат.
Поле пустое или содержит данные другого клиента
| Что проверить | Как исправить |
|---|---|
| Источник | Убедитесь, что запускаете нужную карточку. В действии по ID проверьте именно указанный ID |
| Путь и регистр | Скопируйте переменную заново из каталога своего портала |
| Поле действительно заполнено | Откройте исходную карточку и проверьте значение |
| Клиент связан с карточкой | Выберите нужную компанию или контакт |
| Покупатель и продавец | Поля company относятся к клиенту, my_company к своей организации |
| Реквизиты и банк | Проверьте заполнение соответствующих реквизитов и банковских данных |
| Права | Повторите проверку под тем пользователем, который запускает документ |
| Несколько типов карточек | deal.title относится к сделке. Для общего шаблона нужен подходящий алиас и отдельная проверка каждого типа |
Фильтр default может вывести запасной текст. Он не получает отсутствующие реквизиты. Источники данных.
Артикул товара не появился
Свойства товаров добавлены в обновлении от 15.10.2026. Если их нет в каталоге, сначала проверьте обновление установки приложения, права администратора и разрешение на товарный каталог.
В версии с поддержкой свойств проверьте:
- Используется
{{ item.properties.property109 }}внутри товарного цикла, а109заменён кодом своего портала. - Свойство заполнено у товара или вариации, выбранной в строке CRM. Значения родительского товара автоматически не наследуются.
- Позиция связана с товаром каталога. У свободной позиции свойства каталога нет.
- Пользователь имеет доступ к товару, приложению разрешён товарный каталог.
- Для просмотра описаний свойств каталог открыт администратором.
Пустое свойство даёт пустую ячейку. Ошибка чтения товара останавливает генерацию и требует исправить доступ.
Строки таблицы не повторяются
В Word должна быть настоящая таблица: шапка, отдельная строка {%tr for item in products %}, строка с полями item, отдельная строка {%tr endfor %}. Не помещайте все выражения в один абзац или одну ячейку.
В Excel начало {{#products}}, строка данных и конец {{/products}} должны занимать разные строки листа. Не объединяйте ячейки через границу блока.
Имя списка должно совпадать с данными: products для товаров, tasks для связанных задач. При пустом списке строк данных не будет. Word · Excel.
Остались скобки или служебные выражения
Проверьте точное написание, закрытие скобок и границ блока, сообщения анализа и опубликованную версию. После исправления внешнего файла загрузите новую версию, чтобы приложение заново проверило выражения.
Ошибка времени, даты или суммы
duration принимает целые неотрицательные секунды. Текст, дробные или отрицательные значения требуют исправления входных данных. Для даты не путайте MM (месяц) и mm (минуты). Денежные фильтры используют рубли, а percent не умножает долю на сто. Примеры форматирования.
В БП не видно дополнительных значений
Это поле добавлено в обновлении от 15.10.2026. Администратор проверяет обновление приложения и обновляет параметры действия через «Роботы и БП» → «Переустановить». Затем нужно заново открыть настройки действия в Битрикс24.
Если поле уже есть, передавайте JSON-объект без обёртки custom. Проверяйте кавычки, переносы и совпадение ключа с маркером. Полный пример БП.
Файл создан, но выглядит неправильно
Откройте его в Word или Excel и проверьте исходное оформление: ширину столбцов, высоту строк, длинные значения, объединения, шрифты, колонтитулы и область печати. Редактор DOCX находится в бета-версии, замена шрифта может менять переносы. PDF проверяйте отдельным файлом.
Что передать в поддержку
- действие перед ошибкой и время запуска;
- формат и название шаблона;
- ID генерации и точный текст ошибки;
- обезличенный фрагмент шаблона и пример ожидаемого результата;
- сведения, возникает ли проблема у администратора и у обычного пользователя.
Не передавайте пароли, API-ключи или клиентские документы с закрытыми данными. Связаться с S-WEBS.