starkbank 2.9.0 → 2.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0dc58311d66ee8900115301e82e6ffdeb7ff667b845a67c7ec42de2d00533ed
-  data.tar.gz: ff84f801db89c14d69e21e287ace3f804c1aed4ca8bd5ea546a5047aec6c221e
+  metadata.gz: 1b3c14df2e63024dc300445af57b93d5d7c03fbe7e40efc79f4b130684982118
+  data.tar.gz: 621f032aa81a0c42d8d8df9491d5c66dfa1938207a9f68920d0f4abe7356cdef
 SHA512:
-  metadata.gz: 4456311856c14f16b8076060fececadb8437b8f379f7ed725a1655381e1dec5ba4f970878c3e1bc12b9569be766e638c8c2667bf29e6ea75d061c2b1b8d50a41
-  data.tar.gz: 5f4293cc4fe23711f6bd1b015771dfb5fb4949803c810fd60eb1f12e1af4361936ff1e6388cebe96e660c6fa8d9e8e4cbe092d885f8282af61024e4fb5b8db57
+  metadata.gz: 8e8317904c404ed9a8051169e0079d705224bbea35cf7c735b3f164c955cf212494c76fb3fbfbc74f0f75b89c7b55194ffac31e0efde0b2002ddb886029930b6
+  data.tar.gz: 6f9c6037b10ae646945aa1163b5e64fb7ac70303767a12976a91ffa167bd8453dd7b0f7b32fece994bc6b976632ee67a5860c24a215135129ea4b535d354cdff

data/lib/corporate_purchase/log.rb

@@ -14,15 +14,17 @@ module StarkBank
     # ## Attributes (return-only):
     # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
     # - purchase [CorporatePurchase]: CorporatePurchase entity to which the log refers to.
+    # - description [string]: purchase descriptions. ex: 'my_description'
     # - corporate_transaction_id [string]: transaction ID related to the CorporateCard.
     # - errors [list of strings]: list of errors linked to this CorporatePurchase event
     # - type [string]: type of the CorporatePurchase event which triggered the log creation. ex: 'approved', 'canceled', 'confirmed', 'denied', 'reversed', 'voided'.
     # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
     class Log < StarkCore::Utils::Resource
-      attr_reader :id, :purchase, :corporate_transaction_id, :errors, :type, :created
-      def initialize(id: nil, purchase: nil, corporate_transaction_id: nil, errors: nil, type: nil, created: nil)
+      attr_reader :id, :purchase, :description, :corporate_transaction_id, :errors, :type, :created
+      def initialize(id: nil, purchase: nil, description: nil, corporate_transaction_id: nil, errors: nil, type: nil, created: nil)
         super(id)
         @purchase = purchase
+        @description = description
         @corporate_transaction_id = corporate_transaction_id
         @errors = errors
         @type = type
@@ -117,6 +119,7 @@ module StarkBank
             Log.new(
               id: json['id'],
               purchase: StarkCore::Utils::API.from_api_json(request_maker, json['purchase']),
+              description: json['description'],
               corporate_transaction_id: json['corporate_transaction_id'],
               errors: json['errors'],
               type: json['type'],

data/lib/corporate_rule/corporaterule.rb

@@ -14,6 +14,7 @@ module StarkBank
   # ## Parameters (optional):
   # - interval [string, default 'lifetime']: interval after which the rule amount counter will be reset to 0. ex: 'instant', 'day', 'week', 'month', 'year' or 'lifetime'
   # - schedule [string, default nil]: schedule time for user to spend. ex: "every monday, wednesday from 00:00 to 23:59 in America/Sao_Paulo"
+  # - purposes [list of string, default []]: list of strings representing the allowed purposes for card purchases, you can use this to restrict ATM withdrawals. ex: ["purchase", "withdrawal"]
   # - currency_code [string, default 'BRL']: code of the currency that the rule amount refers to. ex: 'BRL' or 'USD'
   # - categories [list of MerchantCategories, default nil]: merchant categories accepted by the rule. ex: [MerchantCategory(code='fastFoodRestaurants')]
   # - countries [list of MerchantCountries, default nil]: countries accepted by the rule. ex: [MerchantCountry(code='BRA')]
@@ -25,10 +26,10 @@ module StarkBank
   # - currency_symbol [string]: currency symbol. ex: 'R$'
   # - currency_name [string]: currency name. ex: 'Brazilian Real'
   class CorporateRule < StarkCore::Utils::Resource
-    attr_reader :name, :interval, :amount, :currency_code, :counter_amount, :currency_name, :currency_symbol,
+    attr_reader :name, :interval, :amount, :currency_code, :counter_amount, :schedule, :purposes, :currency_name, :currency_symbol,
                 :categories, :countries, :methods
     def initialize(
-      name:, amount:, id: nil, interval: nil, schedule: nil, currency_code: nil, categories: nil, countries: nil, methods: nil,
+      name:, amount:, id: nil, interval: nil, schedule: nil, purposes: nil, currency_code: nil, categories: nil, countries: nil, methods: nil,
       counter_amount: nil, currency_symbol: nil, currency_name: nil
     )
       super(id)
@@ -36,6 +37,7 @@ module StarkBank
       @amount = amount
       @interval = interval
       @schedule = schedule
+      @purposes = purposes
       @currency_code = currency_code
       @categories = CorporateRule.parse_categories(categories)
       @countries = CorporateRule.parse_categories(countries)
@@ -110,6 +112,7 @@ module StarkBank
             amount: json['amount'],
             interval: json['interval'],
             schedule: json['schedule'],
+            purposes: json['purposes'],
             currency_code: json['currency_code'],
             categories: json['categories'],
             countries: json['countries'],

data/lib/darf_payment/darf_payment.rb

@@ -56,7 +56,7 @@ module StarkBank
       @amount = amount
       @nominal_amount = nominal_amount
       @fee = fee
-      @transaction_ids = @transaction_ids
+      @transaction_ids = transaction_ids
       @updated = StarkCore::Utils::Checks.check_datetime(updated)
       @created = StarkCore::Utils::Checks.check_datetime(created)
     end

data/lib/invoice/invoice.rb

@@ -24,6 +24,7 @@ module StarkBank
   # - 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
+  # - rules [list of Invoice::Rule, default []]: list of Invoice::Rule objects for modifying invoice behavior. ex: [Invoice::Rule(key="allowedTaxIds", value=[ "012.345.678-90", "45.059.493/0001-73" ])]
   # - 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
   #
@@ -42,9 +43,9 @@ module StarkBank
   # - created [DateTime]: creation datetime for the Invoice. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   # - updated [DateTime]: latest update datetime for the Invoice. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   class Invoice < StarkCore::Utils::Resource
-    attr_reader :amount, :tax_id, :name, :due, :expiration, :fine, :interest, :discounts, :tags, :pdf, :link, :descriptions, :nominal_amount, :fine_amount, :interest_amount, :discount_amount, :id, :brcode, :fee, :status, :transaction_ids, :created, :updated
+    attr_reader :amount, :tax_id, :name, :due, :expiration, :fine, :interest, :discounts, :rules, :tags, :pdf, :link, :descriptions, :nominal_amount, :fine_amount, :interest_amount, :discount_amount, :id, :brcode, :fee, :status, :transaction_ids, :created, :updated
     def initialize(
-      amount:, tax_id:, name:, due: nil, expiration: nil, fine: nil, interest: nil, discounts: nil,
+      amount:, tax_id:, name:, due: nil, expiration: nil, fine: nil, interest: nil, discounts: nil, rules: nil,
       tags: nil, pdf: nil, link: nil, descriptions: nil, nominal_amount: nil, fine_amount: nil, interest_amount: nil,
       discount_amount: nil, id: nil, brcode: nil, fee: nil, status: nil, transaction_ids: nil, created: nil, updated: nil
     )
@@ -60,6 +61,7 @@ module StarkBank
       @pdf = pdf
       @link = link
       @descriptions = descriptions
+      @rules = StarkBank::Invoice::Rule.parse_rules(rules)
       @nominal_amount = nominal_amount
       @fine_amount = fine_amount
       @interest_amount = interest_amount
@@ -256,6 +258,7 @@ module StarkBank
             fine: json['fine'],
             interest: json['interest'],
             discounts: json['discounts'],
+            rules: json['rules'],
             tags: json['tags'],
             pdf: json['pdf'],
             link: json['link'],

data/lib/invoice/rule.rb

@@ -0,0 +1,46 @@
+require_relative('../utils/rest')
+
+module StarkBank
+  class Invoice
+    # # Invoice::Rule object
+    #
+    # The Invoice::Rule object modifies the behavior of Invoice objects when passed as an argument upon their creation.
+    #
+    # ## Parameters (required):
+    # - key [string]: Rule to be customized, describes what Invoice behavior will be altered. ex: "allowedTaxIds"
+    # - value [list of string]: Value of the rule. ex: ['012.345.678-90', '45.059.493/0001-73']
+    class Rule < StarkCore::Utils::SubResource
+      attr_reader :key, :value
+      def initialize(key:, value:)
+        @key = key
+        @value = value
+      end
+
+      def self.parse_rules(rules)
+        resource_maker = StarkBank::Invoice::Rule.resource[:resource_maker]
+        return rules if rules.nil?
+
+        parsed_rules = []
+        rules.each do |rule|
+          unless rule.is_a? Rule
+            rule = StarkCore::Utils::API.from_api_json(resource_maker, rule)
+          end
+          parsed_rules << rule
+        end
+        return parsed_rules
+      end
+
+      def self.resource
+      {
+        resource_name: 'Rule',
+        resource_maker: proc { |json|
+          Rule.new(
+            key: json['key'],
+            value: json['value']
+          )
+        }
+      }
+      end
+    end
+  end
+end

data/lib/starkbank.rb

@@ -5,6 +5,7 @@ require_relative('balance/balance')
 require_relative('transaction/transaction')
 require_relative('invoice/invoice')
 require_relative('invoice/log')
+require_relative('invoice/rule')
 require_relative('invoice/payment')
 require_relative('dict_key/dict_key')
 require_relative('dynamic_brcode/dynamic_brcode')
@@ -58,7 +59,7 @@ require_relative('institution/institution')
 module StarkBank
 
   API_VERSION = 'v2'
-  SDK_VERSION = '2.9.0'
+  SDK_VERSION = '2.10.0'
   HOST = "bank"
   public_constant :API_VERSION, :SDK_VERSION, :HOST;
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: starkbank
 version: !ruby/object:Gem::Version
-  version: 2.9.0
+  version: 2.10.0
 platform: ruby
 authors:
 - starkbank
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-05-04 00:00:00.000000000 Z
+date: 2023-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: starkcore
@@ -108,6 +108,7 @@ files:
 - lib/invoice/invoice.rb
 - lib/invoice/log.rb
 - lib/invoice/payment.rb
+- lib/invoice/rule.rb
 - lib/merchant_category/merchantcategory.rb
 - lib/merchant_country/merchantcountry.rb
 - lib/payment_preview/boleto_preview.rb