Меню


Курсы СтимулСправочникПолезные материалы1С:Предприятие 8.2Работа с торговым оборудова…Общее

1С:Предприятие 8.2 /
Работа с торговым оборудованием /
Общее

Оглавление

Внешняя компонента "1C:Фискальный регистратор OPOS"

Основные возможности

Работа с внешней компонентой

Свойства

Примеры работы с внешней компонентой

 

Для работы "1С: Предприятия " с фискальными регистраторами, подключаемыми через OPOS драйвер " Фискальный регистратор "Мебиус" от компании "Терлис", применяется внешняя компонента (ВК) системы 1С:Предприятие "1С:Фискальный регистратор OPOS". Текущая версия ВК - 8.0.1.1.

Основные возможности

Внешняя компонента, используя драйвер фискального регистратора, позволяет настроить регистратор, подготовить чек для печати и напечатать его, а также возвращает текущее состояние и информацию об ошибках для обработки в 1С:Предприятие. Компонента поддерживает стандарт OPOS для типа устройств «Фискальный регистратор» и может использоваться для работы с другими устройствами, драйвера которых также поддерживают стандарт OPOS для типа устройств «Фискальный регистратор».

Работа с внешней компонентой

ВК позволяет зарегистрировать кассира (открыть смену), снять промежуточный итог (Х-отчет), закрыть смену (Z-отчет), а также формировать и выводить на печать товарные чеки следующих типов:

В чеках продажи (простой) и возврата (простой) отображается следующая информация:

Свойства

Название (alias)ТипRWОписание
Порт (Port)Число++Один из параметров настройки последовательного порта (номер COM-порта).
Скорость (Speed)Число++Один из параметров настройки последовательного порта (скорость передачи данных).
Результат (ResultCode)Число+-Свойство содержит код результата последней операции.
ДопРезультат (ResultCodeExtended)Число+-Свойство содержит расширенный код результата последней операции.
УстройствоЗанято (ClaimedDevice)Число+-Свойство содержит признак монопольного использованияустройства .
УстройствоВключено (DeviceEnabled)Число++Свойство, указывающее, что устройство используется. Должно быть установлено в «Истина»(1) после занятия устройства и в «Ложь»(0) перед освобождением.
ОписаниеКонтролОбъекта (ControlObjectDescription)Строка+-Свойство содержит описание управляющего объекта (Control Object - CO) (объект верхнего уровня в архитектуре OPOS).
ВерсияКонтролОбъекта (ControlObjectVersion)Число+-Свойство содержит версию OPOS, поддерживаемую управляющим объектом.
ОписаниеСервисОбъекта (ServiceObjectDescription)Строка+-Свойство содержит описание исполняющего объекта (Service Object - SO) (объект нижнего уровня архитектуры OPOS).
ВерсияСервисОбъекта (ServiceObjectVersion)Число+-Свойство содержит версию OPOS, поддерживаемую исполняющим объектом.
ИмяУстройства (DeviceName)Строка+-Свойство содержит строку, идентифицирующую устройство. Эта строка устанавливается в момент открытия устройства.
ОписаниеУстройства (DeviceDescription)Строка++Свойство содержит текстовое описание устройства, которое может быть изменено пользователем.
НомерФискальнойСмены (RemainingFiscalMemory)Число+-Номер смены, хранящейся в памяти регистратора (увеличивается на 1 при очередном открытии смены).
ТипФискальногоЧека (FiscalReceiptType)Число++Свойство, в котором устанавливается тип чека. Необходимо установить до вызова метода НачалоФискальногоЧека(…).
ПоложениеЦеновойДесЗапятой (amountDecimalPlaces)Число+-Свойство содержит указание вида передачи денежных сумм.
0 - для передачи суммы копеек отводится только целая часть, оно соответствует значениям от 0 до 2147483647.00 и совпадает с реальными передаваемыми в этом поле данными от 0 до 2147483647 копеек;
2 - для передачи суммы копеек отводится не только целая часть, но и два разряда после запятой от 0 до 21474836.47, оно соответствует значениям копеек от 0 до 2147483647.
ПоложениеКоличДесЗапятой (QuantityDecimalPlaces)Число+-Свойство содержит указание вида передачи количества.
0 - в количестве все отводится только для целой части товара;
3 - в количестве передается целая часть товара и еще три разряда под дробное значение.

Примечание: если после вызова метода Управление(8, ПозицияЗапятойПоУмолчанию, "") переменная ПозицияЗапятойПоУмолчанию = 1, то количество товара передается как при значении свойства равном 0.

СтрокаПередТП (PreLine)Строка++Свойство используется в следующих случаях:
  1. При вызове метода ПечатьТП(…) в этом свойстве может передаваться бар-код товара;
  2. При вызове методов ПечатьПодитога(…) и ПечатьСкидкиНаТП(…) печатается содержимое этого параметра перед результатом выполнения этих методов;
  3. При формировании чека возврата или продажи с помощью метода ПечатьИтога(…) в этом свойстве могут передаваться код кредитной карточки или код купона в зависимости от типа платежа;
  4. При формировании чеков внесения и выемки перед вызовом функции ПечатьВнесенияВыемки(…) в параметре можно передавать текстовый комментарий к проводимой операции.
СтрокаПослеТП (PostLine)Строка++Свойство используется в следующих случаях:
  1. При вызове метода ПечатьТП(…) в этом свойстве передается тип товара, «1»-дробный(весовой) и «0»-целый(обычный, не весовой);
  2. При вызове методов ПечатьПодитога(…), ПечатьСкидкиНаТП(…) печатается содержимое этого параметра после результата выполнения этих методов;
  3. При формировании любого чека возврата или продажи с помощью метода ПечатьИтога(…) в этом свойстве могут передаваться наименование кредитной карточки или наименование купона в зависимости от типа платежа.
СменаОткрыта (DayOpened)Булево+-Показывает реальное состояние смены.
СостояниеПринтера (PrinterState)Число+-Свойство содержит код текущего состояния устройства.
СостояниеПитания (PowerState)Число+-Свойство содержит текущее состояние питания устройства.

Методы

Название (alias)ПараметрыВозвращаемое значениеОписание
Открыть (Open)ИмяУстройства (Строка, соответствующая имени устройства)Результат в формате OPOSОткрыть устройство.
Закрыть (Close)-Результат в формате OPOSМетод завершает работу с устройством.
ЗанятьУстройство (ClaimDevice)Таймаут (Число, максимальное время ожидания)Результат в формате OPOSМетод осуществляет попытку получения монопольного доступа к устройству (устройство должно быть открыто).
ОсвободитьУстройство (ReleaseDevice)-Результат в формате OPOSМетод освобождает устройство (метод выполняет действия, противоположные «ЗанятьУстройство»).
Управление (DirectIO)Команда (Число, код команды), ЧислПарам (Число, числовой параметр), СтрокПарам (Строка, строковой параметр)Результат в формате OPOSОбщий метод OPOS. Используется для взаимодействия с сервис-объектом напрямую.
ПечатьОтчетаБезГашения
(XReport)
-Результат в формате OPOSПечать Х-отчета.
ПечатьОтчетаСГашением
(ZReport)
-Результат в формате OPOSПечать Z-отчета.
НачалоФискальногоЧека
(BeginFiscalReceipt)
ПечатьЗаголовка (Булево)Результат в формате OPOSОткрывает фискальный чек (смена должна быть открыта).
КонецФискальногоЧека
(EndFiscalReceipt)
ПечатьЗаголовка (Булево)Результат в формате OPOSЗавершение фискального чека (если печать чека не была окончена, то произойдет сброс чека).
ПечатьВнесенияВыемки
(PrintRecCash)
Сумма (Число, вносимая сумма, вид в соотв. с параметром ПоложениеЦеновойДесЗапятой)Результат в формате OPOSПечать в чеке строки внесения или выемки суммы (чек должен быть открыт, необходимо указать тип чека).
ПечатьТП
(PrintRecItem)
Наименование (Строка, наименование товара с возможным указанием единиц измерения количества)
Сумма (Число, вид в соотв. с параметром ПоложениеЦеновойДесЗапятой, без скидок/наценок)
Количество (Число, вид в соответствии с параметром ПоложениеКоличДесЗапятой)
НалоговаяСтавка ()
Цена (Число, вид в соотв. с параметром ПоложениеЦеновойДесЗапятой)
СтрокПараметр (Строка, не используется, передавать пустую строку)
Результат в формате OPOSПечать товарной позиции в чеке (чек должен быть открыт).
ПечатьСкидкиНаТП
(PrintRecItemadjustment)
ТипСкидки (Число, определяет какой тип скидки печается: скидка/наценка, процентная/абсолютная)
Описание (Строка, инф. строка, выводится после печати скидки)
Скидка (Число, процентная или абсолютная)
НалоговаяСтавка (Число, индекс в таблице НС)
Результат в формате OPOSПечать скидки на товарную позицию (вызывается после ПечатьТП(…)).
АннулироватьЧек
(PrintRecVoid)
СтрокПараметр (Строка, не используется, передавать пустую строку)Результат в формате OPOSСброс чека.
ПечатьПодытога
(PrintRecSubtotal)
Сумма (Число, подытоговая сумма с учетом всех скидок/наценок)Результат в формате OPOSМетод служит для формирования подытога в чеках продажи и возврата.
ПечатьИтога
(PrintRecTotal)
ИтоговаяСумма (Число, вид в соотв. с параметром ПоложениеЦеновойДесЗапятой, сумма, с учетом всех скидок)
Оплата (Число, вид в соотв. с параметром ПоложениеЦеновойДесЗапятой)
СтрокПараметр (Строка, передается либо только тип чека, либо тип чека и тип платежа, а код кредитной карточки или код купона и наименование кредитной карточки или купона идут в этом же параметре после второго символа, но между кодом и наименованием должен быть текстовый разделитель "-/-")
Результат в формате OPOSМетод служит для формирования итога в чеках (обязательный вызов в конце любого чека перед закрытием чека).
РегистрацияКассира
(SetPOSID)
НомерКассы (Число, может быть от 0 до 2147483647)
НомерКассира (Число, должен состоять из «XXX-/-N…N», где XXX это номер кассира строка от 1 до 255, «-/-» – разделитель, N…N – строка имя кассира длиной до 23 символов)
Результат в формате OPOSРегистрация нового кассира (если смена открыта, то просто происходит смена кассира, в противном случае сначала происходит открытие смены).
УстановитьНС
(SetVatValue)
ИндексНС (Число)
ЗначениеНС (Число)
Результат в формате OPOSДанную команду необходимо вызывать после открытия и перед первым чеком продажи, чтобы таблица налоговых ставок была сформирована до начала продаж. Свойство СменаОткрыта не влияет.
ИндексНС – от 1 до 15, налоговая ставка 0 всегда имеет ЗначениеНС = 0 (используетcя для продажи безналогового товара);
ЗначениеНС – от 0(0.0%) до 999(99.9%)
ЗаполнитьТаблицуНС
(SetVatTable)
-Результат в формате OPOSПри вызове этого метода происходит сохранение таблицы налоговых ставок в реестре в параметре VatTable, для того чтобы ее не инициализировать повторно после выхода из программы. При следующем запуске, OPOS-драйвер автоматически считает из реестра таблицу налоговых ставок. Внутри ФР налоговые ставки очищаются только при закрытии смены .
ПРИМЕЧАНИЕ
Свойства и методы также описаны в справочной системе элемента управления

Примеры работы с внешней компонентой

  1. Подключение внешней компоненты
    Перем Драйвер;
    Попытка
    	ПрогИД="addIn.OPOS.FiscalPrinter";
    	ПодключитьВнешнююКомпоненту(ПрогИД);
    	Драйвер= Новый (ПрогИД);
    Исключение
    	Результат=мОшибкаЗагрузкиДрайвера;
    КонецПопытки;
    Если Результат=мНетОшибки Тогда
    	Драйвер.Порт=<Порт>;
    	Драйвер.Скорость=<Скорость>;
    КонецЕсли;
    
  2. Подключение и отключение ФР
    Драйвер.Открыть("MbsFiscalPrinter");
    Драйвер.УстройствоАктивно= Истина/Ложь; // (при подключении/отключении) 
    Драйвер.Закрыть();
    
  3. Открытие и закрытие чека
    Драйвер.НачалоФискальногоЧека(Истина);
    Драйвер.КонецФискальногоЧека(Истина);
    
  4. Печать некоторых позиций
    Драйвер.ПечатьТП(
    ""
    ,<Сумма>,<Количество>,<НомерНС>,<Цена>,
    ""
    );
    Драйвер.ПечатьВнесенияВыемки(<Сумма>);
    Драйвер.ПечатьИтога(<ИтоговаяСумма>,<ИтоговаяСумма>,
     ""
    );
    

Нас находят: fiscalreceipttype, внешней компоненты 1С: Фискальный регистратор OPOS версии 8 0 1, внешняя компонента фискальный регистратор 8 0 1 1, BeginFiscalReceipt, 1С: Фискальный регистратор OPOS версии 8 0 1, методы OPOS сервис, opos fiscal printer test выбор com порта, 1С: Фискальный регистратор OPOS, 1с opos, PrintRecItem


Подписка на новости RSS     Добавьте в закладки Google fusion     Мы в Google+    

 

Мы ВКонтакте

 

Мы на Facebook