S-WEBS24

Битрикс24

CRM, процессы и приложения для вашей компании

Разделы руководства
Фабрика документов · руководство

Частые вопросы и ограничения

Свой бланк, разные форматы, артикулы, значения БП, нумерация, PDF, черновики и повторная генерация. Короткие ответы со ссылками на инструкции.

В этой инструкции Разделов: 17

Если вы только начинаете, пройдите первый документ. Здесь собраны короткие ответы о форматах, данных, обновлениях и ограничениях.

Можно ли использовать свой договор или спецификацию?

Да. Сохраните бланк как DOCX или XLSX, замените изменяемый текст выражениями из каталога и загрузите файл через «Шаблоны» → «Новый шаблон». Для Word и Excel нужны отдельные файлы. Подробные шаги: DOCX и XLSX.

Можно ли получить Excel из шаблона Word?

DOCX-шаблон создаёт DOCX, XLSX-шаблон создаёт XLSX. Выбор другого исходного формата в параметрах действия не превращает Word-шаблон в Excel. Если нужны оба формата, подготовьте два шаблона. Дополнительный PDF зависит от доступного преобразования.

Где брать коды полей?

В форме загрузки нажмите «Открыть поля». В редакторе DOCX используйте «Доступные поля». Найдите поле своего портала и скопируйте готовую переменную. Не заменяйте код подписью, которую видите в CRM. Как выбрать источник данных.

Можно ли вывести пользовательское поле товара, например артикул?

Да, в обновлении от 15.10.2026 доступен путь вида {{ item.properties.property109 }} внутри строки товарного цикла. Номер 109 нужно заменить кодом своего свойства. Если поле не видно, проверьте обновление установки, права администратора и разрешение приложения на товарный каталог.

Примеры таблиц приведены отдельно для Word и Excel. Обычное пользовательское поле сделки и свойство товара имеют разные источники.

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

В поле «Дополнительные значения (JSON, необязательно)» передайте объект, например {"contract_number":"00015"}, и вставьте в шаблон {{ custom.contract_number }}. Поле добавлено в обновлении от 15.10.2026; у ранее установленных действий может потребоваться обновление параметров. Пошаговый пример с переменной БП.

Одно дополнительное значение распределится по всем товарам?

custom.article обозначает одно переданное значение и не сопоставляет артикулы с товарными строками. Для свойств каждой позиции используйте её данные внутри products. Внешняя интеграция может передать весь список самостоятельно через API.

Почему в тестовом документе поле заполнено, а в CRM пустое?

Тестовая генерация использует введённый JSON. При запуске из CRM данные загружаются из выбранной карточки и её связей. Проверьте реальное заполнение поля, выбранного клиента, доступ пользователя и точное выражение. Успешная проба на JSON не подтверждает загрузку из CRM.

Достаточно ли передать ID сделки через публичный API?

Нет. Публичный API получает полный payload, необходимый шаблону. Названия, товары, количества и свойства передаёт вызывающая система. Для загрузки карточки по ID внутри Битрикс24 используйте соответствующий робот или действие БП. Разница способов запуска.

Как выбирается своя организация, если их несколько?

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

Работает ли автоматическая нумерация?

Автоматическое присвоение следующего номера DOCX/XLSX по нумератору Битрикс24 пока не поддерживается. Выбор нумератора хранит привязку и не увеличивает его счётчик. Уже записанный в CRM номер можно вывести как обычное поле.

Изменение шаблона исправит старые документы?

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

Черновик редактора уже используется в роботах?

Нет. Черновик DOCX нужно проверить и опубликовать кнопкой «Опубликовать версию». Только после успешной публикации он станет текущей версией для новых документов. Работа с редактором.

PDF доступен всегда?

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

Сохраняются ли нули в начале артикула?

Артикул нужно передавать текстом, например "00042". Число 42 не содержит ведущих нулей. В новой загрузке свойств товара артикул сохраняется текстом. Проверьте и исходное значение, и тип ячейки результата Excel.

Можно ли вывести задачи и затраченное время?

Да, для связанных с карточкой задач используется список tasks. time_spent_in_logs содержит зарегистрированные трудозатраты в секундах. Для вывода времени используйте duration("HH:mm:ss"). Плановое время и прошедшее со дня создания время не заменяют зарегистрированные трудозатраты. Примеры данных и форматирование.

Для предложений (КП) загрузка списка связанных задач в текущей реализации не предусмотрена. Проверяйте свой тип карточки отдельно.

Как вывести картинку, QR-код или штрихкод?

Для таких элементов нужны специально подготовленные данные и подходящий шаблон. Произвольная ссылка в текстовом поле не гарантирует вставку картинки. Сначала проверьте обычные поля и таблицы; настройку изображения согласуйте для конкретного источника и проверьте на пробном файле.

Куда обращаться, если инструкция не помогла?

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