Разработка шаблонов счетов Битрикс24

Счёт — документ, по которому клиент переводит деньги. Если он выглядит непрофессионально, не содержит всех обязательных реквизитов или не соответствует фирменному стилю компании, это влияет на восприятие бизнеса. Стандартный шаблон счёта Битрикс24 содержит базовые поля, но для реальной работы почти всегда требует доработки: добавления банковских реквизитов, печати и подписи, корректного отображения суммы НДС.

Разработка шаблонов счетов Битрикс24

Счета в Битрикс24: два режима

В Битрикс24 счета существуют в двух вариантах:

Старые счета (CRM → Счета) — отдельная сущность CRM, хранятся в таблице b_crm_invoice. Шаблон формируется через раздел CRM → Настройки → Шаблоны документов (тип «Счёт»). Доступны плейсхолдеры счёта: {InvoiceId}, {InvoiceAccount}, {InvoicePrice}, {InvoiceDate}.

Новые счета (смарт-процесс «Счета», появился в 2022) — работают как смарт-процесс, хранятся в таблице b_crm_dynamic_*. Шаблоны документов для них доступны через карточку счёта, плейсхолдеры соответствуют полям смарт-процесса.

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

Обязательные элементы шаблона счёта

По российскому деловому обороту счёт должен содержать:

• Реквизиты продавца: наименование, ИНН/КПП, юридический адрес, банковские реквизиты (БИК, расчётный счёт, корреспондентский счёт, наименование банка)
• Реквизиты покупателя: наименование, ИНН/КПП, адрес
• Номер и дата счёта
• Таблица товаров/услуг: наименование, количество, единица измерения, цена, сумма
• НДС (если применимо)
• Итоговая сумма цифрами и прописью
• Подпись, печать (в шаблоне — место для них)

Реквизиты продавца удобнее хранить статично в шаблоне docx — они редко меняются. Реквизиты покупателя подтягиваются из CRM через плейсхолдеры полей компании/контакта.

Банковские реквизиты и кастомные поля

Банковские реквизиты в стандартном Битрикс24 не хранятся как отдельная сущность. Решения:

• Статично в шаблоне — подходит, если один расчётный счёт. Просто, но при смене реквизитов нужно обновлять шаблон
• Кастомные UF-поля компании продавца — хранить реквизиты в полях компании-продавца в CRM, подтягивать через плейсхолдеры. Гибко, но требует настройки
• Реквизиты через модуль «Мои реквизиты» — в некоторых тарифах Битрикс24 есть встроенный справочник реквизитов, из которого данные автоматически подставляются в счёт

Сумма прописью

Нативной поддержки суммы прописью на русском в шаблонах Битрикс24 нет. Варианты:

• Менеджер заполняет кастомное поле вручную (неудобно, но просто)
• Робот в воронке вычисляет сумму прописью и записывает в кастомное поле при создании/изменении счёта (через JavaScript в бизнес-процессе или внешний вебхук)
• Внешний сервис через REST API: при изменении счёта вебхук вызывает скрипт, который вычисляет пропись и обновляет поле через crm.invoice.update

Кейс: шаблон счёта для IT-компании

ИТ-компания выставляет счета за техподдержку и разработку. Нужен счёт с: реквизитами компании, таблицей услуг (наименование, часы, ставка, сумма), НДС 20%, итогом прописью, подписями директора и главного бухгалтера.

Реквизиты — статично в docx. Таблица услуг — через блок повторения {#Products}. НДС и итог прописью — кастомные UF-поля, заполняемые роботом через бизнес-процесс (JS-действие вычисляет НДС и пропись). Подписи — строки с пустыми полями для живой подписи. Шаблон загружен в Битрикс24, протестирован на 10 счетах. Работа заняла 1,5 дня.

Сроки