=begin #Money Forward Kessai API v2 #Money Forward Kessai REST API The version of the OpenAPI document: 2.6.7 Contact: api.support@mfkessai.co.jp Generated by: https://openapi-generator.tech OpenAPI Generator version: 5.0.1 =end require 'cgi' module MfkOpenapiRubyClient class BillingApi attr_accessor :api_client def initialize(api_client = ApiClient.default) @api_client = api_client end # 請求取得 # @param billing_id [String] 対象の請求IDを指定してください。 # @param [Hash] opts the optional parameters # @return [Billing] def get_billing(billing_id, opts = {}) data, _status_code, _headers = get_billing_with_http_info(billing_id, opts) data end # 請求取得 # @param billing_id [String] 対象の請求IDを指定してください。 # @param [Hash] opts the optional parameters # @return [Array<(Billing, Integer, Hash)>] Billing data, response status code and response headers def get_billing_with_http_info(billing_id, opts = {}) if @api_client.config.debugging @api_client.config.logger.debug 'Calling API: BillingApi.get_billing ...' end # verify the required parameter 'billing_id' is set if @api_client.config.client_side_validation && billing_id.nil? fail ArgumentError, "Missing the required parameter 'billing_id' when calling BillingApi.get_billing" end # resource path local_var_path = '/billings/{billing_id}'.sub('{' + 'billing_id' + '}', CGI.escape(billing_id.to_s)) # query parameters query_params = opts[:query_params] || {} # header parameters header_params = opts[:header_params] || {} # HTTP header 'Accept' (if needed) header_params['Accept'] = @api_client.select_header_accept(['application/json']) # form parameters form_params = opts[:form_params] || {} # http body (model) post_body = opts[:debug_body] # return_type return_type = opts[:debug_return_type] || 'Billing' # auth_names auth_names = opts[:debug_auth_names] || ['apikey'] new_options = opts.merge( :operation => :"BillingApi.get_billing", :header_params => header_params, :query_params => query_params, :form_params => form_params, :body => post_body, :auth_names => auth_names, :return_type => return_type ) data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options) if @api_client.config.debugging @api_client.config.logger.debug "API called: BillingApi#get_billing\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}" end return data, status_code, headers end # 請求一覧取得 # @param [Hash] opts the optional parameters # @option opts [String] :customer_id 任意の顧客IDを指定します。指定した顧客への請求が返却されます。 # @option opts [String] :customer_number 顧客番号を指定します。指定された顧客の請求を取得します。 # @option opts [Array] :status 請求ステータスを指定します。該当するステータスの請求が返却されます。複数指定することが可能です。指定できる値は `scheduled`(請求予定), `invoice_issued`(請求書発行済), `account_transfer_notified`(口座振替通知済)の3種類のみです。 # @option opts [Date] :due_date_from 日付を指定します。指定した日付以降の支払期限となっている請求を取得できます。指定された日付のものも含まれます。 # @option opts [Date] :due_date_to 日付を指定します。指定した日付以前の支払期限となっている請求を取得できます。指定された日付のものも含まれます。 # @option opts [Date] :issue_date_from 日付を指定します。指定した日付以降の請求書発行日となっている請求を取得できます。指定された日付のものも含まれます。 # @option opts [Date] :issue_date_to 日付を指定します。指定した日付以前の請求書発行日となっている請求を取得できます。指定された日付のものも含まれます。 # @option opts [Boolean] :unpaid 未入金のあり(`true`)、なし(`false`)を指定します。空文字が指定された場合、`false`として扱われます。 # @option opts [String] :after 任意のリソースIDを指定します。追加日時の降順でこのIDのリソースよりも後のリソースを取得します。この時`after`で指定したIDのリソースは結果に含まれません。 # @option opts [String] :before 任意のリソースIDを指定します。追加日時の降順でこのIDのリソースよりも前のリソースを取得します。この時`before`で指定したIDのリソースは結果に含まれません。 # @option opts [Integer] :limit 取得したいリソースの最大件数を指定します。1~200の間の整数で指定してください。指定がない場合は20になります。 # @return [BillingsList] def get_billings_list(opts = {}) data, _status_code, _headers = get_billings_list_with_http_info(opts) data end # 請求一覧取得 # @param [Hash] opts the optional parameters # @option opts [String] :customer_id 任意の顧客IDを指定します。指定した顧客への請求が返却されます。 # @option opts [String] :customer_number 顧客番号を指定します。指定された顧客の請求を取得します。 # @option opts [Array] :status 請求ステータスを指定します。該当するステータスの請求が返却されます。複数指定することが可能です。指定できる値は `scheduled`(請求予定), `invoice_issued`(請求書発行済), `account_transfer_notified`(口座振替通知済)の3種類のみです。 # @option opts [Date] :due_date_from 日付を指定します。指定した日付以降の支払期限となっている請求を取得できます。指定された日付のものも含まれます。 # @option opts [Date] :due_date_to 日付を指定します。指定した日付以前の支払期限となっている請求を取得できます。指定された日付のものも含まれます。 # @option opts [Date] :issue_date_from 日付を指定します。指定した日付以降の請求書発行日となっている請求を取得できます。指定された日付のものも含まれます。 # @option opts [Date] :issue_date_to 日付を指定します。指定した日付以前の請求書発行日となっている請求を取得できます。指定された日付のものも含まれます。 # @option opts [Boolean] :unpaid 未入金のあり(`true`)、なし(`false`)を指定します。空文字が指定された場合、`false`として扱われます。 # @option opts [String] :after 任意のリソースIDを指定します。追加日時の降順でこのIDのリソースよりも後のリソースを取得します。この時`after`で指定したIDのリソースは結果に含まれません。 # @option opts [String] :before 任意のリソースIDを指定します。追加日時の降順でこのIDのリソースよりも前のリソースを取得します。この時`before`で指定したIDのリソースは結果に含まれません。 # @option opts [Integer] :limit 取得したいリソースの最大件数を指定します。1~200の間の整数で指定してください。指定がない場合は20になります。 # @return [Array<(BillingsList, Integer, Hash)>] BillingsList data, response status code and response headers def get_billings_list_with_http_info(opts = {}) if @api_client.config.debugging @api_client.config.logger.debug 'Calling API: BillingApi.get_billings_list ...' end if @api_client.config.client_side_validation && !opts[:'customer_number'].nil? && opts[:'customer_number'].to_s.length > 100 fail ArgumentError, 'invalid value for "opts[:"customer_number"]" when calling BillingApi.get_billings_list, the character length must be smaller than or equal to 100.' end allowable_values = ["scheduled", "invoice_issued", "account_transfer_notified"] if @api_client.config.client_side_validation && opts[:'status'] && !opts[:'status'].all? { |item| allowable_values.include?(item) } fail ArgumentError, "invalid value for \"status\", must include one of #{allowable_values}" end if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 200 fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling BillingApi.get_billings_list, must be smaller than or equal to 200.' end if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1 fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling BillingApi.get_billings_list, must be greater than or equal to 1.' end # resource path local_var_path = '/billings' # query parameters query_params = opts[:query_params] || {} query_params[:'customer_id'] = opts[:'customer_id'] if !opts[:'customer_id'].nil? query_params[:'customer_number'] = opts[:'customer_number'] if !opts[:'customer_number'].nil? query_params[:'status'] = @api_client.build_collection_param(opts[:'status'], :csv) if !opts[:'status'].nil? query_params[:'due_date_from'] = opts[:'due_date_from'] if !opts[:'due_date_from'].nil? query_params[:'due_date_to'] = opts[:'due_date_to'] if !opts[:'due_date_to'].nil? query_params[:'issue_date_from'] = opts[:'issue_date_from'] if !opts[:'issue_date_from'].nil? query_params[:'issue_date_to'] = opts[:'issue_date_to'] if !opts[:'issue_date_to'].nil? query_params[:'unpaid'] = opts[:'unpaid'] if !opts[:'unpaid'].nil? query_params[:'after'] = opts[:'after'] if !opts[:'after'].nil? query_params[:'before'] = opts[:'before'] if !opts[:'before'].nil? query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil? # header parameters header_params = opts[:header_params] || {} # HTTP header 'Accept' (if needed) header_params['Accept'] = @api_client.select_header_accept(['application/json']) # form parameters form_params = opts[:form_params] || {} # http body (model) post_body = opts[:debug_body] # return_type return_type = opts[:debug_return_type] || 'BillingsList' # auth_names auth_names = opts[:debug_auth_names] || ['apikey'] new_options = opts.merge( :operation => :"BillingApi.get_billings_list", :header_params => header_params, :query_params => query_params, :form_params => form_params, :body => post_body, :auth_names => auth_names, :return_type => return_type ) data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options) if @api_client.config.debugging @api_client.config.logger.debug "API called: BillingApi#get_billings_list\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}" end return data, status_code, headers end end end