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