printПечатные формы

Печатная форма — шаблон, по которому система собирает документ для печати: товарную накладную, счёт, кассовый ордер, акт инвентаризации. В разделе Шаблоны документов хранятся все шаблоны: печатные формы документов, ценники, письма клиентам и информационные страницы интернет-витрины. Здесь их можно поправить под свою компанию или добавить новые.

Добавили шаблон типа «Печатная форма :: Заказ покупателя» — он появился в меню «Печать» каждого заказа.

Откройте Администрирование → Настройки системы, вкладку Прочее и нажмите Настройка печатных форм.

Под заголовками колонок — фильтры: введите часть значения и нажмите Enter. Например, запрос «Заказ» в фильтре Тип оставит шаблоны заказов. Значок карандаша в строке открывает шаблон для изменения, значок корзины — удаляет его.

1. Найдите шаблон в списке и нажмите на значок карандаша.
2. Измените текст и оформление в редакторе — он работает как текстовый редактор: шрифты, таблицы, выравнивание.

1. Не трогайте места подстановки в двойных фигурных скобках, если не хотите убрать эти данные из документа.
2. Нажмите «Сохранить» над редактором.
3. Откройте любой документ этого типа, нажмите «Печать» и проверьте результат.

Кнопка «Источник» в редакторе показывает шаблон в виде HTML-кода. Сложные формы — со множеством таблиц и точным расположением полей — надёжнее править в этом режиме, см. Как править HTML-код шаблона. Какие конструкции можно использовать и где брать имена полей — в разделах Синтаксис шаблона и Переменные по типам документов.

Шаблоны разных типов собираются по-разному, поэтому и возможности у них разные.

Шаблон — это HTML-страница, в которую вставлены конструкции в двойных фигурных скобках. При печати система заменяет их данными документа. Используется шаблонизатор Handlebars.

Если поля с таким именем нет или оно не заполнено, на его месте будет пусто — ошибки не возникнет.

Цикл повторяет фрагмент для каждой строки документа — так строится таблица товаров.

<table>
  <tbody>
    {{#each orders_item}}
    <tr>
      <td>{{index}}</td>
      <td>{{name}}</td>
      <td>{{quantity}} {{okei_name}}</td>
      <td>{{price}}</td>
      <td>{{amount}}</td>
    </tr>
    {{else}}
    <tr><td colspan="5">В заказе нет товаров</td></tr>
    {{/each}}
  </tbody>
</table>

В поступлении, возврате поставщику, перемещении и заказе поставщику порядок строк можно менять прямо на странице печати: над документом есть ссылка Сортировка: Товар.

Пример: строка с адресом доставки печатается, только если адрес указан.

{{#if shipping_address}}
<p>Адрес доставки: {{shipping_address}}</p>
{{/if}}

Шаблон не умеет считать: сложить, умножить или сравнить «больше — меньше» в нём нельзя. Всё нужное уже посчитано в данных документа: суммы и итоги, суммы прописью (поля с окончанием _text или Text), даты в привычном виде (docdate_readable), дата по частям для бланков (docdate_parts.d, docdate_parts.mText, docdate_parts.Y).

{{> barcode data=docnum}}
{{> barcode data=docnum type="qrcode"}}
{{> barcode data="4600000010526" type="ean13" includeText="true"}}

Откройте шаблон на изменение и раскройте под редактором блок «Показать структуру данных документа для автоподстановки». В нём показаны все поля на примере одного из существующих документов этого типа.

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

В печатных формах документов доступны все поля самого документа и общие поля:

Имена полей со строками и основных итогов. Полный список для типа — в блоке структуры данных.

Суммы с набором вариантов записи (amount_data, cash_before_data, cash_data) раскрываются через точку: .money_format — число с копейками, .string_format — прописью, .whole_part и .fraction_part — целая и дробная части отдельно.

В перемещении себестоимость (cogs, amount) видит только сотрудник с правом console.movegoods.showcostprice. Остальным в эти поля подставляется розничная цена.

Кассовые формы печатает касса, данные берутся из открытого чека или смены. Касса находит шаблон по системному имени, поэтому меняйте существующие шаблоны «Товарный чек», «КМ-3» и «КМ-6»: новый шаблон этого типа касса печатать не будет.

В шаблонах типа «EMail» — в тексте и в теме письма — работают эти переменные:

Имя переменной пишите слитно со скобками, без пробелов: {{ first_name }} в письме не сработает.

Редактор показывает шаблон в двух видах: как оформленную страницу и как HTML-код. Сложные формы — со множеством таблиц, циклами и условиями — правят в коде.

1. Откройте шаблон на изменение и нажмите «Источник» — первую кнопку на панели редактора. Вместо страницы появится HTML-код.

1. Внесите правки в код.
2. Нажмите «Источник» ещё раз, чтобы вернуться к оформленной странице. Циклы и условия в ней показаны как текст в фигурных скобках — это нормально.
3. Нажмите «Сохранить» над редактором.
4. Откройте документ этого типа, нажмите «Печать», выберите шаблон и проверьте результат. Чтобы отправить документ на принтер, нажмите «Печатать» над ним.

Что нужно знать о редакторе:

Оформление задаётся обычными средствами HTML и CSS:

Ссылка на раздел находится на вкладке Прочее настроек системы — для неё нужно право console.config.etc.