Methods_receipt - shtrih-m/fr_drv_ng GitHub Wiki
| Members | Descriptions |
|---|---|
public int CancelCheck()
|
Аннулировать чек. |
public int CashIncome()
|
Внесение. |
public int CashOutcome()
|
Выплата. |
public int CheckSubTotal()
|
Подытог чека. |
public int ContinuePrint()
|
Продолжить печать. |
public int CutCheck()
|
Отрезать чек. |
public int FeedDocument()
|
Продвинуть документ. |
public int FNCancelDocument()
|
Отменить документ ФН. |
public int FNCloseCheckEx()
|
Закрытие чека расширенное в ФН |
public int FNOperation()
|
Операция в ФН. |
public int FNStorno()
|
Сторно ФН |
public int OpenCheck()
|
Открыть чек. |
public int SysAdminCancelCheck()
|
Отмена чека администратором. |
| Members | Descriptions |
|---|---|
public int FNAddTag()
|
Добавить тег. |
public int FNBeginSTLVTag()
|
Начать СТЛВ тег. |
public int FNSendCustomerEmail()
|
Передает в ФН тег 1008(“телефон или e-mail покупателя”) |
public int FNSendItemCodeData()
|
Отправить КТН тег |
public int FNSendSenderEmail()
|
Передает в ФН тег 1117(“адрес электронной почты отправителя чека”) |
public int FNSendSTLVTag()
|
Отправить СТЛВ тег. |
public int FNSendSTLVTagOperation()
|
Отправить СТЛВ тег, привязанный к операции. |
public int FNSendTag()
|
Отправить произвольный тег в ФН |
public int FNSendTagOperation()
|
Отправить тег, привязанный к операции. |
public int FNSendTLV()
|
Передать структуру TLV в ФН. |
public int FNSendTLVOperation()
|
Отправить TLV, привязанный к операции. |
| Members | Descriptions |
|---|---|
public int FNBeginCorrectionReceipt()
|
Начать формирование чека коррекции. |
public int FNBuildCorrectionReceipt()
|
Сформировать чек коррекции ФН. |
public int FNBuildCorrectionReceipt2()
|
Сформировать чек коррекции V2. |
public int CancelCheck()
Аннулировать чек.
Операция производит аннулирование (отмену) всего чека.
- Переводит ККМ в режим, в котором ККМ была до открытия чека, или в режим 3.
Используемые свойства:
- Password - пароль оператора.
Модифицируемые свойства:
- OperatorNumber - порядковый номер оператора, чей пароль был использован.
Код ошибки
public int CashIncome()
Внесение.
Метод регистрирует внесение денежной суммы в кассу.
Работает в режимах 2, 3, 4, 7 и 9. Не меняет режима ККМ.
Используемые свойства:
Модифицируемые свойства:
-
OperatorNumber - порядковый номер оператора, чей пароль был использован
-
OpenDocumentNumber - cквозной номер последнего документа ККМ
Код ошибки
public int CashOutcome()
Выплата.
Метод регистрирует выплату денежной суммы из кассы.
Работает в режимах 2, 3, 4, 7 и 9. Не меняет режима ККМ.
Используемые свойства:
Модифицируемые свойства:
-
OperatorNumber - порядковый номер оператора, чей пароль был использован
-
OpenDocumentNumber - cквозной номер последнего документа ККМ.
Код ошибки
public int CheckSubTotal()
Подытог чека.
Метод возвращает подытог текущего чека.
- Не меняет режима ККМ.
Используемые свойства:
- Password - пароль оператора.
Модифицируемые свойства:
-
OperatorNumber - порядковый номер оператора, чей пароль был использован,
-
Summ1 - подытог текущего чека.
Код ошибки
public int ContinuePrint()
Продолжить печать.
Команда возобновления печати после заправки в ККМ бумаги. После заправки бумаги ККМ находится в подрежиме 3 (см. свойство ECRAdvancedMode) до тех пор, пока не будет вызван данный метод.
Работает в любом режиме, но только в подрежиме 3. Не меняет режима ККМ, но выводит из подрежима 3.
Используемые свойства:
- Password - пароль оператора,
Модифицируемые свойства:
- OperatorNumber - порядковый номер оператора, чей пароль был использован,
Код ошибки
public int CutCheck()
Отрезать чек.
Метод подает на принтер чеков команду «Отрезать чек». Перед исполнением метода необходимо задать способ отрезки («Полная» или «Неполная») в свойстве CutType. После отрезки в зависимости от значения свойства FeedAfterCut может производиться автоматическая промотка чековой ленты. Количество строк промотки необходимо задать в свойстве FeedLineCount.
Метод может вызываться в любом режиме, кроме 8, 10, 11, 12, 14 и подрежимов 4 и 5. Не меняет режима ККМ.
Используемые свойства:
Модифицируемые свойства:
- OperatorNumber - порядковый номер оператора, чей пароль был использован,
Код ошибки
public int FeedDocument()
Продвинуть документ.
Продвигает документ на указанное в свойстве StringQuantity количество строк. Продвигаемый документ задается свойствами UseSlipDocument, UseReceiptRibbon, UseJournalRibbon.
Метод может вызываться в любом режиме, кроме режимов 8, 10, 11, 12, 14 и подрежимов 4 и 5. Не меняет режима ККМ.
Используемые свойства:
-
Password - пароль оператора,
-
StringQuantity - количество строк, на которое необходимо продвинуть документ,
-
UseSlipDocument - продвинуть подкладной документ,
-
UseReceiptRibbon - продвинуть чековую ленту,
-
UseJournalRibbon - продвинуть ленту операционного журнала.
Модифицируемые свойства:
- OperatorNumber - порядковый номер оператора, чей пароль был использован.
Код ошибки
public int FNAddTag()
Добавить тег.
Добавляет тег (не STLV) к родительскому STLV-тегу с указанным TagID. Может быть вызван только после вызова FNBeginSTLVTag.
Работает только с онлайн-кассами.
Используемые свойства:
-
TagID - ID родительского STLV-тега,
-
TagNumber - номерТега STLV,
-
TagType - тип тега,
-
TagValueInt - значение целочисленного тега,
-
TagValueStr - строковое значение тега,
-
TagValueFVLN - значение тега с плавающей запятой,
-
TagValueDateTime - значение тега с датой и временем,
-
TagValueBin Строка - значение тега с бинарными данными,
-
TagValueLength - количество байт длины значения тега.
Код ошибки
See also: FNBeginSTLVTag
public int FNBeginCorrectionReceipt()
Начать формирование чека коррекции.
После вызова данного метода возможна отправка дополнительных TLV-Тегов (согласно документу ФНС «Форматы фискальных документов») при помощи метода FNSendTLV. Далее для проведения отчета необходимо вызвать метод FNBuildCorrectionReceipt.
Работает только с онлайн-кассами.
Работает во всех режимах. Не меняет режима ККМ.
Используемые свойства:
- Password - пароль системного администратора.
Код ошибки
public int FNBeginSTLVTag()
Начать СТЛВ тег.
Начинает формирование тега STLV(тег, включающий в себя другие вложенные теги).
Для добавления обычных(не STLV) вложенных тегов после вызова FNBeginSTLVTag необходимо использовать метод FNAddTag. Для того, чтобы добавить внутрь STLV-тега еще один STLV-тег, нужно повторно вызвать FNBeginSTLVTag. Метод модифицирует свойство TagID для идентификации STLV-тега, в который будут добавляться следующие теги. При первом вызове FNBeginSTLVTag вернет TagID = 0.
К примеру, следующая последовательность вызовов : FNBeginSTLVTag FNAddTag FNAddTag FNBeginSTLVTag FNAddTag FNAddTag cоздаст следующую STLV-структуру: STLV Tag 1 Tag 2 STLV Tag 1 Tag 2
Для отправки сформированного STLV-тега следует использовать метод FNSendSTLVTag либо FNSendSTLVTagOperation. После вызова одного из этих методов STLV-структура очищается и снова можно начать формирование следующей STLV- структуры методом FNBeginSTLVTag.
Работает только с онлайн-кассами.
Используемые свойства:
-
TagID - ID родительского STLV-тега(необязателен при первом вызове FNSendSTLVTag),
-
TagNumber - номерТега STLV,
Модифицируемые свойства:
- TagID - ID созданного STLV-тега.
Код ошибки
See also: FNAddTag
public int FNBuildCorrectionReceipt()
Сформировать чек коррекции ФН.
Работает только с онлайн-кассами.
Работает во всех режимах. Не меняет режима ККМ.
Используемые свойства:
Модифицируемые свойства:
-
ReceiptNumber - номер чека,
-
DocumentNumber - номер ФД,
-
FiscalSign - фискальный признак,
-
FiscalSignAsString - фискальный признак документа в виде строки.
Код ошибки
Deprecated:
public int FNBuildCorrectionReceipt2()
Сформировать чек коррекции V2.
Сформировать чек коррекции. Команда версии 2. См. так же FNBeginCorrectionReceipt.
Работает только с онлайн-кассами.
Используемые свойства:
-
Password - пароль системного администратора,
-
CorrectionType - Тип коррекции
-
CalculationSign - Признак расчёта
-
Summ1 - cумма по чеку,
-
Summ2 - cумма по чеку наличными,
-
Summ3 - сумма по чеку электронными,
-
Summ4 - сумма по чеку предоплатой,
-
Summ5 - сумма по чеку постоплатой,
-
Summ6 - сумма по чеку встречным представлением,
-
Summ7 - сумма НДС 18%,
-
Summ8 - сумма НДС 10%,
-
Summ9 - сумма расчета по ставке 0%,
-
Summ10 - сумма расчета по чеку без НДС,
-
Summ11 - сумма расчета по чеку 18/118,
-
Summ12 - сумма расчета по расч. ставке 10/110,
-
TaxType - код применяемой системы налогооблажения.
Модифицируемые свойства:
-
ReceiptNumber - номер чека,
-
DocumentNumber - номер фискального документа,
-
FiscalSign - фискальный признак.
Код ошибки
public int FNCancelDocument()
Отменить документ ФН.
Работает только с онлайн-кассами.
Используемые свойства:
- Password - пароль администратора.
Код ошибки
public int FNCloseCheckEx()
Закрытие чека расширенное в ФН
Закрытие чека расширенное в ФН.
Работает только с онлайн-кассами.
Согласно ФФД 1.05 для указания суммы предварительной оплаты (аванс) необходимо использовать свойство Summ14, для суммы последующей оплаты (кредит) необходимо использовать свойство Summ15, для иной формы оплаты(оплата встречным предоставлением) необходимо использовать свойство Summ16.
В режиме начисления налогов 1(1 - я таблица) суммы налогов на позицию и на чек должны передаваться из верхнего ПО.
Используемые свойства:
-
Password - пароль оператора,
-
Summ1 - сумма типа оплаты 1,
-
Summ2 - сумма типа оплаты 2,
-
Summ3 - сумма типа оплаты 3,
-
Summ4 - сумма типа оплаты 4,
-
Summ5 - сумма типа оплаты 5,
-
Summ6 - сумма типа оплаты 6,
-
Summ7 - сумма типа оплаты 7,
-
Summ8 - сумма типа оплаты 8,
-
Summ9 - сумма типа оплаты 9,
-
Summ10 - сумма типа оплаты 10,
-
Summ11 - сумма типа оплаты 11,
-
Summ12 - сумма типа оплаты 12,
-
Summ13 - сумма типа оплаты 13,
-
Summ14 - сумма предварительной оплаты (аванс),
-
Summ15 - сумма последующей оплаты (кредит),
-
Summ16 - сумма иной формы оплаты (оплата встречным предоставлением),
-
RoundingSumm - округление до рубля в копейках,
-
TaxValue1 - сумма налога 1,
-
TaxValue2 - сумма налога 2,
-
TaxValue3 - сумма налога 3,
-
TaxValue4 - сумма налога 4,
-
TaxValue5 - сумма налога 5,
-
TaxValue6 - сумма налога 6,
-
TaxType - система налогообложения,
-
StringForPrinting Строка для печати.
Модифицируемые свойства:
-
Change - сумма сдачи,
-
DocumentNumber - номер ФД,
-
FiscalSign - фискальный признак,
-
FiscalSignAsString - фискальный признак документа в виде строки.
Код ошибки
public int FNOperation()
Операция в ФН.
Работает только с онлайн-кассами.
Если Summ1Enabled имеет значение "ложь", то сумма операции рассчитывается кассой как цена*количество, в противном случае сумма операции берётся из значения Summ1 и не должна отличаться более чем на +-1 коп от рассчитанной кассой.
В режиме начисления налогов 1(1 Таблица)налоги на позицию и на чек должны передаваться из верхнего ПО. Если TaxValueEnabled имеет значение "Ложь", то считается, что сумма налога на позицию не указана, в противном случае сумма налога учитывается ФР и передаётся в ОФД. Для налогов 3 и 4 сумма налога всегда считается равной нулю и в ОФД не передаётся.
Если строка начинается символами //, то она передаётся на сервер ОФД, но не печатается на кассе.
Количество округляется до 6 знаков после запятой.
Используемые свойства:
-
Password - пароль оператора,
-
CheckType - тип операции,
-
Quantity - количество (до 6 знаков после запятой),
-
Price - цена(в копейках),
-
Summ1 - сумма операции(в копейках),
-
Summ1Enabled - использовать сумму операции,
-
TaxValue - сумма нолога(в копейках),
-
TaxValueEnabled - использовать сумму налога,
-
Tax1 - налоговая ставка,
-
Department - отдел (0..16 режим свободной продажи, 255 – режим продажи по коду товара),
-
PaymentTypeSign - признак способа расчета,
-
PaymentItemSign - признак предмета расчета,
-
StringForPrinting - наименование товара.
Код ошибки
public int FNSendCustomerEmail()
Передает в ФН тег 1008 (“телефон или e-mail покупателя”)
Используемые свойства:
-
Password - пароль оператора
-
CustomerEmail- Еmail покупателя
Код ошибки
public int FNSendItemCodeData()
Отправить КТН тег
Отправляет тег 1162 (Код товарной номенклатуры), привязанный к операции. Метод должен вызываться только после метода FNOperation.
Работает только с онлайн-кассами.
Используемые свойства:
-
Password - пароль пользователя.
-
MarkingType - Тип маркировки товара. (2 - Изделия из меха, 3 - лекарственные препараты, 5 - Табачные изделия)
-
SerialNumber - для Меха - КиЗ 20 символов; для лекарственных препаратов - Серийный номер 13 символов; для табачных изделий - код идентификации экземпляра, 24 симв.
-
GTIN - число, преобразуется в 6 байт Big endian
Код ошибки
public int FNSendSenderEmail()
Передает в ФН тег 1117 (“адрес электронной почты отправителя чека”)
Используемые свойства:
-
Password - пароль оператора
-
EmailAddress- Еmail отправителя
Код ошибки
public int FNSendSTLVTag()
Отправить СТЛВ тег.
Отправляет STLV тег, предварительно сформированный методами FNBeginSTLVTag, FNAddTag. После вызова данного метода можно начинать формирование нового STLV-тега при помощи FNBeginSTLVTag.
Работает только с онлайн-кассами.
Используемые свойства:
- Password - пароль пользователя.
Модифицируемые свойства:
- TLVData - пароль пользователя.
Код ошибки
public int FNSendSTLVTagOperation()
Отправить СТЛВ тег, привязанный к операции.
Отправляет STLV тег, привязанный к операции. Тег должен быть предварительно сформирован методами FNBeginSTLVTag, FNAddTag. После вызова данного метода можно начинать формирование нового STLV-тега при помощи FNBeginSTLVTag.
Работает только с онлайн-кассами.
Используемые свойства:
- Password - пароль пользователя.
Модифицируемые свойства:
Код ошибки
public int FNSendTag()
Отправить произвольный тег в ФН
Используемые свойства:
-
Password - пароль оператора
-
TagNumber - Номер Тега
-
TagType - Тип Тега
-
TagValueInt - Значение Тега целое
-
TagValueStr - Значение тега строка
-
TagValueFVLN - Значение тегаFVLN
-
TagValueDateTime - Значение тега дата время
-
TagValueBin - Значение тега бинарное
-
TagValueLength - Длина значения тега
Код ошибки
public int FNSendTagOperation()
Отправить тег, привязанный к операции.
Работает только с онлайн-кассами.
Используемые свойства:
-
Password - пароль оператора
-
TagNumber - Номер Тега
-
TagType - Тип Тега
-
TagValueInt - Значение Тега целое
-
TagValueStr - Значение тега строка
-
TagValueFVLN - Значение тегаFVLN
-
TagValueDateTime - Значение тега дата время
-
TagValueBin - Значение тега бинарное
-
TagValueLength - Длина значения тега
Код ошибки
public int FNSendTLV()
Передать структуру TLV в ФН.
Работает только с онлайн-кассами.
Работает во всех режимах. Не меняет режима ККМ.
Используемые свойства:
Код ошибки
public int FNSendTLVOperation()
Отправить TLV, привязанный к операции.
Передать произвольную TLV структуру, привязанную к операции.
Работает только с онлайн-кассами.
Используемые свойства:
Код ошибки
public int FNStorno()
Сторно ФН
Deprecated: реализация удалена. Актуальные версии ФФД не поддерживают сторно.
Код ошибки
public int OpenCheck()
Открыть чек.
Метод открывает документ (чек) определённого типа (продажа, покупка, возврат продажи, возврат покупки).
2, 4, 7 и 9. Переводит ККМ в режим 8 или 3.
Используемые свойства:
Deprecated:
- #SkipPrint - для отключения печати стоит использовать метод
See also: SetDeviceFunction с DFE_SkipAllPrinting
Модифицируемые свойства:
- OperatorNumber - порядковый номер оператора, чей пароль был использован.
Код ошибки
public int SysAdminCancelCheck()
Отмена чека администратором.
Команда позволяет системному администратору отменить (аннулировать) чек, открытый любым другим оператором, администратором или самим системным администратором. При этом на чеке печатается надпись «ЧЕК АННУЛИРОВАН».
Работает в режиме 8. Переводит ККМ в режим, в котором ККМ была до открытия чека, или в режим 3
Используемые свойства:
- Password - пароль системного администратора
Код ошибки