starkinfra 0.5.2 → 0.7.0

data/lib/issuing_product/issuing_product.rb

@@ -12,18 +12,20 @@ module StarkInfra
   # ## Attributes (return-only):
   # - id [string]: unique card product number (BIN) registered within the card network. ex: '53810200'
   # - network [string]: card network flag. ex: 'mastercard'
-  # - funding_type [string]: type of funding used for payment. ex: 'credit', 'debit'
+  # - funding_type [string]: type of funding used for payment. Options: 'prepaid', 'credit'.
   # - holder_type [string]: holder type. ex: 'business', 'individual'
   # - code [string]: internal code from card flag informing the product. ex: 'MRW', 'MCO', 'MWB', 'MCS'
+  # - customer_type [string]: same as holder_type. Kept for backward compatibility.
   # - created [DateTime]: creation datetime for the IssuingProduct. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   class IssuingProduct < StarkCore::Utils::Resource
-    attr_reader :id, :network, :funding_type, :holder_type, :code, :created
-    def initialize(id: nil, network: nil, funding_type: nil, holder_type: nil, code: nil, created: nil)
+    attr_reader :id, :network, :funding_type, :holder_type, :code, :customer_type, :created
+    def initialize(id: nil, network: nil, funding_type: nil, holder_type: nil, code: nil, customer_type: nil, created: nil)
       super(id)
       @network = network
       @funding_type = funding_type
       @holder_type = holder_type
       @code = code
+      @customer_type = customer_type
       @created = StarkCore::Utils::Checks.check_datetime(created)
     end
 
@@ -76,6 +78,7 @@ module StarkInfra
             funding_type: json['funding_type'],
             holder_type: json['holder_type'],
             code: json['code'],
+            customer_type: json['customer_type'],
             created: json['created']
           )
         }

data/lib/issuing_purchase/issuing_purchase.rb

@@ -13,7 +13,8 @@ module StarkInfra
   # - product_id [string]: unique card product number (BIN) registered within the card network. ex: "53810200"
   # - card_id [string]: unique id returned when IssuingCard is created. ex: '5656565656565656'
   # - card_ending [string]: last 4 digits of the card number. ex: '1234'
-  # - purpose [string]: purchase purpose. ex: 'purchase'
+  # - purpose [string]: purchase purpose. Options: 'purchase', 'withdrawal', 'verification', 'purchaseRefund', 'cashbackPurchase', 'paymentTransaction'.
+  # - installment_count [integer]: quantity of installments to be confirmed. Minimum = 1. ex: 12
   # - amount [integer]: IssuingPurchase value in cents. Minimum = 0. ex: 1234 (= R$ 12.34)
   # - tax [integer]: IOF amount taxed for international purchases. ex: 1234 (= R$ 12.34)
   # - issuer_amount [integer]: issuer amount. ex: 1234 (= R$ 12.34)
@@ -24,6 +25,7 @@ module StarkInfra
   # - merchant_category_type [string]: merchant category type. ex 'food'
   # - merchant_currency_symbol [string]: merchant currency symbol. ex: '$'
   # - merchant_category_code [string]: merchant category code. ex: 'fastFoodRestaurants'
+  # - merchant_category_number [integer]: MCC number of the merchant category. ex: 5814
   # - merchant_country_code [string]: merchant country code. ex: 'USA'
   # - acquirer_id [string]: acquirer ID. ex: '5656565656565656'
   # - merchant_id [string]: merchant ID. ex: '5656565656565656'
@@ -39,6 +41,7 @@ module StarkInfra
   # - id [string]: unique id returned when IssuingPurchase is created. ex: '5656565656565656'
   # - issuing_transaction_ids [string]: ledger transaction ids linked to this Purchase
   # - status [string]: current IssuingCard status. Options: 'approved', 'canceled', 'denied', 'confirmed', 'voided'
+  # - confirmed [DateTime]: Confirmation datetime. Null until the purchase is confirmed. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   # - description [string]: IssuingPurchase description. ex: 'Office Supplies'
   # - metadata [dictionary object]: dictionary object used to store additional information about the IssuingPurchase object. ex: { authorizationId: 'OjZAqj' }
   # - zip_code [string]: zip code of the merchant location. ex: '02101234'
@@ -51,18 +54,18 @@ module StarkInfra
   # - holder_id [string]: card holder ID. ex: '5656565656565656'
   # - holder_tags [list of strings]: tags of the IssuingHolder responsible for this purchase. ex: ['technology', 'john snow']
   class IssuingPurchase < StarkCore::Utils::Resource
-    attr_reader :id, :holder_name, :product_id, :card_id, :card_ending, :purpose, :amount, :tax, :issuer_amount, :issuer_currency_code,
+    attr_reader :id, :holder_name, :product_id, :card_id, :card_ending, :purpose, :installment_count, :amount, :tax, :issuer_amount, :issuer_currency_code,
                 :issuer_currency_symbol, :merchant_amount, :merchant_currency_code, :merchant_currency_symbol,
-                :merchant_category_code, :merchant_category_type, :merchant_country_code, :acquirer_id, :merchant_id, :merchant_name,
+                :merchant_category_code, :merchant_category_number, :merchant_category_type, :merchant_country_code, :acquirer_id, :merchant_id, :merchant_name,
                 :merchant_fee, :wallet_id, :method_code, :score, :end_to_end_id, :tags,
-                :issuing_transaction_ids, :status, :description, :metadata, :zip_code, :updated, :created, :is_partial_allowed, :card_tags, :holder_id, :holder_tags
+                :issuing_transaction_ids, :status, :confirmed, :description, :metadata, :zip_code, :updated, :created, :is_partial_allowed, :card_tags, :holder_id, :holder_tags
 
     def initialize(
-      id: nil, holder_name: nil, product_id: nil, card_id: nil, card_ending: nil, purpose: nil, amount: nil, tax: nil, issuer_amount: nil,
+      id: nil, holder_name: nil, product_id: nil, card_id: nil, card_ending: nil, purpose: nil, installment_count: nil, amount: nil, tax: nil, issuer_amount: nil,
       issuer_currency_code: nil, issuer_currency_symbol: nil, merchant_amount: nil, merchant_currency_code: nil,
-      merchant_currency_symbol: nil, merchant_category_code: nil, merchant_category_type: nil, merchant_country_code: nil, acquirer_id: nil,
+      merchant_currency_symbol: nil, merchant_category_code: nil, merchant_category_number: nil, merchant_category_type: nil, merchant_country_code: nil, acquirer_id: nil,
       merchant_id: nil, merchant_name: nil, merchant_fee: nil, wallet_id: nil, method_code: nil, score: nil,
-      end_to_end_id: nil, tags: nil, issuing_transaction_ids: nil, status: nil, description: nil, metadata: nil, zip_code: nil, updated: nil, created: nil,
+      end_to_end_id: nil, tags: nil, issuing_transaction_ids: nil, status: nil, confirmed: nil, description: nil, metadata: nil, zip_code: nil, updated: nil, created: nil,
       is_partial_allowed: nil, card_tags:nil, holder_id: nil, holder_tags:nil
     )
       super(id)
@@ -71,6 +74,7 @@ module StarkInfra
       @card_id = card_id
       @card_ending = card_ending
       @purpose = purpose
+      @installment_count = installment_count
       @amount = amount
       @tax = tax
       @issuer_amount = issuer_amount
@@ -80,6 +84,7 @@ module StarkInfra
       @merchant_currency_code = merchant_currency_code
       @merchant_currency_symbol = merchant_currency_symbol
       @merchant_category_code = merchant_category_code
+      @merchant_category_number = merchant_category_number
       @merchant_category_type = merchant_category_type
       @merchant_country_code = merchant_country_code
       @acquirer_id = acquirer_id
@@ -93,6 +98,7 @@ module StarkInfra
       @tags = tags
       @issuing_transaction_ids = issuing_transaction_ids
       @status = status
+      @confirmed = StarkCore::Utils::Checks.check_datetime(confirmed)
       @description = description
       @metadata = metadata
       @zip_code = zip_code
@@ -195,6 +201,30 @@ module StarkInfra
       )
     end
 
+    # # Update IssuingPurchase entity
+    #
+    # Update an IssuingPurchase by passing id.
+    #
+    # ## Parameters (required):
+    # - id [string]: IssuingPurchase id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - tags [list of strings, default nil]: list of strings for tagging. ex: ['tony', 'stark']
+    # - description [string, default nil]: new IssuingPurchase description. Max of 140 characters. ex: 'Office Supplies'
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - target IssuingPurchase with updated attributes
+    def self.update(id, description: nil, tags: nil, user: nil)
+      StarkInfra::Utils::Rest.patch_id(
+        id: id,
+        description: description,
+        tags: tags,
+        user: user,
+        **resource
+      )
+    end
+
     # # Create a single verified IssuingPurchase authorization request from a content string
     #
     # Use this method to parse and verify the authenticity of the authorization request received at the informed endpoint.
@@ -238,7 +268,7 @@ module StarkInfra
     # ## Return:
     # - Dumped JSON string that must be returned to us on the IssuingPurchase request
     def self.response(
-      status:, reason:, amount:, tags:
+      status:, reason: nil, amount: nil, tags: nil
     )
       params = {
         'status': status,
@@ -261,6 +291,7 @@ module StarkInfra
             card_id: json['card_id'],
             card_ending: json['card_ending'],
             purpose: json['purpose'],
+            installment_count: json['installment_count'],
             amount: json['amount'],
             tax: json['tax'],
             issuer_amount: json['issuer_amount'],
@@ -270,6 +301,7 @@ module StarkInfra
             merchant_currency_code: json['merchant_currency_code'],
             merchant_currency_symbol: json['merchant_currency_symbol'],
             merchant_category_code: json['merchant_category_code'],
+            merchant_category_number: json['merchant_category_number'],
             merchant_category_type: json['merchant_category_type'],
             merchant_country_code: json['merchant_country_code'],
             acquirer_id: json['acquirer_id'],
@@ -283,6 +315,7 @@ module StarkInfra
             tags: json['tags'],
             issuing_transaction_ids: json['issuing_transaction_ids'],
             status: json['status'],
+            confirmed: json['confirmed'],
             description: json['description'],
             metadata: json['metadata'],
             zip_code: json['zip_code'],

data/lib/issuing_restock/issuing_restock.rb

@@ -18,7 +18,7 @@ module StarkInfra
   #
   # ## Attributes (return-only):
   # - id [string]: unique id returned when IssuingRestock is created. ex: '5656565656565656'
-  # - status [string]: current IssuingRestock status. ex: "created", "processing", "confirmed"
+  # - status [string]: current IssuingRestock status. Options: 'created', 'processing', 'confirmed', 'canceled'.
   # - updated [DateTime]: latest update datetime for the IssuingRestock. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   # - created [DateTime]: creation datetime for the IssuingRestock. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   class IssuingRestock < StarkCore::Utils::Resource
@@ -37,7 +37,8 @@ module StarkInfra
 
     # # Create IssuingRestocks
     #
-    # Send a list of IssuingRestock objects for creation in the Stark Infra API
+    # Send a list of IssuingRestock objects for creation in the Stark Infra API. Use this method to create up
+    # to 100 new IssuingRestocks at a time.
     #
     # ## Parameters (required):
     # - restocks [list of IssuingRestock objects]: list of IssuingRestock objects to be created in the API

data/lib/issuing_rule/issuing_rule.rb

@@ -24,12 +24,14 @@ module StarkInfra
   # - counter_amount [integer]: current rule spent amount. ex: 1000
   # - currency_symbol [string]: currency symbol. ex: 'R$'
   # - currency_name [string]: currency name. ex: 'Brazilian Real'
+  # - schedule [string]: Optional schedule dictating when the rule can be used. Some examples: 'everyday from 09:00 to 18:00 in America/Sao_Paulo' - every day, 09:00-18:00 Sao Paulo time; 'every monday, wednesday, friday from 08:00 to 12:00 in America/Sao_Paulo' - only those weekdays, mornings; 'every saturday, sunday' - weekends, all day, in UTC
+  # - purposes [list of strings]: Optional list of transaction purposes the rule applies to. Options: 'purchase', 'withdrawal', 'verification'. The rule then limits only purchases of those purposes; omit it to allow any purposes. Example: ['purchase', 'verification'] if you want us to automatically deny withdrawal.
   class IssuingRule < StarkCore::Utils::Resource
     attr_reader :name, :interval, :amount, :currency_code, :counter_amount, :currency_name, :currency_symbol,
-                :categories, :countries, :methods
+                :categories, :countries, :methods, :schedule, :purposes
     def initialize(
       name:, amount:, id: nil, interval: nil, currency_code: nil, categories: nil, countries: nil, methods: nil,
-      counter_amount: nil, currency_symbol: nil, currency_name: nil
+      counter_amount: nil, currency_symbol: nil, currency_name: nil, schedule: nil, purposes: nil
     )
       super(id)
       @name = name
@@ -42,8 +44,19 @@ module StarkInfra
       @counter_amount = counter_amount
       @currency_symbol = currency_symbol
       @currency_name = currency_name
+      @schedule = schedule
+      @purposes = purposes
     end
 
+    # # Parse MerchantCategories
+    #
+    # Converts a list of hashes into a list of MerchantCategory objects.
+    #
+    # ## Parameters (required):
+    # - categories [list of hashes]: list to be parsed.
+    #
+    # ## Return:
+    # - list of parsed MerchantCategory objects
     def self.parse_categories(categories)
       resource_maker = StarkInfra::MerchantCategory.resource[:resource_maker]
       return categories if categories.nil?
@@ -58,6 +71,15 @@ module StarkInfra
       parsed_categories
     end
 
+    # # Parse MerchantCountries
+    #
+    # Converts a list of hashes into a list of MerchantCountry objects.
+    #
+    # ## Parameters (required):
+    # - countries [list of hashes]: list to be parsed.
+    #
+    # ## Return:
+    # - list of parsed MerchantCountry objects
     def self.parse_countries(countries)
       resource_maker = StarkInfra::MerchantCountry.resource[:resource_maker]
       return countries if countries.nil?
@@ -72,6 +94,15 @@ module StarkInfra
       parsed_countries
     end
 
+    # # Parse CardMethods
+    #
+    # Converts a list of hashes into a list of CardMethod objects.
+    #
+    # ## Parameters (required):
+    # - methods [list of hashes]: list to be parsed.
+    #
+    # ## Return:
+    # - list of parsed CardMethod objects
     def self.parse_methods(methods)
       resource_maker = StarkInfra::CardMethod.resource[:resource_maker]
       return methods if methods.nil?
@@ -86,6 +117,15 @@ module StarkInfra
       parsed_methods
     end
 
+    # # Parse IssuingRules
+    #
+    # Converts a list of hashes into a list of IssuingRule objects.
+    #
+    # ## Parameters (required):
+    # - rules [list of hashes]: list to be parsed.
+    #
+    # ## Return:
+    # - list of parsed IssuingRule objects
     def self.parse_rules(rules)
       rule_maker = StarkInfra::IssuingRule.resource[:resource_maker]
       return rules if rules.nil?
@@ -114,7 +154,9 @@ module StarkInfra
             methods: json['methods'],
             counter_amount: json['counter_amount'],
             currency_symbol: json['currency_symbol'],
-            currency_name: json['currency_name']
+            currency_name: json['currency_name'],
+            schedule: json['schedule'],
+            purposes: json['purposes']
           )
         }
       }

data/lib/issuing_stock/issuing_stock.rb

@@ -13,17 +13,19 @@ module StarkInfra
   # - balance [integer]: [EXPANDABLE] current stock balance. ex: 1000
   # - design_id [string]: IssuingDesign unique id. ex: "5656565656565656"
   # - embosser_id [string]: Embosser unique id. ex: "5656565656565656"
+  # - embosser_name [string]: Name of the embosser that holds this stock
   # - updated [DateTime]: latest update datetime for the IssuingStock. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   # - created [DateTime]: creation datetime for the IssuingStock. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   class IssuingStock < StarkCore::Utils::Resource
-    attr_reader :id, :balance, :design_id, :embosser_id, :updated, :created
+    attr_reader :id, :balance, :design_id, :embosser_id, :embosser_name, :updated, :created
     def initialize(
-      id: nil, balance: nil, design_id: nil, embosser_id: nil, updated: nil, created: nil 
+      id: nil, balance: nil, design_id: nil, embosser_id: nil, embosser_name: nil, updated: nil, created: nil
     )
       super(id)
       @balance = balance
       @design_id = design_id
       @embosser_id = embosser_id
+      @embosser_name = embosser_name
       @updated = StarkCore::Utils::Checks.check_datetime(updated)
       @created = StarkCore::Utils::Checks.check_datetime(created)
     end
@@ -127,6 +129,7 @@ module StarkInfra
             balance: json['balance'],
             design_id: json['design_id'],
             embosser_id: json['embosser_id'],
+            embosser_name: json['embosser_name'],
             updated: json['updated'],
             created: json['created']
           )

data/lib/issuing_stock_rule/issuing_stock_rule.rb

@@ -0,0 +1,214 @@
+# frozen_string_literal: true
+
+require('starkcore')
+require_relative('../utils/rest')
+
+module StarkInfra
+  # # IssuingStockRule object
+  #
+  # The IssuingStockRule object displays the notification rules attached to an IssuingStock.
+  # When the linked stock balance reaches the minimum_balance, the recipients listed in
+  # emails and phones are notified. Each IssuingStock can have only one active IssuingStockRule at a time.
+  #
+  # ## Parameters (required):
+  # - minimum_balance [integer]: stock balance threshold that triggers a notification. ex: 10000
+  # - stock_id [string]: IssuingStock unique id the rule is linked to. ex: '5136459887542272'
+  #
+  # ## Parameters (optional):
+  # - tags [list of strings, default nil]: list of strings for tagging. ex: ['card', 'corporate']
+  # - emails [list of up to 10 strings, default nil]: emails notified when the stock reaches the minimum balance. ex: ['john.doe@enterprise.com']
+  # - phones [list of up to 10 strings, default nil]: phones notified when the stock reaches the minimum balance. ex: ['+5511912345678']
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when IssuingStockRule is created. ex: '5664445921492992'
+  # - status [string]: current IssuingStockRule status. ex: 'active', 'canceled'
+  # - created [DateTime]: creation datetime for the IssuingStockRule. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - updated [DateTime]: latest update datetime for the IssuingStockRule. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class IssuingStockRule < StarkCore::Utils::Resource
+    attr_reader :minimum_balance, :stock_id, :tags, :emails, :phones, :id, :status, :created, :updated
+    def initialize(
+      minimum_balance:, stock_id:, tags: nil, emails: nil, phones: nil,
+      id: nil, status: nil, created: nil, updated: nil
+    )
+      super(id)
+      @minimum_balance = minimum_balance
+      @stock_id = stock_id
+      @tags = tags
+      @emails = emails
+      @phones = phones
+      @status = status
+      @created = StarkCore::Utils::Checks.check_datetime(created)
+      @updated = StarkCore::Utils::Checks.check_datetime(updated)
+    end
+
+    # # Create IssuingStockRules
+    #
+    # Send a list of IssuingStockRule objects for creation in the Stark Infra API. At least one of emails or
+    # phones must be informed per rule.
+    #
+    # ## Parameters (required):
+    # - rules [list of IssuingStockRule objects]: list of IssuingStockRule objects to be created in the API
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of IssuingStockRule objects with updated attributes
+    def self.create(rules:, user: nil)
+      StarkInfra::Utils::Rest.post(entities: rules, user: user, **resource)
+    end
+
+    # # Retrieve a specific IssuingStockRule
+    #
+    # Receive a single IssuingStockRule object previously created in the Stark Infra API by its id
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: '5664445921492992'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - IssuingStockRule object with updated attributes
+    def self.get(id, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+    end
+
+    # # Retrieve IssuingStockRules
+    #
+    # Receive a generator of IssuingStockRule objects previously created in the Stark Infra API
+    #
+    # ## Parameters (optional):
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+    # - after [Date or string, default nil]: date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+    # - before [Date or string, default nil]: date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+    # - status [list of strings, default nil]: filter for status of retrieved objects. ex: ['active', 'canceled']
+    # - stock_ids [list of strings, default nil]: list of stock_ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['card', 'corporate']
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of IssuingStockRule objects with updated attributes
+    def self.query(
+      limit: nil, after: nil, before: nil, status: nil, stock_ids: nil,
+      ids: nil, tags: nil, user: nil
+    )
+      after = StarkCore::Utils::Checks.check_date(after)
+      before = StarkCore::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_stream(
+        limit: limit,
+        after: after,
+        before: before,
+        status: status,
+        stock_ids: stock_ids,
+        ids: ids,
+        tags: tags,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged IssuingStockRules
+    #
+    # Receive a list of up to 100 IssuingStockRule objects previously created in the Stark Infra API and the cursor to the next page.
+    # Use this function instead of query if you want to manually page your requests.
+    #
+    # ## Parameters (optional):
+    # - cursor [string, default nil]: cursor returned on the previous page function call.
+    # - limit [integer, default 100]: maximum number of objects to be retrieved. Max = 100. ex: 35
+    # - after [Date or string, default nil]: date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+    # - before [Date or string, default nil]: date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+    # - status [list of strings, default nil]: filter for status of retrieved objects. ex: ['active', 'canceled']
+    # - stock_ids [list of strings, default nil]: list of stock_ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['card', 'corporate']
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of IssuingStockRule objects with updated attributes
+    # - cursor to retrieve the next page of IssuingStockRule objects
+    def self.page(
+      cursor: nil, limit: nil, after: nil, before: nil, status: nil, stock_ids: nil,
+      ids: nil, tags: nil, user: nil
+    )
+      after = StarkCore::Utils::Checks.check_date(after)
+      before = StarkCore::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_page(
+        cursor: cursor,
+        limit: limit,
+        after: after,
+        before: before,
+        status: status,
+        stock_ids: stock_ids,
+        ids: ids,
+        tags: tags,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Update IssuingStockRule entity
+    #
+    # Update an IssuingStockRule by passing id.
+    #
+    # ## Parameters (required):
+    # - id [string]: IssuingStockRule unique id. ex: '5664445921492992'
+    #
+    # ## Parameters (optional):
+    # - minimum_balance [integer, default nil]: new stock balance threshold that triggers a notification. ex: 20000
+    # - tags [list of strings, default nil]: new list of strings for tagging. ex: ['card', 'corporate']
+    # - emails [list of strings, default nil]: new list of emails notified when the stock reaches the minimum balance. ex: ['john.doe@enterprise.com']
+    # - phones [list of strings, default nil]: new list of phones notified when the stock reaches the minimum balance. ex: ['+5511912345678']
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - target IssuingStockRule with updated attributes
+    def self.update(id, minimum_balance: nil, tags: nil, emails: nil, phones: nil, user: nil)
+      StarkInfra::Utils::Rest.patch_id(
+        id: id,
+        minimum_balance: minimum_balance,
+        tags: tags,
+        emails: emails,
+        phones: phones,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Cancel an IssuingStockRule entity
+    #
+    # Cancel an IssuingStockRule entity previously created in the Stark Infra API. This action is irreversible.
+    #
+    # ## Parameters (required):
+    # - id [string]: IssuingStockRule unique id. ex: '5664445921492992'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - canceled IssuingStockRule object
+    def self.cancel(id, user: nil)
+      StarkInfra::Utils::Rest.delete_id(id: id, user: user, **resource)
+    end
+
+    def self.resource
+      {
+        resource_name: 'IssuingStockRule',
+        resource_maker: proc { |json|
+          IssuingStockRule.new(
+            minimum_balance: json['minimum_balance'],
+            stock_id: json['stock_id'],
+            tags: json['tags'],
+            emails: json['emails'],
+            phones: json['phones'],
+            id: json['id'],
+            status: json['status'],
+            created: json['created'],
+            updated: json['updated']
+          )
+        }
+      }
+    end
+  end
+end