Шаблоны печати чеков: различия между версиями

Материал из Касса
Перейти к навигации Перейти к поиску
 
(не показано 196 промежуточных версий 2 участников)
Строка 1: Строка 1:
[[Файл:Раздел Шаблоны печати.png|thumb|650px|'''Подраздел Шаблоны печати''']]
__TOC__
'''Печатные формы''' - это механизм редактирования шаблонов, который позволяет централизованно конструировать/редактировать/обновлять печатные формы документов, используемые на РМК кассиром.<br> Шаблоны предназначены для печати на ККТ средствами не фискальной печати.
'''Печатные формы''' - это механизм редактирования шаблонов, который позволяет централизованно конструировать/редактировать/обновлять печатные формы документов, используемые на РМК кассиром.<br> Шаблоны предназначены для печати на ККТ средствами не фискальной печати.


Строка 11: Строка 13:


Также можно будет создавать индивидуальные шаблоны для Фискальных документов:
Также можно будет создавать индивидуальные шаблоны для Фискальных документов:
* Чек прихода
* Чек
* Чек расхода


Для Фискальных документов доступно только редактирование Шапки и Подвала чека.
Для Фискальных документов доступно только редактирование Шапки и Подвала чека.
Строка 27: Строка 28:
Также в подразделе предусмотрена система фильтров для более удобного поиска шаблонов.
Также в подразделе предусмотрена система фильтров для более удобного поиска шаблонов.


= Создание шаблона =
[[Файл:Шаблон печатной формы Чек.png|thumb|650px|'''Шаблон печатной формы для фискальных чеков''']]
[[Файл:Шаблон печати документ списание (Пример).png|thumb|650px|'''Шаблон печатной формы для документов учета''']]


Для создания шаблона совершите следующие действия:
Для создания шаблона совершите следующие действия:
Строка 33: Строка 40:
* Во всплывающем окне:
* Во всплывающем окне:
** Выберите '''Тип документа'''
** Выберите '''Тип документа'''
** Укажите название шаблона
** Укажите название шаблона:
*** Для фискальных документов внесите описание в окна '''Шаблон шапки''' и '''Шаблон подвала'''
*** Для фискальных документов внесите описание в окна '''Шаблон шапки''' и '''Шаблон подвала'''
*** Для документов учета внесите описание в окно '''Шаблон'''
*** Для документов учета внесите описание в окно '''Шаблон'''
** При необходимости добавить изображение нажмите кнопку '''''Добавить''''' и добавьте изображения с вашего компьютера
** При необходимости добавить изображение нажмите кнопку '''''Добавить''''' и добавьте изображения с вашего компьютера
* В правой части экрана будет отображаться окно '''Предварительный просмотр''', для просмотра созданного описания нажмите кнопку [[Файл:Значок Обновить.png]]
* Для завершения создания шаблона нажмите кнопку '''''Сохранить'''''
{{Note|'''''Примечание'''''<br>
* Для удаления шаблона в подразделе '''Шаблоны печати''' установите чекбокс в ячейке шаблона и нажмите кнопку [[Файл:Удаление в Личном кабинете.png]].|800}}
<br clear="all"/>
= Список поддерживаемых касс (Android) =
{| class="wikitable"
|-
! САЛЮТ 12Ф !! АТОЛ !! MSPOS !! НЕВА/ПЕЙМОБ !! ШТРИХ-М !! МЕРКУРИЙ
|-
|
&#9989;Печать изображения<br>
&#9989;Печать шрифтов разного размера<br>
&#9989;Жирный шрифт<br>
&#9989;Курсивный шрифт<br>
&#9989;Подчеркнутый<br>
&#9989;Центрирование<br>
&#9989;Штрихкод<br>
&#9989;QR-code
|
&#10060;Печать изображения<br>
&#9989;Печать шрифтов разного размера<br>
&#10060;Жирный шрифт<br>
&#10060;Курсивный шрифт<br>
&#10060;Подчеркнутый<br>
&#9989;Центрирование<br>
&#9989;Штрихкод<br>
&#9989;QR-code
|
&#9989;Печать изображения (только формат картинки jpg)<br>
&#9989;Печать шрифтов разного размера<br>
&#10060;Жирный шрифт<br>
&#10060;Курсивный шрифт<br>
&#10060;Подчеркнутый<br>
&#9989;Центрирование<br>
&#9989;Штрихкод<br>
&#9989;QR-code
|
&#10060;Печать изображения<br>
&#9989;Печать шрифтов разного размера<br>
&#9989;Жирный шрифт<br>
&#10060;Курсивный шрифт<br>
&#10060;Подчеркнутый<br>
&#9989;Центрирование<br>
&#9989;Штрихкод<br>
&#10060;QR-code
|
&#10060;Печать изображения<br>
&#10060;Печать шрифтов разного размера<br>
&#10060;Жирный шрифт<br>
&#10060;Курсивный шрифт<br>
&#10060;Подчеркнутый<br>
&#9989;Центрирование<br>
&#9989;Штрихкод<br>
&#9989;QR-code
|
&#10060;Печать изображения<br>
&#10060;Печать шрифтов разного размера<br>
&#10060;Жирный шрифт<br>
&#10060;Курсивный шрифт<br>
&#10060;Подчеркнутый<br>
&#9989;Центрирование<br>
&#10060;Штрихкод<br>
&#9989;QR-code
|}
= Список поддерживаемых касс (Desktop) =
{| class="wikitable"
|-
! АТОЛ !! МЕРКУРИЙ !! ШТРИХ-М !! ДРИМКАСС
|-
|
&#10060;Печать изображения<br>
&#9989;Печать шрифтов разного размера<br>
&#10060;Жирный шрифт<br>
&#10060;Курсивный шрифт<br>
&#10060;Подчеркнутый<br>
&#9989;Центрирование<br>
&#9989;Штрихкод<br>
&#9989;QR-code
|
&#10060;Печать изображения<br>
&#10060;Печать шрифтов разного размера<br>
&#10060;Жирный шрифт<br>
&#10060;Курсивный шрифт<br>
&#10060;Подчеркнутый<br>
&#9989;Центрирование<br>
&#9989;Штрихкод<br>
&#10060;QR-code
|
&#10060;Печать изображения<br>
&#10060;Печать шрифтов разного размера<br>
&#10060;Жирный шрифт<br>
&#10060;Курсивный шрифт<br>
&#10060;Подчеркнутый<br>
&#9989;Центрирование<br>
&#9989;Штрихкод<br>
&#9989;QR-code
|
&#10060;Печать изображения<br>
&#10060;Печать шрифтов разного размера<br>
&#10060;Жирный шрифт<br>
&#10060;Курсивный шрифт<br>
&#10060;Подчеркнутый<br>
&#9989;Центрирование<br>
&#9989;Штрихкод<br>
&#9989;QR-code
|}
= Пример создания шаблона =
При создании шаблона печати необходимо использовать следующие параметры:
{| class="wikitable" style="background:#FFF5EE;" 
|+ Параметры для редактирования текста
|-
! Описание !! Параметр
|-
|widht="45%" colspan="2" style="text-align: center; background:#E0FFFF;"  | '''Методы печати данных'''
|-
|Параметр для написания текста.<br>
'''Пример''': text('Строка по центру', 'CENTER')
Возможные значения второго аргумента:
* LEFT
* CENTER
* RIGHT
|style="text-align: center;"|'''text('текст')'''
|-
| Написание текста в одну строчку установите символ между параметрами или между текстом и параметром
'''Пример''': text('Организация:'+ organization.name)
|style="text-align: center;"| '''+'''
|-
| При использовании обычного текста необходимо обозначить его, для этого используйте данный символ.
'''Важно!''':
* Символ необходимо указывать в начале и в конце текста
* При указании параметров данный символ не используется
* Текст указанный без данных символов не будет напечатан в чеке
'''Пример''': text('Организация:',organization.name)
|style="text-align: center;"| '
|-
| Вывод даты/времени. Форматирует строку с датой при помощи формата, заданного выше<br>
'''Пример''': text(formatDate(document.documentDate))
|style="text-align: center;"| '''formatDate(document.documentDate)'''
|-
| Выравнивание текста слева-справа. <br>
'''Пример''':lr('Строка слева', &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'Строка справа')
|style="text-align: center;"| '''lr'''
|-
| Положение изображения на чеке (слева, по центру, справа).<br>
'''Пример''':image('Имя изображения')
Возможные значения второго аргумента:
* LEFT
* CENTER
* RIGHT
Если изображение с данным именем не найдется, то распечатается пустая строка
|style="text-align: center;"| '''image'''
|-
| Штрихкод в формате ean8.
'''Пример''':ean8('12345678', 'CENTER')
Печать штрихкода с заданными ранее выравниванием setAlignment('CENTER')
* LEFT
* CENTER
* RIGHT
|style="text-align: center;"| '''ean8'''
|-
|Штрихкод в формате ean13.
'''Пример''':ean13('1234567891011', 'CENTER')
Печать штрихкода с заданными ранее выравниванием setAlignment('CENTER')
* LEFT
* CENTER
* RIGHT
|style="text-align: center;"|'''ean13'''
|-
|Штрихкод в формате code128.
'''Пример''':code128('123456', 'CENTER')
Печать штрихкода с заданными ранее выравниванием setAlignment('CENTER')
* LEFT
* CENTER
* RIGHT
|style="text-align: center;"|'''code128'''
|-
|Штрихкод в формате qrCode.
'''Пример''':qrCode('12345678', 'CENTER')
Печать штрихкода с заданными ранее выравниванием setAlignment('CENTER')
* LEFT
* CENTER
* RIGHT
|style="text-align: center;"|'''qrCode'''
|-
| Печать пустой строки.
'''Пример''':feed()
|style="text-align: center;"| '''feed'''
|-
| Повторить символ на всю ширину строки
'''Пример''':repeat(_)
|style="text-align: center;"| '''repeat'''
|-
| Печать каждой позиции с новой строки. Для каждой позиции документа, наименование будет печататься на новой строке
|style="text-align: center;"| '''for(let item of items) { }'''
|-
| Форматирует список характеристик номенклатуры, перечисляя их через запятую,<br> если характеристик у товара не предусмотрено или список характеристик пустой, то автоматически ставится прочерк
'''Пример''': for(let item of items) {text(formatFeatures(item.nomenclatureFeatures))}
|style="text-align: center;"| '''formatFeatures(item.nomenclatureFeatures)'''
|-
| Форматирует цену, добавляя знак рубля в конце, отсекая десятые доли копеек.<br> Если цена, переданная как аргумент в данный метод, не установлена у данного товара, то автоматически ставится прочерк <br>
'''Пример''': for(let item of items) {left (formatPrice(item.purchasePrice))}
|style="text-align: center;"| '''formatPrice(item.purchasePrice)'''
|-
| Форматирует единицу измерения<br>
'''Пример''': for(let item of items) {left (formatQuantity(item.quantity, item.unitCode))}
|style="text-align: center;"| '''formatQuantity(item.quantity, item.unitCode)'''
|-
|colspan="2" style="text-align: center; background:#E0FFFF;"| '''Команды для изменения стиля текста'''
|-
| Выравнивание последующего текста.
'''Пример''': setAlignment('CENTER')
Возможные значения второго аргумента (по-умолчанию LEFT):
* LEFT
* CENTER
* RIGHT
|style="text-align: center;"| '''setAlignment('CENTER')'''
|-
| Изменение стиля шрифта.
'''Пример''': setStyle('NORMAL')
Меняет стиль шрифта, по-умолчанию NORMAL, возможные значения:
* 'NORMAL' (обычный)
* 'BOLD' (жирный)
* 'ITALIC' (курсив)
* 'UNDERSCORED' (подчеркнутый)
|style="text-align: center;"| '''setStyle('NORMAL')'''
|-
| Изменение размера текста.
'''Пример''': setSize('MEDIUM')
Меняет размер текста, по-умолчанию MEDIUM, возможные значения:
* 'SMALL'
* 'MEDIUM'
* 'LARGE'
* 'X_LARGE'
|style="text-align: center;"| '''setSize('MEDIUM')'''
|-
| Формат вывода даты.
Задает формат вывода даты (формат по-умолчанию: dd-MM-yyyy).
Перечень форматов <b>[https://date-fns.org/v2.16.1/docs/format Форматы дат]</b>.
|style="text-align: center;"| '''setDateFormat('dd.MM.yyyy')'''
|-
| Сброс стиля текста до исходных значений.
Команда сброса стиля текста до исходных значений (LEFT, NORMAL, MEDIUM, формат даты: dd-MM-yyyy)
|style="text-align: center;"<ref></ref> | '''reset()'''
|}
{| class="wikitable" style="background:#FFF5EE;"
|+ Параметры данных
|-
! Описание !! Параметр
|-
|colspan="2" style="text-align: center; background:#E0FFFF;"| ''Пользователь (сущность user)''
|-
| Имя кассира
|style="text-align: center;"| '''user.firstName'''
|-
| Фамилия кассира
|style="text-align: center;"| '''user.lastName'''
|-
| Отчество кассира
|style="text-align: center;"| '''user.patronymic'''
|-
| Должность продавца
|style="text-align: center;"| '''user.position'''
|-
| ИНН продавца
|style="text-align: center;"| '''user.inn'''
|-
|colspan="2" style="text-align: center; background:#E0FFFF;"| ''Торговый объект (сущность tradeObject)''
|-
| Наименование Торгового объекта
|style="text-align: center;"| '''tradeObject.name'''
|-
| Адрес Торгового объекта/ Место расчетов
|style="text-align: center;"| '''tradeObject.address'''
|-
| КПП Торгового объекта
|style="text-align: center;"| '''tradeObject.kpp'''
|-
|colspan="2" style="text-align: center; background:#E0FFFF;"| ''Организация (сущность organization)''
|-
| Наименование организации
|style="text-align: center;"| '''organization.name'''
|-
| ИНН организации
|style="text-align: center;"| '''organization.inn'''
|-
| КПП организации
|style="text-align: center;"| '''organization.kpp'''
|-
| Адрес организации
|style="text-align: center;"| '''organization.address'''
|-
|colspan="2" style="text-align: center; background:#E0FFFF;"| ''Типы документов(сущность document)''
|-
| Дата создания документа
|style="text-align: center;"| '''document.documentDate'''
|-
| Номер документа
|style="text-align: center;"| '''document.documentNumber'''
|-
| Ф.И.О. Ответственного
|style="text-align: center;"| '''document.responsiblePerson'''
|-
| Комментарий к документу
|style="text-align: center;"| '''document.description'''
|-
|colspan="2" style="text-align: center; background:#E0FFFF;"| ''Позиции документа (сущность items)''  доступ к отдельной позиции только через цикл for(let item of items) { }
|-
| Вывод характеристик позиции
|style="text-align: center;"| '''formatFeatures(item.nomenclatureFeatures)'''
|-
| Наименование позиции
|style="text-align: center;"| '''item.name'''
|-
| Штрихкод
|style="text-align: center;"| '''item.barcode'''
|-
| Артикул
|style="text-align: center;"| '''item.vendorCode'''
|-
| Цена закупки
|style="text-align: center;"| '''formatPrice(item.purchasePrice)'''
|-
| Количество товара
|style="text-align: center;"| '''item.quantity'''
|-
| Сумма позиции
|style="text-align: center;"| '''formatPrice(item.amount)'''
|-
| Сумма позиции для учетных документов
|style="text-align: center;"| '''formatPrice(item.sellingPrice)'''
|-
|colspan="2" style="text-align: center; background:#E0FFFF;"| ''Для документа '''ОПРИХОДОВАНИЕ'''''
|-
| Сумма НДС для акта "Оприходования"
|style="text-align: center;"| '''formatPrice(item.vatAmount)'''
|-
| Название НДС позиции
|style="text-align: center;"| '''item.vat'''
|-
| Итого Сумма закупки по всем товарам
|style="text-align: center;"| '''document.totalPurchaseAmount'''
|-
| Итого Сумма продажи по всем товарам
|style="text-align: center;"| '''document.totalSellingAmount'''
|-
| Информация о контрагенте
|style="text-align: center;"| '''document.contractor.shortName''' - ФИО контрагента<br>
'''document.contractor.inn''' - ИНН контрагента<br>
'''document.contractor.address''' - Адрес контрагента
|-
|colspan="2" style="text-align: center; background:#E0FFFF;"| ''Для документа '''ПЕРЕМЕЩЕНИЕ'''''
|-
| Количество принятого товара (Для акта "Перемещения")
|style="text-align: center;"| '''item.acceptedQuantity'''
|-
| ФИО сотрудника принявшего перемещение товара
|style="text-align: center;"| '''document.acceptedPerson'''
|-
| ТО Отправитель (Для акта "Перемещения")
|style="text-align: center;"| '''tradeObjectFrom.address'''
|-
| ТО Получатель (Для акта "Перемещения")
|style="text-align: center;"| '''tradeObjectTo.address'''
|-
| Итого Сумма закупки по всем товарам
|style="text-align: center;"| '''document.totalPurchaseAmount'''
|-
|colspan="2" style="text-align: center; background:#E0FFFF;"| ''Для документа '''ИНВЕНТАРИЗАЦИЯ'''''
|-
| Остаток товара
|style="text-align: center;"| '''item.accountBalance'''
|-
| Фактический остаток товара