qube_sync 0.3.0 → 0.4.0

data/lib/qube_sync/operations/account.rb

@@ -0,0 +1,337 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks account operations, reached as `client.account`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class Account < Base
+      # Create account: POST /connections/{connection_id}/accounts (`account.create`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the JSON body:
+      # - `account_number` (String): Account numbers appear in the QuickBooks chart of accounts,
+      #   Account fields, and reports and graphs. If the IsUsingAccountNumber preference is false
+      #   (that is, if the QuickBooks user has the account numbers Preference turned off), you can
+      #   still set account numbers through the SDK, but the numbers won’t be visible in the user
+      #   interface.
+      # - `account_type` (one of "AccountsPayable", "AccountsReceivable", "Bank", "CostOfGoodsSold",
+      #   "CreditCard", "Equity", "Expense", "FixedAsset", "Income", "LongTermLiability",
+      #   "NonPosting", "OtherAsset", "OtherCurrentAsset", "OtherCurrentLiability", "OtherExpense",
+      #   "OtherIncome", required): The type of QuickBooks account. You can’t create or modify a
+      #   non-posting account through the SDK, because QuickBooks creates these accounts behind the
+      #   scenes. This means that you can’t send an AccountAdd request with an `account_type` of
+      #   NonPosting.
+      # - `bank_number` (String): The bank account number or an identifying note about the account.
+      #   If a `bank_number` exists in a QuickBooks company file, it will only be returned to
+      #   applications that have been granted permission to access sensitive data and that are using
+      #   SDK v2.0 or greater.
+      # - `currency_ref` (Hash): A currency record defines how QuickBooks stores and displays a
+      #   currency. Built-in currency name/code values are fixed; formatting and active status can
+      #   vary by settings and workflow.
+      #   - `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`.
+      # - `desc` (String): A descriptive text field.
+      # - `detail_account_type` (one of "AP", "AR", "AccumulatedAdjustment",
+      #   "AccumulatedAmortization", "AccumulatedAmortizationOfOtherAssets", "AccumulatedDepletion",
+      #   "AccumulatedDepreciation", "AdvertisingOrPromotional", "AllowanceForBadDebts",
+      #   "Amortization", "Auto", "BadDebts", "BankCharges", "Buildings", "CashOnHand",
+      #   "CharitableContributions", "Checking", "CommonStock", "CostOfLabor", "CostOfLaborCOS",
+      #   "CreditCard", "DepletableAssets", "Depreciation", "DevelopmentCosts",
+      #   "DiscountsOrRefundsGiven", "DividendIncome", "DuesAndSubscriptions",
+      #   "EmployeeCashAdvances", "Entertainment", "EntertainmentMeals", "EquipmentRental",
+      #   "EquipmentRentalCOS", "FederalIncomeTaxPayable", "FurnitureAndFixtures", "Goodwill",
+      #   "Insurance", "InsurancePayable", "IntangibleAssets", "InterestEarned", "InterestPaid",
+      #   "Inventory", "InvestmentMortgageOrRealEstateLoans", "InvestmentOther",
+      #   "InvestmentTaxExemptSecurities", "InvestmentUSGovObligations", "Land", "LeaseBuyout",
+      #   "LeaseholdImprovements", "LegalAndProfessionalFees", "Licenses", "LineOfCredit",
+      #   "LoanPayable", "LoansToOfficers", "LoansToOthers", "LoansToStockholders",
+      #   "MachineryAndEquipment", "MoneyMarket", "NonProfitIncome", "NotesPayable",
+      #   "OfficeOrGeneralAdministrativeExpenses", "OpeningBalanceEquity", "OrganizationalCosts",
+      #   "OtherCostsOfServiceCOS", "OtherCurrentAssets", "OtherCurrentLiab", "OtherFixedAssets",
+      #   "OtherInvestmentIncome", "OtherLongTermAssets", "OtherLongTermLiab", "OtherMiscExpense",
+      #   "OtherMiscIncome", "OtherMiscServiceCost", "OtherPrimaryIncome", "OwnersEquity",
+      #   "PaidInCapitalOrSurplus", "PartnerContributions", "PartnerDistributions",
+      #   "PartnersEquity", "PayrollClearing", "PayrollExpenses", "PayrollTaxPayable",
+      #   "PenaltiesAndSettlements", "PreferredStock", "PrepaidExpenses", "PrepaidExpensesPayable",
+      #   "PromotionalMeals", "RentOrLeaseOfBuildings", "RentsHeldInTrust", "RentsInTrustLiab",
+      #   "RepairAndMaintenance", "Retainage", "RetainedEarnings", "SalesOfProductIncome",
+      #   "SalesTaxPayable", "Savings", "SecurityDeposits", "ServiceOrFeeIncome",
+      #   "ShareholderNotesPayable", "ShippingFreightAndDelivery", "ShippingFreightAndDeliveryCOS",
+      #   "StateOrLocalIncomeTaxPayable", "SuppliesAndMaterials", "SuppliesAndMaterialsCOGS",
+      #   "TaxExemptInterest", "TaxesPaid", "Travel", "TravelMeals", "TreasuryStock",
+      #   "TrustAccounts", "TrustAccountsLiab", "UndepositedFunds", "Utilities", "Vehicles")
+      # - `include_ret_element` (Array<one of "AccountNumber", "AccountType", "Balance",
+      #   "BankNumber", "CashFlowClassification", "CurrencyRef", "DataExtRet", "Desc",
+      #   "DetailAccountType", "EditSequence", "ExternalGUID", "FullName", "IsActive",
+      #   "IsTaxAccount", "LastCheckNumber", "ListID", "Name", "OwnerID", "ParentRef",
+      #   "SalesTaxCodeRef", "SpecialAccountType", "Sublevel", "TaxLineInfoRet", "TimeCreated",
+      #   "TimeModified", "TotalBalance", "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 `full_name` remains distinct.
+      # - `open_balance` (Numeric): The amount of money in, or the value of, this account as of
+      #   `open_balance_date`. On a bank statement, the amount of money in the account at the
+      #   beginning of the statement period.
+      # - `open_balance_date` (String): The date when an opening balance was entered for this
+      #   account.
+      # - `parent_ref` (Hash): A reference to the list object that is one level above this one. For
+      #   example, an inventory item with the `full_name` of GermanCars:Mercedes-Benz:CL500I99AA
+      #   might have a parent object with the `full_name` of GermanCars:Mercedes-Benz. In a request,
+      #   if a `parent_ref` aggregate includes both `full_name` and `list_id`, `full_name` will be
+      #   ignored.
+      #   - `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`.
+      # - `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`.
+      # - `sales_tax_code_ref` (Hash): `sales_tax_code_ref` points to the sales-tax code used for an
+      #   item or customer context. QuickBooks includes default TAX and NON codes, and a code can be
+      #   deleted only when nothing references it. If sales tax is disabled, QuickBooks assigns the
+      #   default non-taxable code. If both `full_name` and `list_id` are provided in
+      #   `sales_tax_code_ref`, `full_name` is ignored.
+      #   - `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`.
+      # - `tax_line_id` (Integer): An internal representation of the tax line associated with this
+      #   account.
+      #
+      # @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/accounts/create-account
+      def create(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("account.create", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+
+      # List accounts: GET /connections/{connection_id}/accounts (`account.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `account_type` (Array<one of "AccountsPayable", "AccountsReceivable", "Bank",
+      #   "CostOfGoodsSold", "CreditCard", "Equity", "Expense", "FixedAsset", "Income",
+      #   "LongTermLiability", "NonPosting", "OtherAsset", "OtherCurrentAsset",
+      #   "OtherCurrentLiability", "OtherExpense", "OtherIncome">): The type of QuickBooks account.
+      #   You can’t create or modify a non-posting account through the SDK, because QuickBooks
+      #   creates these accounts behind the scenes. This means that you can’t send an AccountAdd
+      #   request with an `account_type` of NonPosting. Choose at most one of: `list_id`, or
+      #   `full_name`, or the set (`account_type`, `active_status`, `currency_filter`,
+      #   `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.
+      # - `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 (`account_type`, `active_status`,
+      #   `currency_filter`, `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.
+      # - `currency_filter` (Hash): Filters by the specified currency. Choose at most one of:
+      #   `list_id`, or `full_name`, or the set (`account_type`, `active_status`, `currency_filter`,
+      #   `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.
+      #   Give at most one of: `list_id`, or `full_name`.
+      #   - `full_name` (Array<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` (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`.
+      # - `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 (`account_type`, `active_status`, `currency_filter`,
+      #   `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>): `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. Choose at most
+      #   one of: `list_id`, or `full_name`, or the set (`account_type`, `active_status`,
+      #   `currency_filter`, `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 "AccountNumber", "AccountType", "Balance",
+      #   "BankNumber", "CashFlowClassification", "CurrencyRef", "DataExtRet", "Desc",
+      #   "DetailAccountType", "EditSequence", "FullName", "IsActive", "IsTaxAccount",
+      #   "LastCheckNumber", "ListID", "Name", "ParentRef", "SalesTaxCodeRef", "SpecialAccountType",
+      #   "Sublevel", "TaxLineInfoRet", "TimeCreated", "TimeModified", "TotalBalance">)
+      # - `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 (`account_type`, `active_status`,
+      #   `currency_filter`, `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 (`account_type`, `active_status`, `currency_filter`,
+      #   `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 (`account_type`, `active_status`, `currency_filter`,
+      #   `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 (`account_type`, `active_status`, `currency_filter`,
+      #   `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.
+      # - `owner_id` (Array<String>): `owner_id` identifies who owns the data extension. Use 0 for
+      #   QuickBooks custom fields that appear in the UI, or use a GUID for private extensions owned
+      #   by an app. Keep private GUIDs confidential unless you intentionally share extensions
+      #   across apps. If you do share them, both apps must use the same `owner_id` and
+      #   `data_ext_name`, because that pair uniquely identifies the extension.
+      # - `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 (`account_type`, `active_status`, `currency_filter`,
+      #   `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/accounts/list-accounts
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("account.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+
+      # Update account: PUT /connections/{connection_id}/accounts (`account.update`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the JSON body:
+      # - `account_number` (String): Account numbers appear in the QuickBooks chart of accounts,
+      #   Account fields, and reports and graphs. If the IsUsingAccountNumber preference is false
+      #   (that is, if the QuickBooks user has the account numbers Preference turned off), you can
+      #   still set account numbers through the SDK, but the numbers won’t be visible in the user
+      #   interface.
+      # - `account_type` (one of "AccountsPayable", "AccountsReceivable", "Bank", "CostOfGoodsSold",
+      #   "CreditCard", "Equity", "Expense", "FixedAsset", "Income", "LongTermLiability",
+      #   "NonPosting", "OtherAsset", "OtherCurrentAsset", "OtherCurrentLiability", "OtherExpense",
+      #   "OtherIncome"): The type of QuickBooks account. You can’t create or modify a non-posting
+      #   account through the SDK, because QuickBooks creates these accounts behind the scenes. This
+      #   means that you can’t send an AccountAdd request with an `account_type` of NonPosting.
+      # - `bank_number` (String): The bank account number or an identifying note about the account.
+      #   If a `bank_number` exists in a QuickBooks company file, it will only be returned to
+      #   applications that have been granted permission to access sensitive data and that are using
+      #   SDK v2.0 or greater.
+      # - `currency_ref` (Hash): A currency record defines how QuickBooks stores and displays a
+      #   currency. Built-in currency name/code values are fixed; formatting and active status can
+      #   vary by settings and workflow.
+      #   - `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`.
+      # - `desc` (String): A descriptive text field.
+      # - `edit_sequence` (String, required): `edit_sequence` is a server-generated revision token.
+      #   It changes each time the object is updated. To modify an existing object, you must send
+      #   the current `edit_sequence`. If your value is stale, the update is rejected to prevent
+      #   overwriting newer changes.
+      # - `include_ret_element` (Array<one of "AccountNumber", "AccountType", "Balance",
+      #   "BankNumber", "CashFlowClassification", "CurrencyRef", "DataExtRet", "Desc",
+      #   "DetailAccountType", "EditSequence", "ExternalGUID", "FullName", "IsActive",
+      #   "IsTaxAccount", "LastCheckNumber", "ListID", "Name", "OwnerID", "ParentRef",
+      #   "SalesTaxCodeRef", "SpecialAccountType", "Sublevel", "TaxLineInfoRet", "TimeCreated",
+      #   "TimeModified", "TotalBalance", "TxnID", "TxnNumber">)
+      # - `is_active` (Boolean): If `is_active` is true, this object is currently enabled for use by
+      #   QuickBooks. The default value is true.
+      # - `list_id` (String, required): `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`.
+      # - `name` (String): 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 `full_name` remains distinct.
+      # - `open_balance` (Numeric): The amount of money in, or the value of, this account as of
+      #   `open_balance_date`. On a bank statement, the amount of money in the account at the
+      #   beginning of the statement period.
+      # - `open_balance_date` (String): The date when an opening balance was entered for this
+      #   account.
+      # - `parent_ref` (Hash): A reference to the list object that is one level above this one. For
+      #   example, an inventory item with the `full_name` of GermanCars:Mercedes-Benz:CL500I99AA
+      #   might have a parent object with the `full_name` of GermanCars:Mercedes-Benz. In a request,
+      #   if a `parent_ref` aggregate includes both `full_name` and `list_id`, `full_name` will be
+      #   ignored.
+      #   - `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`.
+      # - `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`.
+      # - `sales_tax_code_ref` (Hash): `sales_tax_code_ref` points to the sales-tax code used for an
+      #   item or customer context. QuickBooks includes default TAX and NON codes, and a code can be
+      #   deleted only when nothing references it. If sales tax is disabled, QuickBooks assigns the
+      #   default non-taxable code. If both `full_name` and `list_id` are provided in
+      #   `sales_tax_code_ref`, `full_name` is ignored.
+      #   - `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`.
+      # - `tax_line_id` (Integer): An internal representation of the tax line associated with this
+      #   account.
+      #
+      # @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/accounts/update-account
+      def update(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("account.update", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/account_tax_line_info.rb

@@ -0,0 +1,30 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks account tax line info operations, reached as `client.account_tax_line_info`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class AccountTaxLineInfo < Base
+      # List account tax line infos: GET /connections/{connection_id}/account-tax-line-infos
+      # (`account_tax_line_info.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query 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`.
+      #
+      # @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/account-tax-line-infos/list-account-tax-line-infos
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("account_tax_line_info.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/aging_report.rb

@@ -0,0 +1,160 @@
+# Generated from operations.json by bin/generate-operations: don't edit.
+# frozen_string_literal: true
+
+module QubeSync
+  module Operations
+    # QuickBooks aging report operations, reached as `client.aging_report`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class AgingReport < Base
+      # List aging reports: GET /connections/{connection_id}/aging-reports (`aging_report.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `aging_report_type` (one of "APAgingDetail", "APAgingSummary", "ARAgingDetail",
+      #   "ARAgingSummary", "CollectionsReport", required): The type of aging report being queried.
+      # - `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_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_aging_as_of` (one of "ReportEndDate", "Today"): The report will return aging
+      #   information up to the `report_aging_as_of` date.
+      # - `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`.
+      #
+      # @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/aging-reports/list-aging-reports
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("aging_report.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end

data/lib/qube_sync/operations/alert.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 alert operations, reached as `client.alert`. Each queues a request and
+    # returns it (the response's `data`); the answer comes to `webhook_url`.
+    class Alert < Base
+      # Create alert: POST /connections/{connection_id}/alerts (`alert.create`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the JSON body:
+      # Give at most one of: `com_callback_info`, or `http_callback_info`.
+      # - `activation_date` (String)
+      # - `alert_permission` (Hash)
+      #   - `permission_level` (Array<one of "AccountsPayable", "AccountsReceivable", "Banking",
+      #     "Finance", "Inventory", "TimeTracking">, required)
+      #   - `permission_needed` (one of "All", "Any", required)
+      # - `alert_tag` (String, required)
+      # - `com_callback_info` (Hash)
+      #   Give at most one of: `prog_id`, or `clsid`.
+      #   - `app_name` (String, required)
+      #   - `clsid` (String)
+      #   - `prog_id` (String)
+      # - `desc` (String, required)
+      # - `expiration_date` (String)
+      # - `help_text` (String, required)
+      # - `http_callback_info` (Hash)
+      #   - `url` (String, required)
+      # - `message_text` (String, required)
+      # - `owner_id` (String, 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`.
+      # - `ui_context` (Array<one of "AlertsManager", "CompanyNavigator">)
+      #
+      # @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/alerts/create-alert
+      def create(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("alert.create", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+
+      # Delete alert: DELETE /connections/{connection_id}/alerts (`alert.delete`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the JSON body:
+      # - `alert_tag` (String, required)
+      # - `owner_id` (String, 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`.
+      #
+      # @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/alerts/delete-alert
+      def delete(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("alert.delete", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+
+      # List alerts: GET /connections/{connection_id}/alerts (`alert.query`).
+      #
+      # QuickBooks answers in one webhook.
+      #
+      # Params, sent as the query string:
+      # - `meta_data` (one of "MetaDataAndResponseData", "MetaDataOnly", "NoMetaData")
+      # - `owner_id` (Array<String>, 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`.
+      #
+      # @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/alerts/list-alerts
+      def query(connection_id, params = {}, webhook_url:, idempotency_key: nil)
+        queue("alert.query", connection_id, params, webhook_url: webhook_url, idempotency_key: idempotency_key)
+      end
+    end
+  end
+end