orangedata 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2dde9cd360d680c7c81b2daa172585325a888a57
-  data.tar.gz: fc2569d5d679490fb5315873fd94c3e26a8fc8af
+  metadata.gz: 6087498a7c12ae0d3250d75c1ee5148cfea56a7f
+  data.tar.gz: c7ac45d748527a88a20f04853b4fbb5dde802ca9
 SHA512:
-  metadata.gz: b62936f69fd98b21c29ba5eb028206aa1ea8a8d073262acba0dc3aaef7ee86a7a49f5237d8deaed690391e4b0a541679f1b6899583e23102e7da100522531560
-  data.tar.gz: f1b7e6ef44e611925d8a3147b27df7b7413be86bb9c686b329d171dd25fe4ece1028b55e1aea2de59d5712541f8e034596adaf509709f758d13dca3621baace7
+  metadata.gz: e12efa52f2a06f1393b2c951f84e9e3fa102bc2a5a5d4d592d7b69b62a930a3c3cfc3c23b13a516187296a0e5d72a98cfbce6ae5539bcea1555c87ea8fda8232
+  data.tar.gz: 76d6d37502cd2dde226b18b6b0cc342770b0304272bae7d998ed01cbd4811f11f5496fa7877afd98a957115df2c193bb8a6a63709bfb33895e1686ebf77dc404

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    orangedata (0.0.2)
+    orangedata (0.0.3)
       faraday (>= 0.15)
       faraday_middleware
 
@@ -14,12 +14,16 @@ GEM
     crack (0.4.3)
       safe_yaml (~> 1.0.0)
     diff-lcs (1.3)
+    docile (1.3.1)
     faraday (0.15.2)
       multipart-post (>= 1.2, < 3)
     faraday_middleware (0.12.2)
       faraday (>= 0.7.4, < 1.0)
     hashdiff (0.3.7)
     jaro_winkler (1.5.1)
+    json (2.1.0)
+    json-schema (2.8.1)
+      addressable (>= 2.4)
     multipart-post (2.0.0)
     parallel (1.12.1)
     parser (2.5.1.0)
@@ -51,6 +55,11 @@ GEM
       unicode-display_width (~> 1.0, >= 1.0.1)
     ruby-progressbar (1.9.0)
     safe_yaml (1.0.4)
+    simplecov (0.16.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
     unicode-display_width (1.4.0)
     webmock (3.4.2)
       addressable (>= 2.3.6)
@@ -62,10 +71,12 @@ PLATFORMS
 
 DEPENDENCIES
   bundler (~> 1.16)
+  json-schema (~> 2.8)
   orangedata!
   rake (~> 10.0)
   rspec
   rubocop
+  simplecov
   webmock
 
 BUNDLED WITH

data/README.md

@@ -35,50 +35,46 @@ gem 'orangedata'
 
 ```ruby
   transport = OrangeData::Transport.new("https://apip.orangedata.ru:2443/api/v2/", OrangeData::Credentials.default_test)
-
-  receipt = {
-    id: SecureRandom.uuid,
-    inn: '1234567890', key:'1234567890',
-    content: { # тут собрать данные можно по официальному мануалу
-      type: 1,
-      positions:[{ quantity: 1, price: 0.01, tax: 4, text: "Товар на копейку"}],
-      checkClose:{
-        payments: [{ type:2, amount:'0.01' }],
-        taxationSystem: 1
-      }
-    }
+  receipt = OrangeData::Receipt.income(inn:"1234567890"){|r|
+    r.customer = "Иван Иваныч"
+    r.add_position("Спички", price: 12.34){|pos| pos.tax = :vat_not_charged }
+    r.add_payment(50, :cash)
   }
   transport.post_document(receipt)
-  # wait some time, then
-  transport.get_document("1234567890", receipt[:id])
-  # =>
+  # wait some time
+  res = transport.get_document(receipt.inn, receipt.id)
+
+  # => (внутри такое, а вернет объект)
   # {
-  #   "id"=>"a88b6b30-20ab-47ea-95ca-f12f22ef03d3",
-  #   "deviceSN"=>"1400000000001033",
-  #   "deviceRN"=>"0000000400054952",
-  #   "fsNumber"=>"9999078900001341",
-  #   "ofdName"=>"ООО \"Ярус\" (\"ОФД-Я\")",
-  #   "ofdWebsite"=>"www.ofd-ya.ru",
-  #   "ofdinn"=>"7728699517",
-  #   "fnsWebsite"=>"www.nalog.ru",
-  #   "companyINN"=>"1234567890",
-  #   "companyName"=>"Тест",
-  #   "documentNumber"=>5548,
-  #   "shiftNumber"=>6072,
-  #   "documentIndex"=>3045,
-  #   "processedAt"=>"2018-10-22T19:36:00",
-  #   "content"=>
-  #     {
-  #       "type"=>1,
-  #       "positions"=>[{"quantity"=>1.0, "price"=>0.01, "tax"=>4, "text"=>"Товар на копейку"}],
-  #       "checkClose"=>{
-  #         "payments"=>[{"type"=>2, "amount"=>0.01}],
-  #         "taxationSystem"=>1
-  #       }
-  #     },
-  #   "change"=>0.0,
-  #   "fp"=>"787980846"
+  # "id"=>"50152258-a9aa-4d19-9216-5a3eecec7241",
+  # "deviceSN"=>"1400000000001033",
+  # "deviceRN"=>"0000000400054952",
+  # "fsNumber"=>"9999078900001341",
+  # "ofdName"=>"ООО \"Ярус\" (\"ОФД-Я\")",
+  # "ofdWebsite"=>"www.ofd-ya.ru",
+  # "ofdinn"=>"7728699517",
+  # "fnsWebsite"=>"www.nalog.ru",
+  # "companyINN"=>"1234567890",
+  # "companyName"=>"Тест",
+  # "documentNumber"=>3243,
+  # "shiftNumber"=>234,
+  # "documentIndex"=>7062, "processedAt"=>"2018-10-26T20:21:00",
+  # "content"=>{
+  #   "type"=>1,
+  #   "positions"=>[{"price"=>12.34, "tax"=>6, "text"=>"Спички"}],
+  #   "checkClose"=>{"payments"=>[{"type"=>1, "amount"=>50.0}], "taxationSystem"=>0},
+  #   "customer"=>"Иван Иваныч"
+  # },
+  # "change"=>37.66,
+  # "fp"=>"301645583"
   # }
+
+  res.device_sn
+  # => "1400000000001033"
+
+  # и даже так:
+  res.qr_code_content
+  # => "t=20181026T2021&s=50.0&fn=9999078900001341&i=3243&fp=301645583&n=1"
 ```
 
 ### Получаем сертификаты
@@ -90,8 +86,9 @@ gem 'orangedata'
 
 ```ruby
   c = OrangeData::Credentials.read_certs_from_pack('~/Downloads/1234567890', title:'My production', cert_key_pass:'1234') # cert_key_pass берем из readme_v2.txt, но есть подозрение что он у всех 1234
-  # Generated public signature key: <RSAKeyValue>...</Exponent></RSAKeyValue>
   File.open("my_production.yml", "wt"){|f| f.write c.to_yaml }
+  c.signature_public_xml
+  # "<RSAKeyValue>...</Exponent></RSAKeyValue>"
 
   # опционально на маке копируем публичный ключ в буфер обмена:
   system("echo '#{c.signature_public_xml}' | pbcopy")
@@ -102,7 +99,7 @@ gem 'orangedata'
 Дальше публичный ключ с предыдущего шага отправляется в ЛК, там его сохряняем, "подключаем интеграцию", и пользуемся:
 
 ```ruby
-  transport = OrangeData::Transport.new(OrangeData::Transport::DEFAULT_PRODUCTION_API_URL, OrangeData::Credentials.from_hash(YAML.load('my_production.yml')))
+  transport = OrangeData::Transport.new(OrangeData::Transport::DEFAULT_PRODUCTION_API_URL, OrangeData::Credentials.from_hash(YAML.load_file('my_production.yml')))
   transport.post_document # и далее по тексту, осторожно - не пробейте лишние чеки во время проверок
 ```
 

data/lib/orange_data/credentials.rb

@@ -51,6 +51,25 @@ module OrangeData
             end
           end
         end
+
+        def load_from(val, key_pass=nil)
+          return val unless val
+          case val
+          when self
+            val
+          when Hash
+            from_hash(val)
+          when String
+            if val.start_with?('<')
+              from_xml(val)
+            else
+              new(val, key_pass)
+            end
+          else
+            raise ArgumentError, "cannot load from #{val.class}"
+          end
+        end
+
       end
 
     end
@@ -72,29 +91,28 @@ module OrangeData
     def valid?
       signature_key_name &&
         signature_key && signature_key.private? &&
-        certificate && certificate_key && certificate_key.private?
+        (signature_key.n.num_bits >= 489) && # minimum working key length for sha256 signature
+        certificate && certificate_key &&
+        certificate_key.private? && certificate.check_private_key(certificate_key)
+    end
+
+    def ==(other)
+      return false unless %i[signature_key_name title].all?{|m| self.send(m) == other.send(m) }
+      # certificates/keys cannot be compared directly, so dump
+      %i[signature_key certificate certificate_key].all?{|m|
+        c1 = self.send(m)
+        c2 = other.send(m)
+        c1 == c2 || (c1 && c2 && c1.to_der == c2.to_der)
+      }
     end
 
     def self.from_hash(creds)
-      key = nil
-      if creds[:signature_key]
-        key = if creds[:signature_key].is_a?(OpenSSL::PKey::RSA)
-          creds[:signature_key]
-        elsif creds[:signature_key].is_a?(Hash)
-          OpenSSL::PKey::RSA.from_hash(creds[:signature_key])
-        elsif creds[:signature_key].is_a?(String) && creds[:signature_key].start_with?('<')
-          OpenSSL::PKey::RSA.from_xml(creds[:signature_key])
-        else
-          OpenSSL::PKey::RSA.new(creds[:signature_key], creds[:signature_key_pass])
-        end
-      end
       new(
+        title: creds[:title],
         signature_key_name: creds[:signature_key_name],
-        signature_key: key,
+        signature_key: OpenSSL::PKey::RSA.load_from(creds[:signature_key], creds[:signature_key_pass]),
         certificate: creds[:certificate] && OpenSSL::X509::Certificate.new(creds[:certificate]),
-        certificate_key: creds[:certificate_key] &&
-          OpenSSL::PKey::RSA.new(creds[:certificate_key], creds[:certificate_key_pass]),
-        title: creds[:title]
+        certificate_key: OpenSSL::PKey::RSA.load_from(creds[:certificate_key], creds[:certificate_key_pass]),
       )
     end
 
@@ -109,9 +127,9 @@ module OrangeData
       {
         title: title,
         signature_key_name: signature_key_name,
-        signature_key: signature_key && signature_key.to_pem(OpenSSL::Cipher.new("aes-128-cbc"), key_pass),
+        signature_key: signature_key && signature_key.to_pem(key_pass && OpenSSL::Cipher.new("aes-128-cbc"), key_pass),
         certificate: certificate && certificate.to_pem,
-        certificate_key: certificate_key && certificate_key.to_pem(OpenSSL::Cipher.new("aes-128-cbc"), key_pass),
+        certificate_key: certificate_key && certificate_key.to_pem(key_pass && OpenSSL::Cipher.new("aes-128-cbc"), key_pass),
       }.tap do |h|
         h.delete(:title) if !title || title == ''
         if save_pass
@@ -147,24 +165,33 @@ module OrangeData
       "#<#{self.class.name}:#{object_id} #{info_fields.map{|(k, v)| "#{k}=#{v}" }.join(' ')}>"
     end
 
-    def generate_signature_key!(key_length=2048)
-      self.signature_key = OpenSSL::PKey::RSA.new(key_length)
+    DEFAULT_KEY_LENGTH = 2048
+
+    #deprecated
+    def generate_signature_key!(key_length=DEFAULT_KEY_LENGTH)
+      self.signature_key = self.class.generate_signature_key(key_length)
+    end
+
+    def self.generate_signature_key(key_length=DEFAULT_KEY_LENGTH)
+      raise ArgumentError, "key length should be >= 489, recomended #{DEFAULT_KEY_LENGTH}" unless key_length >= 489
+      OpenSSL::PKey::RSA.new(key_length)
     end
 
-    def self.read_certs_from_pack(path, signature_key_name:nil, cert_key_pass:nil, title:nil)
+    def self.read_certs_from_pack(path, signature_key_name:nil, cert_key_pass:nil, title:nil, signature_key:nil)
       path = File.expand_path(path)
       client_cert = Dir.glob(path + '/*.{crt}').select{|f| File.file?(f.sub(/.crt\z/, '.key'))}
       raise 'Expect to find exactly one <num>.crt with corresponding <num>.key file' unless client_cert.size == 1
       client_cert = client_cert.first
 
-      # private_key_test.xml || rsa_\d+_private_key.xml
-      xmls = Dir.glob(path + '/*.{xml}').select{|f| f =~ /private/}
-      signature_key = if xmls.size == 1
-        File.read(xmls.first)
-      else
-        OpenSSL::PKey::RSA.new(2048).tap{|k|
-          puts "Generated public signature key: #{k.public_key.to_xml}"
-        }
+      unless signature_key
+        # private_key_test.xml || rsa_\d+_private_key.xml
+        xmls = Dir.glob(path + '/*.{xml}').select{|f| f =~ /private/}
+        signature_key = if xmls.size == 1
+          File.read(xmls.first)
+        else
+          generate_signature_key(DEFAULT_KEY_LENGTH)
+          # .tap{|k| logger.info("Generated public signature key: #{k.public_key.to_xml}") }
+        end
       end
 
       from_hash(

data/lib/orange_data/receipt.rb

@@ -1,79 +1,325 @@
 # frozen_string_literal: true
 
+require 'yaml'
+require 'json'
+
 module OrangeData
 
-  # main class for receipt
-  class Receipt
+  PAYLOAD_SCHEMA = YAML.load_file(File.expand_path('schema_definitions.yml', __dir__)).freeze
+
+  # taken from ActiveSupport
+  module StringExt
+    refine String do
+      def underscore
+        self.gsub(/::/, '/').
+        gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+        gsub(/([a-z\d])([A-Z])/,'\1_\2').
+        tr("-", "_").
+        downcase
+      end
+    end
+  end
+  using StringExt unless "".respond_to?(:underscore)
+
+  # main class for receipt/correction
+  class Document
 
-    attr_accessor :id, :inn, :group, :key_name
+    attr_accessor :id, :inn, :group, :key_name, :content
 
-    def initialize(id:SecureRandom.uuid, inn:, group:nil, key_name:nil)
+    def initialize(id:SecureRandom.uuid, inn:, group:nil, key_name:nil, content:nil)
       @id = id
       @inn = inn
       @group = group
-      @key_name = key_name
-      yield self if block_given?
+      @key_name = key_name || inn
+      @content = content if content
+      yield @content if block_given?
     end
 
+    def to_json(*args)
+      {
+        id: id,
+        inn: inn,
+        group: group || 'Main',
+        content: content,
+        key: key_name
+      }.to_json(*args)
+    end
   end
 
-  # nodoc
-  class ReceiptContent
-
-    # for agent type bit mask
-    module AgentTypeSerializer
-      AGENT_TYPE_BITS = { # 1057 (в чеках/БСО должно соответствовать отчету о (пере)регистрации ККТ)
-        bank_payment_agent:    (1 << 0), # банковский платежный агент
-        bank_payment_subagent: (1 << 1), # банковский платежный субагент
-        payment_agent:         (1 << 2), # платежный агент
-        payment_subagent:      (1 << 3), # платежный субагент
-        attorney:              (1 << 4), # поверенный
-        commission_agent:      (1 << 5), # комиссионер
-        other_agent:           (1 << 6), # иной агент
-      }.freeze
-
-      def self.load(data)
-        data = data.to_i
-        AGENT_TYPE_BITS.reject{|(_, v)| (data & v).zero? }.map(&:first)
+  class Receipt < Document
+    def initialize(id:SecureRandom.uuid, inn:, group:nil, key_name:nil, content:nil)
+      @content = ReceiptContent.new(content || {})
+      super
+    end
+    PAYLOAD_SCHEMA["definitions"]["CheckContent"]["properties"]["type"]["x-enum"].each_pair do |slug, info|
+      define_singleton_method(slug) do |**args, &block|
+        new(**args, &block).tap{|doc|
+          doc.content.type = slug
+        }
       end
+    end
+  end
 
-      def self.dump(val)
-        val = [val] unless val.is_a?(Array)
-        val.map{|v| AGENT_TYPE_BITS[v] || raise("unknown agent_type #{v}") }.reduce(:|)
+  module GeneratedAttributes
+    def self.from_schema klass, schema
+      klass.class_eval{
+        extend GeneratedAttributes
+        generate_accessors_from_schema(schema)
+      }
+    end
+
+    protected
+    def generate_accessors_from_schema schema
+      plain_types = %w[integer string number]
+      schema["properties"].each_pair do |property, info|
+        if plain_types.include?(info["type"])
+          if info["x-enum"]
+            inverse_map = info["x-enum"].map{|k,v| [v['val'], k.to_sym]}.to_h
+            define_method(property.underscore){
+              return nil if @payload[property].nil?
+              inverse_map[@payload[property]] || "unknown value #{@payload[property].inspect} for field #{property}"
+            }
+            define_method(:"#{property.underscore}="){|val|
+              unless val.nil?
+                val = (info["x-enum"][val.to_s] || raise(ArgumentError, "unknown value #{val.inspect} for property #{property}"))["val"]
+              end
+              @payload[property] = val
+            }
+
+          elsif info["x-bitfield"]
+            bitmap = info["x-bitfield"].map{|k,v| [k.to_sym, 1 << v['bit']]}.to_h
+            # TODO: return wrapper so that :<< etc will work
+            define_method(property.underscore){
+              return nil if @payload[property].nil?
+              data = @payload[property].to_i
+              # FIXME: unknown bits will be silently lost
+              bitmap.reject{|_,v| (data & v).zero? }.map(&:first)
+            }
+            define_method(:"#{property.underscore}="){|val|
+              unless val.nil?
+                val = [val] unless val.is_a?(Array)
+                val = val.map{|v| bitmap[v] || raise(ArgumentError, "unknown value #{v.inspect} for property #{property}") }.reduce(:|)
+              end
+              @payload[property] = val
+            }
+          else
+            # primitive
+            define_method(property.underscore){ @payload[property] }
+            define_method(:"#{property.underscore}="){|val| @payload[property] = val }
+          end
+        elsif info["type"] == 'array'
+          if info["items"] && plain_types.include?(info["items"]["type"])
+            define_method(property.underscore){ @payload[property] }
+            define_method(:"#{property.underscore}="){|val|
+              val = [val] unless val.is_a?(Array)
+              @payload[property] = val
+            }
+          else
+            # ref?
+          end
+        else
+
+        end
       end
     end
+  end
 
-    RECEIPT_TYPES = { # 1054:
+  # base class for semi-generated classes
+  class PayloadContent
+    def initialize payload={}
+      @payload = payload
+    end
 
-    }.freeze
+    def assign_attributes options
+      options.each_pair{|k,v|
+        setter = :"#{k}="
+        send(setter, v) if respond_to?(setter)
+      }
+      # for chaining:
+      self
+    end
 
-    FIELDS = {
-      type: {
-        name: 'Признак расчета',
-        tag_num: 1054,
-        mapper: :enum,
-        enum_values: {
-          income: 1,        # Приход
-          return_income: 2, # Возврат прихода
-          expense: 3,       # Расход
-          return_expense: 4 # Возврат расхода
-        }
+    def ==(other)
+      self.class == other.class && @payload == other.instance_variable_get(:@payload)
+    end
+
+    def to_hash
+      @payload
+    end
+
+    def to_json(*args)
+      to_hash.to_json(*args)
+    end
+  end
+
+  class ReceiptContent < PayloadContent
+    def initialize payload={}
+      @payload = payload || {}
+      # TODO: import...
+      # TODO: taxationSystem default in checkclose
+      @check_close = CheckClose.new(@payload['checkClose'])
+      @positions = (@payload['positions'] || []).map{|pos| Position.new(pos) }
+      if @payload["additionalUserAttribute"]
+        @additional_user_attribute = AdditionalUserAttribute.new(@payload["additionalUserAttribute"])
+      end
+    end
+
+    # сырой тип используется в qr_code
+    def raw_type
+      @payload["type"]
+    end
+
+    def to_hash
+      @payload.dup.tap{|h|
+        h["positions"] = @positions.map(&:to_hash)
+        h["checkClose"] = check_close.to_hash if check_close
+        h["additionalUserAttribute"] = additional_user_attribute.to_hash if additional_user_attribute
       }
-    }.freeze
+    end
 
-    def initialize(_type)
-      @positions = []
-      @payments = []
+    def add_position(text=nil, **options)
+      pos = Position.new
+      pos.text = text if text
+      pos.assign_attributes(options)
+      yield(pos) if block_given?
+      positions << pos
+      self
     end
 
-    def agent_type
-      AgentTypeSerializer.load(@agent_type)
+    def add_payment(amount=nil, type=nil, **options)
+      payment = Payment.new
+      payment.type = type if type
+      payment.amount = amount if amount
+      payment.assign_attributes(options)
+      yield(payment) if block_given?
+      check_close.payments << payment
+      self
     end
 
-    def agent_type=(val)
-      @agent_type = AgentTypeSerializer.dump(val)
+    def set_additional_user_attribute **options
+      @additional_user_attribute = AdditionalUserAttribute.new.assign_attributes(options)
     end
 
+
+
+    class Position < PayloadContent
+      def initialize payload={}
+        @payload = payload
+        @supplier_info = SupplierInfo.new(@payload['supplierInfo']) if @payload['supplierInfo']
+        @agent_info = AgentInfo.new(@payload['agentInfo']) if @payload['agentInfo']
+      end
+
+      def to_hash
+        @payload.dup.tap{|h|
+          h["supplierInfo"] = supplier_info.to_hash if supplier_info
+          h["agentInfo"] = agent_info.to_hash if agent_info
+        }
+      end
+
+      def set_supplier_info **options
+        @supplier_info = SupplierInfo.new.assign_attributes(options)
+        self
+      end
+
+      def set_agent_info **options
+        @agent_info = AgentInfo.new.assign_attributes(options)
+        self
+      end
+
+      attr_reader :agent_info, :supplier_info
+
+      GeneratedAttributes.from_schema(self, PAYLOAD_SCHEMA["definitions"]["CheckPosition"])
+    end
+
+    class AgentInfo < PayloadContent
+      def initialize payload={}
+        @payload = payload
+      end
+      def to_hash
+        @payload
+      end
+      GeneratedAttributes.from_schema(self, PAYLOAD_SCHEMA["definitions"]["AgentInfo"])
+    end
+
+    class SupplierInfo < PayloadContent
+      def initialize payload={}
+        @payload = payload
+      end
+      def to_hash
+        @payload
+      end
+      GeneratedAttributes.from_schema(self, PAYLOAD_SCHEMA["definitions"]["SupplierInfo"])
+    end
+
+    class CheckClose < PayloadContent
+      def initialize payload={}
+        payload ||= {}
+        @payload = payload
+        @payments = (payload['payments'] || []).map{|p| Payment.new(p)}
+      end
+
+      def to_hash
+        @payload.dup.tap{|h|
+          h["payments"] = @payments.map(&:to_hash) if @payments
+        }
+      end
+
+      attr_reader :payments
+
+      GeneratedAttributes.from_schema(self, PAYLOAD_SCHEMA["definitions"]["CheckClose"])
+    end
+
+    class Payment < PayloadContent
+      GeneratedAttributes.from_schema(self, PAYLOAD_SCHEMA["definitions"]["CheckPayment"])
+    end
+
+    class AdditionalUserAttribute < PayloadContent
+      GeneratedAttributes.from_schema(self, PAYLOAD_SCHEMA["definitions"]["AdditionalUserAttribute"])
+    end
+
+    GeneratedAttributes.from_schema(self, PAYLOAD_SCHEMA["definitions"]["CheckContent"])
+
+    attr_reader :positions, :check_close, :additional_user_attribute
+
+  end
+
+
+  class Correction < Document
+    # TODO: same as Receipt, but based on correctionType
+  end
+
+  class ReceiptResult < PayloadContent
+    def initialize payload
+      @payload = payload
+      @content = ReceiptContent.new(@payload["content"])
+    end
+
+    def self.from_hash(hash)
+      raise ArgumentError, 'Expect hash here' unless hash.is_a?(Hash)
+      new(hash)
+    end
+
+    attr_reader :content
+    GeneratedAttributes.from_schema(self, PAYLOAD_SCHEMA["definitions"]["CheckStatusViewModel[CheckContent]"])
+
+    def qr_code_content
+      #  С живого чека:  t=20180518T220500&s=975.88&fn=8710000101125654&i=99456&fp=1250448795&n=1
+      # Пример: t=20150720T1638&s=9999999.00&fn=000110000105&i=12345678&fp=123456&n=2
+      {
+        # - t=<date/time - дата и время осуществления расчета в формате ГГГГММДДТЧЧММ>
+        t: self.processed_at.gsub(/:\d{2}\z/, '').gsub(/[^0-9T]/, ''),
+        # - s=<сумма расчета в рублях и копейках, разделенных точкой>
+        s: content.check_close.payments.inject(0.0){|d, p| d + p.amount},
+        # - fn=<заводской номер фискального накопителя>
+        fn: fs_number,
+        # - i=<порядковый номер фискального документа, нулями не дополняется>
+        i: document_number, # documentIndex??
+        # - fp=<фискальный признак документа, нулями не дополняется>
+        fp: fp,
+        # - n=<признак расчета>.
+        n: content.raw_type, #??
+      }.map{|k, v| "#{k}=#{v}" }.join('&')
+    end
   end
 
 end