Работа с торговым оборудованием
17.06.2009
Система программ 1С:Предприятие поддерживает обмен данными с различными моделями контрольно-кассовых машин в режиме «offline» по согласованной технологии (рис.1).
Рис.1
Конфигурация системы программ «1С:Предприятие 8» взаимодействует с обработками обслуживания контрольно-кассовых машин в режиме «offline».
Обработки обслуживания контрольно-кассовых машин в режиме «offline» взаимодействуют с внешними компонентами для контрольно-кассовых машин в режиме «offline» (драйверами для интеграции с «1С:Предприятие 8»).
Внешняя компонента (далее по тексту «драйвер») может взаимодействовать:
Общие требования к драйверу:
Драйвер должен:
Система 1С:Предприятие (в дальнейшем "система") инициализирует соединение с драйвером и загружает его. Далее устанавливаются конфигурационные параметры, необходимые для работы. Подключение к устройству выполняется при начале операции с устройством торгового оборудования.
Отключение от устройства выполняется при окончании операции с устройством.
Соединение с драйвером закрывается только при завершении работы системы.
Описание свойств | ||||
---|---|---|---|---|
Название (alias) | Тип | Доступность | Описание | |
Чтение | Запись | |||
Описание методов | |||||
---|---|---|---|---|---|
Название (alias) | Параметры | Возвращаемое значение | Описание | ||
Имя | Тип | Описание | |||
ПолучитьНомерВерсии (GetVersion) | - | - | - | BSTR | Возвращает номер версии драйвера |
ПолучитьОшибку (GetLastError) | ОписаниеОшибки (ErrorDescription) |
BSTR [OUT] | Описание ошибки | LONG | Возвращает код и описание последней произошедшей ошибки |
Подключить (Open) | МассивЗначений (ValuesArray) |
IDispatch* |
Массив значений для настройки подключения | 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 | Сумма проданного товара (конечная цена с учетом всех скидок/наценок) |