Справочный материал

Требования к разработке драйверов для контрольно-кассовых машин в режиме «offline»

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

Требования к разработке драйверов для контрольно-кассовых машин в режиме «offline»

Введение

 

Введение

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

Конфигурация 1С:Пр дприятие Обработка обслуживания Внешняя компонента Обработка обслуживания Обработка обслуживания і і 1 і Внешняя компонента Драйвер Внешняя компонента ш АРМ ПО  л л л Ъ Устройство 1 Устройство / Устройство / Устройство / л М Л

Рис.1

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

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

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

  • непосредственно с моделью контрольно-кассовой машины в режиме «offline»;
  • с программным обеспечением (АРМ), поставляемым вместе с контрольно-кассовой машиной в режиме «offline»;
  • с драйвером контрольно-кассовой машины в режиме «offline» низкого уровня, написанным по технологии OLE for POS (OPOS).

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

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

  • быть разработан в виде внешней компоненты (описание механизма создания внешних компонент приведено в документе «Документация по технологии создания внешних компонент» на диске ИТС в разделе «Технология создания внешних компонент» Методической поддержки 1C:Предприятия 8.0.);
  • обеспечить возможность реализации функционала в полном объеме для подключаемого вида оборудования
  • предоставлять набор свойств и методов для настройки и управления драйвером в соответствии с опубликованными на диске ИТС в разделе «Работа с торговым оборудованием» Методической поддержки 1С:Предприятия 8.1 требованиями к виду представленного на сертификацию оборудования
  • предоставлять русскоязычные и англоязычные названия свойств и методов (например, Таймаут - Timeout, ВыгрузитьТовары() - UploadGoods() и др.);
  • поддерживать множественные подключения (в соответствии с идеологией COM-технологии), а также поддерживать работу с несколькими устройствами, если позволяют бизнес-процессы, в которых используется данное оборудование;
  • при возникновении ошибки в работе предоставлять подробное описание произошедшей ошибки, позволяющее пользователю понять причину возникновения ошибки и способ ее устранения;
  • при возникновении внештатных ситуаций (некорректные действия пользователя, отсутствие запрашиваемого метода или функции, передача некорректных значений и др.) корректно обрабатывать их. Не должно быть аварийных завершений работы драйвера и прочих некорректных действий драйвера, которые могут привести к нарушению нормальной работы пользователя.

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

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

Система 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 Сумма проданного товара (конечная цена с учетом всех скидок/наценок)
Записаться по телефону