hanzoai 8.5.156

data/lib/hanzoai/api/books_api.rb

@@ -0,0 +1,1604 @@
+=begin
+#Hanzo Cloud API
+
+#The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module Hanzoai
+  class BooksApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Returns the org's chart of accounts — the seeded fixed chart every posting key in the ledger refers to.
+    # Returns the org's chart of accounts — the seeded fixed chart every posting key in the ledger refers to.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org's SANDBOX ledger when it is exactly \"true\"; anything else reads the live one.
+    # @return [Array<Account>]
+    def get_books_accounts(opts = {})
+      data, _status_code, _headers = get_books_accounts_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s chart of accounts — the seeded fixed chart every posting key in the ledger refers to.
+    # Returns the org&#39;s chart of accounts — the seeded fixed chart every posting key in the ledger refers to.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;; anything else reads the live one.
+    # @return [Array<(Array<Account>, Integer, Hash)>] Array<Account> data, response status code and response headers
+    def get_books_accounts_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_accounts ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/accounts'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<Account>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_accounts",
+        :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: BooksApi#get_books_accounts\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's normalized bank transactions, newest first — every row the import and connector paths have ingested, with its amount in exact cents, its direction, and whether it has been matched to a voucher yet.
+    # Returns the org's normalized bank transactions, newest first — every row the import and connector paths have ingested, with its amount in exact cents, its direction, and whether it has been matched to a voucher yet.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [Integer] :limit Limit caps how many rows come back; 500 when absent or not positive.
+    # @return [Array<BankTxnRow>]
+    def get_books_bank_transactions(opts = {})
+      data, _status_code, _headers = get_books_bank_transactions_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s normalized bank transactions, newest first — every row the import and connector paths have ingested, with its amount in exact cents, its direction, and whether it has been matched to a voucher yet.
+    # Returns the org&#39;s normalized bank transactions, newest first — every row the import and connector paths have ingested, with its amount in exact cents, its direction, and whether it has been matched to a voucher yet.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [Integer] :limit Limit caps how many rows come back; 500 when absent or not positive.
+    # @return [Array<(Array<BankTxnRow>, Integer, Hash)>] Array<BankTxnRow> data, response status code and response headers
+    def get_books_bank_transactions_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_bank_transactions ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/bank/transactions'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].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']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<BankTxnRow>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_bank_transactions",
+        :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: BooksApi#get_books_bank_transactions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's unmatched bank inflows and their open clarifying questions — the queue a human answers so an unexplained deposit is never guessed into revenue.
+    # Returns the org's unmatched bank inflows and their open clarifying questions — the queue a human answers so an unexplained deposit is never guessed into revenue.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;; anything else reads the live one.
+    # @return [UnreconciledOut]
+    def get_books_bank_unreconciled(opts = {})
+      data, _status_code, _headers = get_books_bank_unreconciled_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s unmatched bank inflows and their open clarifying questions — the queue a human answers so an unexplained deposit is never guessed into revenue.
+    # Returns the org&#39;s unmatched bank inflows and their open clarifying questions — the queue a human answers so an unexplained deposit is never guessed into revenue.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;; anything else reads the live one.
+    # @return [Array<(UnreconciledOut, Integer, Hash)>] UnreconciledOut data, response status code and response headers
+    def get_books_bank_unreconciled_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_bank_unreconciled ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/bank/unreconciled'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'UnreconciledOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_bank_unreconciled",
+        :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: BooksApi#get_books_bank_unreconciled\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the complete financial package for the caller's org over (from, to]: the trial balance, the P&L, the balance sheet, and the GL detail behind them — the four statements a tax preparer or an investor asks for, assembled from the one ledger in a single read so they cannot disagree with each other.
+    # Returns the complete financial package for the caller's org over (from, to]: the trial balance, the P&L, the balance sheet, and the GL detail behind them — the four statements a tax preparer or an investor asks for, assembled from the one ledger in a single read so they cannot disagree with each other.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :from From is the RFC3339 start of the window, exclusive. Empty means all time.
+    # @option opts [String] :to To is the RFC3339 end of the window, inclusive. Empty means up to now.
+    # @option opts [String] :format Format is the export encoding. Only \&quot;json\&quot; is supported; empty means json.
+    # @option opts [Integer] :limit Limit caps the GL detail rows included as the audit trail; 5000 when absent or not positive.
+    # @return [FinancialPackage]
+    def get_books_export(opts = {})
+      data, _status_code, _headers = get_books_export_with_http_info(opts)
+      data
+    end
+
+    # Returns the complete financial package for the caller&#39;s org over (from, to]: the trial balance, the P&amp;L, the balance sheet, and the GL detail behind them — the four statements a tax preparer or an investor asks for, assembled from the one ledger in a single read so they cannot disagree with each other.
+    # Returns the complete financial package for the caller&#39;s org over (from, to]: the trial balance, the P&amp;L, the balance sheet, and the GL detail behind them — the four statements a tax preparer or an investor asks for, assembled from the one ledger in a single read so they cannot disagree with each other.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :from From is the RFC3339 start of the window, exclusive. Empty means all time.
+    # @option opts [String] :to To is the RFC3339 end of the window, inclusive. Empty means up to now.
+    # @option opts [String] :format Format is the export encoding. Only \&quot;json\&quot; is supported; empty means json.
+    # @option opts [Integer] :limit Limit caps the GL detail rows included as the audit trail; 5000 when absent or not positive.
+    # @return [Array<(FinancialPackage, Integer, Hash)>] FinancialPackage data, response status code and response headers
+    def get_books_export_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_export ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/export'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+      query_params[:'from'] = opts[:'from'] if !opts[:'from'].nil?
+      query_params[:'to'] = opts[:'to'] if !opts[:'to'].nil?
+      query_params[:'format'] = opts[:'format'] if !opts[:'format'].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']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FinancialPackage'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_export",
+        :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: BooksApi#get_books_export\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # ListGL returns the org's most recent GL Entry rows, newest first.
+    # ListGL returns the org's most recent GL Entry rows, newest first. This is the raw double-entry detail behind every statement: one row per leg, with its debit, credit, posting time and the source that booked it.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [Integer] :limit Limit caps how many rows come back; 500 when absent or not positive.
+    # @return [Array<GLRow>]
+    def get_books_gl(opts = {})
+      data, _status_code, _headers = get_books_gl_with_http_info(opts)
+      data
+    end
+
+    # ListGL returns the org&#39;s most recent GL Entry rows, newest first.
+    # ListGL returns the org&#39;s most recent GL Entry rows, newest first. This is the raw double-entry detail behind every statement: one row per leg, with its debit, credit, posting time and the source that booked it.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [Integer] :limit Limit caps how many rows come back; 500 when absent or not positive.
+    # @return [Array<(Array<GLRow>, Integer, Hash)>] Array<GLRow> data, response status code and response headers
+    def get_books_gl_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_gl ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/gl'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].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']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<GLRow>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_gl",
+        :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: BooksApi#get_books_gl\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's open document queue — everything uploaded but not yet booked, newest first, each with its extracted summary and the confidence the scanner resolved its category at.
+    # Returns the org's open document queue — everything uploaded but not yet booked, newest first, each with its extracted summary and the confidence the scanner resolved its category at. A booked document drops out of the queue.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;; anything else reads the live one.
+    # @return [InboxOut]
+    def get_books_inbox(opts = {})
+      data, _status_code, _headers = get_books_inbox_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s open document queue — everything uploaded but not yet booked, newest first, each with its extracted summary and the confidence the scanner resolved its category at.
+    # Returns the org&#39;s open document queue — everything uploaded but not yet booked, newest first, each with its extracted summary and the confidence the scanner resolved its category at. A booked document drops out of the queue.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;; anything else reads the live one.
+    # @return [Array<(InboxOut, Integer, Hash)>] InboxOut data, response status code and response headers
+    def get_books_inbox_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_inbox ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/inbox'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'InboxOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_inbox",
+        :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: BooksApi#get_books_inbox\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Metrics returns the org's deterministic SaaS-metrics snapshot over an optional (from, to] window — MRR, ARR, revenue, COGS, burn, gross margin, net income, cash, deferred revenue, monthly burn and runway — as raw int64-cent figures AND the same figures already formatted.
+    # Metrics returns the org's deterministic SaaS-metrics snapshot over an optional (from, to] window — MRR, ARR, revenue, COGS, burn, gross margin, net income, cash, deferred revenue, monthly burn and runway — as raw int64-cent figures AND the same figures already formatted. Every number is the ledger, aggregated the one way the books define it, never a guess; it is the grounded read the unified /v1/ask advisor replays.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :from From is the RFC3339 start of the window, exclusive. Empty means all time.
+    # @option opts [String] :to To is the RFC3339 end of the window, inclusive. Empty means up to now.
+    # @return [MetricsResponse]
+    def get_books_metrics(opts = {})
+      data, _status_code, _headers = get_books_metrics_with_http_info(opts)
+      data
+    end
+
+    # Metrics returns the org&#39;s deterministic SaaS-metrics snapshot over an optional (from, to] window — MRR, ARR, revenue, COGS, burn, gross margin, net income, cash, deferred revenue, monthly burn and runway — as raw int64-cent figures AND the same figures already formatted.
+    # Metrics returns the org&#39;s deterministic SaaS-metrics snapshot over an optional (from, to] window — MRR, ARR, revenue, COGS, burn, gross margin, net income, cash, deferred revenue, monthly burn and runway — as raw int64-cent figures AND the same figures already formatted. Every number is the ledger, aggregated the one way the books define it, never a guess; it is the grounded read the unified /v1/ask advisor replays.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :from From is the RFC3339 start of the window, exclusive. Empty means all time.
+    # @option opts [String] :to To is the RFC3339 end of the window, inclusive. Empty means up to now.
+    # @return [Array<(MetricsResponse, Integer, Hash)>] MetricsResponse data, response status code and response headers
+    def get_books_metrics_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_metrics ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/metrics'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+      query_params[:'from'] = opts[:'from'] if !opts[:'from'].nil?
+      query_params[:'to'] = opts[:'to'] if !opts[:'to'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'MetricsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_metrics",
+        :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: BooksApi#get_books_metrics\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's accrual-basis Profit & Loss over an optional (from, to] window of RFC3339 posting times: recognized revenue, matched cost, and the net.
+    # Returns the org's accrual-basis Profit & Loss over an optional (from, to] window of RFC3339 posting times: recognized revenue, matched cost, and the net.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :from From is the RFC3339 start of the window, exclusive. Empty means all time.
+    # @option opts [String] :to To is the RFC3339 end of the window, inclusive. Empty means up to now.
+    # @return [PnL]
+    def get_books_pnl(opts = {})
+      data, _status_code, _headers = get_books_pnl_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s accrual-basis Profit &amp; Loss over an optional (from, to] window of RFC3339 posting times: recognized revenue, matched cost, and the net.
+    # Returns the org&#39;s accrual-basis Profit &amp; Loss over an optional (from, to] window of RFC3339 posting times: recognized revenue, matched cost, and the net.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :from From is the RFC3339 start of the window, exclusive. Empty means all time.
+    # @option opts [String] :to To is the RFC3339 end of the window, inclusive. Empty means up to now.
+    # @return [Array<(PnL, Integer, Hash)>] PnL data, response status code and response headers
+    def get_books_pnl_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_pnl ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/pnl'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+      query_params[:'from'] = opts[:'from'] if !opts[:'from'].nil?
+      query_params[:'to'] = opts[:'to'] if !opts[:'to'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PnL'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_pnl",
+        :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: BooksApi#get_books_pnl\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's Balance Sheet as of `to` (empty = all time), with the Assets == Liabilities + Equity equation proof.
+    # Returns the org's Balance Sheet as of `to` (empty = all time), with the Assets == Liabilities + Equity equation proof.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :to To is the RFC3339 instant the statement is struck as of. Empty means all time.
+    # @return [BalanceSheet]
+    def get_books_position(opts = {})
+      data, _status_code, _headers = get_books_position_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s Balance Sheet as of &#x60;to&#x60; (empty &#x3D; all time), with the Assets &#x3D;&#x3D; Liabilities + Equity equation proof.
+    # Returns the org&#39;s Balance Sheet as of &#x60;to&#x60; (empty &#x3D; all time), with the Assets &#x3D;&#x3D; Liabilities + Equity equation proof.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :to To is the RFC3339 instant the statement is struck as of. Empty means all time.
+    # @return [Array<(BalanceSheet, Integer, Hash)>] BalanceSheet data, response status code and response headers
+    def get_books_position_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_position ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/position'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+      query_params[:'to'] = opts[:'to'] if !opts[:'to'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BalanceSheet'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_position",
+        :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: BooksApi#get_books_position\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the clarifying questions the caller's own recent GL raises — the unusual postings a founder should look at (outliers, reversals, round-offs, uncosted revenue, an overdrawn wallet), sharpest first.
+    # Returns the clarifying questions the caller's own recent GL raises — the unusual postings a founder should look at (outliers, reversals, round-offs, uncosted revenue, an overdrawn wallet), sharpest first. An empty list means the books look clean; the detector is deterministic over the ledger and invents nothing.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;; anything else reads the live one.
+    # @return [QuestionsResponse]
+    def get_books_questions(opts = {})
+      data, _status_code, _headers = get_books_questions_with_http_info(opts)
+      data
+    end
+
+    # Returns the clarifying questions the caller&#39;s own recent GL raises — the unusual postings a founder should look at (outliers, reversals, round-offs, uncosted revenue, an overdrawn wallet), sharpest first.
+    # Returns the clarifying questions the caller&#39;s own recent GL raises — the unusual postings a founder should look at (outliers, reversals, round-offs, uncosted revenue, an overdrawn wallet), sharpest first. An empty list means the books look clean; the detector is deterministic over the ledger and invents nothing.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;; anything else reads the live one.
+    # @return [Array<(QuestionsResponse, Integer, Hash)>] QuestionsResponse data, response status code and response headers
+    def get_books_questions_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_questions ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/questions'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'QuestionsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_questions",
+        :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: BooksApi#get_books_questions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's auto-categorization rules, highest priority first.
+    # Returns the org's auto-categorization rules, highest priority first. A rule is a standing instruction — \"anything whose merchant contains X books to category Y\" — and it overrides a vendor's default category, so this is the list that decides how a future bill classifies itself.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;; anything else reads the live one.
+    # @return [RulesOut]
+    def get_books_rules(opts = {})
+      data, _status_code, _headers = get_books_rules_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s auto-categorization rules, highest priority first.
+    # Returns the org&#39;s auto-categorization rules, highest priority first. A rule is a standing instruction — \&quot;anything whose merchant contains X books to category Y\&quot; — and it overrides a vendor&#39;s default category, so this is the list that decides how a future bill classifies itself.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;; anything else reads the live one.
+    # @return [Array<(RulesOut, Integer, Hash)>] RulesOut data, response status code and response headers
+    def get_books_rules_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_rules ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/rules'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RulesOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_rules",
+        :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: BooksApi#get_books_rules\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's booked ledger as a single-line register, newest first: one row per voucher, with its date, description, vendor, category, source and amount in exact cents.
+    # Returns the org's booked ledger as a single-line register, newest first: one row per voucher, with its date, description, vendor, category, source and amount in exact cents. It is the double-entry ledger projected to the register a human reads, filterable by posting-time window, category and vendor. Strictly read-only — it restates the books, it never moves them.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :from From is the RFC3339 start of the posting-time window, inclusive.
+    # @option opts [String] :to To is the RFC3339 end of the posting-time window, inclusive.
+    # @option opts [String] :category Category filters to one COA account, named by number (\&quot;5300\&quot;) or by category slug (\&quot;software\&quot;).
+    # @option opts [String] :vendor Vendor filters to rows whose vendor or description contains this text, case-insensitively.
+    # @option opts [Integer] :limit Limit caps how many rows come back; 200 when absent or not positive.
+    # @return [TransactionsOut]
+    def get_books_transactions(opts = {})
+      data, _status_code, _headers = get_books_transactions_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s booked ledger as a single-line register, newest first: one row per voucher, with its date, description, vendor, category, source and amount in exact cents.
+    # Returns the org&#39;s booked ledger as a single-line register, newest first: one row per voucher, with its date, description, vendor, category, source and amount in exact cents. It is the double-entry ledger projected to the register a human reads, filterable by posting-time window, category and vendor. Strictly read-only — it restates the books, it never moves them.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :from From is the RFC3339 start of the posting-time window, inclusive.
+    # @option opts [String] :to To is the RFC3339 end of the posting-time window, inclusive.
+    # @option opts [String] :category Category filters to one COA account, named by number (\&quot;5300\&quot;) or by category slug (\&quot;software\&quot;).
+    # @option opts [String] :vendor Vendor filters to rows whose vendor or description contains this text, case-insensitively.
+    # @option opts [Integer] :limit Limit caps how many rows come back; 200 when absent or not positive.
+    # @return [Array<(TransactionsOut, Integer, Hash)>] TransactionsOut data, response status code and response headers
+    def get_books_transactions_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_transactions ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/transactions'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+      query_params[:'from'] = opts[:'from'] if !opts[:'from'].nil?
+      query_params[:'to'] = opts[:'to'] if !opts[:'to'].nil?
+      query_params[:'category'] = opts[:'category'] if !opts[:'category'].nil?
+      query_params[:'vendor'] = opts[:'vendor'] if !opts[:'vendor'].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']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TransactionsOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_transactions",
+        :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: BooksApi#get_books_transactions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's trial balance over an optional [from, to] window of RFC3339 posting times, including the opening/closing columns and the TotalDebit == TotalCredit proof that the books balance.
+    # Returns the org's trial balance over an optional [from, to] window of RFC3339 posting times, including the opening/closing columns and the TotalDebit == TotalCredit proof that the books balance.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :from From is the RFC3339 start of the window, exclusive. Empty means all time.
+    # @option opts [String] :to To is the RFC3339 end of the window, inclusive. Empty means up to now.
+    # @return [TrialBalance]
+    def get_books_trial(opts = {})
+      data, _status_code, _headers = get_books_trial_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s trial balance over an optional [from, to] window of RFC3339 posting times, including the opening/closing columns and the TotalDebit &#x3D;&#x3D; TotalCredit proof that the books balance.
+    # Returns the org&#39;s trial balance over an optional [from, to] window of RFC3339 posting times, including the opening/closing columns and the TotalDebit &#x3D;&#x3D; TotalCredit proof that the books balance.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;.
+    # @option opts [String] :from From is the RFC3339 start of the window, exclusive. Empty means all time.
+    # @option opts [String] :to To is the RFC3339 end of the window, inclusive. Empty means up to now.
+    # @return [Array<(TrialBalance, Integer, Hash)>] TrialBalance data, response status code and response headers
+    def get_books_trial_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_trial ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/trial'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+      query_params[:'from'] = opts[:'from'] if !opts[:'from'].nil?
+      query_params[:'to'] = opts[:'to'] if !opts[:'to'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TrialBalance'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_trial",
+        :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: BooksApi#get_books_trial\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's vendor book: each canonical vendor, the alias spellings a receipt may print it under, and the expense account new bills from it default to.
+    # Returns the org's vendor book: each canonical vendor, the alias spellings a receipt may print it under, and the expense account new bills from it default to. A vendor here is what makes a scanned bill self-classify instead of asking again.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;; anything else reads the live one.
+    # @return [VendorsOut]
+    def get_books_vendors(opts = {})
+      data, _status_code, _headers = get_books_vendors_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s vendor book: each canonical vendor, the alias spellings a receipt may print it under, and the expense account new bills from it default to.
+    # Returns the org&#39;s vendor book: each canonical vendor, the alias spellings a receipt may print it under, and the expense account new bills from it default to. A vendor here is what makes a scanned bill self-classify instead of asking again.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sandbox Sandbox reads the org&#39;s SANDBOX ledger when it is exactly \&quot;true\&quot;; anything else reads the live one.
+    # @return [Array<(VendorsOut, Integer, Hash)>] VendorsOut data, response status code and response headers
+    def get_books_vendors_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.get_books_vendors ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/vendors'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'sandbox'] = opts[:'sandbox'] if !opts[:'sandbox'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'VendorsOut'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.get_books_vendors",
+        :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: BooksApi#get_books_vendors\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Answers a plain-language question about the caller's own books — \"what is my MRR?\", \"how long is my runway?\" — with figures taken from their ledger, never a guessed number.
+    # Answers a plain-language question about the caller's own books — \"what is my MRR?\", \"how long is my runway?\" — with figures taken from their ledger, never a guessed number. A deterministic keyword router picks the intent and reads the real metrics, and those figures, followups and report sources are computed BEFORE any model call and are never altered by one: the optional narration client only rephrases the sentence, and it degrades silently to the templated answer when no AI plane is wired. It is strictly read-only — it restates the books, it never posts to them.
+    # @param ask_request [AskRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [AskResponse]
+    def post_books_ask(ask_request, opts = {})
+      data, _status_code, _headers = post_books_ask_with_http_info(ask_request, opts)
+      data
+    end
+
+    # Answers a plain-language question about the caller&#39;s own books — \&quot;what is my MRR?\&quot;, \&quot;how long is my runway?\&quot; — with figures taken from their ledger, never a guessed number.
+    # Answers a plain-language question about the caller&#39;s own books — \&quot;what is my MRR?\&quot;, \&quot;how long is my runway?\&quot; — with figures taken from their ledger, never a guessed number. A deterministic keyword router picks the intent and reads the real metrics, and those figures, followups and report sources are computed BEFORE any model call and are never altered by one: the optional narration client only rephrases the sentence, and it degrades silently to the templated answer when no AI plane is wired. It is strictly read-only — it restates the books, it never posts to them.
+    # @param ask_request [AskRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AskResponse, Integer, Hash)>] AskResponse data, response status code and response headers
+    def post_books_ask_with_http_info(ask_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.post_books_ask ...'
+      end
+      # verify the required parameter 'ask_request' is set
+      if @api_client.config.client_side_validation && ask_request.nil?
+        fail ArgumentError, "Missing the required parameter 'ask_request' when calling BooksApi.post_books_ask"
+      end
+      # resource path
+      local_var_path = '/v1/books/ask'
+
+      # 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']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(ask_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AskResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.post_books_ask",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BooksApi#post_books_ask\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Finish connecting a bank account (not yet available)
+    # ANSWERS 501 UNCONDITIONALLY. It is the intended second hop of the bank-linking handshake — trade the provider's short-lived public token for the durable access credential and seal that credential into KMS — and nothing on the HTTP path reaches an implementation today.  The durable bank credential is the reason this hop exists: it is meant to be sealed server-side and never handed back to the caller. Since the route never succeeds, no credential is stored by it and no bank is connected through it.  Documented as refusing rather than declared with a success body, for the same reason as the first hop: it has never sent one, and stating a shape it has never produced would put a return type in every SDK for a call that always fails. A caller with no principal gets 401 before the 501.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def post_books_bank_exchange(opts = {})
+      post_books_bank_exchange_with_http_info(opts)
+      nil
+    end
+
+    # Finish connecting a bank account (not yet available)
+    # ANSWERS 501 UNCONDITIONALLY. It is the intended second hop of the bank-linking handshake — trade the provider&#39;s short-lived public token for the durable access credential and seal that credential into KMS — and nothing on the HTTP path reaches an implementation today.  The durable bank credential is the reason this hop exists: it is meant to be sealed server-side and never handed back to the caller. Since the route never succeeds, no credential is stored by it and no bank is connected through it.  Documented as refusing rather than declared with a success body, for the same reason as the first hop: it has never sent one, and stating a shape it has never produced would put a return type in every SDK for a call that always fails. A caller with no principal gets 401 before the 501.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_books_bank_exchange_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.post_books_bank_exchange ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/bank/exchange'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.post_books_bank_exchange",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BooksApi#post_books_bank_exchange\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Import a bank statement file into your books
+    # Takes a bank statement as RAW BYTES — the file exactly as downloaded, OFX, QFX or CSV, not wrapped in JSON — parses every row, books it against the caller org's own ledger, and answers the tally: how many rows were seen, how many vouchers posted, how many inflows reconciled, how many raised a question, how many were own-account transfers, and how many were skipped.  RE-IMPORTING THE SAME STATEMENT DOES NOT DOUBLE-BOOK. Every row goes through the same posting choke point every other source uses, keyed idempotently, so an overlapping statement — the usual case, since exports overlap at the month boundary — lands its new rows and counts the rest as skipped. Skipped is the number to read on a second import.  It is READ-ONLY against the bank: this ingests, it never sends money. Scoped to the caller's own org from the validated principal, and refused without one; `sandbox=true` writes the org's sandbox ledger instead of its real books. An empty body is a 400, and a file the parser cannot read is a 400 carrying the parser's reason rather than a partial import. On a deployment whose import parser is not built, this answers 501 rather than mishandling the file.
+    # @param [Hash] opts the optional parameters
+    # @option opts [File] :body 
+    # @return [BankTally]
+    def post_books_bank_import(opts = {})
+      data, _status_code, _headers = post_books_bank_import_with_http_info(opts)
+      data
+    end
+
+    # Import a bank statement file into your books
+    # Takes a bank statement as RAW BYTES — the file exactly as downloaded, OFX, QFX or CSV, not wrapped in JSON — parses every row, books it against the caller org&#39;s own ledger, and answers the tally: how many rows were seen, how many vouchers posted, how many inflows reconciled, how many raised a question, how many were own-account transfers, and how many were skipped.  RE-IMPORTING THE SAME STATEMENT DOES NOT DOUBLE-BOOK. Every row goes through the same posting choke point every other source uses, keyed idempotently, so an overlapping statement — the usual case, since exports overlap at the month boundary — lands its new rows and counts the rest as skipped. Skipped is the number to read on a second import.  It is READ-ONLY against the bank: this ingests, it never sends money. Scoped to the caller&#39;s own org from the validated principal, and refused without one; &#x60;sandbox&#x3D;true&#x60; writes the org&#39;s sandbox ledger instead of its real books. An empty body is a 400, and a file the parser cannot read is a 400 carrying the parser&#39;s reason rather than a partial import. On a deployment whose import parser is not built, this answers 501 rather than mishandling the file.
+    # @param [Hash] opts the optional parameters
+    # @option opts [File] :body 
+    # @return [Array<(BankTally, Integer, Hash)>] BankTally data, response status code and response headers
+    def post_books_bank_import_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.post_books_bank_import ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/bank/import'
+
+      # 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']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/octet-stream'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BankTally'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.post_books_bank_import",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BooksApi#post_books_bank_import\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Pulls every connected bank (Plaid/Teller) for the caller's org, maps each fetched transaction to a posting and books it idempotently, then advances that connector's cursor so the next sync resumes where this one stopped.
+    # Pulls every connected bank (Plaid/Teller) for the caller's org, maps each fetched transaction to a posting and books it idempotently, then advances that connector's cursor so the next sync resumes where this one stopped. One connector's outage is skipped rather than failing the whole sync. It reports the batch: how many transactions were seen, how many vouchers posted, how many inflows reconciled against the processor clearing account, how many raised a question, how many were own-account transfers, and how many were already-processed no-ops. It is READ-ONLY against the bank — it ingests, it never sends money.
+    # @param [Hash] opts the optional parameters
+    # @return [BankTally]
+    def post_books_bank_sync(opts = {})
+      data, _status_code, _headers = post_books_bank_sync_with_http_info(opts)
+      data
+    end
+
+    # Pulls every connected bank (Plaid/Teller) for the caller&#39;s org, maps each fetched transaction to a posting and books it idempotently, then advances that connector&#39;s cursor so the next sync resumes where this one stopped.
+    # Pulls every connected bank (Plaid/Teller) for the caller&#39;s org, maps each fetched transaction to a posting and books it idempotently, then advances that connector&#39;s cursor so the next sync resumes where this one stopped. One connector&#39;s outage is skipped rather than failing the whole sync. It reports the batch: how many transactions were seen, how many vouchers posted, how many inflows reconciled against the processor clearing account, how many raised a question, how many were own-account transfers, and how many were already-processed no-ops. It is READ-ONLY against the bank — it ingests, it never sends money.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(BankTally, Integer, Hash)>] BankTally data, response status code and response headers
+    def post_books_bank_sync_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.post_books_bank_sync ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/bank/sync'
+
+      # 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']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BankTally'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.post_books_bank_sync",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BooksApi#post_books_bank_sync\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Begin connecting a bank account (not yet available)
+    # ANSWERS 501 UNCONDITIONALLY. It is the intended first hop of the bank-linking handshake — mint the short-lived session token a browser hands to the provider's link widget — and nothing on the HTTP path reaches an implementation today.  The connectors behind it are written and tested; only the wiring is missing, so an org cannot connect a bank through the API at all. Until that lands, bank data reaches the books by statement import.  It is documented as refusing rather than declared with a success body precisely because it has never sent one. A response schema here would be invention: every generated SDK would carry a return type for a call that has only ever failed. A caller with no principal gets 401 before the 501.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def post_books_bank_token(opts = {})
+      post_books_bank_token_with_http_info(opts)
+      nil
+    end
+
+    # Begin connecting a bank account (not yet available)
+    # ANSWERS 501 UNCONDITIONALLY. It is the intended first hop of the bank-linking handshake — mint the short-lived session token a browser hands to the provider&#39;s link widget — and nothing on the HTTP path reaches an implementation today.  The connectors behind it are written and tested; only the wiring is missing, so an org cannot connect a bank through the API at all. Until that lands, bank data reaches the books by statement import.  It is documented as refusing rather than declared with a success body precisely because it has never sent one. A response schema here would be invention: every generated SDK would carry a return type for a call that has only ever failed. A caller with no principal gets 401 before the 501.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_books_bank_token_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.post_books_bank_token ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/bank/token'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.post_books_bank_token",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BooksApi#post_books_bank_token\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Queue a document for later scanning
+    # Takes a document as RAW BYTES and queues it in the caller org's inbox as `unsorted`, answering the queued item. It is the drop box: get the paperwork in now, read it later.  It EXTRACTS NOTHING and calls no model — that is what separates it from the scan. Nothing is proposed and nothing is posted; the item simply waits to be scanned, and a booked document leaves the queue.  IDEMPOTENT BY CONTENT: the item's id is the file hash, so re-uploading the same bytes answers the existing item rather than adding a duplicate row — and it is the same id a scan of those bytes uses, which is how the two routes address one document. Scoped to the caller's own org from the validated principal and refused without one; `sandbox=true` targets the sandbox ledger, and `filename` is recorded for display. An empty or oversized upload is a 400.
+    # @param [Hash] opts the optional parameters
+    # @option opts [File] :body 
+    # @return [InboxItem]
+    def post_books_inbox(opts = {})
+      data, _status_code, _headers = post_books_inbox_with_http_info(opts)
+      data
+    end
+
+    # Queue a document for later scanning
+    # Takes a document as RAW BYTES and queues it in the caller org&#39;s inbox as &#x60;unsorted&#x60;, answering the queued item. It is the drop box: get the paperwork in now, read it later.  It EXTRACTS NOTHING and calls no model — that is what separates it from the scan. Nothing is proposed and nothing is posted; the item simply waits to be scanned, and a booked document leaves the queue.  IDEMPOTENT BY CONTENT: the item&#39;s id is the file hash, so re-uploading the same bytes answers the existing item rather than adding a duplicate row — and it is the same id a scan of those bytes uses, which is how the two routes address one document. Scoped to the caller&#39;s own org from the validated principal and refused without one; &#x60;sandbox&#x3D;true&#x60; targets the sandbox ledger, and &#x60;filename&#x60; is recorded for display. An empty or oversized upload is a 400.
+    # @param [Hash] opts the optional parameters
+    # @option opts [File] :body 
+    # @return [Array<(InboxItem, Integer, Hash)>] InboxItem data, response status code and response headers
+    def post_books_inbox_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.post_books_inbox ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/inbox'
+
+      # 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']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/octet-stream'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'InboxItem'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.post_books_inbox",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BooksApi#post_books_inbox\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Creates or updates one auto-categorization rule, keyed by its pattern — writing a pattern that already exists REPLACES that row's category and priority.
+    # Creates or updates one auto-categorization rule, keyed by its pattern — writing a pattern that already exists REPLACES that row's category and priority. The category is normalized to a real COA expense account, and anything unrecognized becomes 5900 Uncategorized rather than a guessed real account. It answers the row exactly as stored, so the caller sees the normalization. A rule overrides a vendor's default category, so this is the standing instruction that decides how a future bill classifies.
+    # @param rule [Rule] 
+    # @param [Hash] opts the optional parameters
+    # @return [Rule]
+    def post_books_rules(rule, opts = {})
+      data, _status_code, _headers = post_books_rules_with_http_info(rule, opts)
+      data
+    end
+
+    # Creates or updates one auto-categorization rule, keyed by its pattern — writing a pattern that already exists REPLACES that row&#39;s category and priority.
+    # Creates or updates one auto-categorization rule, keyed by its pattern — writing a pattern that already exists REPLACES that row&#39;s category and priority. The category is normalized to a real COA expense account, and anything unrecognized becomes 5900 Uncategorized rather than a guessed real account. It answers the row exactly as stored, so the caller sees the normalization. A rule overrides a vendor&#39;s default category, so this is the standing instruction that decides how a future bill classifies.
+    # @param rule [Rule] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Rule, Integer, Hash)>] Rule data, response status code and response headers
+    def post_books_rules_with_http_info(rule, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.post_books_rules ...'
+      end
+      # verify the required parameter 'rule' is set
+      if @api_client.config.client_side_validation && rule.nil?
+        fail ArgumentError, "Missing the required parameter 'rule' when calling BooksApi.post_books_rules"
+      end
+      # resource path
+      local_var_path = '/v1/books/rules'
+
+      # 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']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(rule)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Rule'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.post_books_rules",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BooksApi#post_books_rules\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Scan a receipt or invoice into a proposed voucher
+    # Takes a receipt or invoice as RAW BYTES — a PDF, an image or plain text, uploaded under its own content type, not wrapped in JSON — extracts what the document says, resolves the vendor's expense category, and answers a DRAFT carrying a balanced voucher proposed for it.  NOTHING IS POSTED. That split is the whole design: the model only ever produces a structured reading of the document, the voucher is assembled deterministically in Go from that reading, and the ledger is written only by the separate book call a human confirms. So a misread scan can propose a wrong draft; it cannot move money. Amounts are exact integer cents end to end — the extraction returns cents, never a decimal — so no rounding enters the ledger.  The draft's id is the FILE HASH, and that is what makes booking idempotent: re-scanning the same bytes addresses the same draft rather than queuing a second one. A row is written to the org's document inbox as a side effect, moving it from unsorted to draft. Scoped to the caller's own org from the validated principal and refused without one; `sandbox=true` targets the sandbox ledger, and `filename` is recorded for the inbox. An empty or oversized upload is a 400, and a deployment with no scanner model answers 501.
+    # @param [Hash] opts the optional parameters
+    # @option opts [File] :body 
+    # @return [ScanDraft]
+    def post_books_scan(opts = {})
+      data, _status_code, _headers = post_books_scan_with_http_info(opts)
+      data
+    end
+
+    # Scan a receipt or invoice into a proposed voucher
+    # Takes a receipt or invoice as RAW BYTES — a PDF, an image or plain text, uploaded under its own content type, not wrapped in JSON — extracts what the document says, resolves the vendor&#39;s expense category, and answers a DRAFT carrying a balanced voucher proposed for it.  NOTHING IS POSTED. That split is the whole design: the model only ever produces a structured reading of the document, the voucher is assembled deterministically in Go from that reading, and the ledger is written only by the separate book call a human confirms. So a misread scan can propose a wrong draft; it cannot move money. Amounts are exact integer cents end to end — the extraction returns cents, never a decimal — so no rounding enters the ledger.  The draft&#39;s id is the FILE HASH, and that is what makes booking idempotent: re-scanning the same bytes addresses the same draft rather than queuing a second one. A row is written to the org&#39;s document inbox as a side effect, moving it from unsorted to draft. Scoped to the caller&#39;s own org from the validated principal and refused without one; &#x60;sandbox&#x3D;true&#x60; targets the sandbox ledger, and &#x60;filename&#x60; is recorded for the inbox. An empty or oversized upload is a 400, and a deployment with no scanner model answers 501.
+    # @param [Hash] opts the optional parameters
+    # @option opts [File] :body 
+    # @return [Array<(ScanDraft, Integer, Hash)>] ScanDraft data, response status code and response headers
+    def post_books_scan_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.post_books_scan ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/scan'
+
+      # 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']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/octet-stream'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ScanDraft'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.post_books_scan",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BooksApi#post_books_scan\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Posts a reviewed scanned bill to the ledger.
+    # Posts a reviewed scanned bill to the ledger. It is the scanner's ONLY write: the voucher goes through the same post() choke point every other source uses, so it is checked to balance (Σdebit == Σcredit) and is idempotent by (scan, scanId) — re-booking the same scan answers posted=false and writes nothing. A bill whose economic identity (vendor, total, issue date) already posted under a DIFFERENT scan is refused 409 unless override is set, which is what stops the same receipt re-scanned into a new file hash from double-booking. An unbalanced voucher is refused 400.
+    # @param book_request [BookRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [BookResponse]
+    def post_books_scan_book(book_request, opts = {})
+      data, _status_code, _headers = post_books_scan_book_with_http_info(book_request, opts)
+      data
+    end
+
+    # Posts a reviewed scanned bill to the ledger.
+    # Posts a reviewed scanned bill to the ledger. It is the scanner&#39;s ONLY write: the voucher goes through the same post() choke point every other source uses, so it is checked to balance (Σdebit &#x3D;&#x3D; Σcredit) and is idempotent by (scan, scanId) — re-booking the same scan answers posted&#x3D;false and writes nothing. A bill whose economic identity (vendor, total, issue date) already posted under a DIFFERENT scan is refused 409 unless override is set, which is what stops the same receipt re-scanned into a new file hash from double-booking. An unbalanced voucher is refused 400.
+    # @param book_request [BookRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(BookResponse, Integer, Hash)>] BookResponse data, response status code and response headers
+    def post_books_scan_book_with_http_info(book_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.post_books_scan_book ...'
+      end
+      # verify the required parameter 'book_request' is set
+      if @api_client.config.client_side_validation && book_request.nil?
+        fail ArgumentError, "Missing the required parameter 'book_request' when calling BooksApi.post_books_scan_book"
+      end
+      # resource path
+      local_var_path = '/v1/books/scan/book'
+
+      # 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']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(book_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BookResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.post_books_scan_book",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BooksApi#post_books_scan_book\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Sync ingests the caller's OWN org from commerce into BOTH ledgers (live and sandbox) and reports how many new vouchers posted to each.
+    # Sync ingests the caller's OWN org from commerce into BOTH ledgers (live and sandbox) and reports how many new vouchers posted to each. It is idempotent — money that has already been booked posts nothing on a repeat — and it is read-only against commerce: it never mints a deposit, a credit or a payout, only the accounting twin of money that already moved.
+    # @param [Hash] opts the optional parameters
+    # @return [SyncTally]
+    def post_books_sync(opts = {})
+      data, _status_code, _headers = post_books_sync_with_http_info(opts)
+      data
+    end
+
+    # Sync ingests the caller&#39;s OWN org from commerce into BOTH ledgers (live and sandbox) and reports how many new vouchers posted to each.
+    # Sync ingests the caller&#39;s OWN org from commerce into BOTH ledgers (live and sandbox) and reports how many new vouchers posted to each. It is idempotent — money that has already been booked posts nothing on a repeat — and it is read-only against commerce: it never mints a deposit, a credit or a payout, only the accounting twin of money that already moved.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SyncTally, Integer, Hash)>] SyncTally data, response status code and response headers
+    def post_books_sync_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.post_books_sync ...'
+      end
+      # resource path
+      local_var_path = '/v1/books/sync'
+
+      # 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']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SyncTally'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.post_books_sync",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BooksApi#post_books_sync\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Creates or updates one vendor in the org's vendor book, keyed by its canonical name — writing a canonical name that already exists REPLACES that row's aliases and default category.
+    # Creates or updates one vendor in the org's vendor book, keyed by its canonical name — writing a canonical name that already exists REPLACES that row's aliases and default category. A category given as a slug (\"software\") is normalized to its real COA expense account, and anything unrecognized becomes 5900 Uncategorized rather than a guessed real account. It answers the row exactly as stored, so the caller sees the normalization. Recording a vendor is what makes future bills from it self-classify instead of asking again.
+    # @param vendor_row [VendorRow] 
+    # @param [Hash] opts the optional parameters
+    # @return [VendorRow]
+    def post_books_vendors(vendor_row, opts = {})
+      data, _status_code, _headers = post_books_vendors_with_http_info(vendor_row, opts)
+      data
+    end
+
+    # Creates or updates one vendor in the org&#39;s vendor book, keyed by its canonical name — writing a canonical name that already exists REPLACES that row&#39;s aliases and default category.
+    # Creates or updates one vendor in the org&#39;s vendor book, keyed by its canonical name — writing a canonical name that already exists REPLACES that row&#39;s aliases and default category. A category given as a slug (\&quot;software\&quot;) is normalized to its real COA expense account, and anything unrecognized becomes 5900 Uncategorized rather than a guessed real account. It answers the row exactly as stored, so the caller sees the normalization. Recording a vendor is what makes future bills from it self-classify instead of asking again.
+    # @param vendor_row [VendorRow] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(VendorRow, Integer, Hash)>] VendorRow data, response status code and response headers
+    def post_books_vendors_with_http_info(vendor_row, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BooksApi.post_books_vendors ...'
+      end
+      # verify the required parameter 'vendor_row' is set
+      if @api_client.config.client_side_validation && vendor_row.nil?
+        fail ArgumentError, "Missing the required parameter 'vendor_row' when calling BooksApi.post_books_vendors"
+      end
+      # resource path
+      local_var_path = '/v1/books/vendors'
+
+      # 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']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(vendor_row)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'VendorRow'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"BooksApi.post_books_vendors",
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BooksApi#post_books_vendors\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end