Package ru.bitel.bgbilling.plugins.cashcheck.common

Class Check

java.lang.Object
ru.bitel.bgbilling.plugins.cashcheck.common.Check
Direct Known Subclasses:
Check
public class Check
extends java.lang.Object
Используется для формирования последовательностей линий чека. Этот же объект передаётся в скрипты формирования вида чека. После этого отсюда получается список строк для непосредственной посылки в сервер печати. Основной код чека, используется во всех фискализаторах.

  • Nested Class Summary

    Nested Classes
    Modifier and Type Class Description
    static class  Check.CheckLine
    Класс "линия чека", либо продажа(позиция), либо просто строка (когда сумма и отдел равны -1) В сервере печати используется так же: Строка чека.
    static class  Check.STAG
    Шорткат для установки сложных вложенных тегов в чек/позицию.
    static class  Check.Type  

  • Field Summary

    Fields
    Modifier and Type Field Description
    protected java.lang.String cashierINN  
    protected java.lang.String cashierName  
    protected Check.Type checkType
    тип чека: приход, возврат прихода, итд сделан чтобы можно было теоретически поменять в скрипте тип с прихода на возврат (например печатать чек возврата прихода на отрицательные платежи) также используется чтобы печатать чек коррекции прихода вместо чека прихода
    protected java.lang.String customerEmail
    Установленный "адрес пользователя" мыло/телефон.
    protected java.util.Map<java.lang.Integer,​java.lang.Object> customTags
    Доп. теги.
    static java.lang.String CUT_TEXT_COMMAND
    строка которая символизирует отрезку чека, например, в команде драйвера printtext
    protected java.util.Date documentDate  
    protected java.lang.String documentId  
    protected java.util.List<Check.CheckLine> lines
    список линий чека, заполняем сначала этот список теперь, а не сразу текстовые строки, чтобы иметь возможность гибкого манипулирования позициями, суммами итд
    static int OFD_TAG_AGENT_INFO_TYPE
    Атрибуты агента (к позиции): [Тег: 1222] Признак агента по предмету расчета * 0 (bank_payment_agent) - оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным агентом * 1 (bank_payment_subagent) - оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным субагентом * 2 (payment_agent) - оказание услуг покупателю (клиенту) пользователем, являющимся платежным агентом * 3 (payment_subagent) - оказание услуг покупателю (клиенту) пользователем, являющимся платежным субагентом * 4 (solicitor) - осуществление расчета с покупателем (клиентом) пользователем, являющимся поверенным * 5 (commissionaire) - осуществление расчета с покупателем (клиентом) пользователем, являющимся комиссионером * 6 (agent) - осуществление расчета с покупателем (клиентом) пользователем, являющимся агентом и не являющимся банковским платежным агентом (субагентом), платежным агентом (субагентом), поверенным, комиссионером
    static int OFD_TAG_SUPPLIER_INFO_INN
    Атрибуты поставщика (к позиции): [Тег: 1226] ИНН поставщика
    static int OFD_TAG_SUPPLIER_INFO_NAME
    Атрибуты поставщика (к позиции): [Тег: 1225] Наименование поставщика
    static int OFD_TAG_SUPPLIER_INFO_PHONES
    Атрибуты поставщика (к позиции): [Тег: 1171] Телефоны поставщика.
    protected boolean onlyElCheck
    Только электронный чек, на бумаге не печатать
    protected java.math.BigDecimal paymentsum
    считаем сумму, по всем пунктам чека.
    protected java.lang.Integer paymentType
    тип оплаты (он один на весь чек, не на каждую позицию)
    protected java.lang.Integer payMethod  
    protected java.lang.Integer payObject  
    protected java.lang.Integer tax
    налог, налоговая группа итд. задаётся на весь чек одним числом.

  • Constructor Summary

    Constructors
    Constructor Description
    Check()  
    Check​(Check.Type checkType)  

  • Method Summary

    Modifier and Type Method Description
    protected static java.math.BigDecimal _roundSum​(java.math.BigDecimal summa)
    округление входящих сюда сумм, ибо если например передаются суммы из наработки или каким-то делением полученные, то получатся суммы большой точности и некоторые фискализаторы сходят с ума. если точность была меньше точности чем два после запятой - всё равно для общности всё приводится к Х.ХХ
    void addPayment​(java.math.BigDecimal summa, java.lang.String string, int dep)
    Добавление строки продажи.
    void addPayment​(java.math.BigDecimal summa, java.lang.String string, int dep, java.lang.Integer payMethod, java.lang.Integer payObject)  
    void addPayment​(java.math.BigDecimal summa, java.lang.String string, int dep, java.lang.Integer payMethod, java.lang.Integer payObject, java.lang.Integer tax)
    Добавление строки продажи с указанием специфичных признаков способа и объекта расчёта.
    void addString​(java.lang.String string)
    Добавление строки текста.
    java.lang.String getCashierINN()  
    java.lang.String getCashierName()  
    java.lang.String getCheckData()
    получение текстового представления сожержимого чека в том виде котором оно отдаётся на сервер печати
    Check.Type getCheckType()  
    java.lang.String getCustomerEmail()  
    java.util.Date getDocumentDate()
    дата документа, используется в некоторых системах
    java.lang.String getDocumentId()  
    java.util.List<Check.CheckLine> getLines()
    Список линий чека, как платежей, так и каментов.
    java.math.BigDecimal getPaymentsum()  
    java.lang.Integer getPaymentType()  
    java.lang.Integer getPayMethod()
    Признак способа расчёта, вообще это атрибут позиции чека, но здесь оно на весь чек задаётся
    java.lang.Integer getPayObject()
    Признак предмета расчёта, вообще это атрибут позиции чека, но здесь оно на весь чек задаётся
    java.util.List<java.lang.String> getPlines()
    Метод возвращающий список строк для передачи его к клиенту посылки на удалённый сервер печати.
    java.lang.Integer getTax()  
    boolean isOnlyElCheck()
    Признак "только электронный чек, без печати на ленту".
    void setCashierINN​(java.lang.String cashierINN)  
    void setCashierName​(java.lang.String cashierName)  
    void setCheckType​(Check.Type checkType)  
    void setCustomerEmail​(java.lang.String customerEmail)
    установка "адреса пользователя" - мыло/телефон
    void setDocumentDate​(java.util.Date documentDate)
    дата документа, используется в некоторых системах
    void setDocumentId​(int documentId)  
    void setDocumentId​(java.lang.String documentId)  
    void setLastPaymentTag​(int tag, byte[] value)
    Добавление к предыдущей позиции (addPayment) тега, "привязанного к позиции"
    void setLastPaymentTag​(int tag, long value)
    Добавление к предыдущей позиции (addPayment) тега, "привязанного к позиции" целочисленного
    void setLastPaymentTag​(int tag, java.lang.String value)
    Добавление к предыдущей позиции (addPayment) тега, "привязанного к позиции" строкового
    void setLastPaymentTag​(int tag, Check.STAG value)
    Добавление к предыдущей позиции (addPayment) тега, "привязанного к позиции" вложенного тега, внутри мэп с ключом [целое], значение [целое/строка]
    void setOnlyElCheck​(boolean onlyElCheck)
    Установка признака "только электронный чек, без печати на ленту".
    void setPaymentType​(int paymentType)
    Установка типа оплаты (если используется и протокол позволяет)
    void setPayMethod​(int payMethod)
    Признак способа расчёта, вообще это атрибут позиции чека, но здесь оно на весь чек задаётся
    void setPayObject​(int payObject)
    Признак предмета расчёта, вообще это атрибут позиции чека, но здесь оно на весь чек задаётся
    void setTag​(int tag, byte[] value)
    установка произвольного тега
    void setTag​(int tag, long value)
    установка произвольного целочисленного тега
    void setTag​(int tag, java.lang.String value)
    установка произвольного строкового тега
    void setTag​(int tag, Check.STAG value)
    установка вложенного тега, внутри мэп с ключом [целое], значение [целое/строка]
    void setTax​(int tax)
    Установка налога/налоговой группы (если используется и протокол позволяет)
    static byte[] STLV​(byte[]... tlvs)
    создаёт общую структуру из нескольких переданных TLV-структур
    static byte[] TLV​(int tag, byte[] value)  
    static byte[] TLV​(int tag, long value, int len)  
    static byte[] TLV​(int tag, java.lang.String value, java.lang.String charsetName)  

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • paymentsum

      protected java.math.BigDecimal paymentsum
      считаем сумму, по всем пунктам чека. В том числе, если clientsumma не передана, мы подставим её туда, будто клиент дал

    • lines

      protected java.util.List<Check.CheckLine> lines
      список линий чека, заполняем сначала этот список теперь, а не сразу текстовые строки, чтобы иметь возможность гибкого манипулирования позициями, суммами итд

    • paymentType

      protected java.lang.Integer paymentType
      тип оплаты (он один на весь чек, не на каждую позицию)

    • tax

      protected java.lang.Integer tax
      налог, налоговая группа итд. задаётся на весь чек одним числом. хотя например в штрихе задаётся и на продажную позицию и на закрытие чека, также в штрихе можно задать tax1...tax4, но используем только первую

    • customerEmail

      protected java.lang.String customerEmail
      Установленный "адрес пользователя" мыло/телефон.

    • onlyElCheck

      protected boolean onlyElCheck
      Только электронный чек, на бумаге не печатать

    • customTags

      protected java.util.Map<java.lang.Integer,​java.lang.Object> customTags
      Доп. теги. Они могут быть строкой, целым(long), массивом байт, типом STAG (Map) для вложенных тегов. В новом виде передаётся каждый тип по-разному.

    • payMethod

      protected java.lang.Integer payMethod

    • payObject

      protected java.lang.Integer payObject

    • checkType

      protected Check.Type checkType
      тип чека: приход, возврат прихода, итд сделан чтобы можно было теоретически поменять в скрипте тип с прихода на возврат (например печатать чек возврата прихода на отрицательные платежи) также используется чтобы печатать чек коррекции прихода вместо чека прихода

    • cashierName

      protected java.lang.String cashierName

    • cashierINN

      protected java.lang.String cashierINN

    • documentDate

      protected java.util.Date documentDate

    • documentId

      protected java.lang.String documentId

    • CUT_TEXT_COMMAND

      public static final java.lang.String CUT_TEXT_COMMAND
      строка которая символизирует отрезку чека, например, в команде драйвера printtext
      See Also:
      Constant Field Values

    • OFD_TAG_SUPPLIER_INFO_PHONES

      public static final int OFD_TAG_SUPPLIER_INFO_PHONES
      Атрибуты поставщика (к позиции): [Тег: 1171] Телефоны поставщика. Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов.
      See Also:
      Constant Field Values

    • OFD_TAG_SUPPLIER_INFO_NAME

      public static final int OFD_TAG_SUPPLIER_INFO_NAME
      Атрибуты поставщика (к позиции): [Тег: 1225] Наименование поставщика
      See Also:
      Constant Field Values

    • OFD_TAG_SUPPLIER_INFO_INN

      public static final int OFD_TAG_SUPPLIER_INFO_INN
      Атрибуты поставщика (к позиции): [Тег: 1226] ИНН поставщика
      See Also:
      Constant Field Values

    • OFD_TAG_AGENT_INFO_TYPE

      public static final int OFD_TAG_AGENT_INFO_TYPE
      Атрибуты агента (к позиции): [Тег: 1222] Признак агента по предмету расчета * 0 (bank_payment_agent) - оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным агентом * 1 (bank_payment_subagent) - оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным субагентом * 2 (payment_agent) - оказание услуг покупателю (клиенту) пользователем, являющимся платежным агентом * 3 (payment_subagent) - оказание услуг покупателю (клиенту) пользователем, являющимся платежным субагентом * 4 (solicitor) - осуществление расчета с покупателем (клиентом) пользователем, являющимся поверенным * 5 (commissionaire) - осуществление расчета с покупателем (клиентом) пользователем, являющимся комиссионером * 6 (agent) - осуществление расчета с покупателем (клиентом) пользователем, являющимся агентом и не являющимся банковским платежным агентом (субагентом), платежным агентом (субагентом), поверенным, комиссионером
      See Also:
      Constant Field Values

  • Constructor Details

    • Check

      public Check​(Check.Type checkType)

    • Check

      public Check()

  • Method Details

    • addString

      public void addString​(java.lang.String string)
      Добавление строки текста.
      Parameters:
      string - строка.

    • addPayment

      public void addPayment​(java.math.BigDecimal summa, java.lang.String string, int dep)
      Добавление строки продажи.
      Parameters:
      summa - сумма.
      string - название позиции (если используется и протокол позволяет).
      dep - "отдел" в ККМ (если используется и протокол позволяет, иначе ставьте 0).
      See Also:
      addPayment(BigDecimal, String, int)

    • addPayment

      public void addPayment​(java.math.BigDecimal summa, java.lang.String string, int dep, java.lang.Integer payMethod, java.lang.Integer payObject)

    • _roundSum

      protected static java.math.BigDecimal _roundSum​(java.math.BigDecimal summa)
      округление входящих сюда сумм, ибо если например передаются суммы из наработки или каким-то делением полученные, то получатся суммы большой точности и некоторые фискализаторы сходят с ума. если точность была меньше точности чем два после запятой - всё равно для общности всё приводится к Х.ХХ

    • addPayment

      public void addPayment​(java.math.BigDecimal summa, java.lang.String string, int dep, java.lang.Integer payMethod, java.lang.Integer payObject, java.lang.Integer tax)
      Добавление строки продажи с указанием специфичных признаков способа и объекта расчёта.
      Parameters:
      summa - сумма, должна быть не null, сумма сразу приводится к двум знакам точности.
      string - название позиции (если используется и протокол позволяет).
      dep - "отдел" в ККМ (если используется и протокол позволяет, иначе ставьте 0).
      payMethod - признак способа расчёта позиции, не задано: null
      payObject - признак предмета расчёта позиции, не задано: null
      tax - налог для позиции, не задано: null
      See Also:
      addPayment(BigDecimal, String, int)

    • setLastPaymentTag

      public void setLastPaymentTag​(int tag, java.lang.String value)
      Добавление к предыдущей позиции (addPayment) тега, "привязанного к позиции" строкового

    • setLastPaymentTag

      public void setLastPaymentTag​(int tag, long value)
      Добавление к предыдущей позиции (addPayment) тега, "привязанного к позиции" целочисленного

    • setLastPaymentTag

      public void setLastPaymentTag​(int tag, byte[] value)
      Добавление к предыдущей позиции (addPayment) тега, "привязанного к позиции"

    • setLastPaymentTag

      public void setLastPaymentTag​(int tag, Check.STAG value)
      Добавление к предыдущей позиции (addPayment) тега, "привязанного к позиции" вложенного тега, внутри мэп с ключом [целое], значение [целое/строка]

    • setPaymentType

      public void setPaymentType​(int paymentType)
      Установка типа оплаты (если используется и протокол позволяет)
      Parameters:
      paymentType - тип оплаты

    • setTax

      public void setTax​(int tax)
      Установка налога/налоговой группы (если используется и протокол позволяет)
      Parameters:
      tax - налог/налоговая группа

    • setOnlyElCheck

      public void setOnlyElCheck​(boolean onlyElCheck)
      Установка признака "только электронный чек, без печати на ленту".

    • isOnlyElCheck

      public boolean isOnlyElCheck()
      Признак "только электронный чек, без печати на ленту".

    • getPlines

      public java.util.List<java.lang.String> getPlines()
      Метод возвращающий список строк для передачи его к клиенту посылки на удалённый сервер печати.
      Returns:
      список строк

    • getPaymentsum

      public java.math.BigDecimal getPaymentsum()

    • getLines

      public java.util.List<Check.CheckLine> getLines()
      Список линий чека, как платежей, так и каментов.
      Returns:
      лист объектов

    • getPaymentType

      public java.lang.Integer getPaymentType()

    • getTax

      public java.lang.Integer getTax()

    • setCustomerEmail

      public void setCustomerEmail​(java.lang.String customerEmail)
      установка "адреса пользователя" - мыло/телефон

    • getCustomerEmail

      public java.lang.String getCustomerEmail()

    • setTag

      public void setTag​(int tag, java.lang.String value)
      установка произвольного строкового тега

    • setTag

      public void setTag​(int tag, long value)
      установка произвольного целочисленного тега

    • setTag

      public void setTag​(int tag, byte[] value)
      установка произвольного тега

    • setTag

      public void setTag​(int tag, Check.STAG value)
      установка вложенного тега, внутри мэп с ключом [целое], значение [целое/строка]

    • setPayMethod

      public void setPayMethod​(int payMethod)
      Признак способа расчёта, вообще это атрибут позиции чека, но здесь оно на весь чек задаётся

    • setPayObject

      public void setPayObject​(int payObject)
      Признак предмета расчёта, вообще это атрибут позиции чека, но здесь оно на весь чек задаётся

    • getPayMethod

      public java.lang.Integer getPayMethod()
      Признак способа расчёта, вообще это атрибут позиции чека, но здесь оно на весь чек задаётся

    • getPayObject

      public java.lang.Integer getPayObject()
      Признак предмета расчёта, вообще это атрибут позиции чека, но здесь оно на весь чек задаётся

    • getCheckType

      public Check.Type getCheckType()
      Returns:
      текущий тип чека (теоретически может быть незадан на данный момент).

    • setCheckType

      public void setCheckType​(Check.Type checkType)
      Parameters:
      \u043d\u0430\u0441\u0438\u043b\u044c\u043d\u0430\u044f - установка типа чека.

    • TLV

      public static byte[] TLV​(int tag, java.lang.String value, java.lang.String charsetName)

    • TLV

      public static byte[] TLV​(int tag, long value, int len)

    • TLV

      public static byte[] TLV​(int tag, byte[] value)

    • STLV

      public static byte[] STLV​(byte[]... tlvs)
      создаёт общую структуру из нескольких переданных TLV-структур

    • setCashierName

      public void setCashierName​(java.lang.String cashierName)
      Parameters:
      cashierName - значение кассир (1021) для чеков

    • setCashierINN

      public void setCashierINN​(java.lang.String cashierINN)
      Parameters:
      cashierINN - значение инн кассира (1203) для чеков

    • getCashierName

      public java.lang.String getCashierName()

    • getCashierINN

      public java.lang.String getCashierINN()

    • getCheckData

      public java.lang.String getCheckData()
      получение текстового представления сожержимого чека в том виде котором оно отдаётся на сервер печати

    • getDocumentDate

      public java.util.Date getDocumentDate()
      дата документа, используется в некоторых системах

    • setDocumentDate

      public void setDocumentDate​(java.util.Date documentDate)
      дата документа, используется в некоторых системах

    • getDocumentId

      public java.lang.String getDocumentId()

    • setDocumentId

      public void setDocumentId​(int documentId)

    • setDocumentId

      public void setDocumentId​(java.lang.String documentId)