Коммерческое предложение из анкеты: 9 шагов до своего документа

Ниже пошаговая инструкция: девять шагов, к каждому действию готовый промпт. Копируй их, описывай свои объекты и собирай документ под строительные работы, ремонт, автосервис, клинику, магазин или студию. Я делюсь этим с удовольствием, потому что такой порядок убирает не только ручную вёрстку, но и забытые условия расчёта.

А началось всё с обычной заявки на работы.

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

Самое неприятное начинается не с суммы. Спорный пункт легко забыть. Например, доступ на объект: подтверждён ли он? В каком состоянии основание и кто отвечает за вывоз? А подготовительные работы: включены они в смету или их нужно считать отдельно? Если это не записать отдельно, заказчик может решить, что всё уже входит в итоговую сумму.

Раньше я брала данные из переписки, переносила их в Word или Excel, потом несколько раз пересчитывала смету и снова проверяла документ перед отправкой. Работа вроде бы простая, но внимание уходило на механические действия. Чем больше заявок в сезон, тем выше риск упустить именно условие.

Поэтому я собрала анкету объекта и шаблон коммерческого предложения. Сначала отмечаю, что известно, и отдельно фиксирую допущения. Затем получаю документ, где работы, материалы и неподтверждённые условия находятся в своих разделах.

Что изменилось в моей работе после своего коммерческого предложения?

Я не стала вести в анкете всё подряд. Там только то, что влияет на расчёт:

• что нужно сделать;
• какие материалы нужны;
• в каком состоянии объект;
• есть ли доступ;
• требуется ли вывоз;
• нужны ли подготовительные работы;
• что заказчик подтвердил;
• что осталось допущением.

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

Документ собирается по шаблону. В нём есть разделы для работ, материалов, суммы и условий. Я сначала смотрю на исходные данные, потом на результат. Если что-то не сходится, исправляю правило, а не перепечатываю весь текст.

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

Почему своё коммерческое предложение удобнее готового сервиса?

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

В собственной схеме я сама задаю порядок:

1. сначала получить условия объекта;
2. отметить подтверждённые данные;
3. вынести спорные пункты в допущения;
4. подобрать работы и материалы;
5. собрать сумму;
6. подставить всё в документ;
7. проверить PDF перед отправкой.

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

Есть и ограничение. Своя сборка не появляется без проверки. Её нельзя один раз запустить и забыть. Сначала нужно проверить расчёт на нескольких типах объектов, посмотреть на печатную версию и убедиться, что неподтверждённые условия не превращаются в включённые.

Своё решение не делает смету правильной само по себе. Оно только удерживает порядок, который я заранее задала.

Из чего состоит коммерческое предложение из анкеты?

Сначала появляется анкета объекта. В ней можно хранить такие поля:

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

Цены в примере не заданы, поэтому их нельзя выдумывать. В рабочий прайс я внесу свои значения сама.

Ответ анкеты записывается в таблицу. Сборщик находит код услуги, получает цену, считает строку и передаёт данные в документ. Для чтения и записи значений Google Sheets API предоставляет операции get, update, batchGet, batchUpdate и append (Google for Developers).

Шаблон коммерческого предложения готовится в Google Docs. В тексте заранее ставятся уникальные маркеры:

{{client_name}}
{{object_name}}
{{works_table}}
{{materials_table}}
{{assumptions}}
{{total}}

После получения анкеты создаётся копия шаблона. В ней заменяются маркеры, добавляются работы, материалы и сумма. Потом заполненный документ экспортируется в PDF. Google Drive поддерживает экспорт Google Docs в PDF с типом application/pdf (Google for Developers).

Такой порядок разделяет данные и оформление. Если поменялась цена материала, я обновляю прайс. Если поменялся внешний вид документа, я правлю шаблон. Одно не приходится перепечатывать из-за другого.

Что поставить перед сборкой и сколько это стоит?

Visual Studio Code нужен как рабочая папка проекта. Слева видны файлы, справа открывается их содержимое. Код создаёт помощник по вашему описанию, а вы проверяете, что данные перенеслись верно. Я использую редактор, чтобы видеть, какие документы и настройки созданы, и запускать помощника в одном месте.

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

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

Есть важное ограничение по подписке. Claude Code относится к платным возможностям Claude. Claude Pro включает Claude Code, но подписка не означает безлимитную работу: лимиты Claude и Claude Code общие и считаются в скользящем пятичасовом окне (Anthropic, Claude Help Center).

Для оплаты из России понадобится зарубежный платёжный инструмент. В России официальная доступность Claude на странице поддерживаемых стран не подтверждена, а российские карты могут отклоняться при оплате (Claude Help Center, РБК Компании).

Перед началом проверь, что у тебя есть:

• Visual Studio Code;
• Claude Code;
• аккаунт Google;
• Google Таблицы для анкеты и прайса;
• Google Docs для шаблона;
• Google Drive для копий и PDF;
• папка проекта с понятным названием.

Google Apps Script может работать как веб-приложение. Для этого используется функция doGet(e) или doPost(e), а данные POST-запроса доступны через объект события e (Google for Developers).

Как собрать своё коммерческое предложение шаг за шагом?

1. Опиши задачу словами.

   Создай папку kp-stroika, открой её в Visual Studio Code и попроси помощника сначала разобраться в процессе, а не писать программу.

   Разобрать сборку коммерческого предложенияСкопировать промпт

   У меня небольшая строительная компания. Я сама принимаю заявки, уточняю условия объекта, запрашиваю фотографии или выезд специалиста, собираю перечень работ и материалов, а потом вручную переношу всё в Word или Excel. Хочу получать коммерческое предложение из анкеты объекта и прайса.
   
   В предложении должны быть отдельные разделы для работ, материалов, суммы и допущений расчёта. Отдельно отмечай доступ на объект, состояние основания, вывоз и подготовительные работы. То, что заказчик не подтвердил, нельзя включать в итоговую сумму молча.
   
   Пока не пиши код. Разбери процесс простыми словами: какие данные нужны, какие таблицы и документы понадобятся, из каких частей будет состоять решение и в каком порядке его собирать. Задай вопросы, если информации не хватает. Сохрани разбор в файл plan.md в папке проекта. Если понадобится установить программу или дать доступ к сервису, скажи об этом прямо.

   В ответ помощник должен выдать план и вопросы по процессу. Проверь, что в нём есть объект, работы, материалы, допущения и итоговый документ.

2. Собери анкету объекта.

   Создай лист Анкета в Google Таблицах. Вопросы должны помогать получить условия расчёта, а не превращать заявку в длинную форму.

   Создать структуру анкеты объектаСкопировать промпт

   На основе разбора создай структуру анкеты объекта для строительных и ремонтных работ. Нужны поля: имя или название клиента, описание объекта, перечень работ, материалы, фотографии или ссылка на них, доступ на объект, состояние основания, вывоз, подготовительные работы, дополнительные комментарии и согласие на расчёт.
   
   Раздели поля на две группы: обязательные для предварительного расчёта и уточняемые позже. Добавь отдельный блок «Допущения расчёта». В нём должны появляться все условия, которые заказчик не подтвердил. Не добавляй паспортные данные, платёжные реквизиты и лишнюю переписку.
   
   Покажи итоговую структуру таблицей с колонками «Поле», «Обязательное», «Что проверять», «Куда попадёт в документ». Код пока не пиши.

   Помощник должен показать таблицу полей и правила проверки. Если доступ, основание или вывоз не выделены отдельно, попроси переделать структуру.

3. Добавь прайс материалов.

   В отдельном листе Прайс храни работы и материалы. Для связки используй код, а не только отображаемое название.

   Создать лист прайса для коммерческого предложенияСкопировать промпт

   Создай структуру листа «Прайс» для строительных и ремонтных работ. Колонки: код, тип позиции, название, единица измерения, цена, активна. Тип позиции должен принимать только два значения: работа или материал.
   
   Используй тестовые строки без выдуманных цен:
   wall_prep | работа | Подготовка стен | м2 | пусто | да
   floor_work | работа | Работы с полом | м2 | пусто | да
   material_basic | материал | Материал основной | упаковка | пусто | да
   
   Сборщик должен находить позицию по коду, брать цену из листа и не использовать неактивные строки. Если цена пустая, не подставляй ноль: покажи ошибку и останови расчёт этой строки. Покажи правила проверки прайса и способ добавления новой позиции.

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

4. Раздели факты и допущения.

   Попроси помощника добавить правило, по которому неподтверждённое условие не попадает в итоговую сумму.

   Добавить правило допущенийСкопировать промпт

   Добавь в проект правило расчёта коммерческого предложения.
   
   Сначала проверь условия объекта: доступ, состояние основания, вывоз и подготовительные работы. Для каждого условия храни значение и статус подтверждения. Возможные статусы: подтверждено, не подтверждено, не требуется.
   
   В итоговую сумму разрешено включать только подтверждённые работы, материалы и условия. Всё со статусом «не подтверждено» должно попадать в отдельный раздел «Допущения расчёта» и быть явно подписано в документе. Нельзя молча считать неподтверждённую работу включённой.
   
   При отсутствии обязательного условия покажи предупреждение до создания документа. Сначала опиши, какие файлы и листы изменишь, затем внеси правку.

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

5. Подготовь шаблон документа.

   В Google Docs создай шаблон с уникальными маркерами. Не используй одиночные слова вроде «Цена» или «Клиент»: они могут встретиться в обычном тексте.

   Подготовить шаблон коммерческого предложенияСкопировать промпт

   Создай структуру шаблона коммерческого предложения в Google Docs. В документе должны быть заголовок, данные клиента и объекта, таблица работ, таблица материалов, итоговая сумма, отдельный блок «Допущения расчёта» и примечание о том, что неподтверждённые условия не входят в итоговую сумму.
   
   Используй только уникальные маркеры:
   {{client_name}}
   {{object_name}}
   {{works_table}}
   {{materials_table}}
   {{total}}
   {{assumptions}}
   {{comments}}
   
   Маркеры должны стоять отдельными строками или в отдельных ячейках таблицы. Объясни, куда какой маркер попадёт. Не заполняй постоянный шаблон данными конкретного клиента: для каждой заявки должна создаваться его копия.

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

6. Собери документ из заявки.

   Теперь свяжи анкету, прайс и шаблон. Google Drive API умеет создавать копию файла через files.copy, поэтому постоянный шаблон не нужно заполнять напрямую (Google for Developers).

   Связать анкету, прайс и шаблонСкопировать промпт

   Свяжи данные листа «Анкета», листа «Прайс» и шаблона Google Docs.
   
   Для каждой новой заявки:
   1. прочитай поля анкеты;
   2. найди работы и материалы по стабильным кодам;
   3. проверь цены и активность позиций;
   4. раздели подтверждённые условия и допущения;
   5. создай копию исходного шаблона;
   6. подставь имя клиента, объект, таблицу работ, таблицу материалов, сумму и допущения;
   7. сохрани заполненный документ в отдельной папке Google Drive;
   8. запиши ссылку на документ и статус обработки в таблицу.
   
   Исходный шаблон не изменяй. Если обязательного поля или цены нет, не создавай документ с неполным расчётом: запиши понятную ошибку и оставь заявку со статусом «нужна проверка». Перед изменением перечисли файлы, листы и доступы, которые понадобятся.

   Правильный результат - отдельный документ с данными одной заявки, ссылкой в таблице и понятным статусом. Исходный шаблон должен остаться пустым.

   Так выглядит Вайб-кодинг: я не разбираю внутренний код, а проверяю, правильно ли перенеслись условия и сумма.

7. Экспортируй документ в PDF.

   PDF нужен для печати и отправки заказчику. Ссылка на редактируемый документ оставляет возможность случайно поменять расчёт после отправки.

   Экспортировать заполненное КП в PDFСкопировать промпт

   После создания заполненной копии Google Docs экспортируй её в PDF и сохрани рядом с документом в папке Google Drive.
   
   Назови файлы по схеме «КП - клиент - объект». Не меняй исходный шаблон. В таблицу заявки запиши ссылки на заполненный Google Docs и PDF, дату создания и статус. Если экспорт не удался, не ставь статус «готово»: запиши ошибку и оставь заявку для повторной проверки.
   
   Перед завершением проверь, что PDF открывается, содержит работы, материалы, итоговую сумму и отдельный блок допущений.

   Помощник должен создать PDF и записать ссылку. Открой файл, распечатай тестовую страницу и посмотри на переносы таблиц, обрезанные строки и разрывы страниц.

   [!warning] Не проверяй только сумму Документ может иметь правильный итог и при этом потерять строку материала или перенести допущение на следующую страницу. Перед отправкой смотри весь PDF и его печатную версию.

8. Добавь запуск после анкеты.

   Для первого варианта можно запускать сборку вручную из таблицы. Позже помощник добавит приём заявок с сайта, когда сайт сам отправляет заявку боту, или очередь. Google Apps Script поддерживает запуск веб-приложения через doPost(e), а триггеры позволяют обрабатывать очередь с заданным интервалом (Google for Developers).

   Добавить обработку новой анкетыСкопировать промпт

   Добавь обработку новой строки листа «Анкета».
   
   Для новой строки сначала запиши статус «принято». Затем проверь обязательные поля, найди работы и материалы в листе «Прайс», создай копию шаблона, подставь данные, экспортируй PDF и запиши ссылки на документ и PDF.
   
   Если произошла ошибка, запиши статус «ошибка», этап сбоя и понятное описание. Не создавай вторую копию при повторном запуске той же заявки. Для каждой заявки используй постоянный request_id и журнал попыток.
   
   Не делай массовую рассылку. Сначала собери ручной запуск для одной тестовой строки и объясни, как проверить результат.

   Сначала проверь одну строку. Только после этого подключай автоматический запуск. Для небольшого дела разумнее сначала увидеть весь путь от анкеты до PDF, а потом добавлять webhook.

9. Проверь на разных условиях.

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

   Проверить сборку коммерческого предложенияСкопировать промпт

   Проведи проверку на тестовых заявках в листе «Анкета».
   
   Проверь четыре случая:
   1. все условия объекта подтверждены;
   2. вывоз не подтверждён;
   3. у материала нет цены;
   4. обязательное поле объекта пустое.
   
   Для каждого случая покажи ожидаемый статус, состав итоговой суммы, содержимое блока «Допущения расчёта», наличие копии Google Docs и PDF. Не исправляй ошибки молча. Составь список найденных проблем простыми словами и предложи правку только после моего подтверждения.

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

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

Что появится в папке после сборки?

Обычно схема выглядит так:

kp-stroika/
  plan.md
  настройки проекта
  журнал ошибок
  правила проверки

В Google Drive лежат:

Шаблон КП
  ↓ копия для клиента
Заполненный документ
  ↓ экспорт
PDF для печати

Исходный шаблон нужен как чистая форма. В нём не должны оставаться имя клиента, объект, старая сумма или прошлые допущения. Каждая новая заявка получает собственную копию.

Заполненный Google Docs нужен для проверки и дальнейшего редактирования, если заказчик попросил уточнение. PDF нужен как зафиксированная версия для печати и отправки.

В таблице заявок можно хранить:

Не удаляй журнал ошибок после удачного запуска. По нему видно, на каком этапе остановилась обработка. В служебные файлы тоже не нужно лезть без причины. Если расчёт неверный, сначала проверь данные анкеты и прайс, потом попроси помощника объяснить, где находится правило.

Что делать, если сумма или PDF собираются неправильно?

1. Останови повторную отправку. Если после таймаута клиент получил два одинаковых PDF, не нажимай запуск ещё раз.

Одна заявка на коммерческое предложение могла обработаться повторно после таймаута. Проверь журнал по request_id, количество созданных документов, PDF и отправок. Не создавай новые файлы. Определи, на каком этапе повторилась операция, и предложи защиту от дублей через постоянный request_id, статус заявки и журнал попыток. Покажи, какие строки и функции нужно изменить.

Повторная доставка не доказывает, что первая отправка не произошла. Этот сбой описан в обсуждении python-telegram-bot (обсуждение python-telegram-bot).

2. Проверь повторную доставку заявки с сайта. Если одна анкета дважды появилась в таблице, проверь update_id или message_id.

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

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

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

Сборка коммерческого предложения работает на тестовых строках, но на реальном прайсе и PDF завершается по таймауту. Измерь длительность этапов: чтение анкеты, чтение прайса, расчёт, создание Google Docs, экспорт PDF и отправка. Не переписывай всё сразу. Предложи разделить процесс на статусы «принято», «расчёт», «документ», «PDF», «готово» и показать, какие операции можно вынести в отдельный запуск.

Лимит одного запуска Apps Script составляет шесть минут. Документация Google рекомендует читать таблицу одним массивом, а не обращаться к ней на каждой строке (Google for Developers, Q&A на Хабре).

4. Укороти рабочий диапазон. Если таблица стала медленной, проверь пустые строки, формулы и лишнее форматирование.

Лист «Анкета» стал медленно читаться. Проверь количество заполненных строк, максимальное число строк, формулы и форматирование в пустом хвосте. Используй рабочий диапазон до последней заполненной строки, а не весь лист. Не удаляй данные и не меняй архив. Сначала покажи отчёт с причиной замедления и безопасным способом исправления.

Большой пустой хвост может замедлить даже чтение пакетным запросом. Старые заявки лучше переносить в архив, а оперативный лист держать коротким.

5. Обнови авторизацию. Если Sheets или Drive перестали отвечать, хотя сам сценарий запускается, проблема может быть в OAuth.

Сценарий запускается, но доступ к Google Sheets или Google Drive перестал работать. Проверь статус авторизации, режим OAuth-приложения и наличие refresh token. Не вставляй токены в код и не выводи их в журнал. Добавь понятное сообщение владельцу, если доступ истёк, и не ставь заявке статус «готово» при ошибке авторизации.

Тестовый режим OAuth может привести к остановке интеграции примерно через семь дней. Этот симптом описан в issue Activepieces (GitHub).

6. Убери двойной триггер. Если одно изменение создаёт два документа, проверь список триггеров проекта.

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

Два одинаковых триггера могут дать две записи, два PDF или два сообщения. Оставляй один способ запуска и проверку заявки перед созданием копии (Google for Developers).

Последний сбой особенно неприятен: повторную доставку заявки с сайта нельзя надёжно исправить одной визуальной проверкой PDF. Оба файла могут выглядеть одинаково, а в журнале останется две обработки одной заявки. Поэтому request_id, статус и журнал попыток нужны уже в первой рабочей версии.

Сколько стоит своё решение против сервиса и подрядчика?

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

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

Бесплатный тариф сервиса может подойти для знакомства, но его ограничения нужно смотреть отдельно перед запуском. Нельзя сравнивать только слово «бесплатно»: важны лимиты на документы, пользователей, автоматические действия и экспорт.

Стоимость Claude Pro считается в долларах. Anthropic указывает $20 в месяц, а рублёвый пересчёт на конкретную дату не включает комиссии посредника и расходы на зарубежную карту (Anthropic, Банк России).

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

Что сделать сегодня, если я не разбираюсь в технологиях?

1. Обезличь тестовую заявку. Удали паспортные данные, платёжные реквизиты и лишнюю переписку.
2. Выпиши условия объекта. Отдельно укажи доступ, основание, вывоз и подготовительные работы.
3. Сделай простой прайс. Для каждой работы и материала задай код, единицу, цену и активность.
4. Подготовь шаблон. Оставь отдельные места для работ, материалов, суммы и допущений.
5. Проверь согласия. Согласие на расчёт не объединяй с согласием на рекламу.
6. Собери одну копию. Не подключай массовую обработку, пока не проверишь один PDF.
7. Напечатай документ. Посмотри разрывы страниц, таблицы, подписи и блок допущений.

Согласие на обработку персональных данных должно быть конкретным, предметным, информированным, сознательным и однозначным. Так сформулировано в статье 9 закона № 152-ФЗ (КонсультантПлюс).

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

В практикуме эту сборку повторяют руками на собственной задаче. Там можно пройти путь от своей рутины до работающего документа и сразу разобраться с проверкой, а не просто посмотреть на готовый пример.

Вопросы и ответы

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