Торговый зал 6.0» (Ole Automation Server)

OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
«Торговый зал 6.0» (Ole Automation Server)
Программный Продукт предназначен как для конечного пользователя так и для
разработчиков торговых систем под Windows32.
Задачей Программного продукта является помощь разработчикам ПО в создании не
дорогих торговых комплексов на базе разнородного контрольно-кассовых машин (ККМ),
связанных с компьютером в режиме online с одной стороны и с другой стороны внедрения
готового не дорогого решения автоматизации розничной торговли для конечного пользователя.
Катран «Торговый Зал 6.0» выступает как единый кассовый сервер для множество ККМ:
 АМС 100 Ф
 АМС 200 Ф
 Меркурий 112 Ф
 Меркурий 140 Ф
 Рада Ф
 Карат 1500 Дмф
 Штрих 850 Ф
 Штрих 2000 Ф
 Элвес 01/03 Ф
 Элвес Mini Ф
 Орант 121Ф
 Елка МБ82Ф
 Samsung 250 (ПТС 250)
 Samsung 4615(ПТС 4615)
 Эмулятор ККМ специально для разработчиков ПО.
«Торговый Зал 6.0» предназначен для оперативного учета продаж в торговых залах
торгового предприятия или холдинга, на базе сети выше перечисленных ККМ с одной стороны и
для стандартизированной передачи этих данных независимо от типа ККМ в управляющее
приложение в режиме OnLine с другой стороны.
Установка компьютерно - кассового комплекса позволяет:
ù Существенно упростить процедуру учёта товара в торговом зале;
ù Контролировать работу персонала, более четко производить расчет с поставщиками по факту
реализации товара.
ù Осуществлять оптимизацию затрат при формировании ассортимента;
ù Оперативно отслеживать остаток любого товара в торговом зале для его переоценки;
ù Формировать отчёты по продажам товара из торгового зала за любой период времени.
«Торговый зал 6.0» не ведет торгового учета в полной мере: нет учета поставок товаров,
различных поставщиков, многовалютного анализа, складских перемещений и т.д. «Торговый зал
6.0» ориентирован на работу в комплексе с программами «верхнего уровня», осуществляющими
полный торговый учет (1С:Торговля, Бэст, Парус, Фолио и т.д.). На рисунке приведен возможный
вариант построения систем автоматизации торговой деятельности. С точки зрения удешевления
решения в комплексе «Торговый зал 6.0» можно совместить с рабочим местом в сети.
Функциональные возможности программы «Торговый зал 6.0»
Торговый зал представляет пользователю следующие возможности:
ù Ведение справочников товаров, динамически отражающего остатки товаров в результате
продаж;
ù Возможность добавления, изменения, удаления и поиска информации в справочнике товаров;
ù Печать справочника товаров;
ù Возможность загрузки (выгрузки) справочника из внешних текстовых файлов;
ù Просмотр пробитых чеков и их структуры;
1
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
Анализ продаж товаров и пробитых сумм;
Печать данных о продажах;
Выгрузка данных о продажах во внешний текстовый файл;
Настройка ККМ (серийный номер и комментарий) для дальнейшего учета продаж через
конкретные кассы;
ù Настройка справочников и привязка к ним ККМ.
ù Разграничение доступа к данным - настройка паролей Администратора (может производить
удаления и редактирование) и Пользователя (только просмотр и анализ данных без
возможности изменения).
ù Богатый набор OLE функцией для загрузка и выгрузка всех имеющихся данных, а также для
настройки системы.
ù
ù
ù
ù
рис 1.
Описание пользовательского интерфейса программы «Торговый зал 6.0»
В отличии от предыдущих версий, «Торговый зал 6.0» представляет собой однооконное
Windows приложение , которое в зависимости от выбранного режима отображает определенную
информацию и представляет определенные возможности. «Торговый зал 6.0» работает в
следующих режимах: «Справочник товаров», «Список чеков», «Анализ продаж» , «Настройка
ККМ», «Настройка Справочников». Все экранные элементы оснащены всплывающей подсказкой,
которая появляется при задержке курсора мыши над элементов и дублируется в информационной
строке . Номер текущей позиции в списке (товаров, чеков, касс) и общее количество элементов
списка отображаются в статусной строке . Для удобства, при закрытии программы положение окна
на экране, режимы работы со справочниками, ширина столбцов списков сохраняются, т.е.
пользователь в следующий раз начнет работать с предыдущими, установленными им же
параметрами. При минимизации окна программы «иконка» «Торгового зала» помещается не на
панель задач Windows 95, а правее, рядом с часами и т.е. не занимает место на экране.
Переключение режимов окна и настройка программы
происходит при помощи главной панели инструментов , которая
выполняет следующие команды:
2
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
Переключение в окно «Справочник товаров» (Alt+1)
Переключение в окно «Список чеков» (Alt+2)
Переключение в окно «Анализ продаж» (Alt+3)
Переключение в окно «Настройка ККМ»
Вызов окна настройки программы
Настройка справочников
Отображение информации о программе
Выход (Alt+X)
Справочник товаров
"Торговый Зал 6.0" позволяет вести несколько справочников товаров. При настройке
кассовых каналов (см. Настройка касс) пользователь установит для каждой ККМ справочник
товаров, с которым будет вестись работа.
Окно "Справочник товаров" предназначено для ведения базы данных по товарам,
пробиваемым на ККМ. При помощи панели инструментов и меню пользователь может
переключаться между справочниками товаров, добавлять, удалить товары, очистить, распечатать,
выгрузить и загрузить справочник. Редактирование возможно только при отключенном контроле
доступа или при работе под паролем администратора.
Команды редактирования
Справочник
Выбор справочника товаров
Добавить
Добавление нового товара. При этом уникальный код генерируется
автоматически а остальные поля устанавливаются в значения по
умолчанию (см. Настройка. Справочник)
Удалить
Удаление выделенного товара. При удалении товара возможно
не отображение наименований данных в списках чеков и продаж
Очистить
Удаление всех товаров (см. удаление товара)
Печать
Печать справочника
Выгрузка
Выгрузка справочника в текстовый файл (см. Выгрузка
справочника)
Загрузка
Загрузка справочника из текстового файла (см. Загрузка
справочника)
Режим обучения
Переключение режима обработки запроса товара с ККМ по штрих
коду. При включенном режиме в ККМ посылается ответ "Товар не
найден", а в справочник добавляется новый товар и ему
присваивается полученный из ККМ штрих код
Отображаемые поля
Настройка списка данных (см. Настройка вида списка)
Команды сортировки и поиска
Поле сортировки
Устанавливает порядок сортировки списка товаров и поле, по
которому происходит поиск. Сортировку списка можно также
установить, нажав мышью на заголовок колонки с треугольником в
левой части.
Направление сортировки Устанавливает порядок сортировки списка товаров по убыванию
или
по возрастанию
Поиск
При наборе текста в поле, происходит поиск ближайшего значения
в списке по значению поля сортировки
Каждый элемент базы данных обладает следующими свойствами:
3
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
Код
Уникальный код в пределах справочника, однозначно
идентифицирующий товар
Штрих код
Штрих код товара (фабричный или назначенный самостоятельно),
также должен быть уникальным. Один товар может иметь
несколько Штрих кодов. В поле они вводятся через запятую.
Наименование
Наименование товара для печати на чековой ленте (не на всех типах
ККМ)
Количество
Остаток товара
Минимальное количество Количество, при достижении которого программа сигнализирует о
нехватке товара
Цена
Цена товара для пробивки на ККМ
Секция
Товарная секция
Нал. группа
Налоговая группа товара
Весовой
Признак весового товара. Если не установлен, то невозможно
побить
дробное количество
Наличие всех этих полей может быть настроен пользователем как для визуализации, так и для
печати.( см. Настройка вида списка)
Список чеков
Окно "Список чеков" показывает работу ККМ в реальном режиме времени. Здесь
отображаются чеки, пробитые на ККМ. Пользователь может переключаться между ККМ, удалить
все чеки выбранной ККМ или очистить все чековые данные. Редактирование возможно только при
отключенном контроле доступа или при работе под паролем администратора.
Команды редактирования
Выбор ККМ
Справочник
Позволяет выбрать ККМ для наблюдения за работой
Отображает справочник товаров, связанный с
выбранным кассовым каналом
Удалить
Удаляет выбранный чек. При удалении чека его
данные не попадут в аналитический список продаж
Закрыть чек
Доступна если выбранный чек открыт и не являлется
Очистить список чеков
Удаление всех чеков выбранной кассы (см. Удалить)
текущим чеком, пробиваемым на ККМ
Печать
Печать списка чеков
Отображаемые поля чеков
Настройка списка чеков (см. Настройка вида списка)
Отображаемые поля позиции чека
Настройка списка позиций чека (см. Настройка вида
списка)
Надо отметить, что если до закрытия чека было отключено питание на ККМ чек остается
открытым. Пользователь с учетом особенности ККМ должен или Удалить или Закрыть данный
чек через программу.
Список продаж
Окно "Список продаж" показывает суммарную информацию о продажах, сгруппированную по
наименованию и ценам товаров. Здесь отображаются количество проданного товара, цена
продажи, общая сумма продаж товара, общая сумма скидок (надбавок) на этот товар. В нижней
части окна показываются общие суммы: сумма продаж товаров, сумма "свободных сумм" и сумма
возвратов товаров. Пользователь может установить фильтр отбора данных по ККМ, секции,
налоговой группе и периоду времени. Для установления периода по умолчанию определены
следующие фильтры: за сегодняшний день, за последнюю неделю (от понедельника до текущего
4
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
дня недели), за последний месяц (от 1 -го числа до сегодняшнего) и за весь период времени.
Отобранные данные могут быть выгружены в текстовый файл или распечатаны.
Команды редактирования
Обновить
Обновить список данных. Команда становится доступной при
изменении в чековых данных (продажа с ККМ, удаление /
добавление товаров и т.п.)
Выбор ККМ
Устанавливает фильтр отбора данных по всем ККМ или конкретно
выбранной.
Выбор секции
Устанавливает фильтр отбора данных по всем секциям или
конкретно выбранной
Выбор налоговой группы Устанавливает фильтр отбора данных по всем налоговым группам
или конкретно выбранной
Установка периода
Установка периода отбора данных, заранее определенного или
настраиваемого пользователем
Печать
Печать списка продаж
Выгрузка
Выгрузка определенного списка в текстовый файл (см. Выгрузка
продаж)
Команды сортировки и поиска
Поле сортировки
Устанавливает порядок сортировки списка товаров и поле, по
которому происходит поиск. Сортировку списка можно также
установить, нажав мышью на заголовок колонки с треугольником в
левой части.
Направление сортировки Устанавливает порядок сортировки списка товаров по убыванию
или
по возрастанию
Поиск
При наборе текста в поле, происходит поиск ближайшего значения
в списке.
Настройка параметров
Интерфейс. Эта страница диалога позволяет настраивать внешний вид приложения.
Минимизировать на SystemTray.
При минимизации приложения появляется
значок рядом часами, а не на панели задач
Загружаться в минимизированном
состоянии
При загрузке приложения, оно появляется в
виде значка на панели задач или на
SystemTray (рядом с часами)
Сообщения. Позволяет указать приложению спрашивать ли у пользователя подтверждение на
выполнение каких-либо действий или информировать пользователя о каком-либо событии.
Подтверждение выхода из программы
Выход возможен только после
подтверждения
Подтверждение удаления товара ( чека )
и очистки списков
Если выбран, то при каждом удалении
спрашивется подтверждение
Предупреждение при ошибке загрузки драйвера Выдает сообщение об ошибке, если при
загрузке приложения не был загружен
кассовый драйвер
Предупреждение при ошибке открытия
кассового канала
Выдает сообщение об ошибке при
невозможности открытия кассового канала
Сообщения при ошибках
5
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
выгрузки / загрузки данных
Выдает сообщения об ошибках при операция
выгрузки / загрузки данных через текстовые
файлы
Режимы. Настройка режимов обработки данных, авто сохранения.
Увеличивать кол-во при пробивке
товара (услуги) на кассе
Означает, что при пробивке товара(услуги) на
ККМ, счетчик количества увеличивается
Разрешить отрицательные остатки
Разрешает пробивать товар на ККМ если
даже его остаток в справочнике меньше нуля.
Показывать текущий чек
Если в окне "Список чеков" выбрана ККМ,
пробивающая чек, то этот чек автоматически
будет подсвечен и будет показана его
структура
Авто сохранение данных
Разрешает авто сохранение данных
Интервал авто сохранения, мин
Определяет период авто сохранения данных в
минутах
Доступ. Позволяет включить / отключить контроль доступа. При включенном контроле
доступа приложение работает в двух режимах: "пользователь", когда возможно лишь
наблюдение(все команды редактирования запрещены) и "администратор", когда возможно
редактировать данные. По умолчанию пароль "пользователя" - user, а пароль "администратора" admin.
Разрешить контроль доступа
Включает / отключает контроль доступа
Пароль администратора и его подтверждение
Настройка пароля администратора.
Подтверждение обязательно должно
соответствовать значению пароля
Пароль пользователя и его подтверждение
Настройка пароля пользователя.
Пользователь может настраивать
параметры выгрузки / загрузки
При выгрузке / загрузке данных через
текстовые файлы (см. Выгрузка данных,
Загрузка данных) пользователь имеет
возможность произвести настройку файла,
разделителей и т.д. В противном случае
операция производиться по настройкам,
сделанным ранее администратором.
При разрешенном контроле доступа
приложение загружается не спрашивая
сразу в режиме "пользователя"
Загружаться в режиме пользователя
пароля
Файлы. Предназначена для настройки файлов приложения.
Файл данных
Определяет имя файла в котором
сохраняются данные
Файл ошибок при загрузке
Текстовый
файл,
в
который
будут
помещаться
позиции
не
загруженные при выполнении
Загрузки справочника
Справочник. Предназначена для установки начальных значений при добавлении нового товара
в справочнике товаров.
Настройка касс
Диалог "Настройка касс" предназначен для определения кассовых каналов для связи
компьютера с ККМ. В списке в левой части окна отображаются заведенные кассовые каналы, а
6
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
справа - параметры выделенного канала (Серийный номер ККМ, Наименование ККМ и, если
необходимо, коммуникационный порт для соединения ККМ с компьютером). В зависимости от
схемы подключения ККМ к компьютеру, коммуникационный порт должен быть настроен или для
каждой ККМ (схема "звезда"), или для сети из ККМ ( схема "сеть").
Настройка касс может быть вызвана только при отключенном контроле доступа или при работе
под паролем администратора.
Описание элементов редактирования
Список
Серийный номер
Наименование
Справочник
СОМ - порт (СОМ - порт сети)
Добавить
Удалить
Открыть
Закрыть
Список заведенных ККМ. Если канал неоткрыт, то он
отображается в списке красным цветом
Поле редактирования серийного номера ККМ.
Необходимо для точной идентификации команд от
ККМ.
Комментарий пользователя о ККМ
Справочник товаров, с которым работает ККМ
В случае схемы "звезда" - значение порта для
выделенной ККМ, в случае "сети" - общий
коммуникационный порт для всех ККМ. Если при
изменении значения канал (порт сети) был открыт, то
происходит попытка переоткрыть канал (порт) с
новым параметром.
Добавление новой ККМ. Канал добавляется
закрытым. Т.е. для работы с подключенной ККМ его
необходимо открыть (см. Открыть)
Удаление выделенного канала. При удалении будут
удалены все чековые данные, связанные с этой ККМ.
Команда доступна если выделенный канал неоткрыт
(Если канал только что добавлен или не был открыт
при загрузке программы). Осуществляет попытку
переоткрыть канал.
Выход из диалога настройки
Все изменения, сделанные в "Настройке касс" отражаются сразу же по их совершении, а не при
выходе из окна.
Настройка вида списка
Окно "Настройка списка" позволяет пользователю настроить списки данных для того, чтобы
отображать только необходимую ему информацию в нужном ему порядке. По умолчанию все
списки отображают полный набор полей. Вызов диалога настройка осуществляется двойным
щелчком мыши на списке или выбором в меню пункта "Отображаемые поля ...". В левой части
окна находится список доступных полей, а в правой - список выбранных пользователем в
установленном им порядке. При помощи кнопок редактирования или мыши (drag-and-drop)
пользователь производит настройку.
Описание элементов редактирования
Список всех полей
Добавить поле
Удалить поле
Список доступных полей, за исключением уже
выбранных Список выбранных полей Список
выбранных полей в нужном порядке
Добавляет выбранное поле из списка всех полей в
список отображаемых полей , при этом оно удаляется
из списка всех полей
Возвращает выбранное поле в список всех полей.
Команда успешного завершения настройки ("ОК")
7
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
Добавить все поля
Удалить все поля
Сдвинуть поле вверх
Сдвинуть поле вниз
Добавить пустое поле
при
количество
позиции чека может не совпадать)
будет доступна только при наличии хотя бы одного
поля в списке отображаемых полей
Добавляет все доступные поля к списку
отображаемых полей
Удаляет все отображаемые поля. (см. Удалить поле)
Сдвигает выбранное поле на позицию вверх в списке
отображаемых полей
Сдвигает выбранное поле на позицию вверх в списке
отображаемых полей
Добавляет пустой столбец к списку (Имеет смысл
наст ройке вида списка чеков, когда
столбцов
чека
и
Настройка справочников
Диалог "Настройка справочников" предназначен для определения справочников товаров. В
списке в левой части окна отображаются заведенные справочники, а справа - параметры
выделенного справочника (Уникальный код и Наименование).
Настройка справочников может быть вызвана только при отключенном контроле доступа или
при работе под паролем администратора.
Описание элементов редактирования
Список
Список заведенных справочников.
Серийный номер
Поле редактирования уникального кода справочника.
Наименование
Наименование справочника
Добавить
Добавление нового справочника.
Удалить
Удаление выделенного справочника.
Закрыть
Выход из диалога настройки
Все изменения, сделанные в диалоге отражаются сразу же по их совершении, а не при выходе
из окна.
Список функций и свойств OLE Automation сервера
Имя сервера: 'KATRAN.AutoManager'.
OLE Automation сервер представляет доступ к настройкам приложнния и его данным
через интрерфейс OLE. Вызовы этих команд возможны из любой программы, поддерживающей
механизмы OLE Automation, например из Microsoft Excel или Microsoft Word.
При помощи сервера возможно динамически забирать данные о продажах, изменять параметры
товаров и настройки системы.
function Close: WordBool;
Описание : Отключает драйвер ККМ
Результат: 1 (true) если успешно, иначе - 0 (false)
function Open: WordBool;
Описание : Включает драйвер ККМ если был отключен функцией Close
Результат: 1 (true) если успешно, иначе - 0 (false)
procedure Show(Index: Integer);
Описание : Показывает окно программы
Параметры: Index - режим: 0 - справочник товаров;
1 - список чеков;
8
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
2 - список продаж
procedure Hide;
Описание : Сворачивает окно приложения в икону. В зависимости от настроек
интрефейса (см. Настройка интрфейса) значок программы появляется
или на панели задач Windows, или на SystemTray - рядом с часами
procedure SetupOptions;
Описание : Открывает диалог настроек программы (см. Настройка)
procedure SetupChannels;
Описание : Открывает диалог настроек касс (см. Настройка касс)
procedure SetupComs;
Описание : Открывает диалог настроек справочников (см. Настройка справочников)
function AppendChannel(ACashNo, APort: Integer; AName: WideString): WordBool
Описание : Добавляет кассовый канал
Параметры: ACashNo - Серийный номер ККМ
APort
- Номер СОМ порта (для схемы звезда)
AName
- Наименование добавляемого канала
Результат: 1 (true) если успешно, иначе - 0 (false)
function DeleteChannel(ACashNo: Integer): WordBool;
Описание : Удаляет кассовый канал
Параметры: ACashNo - Серийный номер ККМ
Результат: 1 (true) если успешно, иначе - 0 (false)
function ClearChecks(CashNo: Integer) : WordBool;
Описание : Очищает список чеков для определенного канала
Параметры: ACashNo - Серийный номер ККМ
Результат: 1 (true) если успешно, иначе - 0 (false)
procedure DeleteAllChannels;
Описание: Удаляет все кассовые каналы.
function LinkComs(ACashNo, APartNo: Integer): WordBool;
Описание : Связывет кассовый канал со справочником товаров
Параметры: ACashNo - Серийный номер ККМ
APartNo - Код справочника
Результат: 1 (true) если успешно, иначе - 0 (false)
function GetChannelComs(ACashNo: Integer): Integer;
Описание : Возвращает уникальный код справочника, связанного с выбранным
кассовым каналом
Параметры: ACashNo - Серийный номер ККМ
Результат: -1 если нет канала с сер.номером ACashNo,
-2 если канал не связан со справочником
иначе уникальный код справочника
procedure Clear;
Описание: Удаляет все данные программы (Товары, чеки, данные о кассах)
function AppendComs(APartNo: Integer; AName: WideString): WordBool;
Описание : Добавляет справочник товаров
Параметры: APartNo - Код справочника
AName
- Наименование добавляемого справочника
Результат: 1 (true) если успешно, иначе - 0 (false)
function DeleteComs(APartNo: Integer): WordBool;
Описание : Удаляет справочник товаров
Параметры: APartNo - Код справочника
9
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
Результат: 1 (true) если успешно, иначе - 0 (false)
procedure DeleteAllComs;
Описание: Удаляет все справочники товаров
function AppendCom(APartNo, ACode: Integer; ABarCode: Double; AName: WideString; APrice, ANumber,
AAlarmNum: Double; ASection, ATaxGroup: Integer; AIsReal: WordBool; AReserved: WideString;
ReplaceNumber: WordBool): WordBool;
Описание : Добавляет товар.
Параметры: APartNo
- Код справочника
ACode
- Код товара (если товар с таким кодом уже существует
см. описание ReplaceNumber)
ABarCode
- Штрихкод
AName
- Наименование
APrice
- Цена
ANumber
- Количество
AAlarmNum
- Мин.количестов
ASection
- Секция (для ККМ)
ATaxGroup
- Нал. группа (для ККМ)
AIsReal
- Признак всевого товара: 0 - штучный; 1 - весовой
AReserved
- Дополнительное поле
ReplaceNumber - Eсли товар с кодом ACode уже существует то:
0 (false) - количество суммируется с параметром ANumber;
1 (true) - заменяется на ANumber;
Результат: 1 (true) если успешно, иначе - 0 (false)
function DeleteCom(APartNo, ACode: Integer): WordBool;
Описание : Удаляет товар.
Параметры: APartNo - Код справочника
ACode
- Код товара
Результат: 1 (true) если успешно, иначе - 0 (false)
function AddBarCode(APartNo, ACode: Integer; ABarCode: Double): WordBool;
Описание : Добавляет штрихкод для товара
Параметры: APartNo - Код справочника
ACode
- Код товара, для которго добавляется штрихкод
Результат: 1 (true) если успешно, иначе - 0 (false)
function DelBarCode(APartNo: Integer; ABarCode: Double): WordBool;
Описание : Удаляет штрихкод
Параметры: APartNo - Код справочника
ABarCode - Штрихкод, подлежащий удалению
Результат: 1 (true) если успешно, иначе - 0 (false)
function ClearComs(APartNo: Integer): WordBool;
Описание : Очищает справочник товаров
Параметры: APartNo - Код справочника
Результат: 1 (true) если успешно, иначе - 0 (false)
function GetComs(APartNo: Integer): WordBool;
Описание :
Параметры:
Результат:
Прмечание:
Получает справочник товаров и помещает указатель на первый товар
APartNo - Код справочника
1 (true) если успешно, иначе - 0 (false)
Далее все функции и свойства вида "Com_" работают с полученным
справочником
property Com_EOF: WordBool; readonly;
Описание : Признак конца справочника товаров
function Com_Next: WordBool;
Описание : Переход к следующему товару
function Com_Delete: WordBool;
10
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
Описание : Удаление текущего товара
property Com_Code: Integer; readonly;
Описание : Код товара
property Com_BarCodes: WideString; readonly;
Описание : Список штрихкодов, разделенный ","
property Com_Name: WideString; readonly;
Описание : Наименование
property Com_Section: Integer; readonly;
Описание : Секция (для ККМ)
property Com_TaxGroup: Integer; readonly;
Описание : Нал.группа (для ККМ)
property Com_Price: Double; readonly;
Описание : Цена
property Com_Number: Double; readonly;
Описание : Количество (текущий остаток)
property Com_Reserved: WideString; readonly;
Описание : Дополнительное поле
function FindComByCode(ACode: Integer): WordBool;
Описание :
Параметры:
Результат:
Прмечание:
Ищет товар по коду в справочнике, полученном вызовом GetComs
ACode - Код товара
1 (true) если успешно, иначе - 0 (false)
Если товар найден, то указатель с справочнике устанавливается на него
function GetSels(ACashNo, APartNo, ASection, ATaxGroup, Period: Integer; StartDate, StartTime,
EndDate, EndTime: WideString): WordBool;
Описание : Получает список продаж и помещает указатель на первую позицию. Список
группируется по ценам: т.е. если товар был продан по разным ценам,
то в списке будет несколько позиций с одним кодом
Параметры: ACashNo
- Серийный номер ККМ (если -1 то по всем)
APartNo
- Код справочника (если -1 то по всем, имеет смысл
если ACashNo = -1)
ASection - секция товара (ККМ)
ATaxGroup - нал.группа (ККМ)
Period
- Период опроса:
0 - все
1 - за сегодня
2 - за последнюю неделю (понедельник - сегодняшний день недели)
3 - за последний месяц (1-ое число - сегодняшнее число)
4 - настраиваемый (параметры StartDate, StartTime,
EndDate, EndTime)
StartDate - Начальная дата отбора данных в виде строки ("07.11.1917")
StartTime - Начальное время в виде строки ("12:00")
EndDate
- Конечная дата
EndTime
- Конечное время
Результат: 1 (true) если успешно, иначе - 0 (false)
Прмечание: Далее все функции и свойства вида "Sel_" работают с полученным
списком продаж
property Sel_EOF: WordBool; readonly;
Описание : Признак конца списка продаж
function Sel_Next: WordBool;
Описание : Переход к следующей позици
11
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
property Sel_Code: Integer; readonly;
Описание : Код товара
property Sel_BarCodes: WideString; readonly;
Описание : Список штрихкодов, разделенный ","
property Sel_Name: WideString; readonly;
Описание : Наименование
property Sel_Section: Integer; readonly;
Описание : Секция (для ККМ)
property Sel_TaxGroup: Integer; readonly;
Описание : Нал.группа (для ККМ)
property Sel_Price: Double; readonly;
Описание : Цена
property Sel_Number: Double; readonly;
Описание : Проданное количество
property Sel_RetNumber: Double; readonly;
Описание : Возврашенное количество
property Sel_Sum: Double; readonly;
Описание : Сумма продаж
property Sel_RetSum: Double; readonly;
Описание : Сумма возвратов
property Sel_DecSum: Double; readonly;
Описание : Общая сумма скидок при продажах текущего товара
property Sel_DecPercent: Double; readonly;
Описание : Общий процент скидок при продажах текущего товара
property Sel_IncSum: Double; readonly;
Описание : Общая сумма надбавок при продажах текущего товара
property Sel_IncPercent: Double; readonly;
Описание : Общий процент надбавок при продажах текущего товара
property Sel_All_Sum: Double; readonly;
Описание : Общая сумма продаж по текущему списку
property Sel_All_RetSum: Double; readonly;
Описание : Общая сумма возвратов по текущему списку
property Sel_All_FreeSum: Double; readonly;
Описание : Общая сумма "свободный сумм" по текущему списку
function GetChecks(ACashNo: Integer): WordBool;
Описание : Получает список чеков для определенного канала и устанавливает
указатель на первую позицию
Параметры: ACashNo - Серийный номер ККМ
Результат: 1 (true) если успешно, иначе - 0 (false)
Прмечание: Далее все функции и свойства вида "Check_" работают с полученным
12
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
списком продаж. При каждом переходе между чеками указатель на
позицию чека устанавливается в начало; все функции и свойства
вида "Item_" работают со списком позиций текущего чека
property Check_EOF: WordBool;
Описание : Признак конца списка чеков
function Check_Next: WordBool;
Описание : Переход к следующему чеку.
function Check_Delete: WordBool;
Описание : Удаление текущего чека
property Check_No: Integer; readonly;
Описание : Номер чека
property Check_Date: WideString; readonly;
Описание : Дата чека
property Check_Time: WideString; readonly;
Описание : Время чека
property Check_PayMode: Integer; readonly;
Описание : Вид оплаты
property Check_DecSum: Double; readonly;
Описание : Сумма скидки на чек
property Check_DecPercent: Double; readonly;
Описание : Процент скидки на чек
property Check_IncSum: Double; readonly;
Описание : Сумма надбавки на чек
property Check_IncPercent: Double; readonly;
Описание : Процент надбавки на чек
property Check_Sum: Double; readonly;
Описание : Сумма чека
property Check_IsOpen: WordBool; readonly;
Описание : Состояние чека: 0 (false) - закрыт ("Итог" нажат);
1 (true) - открыт ("Итог" не нажат)
property Check_ItemCount: Integer; readonly;
Описание : Количество позиций в чеке
function FindCheckByNo(ACheckNo: Integer): WordBool;
Описание :
Параметры:
Результат:
Прмечание:
Ищет чек по номеру в списке, полученном вызовом GetChecks
ACheckNo - Номер чека
1 (true) если успешно, иначе - 0 (false)
Если чек найден, то указатель в списке устанавливается на него
function FindCheckByDate(ADate: WideString): WordBool;
Описание :
Параметры:
Результат:
Прмечание:
Ищет первый чек с указанной датой в списке, полученном вызовом GetChecks
ADate - Дата чека
1 (true) если успешно, иначе - 0 (false)
Если чек найден, то указатель в списке устанавливается на него
13
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
property Item_EOF: WordBool; readonly;
Описание : Признак конца списка позиций текущего чека. Все функции и свойства
вида "Item_" работают со списком позиций текущего чека
function Item_Next: WordBool;
Описание : Переход к следующей позиции
property Item_Code: Integer; readonly;
Описание : Код товара
property Item_BarCodes: WideString; readonly;
Описание : Список штрихкодов, разделенный ","
property Item_Name: WideString; readonly;
Описание : Наименование
property Item_Section: Integer; readonly;
Описание : Секция (для ККМ)
property Item_TaxGroup: Integer; readonly;
Описание : Нал.группа (для ККМ)
property Item_Price: Double; readonly;
Описание : Цена
property Item_Number: Double; readonly;
Описание : Проданное количество
property Item_Sum: Double; readonly;
Описание : Сумма продажи
property Item_DecSum: Double; readonly;
Описание : Сумма скидки
property Item_DecPercent: Double; readonly;
Описание : Процент скидки
property Item_IncSum: Double; readonly;
Описание : Сумма надбавки
property Item_IncPercent: Double; readonly;
Описание : Процент надбавки
function Channel_First: WordBool;
Описание : Устанавливает указатель на первую позицию в списке кассовых
каналов
Результат: 1 (true) если успешно, иначе если список пуст - 0 (false)
Прмечание: Далее все функции и свойства вида "Channel_" работают со
списком каналов. При каждом переходе между каналами
устанавливается список чеков для текущего канала
(см. GetChecks).
property Channel_EOF: WordBool; readony;
Описание : Признак конца списка каналов
function Channel_Next: WordBool;
Описание : Переход к следующей позиции
14
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
function Channel_Delete: WordBool;
Описание : Удаление текущего канала
property Channel_CashNo: Integer;
Описание : Серийный номер ККМ
property Channel_Name: WideString;
Описание : Наименование канала
property Channel_Port: Integer;
Описание : Номер СОМ порта (только для схемы "звезда")
property Channel_CheckNo: Integer;
Описание : Последний номер чека (для синхронизации чековой
ленты со списком чеков)
property Channel_PartNo: Integer;
Описание : Код справочника, связанного с каналом.
-1 если не определен
function FindChannelByCashNo(ACashNo:Integer): WordBool;
Описание :
Параметры:
Результат:
Прмечание:
Ищет канал по сер.номеру
ACashNo - Сер.номер ККМ
1 (true) если успешно, иначе - 0 (false)
Если канал найден, то указатель в списке устанавливается на
него, устанавливается список чеков для найденного канала
(см. GetChecks).
function Coms_First: WordBool;
Описание : Устанавливает указатель на первую позицию в списке
справочников
Результат: 1 (true) если успешно, иначе если список пуст - 0 (false)
Прмечание: Далее все функции и свойства вида "Coms_" работают со
списком справочников. При каждом переходе между справочниками
устанавливается список товаров для текущего справочника
(см. GetComs).
property Coms_EOF: WordBool; readonly;
Описание : Признак конца списка каналов
function Coms_Next: WordBool;
Описание : Переход к следующей позиции
property Coms_PartNo: Integer;
Описание : Код справочника
property Coms_Name: WideString;
Описание : Наименование справочника
function Coms_Delete: WordBool;
Описание : Удаление текщего справочника
function FindComsByPartNo(APartNo:Integer): WordBool;
Описание :
Параметры:
Результат:
Прмечание:
Ищет справочник по коду
APartNo - Код справочника
1 (true) если успешно, иначе - 0 (false)
Если канал найден, то указатель в списке устанавливается
на него, устанавливается список товаров для найденного
справочника (см. GetComs).
15
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
Пользователям, которые будут использовать «Торговый зал 6.0» в режиме OLE Server
(на пример с 1С:Торговля и склад)мы рекомендуем загрузить приложения «Торговый зал
6.0» до загрузки 1С и чаще обновлять ссылку в своем ПО на объект 'KATRAN.AutoManager',
так как 1С имеет свойство терять данную ссылку по не понятным причинам.
Структура текстовых файлов загрузки и выгрузки
Структура файла загрузки справочника:
1. Код Товара
2. Штрих - Код
3. Наименование
4. Цена покупки
5. Цена продажи
6. Количество
7. Минимальное количество, при котором сигнализировать пользователю
8. Признак дробности
9. Налоговая группа
10. Секция
Между значениями находится настраиваемый разделитель полей. Текстовая информация
может быть ограничена настраиваемым символом признака строки. Пример нескольких строк из
файла загрузки при разделителе полей - «/», без признака строк:
1898/0/130001Женские ботфорты коричневые (Португалия)/45.00/275000.00/6.00/0/0/0/0
1902/0/130002 Полусапожки на шнурках (Португалия)/30.00/47.30/59.00/0/0/0/0
1909/0/130003 Сапоги жен высокие (Португалия)/75.00/93.50/36.00/0/0/0/0
1918/0/130004 Сапоги жен. низкие (Португалия)/55.00/71.50/65.00/0/0/0/0
1930/0/130005 Ботинки женские демисезонные (Португалия)/26.00/38.00/36.00/0/0/0/0
Структура файла выгрузки продаж:
1. Код Товара
2. Название товара
3. Налоговая группа
4. Секция
5. Суммарное проданное количество
6. Сумма скидок
7. Сумма надбавок
8. Сумма продаж
Между значениями находится настраеваемый разделитель полей. Текстовая информация может
быть ограничена настраваемым символом признака строки. Пример нескольких строк из файла
загрузки при разделителе полей - «/»:
1910/120002 Кроссовки высокие нат. кожа/0/0/1/0/0/15
1917/120003 Кроссовки "ADIDAS"/0/0/2/0/0/170000
1933/Вентилятор JIPONIC (Тайв.), напольный/0/0/1/0/0/30
237/Калькулятор TI - 30X Solar/1/1/2/0/0/44
238/Калькулятор TI - 36X Solar - 10-разр., солн. батар/0/0/2/0/0/54
Установка
Программа поставляется на одной дискете. Для установки необходимо в LPT порт вставить
ключ защиты и запустить install.exe. В процессе установки программа сама зарегистрируется как
OLE сервер и в группе программы появится новая подгруппа «Торговый Зал Auto 6.0». Без ключа
защиты программа работает в демонстрационном режиме (20 Товаров 10 чеков). Надо учесть,
аппаратную особенность ключа при работе т.е. после подключения некоторых принтеров
программа может потерять ключ. Рекомендуем или отключить шлейф от ключа или подать на
принтер питание. В системном реестре добавляется Каталог:
16
Апрель 1999 г.
OOO «КАТРАН СОФТ» Москва, Жебрунова 6
тел:/факс: (095)268 - 80 - 06
E-mail: [email protected],[email protected]
HKEY_LOCAL_MACHINE\SOFTWARE\KATRAN\TH60\Options\Files.
В этом каталоге указаны путы откуда грузить Базу Данных, Кассовый Драйвер, Программу,
файл помощи, Файл ошибок, файл загрузки и выгрузки(если они нужны). По этому у пользователя
есть может возможность копировать БД или обновлять драйвер в зависимости от типа ККМ.
На Windows Desk Top появится иконка «Торговый Зал Auto 6.0» и вы можете загрузить
программу. Удаление программы требуется только через пункт «Удаление приложения» из новой
группы «Торговый Зал Auto 6.0».
17
Апрель 1999 г.