Карточка, шаблон и готовый файл
Почему в созданном счёте неправильный адрес, хотя менеджер исправил его в CRM? Значение могло остаться в другой карточке, браться из другого поля или относиться к уже созданному документу. Для счёта и договора из сделки Битрикс24 разберём цепочку от реквизитов компании и клиента до итогового файла.
Три места поиска ошибки
Сначала сравнивают исходные данные, соответствие полей шаблона и полученный документ. Это три разных участка. Если адрес неверен в карточке, красивый шаблон лишь аккуратно перенесёт ошибку. Если карточка заполнена правильно, выясняют, какое поле использует код в документе. Если новый файл уже верен, а клиент смотрит прежний, разбирают порядок создания и отправки версий.
Править только PDF неудобно. Следующий документ снова возьмёт прежние сведения, и менеджер повторит ручную корректировку.
Начните поиск с исходного поля: исправление его связи с шаблоном устраняет повторяющуюся причину, тогда как ручная подмена текста в PDF помогает только одному файлу и оставляет ошибку для следующей сделки. В обращении к интегратору указывают карточку, дату создания документа, неверное значение и ожидаемый результат. Полезно приложить обе версии сведений, скрыв данные, которые не нужны для разбора. Специалист показывает, откуда взялся адрес, исправляет источник либо код и получает документ заново обычным действием менеджера. После этого тот же способ испытывают на другом клиенте, чтобы исключить частную подстановку вместо работающей связи.
Техническое заполнение и содержание
Юридический смысл договора и состав реквизитов утверждает компания со своим профильным специалистом. Интегратор отвечает за перенос данных и получение файла по утверждённому образцу. Разделение полезно закрепить в задании. Иначе спор о формулировке договора окажется ошибочно записан в дефекты генерации. Здесь принимается именно техническая работа с шаблоном.
Где возникает подмена значения
Карточка
В исходном поле записаны верные сведения.
Шаблон
Код обращается к нужному полю.
Документ
Новый файл содержит ожидаемое значение.
Шаблон и источник каждого поля
В справке Битрикс24 о собственном шаблоне указан формат docx и максимальный размер 2 МБ. Поля подставляются через символьные коды — обозначения, связанные со сведениями CRM.
Как читать карту соответствий
Коды в документ помещает интегратор. Ему нужна карта: какое значение в документе берётся из какого объекта и поля. «Компания» без уточнения слишком неопределённа. Это может быть собственная организация или компания клиента. Контактное лицо также не равно плательщику. Названия в карте раскрывают эти роли обычными словами.
Код — адрес данных. Если он указывает на неподходящее поле, оформление не заставит систему угадать верный смысл.
Каждый важный реквизит лучше разобрать отдельно: общий ответ «всё берётся из сделки» не объясняет, где менеджеру менять сведения. Если документ получает адрес из реквизитов компании клиента, исправление похожего поля в контакте не изменит подстановку, хотя менеджер увидит правильное значение на экране CRM: карта соответствий нужна именно для того, чтобы сотрудник нашёл исходное поле, которое действительно использует этот шаблон. Интегратор показывает путь значения от исходного поля до файла, а сотрудник, готовящий документы, подтверждает его назначение. Тут же решают, что делать с пустым источником: попросить менеджера заполнить его или пропустить необязательный реквизит без непонятного пробела в договоре.
| Значение в файле | Что уточнить у исполнителя |
|---|---|
| Собственная организация | Как выбираются её реквизиты для этой сделки |
| Покупатель | Используется компания или контакт и почему |
| Адрес | Какой именно адрес связан с полем шаблона |
| Товары | Из какого списка берутся строки и суммы |
| Ответственный | Чьи данные и в какой момент подставляются |
После загрузки шаблона справка предлагает настроить название, права доступа и привязку к разделу. От этих настроек зависит ежедневная работа менеджера с документами. Менеджер находит нужный вариант там, где создаёт документ. Сотрудник без полномочий не получает лишний шаблон по случайной общей настройке. Название позволяет отличить назначение и актуальную версию.
Товары, суммы и длинные названия
Однострочный счёт способен выглядеть безупречно, пока в сделке не появится несколько товаров. Тогда обнаруживаются повтор заголовка, потерянная строка, обрезанное название или итог, который не соответствует видимой таблице.
Проверять состав вместе с арифметикой
В документации Битрикс24 показан код ProductsProductName для названия товара. Табличный блок повторяется по товарам. Заказчику достаточно увидеть, что каждой нужной позиции сделки соответствует строка, а количество, единица измерения и стоимость связаны с той же позицией. Видимый итог сверяют с принятым порядком расчёта. Неясные налоговые или ценовые правила сначала уточняет компания, затем исполнитель переносит их в документ.
Совпавшая сумма может скрывать ошибку. Две разные позиции одинаковой стоимости способны поменяться местами без изменения итога.
В приёмочный набор лучше включить разные названия, количества и единицы: тогда перестановку данных будет видно даже при совпавшем итоге. Повторение одной удобной строки такую ошибку скроет. При сверке проходят весь список от первой позиции до последней, сопоставляя название, количество, единицу измерения и стоимость с конкретным товаром сделки, чтобы строка с правильным названием не скрыла количество соседнего изделия или цену, взятую из другого поля. Затем открывают страницу, на которую продолжается таблица, и смотрят, сохранилась ли связь названий с числами. Полностью читаемое название помогает покупателю понять, за какую позицию выставлена каждая сумма.
Длинное содержание
Нужны длинное название организации, адрес и наименование товара, похожие по длине на рабочие данные. Их не сокращают специально для красивой демонстрации. Макет допускает переносы. Подписи сохраняют связь с реквизитами. Если документ становится длиннее, страницы продолжают читаться последовательно, без отдельного пустого листа перед подписью.
- Количество строк соответствует составу сделки.
- У каждой строки верны название, количество и единица.
- Суммы сверены с исходными значениями и утверждённым расчётом.
- На границе страниц таблица и подписи остаются понятными.
- Пустое необязательное поле не оставляет непонятный код в итоговом файле.
Исправлять переносы уменьшением всего текста неудобно для читателя документа. Предпочтительнее переработать ширины и размещение полей, сохранив читаемость. Если товарных строк действительно много, многостраничный результат естественен. Задача шаблона — корректно продолжить сведения, а не любой ценой уместить сделку на одном листе.
Набор данных для испытания таблицы
Одна строка
Проверка основного состава и итога.
Несколько разных позиций
Сверка связи названия, количества и суммы.
Длинный список
Проверка продолжения на следующей странице.
Реквизиты, подпись и итоговый файл
Подпись и печать могут занимать правильное место в исходном шаблоне, но сместиться в созданном документе после подстановки длинных значений. Поэтому принимать нужно файл с рабочим содержимым.
Форматы результата
Инструкция по документам CRM описывает скачивание в форматах pdf и docx. При отправке по e-mail клиент получает PDF. Эти различия задают набор испытаний: редактируемый исходник и итог для получателя не заменяют друг друга. Если компания использует оба варианта, открывают оба. Для отправки принимают тот формат, который действительно увидит клиент.
Предпросмотр не равен отправленному файлу. Нужен скачанный результат после подстановки данных, включая все страницы.
Я предпочитаю сверять PDF с утверждённым образцом при участии сотрудника, который готовит документы: клиент получит этот файл и будет читать в нём реквизиты, сумму и подписи. Редактируемый документ проверяют отдельно, если компания использует и его. Сотрудник отмечает содержательные расхождения, а исполнитель исправляет подстановки и размещение элементов в шаблоне. После правки документ создают заново, чтобы убедиться в повторяемости результата без ручного редактирования готового PDF.
Какие сведения можно менять
Компания определяет, какие реквизиты берутся автоматически и какие менеджер может корректировать перед отправкой. Излишняя свобода в собственных банковских данных создаёт риск случайного изменения. Полный запрет редактирования любого текста тоже может мешать принятому процессу. Поэтому ограничения назначают по полям и ролям. На сдаче менеджер входит под своей обычной ролью: полномочия администратора скрыли бы часть ограничений.
Графическое изображение подписи не следует описывать как самостоятельное подтверждение юридического статуса документа. Его назначение определяет утверждённый компанией порядок работы. В техническом задании достаточно проверить правильный файл изображения, его положение и отсутствие подмены между собственными организациями. Вопросы подписания выходят за пределы проверки подстановок.
Для испытания выбирают подготовленный пример и скачивают полученный файл, а доступный канал отправки показывают без реального письма клиенту: так компания увидит содержание будущего документа, не создав у покупателя впечатления, что ему выставили новый счёт или направили другую редакцию договора. Если требуется проверять доставку письма, её выделяют в отдельную задачу с согласованным тестовым адресатом.
Повторная генерация после исправления
Исправление реквизита в карточке нужно довести до нового файла, который менеджер сможет отличить от старого. Иначе менеджер может отправить документ, созданный до правки, и решить, что шаблон продолжает ошибаться.
Последовательность повторения
На приёмке сохраняют исходный документ, обновляют исходный реквизит и создают новый файл обычным способом менеджера. Значение сверяют вместе с датой создания: это помогает найти нужный результат среди документов с похожими именами. Если старый файл остаётся доступен, команда выбирает понятный способ обозначить его состояние и отличить от актуального до отправки. Сотрудник показывает это действие самостоятельно: выбор версии по памяти нельзя считать надёжной частью рабочего порядка.
Шаблон меняют отдельно от данных. Обновление макета и исправление адреса — разные причины повторной генерации, хотя обе заканчиваются новым файлом.
Повторное испытание начинают с карточек, на которых выявили дефект, а затем создают документ для другого клиента. Второй пример нужен, чтобы отличить исправленную связь с полем от случайной подстановки одного правильного значения: если разработчик вписал адрес прямо в шаблон, первый клиент получит ожидаемые сведения, однако при следующей сделке та же строка попадёт уже в чужой документ. Менеджер проходит оба примера обычными действиями, без помощи исполнителя при заполнении отдельных реквизитов. Такой результат можно воспроизвести и в следующей сделке.
- После изменения реквизита новый документ получает ожидаемое значение.
- Старую версию можно отличить от актуальной до отправки.
- После обновления шаблона сохраняются права и нужная привязка.
- На другом наборе клиентов поля заполняются без частных ручных исправлений.
Где хранится утверждённая версия
Полезно определить владельца шаблона и место хранения исходника. Тогда новый сотрудник не загружает случайную копию из переписки. Изменение проходит проверку на том же наборе примеров. Команда знает, с какой даты используется вариант. Номер версии можно вести локально в понятном реестре, не усложняя название документа для клиента.
Исправление заканчивается новым результатом
Причина
Уточнить исходное поле или код.
Правка
Исправить данные либо шаблон.
Генерация
Получить новый файл обычным действием менеджера.
Сравнение
Сверить результат и отличить его от прежнего.
Комплект для сдачи шаблонов
На сдаче компании нужны утверждённые образцы, рабочие исходники и набор примеров, по которым можно повторить заполнение. Без этого шаблон превращается в файл, понятный только его автору.
Содержание передачи
В задание по Битрикс24 включают перечень документов, источники реквизитов, правила для пустых полей, роли сотрудников и ожидаемые форматы. Вместе с контрольными PDF и картой полей этот комплект позволяет новому исполнителю понять, какие сведения компания утвердила для каждого документа, откуда они поступают в файл и по каким примерам проверить результат после правки, даже если первоначальный автор шаблона больше не участвует в работе. Компания также указывает сотрудника, который разрешает менять содержание документа. Если новый запрос касается формулировки договора, его согласуют с этим сотрудником; если поле перестало получать верное значение, исправление передают интегратору.
Начните с одного утверждённого счёта. На нём легче согласовать перенос реквизитов и товарных строк, а затем применять тот же порядок приёмки к другим документам.
- Образец утверждён, а технические поля связаны с конкретными источниками CRM.
- Шаблон загружается в допустимом формате и доступен нужным сотрудникам.
- Разные клиенты и товары дают верное заполнение без частных подстановок.
- PDF читается целиком, включая переносы, подписи и итог.
- После изменения данных менеджер получает и выбирает актуальный файл.
Передачу завершает самостоятельное действие сотрудника: он создаёт документ, сверяет его и понимает, где исправлять найденную ошибку. Образцы остаются у компании, поэтому после следующего изменения команда сможет сравнить заполнение без подсказок интегратора. Готовый шаблон пригоден к работе с другими сделками, если их реквизиты попадают в нужные поля и сохраняют читаемое размещение.
Источники и полезные ссылки
Интерфейсы и возможности сервисов могут меняться. Перед настройкой сверяйтесь с актуальной документацией.


