Работа с торговым оборудованием
17.06.2009

Требования к разработке драйверов для контрольно-кассовых машин в режиме «offline» для платформы "1С:Предприятие 8.1"

Введение

Система программ 1С:Предприятие поддерживает обмен данными с различными моделями контрольно-кассовых машин в режиме «offline» по согласованной технологии (рис.1).

Рис.1

Конфигурация системы программ «1С:Предприятие 8» взаимодействует с обработками обслуживания контрольно-кассовых машин в режиме «offline».

Обработки обслуживания контрольно-кассовых машин в режиме «offline» взаимодействуют с внешними компонентами для контрольно-кассовых машин в режиме «offline» (драйверами для интеграции с «1С:Предприятие 8»).

Внешняя компонента (далее по тексту «драйвер») может взаимодействовать:

Общие требования к драйверу:

Драйвер должен:

Описание работы с драйвером

Начало работы с драйвером

Система 1С:Предприятие (в дальнейшем "система") инициализирует соединение с драйвером и загружает его. Далее устанавливаются конфигурационные параметры, необходимые для работы. Подключение к устройству выполняется при начале операции с устройством торгового оборудования.

Завершение работы

Отключение от устройства выполняется при окончании операции с устройством.

Соединение с драйвером закрывается только при завершении работы системы.

Описание свойств

Описание свойств
Название (alias) Тип Доступность Описание
Чтение Запись
         

Описание методов

Описание методов
Название (alias) Параметры Возвращаемое значение Описание
Имя Тип Описание
ПолучитьНомерВерсии (GetVersion) - - - BSTR Возвращает номер версии драйвера
ПолучитьОшибку (GetLastError) ОписаниеОшибки
(ErrorDescription)
BSTR [OUT] Описание ошибки LONG Возвращает код и описание последней произошедшей ошибки
Подключить (Open) МассивЗначений
(ValuesArray)

IDispatch*
[IN]

Массив значений для настройки подключения BOOL Подключает ККМ Offline
ИДУстройства (DeviceID) BSTR [OUT] Идентификатор устройства
Отключить (Close) ИДУстройства (DeviceID) BSTR [IN] Идентификатор устройства BOOL Отключает ККМ Offline
ВыгрузитьТовары (UploadGoods) ИДУстройства (DeviceID) BSTR [IN] Идентификатор устройства BOOL Выгружает товары в ККМ
ТаблицаТоваров (Goods)

IDispatch*[IN]

Таблица значений с информацией о товарах 
ЗагрузитьОтчет (DownloadReport) ИДУстройства (DeviceID) BSTR [IN] Идентификатор устройства BOOL Загружает отчет о проданных товарах из ККМ

ТаблицаПродаж (Report)

IDispatch*[OUT] Таблица значений с информацией о продажах
ОтчетЗагружен (LoadSuccess) ИДУстройства (DeviceID) BSTR [IN] Идентификатор устройства BOOL Драйверу устанавливается флаг в «Истина», если отчет был успешно обработан, и в «Ложь» в противном случае.

ФлагСостояния(StateFlag)

BOOL [IN] Признак успеха обработки отчета
ОчиститьБазу (PurgeBase) ИДУстройства (DeviceID) BSTR [IN] Идентификатор устройства BOOL Очищает базу товаров ККМ
ТестУстройства (DeviceTest) МассивЗначений
(ValuesArray)
IDispatch*
[IN]
Массив значений для настройки подключения

BOOL

Выполняет пробное подключение и опрос устройства. При успешном выполнении подключения в описании возвращается описание устройства. При отрицательном результате возвращается описание возникшей проблемы при подключении.
ДополнительноеОписание (AdditionalDescription) BSTR
[OUT]
Описание результата выполнения теста

Дополнительное описание:
"МассивЗначений" (пример значений для устройства, подключаемого на последовательном порту)

Наименование параметра   Наличие в структуре Типы данных Описание параметра
Порт (Port) Необязательно LONG Номер последовательного порта (1 соответствует порту COM1).
Скорость (Speed) Необязательно LONG Скорость последовательного порта, на которой подключается устройство (передается непосредственно значение 9600, 19200, 57600, 115200 и т.д.)
Таймаут (Timeout) Необязательно LONG Время, в течение которого компонента должна ожидать ответа от устройства при выполнении операций.

"ТаблицаТоваров"

Имя

Тип

Описание

PLU LONG PLU товара
Штрихкод (BarCode) BSTR Штрихкод товара
Номенклатура (Name1) BSTR Наименование номенклатуры
ХарактеристикаНоменклатуры (Name2) BSTR Характеристика номенклатуры
СерияНоменклатуры (Name3) BSTR Серия номенклатуры
ЕдиницаИзмерения (Name4) BSTR Единица измерения номенклатуры
Цена (Price) DOUBLE Цена
Остаток (Remainder) DOUBLE Остаток товаров
ВесовойТовар (IsWeightGoods) BOOL Признак весового товара

"ТаблицаПродаж"

Имя Тип Описание
PLU LONG PLU товара
Цена (Price) DOUBLE Цена, по которой продан товар
Количество (Quantity) DOUBLE Количество проданного товара
Скидка (Discount) DOUBLE Процент предоставленной скидки
Сумма (Amount) DOUBLE Сумма проданного товара (конечная цена с учетом всех скидок/наценок)