Для получения отчётов по базе данных «Штрих-М: Кассир 5» предусмотрен механизм формирования расширенных отчетов. В стандартной поставке имеются расширенные отчёты, список которых можно дополнить пользовательскими без изменения конфигурации.

Каждый расширенный отчёт может быть сформирован двуми способами:

• Интерактивно
• Автоматически, при снятии Z-отчета.

Независимо от способа формирования, отчёт представляется пользователю на экран, печатается на принтере/ККМ или сохраняется в файл. Способ представления отчёта определяется самим отчётом, например его настройкой.

Инициатором формирования является пользователь. Действие производится из меню супервизора Расширенные отчёты.

Основное назначение данного способа формирования отчёта – регулярное формирование или предоставление данных отчёта (как правило за текущую кассовую смену) вместе с Z-отчётом. Формирование отчёта производится непосредственно перед снятем Z-отчёта в ККМ.

Для интеграции пользовательского расширенного отчёта в систему необходимо выполнить ряд требований:

• отчёт должен быть внешней обработкой, код которой не приводит к ошибкам в контексте конфигурации «Штрих-М: Кассир 5»
• синоним внешней обработки определяет имя расширенного отчёта в списке отчётов
• внешняя обработка помещается в ExtFiles\Reports каталога базы данных
• основная форма обработки реализует API расширенных отчётов.

Основная форма обработки экспортирует следующие функции:

Функция ПолучитьВерсиюПротокола(СтруктураФункций) Экспорт
Процедура ВывестиОтчет(Знач СтрокаНастроек, Знач ККМДляПечати) Экспорт
Процедура НастройкаОтчета(СтрокаНастроек) Экспорт
Процедура НастройкаПечатиПриZОтчете(СтрокаНастроек) Экспорт
Процедура СформироватьОтчетПриСнятииZОтчета(Знач СтрокаНастроек, Знач ККМДляПечати) Экспорт

Функция является обязательной к экспорту. Вызывается для проверки функциональных возможностей расширенного отчета.
Параметр СтруктураФункций.
Тип – Структура. Имеет следующие свойства, определяющие наличие одноименных экспортных функций модуля:
ВывестиОтчет (булево)
НастройкаОтчета (булево)
НастройкаПечатиПриZОтчете (булево)
ПечататьПриZОтчете (булево)
Изменяя значения свойств передаваемой структуры, обработка сообщит кассовому ПО о поддержке функционала.
Возвращаемое значение (число) – 1.

Процедура является обязательной к экспорту, если параметр ВывестиОтчет (структуры СтруктураФункций) был установлен в значение Истина.
Вызов процедуры производится при интерактивном формировании отчёта.
Параметры:
СтрокаНастроек (строка) – Строка сожержащая настройки отчёта, которая была сохранена в базе данных при вызове процедуры НастройкаОтчета().
ККМДляПечати – Строка таблицы значений СписокККМ. Определяет ККМ на котором будет распечатан отчёт в случае его печати на ККМ.

Процедура является обязательной к экспорту, если параметр НастройкаОтчета (структуры СтруктураФункций) был установлен в значение Истина.
Вызов процедуры производится при настройке расширенного отчёта.
Параметры:
СтрокаНастроек (строка) – Строка содержащая настройки отчёта. Обработка представляет свои настройки в виде строки, которая сохраняется кассовым ПО в базе данных после вызова процедуры. Параметром передаётся сохраненное ранее значение или пустая строка.

Процедура является обязательной к экспорту, если параметр НастройкаПечатиПриZОтчете (структуры СтруктураФункций) был установлен в значение Истина.
Вызов процедуры производится при настройке расширенного отчёта.
Параметры:
СтрокаНастроек (строка) – Строка сожержащая настройки отчёта. Обработка представляет свои настройки в виде строки, которая сохраняется кассовым ПО в базе данных после вызова процедуры. Парметром передаеётся сохраненное ранее значение или пустая строка.

Процедура является обязательной к экспорту, если параметр СформироватьОтчетПриСнятииZОтчета (структуры СтруктураФункций) был установлен в значение Истина.
Вызов процедуры производится перед снятием Z-отчёта в ККМ.
Параметры:
СтрокаНастроек (строка) – Строка сожержащая настройки отчёта, которая была сохранена в базе данных при вызове процедуры НастройкаПечатиПриZОтчете.
ККМДляПечати – Строка таблицы значений СписокККМ. Определяет ККМ на котором будет распечатан отчёт в случае его печати на ККМ.