Калькулятор и смета в карточке сделки Битрикс24: сборка на Вайбкоде

Когда менеджер считает стоимость в Excel, а потом вручную переносит итог в CRM - данные расходятся, версии путаются, а история расчёта теряется. Вайбкод позволяет собрать калькулятор прямо внутри карточки сделки Битрикс24: он открывается как встройка, тянет цены из портала и записывает результат обратно в сделку.

Почему Excel рядом с CRM - это потеря данных

Схема «менеджер считает в таблице, копирует итог в сделку» ломается в нескольких точках:

• Версии расходятся. Клиент просит пересчёт - менеджер правит таблицу, но в сделку переносит не всегда.
• История исчезает. Через месяц непонятно, по какому прайсу считали и какую наценку применяли.
• Ошибки при переносе. Сумма с итоговой строки копируется вручную - это риск.
• Нет контроля. Руководитель не видит, из чего сложилась цена в сделке.

Альтернатива - калькулятор как приложение Вайбкода, встроенное прямо в карточку сделки. Менеджер не выходит из Битрикс24, расчёт сохраняется в сделке, история актуальна.

О том, что вообще можно собирать на этой платформе, читайте в обзоре что такое Битрикс24 Вайбкод.

Где живёт калькулятор и как он открывается из сделки

Приложение открывается прямо в карточке сделки через механизм плейсмента - это точка встраивания приложения в интерфейс Битрикс24. Плейсмент типа CRM_DEAL_DETAIL_TAB добавляет в карточку отдельную вкладку; плейсмент CRM_DEAL_DETAIL_ACTIVITY - блок в правую часть карточки. Оба варианта работают без перехода в браузерную вкладку.

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

Ключ авторизации для такого приложения создаётся администратором портала как OAuth-приложение - это даёт работу под правами конкретного пользователя, а не от имени одного владельца. Это важно, если нужно разграничить, кто может видеть закупочные цены, а кто - только итоговые.

Само приложение разворачивается на сервере Вайбкода. Для калькулятора среднего размера достаточно галактики - это хост, который уплотняет несколько десятков приложений на одном сервере и тарифицируется как единый хост. Отдельный сервер нужен, только если расчёт тяжёлый или объём данных большой.

После деплоя приложение автоматически появляется в каталоге приложений портала и открывается в том числе в мобильном приложении Битрикс24.

Путь от обращения клиента до сохранения расчёта в сделке выглядит так: менеджер открывает сделку, переходит на вкладку с калькулятором (плейсмент передаёт ID сделки), выбирает позиции, получает итог - и одной кнопкой всё сохраняется обратно в Битрикс24 через Vibe API.

flowchart TD
    DEAL[Карточка сделки] -->|плейсмент CRM_DEAL_DETAIL_TAB| APP[Приложение Вайбкода]
    APP -->|Vibe API: чтение данных сделки| B24[Битрикс24]
    APP -->|Vibe API: чтение позиций и цен| SP[Смарт-процесс: справочник цен]
    APP -->|Vibe API: запись позиций, файл расчёта| B24
    B24 --> DEAL

Откуда берутся цены и правила расчёта

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

Такой подход даёт несколько преимуществ:

Приложение Вайбкода обращается к смарт-процессу через Vibe API - метод чтения элементов сущности с фильтрацией. Vibe API автоматически выстраивает запросы в очередь, делает пакетные запросы и соблюдает лимиты портала, поэтому при большом справочнике приложение не получит ошибку 429.

Логика вида «выбрал позицию - автоматически подтянулись сопутствующие работы» описывается данными в связях между элементами смарт-процесса, а не кодом приложения. Это принципиально: менять состав комплекта или добавлять новые связки можно без пересборки приложения.

Подробнее о методах Vibe API и доступных сущностях - в статье Vibe API и бесплатные ИИ-модели BitrixGPT в Вайбкоде.

Как результат возвращается в сделку

После того как менеджер собрал расчёт, приложение выполняет несколько операций через Vibe API:

1. Записывает товарные позиции в сделку. Метод записи товаров сделки принимает массив позиций с ценами, количеством и скидками - те же данные, что менеджер мог бы вносить вручную.
2. Сохраняет файл расчёта. PDF или HTML-файл прикрепляется к карточке сделки - его можно сразу отправить клиенту.
3. Создаёт элемент смарт-процесса с привязкой к сделке. Это история расчётов: каждый вариант цены фиксируется как отдельная карточка, связанная со сделкой. Можно посмотреть все версии и увидеть, что именно менялось.

Vibe API поддерживает пользовательские поля в сделках - итоговая сумма, наценка в процентах или признак «расчёт согласован» могут записываться в произвольные поля карточки, которые потом видны в списке сделок и фильтрах.

Готовый файл расчёта удобно сразу включить в шаблон коммерческого предложения или счёта, не копируя данные вручную.

Мобильные сотрудники и выездные замеры

Задеплоенное приложение автоматически появляется в каталоге приложений портала и доступно в мобильном приложении Битрикс24 - без отдельной установки.

Это принципиально для выездных сотрудников: замерщик или монтажник может открыть карточку сделки на телефоне, внести параметры объекта прямо на месте и получить расчёт. Условие одно: при сборке нужно сразу ставить задачу на адаптивную вёрстку, чтобы интерфейс корректно отображался на маленьком экране.

Если приложение тянет прайс из смарт-процесса через Vibe API, а не из внешнего источника, оно работает надёжно даже при слабом соединении - данные уже внутри портала. Для случаев, когда цены приходят из внешней системы (например, из 1С), нужен запасной путь: кешированный прайс на стороне Вайбкода и понятное поведение при недоступности источника.

Пример отраслевого применения с выездными сотрудниками - в статье Битрикс24 для электромонтажной компании: там схожая задача по расчёту стоимости работ и материалов на объекте.

Что ломается на практике

Честный раздел для тех, кто планирует проект. Типичные проблемы, с которыми сталкиваются при сборке таких приложений:

Мультивалютность без плана. Нельзя складывать суммы в разных валютах и показывать итог в первой попавшейся. Если есть хотя бы один иностранный клиент, мультивалютность продумывают до старта разработки - после переделывать дороже.

Обязательные поля при смене стадии. Модель Вайбкода не видит правила обязательности полей CRM при переводе стадии, если эти правила не отражены в API. Проверки дублируют непосредственно в приложении - иначе менеджер сможет записать расчёт в сделку, не заполнив нужные поля.

Доступ к закупочным ценам. Закупочные цены и наценки видны не всем сотрудникам. Разграничение доступа проектируют до старта: OAuth-ключ с правами конкретной роли, скрытые поля смарт-процесса, отдельные представления для разных групп.

Недоступность внешнего источника цен. Если прайс тянется из 1С или другой внешней системы, нужен запасной путь. При недоступности источника приложение должно либо показывать последний актуальный прайс из кеша, либо явно сигнализировать менеджеру - но не молча показывать нули.

Ключ только для чтения. Если приложение тестируется или передаётся стажёру, стоит выдать ключ только для чтения: запись блокируется на стороне Вайбкода ещё до обращения к Битрикс24. Это защищает данные сделок от случайной перезаписи.

О типичных ошибках при работе с платформой подробнее написано в материале что можно собрать на Битрикс24 Вайбкод.

С чего начать

Минимальный путь к рабочему прототипу:

1. Описать логику расчёта. Зафиксировать: какие позиции, откуда берутся цены, какие правила наценок, что записывается в сделку. Без этого ИИ-агент будет угадывать.
2. Создать структуру смарт-процесса для прайса. Поля, связи, права доступа - это делается штатными инструментами Битрикс24, до написания кода.
3. Получить API-ключ Вайбкода. Ключ авторизации создаёт администратор портала. Для прототипа подойдёт простой API-ключ, для продакшена - OAuth.
4. Собрать приложение через ИИ-агент. Описать задачу агенту, передать документацию Vibe API и структуру смарт-процесса.
5. Задеплоить в галактику. После деплоя приложение автоматически появляется в каталоге портала и доступно через плейсмент в карточке сделки.

По нашему опыту, прототип с базовым расчётом (выбор позиций, наценка, итог, запись в сделку) собирается за несколько часов вайбкодинга. Полноценное приложение с историей расчётов, PDF и мобильной адаптацией - за 1-2 рабочих дня.

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

Если нужна помощь с постановкой задачи, структурой смарт-процессов или разработкой под ключ - напишите на sales@acp-24.ru или позвоните +7 495 414-48-49. АС Проект - платиновый партнёр Битрикс24.

Нужна помощь по вайбкод-приложению? АС Проект - платиновый партнёр Битрикс24: собираем приложения на Вайбкоде, проверяем чужие перед боевым запуском и берём на сопровождение. Состав работ и цены - на странице приложения на вайбкодинге.

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