Драйвер ККМ АМС-100Ф.

Драйвер может быть подключен в конфигурацию “Торговля + склад” редакция 9.2.

Подключение драйвера к 1С:Торговля + Склад

Перепишите файлы внешней обработки “on_ams100f.ert” и “on_ams100f.efd” из каталога драйвера (обычно “c:\program files\ams100FDriver”) в подкаталог информационной базы 1С “ExtForms\Equip” (например, если база расположена в каталоге “c:\db”, то файлы необходимо скопировать в каталог “c:\db\ExtForms\Equip”).

Добавьте новую кассу в справочник “Кассы”. В поле “Код” введите последние четыре цифры заводского номера.

В меню “Сервис” выберите пункт “Настройка торгового оборудования”, на вкладке “ККМ On-Line” отметьте галочкой нужную кассу, в выпадающем списке выберите “АМС-100Ф Online” и нажмите кнопку “Подключить”.

Затем в меню “Сервис” выберите пункт “Параметры...”. Во вкладке АМС100Ф настройте параметры драйвера. Сетевым номером для кассы АМС-100Ф служат последние четыре цифры заводского номера. В поле “Ключ активации” указывается путь к каталогу, содержащему ключ активации.

Подключение кассы в режиме чекового онлайна осуществляется аналогичным образом, но в справочнике “Кассы”, необходимо установить поле “Режим работы в ККМ” в значение “ФР” и в окне “Торговое оборудование” заполнить вкладку “Фискальный регистратор”.

Програмный интерфейс драйвера ККМ АМС-100Ф

Для подключения драйвера к системе 1С:Предприятие необходимо вызвать функцию ПодключитьВнешнююКомпоненту("ams100f1c.driver"). Желательно это делать в предопределенной процедуре глобального модуля ПриНачалеРаботыСистемы().

Для создания объекта ККМ используйте функцию СоздатьОбъект("AddIn.АМС100Ф").

Функции:

Название: Активизировать()

Синтаксис: Активизировать()

Назначение: Переводит драйвер в активное состояние.

Возвращаемые значения: 0 – подключение не удалось, функция ПолучитьТекстОшибки() возвращает описание ошибки подключения; 1 – успешное подключение.

Название: ПолучитьТекстОшибки()

Синтаксис: ПолучитьТекстОшибки()

Назначение: Возращает описание ошибки подключения.

Возвращаемые значения: строка с описанием ошибки.

Название: Остановить()

Синтаксис: Остановить()

Назначение: Останавливает работу драйвера.

Возвращаемые значения: 0 – ошибка, 1 – успех.

Название: СобытиеОбработано()

Синтаксис: СобытиеОбработано()

Назначение: Эту функцию необходимо вызвать при завершении обработки внешнего события.

Возвращаемые значения: нет

Название: ДобавитьТовар(<?>,<?>,<?>,<?>,<?>)

Синтаксис: ДобавитьТовар(<Название>,<НомерОтдела>,<Цена>,<Кол-во>,<Точность>)

Назначение: Добавляет товар в текущий чек. Название – название товара; НомерОтдела – число от 1 до 8; Цена – число; Кол-во – число; Точность – количество цифр после десятичной точки в параметре <Кол-во>, возможные значения 2 или 3.

Возвращаемые значения: нет

Название: НачатьЗаполнениеЧека()

Синтаксис: НачатьЗаполнениеЧека()

Назначение: Подготовить драйвер к внесению товаров в чек. Товары добавляются функцией ДобавитьТовар().

Возвращаемые значения: 1 – успех, 0 – ошибка.

Название: ПечатьЧека(<?>)

Синтаксис: ПечатьЧека(<ПризнакВозврата>)

Назначение: Выводит диалоговое окно “Нажмите ФЦ 1 ВВ”, после нажатия соответствующих клавиш на ККМ печатает подготовленный чек. Если ПризнакВозврата равен 1 печатается чек на возврат.

Возвращаемые значения: 1 – успех, 0 – печать чека была отменена.

Название: ОтменаПечати()

Синтаксис: ОтменаПечати()

Назначение: Отменяет печать чека, или вызов функции НачатьЗаполнениеЧека(). После нажатия клавиш ККМ “ФЦ” “1” “ВВ” отменить печать чека невозможно.

Возвращаемые значения: 1 – успех, 0 – ошибка.

Название: УстановитьРежимФР(<?>)

Синтаксис: ОтменаПечати(<Режим>)

Назначение: Переводит ККМ в режим чекового онлайна если Режим=1, или в режим онлайн если Режим=0.

Возвращаемые значения: нет

Свойства:

Синтаксис: Порт

Назначение: Номер ком-порта – число от 1 до 255.

Синтаксис: ИнтервалОпроса

Назначение: Интервал опроса ККМ в миллисекундах. Чем меньше интервал тем быстрее драйвер реагирует на действия кассира. Рекомендуемые значения от 200 до 500.

Синтаксис: ПЛУ

Назначение: Штрихкод. Значение свойства актуально при обработке внешнего события “Запрос”.

Синтаксис: СетевойНомер

Назначение: Сетевой номер кассы.

Синтаксис: КодАктивации

Назначение: Код активации драйвера или путь к каталогу, содержащему код активации.

Синтаксис: Количество

Назначение: Количество товара. Значение свойства актуально при обработке внешних событий “Запрос”, “ДобавлениеПокупкиВЧек” и “Продажа”. Установите значение этого свойства при обработке внешнего события “Запрос”, если Вы необходимо изменить количество товара (например для штрихкода установлен коэффициент).

Синтаксис: НаименованиеТовара

Назначение: Установите это свойство при обработке события “Запрос”. Значение этого свойства актуально при обработке события “ДобавлениеПокупкиВЧек”.

Синтаксис: ЗаголовокЧека

Назначение: Заголовок и подвал чека в формате <строка1>|<строка2>|<строка3>|<подвал>.

Синтаксис: МожноОтвечать

Назначение: Установите значение этого свойства в 1 при обработке внешнего события “Запрос”, чтобы подтвердить добавление покупки, или установите в 0, чтобы отменить добавление.

Синтаксис: Цена

Назначение: Цена товара. Установите значение этого свойства при обработке внешнего события “Запрос”.

Синтаксис: Отдел

Назначение: Установите значение этого свойства при обработке внешнего события “Запрос”. Значение актуально при обработке события “Продажа”.

Синтаксис: СуммаПокупки

Назначение: Значение свойства актуально при обработке внешних событий “Продажа” и “ДобавлениеПокупкиВЧек”.

Синтаксис: ПризнакВозврата

Назначение: Значение свойства актуально при обработке внешнего события “ЗакрытиеЧека”.

Синтаксис: НомерЧека

Назначение: Номер текущего чека

Внешние события:

Драйвер отслеживает состояние ККМ и при его изменении генерирует событие, передаваемое в 1С.

Процедура обработки внешних событий получает три параметра: источник, событие, данные. События генерируемые данным драйвером имеют вид: источник - “AMS100Online”, событие – строка идентификатор события , данные – сетевой номер ККМ.

Параметр событие может принимать следующие значения: ЗакрытиеЧека, Запрос, СбросЧека, Продажа, ДобавлениеПокупкиВЧек, Включение, Выключение, Печать нулевого чека, ZОтчет, ЧекНапечатан.

Внимание! Если драйвер работает в режие онлайн, то перед выходом из процедуры обработки внешнего события необходимо вызвать функцию драйвера СобытиеОбработано()!

После того как драйвер загружен функцией ПодключитьВнешнююКомпоненту, его настройку можно осуществлять с помощью страницы свойств, отображаемой в диалоге "Настройка параметров системы".