xero-ruby 4.3.0 → 5.0.0

data/lib/xero-ruby/api/app_store_api.rb

@@ -157,6 +157,7 @@ module XeroRuby
     # @param subscription_item_id [String] The unique identifier of the subscriptionItem
     # @param create_usage_record [CreateUsageRecord] Contains the quantity for the usage record to create
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [UsageRecord]
     def post_usage_records(subscription_id, subscription_item_id, create_usage_record, opts = {})
       data, _status_code, _headers = post_usage_records_with_http_info(subscription_id, subscription_item_id, create_usage_record, opts)
@@ -168,6 +169,7 @@ module XeroRuby
     # @param subscription_item_id [String] The unique identifier of the subscriptionItem
     # @param create_usage_record [CreateUsageRecord] Contains the quantity for the usage record to create
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Array<(UsageRecord, Integer, Hash)>] UsageRecord data, response status code and response headers
     def post_usage_records_with_http_info(subscription_id, subscription_item_id, create_usage_record, options = {})
       opts = options.dup
@@ -205,6 +207,7 @@ module XeroRuby
       header_params['Accept'] = @api_client.select_header_accept(['application/json'])
       # HTTP header 'Content-Type'
       header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -240,6 +243,7 @@ module XeroRuby
     # @param usage_record_id [String] The unique identifier of the usage record
     # @param update_usage_record [UpdateUsageRecord] Contains the quantity for the usage record to update
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [UsageRecord]
     def put_usage_records(subscription_id, subscription_item_id, usage_record_id, update_usage_record, opts = {})
       data, _status_code, _headers = put_usage_records_with_http_info(subscription_id, subscription_item_id, usage_record_id, update_usage_record, opts)
@@ -252,6 +256,7 @@ module XeroRuby
     # @param usage_record_id [String] The unique identifier of the usage record
     # @param update_usage_record [UpdateUsageRecord] Contains the quantity for the usage record to update
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Array<(UsageRecord, Integer, Hash)>] UsageRecord data, response status code and response headers
     def put_usage_records_with_http_info(subscription_id, subscription_item_id, usage_record_id, update_usage_record, options = {})
       opts = options.dup
@@ -293,6 +298,7 @@ module XeroRuby
       header_params['Accept'] = @api_client.select_header_accept(['application/json'])
       # HTTP header 'Content-Type'
       header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}

data/lib/xero-ruby/api/asset_api.rb

@@ -21,6 +21,7 @@ module XeroRuby
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param asset [Asset] Fixed asset you are creating
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Asset]
     def create_asset(xero_tenant_id, asset, opts = {})
       data, _status_code, _headers = create_asset_with_http_info(xero_tenant_id, asset, opts)
@@ -32,6 +33,7 @@ module XeroRuby
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param asset [Asset] Fixed asset you are creating
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Array<(Asset, Integer, Hash)>] Asset data, response status code and response headers
     def create_asset_with_http_info(xero_tenant_id, asset, options = {})
       opts = options.dup
@@ -66,6 +68,7 @@ module XeroRuby
       # HTTP header 'Content-Type'
       header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
       header_params[:'xero-tenant-id'] = xero_tenant_id
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -98,21 +101,23 @@ module XeroRuby
     # adds a fixed asset type
     # Adds an fixed asset type to the system
     # @param xero_tenant_id [String] Xero identifier for Tenant
+    # @param asset_type [AssetType] Asset type to add
     # @param [Hash] opts the optional parameters
-    # @option opts [AssetType] :asset_type Asset type to add
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [AssetType]
-    def create_asset_type(xero_tenant_id, opts = {})
-      data, _status_code, _headers = create_asset_type_with_http_info(xero_tenant_id, opts)
+    def create_asset_type(xero_tenant_id, asset_type, opts = {})
+      data, _status_code, _headers = create_asset_type_with_http_info(xero_tenant_id, asset_type, opts)
       data
     end
 
     # adds a fixed asset type
     # Adds an fixed asset type to the system
     # @param xero_tenant_id [String] Xero identifier for Tenant
+    # @param asset_type [AssetType] Asset type to add
     # @param [Hash] opts the optional parameters
-    # @option opts [AssetType] :asset_type Asset type to add
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Array<(AssetType, Integer, Hash)>] AssetType data, response status code and response headers
-    def create_asset_type_with_http_info(xero_tenant_id, options = {})
+    def create_asset_type_with_http_info(xero_tenant_id, asset_type, options = {})
       opts = options.dup
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AssetApi.create_asset_type ...'
@@ -121,6 +126,10 @@ module XeroRuby
       if @api_client.config.client_side_validation && xero_tenant_id.nil?
         fail ArgumentError, "Missing the required parameter 'xero_tenant_id' when calling AssetApi.create_asset_type"
       end
+      # verify the required parameter 'asset_type' is set
+      if @api_client.config.client_side_validation && asset_type.nil?
+        fail ArgumentError, "Missing the required parameter 'asset_type' when calling AssetApi.create_asset_type"
+      end
       # resource path
       local_var_path = '/AssetTypes'
 
@@ -141,12 +150,13 @@ module XeroRuby
       # HTTP header 'Content-Type'
       header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
       header_params[:'xero-tenant-id'] = xero_tenant_id
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:body] || @api_client.object_to_http_body(opts[:'asset_type']) 
+      post_body = opts[:body] || @api_client.object_to_http_body(asset_type) 
 
       # return_type
       return_type = opts[:return_type] || 'AssetType' 

data/lib/xero-ruby/api/files_api.rb

@@ -20,11 +20,12 @@ module XeroRuby
     # By passing in the appropriate options, you can create a new folder
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param file_id [String] File id for single object
+    # @param association [Association] 
     # @param [Hash] opts the optional parameters
-    # @option opts [Association] :association 
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Association]
-    def create_file_association(xero_tenant_id, file_id, opts = {})
-      data, _status_code, _headers = create_file_association_with_http_info(xero_tenant_id, file_id, opts)
+    def create_file_association(xero_tenant_id, file_id, association, opts = {})
+      data, _status_code, _headers = create_file_association_with_http_info(xero_tenant_id, file_id, association, opts)
       data
     end
 
@@ -32,10 +33,11 @@ module XeroRuby
     # By passing in the appropriate options, you can create a new folder
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param file_id [String] File id for single object
+    # @param association [Association] 
     # @param [Hash] opts the optional parameters
-    # @option opts [Association] :association 
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Array<(Association, Integer, Hash)>] Association data, response status code and response headers
-    def create_file_association_with_http_info(xero_tenant_id, file_id, options = {})
+    def create_file_association_with_http_info(xero_tenant_id, file_id, association, options = {})
       opts = options.dup
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: FilesApi.create_file_association ...'
@@ -48,6 +50,10 @@ module XeroRuby
       if @api_client.config.client_side_validation && file_id.nil?
         fail ArgumentError, "Missing the required parameter 'file_id' when calling FilesApi.create_file_association"
       end
+      # verify the required parameter 'association' is set
+      if @api_client.config.client_side_validation && association.nil?
+        fail ArgumentError, "Missing the required parameter 'association' when calling FilesApi.create_file_association"
+      end
       # resource path
       local_var_path = '/Files/{FileId}/Associations'.sub('{' + 'FileId' + '}', file_id.to_s)
 
@@ -68,12 +74,13 @@ module XeroRuby
       # HTTP header 'Content-Type'
       header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
       header_params[:'xero-tenant-id'] = xero_tenant_id
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:body] || @api_client.object_to_http_body(opts[:'association']) 
+      post_body = opts[:body] || @api_client.object_to_http_body(association) 
 
       # return_type
       return_type = opts[:return_type] || 'Association' 
@@ -100,21 +107,23 @@ module XeroRuby
     # Creates a new folder
     # By passing in the appropriate properties, you can create a new folder
     # @param xero_tenant_id [String] Xero identifier for Tenant
+    # @param folder [Folder] 
     # @param [Hash] opts the optional parameters
-    # @option opts [Folder] :folder 
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Folder]
-    def create_folder(xero_tenant_id, opts = {})
-      data, _status_code, _headers = create_folder_with_http_info(xero_tenant_id, opts)
+    def create_folder(xero_tenant_id, folder, opts = {})
+      data, _status_code, _headers = create_folder_with_http_info(xero_tenant_id, folder, opts)
       data
     end
 
     # Creates a new folder
     # By passing in the appropriate properties, you can create a new folder
     # @param xero_tenant_id [String] Xero identifier for Tenant
+    # @param folder [Folder] 
     # @param [Hash] opts the optional parameters
-    # @option opts [Folder] :folder 
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Array<(Folder, Integer, Hash)>] Folder data, response status code and response headers
-    def create_folder_with_http_info(xero_tenant_id, options = {})
+    def create_folder_with_http_info(xero_tenant_id, folder, options = {})
       opts = options.dup
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: FilesApi.create_folder ...'
@@ -123,6 +132,10 @@ module XeroRuby
       if @api_client.config.client_side_validation && xero_tenant_id.nil?
         fail ArgumentError, "Missing the required parameter 'xero_tenant_id' when calling FilesApi.create_folder"
       end
+      # verify the required parameter 'folder' is set
+      if @api_client.config.client_side_validation && folder.nil?
+        fail ArgumentError, "Missing the required parameter 'folder' when calling FilesApi.create_folder"
+      end
       # resource path
       local_var_path = '/Folders'
 
@@ -143,12 +156,13 @@ module XeroRuby
       # HTTP header 'Content-Type'
       header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
       header_params[:'xero-tenant-id'] = xero_tenant_id
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:body] || @api_client.object_to_http_body(opts[:'folder']) 
+      post_body = opts[:body] || @api_client.object_to_http_body(folder) 
 
       # return_type
       return_type = opts[:return_type] || 'Folder' 
@@ -408,6 +422,10 @@ module XeroRuby
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param object_id [String] Object id for single object
     # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :pagesize pass an optional page size value
+    # @option opts [Integer] :page number of records to skip for pagination
+    # @option opts [String] :sort values to sort by
+    # @option opts [String] :direction direction to sort by
     # @return [Array<Association>]
     def get_associations_by_object(xero_tenant_id, object_id, opts = {})
       data, _status_code, _headers = get_associations_by_object_with_http_info(xero_tenant_id, object_id, opts)
@@ -419,6 +437,10 @@ module XeroRuby
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param object_id [String] Object id for single object
     # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :pagesize pass an optional page size value
+    # @option opts [Integer] :page number of records to skip for pagination
+    # @option opts [String] :sort values to sort by
+    # @option opts [String] :direction direction to sort by
     # @return [Array<(Array<Association>, Integer, Hash)>] Array<Association> data, response status code and response headers
     def get_associations_by_object_with_http_info(xero_tenant_id, object_id, options = {})
       opts = options.dup
@@ -433,6 +455,22 @@ module XeroRuby
       if @api_client.config.client_side_validation && object_id.nil?
         fail ArgumentError, "Missing the required parameter 'object_id' when calling FilesApi.get_associations_by_object"
       end
+      if @api_client.config.client_side_validation && !opts[:'pagesize'].nil? && opts[:'pagesize'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"pagesize"]" when calling FilesApi.get_associations_by_object, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page'].nil? && opts[:'page'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page"]" when calling FilesApi.get_associations_by_object, must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["Name", "CreatedDateUTC"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["ASC", "DESC"]
+      if @api_client.config.client_side_validation && opts[:'direction'] && !allowable_values.include?(opts[:'direction'])
+        fail ArgumentError, "invalid value for \"direction\", must be one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/Associations/{ObjectId}'.sub('{' + 'ObjectId' + '}', object_id.to_s)
 
@@ -441,6 +479,10 @@ module XeroRuby
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'pagesize'] = opts[:'pagesize'] if !opts[:'pagesize'].nil?
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'direction'] = opts[:'direction'] if !opts[:'direction'].nil?
       
       # XeroAPI's `IDs` convention openapi-generator does not snake_case properly.. manual over-riding `i_ds` malformations:
       query_params[:'IDs'] = @api_client.build_collection_param(opts[:'ids'], :csv) if !opts[:'ids'].nil?
@@ -1107,11 +1149,12 @@ module XeroRuby
     # Updates file properties of a single file
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param file_id [String] File id for single object
+    # @param file_object [FileObject] 
     # @param [Hash] opts the optional parameters
-    # @option opts [FileObject] :file_object 
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [FileObject]
-    def update_file(xero_tenant_id, file_id, opts = {})
-      data, _status_code, _headers = update_file_with_http_info(xero_tenant_id, file_id, opts)
+    def update_file(xero_tenant_id, file_id, file_object, opts = {})
+      data, _status_code, _headers = update_file_with_http_info(xero_tenant_id, file_id, file_object, opts)
       data
     end
 
@@ -1119,10 +1162,11 @@ module XeroRuby
     # Updates file properties of a single file
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param file_id [String] File id for single object
+    # @param file_object [FileObject] 
     # @param [Hash] opts the optional parameters
-    # @option opts [FileObject] :file_object 
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Array<(FileObject, Integer, Hash)>] FileObject data, response status code and response headers
-    def update_file_with_http_info(xero_tenant_id, file_id, options = {})
+    def update_file_with_http_info(xero_tenant_id, file_id, file_object, options = {})
       opts = options.dup
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: FilesApi.update_file ...'
@@ -1135,6 +1179,10 @@ module XeroRuby
       if @api_client.config.client_side_validation && file_id.nil?
         fail ArgumentError, "Missing the required parameter 'file_id' when calling FilesApi.update_file"
       end
+      # verify the required parameter 'file_object' is set
+      if @api_client.config.client_side_validation && file_object.nil?
+        fail ArgumentError, "Missing the required parameter 'file_object' when calling FilesApi.update_file"
+      end
       # resource path
       local_var_path = '/Files/{FileId}'.sub('{' + 'FileId' + '}', file_id.to_s)
 
@@ -1155,12 +1203,13 @@ module XeroRuby
       # HTTP header 'Content-Type'
       header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
       header_params[:'xero-tenant-id'] = xero_tenant_id
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:body] || @api_client.object_to_http_body(opts[:'file_object']) 
+      post_body = opts[:body] || @api_client.object_to_http_body(file_object) 
 
       # return_type
       return_type = opts[:return_type] || 'FileObject' 
@@ -1190,6 +1239,7 @@ module XeroRuby
     # @param folder_id [String] Folder id for single object
     # @param folder [Folder] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Folder]
     def update_folder(xero_tenant_id, folder_id, folder, opts = {})
       data, _status_code, _headers = update_folder_with_http_info(xero_tenant_id, folder_id, folder, opts)
@@ -1202,6 +1252,7 @@ module XeroRuby
     # @param folder_id [String] Folder id for single object
     # @param folder [Folder] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @return [Array<(Folder, Integer, Hash)>] Folder data, response status code and response headers
     def update_folder_with_http_info(xero_tenant_id, folder_id, folder, options = {})
       opts = options.dup
@@ -1240,6 +1291,7 @@ module XeroRuby
       # HTTP header 'Content-Type'
       header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
       header_params[:'xero-tenant-id'] = xero_tenant_id
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1275,6 +1327,7 @@ module XeroRuby
     # @param name [String] exact name of the file you are uploading
     # @param filename [String] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @option opts [String] :mime_type 
     # @return [FileObject]
     def upload_file(xero_tenant_id, body, name, filename, opts = {})
@@ -1288,6 +1341,7 @@ module XeroRuby
     # @param name [String] exact name of the file you are uploading
     # @param filename [String] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @option opts [String] :mime_type 
     # @return [Array<(FileObject, Integer, Hash)>] FileObject data, response status code and response headers
     def upload_file_with_http_info(xero_tenant_id, body, name, filename, options = {})
@@ -1331,6 +1385,7 @@ module XeroRuby
       # HTTP header 'Content-Type'
       header_params['Content-Type'] = @api_client.select_header_content_type(['multipart/form-data'])
       header_params[:'xero-tenant-id'] = xero_tenant_id
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1371,6 +1426,7 @@ module XeroRuby
     # @param name [String] exact name of the file you are uploading
     # @param filename [String] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @option opts [String] :mime_type 
     # @return [FileObject]
     def upload_file_to_folder(xero_tenant_id, folder_id, body, name, filename, opts = {})
@@ -1385,6 +1441,7 @@ module XeroRuby
     # @param name [String] exact name of the file you are uploading
     # @param filename [String] 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
     # @option opts [String] :mime_type 
     # @return [Array<(FileObject, Integer, Hash)>] FileObject data, response status code and response headers
     def upload_file_to_folder_with_http_info(xero_tenant_id, folder_id, body, name, filename, options = {})
@@ -1432,6 +1489,7 @@ module XeroRuby
       # HTTP header 'Content-Type'
       header_params['Content-Type'] = @api_client.select_header_content_type(['multipart/form-data'])
       header_params[:'xero-tenant-id'] = xero_tenant_id
+      header_params[:'Idempotency-Key'] = opts[:'idempotency_key'] if !opts[:'idempotency_key'].nil?
 
       # form parameters
       form_params = opts[:form_params] || {}