Як створити новий шаблон документа для друку (для адміністраторів)

Розповідаємо, як створювати та налаштовувати шаблони документів для замовлень та доставок
Написано Анастасія Останіна
Оновлено 2 місяці тому

Якщо вам потрібні документи для митниці, кур'єрів, клієнтів, наприклад: товарні чеки, видаткові накладні, інвойси тощо, ви можете створити їх шаблони та друкувати в потрібний момент.

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

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

Перейдіть до «Налаштування» → «Додатково» → «Шаблони документів», де відображатиметься список створених шаблонів.

Щоб додати новий, натисніть «Додати шаблон»:

У вікні, яке відкрилось: 

  1. Назва — введіть зрозумілу для співробітників назву;
  2. Тип шаблону — виберіть «Замовлення», якщо шаблон потрібен тільки для доставок виберіть «Доставки»;
  3. Вставити поле — список усіх доступних змінних, які можна додати в шаблон, вони відповідають полям з замовлення, покупця, компанії.  По кліку відразу додається вибрана змінна поля в код, при генерації документа буде замінена даними з цього поля;
  4. Перегляд PDF — натисніть, щоб переглянути, як виглядатиме готовий документ під час друку;
  5. Попередній перегляд — натисніть, щоб швидко переглянути внесені зміни в код;
  6. Поле для вводу кода — додайте код вашого документа, підтримується html, css та twig

По готовності натисніть кнопку «Зберегти». Створений шаблон з'явиться у списку і стане доступним для друку.

Як внести свої дані в готовий шаблон

Спочатку виберіть та скопіюйте код шаблону з нашої бібліотеки документів. Видаліть весь код з поля вводу і вставте скопійований. 

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

Важливо! Який би ви шаблон не використовували, обов'язково замініть весь текст, підсвічений жовтим на свої дані!

Коли все буде готове, і ви переконаєтеся, що все виводиться правильно, потрібно видалити підсвічування тексту, інакше воно збережеться під час друку.

Для цього знайдіть усі рядки style="background-color: yellow" і видаліть їх:

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

Натисніть «Зберегти», щоб додати шаблон і зберегти усі введені дані.

Як додати свій логотип, підпис та інші зображення в документ

Щоб додати зображення, потрібно мати пряме посилання на файл із розширенням. Перевірте, щоб це посилання відкривало зображення в браузері, наприклад: https://blog.keycrm.app/keycrm/images/keycrm-logo-blue-on-white.png.

Ви можете отримати посилання:

  • Завантаживши логотип у розділі «Налаштування»«Основні» й скопіювавши його через контекстне меню.
  • Розмістивши зображення на своєму сервері чи сайті.
  • Використовуючи фотохостинги, наприклад, postimages.org.
Зверніть увагу! Посилання на зображення з Google Диску не підходять.

Щоб вставити зображення в документ, скористайтеся таким кодом:

<img src="https://blog.keycrm.app/keycrm/images/keycrm-logo-blue-on-white.png" style="width: 200px;">
  • src — посилання на зображення (URL). Тут потрібно вказати шлях до вашого зображення;
  • style — параметр стилю, наприклад, width: 200px; встановлює ширину зображення. Ви можете змінювати значення залежно від ваших потреб.

Якщо потрібно замінити зображення, замініть посилання всередині лапок у src="ваше посилання".

Як додати шаблони документів до служби доставки

Шаблоні створені з типом «Доставки» можна друкувати лише після створення ТТН через KeyCRM

Щоб вони стали доступні потрібно додати їх служби доставки, яку використовуватимете. Для цього:

  1. Перейдіть до налаштувань інтегрованої служби доставки;
  2. Відкрийте вкладку «Документи» та у полі «Шаблони документів» виберіть потрібні.
Шаблони створені з типом «Замовлення» також доступні до вибору.

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

Натисніть «Зберегти», з цього моменту для усіх нових створених ТТН для цієї служби доставки стануть доступні вибрані документи для друку.

Управління шаблонами

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

  1. Увімкнути/вимкнути шаблон, натиснувши на перемикач у колонці «Статус»;
  2. Перейменувати та внести зміни в код, натиснувши на іконку олівця, що відкриє таке саме вікно, як і при створенні шаблону;
  3. Видалити шаблон документа який не використовується, натиснувши на іконку кошика.

Використовуючи готові приклади, доступні змінні та функції twig ви можете налаштувати власні шаблони документів і друкувати їх в процесі роботи.

Теги: документи, шаблони документів, інвойс, рахунок, чек, товарний чек, накладна, видаткова, друк, код документа, код шаблона
Чи була наша стаття корисною?