starkinfra 0.2.0 → 0.4.0

data/lib/issuingcard/issuingcard.rb

@@ -10,10 +10,6 @@ module StarkInfra
   # The IssuingCard object displays the information of the cards created in your Workspace.
   # Sensitive information will only be returned when the 'expand' parameter is used, to avoid security concerns.
   #
-  # When you initialize a IssuingCard, the entity will not be automatically
-  # created in the Stark Infra API. The 'create' function sends the objects
-  # to the Stark Infra API and returns the created object.
-  #
   # ## Parameters (required):
   # - holder_name [string]: card holder name. ex: 'Tony Stark'
   # - holder_tax_id [string]: card holder tax ID. ex: '012.345.678-90'
@@ -114,14 +110,14 @@ module StarkInfra
     #
     # ## Parameters (optional):
     # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
-    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
-    # - 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)
+    # - 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', 'blocked', 'canceled', 'expired']
     # - types [list of strings, default nil]: card type. ex: ['virtual']
     # - holder_ids [list of strings, default nil]: card holder IDs. ex: ['5656565656565656', '4545454545454545']
     # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
     # - expand [list of strings, default nil]: fields to expand information. ex: ['rules', 'security_code', 'number', 'expiration']
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
     # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
     #
     # ## Return:
@@ -147,14 +143,15 @@ module StarkInfra
 
     # # Retrieve paged IssuingCards
     #
-    # Receive a list of IssuingCards objects previously created in the Stark Infra API and the cursor to the next page.
+    # Receive a list of up to 100 IssuingCard 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 identities.
     #
     # ## 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
     # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
-    # - 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)
+    # - 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', 'blocked', 'canceled', 'expired']
     # - types [list of strings, default nil]: card type. ex: ['virtual']
     # - holder_ids [list of strings, default nil]: card holder IDs. ex: ['5656565656565656', '4545454545454545']
@@ -163,7 +160,7 @@ module StarkInfra
     # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
     #
     # ## Return:
-    # - list of IssuingCards objects with updated attributes
+    # - list of IssuingCard objects with updated attributes
     # - cursor to retrieve the next page of IssuingCards objects
     def self.page(cursor: nil, limit: nil, ids: nil, after: nil, before: nil, status: nil, types: nil, holder_ids: nil,
                   tags: nil, expand: nil, user: nil)
@@ -194,6 +191,7 @@ module StarkInfra
     #
     # ## Parameters (optional):
     # - status [string, default nil]: You may block the IssuingCard by passing 'blocked' or activate by passing 'active' in the status
+    # - pin [string, default nil]: You may unlock your physical card by passing its PIN. This is also the PIN you use to authorize a purhcase.
     # - display_name [string, default nil]: card displayed name
     # - rules [list of IssuingRule objects, default nil]: [EXPANDABLE] list of card spending rules.
     # - tags [list of strings, default nil]: list of strings for tagging
@@ -201,10 +199,11 @@ module StarkInfra
     #
     # ## Return:
     # - target IssuingCard with updated attributes
-    def self.update(id, status: nil, display_name: nil, rules: nil, tags: nil, user: nil)
+    def self.update(id, status: nil, display_name: nil, pin: nil, rules: nil, tags: nil, user: nil)
       StarkInfra::Utils::Rest.patch_id(
         id: id,
         status: status,
+        pin: pin,
         display_name: display_name,
         rules: rules,
         tags: tags,

data/lib/issuingcard/log.rb

@@ -9,14 +9,14 @@ module StarkInfra
   class IssuingCard
     # # IssuingCard::Log object
     #
-    # Every time an IssuingCard entity is updated, a corresponding issuing card.Log is generated for the entity. This log
+    # Every time an IssuingCard entity is updated, a corresponding IssuingCard::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 IssuingCard.
     #
-    # ## Attributes:
+    # ## Attributes (return-only):
     # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
-    # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
-    # - type [string]: type of the IssuingCard event which triggered the log creation. ex: 'processing' or 'success'
     # - card [IssuingCard]: IssuingCard entity to which the log refers to.
+    # - type [string]: type of the IssuingCard event which triggered the log creation. ex: 'processing' or 'success'
+    # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
     class Log < StarkInfra::Utils::Resource
       attr_reader :id, :created, :type, :card
       def initialize(id:, created:, type:, card:)
@@ -26,9 +26,9 @@ module StarkInfra
         @created = StarkInfra::Utils::Checks.check_datetime(created)
       end
 
-      # # Retrieve a specific Log
+      # # Retrieve a specific IssuingCard::Log
       #
-      # Receive a single Log object previously created by the Stark Infra API by passing its id
+      # Receive a single IssuingCard::Log object previously created by the Stark Infra API by passing its id
       #
       # ## Parameters (required):
       # - id [string]: object unique id. ex: '5656565656565656'
@@ -37,26 +37,26 @@ module StarkInfra
       # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
       #
       # ## Return:
-      # - Log object with updated attributes
+      # - IssuingCard::Log object with updated attributes
       def self.get(id, user: nil)
         StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
       end
 
-      # # Retrieve Logs
+      # # Retrieve IssuingCard::Logs
       #
-      # Receive a generator of Log objects previously created in the Stark Infra API
+      # Receive a generator of IssuingCard::Log objects previously created in the Stark Infra API
       #
       # ## Parameters (optional):
-      # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
       # - 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)
+      # - 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)
       # - types [list of strings, default nil]: filter for log event types. ex: ['blocked', 'canceled', 'created', 'expired', 'unblocked', 'updated']
       # - card_ids [list of strings, default nil]: list of IssuingCard ids to filter logs. ex: ['5656565656565656', '4545454545454545']
+      # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
       # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
       #
       # ## Return:
-      # - generator of Log objects with updated attributes
+      # - generator of IssuingCard::Log objects with updated attributes
       def self.query(limit: nil, after: nil, before: nil, types: nil, card_ids: nil, user: nil)
         after = StarkInfra::Utils::Checks.check_date(after)
         before = StarkInfra::Utils::Checks.check_date(before)
@@ -71,23 +71,23 @@ module StarkInfra
         )
       end
 
-      # # Retrieve paged Logs
+      # # Retrieve paged IssuingCard::Logs
       #
-      # Receive a list of up to 100 Log objects previously created in the Stark Infra API and the cursor to the next page.
+      # Receive a list of up to 100 IssuingCard::Log 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 logs.
       #
       # ## Parameters (optional):
       # - cursor [string, default nil]: cursor returned on the previous page function call
-      # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
       # - 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)
+      # - 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)
       # - types [list of strings, default nil]: filter for log event types. ex: ['blocked', 'canceled', 'created', 'expired', 'unblocked', 'updated']
       # - card_ids [list of strings, default nil]: list of IssuingCard ids to filter logs. ex: ['5656565656565656', '4545454545454545']
+      # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
       # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
       #
       # ## Return:
-      # - list of Log objects with updated attributes
+      # - list of IssuingCard::Log objects with updated attributes
       # - Cursor to retrieve the next page of Log objects
       def self.page(cursor: nil, limit: nil, after: nil, before: nil, types: nil, card_ids: nil, user: nil)
         after = StarkInfra::Utils::Checks.check_date(after)

data/lib/issuingdesign/issuingdesign.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+require_relative('../utils/resource')
+
+module StarkInfra
+  # # IssuingDesign object
+  #
+  # The IssuingDesign object displays information on the card and card package designs available to your Workspace.
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when IssuingDesign is created. ex: "5656565656565656"
+  # - name [string]: card or package design name. ex: "stark-plastic-dark-001"
+  # - embosser_ids [list of strings]: list of embosser unique ids. ex: ["5136459887542272", "5136459887542273"]
+  # - type [string]: card or package design type. Options: "card", "envelope"
+  # - updated [DateTime]: latest update datetime for the IssuingDesign. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - created [DateTime]: creation datetime for the IssuingDesign. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class IssuingDesign < StarkInfra::Utils::Resource
+    attr_reader :id, :name, :embosser_ids, :type, :updated, :created
+    def initialize(
+      id: nil, name: nil, embosser_ids: nil, type: nil, updated: nil, created: nil
+    )
+      super(id)
+      @name = name
+      @embosser_ids = embosser_ids
+      @type = type
+      @updated = StarkInfra::Utils::Checks.check_datetime(updated)
+      @created = StarkInfra::Utils::Checks.check_datetime(created)
+    end
+
+    # # Retrieve a specific IssuingDesign
+    #
+    # Receive a single IssuingDesign object previously created in the Stark Infra API by its id
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - IssuingDesign object with updated attributes
+    def self.get(id, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+    end
+
+    # # Retrieve IssuingDesigns
+    #
+    # Receive a generator of IssuingDesigns 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
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ["5656565656565656", "4545454545454545"]
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of IssuingDesigns objects with updated attributes
+    def self.query(limit: nil, ids: nil, user: nil)
+      StarkInfra::Utils::Rest.get_stream(
+        limit: limit,
+        ids: ids,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged IssuingDesigns
+    #
+    # Receive a list of up to 100 IssuingDesign 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
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ["5656565656565656", "4545454545454545"]
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - list of IssuingDesign objects with updated attributes
+    # - cursor to retrieve the next page of IssuingDesign objects
+    def self.page(cursor: nil, limit: nil, status: nil, user: nil)
+      StarkInfra::Utils::Rest.get_page(
+        cursor: cursor,
+        limit: limit,
+        status: status,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve a specific IssuingDesign pdf file
+    #
+    # Receive a single IssuingDesign pdf file generated in the Stark Infra API by its id.
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - IssuingDesign pdf file
+    def self.pdf(id, user: nil)
+      StarkInfra::Utils::Rest.get_content(id: id, user: user, sub_resource_name: 'pdf', **resource)
+    end
+
+    def self.parse_designs(designs)
+      resource_maker = StarkInfra::IssuingDesign.resource[:resource_maker]
+      return designs if designs.nil?
+
+      parsed_designs = []
+      designs.each do |design|
+        unless design.is_a? IssuingDesign
+          design = StarkInfra::Utils::API.from_api_json(resource_maker, design)
+        end
+        parsed_designs << design
+      end
+      parsed_designs
+    end
+
+    def self.resource
+      {
+        resource_name: 'IssuingDesign',
+        resource_maker: proc { |json|
+          IssuingDesign.new(
+            id: json['id'],
+            name: json['name'],
+            embosser_ids: json['embosser_ids'],
+            type: json['type'],
+            updated: json['updated'],
+            created: json['created']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/issuingembossingkit/issuingembossingkit.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+require_relative('../utils/resource')
+
+module StarkInfra
+  # # IssuingEmbossingKit object
+  #
+  # The IssuingEmbossingKit object displays information on the embossing kits available to your Workspace.
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when IssuingEmbossingKit is created. ex: "5656565656565656"
+  # - name [string]: card or package design name. ex: "stark-plastic-dark-001"
+  # - designs [list of IssuingDesign objects]: list of IssuingDesign objects. ex: [IssuingDesign(), IssuingDesign()]
+  # - updated [DateTime]: latest update datetime for the IssuingEmbossingKit. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - created [DateTime]: creation datetime for the IssuingEmbossingKit. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class IssuingEmbossingKit < StarkInfra::Utils::Resource
+    attr_reader :id, :name, :designs, :updated, :created
+    def initialize(
+      id: nil, name: nil, designs: nil, updated: nil, created: nil
+    )
+      super(id)
+      @name = name
+      @designs = IssuingDesign::parse_designs(designs)
+      @updated = StarkInfra::Utils::Checks.check_datetime(updated)
+      @created = StarkInfra::Utils::Checks.check_datetime(created)
+    end
+
+    # # Retrieve a specific IssuingEmbossingKit
+    #
+    # Receive a single IssuingEmbossingKit object previously created in the Stark Infra API by its id
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - IssuingEmbossingKit object with updated attributes
+    def self.get(id, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+    end
+
+    # # Retrieve IssuingEmbossingKits
+    #
+    # Receive a generator of IssuingEmbossingKits 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: ["created", "processing", "success", "failed"]
+    # - design_ids [list of string, default nil]: list of design_ids to filter retrieved objects. ex: ["5656565656565656", "4545454545454545"]
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ["5656565656565656", "4545454545454545"]
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of IssuingEmbossingKits objects with updated attributes
+    def self.query(limit: nil, after: nil, before: nil, status: nil, design_ids: nil, ids: nil, user: nil)
+      StarkInfra::Utils::Rest.get_stream(
+        limit: limit,
+        after: after,
+        before: before,
+        status: status,
+        design_ids: design_ids,
+        ids: ids,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged IssuingEmbossingKits
+    #
+    # Receive a list of up to 100 IssuingEmbossingKit 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: ["created", "processing", "success", "failed"]
+    # - design_ids [list of string, default nil]: list of design_ids to filter retrieved objects. ex: ["5656565656565656", "4545454545454545"]
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ["5656565656565656", "4545454545454545"]
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - list of IssuingEmbossingKit objects with updated attributes
+    # - cursor to retrieve the next page of IssuingEmbossingKit objects
+    def self.page(cursor: nil, limit: nil, after: nil, before: nil, status: nil, design_ids: nil, ids: nil, user: nil)
+      StarkInfra::Utils::Rest.get_page(
+        cursor: cursor,
+        limit: limit,
+        after: after,
+        before: before,
+        status: status,
+        design_ids: design_ids,
+        ids: ids,
+        user: user,
+        **resource
+      )
+    end
+
+    def self.resource
+      {
+        resource_name: 'IssuingEmbossingKit',
+        resource_maker: proc { |json|
+          IssuingEmbossingKit.new(
+            id: json['id'],
+            name: json['name'],
+            designs: json['designs'],
+            updated: json['updated'],
+            created: json['created']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/issuingembossingrequest/issuingembossingrequest.rb

@@ -0,0 +1,210 @@
+# frozen_string_literal: true
+
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+require_relative('../utils/resource')
+
+module StarkInfra
+  # # IssuingEmbossingRequest object
+  #
+  # The IssuingEmbossingRequest object displays the information of embossing requests in your Workspace.
+  #
+  # ## Parameters (required):
+  # - card_id [string]: id of the IssuingCard to be embossed. ex "5656565656565656"
+  # - kit_id [string]: card embossing kit id. ex "5656565656565656"
+  # - display_name_1 [string]: card displayed name. ex: "ANTHONY STARK"
+  # - shipping_city [string]: shipping city. ex: "NEW YORK"
+  # - shipping_country_code [string]: shipping country code. ex: "US"
+  # - shipping_district [string]: shipping district. ex: "NY"
+  # - shipping_state_code [string]: shipping state code. ex: "NY"
+  # - shipping_street_line_1 [string]: shipping main address. ex: "AVENUE OF THE AMERICAS"
+  # - shipping_street_line_2 [string]: shipping address complement. ex: "Apt. 6"
+  # - shipping_service [string]: shipping service. ex: "loggi"
+  # - shipping_tracking_number [string]: shipping tracking number. ex: "5656565656565656"
+  # - shipping_zip_code [string]: shipping zip code. ex: "12345-678"
+  #
+  # ## Parameters (optional):
+  # - embosser_id [string, default nil]: id of the card embosser. ex: "5656565656565656"
+  # - display_name_2 [string, default nil]: card displayed name. ex: "IT Services"
+  # - display_name_3 [string, default nil]: card displayed name. ex: "StarkBank S.A."
+  # - shipping_phone [string, deafult nil]: shipping phone. ex: "+5511999999999"
+  # - tags [list of strings, default nil]: list of strings for tagging. ex: ["card", "corporate"]
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when IssuingEmbossingRequest is created. ex: "5656565656565656"
+  # - fee [integer]: fee charged when IssuingEmbossingRequest is created. ex: 1000
+  # - status [string]: status of the IssuingEmbossingRequest. ex: "created", "processing", "success", "failed"
+  # - updated [DateTime]: latest update datetime for the IssuingEmbossingRequest. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - created [DateTime]: creation datetime for the IssuingEmbossingRequest. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class IssuingEmbossingRequest < StarkInfra::Utils::Resource
+    attr_reader :card_id, :kit_id, :display_name_1, :shipping_city, :shipping_country_code, 
+                :shipping_district, :shipping_state_code, :shipping_street_line_1, :shipping_street_line_2, 
+                :shipping_service, :shipping_tracking_number, :shipping_zip_code, :embosser_id, :display_name_2, 
+                :display_name_3, :shipping_phone, :tags, :id, :fee, :status, :created, :updated
+    def initialize(
+      card_id:, kit_id:, display_name_1:, shipping_city:, 
+      shipping_country_code:, shipping_district:, shipping_state_code:, shipping_street_line_1:, 
+      shipping_street_line_2:, shipping_service:, shipping_tracking_number:, shipping_zip_code:, 
+      embosser_id: nil, display_name_2: nil, display_name_3: nil, shipping_phone: nil, 
+      tags: nil, id: nil, fee: nil, status: nil, updated: nil, created: nil
+    )
+      super(id)
+      @card_id = card_id
+      @kit_id = kit_id
+      @display_name_1 = display_name_1
+      @shipping_city = shipping_city
+      @shipping_country_code = shipping_country_code
+      @shipping_district = shipping_district
+      @shipping_state_code = shipping_state_code
+      @shipping_street_line_1 = shipping_street_line_1
+      @shipping_street_line_2 = shipping_street_line_2
+      @shipping_service = shipping_service
+      @shipping_tracking_number = shipping_tracking_number
+      @shipping_zip_code = shipping_zip_code
+      @embosser_id = embosser_id
+      @display_name_2 = display_name_2
+      @display_name_3 = display_name_3
+      @shipping_phone = shipping_phone
+      @tags = tags
+      @fee = fee
+      @status = status
+      @created = StarkInfra::Utils::Checks.check_datetime(created)
+      @updated = StarkInfra::Utils::Checks.check_datetime(updated)
+    end
+
+    # # Create IssuingEmbossingRequests
+    #
+    # Send a list of IssuingEmbossingRequest objects for creation in the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - requests [list of IssuingEmbossingRequest objects]: list of IssuingEmbossingRequest 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 IssuingEmbossingRequest objects with updated attributes
+    def self.create(requests:, user: nil)
+      StarkInfra::Utils::Rest.post(entities: requests, user: user, **resource)
+    end
+
+    # # Retrieve a specific IssuingEmbossingRequest
+    #
+    # Receive a single IssuingEmbossingRequest object previously created in the Stark Infra API by its id
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - IssuingEmbossingRequest object with updated attributes
+    def self.get(id, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+    end
+
+    # # Retrieve IssuingEmbossingRequests
+    #
+    # Receive a generator of IssuingEmbossingRequests 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: ["created", "processing", "success", "failed"]
+    # - card_ids [list of string, default nil]: list of card_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: ["tony", "stark"]
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of IssuingEmbossingRequests objects with updated attributes
+    def self.query( 
+      limit: nil, after: nil, before: nil, status: nil, card_ids: nil, ids: nil, 
+      tags: nil, user: nil
+    )
+      after = StarkInfra::Utils::Checks.check_date(after)
+      before = StarkInfra::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_stream(
+        limit: limit,
+        after: after,
+        before: before,
+        status: status,
+        card_ids: card_ids,
+        ids: ids,
+        tags: tags,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged IssuingEmbossingRequests
+    #
+    # Receive a list of up to 100 IssuingEmbossingRequest 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: ["created", "processing", "success", "failed"]
+    # - card_ids [list of string, default nil]: list of card_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: ["tony", "stark"]
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of IssuingEmbossingRequests objects with updated attributes
+    # - cursor to retrieve the next page of IssuingEmbossingRequests objects
+    def self.page(cursor: nil, limit: nil, after: nil, before: nil, status: nil, card_ids: nil, ids: nil, tags: nil, user: nil)
+      after = StarkInfra::Utils::Checks.check_date(after)
+      before = StarkInfra::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_page(
+        cursor: cursor,
+        limit: limit,
+        after: after,
+        before: before,
+        status: status,
+        card_ids: card_ids,
+        ids: ids,
+        tags: tags,
+        user: user,
+        **resource
+      )
+    end
+
+    def self.resource
+      {
+        resource_name: 'IssuingEmbossingRequest',
+        resource_maker: proc { |json|
+          IssuingEmbossingRequest.new(
+            card_id: json['card_id'],
+            kit_id: json['kit_id'],
+            display_name_1: json['display_name_1'],
+            shipping_city: json['shipping_city'],
+            shipping_country_code: json['shipping_country_code'],
+            shipping_district: json['shipping_district'],
+            shipping_state_code: json['shipping_state_code'],
+            shipping_street_line_1: json['shipping_street_line_1'],
+            shipping_street_line_2: json['shipping_street_line_2'],
+            shipping_service: json['shipping_service'],
+            shipping_tracking_number: json['shipping_tracking_number'],
+            shipping_zip_code: json['shipping_zip_code'],
+            embosser_id: json['embosser_id'],
+            display_name_2: json['display_name_2'],
+            display_name_3: json['display_name_3'],
+            shipping_phone: json['shipping_phone'],
+            tags: json['tags'],
+            id: json['id'],
+            fee: json['fee'],
+            status: json['status'],
+            updated: json['updated'],
+            created: json['created']
+          )
+        }
+      }
+    end
+  end
+end