starkbank 2.1.0.beta1 → 2.1.0.beta2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9da63502c7b5223de6fb3dd146b38f1bbb812ea44db8be8ed224090ed47d730b
-  data.tar.gz: 5a13dfc89a11da6e3283534c63d4a7d168c3d433f6e0817f45cb30c883a6bd9d
+  metadata.gz: 98835d3b25dff96530638da6c2da72f1c8acbe7cb3a5fdb45a25e5506f8cb153
+  data.tar.gz: b298cf063b7b824658c247122c3135302096924332b311d638089573aea432cc
 SHA512:
-  metadata.gz: 52b9461b3caca3b5185afa5818e240f02f2a0de5efe475fdce336f40120b1d46a6a9fec604ceb67bee7221d7f5af89a8b6ce2110aaaf092b903c56d460aa1464
-  data.tar.gz: 3d61fc51d7ddebd01bba544f2d43f8af70e34de78295b505f02e16f9c45832980304038e4397afb43b8c752ec622ccf7ddd1e815e83ae99602619a82a386cd8b
+  metadata.gz: 778c03a3493122b36fc1f1cd521e96c9a45035f5ff4590fc8189c17da4d3be177e890f8de65978e1c16eda9f4d3362e97e018e3f032186a0fe99a011df45e6d8
+  data.tar.gz: 8a992c980902e97809cded32d229f72b4ef8e4c1adc6d2d8e8f67c7eb8a0c7efc5bf7bbc6faec265ad5a741ae0219de1f5d2bb507f501cef9e5c55338e34e5e7

data/lib/boleto/boleto.rb

@@ -58,7 +58,7 @@ module StarkBank
       @city = city
       @state_code = state_code
       @zip_code = zip_code
-      @due = due
+      @due = StarkBank::Utils::Checks.check_date(due)
       @fine = fine
       @interest = interest
       @overdue_limit = overdue_limit

data/lib/boleto_payment/boleto_payment.rb

@@ -37,7 +37,7 @@ module StarkBank
       @description = description
       @line = line
       @bar_code = bar_code
-      @scheduled = StarkBank::Utils::Checks.check_datetime(scheduled)
+      @scheduled = StarkBank::Utils::Checks.check_date(scheduled)
       @tags = tags
       @status = status
       @amount = amount

data/lib/event/event.rb

@@ -8,7 +8,7 @@ require_relative('../utils/checks')
 require_relative('../utils/cache')
 require_relative('../error')
 require_relative('../boleto/log')
-require_relative('../boleto_holmes/log')
+require_relative('../invoice/log')
 require_relative('../transfer/log')
 require_relative('../boleto_payment/log')
 require_relative('../utility_payment/log')
@@ -22,7 +22,7 @@ module StarkBank
   #
   # ## Attributes:
   # - id [string]: unique id returned when the event is created. ex: '5656565656565656'
-  # - log [Log]: a Log object from one the subscription services (TransferLog, BoletoLog, BoletoPaymentlog or UtilityPaymentLog)
+  # - log [Log]: a Log object from one the subscription services (TransferLog, InvoiceLog, BoletoLog, BoletoPaymentlog or UtilityPaymentLog)
   # - created [DateTime]: creation datetime for the notification event. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   # - is_delivered [bool]: true if the event has been successfully delivered to the user url. ex: False
   # - subscription [string]: service that triggered this event. ex: 'transfer', 'utility-payment'
@@ -36,10 +36,10 @@ module StarkBank
 
       resource = {
         'transfer': StarkBank::Transfer::Log.resource,
+        'invoice': StarkBank::Invoice::Log.resource,
         'boleto': StarkBank::Boleto::Log.resource,
         'boleto-payment': StarkBank::BoletoPayment::Log.resource,
-        'utility-payment': StarkBank::UtilityPayment::Log.resource,
-        'boleto-holmes': StarkBank::BoletoHolmes::Log.resource
+        'utility-payment': StarkBank::UtilityPayment::Log.resource
       }[subscription.to_sym]
 
       @log = log

data/lib/invoice/invoice.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+
+module StarkBank
+  # # Invoice object
+  #
+  # When you initialize an Invoice, the entity will not be automatically
+  # sent to the Stark Bank API. The 'create' function sends the objects
+  # to the Stark Bank API and returns the list of created objects.
+  #
+  # ## Parameters (required):
+  # - amount [integer]: Invoice value in cents. Minimum = 0 (any value will be accepted). ex: 1234 (= R$ 12.34)
+  # - tax_id [string]: payer tax ID (CPF or CNPJ) with or without formatting. ex: '01234567890' or '20.018.183/0001-80'
+  # - name [string]: payer name. ex: 'Iron Bank S.A.'
+  #
+  # ## Parameters (optional):
+  # - due [DateTime or string, default today + 2 days]: Invoice due date in UTC ISO format. ex: '2020-10-28T17:59:26.249976+00:00'
+  # - expiration [integer, default 5097600 (59 days)]: time interval in seconds between due date and expiration date. ex 123456789
+  # - fine [float, default 0.0]: Invoice fine for overdue payment in %. ex: 2.5
+  # - interest [float, default 0.0]: Invoice monthly interest for overdue payment in %. ex: 5.2
+  # - discounts [list of hashes, default nil]: list of hashes with 'percentage':float and 'due':DateTime or string pairs
+  # - descriptions [list of hashes, default nil]: list of hashes with 'key':string and 'value':string pairs
+  # - tags [list of strings, default nil]: list of strings for tagging
+  #
+  # ## Attributes (return-only):
+  # - id [string, default nil]: unique id returned when Invoice is created. ex: '5656565656565656'
+  # - nominal_amount [integer, default nil]: Invoice emission value in cents (will change if invoice is updated, but not if it's paid). ex: 400000
+  # - fine_amount [integer, default nil]: Invoice fine value calculated over nominal_amount. ex: 20000
+  # - interest_amount [integer, default nil]: Invoice interest value calculated over nominal_amount. ex: 10000
+  # - discount_amount [integer, default nil]: Invoice discount value calculated over nominal_amount. ex: 3000
+  # - brcode [string, default nil]: BR Code for the Invoice payment. ex: '00020101021226800014br.gov.bcb.pix2558invoice.starkbank.com/f5333103-3279-4db2-8389-5efe335ba93d5204000053039865802BR5913Arya Stark6009Sao Paulo6220051656565656565656566304A9A0'
+  # - status [string, default nil]: current Invoice status. ex: 'registered' or 'paid'
+  # - created [DateTime, default nil]: creation datetime for the Invoice. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - updated [DateTime, default nil]: latest update datetime for the Invoice. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class Invoice < StarkBank::Utils::Resource
+    attr_reader :amount, :due, :tax_id, :name, :expiration, :fine, :interest, :discounts, :tags, :descriptions, :nominal_amount, :fine_amount, :interest_amount, :discount_amount, :id, :brcode, :status, :created, :updated
+    def initialize(
+      amount:, due:, tax_id:, name:, expiration: nil, fine: nil, interest: nil, discounts: nil,
+      tags: nil, descriptions: nil, nominal_amount: nil, fine_amount: nil, interest_amount: nil,
+      discount_amount: nil, id: nil, brcode: nil, status: nil, created: nil, updated: nil
+    )
+      super(id)
+      @amount = amount
+      @due = StarkBank::Utils::Checks.check_datetime(due)
+      @tax_id = tax_id
+      @name = name
+      @expiration = expiration
+      @fine = fine
+      @interest = interest
+      @discounts = discounts
+      @tags = tags
+      @descriptions = descriptions
+      @nominal_amount = nominal_amount
+      @fine_amount = fine_amount
+      @interest_amount = interest_amount
+      @discount_amount = discount_amount
+      @brcode = brcode
+      @status = status
+      @updated = StarkBank::Utils::Checks.check_datetime(updated)
+      @created = StarkBank::Utils::Checks.check_datetime(created)
+    end
+
+    # # Create Invoices
+    #
+    # Send a list of Invoice objects for creation in the Stark Bank API
+    #
+    # ## Parameters (required):
+    # - invoices [list of Invoice objects]: list of Invoice objects to be created in the API
+    #
+    # ## Parameters (optional):
+    # - user [Project object]: Project object. Not necessary if StarkBank.user was set before function call
+    #
+    # ## Return:
+    # - list of Invoice objects with updated attributes
+    def self.create(invoices, user: nil)
+      StarkBank::Utils::Rest.post(entities: invoices, user: user, **resource)
+    end
+
+    # # Retrieve a specific Invoice
+    #
+    # Receive a single Invoice object previously created in the Stark Bank API by passing its id
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - user [Project object]: Project object. Not necessary if StarkBank.user was set before function call
+    #
+    # ## Return:
+    # - Invoice object with updated attributes
+    def self.get(id, user: nil)
+      StarkBank::Utils::Rest.get_id(id: id, user: user, **resource)
+    end
+
+    # # Retrieve Invoices
+    #
+    # Receive a generator of Invoice objects previously created in the Stark Bank API
+    #
+    # ## Parameters (optional):
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+    # - after [Date , DateTime, Time or string, default nil] date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+    # - before [Date, DateTime, Time or string, default nil] date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+    # - status [string, default nil]: filter for status of retrieved objects. ex: 'paid' or 'registered'
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - user [Project object, default nil]: Project object. Not necessary if StarkBank.user was set before function call
+    #
+    # ## Return:
+    # - generator of Invoice objects with updated attributes
+    def self.query(limit: nil, after: nil, before: nil, status: nil, tags: nil, ids: nil, user: nil)
+      after = StarkBank::Utils::Checks.check_date(after)
+      before = StarkBank::Utils::Checks.check_date(before)
+      StarkBank::Utils::Rest.get_list(
+        limit: limit,
+        after: after,
+        before: before,
+        status: status,
+        tags: tags,
+        ids: ids,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Update an Invoice entity
+    #
+    # Update an Invoice entity previously created in the Stark Bank API
+    #
+    # ## Parameters (required):
+    # - id [string]: Invoice unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - user [Project object]: Project object. Not necessary if StarkBank.user was set before function call
+    #
+    # ## Return:
+    # - deleted Invoice object
+    def self.update(id, status: nil, amount: nil, due: nil, expiration: nil, user: nil)
+      StarkBank::Utils::Rest.patch_id(id: id, status: status, amount: amount, due: due, expiration: expiration, user: user, **resource)
+    end
+
+    def self.resource
+      {
+        resource_name: 'Invoice',
+        resource_maker: proc { |json|
+          Invoice.new(
+            id: json['id'],
+            amount: json['amount'],
+            due: json['due'],
+            tax_id: json['tax_id'],
+            name: json['name'],
+            expiration: json['expiration'],
+            fine: json['fine'],
+            interest: json['interest'],
+            discounts: json['discounts'],
+            tags: json['tags'],
+            descriptions: json['descriptions'],
+            nominal_amount: json['nominal_amount'],
+            fine_amount: json['fine_amount'],
+            interest_amount: json['interest_amount'],
+            discount_amount: json['discount_amount'],
+            brcode: json['brcode'],
+            status: json['status'],
+            updated: json['updated'],
+            created: json['created'],
+          )
+        }
+      }
+    end
+  end
+end

data/lib/{boleto_holmes → invoice}/log.rb

@@ -3,28 +3,30 @@
 require_relative('../utils/resource')
 require_relative('../utils/rest')
 require_relative('../utils/checks')
-require_relative('boleto_holmes')
+require_relative('invoice')
 
 module StarkBank
-  class BoletoHolmes
-    # # BoletoHolmes::Log object
+  class Invoice
+    # # Invoice::Log object
     #
-    # Every time a BoletoHolmes entity is modified, a corresponding BoletoHolmes::Log
+    # Every time a Invoice entity is updated, a corresponding Invoice::Log
     # is generated for the entity. This log is never generated by the
     # user, but it can be retrieved to check additional information
-    # on the BoletoHolmes.
+    # on the Invoice.
     #
     # ## Attributes:
     # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
-    # - holmes [BoletoHolmes]: BoletoHolmes entity to which the log refers to.
-    # - type [string]: type of the Boleto event which triggered the log creation. ex: 'registered' or 'paid'
+    # - invoice [Invoice]: Invoice entity to which the log refers to.
+    # - errors [list of strings]: list of errors linked to this Invoice event
+    # - type [string]: type of the Invoice event which triggered the log creation. ex: 'canceled' or 'paid'
     # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
     class Log < StarkBank::Utils::Resource
-      attr_reader :id, :holmes, :type, :created
-      def initialize(id:, holmes:, type:, created:)
+      attr_reader :id, :created, :type, :errors, :invoice
+      def initialize(id:, created:, type:, errors:, invoice:)
         super(id)
-        @holmes = holmes
         @type = type
+        @errors = errors
+        @invoice = invoice
         @created = StarkBank::Utils::Checks.check_datetime(created)
       end
 
@@ -52,13 +54,13 @@ module StarkBank
       # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
       # - after [Date, DateTime, Time or string, default nil] date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
       # - before [Date, DateTime, Time or string, default nil] date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
-      # - types [list of strings, default nil]: filter for log event types. ex: 'paid' or 'registered'
-      # - holmes_ids [list of strings, default nil]: list of BoletoHolmes ids to filter logs. ex: ['5656565656565656', '4545454545454545']
+      # - types [list of strings, default nil]: filter for log event types. ex: 'paid' or 'canceled'
+      # - invoice_ids [list of strings, default nil]: list of Invoice ids to filter logs. ex: ['5656565656565656', '4545454545454545']
       # - user [Project object, default nil]: Project object. Not necessary if StarkBank.user was set before function call
       #
       # ## Return:
       # - list of Log objects with updated attributes
-      def self.query(limit: nil, after: nil, before: nil, types: nil, holmes_ids: nil, user: nil)
+      def self.query(limit: nil, after: nil, before: nil, types: nil, invoice_ids: nil, user: nil)
         after = StarkBank::Utils::Checks.check_date(after)
         before = StarkBank::Utils::Checks.check_date(before)
         StarkBank::Utils::Rest.get_list(
@@ -66,22 +68,23 @@ module StarkBank
           after: after,
           before: before,
           types: types,
-          holmes_ids: holmes_ids,
+          invoice_ids: invoice_ids,
           user: user,
           **resource
         )
       end
 
       def self.resource
-        holmes_maker = StarkBank::BoletoHolmes.resource[:resource_maker]
+        invoice_maker = StarkBank::Invoice.resource[:resource_maker]
         {
-          resource_name: 'BoletoHolmesLog',
+          resource_name: 'InvoiceLog',
           resource_maker: proc { |json|
             Log.new(
               id: json['id'],
-              holmes: StarkBank::Utils::API.from_api_json(holmes_maker, json['holmes']),
+              created: json['created'],
               type: json['type'],
-              created: json['created']
+              errors: json['errors'],
+              invoice: StarkBank::Utils::API.from_api_json(invoice_maker, json['invoice'])
             )
           }
         }

data/lib/transfer/transfer.rb

@@ -40,7 +40,7 @@ module StarkBank
       @bank_code = bank_code
       @branch_code = branch_code
       @account_number = account_number
-      @scheduled = StarkBank::Utils::Checks.check_datetime(scheduled)
+      @scheduled = StarkBank::Utils::Checks.check_date(scheduled)
       @transaction_ids = transaction_ids
       @fee = fee
       @tags = tags

data/lib/utility_payment/utility_payment.rb

@@ -36,7 +36,7 @@ module StarkBank
       @line = line
       @bar_code = bar_code
       @tags = tags
-      @scheduled = StarkBank::Utils::Checks.check_datetime(scheduled)
+      @scheduled = StarkBank::Utils::Checks.check_date(scheduled)
       @amount = amount
       @fee = fee
       @status = status

data/lib/utils/api.rb

@@ -28,21 +28,22 @@ module StarkBank
         hash.each do |key, value|
           next if value.nil?
 
-          value = value.is_a?(Date) || value.is_a?(DateTime) || value.is_a?(Time) ? value.strftime('%Y-%m-%d') : value
+          entity_hash[StarkBank::Utils::Case.snake_to_camel(key)] = parse_value(value)
+        end
+        entity_hash
+      end
 
-          if value.is_a?(Array)
-            list = []
-            value.each do |v|
-              list << (v.is_a?(Hash) ? cast_json_to_api_format(v) : v)
-            end
-            value = list
-          elsif value.is_a?(Hash)
-            value = cast_json_to_api_format(value)
-          end
+      def self.parse_value(value)
+        return value.strftime('%Y-%m-%d') if value.is_a?(Date)
+        return value.strftime('%Y-%m-%dT%H:%M:%S+00:00') if value.is_a?(DateTime) || value.is_a?(Time)
+        return cast_json_to_api_format(value) if value.is_a?(Hash)
+        return value unless value.is_a?(Array)
 
-          entity_hash[StarkBank::Utils::Case.snake_to_camel(key)] = value
+        list = []
+        value.each do |v|
+          list << (v.is_a?(Hash) ? cast_json_to_api_format(v) : v)
         end
-        entity_hash
+        list
       end
 
       def self.from_api_json(resource_maker, json)
@@ -60,12 +61,7 @@ module StarkBank
       end
 
       def self.last_name_plural(resource_name)
-        base = last_name(resource_name)
-
-        return base if base[-1].eql?('s')
-        return "#{base[0...-1]}ies" if base[-1].eql?('y')
-
-        "#{base}s"
+        "#{last_name(resource_name)}s"
       end
 
       def self.last_name(resource_name)

data/lib/utils/checks.rb

@@ -46,7 +46,8 @@ module StarkBank
 
         return Time.new(data.year, data.month, data.day) if data.is_a?(Date)
 
-        check_datetime_string(data)
+        data, _type = check_datetime_string(data)
+        data
       end
 
       def self.check_date(data)
@@ -56,9 +57,9 @@ module StarkBank
 
         return data if data.is_a?(Date)
 
-        data = check_datetime_string(data)
+        data, type = check_datetime_string(data)
 
-        Date.new(data.year, data.month, data.day)
+        type == 'date' ? Date.new(data.year, data.month, data.day) : data
       end
 
       class << self
@@ -68,17 +69,17 @@ module StarkBank
           data = data.to_s
 
           begin
-            return DateTime.strptime(data, '%Y-%m-%dT%H:%M:%S.%L+00:00')
+            return [DateTime.strptime(data, '%Y-%m-%dT%H:%M:%S.%L+00:00'), 'datetime']
           rescue ArgumentError
           end
 
           begin
-            return DateTime.strptime(data, '%Y-%m-%dT%H:%M:%S+00:00')
+            return [DateTime.strptime(data, '%Y-%m-%dT%H:%M:%S+00:00'), 'datetime']
           rescue ArgumentError
           end
 
           begin
-            return DateTime.strptime(data, '%Y-%m-%d')
+            return [DateTime.strptime(data, '%Y-%m-%d'), 'date']
           rescue ArgumentError
             raise(ArgumentError, 'invalid datetime string ' + data)
           end

data/lib/utils/request.rb

@@ -61,7 +61,7 @@ module StarkBank
         req['Access-Time'] = access_time
         req['Access-Signature'] = signature
         req['Content-Type'] = 'application/json'
-        req['User-Agent'] = "Ruby-#{RUBY_VERSION}-SDK-2.0.0"
+        req['User-Agent'] = "Ruby-#{RUBY_VERSION}-SDK-2.1.0.beta2"
         req['Accept-Language'] = language
 
         request = Net::HTTP.start(uri.hostname, use_ssl: true) { |http| http.request(req) }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: starkbank
 version: !ruby/object:Gem::Version
-  version: 2.1.0.beta1
+  version: 2.1.0.beta2
 platform: ruby
 authors:
 - starkbank
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-10-19 00:00:00.000000000 Z
+date: 2020-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: starkbank-ecdsa
@@ -75,12 +75,12 @@ files:
 - lib/balance/balance.rb
 - lib/boleto/boleto.rb
 - lib/boleto/log.rb
-- lib/boleto_holmes/boleto_holmes.rb
-- lib/boleto_holmes/log.rb
 - lib/boleto_payment/boleto_payment.rb
 - lib/boleto_payment/log.rb
 - lib/error.rb
 - lib/event/event.rb
+- lib/invoice/invoice.rb
+- lib/invoice/log.rb
 - lib/key.rb
 - lib/payment_request/payment_request.rb
 - lib/starkbank.rb
@@ -101,7 +101,7 @@ files:
 - lib/utils/rest.rb
 - lib/utils/url.rb
 - lib/webhook/webhook.rb
-homepage: https://github.com/starkbank/sdk-ruby/tree/feature/boleto-holmes
+homepage: https://github.com/starkbank/sdk-ruby
 licenses:
 - MIT
 metadata: {}

data/lib/boleto_holmes/boleto_holmes.rb

@@ -1,121 +0,0 @@
-# frozen_string_literal: true
-
-require_relative('../utils/resource')
-require_relative('../utils/rest')
-require_relative('../utils/checks')
-
-module StarkBank
-  # # BoletoHolmes object
-  #
-  # When you initialize a BoletoHolmes, the entity will not be automatically
-  # created in the Stark Bank API. The 'create' function sends the objects
-  # to the Stark Bank API and returns the list of created objects.
-  #
-  # ## Parameters (required):
-  # - boleto_id [string]: investigated boleto entity ID. ex: '5656565656565656'
-  #
-  # ## Parameters (optional):
-  # - tags [list of strings]: list of strings for tagging
-  #
-  # ## Attributes (return-only):
-  # - id [string, default nil]: unique id returned when holmes is created. ex: '5656565656565656'
-  # - status [string, default nil]: current holmes status. ex: 'solving' or 'solved'
-  # - result [string, default nil]: result of boleto status investigation. ex: 'paid' or 'cancelled'
-  # - created [DateTime, default nil]: creation datetime for the Boleto. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
-  # - updated [DateTime, default nil]: latest update datetime for the holmes. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
-  class BoletoHolmes < StarkBank::Utils::Resource
-    attr_reader :boleto_id, :tags, :id, :status, :result, :created, :updated
-    def initialize(
-      boleto_id:, tags: nil, id: nil, status: nil, result: nil, created: nil, updated: nil
-    )
-      super(id)
-      @boleto_id = boleto_id
-      @tags = tags
-      @status = status
-      @result = result
-      @created = StarkBank::Utils::Checks.check_datetime(created)
-      @updated = StarkBank::Utils::Checks.check_datetime(updated)
-    end
-
-    # # Create BoletoHolmes
-    #
-    # Send a list of BoletoHolmes objects for creation in the Stark Bank API
-    #
-    # ## Parameters (required):
-    # - holmes [list of BoletoHolmes objects]: list of BoletoHolmes objects to be created in the API
-    #
-    # ## Parameters (optional):
-    # - user [Project object]: Project object. Not necessary if StarkBank.user was set before function call
-    #
-    # ## Return:
-    # - list of BoletoHolmes objects with updated attributes
-    def self.create(holmes, user: nil)
-      StarkBank::Utils::Rest.post(entities: holmes, user: user, **resource)
-    end
-
-    # # Retrieve a specific BoletoHolmes
-    #
-    # Receive a single BoletoHolmes object previously created by the Stark Bank API by passing its id
-    #
-    # ## Parameters (required):
-    # - id [string]: object unique id. ex: '5656565656565656'
-    #
-    # ## Parameters (optional):
-    # - user [Project object]: Project object. Not necessary if StarkBank.user was set before function call
-    #
-    # ## Return:
-    # - BoletoHolmes object with updated attributes
-    def self.get(id, user: nil)
-      StarkBank::Utils::Rest.get_id(id: id, user: user, **resource)
-    end
-
-    # # Retrieve BoletoHolmes
-    #
-    # Receive a generator of BoletoHolmes objects previously created in the Stark Bank API
-    #
-    # ## Parameters (optional):
-    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
-    # - after [Date , DateTime, Time or string, default nil] date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
-    # - before [Date, DateTime, Time or string, default nil] date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
-    # - status [string, default nil]: filter for status of retrieved objects. ex: 'solved'
-    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
-    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
-    # - boleto_id [string, default nil]: filter for holmes that investigate a specific boleto by its ID. ex: '5656565656565656'
-    # - user [Project object, default nil]: Project object. Not necessary if StarkBank.user was set before function call
-    #
-    # ## Return:
-    # - generator of BoletoHolmes objects with updated attributes
-    def self.query(limit: nil, after: nil, before: nil, status: nil, tags: nil, ids: nil, boleto_id: nil, user: nil)
-      after = StarkBank::Utils::Checks.check_date(after)
-      before = StarkBank::Utils::Checks.check_date(before)
-      StarkBank::Utils::Rest.get_list(
-        limit: limit,
-        after: after,
-        before: before,
-        status: status,
-        tags: tags,
-        ids: ids,
-        boleto_id: boleto_id,
-        user: user,
-        **resource
-      )
-    end
-
-    def self.resource
-      {
-        resource_name: 'BoletoHolmes',
-        resource_maker: proc { |json|
-          BoletoHolmes.new(
-            boleto_id: json['boleto_id'],
-            tags: json['tags'],
-            id: json['id'],
-            status: json['status'],
-            result: json['result'],
-            created: json['created'],
-            updated: json['updated']
-          )
-        }
-      }
-    end
-  end
-end