Class: FinancialYearSettingsClient

Inherits:
Object
  • Object
show all
Defined in:
lib/lockstep_sdk/clients/financial_year_settings_client.rb

Instance Method Summary collapse

Constructor Details

#initialize(lockstepsdk) ⇒ FinancialYearSettingsClient

Initialize the FinancialYearSettingsClient class with a lockstepsdk instance.



24
25
26
 
# File 'lib/lockstep_sdk/clients/financial_year_settings_client.rb', line 24

def initialize(lockstepsdk)
    @lockstepsdk = lockstepsdk
end

Instance Method Details

#create_financial_year_setting(body:) ⇒ Object

Creates a financial year setting from a given model.

A Financial Year Setting is used to to set the type, beginning, end, and number of periods of a year used to calculate accounting reports. The financial setting can either be for a specific app enrollment id via a sync or, when the financial year setting is manually created, will cover all account data without an app enrollment id.



71
72
73
74
 
# File 'lib/lockstep_sdk/clients/financial_year_settings_client.rb', line 71

def create_financial_year_setting(body:)
    path = "/api/v1/FinancialYearSettings"
    @lockstepsdk.request(:post, path, body, nil)
end

#delete_financial_year_setting(id:) ⇒ Object

Delete the Financial Year Setting referred to by this unique identifier.

A Financial Year Setting is used to to set the type, beginning, end, and number of periods of a year used to calculate accounting reports. The financial setting can either be for a specific app enrollment id via a sync or, when the financial year setting is manually created, will cover all account data without an app enrollment id.



60
61
62
63
 
# File 'lib/lockstep_sdk/clients/financial_year_settings_client.rb', line 60

def delete_financial_year_setting(id:)
    path = "/api/v1/FinancialYearSettings/#{id}"
    @lockstepsdk.request(:delete, path, nil, nil)
end

#query_financial_year_settings(filter:, order:, page_size:, page_number:) ⇒ Object

Queries Financial Year Settings for this account using the specified filtering, sorting, and pagination rules requested.

More information on querying can be found on the [Searchlight Query Language](developer.lockstep.io/docs/querying-with-searchlight) page on the Lockstep Developer website.

A Financial Year Setting is used to to set the type, beginning, end, and number of periods of a year used to calculate accounting reports. The financial setting can either be for a specific app enrollment id via a sync or, when the financial year setting is manually created, will cover all account data without an app enrollment id.



87
88
89
90
91
 
# File 'lib/lockstep_sdk/clients/financial_year_settings_client.rb', line 87

def query_financial_year_settings(filter:, order:, page_size:, page_number:)
    path = "/api/v1/FinancialYearSettings/query"
    params = {:filter => filter, :order => order, :pageSize => page_size, :pageNumber => page_number}
    @lockstepsdk.request(:get, path, nil, params)
end

#retrieve_financial_year_setting(id:) ⇒ Object

Retrieves the Financial Year Setting specified by this unique identifier.

A Financial Year Setting is used to to set the type, beginning, end, and number of periods of a year used to calculate accounting reports. The financial setting can either be for a specific app enrollment id via a sync or, when the financial year setting is manually created, will cover all account data without an app enrollment id.



35
36
37
38
 
# File 'lib/lockstep_sdk/clients/financial_year_settings_client.rb', line 35

def retrieve_financial_year_setting(id:)
    path = "/api/v1/FinancialYearSettings/#{id}"
    @lockstepsdk.request(:get, path, nil, nil)
end

#update_financial_year_setting(id:, body:) ⇒ Object

Updates a financial year setting that matches the specified id with the requested information.

The PATCH method allows you to change specific values on the object while leaving other values alone. As input you should supply a list of field names and new values. If you do not provide the name of a field, that field will remain unchanged. This allows you to ensure that you are only updating the specific fields desired.

A Financial Year Setting is used to to set the type, beginning, end, and number of periods of a year used to calculate accounting reports. The financial setting can either be for a specific app enrollment id via a sync or, when the financial year setting is manually created, will cover all account data without an app enrollment id.



49
50
51
52
 
# File 'lib/lockstep_sdk/clients/financial_year_settings_client.rb', line 49

def update_financial_year_setting(id:, body:)
    path = "/api/v1/FinancialYearSettings/#{id}"
    @lockstepsdk.request(:patch, path, body.to_camelback_keys.to_json, nil)
end