qube_sync 0.3.0 → 0.4.0

data/lib/qube_sync/operations/special_item.rb

@@ -0,0 +1,44 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks special item operations, reached as `client.special_item`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class SpecialItem < Base
+      # Create special item: POST /connections/{connection_id}/special-items
+      # (`special_item.create`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the JSON body:
+      # - `bar_code` (Hash): Barcode reference information.
+      #   - `allow_override` (Boolean): Allows for barcode to be overridden for an item.
+      #   - `assign_even_if_used` (Boolean): Allow barcode to be assigned to item, even if already
+      #     in use.
+      #   - `bar_code_value` (String): Value of the barcode in the item.
+      # - `external_guid` (String): Allows for the attachment of a user defined GUID value.
+      # - `include_ret_element` (Array<one of "BarCodeValue", "ClassRef", "DataExtRet",
+      #   "EditSequence", "ExternalGUID", "FullName", "IsActive", "IsPrintItemsInGroup",
+      #   "IsTaxIncluded", "ItemDesc", "ItemGroupLine", "ListID", "Name", "ParentRef",
+      #   "SalesAndPurchase", "SalesOrPurchase", "SalesTaxCodeRef", "SpecialItemType", "Sublevel",
+      #   "TimeCreated", "TimeModified", "UnitOfMeasureSetRef">)
+      # - `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`.
+      # - `special_item_type` (one of "FinanceCharge", "ReimbursableExpenseGroup",
+      #   "ReimbursableExpenseSubtotal", required): Identifies the type of special item. See type
+      #   for possible enum values.
+      #
+      # @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/special-items/create-special-item
+      def create(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("special_item.create", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/standard_terms.rb

@@ -0,0 +1,125 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks standard terms operations, reached as `client.standard_terms`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class StandardTerms < Base
+      # Create standard terms: POST /connections/{connection_id}/standard-terms
+      # (`standard_terms.create`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the JSON body:
+      # - `discount_pct` (Numeric): If payment is received within `std_discount_days` number of
+      #   days, then this discount will apply to the payment. `discount_pct` must be between 0 and
+      #   100.
+      # - `include_ret_element` (Array<one of "DiscountPct", "EditSequence", "ExternalGUID",
+      #   "IsActive", "ListID", "Name", "OwnerID", "StdDiscountDays", "StdDueDays", "TimeCreated",
+      #   "TimeModified", "TxnID", "TxnNumber">)
+      # - `is_active` (Boolean): If `is_active` is true, this object is currently enabled for use by
+      #   QuickBooks. The default value is true.
+      # - `name` (String, required): Name is the case-insensitive short name of a list object
+      #   (without ancestors). It must be unique within its hierarchy scope. Hierarchical lists can
+      #   reuse the same Name in different branches because FullName remains distinct.
+      # - `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`.
+      # - `std_discount_days` (Integer): If payment is received within `std_discount_days` number of
+      #   days, then `discount_pct` will apply to the payment.
+      # - `std_due_days` (Integer): The number of days until payment is due.
+      #
+      # @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/standard-terms/create-standard-terms
+      def create(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("standard_terms.create", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+
+      # List standard terms: GET /connections/{connection_id}/standard-terms
+      # (`standard_terms.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `active_status` (one of "ActiveOnly", "All", "InactiveOnly"): Used in filters to select
+      #   list objects based on whether or not they are currently enabled for use by QuickBooks. The
+      #   default value is asActiveOnly, which selects only list objects that are active. Choose at
+      #   most one of: `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set
+      #   combine with each other, not with the other choices.
+      # - `from_modified_date` (String): Filters results to objects modified on or after this
+      #   timestamp. QuickBooks Desktop accepts 1970-01-01 through 2038-01-19T03:14:07. If only a
+      #   date is provided, time defaults to 00:00:00. Choose at most one of: `list_id`, or
+      #   `full_name`, or the set (`active_status`, `from_modified_date`, `max_returned`,
+      #   `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set combine with
+      #   each other, not with the other choices.
+      # - `full_name` (Array<String>): Choose at most one of: `list_id`, or `full_name`, or the set
+      #   (`active_status`, `from_modified_date`, `max_returned`, `name_filter`,
+      #   `name_range_filter`, `to_modified_date`). Members of a set combine with each other, not
+      #   with the other choices.
+      # - `include_ret_element` (Array<one of "DiscountPct", "EditSequence", "IsActive", "ListID",
+      #   "Name", "StdDiscountDays", "StdDueDays", "TimeCreated", "TimeModified">)
+      # - `list_id` (Array<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`. Choose at most
+      #   one of: `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set
+      #   combine with each other, not with the other choices.
+      # - `max_returned` (Integer): Limits the number of objects that a query returns. (To get a
+      #   count of how many objects could possibly be returned, use the `meta_data` query
+      #   attribute.) If you include a `max_returned` value, it must be at least 1. 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:
+      #   `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set
+      #   combine with each other, not with the other choices.
+      # - `meta_data` (one of "MetaDataAndResponseData", "MetaDataOnly", "NoMetaData"): Use the
+      #   `meta_data` attribute to control whether query responses include counts. Options are
+      #   NoMetaData (default), MetaDataOnly (count only), and MetaDataAndResponseData (count plus
+      #   objects). Counts are approximate and may vary slightly if records are created or deleted
+      #   during processing.
+      # - `name_filter` (Hash): Filters according to the object’s Name. Choose at most one of:
+      #   `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set
+      #   combine with each other, not with the other choices.
+      #   - `match_criterion` (one of "Contains", "EndsWith", "StartsWith", required): The criterion
+      #     to match.
+      #   - `name` (String, required): The string to match.
+      # - `name_range_filter` (Hash): Filters according to the object’s Name. Choose at most one of:
+      #   `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set
+      #   combine with each other, not with the other choices.
+      #   - `from_name` (String): The first name or item in the search range. If `from_name` is
+      #     omitted, the range will begin with first name on the list.
+      #   - `to_name` (String): The final name or item in the search range. If `to_name` is omitted,
+      #     the range will end with last name on the list.
+      # - `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`.
+      # - `to_modified_date` (String): Filters results to objects modified on or before this
+      #   timestamp. QuickBooks Desktop accepts 1970-01-01 through 2038-01-19T03:14:07. If only a
+      #   date is provided, time defaults to end-of-day (23:59:59). Choose at most one of:
+      #   `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). 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/standard-terms/list-standard-terms
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("standard_terms.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/template.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 template operations, reached as `client.template`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class Template < Base
+      # List templates: GET /connections/{connection_id}/templates (`template.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `include_ret_element` (Array<one of "EditSequence", "IsActive", "ListID", "Name",
+      #   "TemplateType", "TimeCreated", "TimeModified">)
+      # - `meta_data` (one of "MetaDataAndResponseData", "MetaDataOnly", "NoMetaData"): Use the
+      #   `meta_data` attribute to control whether query responses include counts. Options are
+      #   NoMetaData (default), MetaDataOnly (count only), and MetaDataAndResponseData (count plus
+      #   objects). Counts are approximate and may vary slightly if records are created or deleted
+      #   during processing.
+      # - `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/templates/list-templates
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("template.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/terms.rb

@@ -0,0 +1,91 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks terms operations, reached as `client.terms`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class Terms < Base
+      # List terms: GET /connections/{connection_id}/terms (`terms.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `active_status` (one of "ActiveOnly", "All", "InactiveOnly"): Used in filters to select
+      #   list objects based on whether or not they are currently enabled for use by QuickBooks. The
+      #   default value is asActiveOnly, which selects only list objects that are active. Choose at
+      #   most one of: `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set
+      #   combine with each other, not with the other choices.
+      # - `from_modified_date` (String): Filters results to objects modified on or after this
+      #   timestamp. QuickBooks Desktop accepts 1970-01-01 through 2038-01-19T03:14:07. If only a
+      #   date is provided, time defaults to 00:00:00. Choose at most one of: `list_id`, or
+      #   `full_name`, or the set (`active_status`, `from_modified_date`, `max_returned`,
+      #   `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set combine with
+      #   each other, not with the other choices.
+      # - `full_name` (Array<String>): Choose at most one of: `list_id`, or `full_name`, or the set
+      #   (`active_status`, `from_modified_date`, `max_returned`, `name_filter`,
+      #   `name_range_filter`, `to_modified_date`). Members of a set combine with each other, not
+      #   with the other choices.
+      # - `include_ret_element` (Array<one of "DayOfMonthDue", "DiscountDayOfMonth", "DiscountPct",
+      #   "DueNextMonthDays", "EditSequence", "IsActive", "ListID", "Name", "StdDiscountDays",
+      #   "StdDueDays", "TimeCreated", "TimeModified">)
+      # - `list_id` (Array<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`. Choose at most
+      #   one of: `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set
+      #   combine with each other, not with the other choices.
+      # - `max_returned` (Integer): Limits the number of objects that a query returns. (To get a
+      #   count of how many objects could possibly be returned, use the `meta_data` query
+      #   attribute.) If you include a `max_returned` value, it must be at least 1. 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:
+      #   `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set
+      #   combine with each other, not with the other choices.
+      # - `meta_data` (one of "MetaDataAndResponseData", "MetaDataOnly", "NoMetaData"): Use the
+      #   `meta_data` attribute to control whether query responses include counts. Options are
+      #   NoMetaData (default), MetaDataOnly (count only), and MetaDataAndResponseData (count plus
+      #   objects). Counts are approximate and may vary slightly if records are created or deleted
+      #   during processing.
+      # - `name_filter` (Hash): Filters according to the object’s Name. Choose at most one of:
+      #   `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set
+      #   combine with each other, not with the other choices.
+      #   - `match_criterion` (one of "Contains", "EndsWith", "StartsWith", required): The criterion
+      #     to match.
+      #   - `name` (String, required): The string to match.
+      # - `name_range_filter` (Hash): Filters according to the object’s Name. Choose at most one of:
+      #   `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). Members of a set
+      #   combine with each other, not with the other choices.
+      #   - `from_name` (String): The first name or item in the search range. If `from_name` is
+      #     omitted, the range will begin with first name on the list.
+      #   - `to_name` (String): The final name or item in the search range. If `to_name` is omitted,
+      #     the range will end with last name on the list.
+      # - `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`.
+      # - `to_modified_date` (String): Filters results to objects modified on or before this
+      #   timestamp. QuickBooks Desktop accepts 1970-01-01 through 2038-01-19T03:14:07. If only a
+      #   date is provided, time defaults to end-of-day (23:59:59). Choose at most one of:
+      #   `list_id`, or `full_name`, or the set (`active_status`, `from_modified_date`,
+      #   `max_returned`, `name_filter`, `name_range_filter`, `to_modified_date`). 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/terms/list-terms
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("terms.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/time_report.rb

@@ -0,0 +1,127 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks time report operations, reached as `client.time_report`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class TimeReport < Base
+      # List time reports: GET /connections/{connection_id}/time-reports (`time_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_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">)
+      # - `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_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_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_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.
+      # - `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.
+      # - `time_report_type` (one of "TimeByItem", "TimeByJobDetail", "TimeByJobSummary",
+      #   "TimeByName", required): Allows you to report on time that has been recorded in a
+      #   particular category.
+      #
+      # @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/time-reports/list-time-reports
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("time_report.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end