qube_sync 0.3.0 → 0.4.0

data/lib/qube_sync/operations/form1099_category_account_mapping.rb

@@ -0,0 +1,90 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks form1099 category account mapping operations, reached as `client.form1099_category_account_mapping`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class Form1099CategoryAccountMapping < Base
+      # List form1099 category account mappings: GET
+      # /connections/{connection_id}/form1099-category-account-mappings
+      # (`form1099_category_account_mapping.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `form_type` (String): Added a form type to support Form 1099-NEC and Form 1099-MISC.
+      #   `form_type` is a property to identify the type of form (MISC/NEC) for which
+      #   Form1099CategoryAccountMapping query is run. Form type will be MISC if no `form_type` is
+      #   specified.
+      # - `mapping_category` (Array<one of "BOX1", "BOX10", "BOX13", "BOX14", "BOX2", "BOX3",
+      #   "BOX4", "BOX5", "BOX6", "BOX7", "BOX8", "BOX9">): A mapping category indicates the form
+      #   1099 box that one or more accounts is being mapped to. You must specify one of the
+      #   following enumerated values based on the form type:
+      # - `request_id` (String): Your own label for the request, sent to QuickBooks as its qbXML
+      #   `requestID` and echoed in the raw answer (`response_xml`); optional, since the answer's
+      #   webhook already carries the request's `id`.
+      #
+      # @param connection_id [String]
+      # @param params [Hash] the fields above
+      # @param webhook_url [String] where QuBe Sync sends the answer
+      # @param idempotency_key [String, nil] made for the call when nil, and reused on its retries
+      # @return [Hash] the queued request
+      # @see https://docs.qubesync.com/api-reference/v2/form1099-category-account-mappings/list-form1099-category-account-mappings
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("form1099_category_account_mapping.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+
+      # Update form1099 category account mapping: PUT
+      # /connections/{connection_id}/form1099-category-account-mappings
+      # (`form1099_category_account_mapping.update`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the JSON body:
+      # - `category_account_mapping_mod` (Array<Hash>)
+      #   - `mapping_account` (Array<Hash>)
+      #     - `account_ref` (Hash, required): `account_ref` points to an account in the company
+      #       file. If both `full_name` and `list_id` are provided, `full_name` is ignored. Meaning
+      #       depends on context: for checks it is the funding account; for ExpenseLineAdd it may be
+      #       required by accounting preferences; for credit-card transactions it identifies the
+      #       bank or card account involved.
+      #       - `full_name` (String): `full_name` (along with `list_id`) is a way to identify a list
+      #         object. The `full_name` is the name prefixed by the names of each ancestor, for
+      #         example Jones:Kitchen:Cabinets. `full_name` values aren’t case-sensitive.
+      #       - `list_id` (String): `list_id` and `full_name` both identify a list object.
+      #         QuickBooks assigns `list_id` when the object is created. `list_id` values are unique
+      #         within a list type, not globally across all lists. If both `full_name` and `list_id`
+      #         are supplied in a request, QuickBooks uses `list_id` and ignores `full_name`.
+      #     - `force_mapping` (Boolean): In some circumstances, changing the account mapping could
+      #       result in the displaying of a user dialog in the QuickBooks UI prompting the user to
+      #       confirm, which would prevent the SDK request from completing. Setting this property to
+      #       true causes that user dialog to be suppressed.
+      #   - `mapping_category` (one of "BOX1", "BOX10", "BOX13", "BOX14", "BOX2", "BOX3", "BOX4",
+      #     "BOX5", "BOX6", "BOX7", "BOX8", "BOX9", required): A mapping category indicates the form
+      #     1099 box that one or more accounts is being mapped to. You must specify one of the
+      #     following enumerated values based on the form type:
+      #   - `threshold` (Numeric): This is the dollar amount at which the IRS requires you to file
+      #     the 1099-MISC and 1099-NEC forms. Each box (“Category” in SDK lingo) can have a separate
+      #     threshold, as established by the IRS. For the latest thresholds, check the website for
+      #     the Internal Revenue Service, currently at www.irs.gov.
+      # - `is_filing1099_misc` (Boolean): This property reports only (it doesn’t set!) the current
+      #   status of 1099 preferences setting in the company file. The value true indicates that the
+      #   company file currently has the 1099 filing preference turned on. The value false indicates
+      #   that the company file isn’t currently set to file 1099-MISC and 1099-NEC forms.
+      # - `request_id` (String): Your own label for the request, sent to QuickBooks as its qbXML
+      #   `requestID` and echoed in the raw answer (`response_xml`); optional, since the answer's
+      #   webhook already carries the request's `id`.
+      #
+      # @param connection_id [String]
+      # @param params [Hash] the fields above
+      # @param webhook_url [String] where QuBe Sync sends the answer
+      # @param idempotency_key [String, nil] made for the call when nil, and reused on its retries
+      # @return [Hash] the queued request
+      # @see https://docs.qubesync.com/api-reference/v2/form1099-category-account-mappings/update-form1099-category-account-mapping
+      def update(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("form1099_category_account_mapping.update", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/general_detail_report.rb

@@ -0,0 +1,185 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks general detail report operations, reached as `client.general_detail_report`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class GeneralDetailReport < Base
+      # List general detail reports: GET /connections/{connection_id}/general-detail-reports
+      # (`general_detail_report.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `display_report` (Boolean): Set `display_report` to true to display this report within the
+      #   QuickBooks UI. (Default is false.) If you want the request to display the report without
+      #   returning any data to your application, set the responseData attribute to includeNone.
+      # - `general_detail_report_type` (one of "1099Detail", "AuditTrail", "BalanceSheetDetail",
+      #   "CheckDetail", "CustomerBalanceDetail", "DepositDetail", "EstimatesByJob",
+      #   "ExpenseByVendorDetail", "GeneralLedger", "IncomeByCustomerDetail", "IncomeTaxDetail",
+      #   "InventoryValuationDetail", "JobProgressInvoicesVsEstimates", "Journal", "MissingChecks",
+      #   "OpenInvoices", "OpenPOs", "OpenPOsByJob", "OpenSalesOrderByCustomer",
+      #   "OpenSalesOrderByItem", "PendingSales", "ProfitAndLossDetail", "PurchaseByItemDetail",
+      #   "PurchaseByVendorDetail", "SalesByCustomerDetail", "SalesByItemDetail",
+      #   "SalesByRepDetail", "TxnDetailByAccount", "TxnListByCustomer", "TxnListByDate",
+      #   "TxnListByVendor", "UnbilledCostsByJob", "UnpaidBillsDetail", "VendorBalanceDetail",
+      #   required): The type of general detail report to return. (If you specify gdrtMissingChecks,
+      #   you must also specify an account type in the account filter.)
+      # - `include_accounts` (one of "All", "InUse"): Indicates whether this report should include
+      #   all accounts or just those that are currently in use.
+      # - `include_column` (Array<one of "Account", "Aging", "Amount", "AmountDifference",
+      #   "AverageCost", "BilledDate", "BillingStatus", "CalculatedAmount", "Class",
+      #   "ClearedStatus", "CostPrice", "Credit", "Currency", "Date", "Debit", "DeliveryDate",
+      #   "DueDate", "EstimateActive", "ExchangeRate", "FOB", "IncomeSubjectToTax", "Invoiced",
+      #   "Item", "ItemDesc", "LastModifiedBy", "LatestOrPriorState", "Memo", "ModifiedTime",
+      #   "Name", "NameAccountNumber", "NameAddress", "NameCity", "NameContact", "NameEmail",
+      #   "NameFax", "NamePhone", "NameState", "NameZip", "OpenBalance", "OriginalAmount",
+      #   "PONumber", "PaidAmount", "PaidStatus", "PaidThroughDate", "PaymentMethod", "PayrollItem",
+      #   "PrintStatus", "ProgressAmount", "ProgressPercent", "Quantity", "QuantityAvailable",
+      #   "QuantityOnHand", "QuantityOnSalesOrder", "ReceivedQuantity", "RefNumber",
+      #   "RunningBalance", "SSNOrTaxID", "SalesRep", "SalesTaxCode", "SerialOrLotNumber",
+      #   "ShipDate", "ShipMethod", "SourceName", "SplitAccount", "TaxLine", "TaxTableVersion",
+      #   "Terms", "TxnID", "TxnNumber", "TxnType", "UnitPrice", "UserEdit", "ValueOnHand",
+      #   "WageBase", "WageBaseTips">)
+      # - `report_account_filter` (Hash): Allows you to query for a specified account type or for
+      #   specific list elements.
+      #   Give at most one of: `account_type_filter`, or `list_id`, or `full_name`, or
+      #   `list_id_with_children`, or `full_name_with_children`.
+      #   - `account_type_filter` (one of "APAndSalesTax", "APOrCreditCard", "ARAndAP",
+      #     "AccountsPayable", "AccountsReceivable", "AllowedFor1099", "Asset", "BalanceSheet",
+      #     "Bank", "BankAndARAndAPAndUF", "BankAndUF", "CostOfSales", "CreditCard", "CurrentAsset",
+      #     "CurrentAssetAndExpense", "CurrentLiability", "Equity", "EquityAndIncomeAndExpense",
+      #     "ExpenseAndOtherExpense", "FixedAsset", "IncomeAndExpense", "IncomeAndOtherIncome",
+      #     "Liability", "LiabilityAndEquity", "LongTermLiability", "NonPosting", "OrdinaryExpense",
+      #     "OrdinaryIncome", "OrdinaryIncomeAndCOGS", "OrdinaryIncomeAndExpense", "OtherAsset",
+      #     "OtherCurrentAsset", "OtherCurrentLiability", "OtherExpense", "OtherIncome",
+      #     "OtherIncomeOrExpense"): Allows you to report on a specific account type.
+      #   - `full_name` (Array<String>)
+      #   - `full_name_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants. For names that don’t have children,
+      #     `full_name_with_children` is exactly the same as `full_name`.
+      #   - `list_id` (Array<String>)
+      #   - `list_id_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants.
+      # - `report_basis` (one of "Accrual", "Cash", "None"): If `report_basis` is rbCash, the report
+      #   bases income and expenses on the dates when money changed hands.rbAccrual, the report
+      #   bases income on the dates when customers were invoiced and bases expenses on the dates
+      #   when bills were entered.rbNone, the report uses the default `report_basis`, which is
+      #   either the QuickBooks Preference setting or the QuickBooks default for a given type of
+      #   report.
+      # - `report_class_filter` (Hash): Allows you to query for a specified class. Classes can be
+      #   used to separate transactions into meaningful categories. (For example, transactions could
+      #   be classified according to department, business location, or type of work.) In QuickBooks,
+      #   class tracking is off by default.
+      #   Give at most one of: `list_id`, or `full_name`, or `list_id_with_children`, or
+      #   `full_name_with_children`.
+      #   - `full_name` (Array<String>)
+      #   - `full_name_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants. For names that don’t have children,
+      #     `full_name_with_children` is exactly the same as `full_name`.
+      #   - `list_id` (Array<String>)
+      #   - `list_id_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants.
+      # - `report_date_macro` (one of "All", "LastMonth", "LastMonthToDate", "LastQuarter",
+      #   "LastQuarterToDate", "LastWeek", "LastWeekToDate", "LastYear", "LastYearToDate",
+      #   "NextFourWeeks", "NextMonth", "NextQuarter", "NextWeek", "NextYear", "ThisMonth",
+      #   "ThisMonthToDate", "ThisQuarter", "ThisQuarterToDate", "ThisWeek", "ThisWeekToDate",
+      #   "ThisYear", "ThisYearToDate", "Today", "Yesterday"): The time period covered by this
+      #   report. Choose at most one of: `report_period`, or `report_date_macro`.
+      # - `report_detail_level_filter` (one of "All", "AllExceptSummary", "SummaryOnly"): The level
+      #   of detail to include in the report.
+      # - `report_entity_filter` (Hash): Allows you to query for a specified name type (customer,
+      #   employee, vendor, or other) or query for specific list elements.
+      #   Give at most one of: `entity_type_filter`, or `list_id`, or `full_name`, or
+      #   `list_id_with_children`, or `full_name_with_children`.
+      #   - `entity_type_filter` (one of "Customer", "Employee", "OtherName", "Vendor"): Allows you
+      #     to report on a specific name type.
+      #   - `full_name` (Array<String>)
+      #   - `full_name_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants. For names that don’t have children,
+      #     `full_name_with_children` is exactly the same as `full_name`.
+      #   - `list_id` (Array<String>)
+      #   - `list_id_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants.
+      # - `report_item_filter` (Hash): Allows you to query for a specified item type (for example,
+      #   discount, inventory, or non-inventory) or query for specific list elements.
+      #   Give at most one of: `item_type_filter`, or `list_id`, or `full_name`, or
+      #   `list_id_with_children`, or `full_name_with_children`.
+      #   - `full_name` (Array<String>)
+      #   - `full_name_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants. For names that don’t have children,
+      #     `full_name_with_children` is exactly the same as `full_name`.
+      #   - `item_type_filter` (one of "AllExceptFixedAsset", "Assembly", "Discount", "FixedAsset",
+      #     "Inventory", "InventoryAndAssembly", "NonInventory", "OtherCharge", "Payment", "Sales",
+      #     "SalesTax", "Service"): Allows you to report on a specific item type.
+      #   - `list_id` (Array<String>)
+      #   - `list_id_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants.
+      # - `report_modified_date_range_filter` (Hash): Returns reports that were modified between
+      #   these two dates (inclusive). The range of acceptable dates for both
+      #   `from_report_modified_date` and `to_report_modified_date` is 1970-01-01 to
+      #   2038-01-19T03:14:07 (2038-01-18T19:14:07-08:00 PST). Choose at most one of:
+      #   `report_modified_date_range_filter`, or `report_modified_date_range_macro`.
+      #   - `from_report_modified_date` (String): Selects information from this date and later. The
+      #     range of acceptable dates is 1970-01-01 to 2038-01-19T03:14:07
+      #     (2038-01-18T19:14:07-08:00 PST).
+      #   - `to_report_modified_date` (String): Selects information created on this date or earlier.
+      #     The range of acceptable dates is 1970-01-01 to 2038-01-19T03:14:07
+      #     (2038-01-18T19:14:07-08:00 PST).
+      # - `report_modified_date_range_macro` (one of "All", "LastMonth", "LastMonthToDate",
+      #   "LastQuarter", "LastQuarterToDate", "LastWeek", "LastWeekToDate", "LastYear",
+      #   "LastYearToDate", "NextFourWeeks", "NextMonth", "NextQuarter", "NextWeek", "NextYear",
+      #   "ThisMonth", "ThisMonthToDate", "ThisQuarter", "ThisQuarterToDate", "ThisWeek",
+      #   "ThisWeekToDate", "ThisYear", "ThisYearToDate", "Today", "Yesterday"): The time period
+      #   covered by this report. Choose at most one of: `report_modified_date_range_filter`, or
+      #   `report_modified_date_range_macro`.
+      # - `report_open_balance_as_of` (one of "ReportEndDate", "Today"): The report will return open
+      #   balance information up to the `report_open_balance_as_of` date.
+      # - `report_period` (Hash): If you omit both `to_report_date` and `from_report_date`, the
+      #   report will cover the current fiscal year to date. Choose at most one of: `report_period`,
+      #   or `report_date_macro`.
+      #   - `from_report_date` (String): Selects information from this date and later. The range of
+      #     acceptable `from_report_date` and `to_report_date` values depends on how the report
+      #     dates are determined. If the report dates are based on the dates of transactions, the
+      #     range is 01/01/1901 to 12/31/9999.
+      #   - `to_report_date` (String): Selects information created on this date or earlier. The
+      #     range of acceptable `to_report_date` and `from_report_date` values depends on how the
+      #     report dates are determined. If the report dates are based on the dates of transactions,
+      #     the range is 01/01/1901 to 12/31/9999.
+      # - `report_posting_status_filter` (one of "Either", "NonPosting", "Posting"): Allows you to
+      #   query for posting reports, non-posting reports, or reports that are either one.
+      # - `report_txn_type_filter` (Hash): Allows you to report on specific transaction types (for
+      #   example, charge, check, deposit, or estimate).
+      #   - `txn_type_filter` (Array<one of "ARRefundCreditCard", "All", "Bill", "BillPaymentCheck",
+      #     "BillPaymentCreditCard", "BuildAssembly", "Charge", "Check", "CreditCardCharge",
+      #     "CreditCardCredit", "CreditMemo", "Deposit", "Estimate", "InventoryAdjustment",
+      #     "Invoice", "ItemReceipt", "JournalEntry", "LiabilityAdjustment", "Paycheck",
+      #     "PayrollLiabilityCheck", "PurchaseOrder", "ReceivePayment", "SalesOrder",
+      #     "SalesReceipt", "SalesTaxPaymentCheck", "Transfer", "VendorCredit", "YTDAdjustment">,
+      #     required)
+      # - `request_id` (String): Your own label for the request, sent to QuickBooks as its qbXML
+      #   `requestID` and echoed in the raw answer (`response_xml`); optional, since the answer's
+      #   webhook already carries the request's `id`.
+      # - `summarize_rows_by` (one of "Account", "BalanceSheet", "Class", "Customer",
+      #   "CustomerType", "Day", "Employee", "FourWeek", "HalfMonth", "IncomeStatement",
+      #   "ItemDetail", "ItemType", "Month", "Payee", "PaymentMethod", "PayrollItemDetail",
+      #   "PayrollYtdDetail", "Quarter", "SalesRep", "SalesTaxCode", "ShipMethod", "TaxLine",
+      #   "Terms", "TotalOnly", "TwoWeek", "Vendor", "VendorType", "Week", "Year"):
+      #   `summarize_rows_by` (along with IncludeColumnList, in most cases) determines what data is
+      #   calculated for this report and controls how the rows are organized and labeled. For
+      #   example, if you set the value to srbAccount, the report’s row labels might be “Checking,”
+      #   “Savings,” and so on.
+      #
+      # @param connection_id [String]
+      # @param params [Hash] the fields above
+      # @param webhook_url [String] where QuBe Sync sends the answer
+      # @param idempotency_key [String, nil] made for the call when nil, and reused on its retries
+      # @return [Hash] the queued request
+      # @see https://docs.qubesync.com/api-reference/v2/general-detail-reports/list-general-detail-reports
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("general_detail_report.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/general_summary_report.rb

@@ -0,0 +1,180 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks general summary report operations, reached as `client.general_summary_report`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class GeneralSummaryReport < Base
+      # List general summary reports: GET /connections/{connection_id}/general-summary-reports
+      # (`general_summary_report.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `display_report` (Boolean): Set `display_report` to true to display this report within the
+      #   QuickBooks UI. (Default is false.) If you want the request to display the report without
+      #   returning any data to your application, set the responseData attribute to includeNone.
+      # - `general_summary_report_type` (one of "BalanceSheetByClass", "BalanceSheetPrevYearComp",
+      #   "BalanceSheetStandard", "BalanceSheetSummary", "CustomerBalanceSummary",
+      #   "ExpenseByVendorSummary", "IncomeByCustomerSummary", "IncomeTaxSummary",
+      #   "InventoryStockStatusByItem", "InventoryStockStatusByVendor", "InventoryValuationSummary",
+      #   "InventoryValuationSummaryBySite", "LotNumberInStockBySite", "PhysicalInventoryWorksheet",
+      #   "ProfitAndLossByClass", "ProfitAndLossByJob", "ProfitAndLossPrevYearComp",
+      #   "ProfitAndLossStandard", "ProfitAndLossYTDComp", "PurchaseByItemSummary",
+      #   "PurchaseByVendorSummary", "SalesByCustomerSummary", "SalesByItemSummary",
+      #   "SalesByRepSummary", "SalesTaxLiability", "SalesTaxRevenueSummary",
+      #   "SerialNumberInStockBySite", "TrialBalance", "VendorBalanceSummary", required): The type
+      #   of general summary report being queried. The report types listed below map almost directly
+      #   to named reports in QuickBooks.
+      # - `include_subcolumns` (Boolean): The default value is false, which means that the report
+      #   won’t include any subcolumn information. To include all available types of subcolumns for
+      #   this report, set `include_subcolumns` to true. The SDK won’t return subcolumn information
+      #   for data that can be easily computed. (For example, the SDK doesn’t return the “percent of
+      #   row” column.)
+      # - `report_account_filter` (Hash): Allows you to query for a specified account type or for
+      #   specific list elements.
+      #   Give at most one of: `account_type_filter`, or `list_id`, or `full_name`, or
+      #   `list_id_with_children`, or `full_name_with_children`.
+      #   - `account_type_filter` (one of "APAndSalesTax", "APOrCreditCard", "ARAndAP",
+      #     "AccountsPayable", "AccountsReceivable", "AllowedFor1099", "Asset", "BalanceSheet",
+      #     "Bank", "BankAndARAndAPAndUF", "BankAndUF", "CostOfSales", "CreditCard", "CurrentAsset",
+      #     "CurrentAssetAndExpense", "CurrentLiability", "Equity", "EquityAndIncomeAndExpense",
+      #     "ExpenseAndOtherExpense", "FixedAsset", "IncomeAndExpense", "IncomeAndOtherIncome",
+      #     "Liability", "LiabilityAndEquity", "LongTermLiability", "NonPosting", "OrdinaryExpense",
+      #     "OrdinaryIncome", "OrdinaryIncomeAndCOGS", "OrdinaryIncomeAndExpense", "OtherAsset",
+      #     "OtherCurrentAsset", "OtherCurrentLiability", "OtherExpense", "OtherIncome",
+      #     "OtherIncomeOrExpense"): Allows you to report on a specific account type.
+      #   - `full_name` (Array<String>)
+      #   - `full_name_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants. For names that don’t have children,
+      #     `full_name_with_children` is exactly the same as `full_name`.
+      #   - `list_id` (Array<String>)
+      #   - `list_id_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants.
+      # - `report_basis` (one of "Accrual", "Cash", "None"): If `report_basis` is rbCash, the report
+      #   bases income and expenses on the dates when money changed hands.rbAccrual, the report
+      #   bases income on the dates when customers were invoiced and bases expenses on the dates
+      #   when bills were entered.rbNone, the report uses the default `report_basis`, which is
+      #   either the QuickBooks Preference setting or the QuickBooks default for a given type of
+      #   report.
+      # - `report_calendar` (one of "CalendarYear", "FiscalYear", "TaxYear"): Specifies the type of
+      #   year that will be used for this report.
+      # - `report_class_filter` (Hash): Allows you to query for a specified class. Classes can be
+      #   used to separate transactions into meaningful categories. (For example, transactions could
+      #   be classified according to department, business location, or type of work.) In QuickBooks,
+      #   class tracking is off by default.
+      #   Give at most one of: `list_id`, or `full_name`, or `list_id_with_children`, or
+      #   `full_name_with_children`.
+      #   - `full_name` (Array<String>)
+      #   - `full_name_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants. For names that don’t have children,
+      #     `full_name_with_children` is exactly the same as `full_name`.
+      #   - `list_id` (Array<String>)
+      #   - `list_id_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants.
+      # - `report_date_macro` (one of "All", "LastMonth", "LastMonthToDate", "LastQuarter",
+      #   "LastQuarterToDate", "LastWeek", "LastWeekToDate", "LastYear", "LastYearToDate",
+      #   "NextFourWeeks", "NextMonth", "NextQuarter", "NextWeek", "NextYear", "ThisMonth",
+      #   "ThisMonthToDate", "ThisQuarter", "ThisQuarterToDate", "ThisWeek", "ThisWeekToDate",
+      #   "ThisYear", "ThisYearToDate", "Today", "Yesterday"): The time period covered by this
+      #   report. Choose at most one of: `report_period`, or `report_date_macro`.
+      # - `report_detail_level_filter` (one of "All", "AllExceptSummary", "SummaryOnly"): The level
+      #   of detail to include in the report.
+      # - `report_entity_filter` (Hash): Allows you to query for a specified name type (customer,
+      #   employee, vendor, or other) or query for specific list elements.
+      #   Give at most one of: `entity_type_filter`, or `list_id`, or `full_name`, or
+      #   `list_id_with_children`, or `full_name_with_children`.
+      #   - `entity_type_filter` (one of "Customer", "Employee", "OtherName", "Vendor"): Allows you
+      #     to report on a specific name type.
+      #   - `full_name` (Array<String>)
+      #   - `full_name_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants. For names that don’t have children,
+      #     `full_name_with_children` is exactly the same as `full_name`.
+      #   - `list_id` (Array<String>)
+      #   - `list_id_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants.
+      # - `report_item_filter` (Hash): Allows you to query for a specified item type (for example,
+      #   discount, inventory, or non-inventory) or query for specific list elements.
+      #   Give at most one of: `item_type_filter`, or `list_id`, or `full_name`, or
+      #   `list_id_with_children`, or `full_name_with_children`.
+      #   - `full_name` (Array<String>)
+      #   - `full_name_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants. For names that don’t have children,
+      #     `full_name_with_children` is exactly the same as `full_name`.
+      #   - `item_type_filter` (one of "AllExceptFixedAsset", "Assembly", "Discount", "FixedAsset",
+      #     "Inventory", "InventoryAndAssembly", "NonInventory", "OtherCharge", "Payment", "Sales",
+      #     "SalesTax", "Service"): Allows you to report on a specific item type.
+      #   - `list_id` (Array<String>)
+      #   - `list_id_with_children` (String): Allows you to filter for data that relates to the
+      #     specified object and its descendants.
+      # - `report_modified_date_range_filter` (Hash): Returns reports that were modified between
+      #   these two dates (inclusive). The range of acceptable dates for both
+      #   `from_report_modified_date` and `to_report_modified_date` is 1970-01-01 to
+      #   2038-01-19T03:14:07 (2038-01-18T19:14:07-08:00 PST). Choose at most one of:
+      #   `report_modified_date_range_filter`, or `report_modified_date_range_macro`.
+      #   - `from_report_modified_date` (String): Selects information from this date and later. The
+      #     range of acceptable dates is 1970-01-01 to 2038-01-19T03:14:07
+      #     (2038-01-18T19:14:07-08:00 PST).
+      #   - `to_report_modified_date` (String): Selects information created on this date or earlier.
+      #     The range of acceptable dates is 1970-01-01 to 2038-01-19T03:14:07
+      #     (2038-01-18T19:14:07-08:00 PST).
+      # - `report_modified_date_range_macro` (one of "All", "LastMonth", "LastMonthToDate",
+      #   "LastQuarter", "LastQuarterToDate", "LastWeek", "LastWeekToDate", "LastYear",
+      #   "LastYearToDate", "NextFourWeeks", "NextMonth", "NextQuarter", "NextWeek", "NextYear",
+      #   "ThisMonth", "ThisMonthToDate", "ThisQuarter", "ThisQuarterToDate", "ThisWeek",
+      #   "ThisWeekToDate", "ThisYear", "ThisYearToDate", "Today", "Yesterday"): The time period
+      #   covered by this report. Choose at most one of: `report_modified_date_range_filter`, or
+      #   `report_modified_date_range_macro`.
+      # - `report_period` (Hash): If you omit both `to_report_date` and `from_report_date`, the
+      #   report will cover the current fiscal year to date. Choose at most one of: `report_period`,
+      #   or `report_date_macro`.
+      #   - `from_report_date` (String): Selects information from this date and later. The range of
+      #     acceptable `from_report_date` and `to_report_date` values depends on how the report
+      #     dates are determined. If the report dates are based on the dates of transactions, the
+      #     range is 01/01/1901 to 12/31/9999.
+      #   - `to_report_date` (String): Selects information created on this date or earlier. The
+      #     range of acceptable `to_report_date` and `from_report_date` values depends on how the
+      #     report dates are determined. If the report dates are based on the dates of transactions,
+      #     the range is 01/01/1901 to 12/31/9999.
+      # - `report_posting_status_filter` (one of "Either", "NonPosting", "Posting"): Allows you to
+      #   query for posting reports, non-posting reports, or reports that are either one.
+      # - `report_txn_type_filter` (Hash): Allows you to report on specific transaction types (for
+      #   example, charge, check, deposit, or estimate).
+      #   - `txn_type_filter` (Array<one of "ARRefundCreditCard", "All", "Bill", "BillPaymentCheck",
+      #     "BillPaymentCreditCard", "BuildAssembly", "Charge", "Check", "CreditCardCharge",
+      #     "CreditCardCredit", "CreditMemo", "Deposit", "Estimate", "InventoryAdjustment",
+      #     "Invoice", "ItemReceipt", "JournalEntry", "LiabilityAdjustment", "Paycheck",
+      #     "PayrollLiabilityCheck", "PurchaseOrder", "ReceivePayment", "SalesOrder",
+      #     "SalesReceipt", "SalesTaxPaymentCheck", "Transfer", "VendorCredit", "YTDAdjustment">,
+      #     required)
+      # - `request_id` (String): Your own label for the request, sent to QuickBooks as its qbXML
+      #   `requestID` and echoed in the raw answer (`response_xml`); optional, since the answer's
+      #   webhook already carries the request's `id`.
+      # - `return_columns` (one of "ActiveOnly", "All", "NonZero"): Specifies whether you want the
+      #   report to include only columns with active information, only columns with nonzero values,
+      #   or all columns regardless of their content or active status.
+      # - `return_rows` (one of "ActiveOnly", "All", "NonZero"): Specifies whether you want the
+      #   report to include only rows with active information, only rows with nonzero values, or all
+      #   rows regardless of their content or active status.
+      # - `summarize_columns_by` (one of "Account", "BalanceSheet", "Class", "Customer",
+      #   "CustomerType", "Day", "Employee", "FourWeek", "HalfMonth", "IncomeStatement",
+      #   "ItemDetail", "ItemType", "Month", "Payee", "PaymentMethod", "PayrollItemDetail",
+      #   "PayrollYtdDetail", "Quarter", "SalesRep", "SalesTaxCode", "ShipMethod", "Terms",
+      #   "TotalOnly", "TwoWeek", "Vendor", "VendorType", "Week", "Year"): `summarize_columns_by`
+      #   determines which data the report calculates and how the columns will be labeled across the
+      #   top of the report. For example, if you set the value to scbTwoWeek, the report’s column
+      #   labels might be “Feb 10-23, 02,” “Feb 24-Mar9, 02,” and so on.
+      #
+      # @param connection_id [String]
+      # @param params [Hash] the fields above
+      # @param webhook_url [String] where QuBe Sync sends the answer
+      # @param idempotency_key [String, nil] made for the call when nil, and reused on its retries
+      # @return [Hash] the queued request
+      # @see https://docs.qubesync.com/api-reference/v2/general-summary-reports/list-general-summary-reports
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("general_summary_report.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/host.rb

@@ -0,0 +1,36 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks host operations, reached as `client.host`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class Host < Base
+      # List hosts: GET /connections/{connection_id}/hosts (`host.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `include_list_meta_data` (Hash): Use this aggregate if you want the query to return list
+      #   capacity metadata for each object type in QuickBooks.
+      #   - `include_max_capacity` (Boolean, required): Specify the value “true” to return max list
+      #     limits for each object type, or “false” to not return these in the query response. By
+      #     default, this is “false” for HostQuery.
+      # - `include_ret_element` (Array<one of "Country", "IsAutomaticLogin", "ListMetaData",
+      #   "MajorVersion", "MinorVersion", "ProductName", "QBFileMode", "SupportedQBXMLVersion">)
+      # - `request_id` (String): Your own label for the request, sent to QuickBooks as its qbXML
+      #   `requestID` and echoed in the raw answer (`response_xml`); optional, since the answer's
+      #   webhook already carries the request's `id`.
+      #
+      # @param connection_id [String]
+      # @param params [Hash] the fields above
+      # @param webhook_url [String] where QuBe Sync sends the answer
+      # @param idempotency_key [String, nil] made for the call when nil, and reused on its retries
+      # @return [Hash] the queued request
+      # @see https://docs.qubesync.com/api-reference/v2/hosts/list-hosts
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("host.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end