starkbank 2.1.0 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,77 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative('../utils/resource')
4
+ require_relative('../utils/rest')
5
+ require_relative('../utils/checks')
6
+
7
+ module StarkBank
8
+ # # BrcodePreview object
9
+ #
10
+ # A BrcodePreview is used to get information from a BR Code you received to check the informations before paying it.
11
+ #
12
+ # ## Attributes (return-only):
13
+ # - status [string]: Payment status. ex: 'active', 'paid', 'canceled' or 'unknown'
14
+ # - name [string]: Payment receiver name. ex: 'Tony Stark'
15
+ # - tax_id [string]: Payment receiver tax ID. ex: '012.345.678-90'
16
+ # - bank_code [string]: Payment receiver bank code. ex: '20018183'
17
+ # - branch_code [string]: Payment receiver branch code. ex: '0001'
18
+ # - account_number [string]: Payment receiver account number. ex: '1234567'
19
+ # - account_type [string]: Payment receiver account type. ex: 'checking'
20
+ # - allow_change [bool]: If True, the payment is able to receive amounts that are diferent from the nominal one. ex: True or False
21
+ # - amount [integer]: Value in cents that this payment is expecting to receive. If 0, any value is accepted. ex: 123 (= R$1,23)
22
+ # - reconciliation_id [string]: Reconciliation ID linked to this payment. ex: 'txId', 'payment-123'
23
+ class BrcodePreview < StarkBank::Utils::Resource
24
+ attr_reader :status, :name, :tax_id, :bank_code, :branch_code, :account_number, :account_type, :allow_change, :amount, :reconciliation_id
25
+ def initialize(status:, name:, tax_id:, bank_code:, branch_code:, account_number:, account_type:, allow_change:, amount:, reconciliation_id:)
26
+ @status = status
27
+ @name = name
28
+ @tax_id = tax_id
29
+ @bank_code = bank_code
30
+ @branch_code = branch_code
31
+ @account_number = account_number
32
+ @account_type = account_type
33
+ @allow_change = allow_change
34
+ @amount = amount
35
+ @reconciliation_id = reconciliation_id
36
+ end
37
+
38
+ # # Retrieve BrcodePreviews
39
+ #
40
+ # Receive a generator of BrcodePreview objects previously created in the Stark Bank API
41
+ #
42
+ # ## Parameters (optional):
43
+ # - brcodes [list of strings]: List of brcodes to preview. ex: %w[00020126580014br.gov.bcb.pix0136a629532e-7693-4846-852d-1bbff817b5a8520400005303986540510.005802BR5908T'Challa6009Sao Paulo62090505123456304B14A]
44
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if Starkbank.user was set before function call
45
+ #
46
+ # ## Return:
47
+ # - generator of BrcodePreview objects with updated attributes
48
+ def self.query(limit: nil, brcodes: nil, user: nil)
49
+ StarkBank::Utils::Rest.get_list(
50
+ user: user,
51
+ limit: nil,
52
+ brcodes: brcodes,
53
+ **resource
54
+ )
55
+ end
56
+
57
+ def self.resource
58
+ {
59
+ resource_name: 'BrcodePreview',
60
+ resource_maker: proc { |json|
61
+ BrcodePreview.new(
62
+ status: json['status'],
63
+ name: json['name'],
64
+ tax_id: json['tax_id'],
65
+ bank_code: json['bank_code'],
66
+ branch_code: json['branch_code'],
67
+ account_number: json['account_number'],
68
+ account_type: json['account_type'],
69
+ allow_change: json['allow_change'],
70
+ amount: json['amount'],
71
+ reconciliation_id: json['reconciliation_id']
72
+ )
73
+ }
74
+ }
75
+ end
76
+ end
77
+ end
@@ -0,0 +1,121 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative('../utils/resource')
4
+ require_relative('../utils/rest')
5
+ require_relative('../utils/checks')
6
+
7
+ module StarkBank
8
+ # # Deposit object
9
+ #
10
+ # Deposits represent passive cash-in received by your account from external transfers
11
+ #
12
+ ## Attributes (return-only):
13
+ # - id [string]: unique id associated with a Deposit when it is created. ex: '5656565656565656'
14
+ # - name [string]: payer name. ex: 'Iron Bank S.A.'
15
+ # - tax_id [string]: payer tax ID (CPF or CNPJ). ex: '012.345.678-90' or '20.018.183/0001-80'
16
+ # - bank_code [string]: payer bank code in Brazil. ex: '20018183' or '341'
17
+ # - branch_code [string]: payer bank account branch. ex: '1357-9's
18
+ # - account_number [string]: payer bank account number. ex: '876543-2'
19
+ # - amount [integer]: Deposit value in cents. ex: 1234 (= R$ 12.34)
20
+ # - type [string]: Type of settlement that originated the deposit. ex: 'pix' or 'ted'
21
+ # - status [string]: current Deposit status. ex: 'created'
22
+ # - tags [list of strings]: list of strings that are tagging the deposit. ex: ['reconciliationId', 'txId']
23
+ # - fee [integer]: fee charged by this deposit. ex: 50 (= R$ 0.50)
24
+ # - transaction_ids [list of strings]: ledger transaction ids linked to this Deposit (if there are more than one, all but first are reversals). ex: ['19827356981273']
25
+ # - created [datetime.datetime]: creation datetime for the Deposit. ex: datetime.datetime(2020, 12, 10, 10, 30, 0, 0)
26
+ # - updated [datetime.datetime]: latest update datetime for the Deposit. ex: datetime.datetime(2020, 12, 10, 10, 30, 0, 0)
27
+ class Deposit < StarkBank::Utils::Resource
28
+ attr_reader :id, :name, :tax_id, :bank_code, :branch_code, :account_number, :amount, :type, :status, :tags, :fee, :transaction_ids, :created, :updated
29
+ def initialize(
30
+ id:, name:, tax_id:, bank_code:, branch_code:, account_number:, amount:, type:, status:, tags:, fee:,
31
+ transaction_ids:, created:, updated:
32
+ )
33
+ super(id)
34
+ @name = name
35
+ @tax_id = tax_id
36
+ @bank_code = bank_code
37
+ @branch_code = branch_code
38
+ @account_number = account_number
39
+ @amount = amount
40
+ @type = type
41
+ @status = status
42
+ @tags = tags
43
+ @fee = fee
44
+ @transaction_ids = transaction_ids
45
+ @created = StarkBank::Utils::Checks.check_datetime(created)
46
+ @updated = StarkBank::Utils::Checks.check_datetime(updated)
47
+ end
48
+
49
+ # # Retrieve a specific Deposit
50
+ #
51
+ # Receive a single Deposit object previously created in the Stark Bank API by passing its id
52
+ #
53
+ # ## Parameters (required):
54
+ # - id [string]: object unique id. ex: '5656565656565656'
55
+ #
56
+ # ## Parameters (optional):
57
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkBank.user was set before function call
58
+ #
59
+ # ## Return:
60
+ # - Deposit object with updated attributes
61
+ def self.get(id, user: nil)
62
+ StarkBank::Utils::Rest.get_id(id: id, user: user, **resource)
63
+ end
64
+
65
+ # # Retrieve Deposits
66
+ #
67
+ # Receive a generator of Deposit objects previously created in the Stark Bank API
68
+ #
69
+ # ## Parameters (optional):
70
+ # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
71
+ # - after [Date , DateTime, Time or string, default nil] date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
72
+ # - before [Date, DateTime, Time or string, default nil] date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
73
+ # - status [string, default nil]: filter for status of retrieved objects. ex: 'paid' or 'registered'
74
+ # - sort [string, default '-created']: sort order considered in response. Valid options are 'created' or '-created'.
75
+ # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
76
+ # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
77
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if Starkbank.user was set before function call
78
+ #
79
+ # ## Return:
80
+ # - generator of Deposit objects with updated attributes
81
+ def self.query(limit: nil, after: nil, before: nil, status: nil, sort: nil, tags: nil, ids: nil, user: nil)
82
+ after = StarkBank::Utils::Checks.check_date(after)
83
+ before = StarkBank::Utils::Checks.check_date(before)
84
+ StarkBank::Utils::Rest.get_list(
85
+ limit: limit,
86
+ after: after,
87
+ before: before,
88
+ status: status,
89
+ sort: sort,
90
+ tags: tags,
91
+ ids: ids,
92
+ user: user,
93
+ **resource
94
+ )
95
+ end
96
+
97
+ def self.resource
98
+ {
99
+ resource_name: 'Deposit',
100
+ resource_maker: proc { |json|
101
+ Deposit.new(
102
+ id: json['id'],
103
+ name: json['name'],
104
+ tax_id: json['tax_id'],
105
+ bank_code: json['bank_code'],
106
+ branch_code: json['branch_code'],
107
+ account_number: json['account_number'],
108
+ amount: json['amount'],
109
+ type: json['type'],
110
+ status: json['status'],
111
+ tags: json['tags'],
112
+ fee: json['fee'],
113
+ transaction_ids: json['transaction_ids'],
114
+ created: json['created'],
115
+ updated: json['updated']
116
+ )
117
+ }
118
+ }
119
+ end
120
+ end
121
+ end
@@ -0,0 +1,94 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative('../utils/resource')
4
+ require_relative('../utils/rest')
5
+ require_relative('../utils/checks')
6
+ require_relative('deposit')
7
+
8
+ module StarkBank
9
+ class Deposit
10
+ # # Deposit::Log object
11
+ #
12
+ # Every time a Deposit entity is updated, a corresponding Deposit::Log
13
+ # is generated for the entity. This log is never generated by the
14
+ # user, but it can be retrieved to check additional information
15
+ # on the Deposit.
16
+ #
17
+ # ## Attributes:
18
+ # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
19
+ # - deposit [Deposit]: Deposit entity to which the log refers to.
20
+ # - errors [list of strings]: list of errors linked to this Deposit event
21
+ # - type [string]: type of the Deposit event which triggered the log creation. ex: 'canceled' or 'paid'
22
+ # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
23
+ class Log < StarkBank::Utils::Resource
24
+ attr_reader :id, :created, :type, :errors, :deposit
25
+ def initialize(id:, created:, type:, errors:, deposit:)
26
+ super(id)
27
+ @type = type
28
+ @errors = errors
29
+ @deposit = deposit
30
+ @created = StarkBank::Utils::Checks.check_datetime(created)
31
+ end
32
+
33
+ # # Retrieve a specific Log
34
+ #
35
+ # Receive a single Log object previously created by the Stark Bank API by passing its id
36
+ #
37
+ # ## Parameters (required):
38
+ # - id [string]: object unique id. ex: '5656565656565656'
39
+ #
40
+ # ## Parameters (optional):
41
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkBank.user was set before function call
42
+ #
43
+ # ## Return:
44
+ # - Log object with updated attributes
45
+ def self.get(id, user: nil)
46
+ StarkBank::Utils::Rest.get_id(id: id, user: user, **resource)
47
+ end
48
+
49
+ # # Retrieve Logs
50
+ #
51
+ # Receive a generator of Log objects previously created in the Stark Bank API
52
+ #
53
+ # ## Parameters (optional):
54
+ # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
55
+ # - after [Date, DateTime, Time or string, default nil] date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
56
+ # - before [Date, DateTime, Time or string, default nil] date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
57
+ # - types [list of strings, default nil]: filter for log event types. ex: 'paid' or 'canceled'
58
+ # - deposit_ids [list of strings, default nil]: list of Deposit ids to filter logs. ex: ['5656565656565656', '4545454545454545']
59
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if Starkbank.user was set before function call
60
+ #
61
+ # ## Return:
62
+ # - list of Log objects with updated attributes
63
+ def self.query(limit: nil, after: nil, before: nil, types: nil, deposit_ids: nil, user: nil)
64
+ after = StarkBank::Utils::Checks.check_date(after)
65
+ before = StarkBank::Utils::Checks.check_date(before)
66
+ StarkBank::Utils::Rest.get_list(
67
+ limit: limit,
68
+ after: after,
69
+ before: before,
70
+ types: types,
71
+ deposit_ids: deposit_ids,
72
+ user: user,
73
+ **resource
74
+ )
75
+ end
76
+
77
+ def self.resource
78
+ deposit_maker = StarkBank::Deposit.resource[:resource_maker]
79
+ {
80
+ resource_name: 'DepositLog',
81
+ resource_maker: proc { |json|
82
+ Log.new(
83
+ id: json['id'],
84
+ created: json['created'],
85
+ type: json['type'],
86
+ errors: json['errors'],
87
+ deposit: StarkBank::Utils::API.from_api_json(deposit_maker, json['deposit'])
88
+ )
89
+ }
90
+ }
91
+ end
92
+ end
93
+ end
94
+ end
@@ -0,0 +1,118 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative('../utils/resource.rb')
4
+ require_relative('../utils/rest.rb')
5
+ require_relative('../utils/checks.rb')
6
+
7
+ module StarkBank
8
+ # # DictKey object
9
+ #
10
+ # DictKey represents a PIX key registered in Bacen's DICT system.
11
+ #
12
+ # ## Parameters (required):
13
+ # - id [string]: DictKey object unique id and PIX key itself. ex: 'tony@starkbank.com', '722.461.430-04', '20.018.183/0001-80', '+5511988887777', 'b6295ee1-f054-47d1-9e90-ee57b74f60d9'
14
+ #
15
+ # ## Attributes (return-only):
16
+ # - type [string, default nil]: DICT key type. ex: 'email', 'cpf', 'cnpj', 'phone' or 'evp'
17
+ # - name [string, default nil]: account owner full name. ex: 'Tony Stark'
18
+ # - tax_id [string, default nil]: key owner tax ID (CNPJ or masked CPF). ex: '***.345.678-**' or '20.018.183/0001-80'
19
+ # - owner_type [string, default nil]: DICT key owner type. ex 'naturalPerson' or 'legalPerson'
20
+ # - ispb [string, default nil]: bank ISPB associated with the DICT key. ex: '20018183'
21
+ # - branch_code [string, default nil]: bank account branch code associated with the DICT key. ex: '9585'
22
+ # - account_number [string, default nil]: bank account number associated with the DICT key. ex: '9828282578010513'
23
+ # - account_type [string, default nil]: bank account type associated with the DICT key. ex: 'checking', 'saving' e 'salary'
24
+ # - status [string, default nil]: current DICT key status. ex: 'created', 'registered', 'canceled' or 'failed'
25
+ # - account_created [DateTime or string, default nil]: creation datetime of the bank account associated with the DICT key. ex: '2020-11-05T14:55:08.812665+00:00'
26
+ # - owned [DateTime or string, default nil]: datetime since when the current owner hold this DICT key. ex : '2020-11-05T14:55:08.812665+00:00'
27
+ # - created [DateTime or string, default nil]: creation datetime for the DICT key. ex: '2020-03-10 10:30:00.000'
28
+ class DictKey < StarkBank::Utils::Resource
29
+ attr_reader :id, :type, :name, :tax_id, :owner_type, :ispb, :branch_code, :account_number, :account_type, :status, :account_created, :owned, :created
30
+ def initialize(
31
+ id:, type:, name:, tax_id:, owner_type:, ispb:, branch_code:, account_number:, account_type:,
32
+ status:, account_created:, owned:, created:
33
+ )
34
+ super(id)
35
+ @type = type
36
+ @name = name
37
+ @tax_id = tax_id
38
+ @owner_type = owner_type
39
+ @ispb = ispb
40
+ @branch_code = branch_code
41
+ @account_number = account_number
42
+ @account_type = account_type
43
+ @status = status
44
+ @account_created = StarkBank::Utils::Checks.check_datetime(account_created)
45
+ @owned = StarkBank::Utils::Checks.check_datetime(owned)
46
+ @created = StarkBank::Utils::Checks.check_datetime(created)
47
+ end
48
+
49
+ # # Retrieve a specific DictKey
50
+ #
51
+ # Receive a single DictKey object by passing its id
52
+ #
53
+ # ## Parameters (required):
54
+ # - id [string]: DictKey object unique id and PIX key itself. ex: 'tony@starkbank.com', '722.461.430-04', '20.018.183/0001-80', '+5511988887777', 'b6295ee1-f054-47d1-9e90-ee57b74f60d9'
55
+ #
56
+ # ## Parameters (optional):
57
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkBank.user was set before function call
58
+ #
59
+ # ## Return:
60
+ # - DictKey object with updated attributes
61
+ def self.get(id, user: nil)
62
+ StarkBank::Utils::Rest.get_id(id: id, user: user, **resource)
63
+ end
64
+
65
+ # # Retrieve DitcKeys
66
+ #
67
+ # Receive a generator of DitcKey objects previously created in the Stark Bank API
68
+ #
69
+ # ## Parameters (optional):
70
+ # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
71
+ # - type [string, default nil]: DictKey type. ex: 'cpf', 'cnpj', 'phone', 'email' or 'evp'
72
+ # - after [Date , DateTime, Time or string, default nil] date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
73
+ # - before [Date, DateTime, Time or string, default nil] date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
74
+ # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
75
+ # - status [string, default nil]: filter for status of retrieved objects. ex: 'canceled', 'registered'
76
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if Starkbank.user was set before function call
77
+ #
78
+ # ## Return:
79
+ # - generator of DitcKey objects with updated attributes
80
+ def self.query(limit: nil, type: nil, after: nil, before: nil, ids: nil, status: nil, user: nil)
81
+ after = StarkBank::Utils::Checks.check_date(after)
82
+ before = StarkBank::Utils::Checks.check_date(before)
83
+ StarkBank::Utils::Rest.get_list(
84
+ limit: limit,
85
+ type: type,
86
+ after: after,
87
+ before: before,
88
+ ids: ids,
89
+ status: status,
90
+ user: user,
91
+ **resource
92
+ )
93
+ end
94
+
95
+ def self.resource
96
+ {
97
+ resource_name: 'DictKey',
98
+ resource_maker: proc { |json|
99
+ DictKey.new(
100
+ id: json['id'],
101
+ account_type: json['account_type'],
102
+ name: json['name'],
103
+ tax_id: json['tax_id'],
104
+ owner_type: json['owner_type'],
105
+ ispb: json['ispb'],
106
+ branch_code: json['branch_code'],
107
+ account_number: json['account_number'],
108
+ type: json['type'],
109
+ status: json['status'],
110
+ account_created: json['account_created'],
111
+ owned: json['owned'],
112
+ created: json['created']
113
+ )
114
+ }
115
+ }
116
+ end
117
+ end
118
+ end
@@ -9,6 +9,9 @@ require_relative('../utils/cache')
9
9
  require_relative('../error')
10
10
  require_relative('../boleto/log')
11
11
  require_relative('../boleto_holmes/log')
12
+ require_relative('../invoice/log')
13
+ require_relative('../deposit/log')
14
+ require_relative('../brcode_payment/log')
12
15
  require_relative('../transfer/log')
13
16
  require_relative('../boleto_payment/log')
14
17
  require_relative('../utility_payment/log')
@@ -22,7 +25,7 @@ module StarkBank
22
25
  #
23
26
  # ## Attributes:
24
27
  # - id [string]: unique id returned when the event is created. ex: '5656565656565656'
25
- # - log [Log]: a Log object from one the subscription services (TransferLog, BoletoLog, BoletoPaymentlog or UtilityPaymentLog)
28
+ # - log [Log]: a Log object from one the subscription services (TransferLog, InvoiceLog, BoletoLog, BoletoPaymentlog or UtilityPaymentLog)
26
29
  # - created [DateTime]: creation datetime for the notification event. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
27
30
  # - is_delivered [bool]: true if the event has been successfully delivered to the user url. ex: False
28
31
  # - subscription [string]: service that triggered this event. ex: 'transfer', 'utility-payment'
@@ -36,6 +39,9 @@ module StarkBank
36
39
 
37
40
  resource = {
38
41
  'transfer': StarkBank::Transfer::Log.resource,
42
+ 'invoice': StarkBank::Invoice::Log.resource,
43
+ 'deposit': StarkBank::Deposit::Log.resource,
44
+ 'brcode-payment': StarkBank::BrcodePayment::Log.resource,
39
45
  'boleto': StarkBank::Boleto::Log.resource,
40
46
  'boleto-payment': StarkBank::BoletoPayment::Log.resource,
41
47
  'utility-payment': StarkBank::UtilityPayment::Log.resource,
@@ -54,7 +60,7 @@ module StarkBank
54
60
  # - id [string]: object unique id. ex: '5656565656565656'
55
61
  #
56
62
  # ## Parameters (optional):
57
- # - user [Project object]: Project object. Not necessary if StarkBank.user was set before function call
63
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkBank.user was set before function call
58
64
  #
59
65
  # ## Return:
60
66
  # - Event object with updated attributes
@@ -71,7 +77,7 @@ module StarkBank
71
77
  # - after [Date, DateTime, Time or string, default nil]: date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
72
78
  # - before [Date, DateTime, Time or string, default nil]: date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
73
79
  # - is_delivered [bool, default nil]: bool to filter successfully delivered events. ex: True or False
74
- # - user [Project object, default nil]: Project object. Not necessary if StarkBank.user was set before function call
80
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if Starkbank.user was set before function call
75
81
  #
76
82
  # ## Return:
77
83
  # - generator of Event objects with updated attributes
@@ -96,7 +102,7 @@ module StarkBank
96
102
  # - id [string]: Event unique id. ex: '5656565656565656'
97
103
  #
98
104
  # ## Parameters (optional):
99
- # - user [Project object]: Project object. Not necessary if StarkBank.user was set before function call
105
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkBank.user was set before function call
100
106
  #
101
107
  # ## Return:
102
108
  # - deleted Event object
@@ -114,7 +120,7 @@ module StarkBank
114
120
  # - is_delivered [bool]: If True and event hasn't been delivered already, event will be set as delivered. ex: True
115
121
  #
116
122
  # ## Parameters (optional):
117
- # - user [Project object]: Project object. Not necessary if StarkBank.user was set before function call
123
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkBank.user was set before function call
118
124
  #
119
125
  # ## Return:
120
126
  # - target Event with updated attributes
@@ -133,7 +139,7 @@ module StarkBank
133
139
  # - signature [string]: base-64 digital signature received at response header 'Digital-Signature'
134
140
  #
135
141
  # ## Parameters (optional):
136
- # - user [Project object]: Project object. Not necessary if StarkBank.user was set before function call
142
+ # - user [Organization/Project object]: Organization or Project object. Not necessary if StarkBank.user was set before function call
137
143
  #
138
144
  # ## Return:
139
145
  # - Parsed Event object