DEV Community

Глеб Лужбин S-WEBS
Глеб Лужбин S-WEBS

Posted on Originally published at s-webs24.ru

Спецификация в Excel из Битрикс24: настройка XLSX-шаблона

Клиенты часто просят спецификацию не PDF-картинкой, а живым Excel-файлом — чтобы проверить строки, поменять количество, пересчитать сумму. В Битрикс24 это закрывается приложением «Фабрика документов»: оно подставляет данные сделки в XLSX-шаблон и отдаёт готовый файл.

Когда Excel, а когда Word

XLSX выбирают, когда документ читают по строкам и колонкам: товары, количество, цены, итоги. Для договора с длинными текстовыми условиями удобнее DOCX. Формат решают под задачу документа, а не под количество доступных шаблонов.

Важный нюанс: сформированный файл — срез данных на момент генерации. Если менеджер потом поменяет состав сделки, ранее скачанный Excel сам не обновится.

Макет спецификации

Практичный шаблон делится на три части:

  1. Шапка — название сделки, клиент, дата. Название подставляется выражением вроде {{ deal.title }}, дата берётся из выбранного поля.
  2. Таблица товаров — колонки «товар / количество / цена / сумма строки».
  3. Подвал — итоги и постоянные условия поставки.

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

Повторяющаяся строка

Список товаров в XLSX оформляется блоком products. Начало блока, строка данных и конец занимают разные строки листа:

{{#products}}
{{{{ item.name }}}  {{{{ item.qty }}}   {{{{ item.price }}} {{{{ item.sum }}}}
{{/products}}
Enter fullscreen mode Exit fullscreen mode

Каждое выражение кладётся в свою ячейку. Заголовки колонок выносятся выше начала блока. Для каждого товара приложение создаст отдельную строку.

Подводный камень: строки ниже блока сдвигаются. Формулы и ссылки на ячейки нужно проверять на итоговом файле, а ячейки не стоит объединять через границу цикла.

Расчёт и оформление — разные вещи

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

Ещё момент: фильтры работают в рублях и не переключаются на валюту сделки автоматически. Валютный документ требует отдельного согласования источника валюты.

И рабочее правило: не складывайте «на глаз» сумму сделки и сумму товарных строк — это могут быть разные показатели. Заранее определите, какие итоги считаются основными.

Контрольный пример

Полезная сверка без скидок и налогов: две позиции по 1 250 ₽ и одна по 3 000 ₽ дают 5 500 ₽. Это учебная арифметика для проверки строк. Скидки и НДС сверяйте по конкретным значениям CRM.

Печать проверяют на краях: длинное название товара, несколько позиций, одна позиция и пустой список. Пустой список не должен превращаться в вымышленную строку поставки.

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

Можно использовать свой Excel-бланк? Да, если добавить в него поддерживаемые выражения и строки повторения. Сложные объединения ячеек и формулы требуют проверки на итоговом файле.

XLSX сам превратится в PDF? Нет, это отдельное преобразование, его доступность зависит от настройки приложения. Успешный Excel не гарантирует корректный PDF.

Учебные примеры DOCX/XLSX и синтаксис выражений — на странице приложения.

Читать полностью на S-WEBS24

Top comments (0)