Перейти до основного контенту
Усі колекціїСRM та продажіГенератор документів
Створення та завантаження нового шаблону документа
Створення та завантаження нового шаблону документа

У цій статті ми розкажемо як правильно створити власний шаблон документа та як додати його в свій робочий Простір для використання в CRM

Uspacy Support Team avatar
Автор: Uspacy Support Team
Оновлено понад 4 міс. тому

Щоб працювати з документами в CRM і легко генерувати їх, потрібно мати в системі свої шаблони.

Але спершу їх потрібно створити та завантажити у Простір.

🌟Зробити це може лише адміністратор або суперадміністратор Простору.

Але про все по черзі ⬇️

Як створити власний шаблон?

На своєму персональному комп’ютері скористайтеся програмою для роботи з текстовими файлами. Це може бути MS Word, LibreOffice тощо.

І створити потрібний вам тип документу.

💡Ми додали в систему шаблон, який ви можете скачати та, спираючись на його оформлення, створити свої власні. Знайти цей прикладовий шаблон можна у вікні завантаження.

Це може бути рахунок, договір купівлі-продажу, доручення, якісь акти тощо. У нашому прикладі для статті – це документ, що підтверджує відвантаження товару.

У процесі формування шаблону в тексті виділяйте інформацію, яка повинна підтягнутися з системи. Тобто в деяких місцях документу повинні містити ті дані, які є в полях картки елемента сутності.

❗️Шаблони створюються для кожної із сутностей. Тобто окремо для угод, лідів, контактів або компаній.

Коли ви сформуєте потрібний текст шаблону та визначите ті дані, які мають підтягуватися в документ із полів картки елемента, потрібно замінити їх символьным кодом. Саме це забезпечить успішний процес генерації.

Де знайти символьний код?

Для кожного поля кожної сутності у системі формується спеціальний код. Знайти його можна перейшовши до Налаштувань розділів та у вкладці Документи розкрити блок Поля для шаблонів документів.

І там ви побачите список назв всіх полів у CRM і символьні коди, які їм кореспондують.

Для зручності можна відфільтрувати поля відповідно до сутності, для якої вони характерні.

Свої символьні коди мають як стандартні поля в CRM, так і користувацькі. Відповідно у згенерований документ ви можете підтягнути будь-яку потрібну вам інформацію, що міститься в картці елемента сутності.

🔍 Детальніше про роботу з користувацькими полями можна прочитати в окремій статті.

Отже, виберіть потрібне поле та скопіюйте його символьний код.

І вставте у потрібне місце вашого шаблону.

Відповідно аналогічні дії потрібно зробити з кожним полем, дані з якого повинні бути підтягнуті в згенерований документ.

💡Зверніть увагу, що символьні коди мають зв’язок із сутністю. Що це означає?

Наприклад, ви формуєте шаблон і плануєте використовувати його в угодах. Але окрім символьних кодів полів, які характерні саме угодам, додасте ще й з контактів. То при генерації документа з картки угоди, дані з полів контакту не будуть підтягнуті. Навіть, якщо там вставлені правильні символьні коди.

Тому це потрібно враховувати при формуванні шаблону. Найпростіший варіант, коли у файлі використовуються символьні коди лише для однієї сутності плюс символьні коди, що відносяться до документа (${DocumentName}, ${DocumentId}, ${DocumentDate}, ${DocumentNumber}).


💡Якщо потрібно, щоб у згенерований документ підтягувалися продукти (та їх характеристики, такі як назва, ціна, знижки тощо), які прикріплені до угоди, то в шаблон необхідно додавати символьні коди, що відповідають за це.

❗️Зверніть увагу, якщо у списку ви не бачите поля, які характеризують продукти, й не можете знайти їх через пошук, то спершу «активуйте» продукти у картці будь-якої угоди. Тобто просто перейдіть у цю вкладку.

Наприклад, в шаблоні це можна оформити у вигляді таблиці. Достатньо створити перший ряд – шапку. У ній прописати характеристики продукту (товару/послуги). Та ще один рядок, у колонки якого розмістити коди полів, які їм кореспондують.

І якщо до угоди прикріплено декілька товарів, то у згенерований документ автоматично будуть підтягнуті всі вони.

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

${ProductsIndex}

${ProductsPreviewImage}

${ProductsProductName}

${ProductsProductQuantity}

${ProductsProductMeasureName}

${ProductsProductPriceRaw}

${ProductsProductDiscountRate}

${ProductsProductDiscountSum}

${ProductsProductTaxRate}

${ProductsProductTaxAmount}

${ProductsProductTaxIncluded}

${ProductsProductPriceRawSum}

Інші поля для продуктів та їх символьні коди стосуються ВСІХ доданих до угоди продуктів. Тому для правильного відображення інформації вони повинні бути розміщені поза рядками, що характеризують окремий продукт. Такими полями є:

${TotalRaw}

${TotalDiscountAmount}

${TaxesTaxValue}

${TotalAmountBeforeTax}

${TotalSum}

${TotalProductsCount}

☝🏻 Знайти та скачати прикладовий шаблон рахунку можна тут.


💡Якщо потрібно щоб, у документі, ціна продуктів, загальна їх вартість чи сума угоди тощо (тобто будь-яке поле типу Гроші) була прописана словесним виразом, то до символьного коду потрібно додати частинку ~words .

Розглянемо на прикладі поля Сума угоди. Щоб відобразити у документі словесний варіант, у шаблоні потрібно прописати символьний код наступним чином:

Сума угоди: ${DealsAmountOfTheDeal~words}

☝🏻 Копійки завжди будуть у вигляді числа. Якщо вони не зазначені, то все одно пропишуться як «00 копійок».

А якщо потрібно і в числовому і в словесному варіанті, то можна прописати так:

Сума угоди: ${DealsAmountOfTheDeal} (${DealsAmountOfTheDeal~words})


Отже, коли все готово, просто збережіть свій шаблон у форматі *.docx і можна переходити до наступного кроку.

Як завантажити шаблон у Простір?

Зробити це можна декількома способами. Перший – на сторінці Налаштування розділів, у вкладці Документи, у блоці Шаблони документів. Потрібно лише натиснути на кнопку Новий шаблон.

Другий – у картці елемента потрібної вам сутності. У вкладці Документи, натисніть на кнопку Новий шаблон.

🌟Працювати з генератором документів і завантажувати власні шаблони можна на всіх тарифних планах. Єдиною відмінністю є їх кількість.

  • Тариф Безкоштовний передбачає 1 шаблон.

  • Стандартний – 5.

  • Професійний – необмежено.

Незважаючи на спосіб, який ви виберете, відкриється форма завантаження. Скористайтеся кнопкою Виберіть файл, щоб додати шаблон у систему.

💡Перевірте ще раз, що ваш шаблон відповідає потрібному формату *.docx.

Після цього файл буде завантажений у систему. Відкриється, у якій можна задати стартові параметри для шаблону.

Тому спершу визначтеся з назвою, вона автоматично підтягнеться з файлу. Але її, звісно, можна змінити. А також визначтеся з активністю. Якщо ви хочете, щоб шаблон можна було використовувати в CRM, то галочка повинна стояти.

Далі виберіть, для якої сутності (сутностей) буде доступний шаблон.

☝🏻Зверніть увагу, що для угод можна налаштувати використання шаблону лише в потрібних воронках.

А якщо ви завантажуєте шаблон з картки елемента, то параметр Прив’язка до розділів CRM буде автоматично заповнений значенням тієї сутності, з якою працюєте. У випадку, коли це угода, то обов’язково підтягується ще й воронка. Або напрямок, якщо це розумний об’єкт і для нього така можливість передбачена налаштуваннями.

Але звісно, ці автоматичні параметри можна змінити й додатково вказати потрібні сутності. Або напрямки, якщо мова йде про угоди. Чи напрямки, якщо вони активні для створених розумних об’єктів.

І наостанок вкажіть, хто з користувачів Простору буде мати доступ для роботи з шаблоном. Можна одразу вибрати всіх співробітників, або відмічати лише потрібних.

Налаштувати Нумератор для шаблону можна буде трошки пізніше. Слідкуйте за нашими оновленнями 😉

Коли все готово, то залишається натиснути Зберегти.

Після цього шаблон з’явиться у списку.

А також буде доступний для вибору у картках елементів, тих сутностей, з якими пов’язаний.


Тепер шаблон можна використовувати, щоб створювати на його основі документи.

🔍 Детальніше про те як згенерувати документ у CRM можна прочитати в окремій статті.

Шаблон рахунку

Значок вкладення
Ви отримали відповідь на своє запитання?