qube_sync 0.3.0 → 0.4.0

data/lib/qube_sync/operations/payroll_summary_report.rb

@@ -0,0 +1,157 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks payroll summary report operations, reached as `client.payroll_summary_report`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class PayrollSummaryReport < Base
+      # List payroll summary reports: GET /connections/{connection_id}/payroll-summary-reports
+      # (`payroll_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.
+      # - `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.)
+      # - `payroll_summary_report_type` (one of "EmployeeEarningsSummary",
+      #   "PayrollLiabilityBalances", "PayrollSummary", required): The type of payroll report:
+      #   psrtEmployeeEarningsSummary This report shows information similar to the payroll summary
+      #   report, but in a different layout.
+      # - `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_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.
+      # - `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/payroll-summary-reports/list-payroll-summary-reports
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("payroll_summary_report.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/payroll_year_to_date_adjustment.rb

@@ -0,0 +1,211 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks payroll year to date adjustment operations, reached as `client.payroll_year_to_date_adjustment`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class PayrollYearToDateAdjustment < Base
+      # Create payroll year to date adjustment: POST
+      # /connections/{connection_id}/payroll-year-to-date-adjustments
+      # (`payroll_year_to_date_adjustment.create`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the JSON body:
+      # - `account_ref` (Hash)
+      #   - `full_name` (String)
+      #   - `list_id` (String)
+      # - `class_ref` (Hash)
+      #   - `full_name` (String)
+      #   - `list_id` (String)
+      # - `def_macro` (String)
+      # - `employee_ref` (Hash, required)
+      #   - `full_name` (String)
+      #   - `list_id` (String)
+      # - `include_ret_element` (Array<one of "AccountRef", "Amount", "ClassRef", "EditSequence",
+      #   "EmployeeRef", "IsAffectingAccounts", "Memo", "PayPeriodBeginDate", "PayPeriodEndDate",
+      #   "PayrollDate", "PayrollYearToDateAdjustmentLineRet", "RefNumber", "TaxTableVersion",
+      #   "TimeCreated", "TimeModified", "TxnDate", "TxnID", "TxnNumber">)
+      # - `is_affecting_accounts` (Boolean, required)
+      # - `memo` (String)
+      # - `pay_period_begin_date` (String)
+      # - `pay_period_end_date` (String)
+      # - `payroll_date` (String)
+      # - `payroll_year_to_date_adjustment_line_add` (Array<Hash>, required)
+      #   - `account_ref` (Hash)
+      #     - `full_name` (String)
+      #     - `list_id` (String)
+      #   - `amount` (Numeric)
+      #   - `calculated_amount` (Numeric)
+      #   - `class_ref` (Hash)
+      #     - `full_name` (String)
+      #     - `list_id` (String)
+      #   - `company_paid_attribute` (one of "IsExpense", "IsLiability", "IsLiabilityAndExpense",
+      #     "NotApplicable")
+      #   - `experience_mod_rate_amount` (Numeric)
+      #   - `hours_worked` (String)
+      #   - `income_subject_to_tax_amount` (Numeric)
+      #   - `is_amount_overridden` (Boolean)
+      #   - `memo` (String)
+      #   - `other_account_ref` (Hash)
+      #     - `full_name` (String)
+      #     - `list_id` (String)
+      #   - `payroll_item_ref` (Hash)
+      #     - `full_name` (String)
+      #     - `list_id` (String)
+      #   - `rate` (Numeric): Choose at most one of: `rate`, or `rate_percent`.
+      #   - `rate_percent` (Numeric): Choose at most one of: `rate`, or `rate_percent`.
+      #   - `wage_base_amount` (Numeric)
+      #   - `workers_comp_amount` (Numeric)
+      #   - `workers_comp_code_ref` (Hash)
+      #     - `full_name` (String)
+      #     - `list_id` (String)
+      # - `ref_number` (String)
+      # - `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`.
+      # - `tax_table_version` (Integer)
+      # - `txn_date` (String)
+      #
+      # @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/payroll-year-to-date-adjustments/create-payroll-year-to-date-adjustment
+      def create(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("payroll_year_to_date_adjustment.create", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+
+      # List payroll year to date adjustments: GET
+      # /connections/{connection_id}/payroll-year-to-date-adjustments
+      # (`payroll_year_to_date_adjustment.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `account_filter` (Hash): Choose at most one of: `txn_id`, or `ref_number`, or
+      #   `ref_number_case_sensitive`, or the set (`account_filter`, `entity_filter`,
+      #   `max_returned`, `modified_date_range_filter`, `payroll_date_range_filter`,
+      #   `ref_number_filter`, `ref_number_range_filter`, `txn_date_range_filter`). Members of a set
+      #   combine with each other, not with the other choices.
+      #   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)
+      #   - `list_id` (Array<String>)
+      #   - `list_id_with_children` (String)
+      # - `entity_filter` (Hash): Choose at most one of: `txn_id`, or `ref_number`, or
+      #   `ref_number_case_sensitive`, or the set (`account_filter`, `entity_filter`,
+      #   `max_returned`, `modified_date_range_filter`, `payroll_date_range_filter`,
+      #   `ref_number_filter`, `ref_number_range_filter`, `txn_date_range_filter`). Members of a set
+      #   combine with each other, not with the other choices.
+      #   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)
+      #   - `list_id` (Array<String>)
+      #   - `list_id_with_children` (String)
+      # - `include_line_items` (Boolean)
+      # - `include_ret_element` (Array<one of "AccountRef", "Amount", "ClassRef", "EditSequence",
+      #   "EmployeeRef", "IsAffectingAccounts", "Memo", "PayPeriodBeginDate", "PayPeriodEndDate",
+      #   "PayrollDate", "PayrollYearToDateAdjustmentLineRet", "RefNumber", "TaxTableVersion",
+      #   "TimeCreated", "TimeModified", "TxnDate", "TxnID", "TxnNumber">)
+      # - `max_returned` (Integer): QuickBooks doesn't page this query: at most this many records
+      #   come back, in one answer, with no sign of whether more matched. Leave it out for every
+      #   match, in one answer; one over 4 MB as the Web Connector sends it, about 3 MB of qbXML
+      #   isn't kept (`error_type` `response_too_large`), so narrow a large one with its filters.
+      #   Choose at most one of: `txn_id`, or `ref_number`, or `ref_number_case_sensitive`, or the
+      #   set (`account_filter`, `entity_filter`, `max_returned`, `modified_date_range_filter`,
+      #   `payroll_date_range_filter`, `ref_number_filter`, `ref_number_range_filter`,
+      #   `txn_date_range_filter`). Members of a set combine with each other, not with the other
+      #   choices.
+      # - `meta_data` (one of "MetaDataAndResponseData", "MetaDataOnly", "NoMetaData")
+      # - `modified_date_range_filter` (Hash): Choose at most one of: `txn_id`, or `ref_number`, or
+      #   `ref_number_case_sensitive`, or the set (`account_filter`, `entity_filter`,
+      #   `max_returned`, `modified_date_range_filter`, `payroll_date_range_filter`,
+      #   `ref_number_filter`, `ref_number_range_filter`, `txn_date_range_filter`). Members of a set
+      #   combine with each other, not with the other choices.
+      #   - `from_modified_date` (String)
+      #   - `to_modified_date` (String)
+      # - `payroll_date_range_filter` (Hash): Choose at most one of: `txn_id`, or `ref_number`, or
+      #   `ref_number_case_sensitive`, or the set (`account_filter`, `entity_filter`,
+      #   `max_returned`, `modified_date_range_filter`, `payroll_date_range_filter`,
+      #   `ref_number_filter`, `ref_number_range_filter`, `txn_date_range_filter`). Members of a set
+      #   combine with each other, not with the other choices.
+      #   Give at most one of: `from_payroll_date` with `to_payroll_date`, or `date_macro`.
+      #   - `date_macro` (one of "All", "LastCalendarQuarter", "LastCalendarQuarterToDate",
+      #     "LastCalendarYear", "LastCalendarYearToDate", "LastFiscalQuarter",
+      #     "LastFiscalQuarterToDate", "LastFiscalYear", "LastFiscalYearToDate", "LastMonth",
+      #     "LastMonthToDate", "LastWeek", "LastWeekToDate", "NextCalendarQuarter",
+      #     "NextCalendarYear", "NextFiscalQuarter", "NextFiscalYear", "NextFourWeeks", "NextMonth",
+      #     "NextWeek", "ThisCalendarQuarter", "ThisCalendarQuarterToDate", "ThisCalendarYear",
+      #     "ThisCalendarYearToDate", "ThisFiscalQuarter", "ThisFiscalQuarterToDate",
+      #     "ThisFiscalYear", "ThisFiscalYearToDate", "ThisMonth", "ThisMonthToDate", "ThisWeek",
+      #     "ThisWeekToDate", "Today", "Yesterday")
+      #   - `from_payroll_date` (String)
+      #   - `to_payroll_date` (String)
+      # - `ref_number` (Array<String>): Choose at most one of: `txn_id`, or `ref_number`, or
+      #   `ref_number_case_sensitive`, or the set (`account_filter`, `entity_filter`,
+      #   `max_returned`, `modified_date_range_filter`, `payroll_date_range_filter`,
+      #   `ref_number_filter`, `ref_number_range_filter`, `txn_date_range_filter`). Members of a set
+      #   combine with each other, not with the other choices.
+      # - `ref_number_case_sensitive` (Array<String>): Choose at most one of: `txn_id`, or
+      #   `ref_number`, or `ref_number_case_sensitive`, or the set (`account_filter`,
+      #   `entity_filter`, `max_returned`, `modified_date_range_filter`,
+      #   `payroll_date_range_filter`, `ref_number_filter`, `ref_number_range_filter`,
+      #   `txn_date_range_filter`). Members of a set combine with each other, not with the other
+      #   choices.
+      # - `ref_number_filter` (Hash): Choose at most one of: `txn_id`, or `ref_number`, or
+      #   `ref_number_case_sensitive`, or the set (`account_filter`, `entity_filter`,
+      #   `max_returned`, `modified_date_range_filter`, `payroll_date_range_filter`,
+      #   `ref_number_filter`, `ref_number_range_filter`, `txn_date_range_filter`). Members of a set
+      #   combine with each other, not with the other choices.
+      #   - `match_criterion` (one of "Contains", "EndsWith", "StartsWith", required)
+      #   - `ref_number` (String, required)
+      # - `ref_number_range_filter` (Hash): Choose at most one of: `txn_id`, or `ref_number`, or
+      #   `ref_number_case_sensitive`, or the set (`account_filter`, `entity_filter`,
+      #   `max_returned`, `modified_date_range_filter`, `payroll_date_range_filter`,
+      #   `ref_number_filter`, `ref_number_range_filter`, `txn_date_range_filter`). Members of a set
+      #   combine with each other, not with the other choices.
+      #   - `from_ref_number` (String)
+      #   - `to_ref_number` (String)
+      # - `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`.
+      # - `txn_date_range_filter` (Hash): Choose at most one of: `txn_id`, or `ref_number`, or
+      #   `ref_number_case_sensitive`, or the set (`account_filter`, `entity_filter`,
+      #   `max_returned`, `modified_date_range_filter`, `payroll_date_range_filter`,
+      #   `ref_number_filter`, `ref_number_range_filter`, `txn_date_range_filter`). Members of a set
+      #   combine with each other, not with the other choices.
+      #   Give at most one of: `from_txn_date` with `to_txn_date`, or `date_macro`.
+      #   - `date_macro` (one of "All", "LastCalendarQuarter", "LastCalendarQuarterToDate",
+      #     "LastCalendarYear", "LastCalendarYearToDate", "LastFiscalQuarter",
+      #     "LastFiscalQuarterToDate", "LastFiscalYear", "LastFiscalYearToDate", "LastMonth",
+      #     "LastMonthToDate", "LastWeek", "LastWeekToDate", "NextCalendarQuarter",
+      #     "NextCalendarYear", "NextFiscalQuarter", "NextFiscalYear", "NextFourWeeks", "NextMonth",
+      #     "NextWeek", "ThisCalendarQuarter", "ThisCalendarQuarterToDate", "ThisCalendarYear",
+      #     "ThisCalendarYearToDate", "ThisFiscalQuarter", "ThisFiscalQuarterToDate",
+      #     "ThisFiscalYear", "ThisFiscalYearToDate", "ThisMonth", "ThisMonthToDate", "ThisWeek",
+      #     "ThisWeekToDate", "Today", "Yesterday")
+      #   - `from_txn_date` (String)
+      #   - `to_txn_date` (String)
+      # - `txn_id` (Array<String>): Choose at most one of: `txn_id`, or `ref_number`, or
+      #   `ref_number_case_sensitive`, or the set (`account_filter`, `entity_filter`,
+      #   `max_returned`, `modified_date_range_filter`, `payroll_date_range_filter`,
+      #   `ref_number_filter`, `ref_number_range_filter`, `txn_date_range_filter`). Members of a set
+      #   combine with each other, not with the other choices.
+      #
+      # @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/payroll-year-to-date-adjustments/list-payroll-year-to-date-adjustments
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("payroll_year_to_date_adjustment.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/preferences.rb

@@ -0,0 +1,61 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks preferences operations, reached as `client.preferences`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class Preferences < Base
+      # List preferences: GET /connections/{connection_id}/preferences (`preferences.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `include_ret_element` (Array<one of "AccountingPreferences", "CurrentAppAccessRights",
+      #   "FinanceChargePreferences", "ItemsAndInventoryPreferences", "JobsAndEstimatesPreferences",
+      #   "MultiCurrencyPreferences", "MultiLocationInventoryPreferences",
+      #   "PurchasesAndVendorsPreferences", "ReportsPreferences", "SalesAndCustomersPreferences",
+      #   "SalesTaxPreferences", "TimeTrackingPreferences">)
+      # - `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/preferences/list-preferences
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("preferences.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+
+      # Update preferences: PUT /connections/{connection_id}/preferences (`preferences.update`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the JSON body:
+      # - `accounting_preferences_mod` (Hash, required)
+      #   - `closing_date` (String)
+      #   - `closing_date_password` (String)
+      # - `include_ret_element` (Array<one of "AccountingPreferences", "CurrentAppAccessRights",
+      #   "FinanceChargePreferences", "ItemsAndInventoryPreferences", "JobsAndEstimatesPreferences",
+      #   "MultiCurrencyPreferences", "MultiLocationInventoryPreferences",
+      #   "PurchasesAndVendorsPreferences", "ReportsPreferences", "SalesAndCustomersPreferences",
+      #   "SalesTaxPreferences", "TimeTrackingPreferences">)
+      # - `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/preferences/update-preferences
+      def update(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("preferences.update", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end