orb-billing 1.14.0 → 1.16.0

data/lib/orb/models/discount.rb

@@ -15,8 +15,152 @@ module Orb
 
       variant :amount, -> { Orb::AmountDiscount }
 
+      variant :tiered_percentage, -> { Orb::Discount::TieredPercentage }
+
+      class TieredPercentage < Orb::Internal::Type::BaseModel
+        # @!attribute discount_type
+        #
+        #   @return [Symbol, :tiered_percentage]
+        required :discount_type, const: :tiered_percentage
+
+        # @!attribute tiers
+        #   Only available if discount_type is `tiered_percentage`. The ordered, contiguous
+        #   bands of cumulative eligible spend, each discounted at its own percentage
+        #   (progressive fill-a-tier).
+        #
+        #   @return [Array<Orb::Models::Discount::TieredPercentage::Tier>]
+        required :tiers, -> { Orb::Internal::Type::ArrayOf[Orb::Discount::TieredPercentage::Tier] }
+
+        # @!attribute applies_to_price_ids
+        #   List of price_ids that this discount applies to. For plan/plan phase discounts,
+        #   this can be a subset of prices.
+        #
+        #   @return [Array<String>, nil]
+        optional :applies_to_price_ids, Orb::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!attribute filters
+        #   The filters that determine which prices to apply this discount to.
+        #
+        #   @return [Array<Orb::Models::Discount::TieredPercentage::Filter>, nil]
+        optional :filters,
+                 -> { Orb::Internal::Type::ArrayOf[Orb::Discount::TieredPercentage::Filter] },
+                 nil?: true
+
+        # @!attribute reason
+        #
+        #   @return [String, nil]
+        optional :reason, String, nil?: true
+
+        # @!method initialize(tiers:, applies_to_price_ids: nil, filters: nil, reason: nil, discount_type: :tiered_percentage)
+        #   Some parameter documentations has been truncated, see
+        #   {Orb::Models::Discount::TieredPercentage} for more details.
+        #
+        #   @param tiers [Array<Orb::Models::Discount::TieredPercentage::Tier>] Only available if discount_type is `tiered_percentage`. The ordered, contiguous
+        #
+        #   @param applies_to_price_ids [Array<String>, nil] List of price_ids that this discount applies to. For plan/plan phase discounts,
+        #
+        #   @param filters [Array<Orb::Models::Discount::TieredPercentage::Filter>, nil] The filters that determine which prices to apply this discount to.
+        #
+        #   @param reason [String, nil]
+        #
+        #   @param discount_type [Symbol, :tiered_percentage]
+
+        class Tier < Orb::Internal::Type::BaseModel
+          # @!attribute lower_bound
+          #   Exclusive lower bound of cumulative spend for this tier.
+          #
+          #   @return [Float]
+          required :lower_bound, Float
+
+          # @!attribute percentage
+          #   The percentage (between 0 and 1) discounted from spend that falls within this
+          #   tier.
+          #
+          #   @return [Float]
+          required :percentage, Float
+
+          # @!attribute upper_bound
+          #   Inclusive upper bound of cumulative spend for this tier; null for the final
+          #   open-ended tier.
+          #
+          #   @return [Float, nil]
+          optional :upper_bound, Float, nil?: true
+
+          # @!method initialize(lower_bound:, percentage:, upper_bound: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Orb::Models::Discount::TieredPercentage::Tier} for more details.
+          #
+          #   One band of a tiered percentage discount. Bounds are denominated in the
+          #   discount's currency. `lower_bound` is the exclusive start of the band and
+          #   `upper_bound` is the inclusive end; `upper_bound` is null only for the
+          #   open-ended final tier.
+          #
+          #   @param lower_bound [Float] Exclusive lower bound of cumulative spend for this tier.
+          #
+          #   @param percentage [Float] The percentage (between 0 and 1) discounted from spend that falls within this ti
+          #
+          #   @param upper_bound [Float, nil] Inclusive upper bound of cumulative spend for this tier; null for the final open
+        end
+
+        class Filter < Orb::Internal::Type::BaseModel
+          # @!attribute field
+          #   The property of the price to filter on.
+          #
+          #   @return [Symbol, Orb::Models::Discount::TieredPercentage::Filter::Field]
+          required :field, enum: -> { Orb::Discount::TieredPercentage::Filter::Field }
+
+          # @!attribute operator
+          #   Should prices that match the filter be included or excluded.
+          #
+          #   @return [Symbol, Orb::Models::Discount::TieredPercentage::Filter::Operator]
+          required :operator, enum: -> { Orb::Discount::TieredPercentage::Filter::Operator }
+
+          # @!attribute values
+          #   The IDs or values that match this filter.
+          #
+          #   @return [Array<String>]
+          required :values, Orb::Internal::Type::ArrayOf[String]
+
+          # @!method initialize(field:, operator:, values:)
+          #   @param field [Symbol, Orb::Models::Discount::TieredPercentage::Filter::Field] The property of the price to filter on.
+          #
+          #   @param operator [Symbol, Orb::Models::Discount::TieredPercentage::Filter::Operator] Should prices that match the filter be included or excluded.
+          #
+          #   @param values [Array<String>] The IDs or values that match this filter.
+
+          # The property of the price to filter on.
+          #
+          # @see Orb::Models::Discount::TieredPercentage::Filter#field
+          module Field
+            extend Orb::Internal::Type::Enum
+
+            PRICE_ID = :price_id
+            ITEM_ID = :item_id
+            PRICE_TYPE = :price_type
+            CURRENCY = :currency
+            PRICING_UNIT_ID = :pricing_unit_id
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Should prices that match the filter be included or excluded.
+          #
+          # @see Orb::Models::Discount::TieredPercentage::Filter#operator
+          module Operator
+            extend Orb::Internal::Type::Enum
+
+            INCLUDES = :includes
+            EXCLUDES = :excludes
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+
       # @!method self.variants
-      #   @return [Array(Orb::Models::PercentageDiscount, Orb::Models::TrialDiscount, Orb::Models::UsageDiscount, Orb::Models::AmountDiscount)]
+      #   @return [Array(Orb::Models::PercentageDiscount, Orb::Models::TrialDiscount, Orb::Models::UsageDiscount, Orb::Models::AmountDiscount, Orb::Models::Discount::TieredPercentage)]
     end
   end
 end

data/lib/orb/models/event_ingest_params.rb

@@ -20,7 +20,10 @@ module Orb
       optional :backfill_id, String, nil?: true
 
       # @!attribute debug
-      #   Flag to enable additional debug information in the endpoint response
+      #   @deprecated
+      #
+      #   Pending Deprecation: Flag to enable additional debug information in the endpoint
+      #   response
       #
       #   @return [Boolean, nil]
       optional :debug, Orb::Internal::Type::Boolean
@@ -33,7 +36,7 @@ module Orb
       #
       #   @param backfill_id [String, nil] If this ingestion request is part of a backfill, this parameter ties the ingeste
       #
-      #   @param debug [Boolean] Flag to enable additional debug information in the endpoint response
+      #   @param debug [Boolean] Pending Deprecation: Flag to enable additional debug information in the endpoint
       #
       #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/orb/models/invoice.rb

@@ -112,11 +112,13 @@ module Orb
       #   | Estonia                | `eu_vat`     | European VAT Number                                                                                     |
       #   | Ethiopia               | `et_tin`     | Ethiopia Tax Identification Number                                                                      |
       #   | European Union         | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+      #   | Faroe Islands          | `fo_vat`     | Faroe Islands VAT Number                                                                                |
       #   | Finland                | `eu_vat`     | European VAT Number                                                                                     |
       #   | France                 | `eu_vat`     | European VAT Number                                                                                     |
       #   | Georgia                | `ge_vat`     | Georgian VAT                                                                                            |
       #   | Germany                | `de_stn`     | German Tax Number (Steuernummer)                                                                        |
       #   | Germany                | `eu_vat`     | European VAT Number                                                                                     |
+      #   | Gibraltar              | `gi_tin`     | Gibraltar Tax Identification Number                                                                     |
       #   | Greece                 | `eu_vat`     | European VAT Number                                                                                     |
       #   | Guinea                 | `gn_nif`     | Guinea Tax Identification Number (Número de Identificação Fiscal)                                       |
       #   | Hong Kong              | `hk_br`      | Hong Kong BR Number                                                                                     |
@@ -128,6 +130,7 @@ module Orb
       #   | Ireland                | `eu_vat`     | European VAT Number                                                                                     |
       #   | Israel                 | `il_vat`     | Israel VAT                                                                                              |
       #   | Italy                  | `eu_vat`     | European VAT Number                                                                                     |
+      #   | Italy                  | `it_cf`      | Italian Codice Fiscale Number                                                                           |
       #   | Japan                  | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
       #   | Japan                  | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
       #   | Japan                  | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
@@ -158,6 +161,7 @@ module Orb
       #   | Norway                 | `no_vat`     | Norwegian VAT Number                                                                                    |
       #   | Norway                 | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
       #   | Oman                   | `om_vat`     | Omani VAT Number                                                                                        |
+      #   | Paraguay               | `py_ruc`     | Paraguayan RUC Number                                                                                   |
       #   | Peru                   | `pe_ruc`     | Peruvian RUC Number                                                                                     |
       #   | Philippines            | `ph_tin`     | Philippines Tax Identification Number                                                                   |
       #   | Poland                 | `eu_vat`     | European VAT Number                                                                                     |
@@ -179,6 +183,7 @@ module Orb
       #   | South Korea            | `kr_brn`     | Korean BRN                                                                                              |
       #   | Spain                  | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
       #   | Spain                  | `eu_vat`     | European VAT Number                                                                                     |
+      #   | Sri Lanka              | `lk_vat`     | Sri Lanka VAT Number                                                                                    |
       #   | Suriname               | `sr_fin`     | Suriname FIN Number                                                                                     |
       #   | Sweden                 | `eu_vat`     | European VAT Number                                                                                     |
       #   | Switzerland            | `ch_uid`     | Switzerland UID Number                                                                                  |
@@ -216,7 +221,7 @@ module Orb
 
       # @!attribute discounts
       #
-      #   @return [Array<Orb::Models::PercentageDiscount, Orb::Models::AmountDiscount, Orb::Models::TrialDiscount>]
+      #   @return [Array<Orb::Models::PercentageDiscount, Orb::Models::AmountDiscount, Orb::Models::TrialDiscount, Orb::Models::InvoiceLevelDiscount::TieredPercentage>]
       required :discounts, -> { Orb::Internal::Type::ArrayOf[union: Orb::InvoiceLevelDiscount] }
 
       # @!attribute due_date
@@ -235,8 +240,8 @@ module Orb
       required :eligible_to_issue_at, Time, nil?: true
 
       # @!attribute hosted_invoice_url
-      #   A URL for the customer-facing invoice portal. This URL expires 30 days after the
-      #   invoice's due date, or 60 days after being re-generated through the UI.
+      #   A URL for the customer-facing invoice portal. This URL expires 60 days after the
+      #   link is generated, or 30 days after the invoice's due date — whichever is later.
       #
       #   @return [String, nil]
       required :hosted_invoice_url, String, nil?: true
@@ -437,13 +442,13 @@ module Orb
       #
       #   @param discount [Object] This field is deprecated in favor of `discounts`. If a `discounts` list is provi
       #
-      #   @param discounts [Array<Orb::Models::PercentageDiscount, Orb::Models::AmountDiscount, Orb::Models::TrialDiscount>]
+      #   @param discounts [Array<Orb::Models::PercentageDiscount, Orb::Models::AmountDiscount, Orb::Models::TrialDiscount, Orb::Models::InvoiceLevelDiscount::TieredPercentage>]
       #
       #   @param due_date [Time, nil] When the invoice payment is due. The due date is null if the invoice is not yet
       #
       #   @param eligible_to_issue_at [Time, nil] If the invoice has a status of `draft`, this will be the time that the invoice w
       #
-      #   @param hosted_invoice_url [String, nil] A URL for the customer-facing invoice portal. This URL expires 30 days after the
+      #   @param hosted_invoice_url [String, nil] A URL for the customer-facing invoice portal. This URL expires 60 days after the
       #
       #   @param invoice_date [Time] The scheduled date of the invoice
       #
@@ -746,7 +751,7 @@ module Orb
         #   invoice calculations (ie. usage discounts -> amount discounts -> percentage
         #   discounts -> minimums -> maximums).
         #
-        #   @return [Array<Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment>]
+        #   @return [Array<Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment>]
         required :adjustments, -> { Orb::Internal::Type::ArrayOf[union: Orb::Invoice::LineItem::Adjustment] }
 
         # @!attribute amount
@@ -806,7 +811,7 @@ module Orb
         #   For more on the types of prices, see
         #   [the core concepts documentation](/core-concepts#plan-and-price)
         #
-        #   @return [Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput]
+        #   @return [Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::MatrixWithThresholdDiscounts, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::DailyCreditAllowance, Orb::Models::Price::MeteredAllowance, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput]
         required :price, union: -> { Orb::Price }
 
         # @!attribute quantity
@@ -855,7 +860,7 @@ module Orb
         #
         #   @param adjusted_subtotal [String] The line amount after any adjustments and before overage conversion, credits and
         #
-        #   @param adjustments [Array<Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment>] All adjustments applied to the line item in the order they were applied based on
+        #   @param adjustments [Array<Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment>] All adjustments applied to the line item in the order they were applied based on
         #
         #   @param amount [String] The final amount for a line item after all adjustments and pre paid credits have
         #
@@ -871,7 +876,7 @@ module Orb
         #
         #   @param partially_invoiced_amount [String] Any amount applied from a partial invoice
         #
-        #   @param price [Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput] The Price resource represents a price that can be billed on a subscription, resu
+        #   @param price [Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::MatrixWithThresholdDiscounts, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::DailyCreditAllowance, Orb::Models::Price::MeteredAllowance, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput] The Price resource represents a price that can be billed on a subscription, resu
         #
         #   @param quantity [Float] Either the fixed fee quantity or the usage during the service period.
         #
@@ -896,12 +901,194 @@ module Orb
 
           variant :percentage_discount, -> { Orb::MonetaryPercentageDiscountAdjustment }
 
+          variant :tiered_percentage_discount, -> { Orb::Invoice::LineItem::Adjustment::TieredPercentageDiscount }
+
           variant :minimum, -> { Orb::MonetaryMinimumAdjustment }
 
           variant :maximum, -> { Orb::MonetaryMaximumAdjustment }
 
+          class TieredPercentageDiscount < Orb::Internal::Type::BaseModel
+            # @!attribute id
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute adjustment_type
+            #
+            #   @return [Symbol, :tiered_percentage_discount]
+            required :adjustment_type, const: :tiered_percentage_discount
+
+            # @!attribute amount
+            #   The value applied by an adjustment.
+            #
+            #   @return [String]
+            required :amount, String
+
+            # @!attribute applies_to_price_ids
+            #   @deprecated
+            #
+            #   The price IDs that this adjustment applies to.
+            #
+            #   @return [Array<String>]
+            required :applies_to_price_ids, Orb::Internal::Type::ArrayOf[String]
+
+            # @!attribute filters
+            #   The filters that determine which prices to apply this adjustment to.
+            #
+            #   @return [Array<Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Filter>]
+            required :filters,
+                     -> { Orb::Internal::Type::ArrayOf[Orb::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Filter] }
+
+            # @!attribute is_invoice_level
+            #   True for adjustments that apply to an entire invoice, false for adjustments that
+            #   apply to only one price.
+            #
+            #   @return [Boolean]
+            required :is_invoice_level, Orb::Internal::Type::Boolean
+
+            # @!attribute reason
+            #   The reason for the adjustment.
+            #
+            #   @return [String, nil]
+            required :reason, String, nil?: true
+
+            # @!attribute replaces_adjustment_id
+            #   The adjustment id this adjustment replaces. This adjustment will take the place
+            #   of the replaced adjustment in plan version migrations.
+            #
+            #   @return [String, nil]
+            required :replaces_adjustment_id, String, nil?: true
+
+            # @!attribute tiers
+            #   The ordered, contiguous bands of cumulative eligible spend, each discounted at
+            #   its own percentage (progressive fill-a-tier), applied to the prices this
+            #   adjustment covers in a given billing period.
+            #
+            #   @return [Array<Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Tier>]
+            required :tiers,
+                     -> { Orb::Internal::Type::ArrayOf[Orb::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Tier] }
+
+            # @!method initialize(id:, amount:, applies_to_price_ids:, filters:, is_invoice_level:, reason:, replaces_adjustment_id:, tiers:, adjustment_type: :tiered_percentage_discount)
+            #   Some parameter documentations has been truncated, see
+            #   {Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount} for more
+            #   details.
+            #
+            #   @param id [String]
+            #
+            #   @param amount [String] The value applied by an adjustment.
+            #
+            #   @param applies_to_price_ids [Array<String>] The price IDs that this adjustment applies to.
+            #
+            #   @param filters [Array<Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Filter>] The filters that determine which prices to apply this adjustment to.
+            #
+            #   @param is_invoice_level [Boolean] True for adjustments that apply to an entire invoice, false for adjustments that
+            #
+            #   @param reason [String, nil] The reason for the adjustment.
+            #
+            #   @param replaces_adjustment_id [String, nil] The adjustment id this adjustment replaces. This adjustment will take the place
+            #
+            #   @param tiers [Array<Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Tier>] The ordered, contiguous bands of cumulative eligible spend, each discounted at i
+            #
+            #   @param adjustment_type [Symbol, :tiered_percentage_discount]
+
+            class Filter < Orb::Internal::Type::BaseModel
+              # @!attribute field
+              #   The property of the price to filter on.
+              #
+              #   @return [Symbol, Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Filter::Field]
+              required :field, enum: -> { Orb::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Filter::Field }
+
+              # @!attribute operator
+              #   Should prices that match the filter be included or excluded.
+              #
+              #   @return [Symbol, Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Filter::Operator]
+              required :operator,
+                       enum: -> { Orb::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Filter::Operator }
+
+              # @!attribute values
+              #   The IDs or values that match this filter.
+              #
+              #   @return [Array<String>]
+              required :values, Orb::Internal::Type::ArrayOf[String]
+
+              # @!method initialize(field:, operator:, values:)
+              #   @param field [Symbol, Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Filter::Field] The property of the price to filter on.
+              #
+              #   @param operator [Symbol, Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Filter::Operator] Should prices that match the filter be included or excluded.
+              #
+              #   @param values [Array<String>] The IDs or values that match this filter.
+
+              # The property of the price to filter on.
+              #
+              # @see Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Filter#field
+              module Field
+                extend Orb::Internal::Type::Enum
+
+                PRICE_ID = :price_id
+                ITEM_ID = :item_id
+                PRICE_TYPE = :price_type
+                CURRENCY = :currency
+                PRICING_UNIT_ID = :pricing_unit_id
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+
+              # Should prices that match the filter be included or excluded.
+              #
+              # @see Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Filter#operator
+              module Operator
+                extend Orb::Internal::Type::Enum
+
+                INCLUDES = :includes
+                EXCLUDES = :excludes
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
+            class Tier < Orb::Internal::Type::BaseModel
+              # @!attribute lower_bound
+              #   Exclusive lower bound of cumulative spend for this tier.
+              #
+              #   @return [Float]
+              required :lower_bound, Float
+
+              # @!attribute percentage
+              #   The percentage (between 0 and 1) discounted from spend that falls within this
+              #   tier.
+              #
+              #   @return [Float]
+              required :percentage, Float
+
+              # @!attribute upper_bound
+              #   Inclusive upper bound of cumulative spend for this tier; null for the final
+              #   open-ended tier.
+              #
+              #   @return [Float, nil]
+              optional :upper_bound, Float, nil?: true
+
+              # @!method initialize(lower_bound:, percentage:, upper_bound: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount::Tier} for
+              #   more details.
+              #
+              #   One band of a tiered percentage discount. Bounds are denominated in the
+              #   discount's currency. `lower_bound` is the exclusive start of the band and
+              #   `upper_bound` is the inclusive end; `upper_bound` is null only for the
+              #   open-ended final tier.
+              #
+              #   @param lower_bound [Float] Exclusive lower bound of cumulative spend for this tier.
+              #
+              #   @param percentage [Float] The percentage (between 0 and 1) discounted from spend that falls within this ti
+              #
+              #   @param upper_bound [Float, nil] Inclusive upper bound of cumulative spend for this tier; null for the final open
+            end
+          end
+
           # @!method self.variants
-          #   @return [Array(Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment)]
+          #   @return [Array(Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::Invoice::LineItem::Adjustment::TieredPercentageDiscount, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment)]
         end
 
         module SubLineItem
@@ -989,6 +1176,7 @@ module Orb
           extend Orb::Internal::Type::Enum
 
           STRIPE = :stripe
+          ADYEN = :adyen
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/orb/models/invoice_create_params.rb

@@ -15,8 +15,9 @@ module Orb
       required :currency, String
 
       # @!attribute invoice_date
-      #   Optional invoice date to set. Must be in the past, if not set, `invoice_date` is
-      #   set to the current time in the customer's timezone.
+      #   An ISO 8601 date or timestamp, interpreted in the customer's timezone. Must be
+      #   in the past. If a date is set without a time, `invoice_date` is set to midnight
+      #   on the chosen date in the customer's timezone.
       #
       #   @return [Time]
       required :invoice_date, Time
@@ -44,7 +45,7 @@ module Orb
       # @!attribute discount
       #   An optional discount to attach to the invoice.
       #
-      #   @return [Orb::Models::PercentageDiscount, Orb::Models::TrialDiscount, Orb::Models::UsageDiscount, Orb::Models::AmountDiscount, nil]
+      #   @return [Orb::Models::PercentageDiscount, Orb::Models::TrialDiscount, Orb::Models::UsageDiscount, Orb::Models::AmountDiscount, Orb::Models::Discount::TieredPercentage, nil]
       optional :discount, union: -> { Orb::Discount }, nil?: true
 
       # @!attribute due_date
@@ -100,7 +101,7 @@ module Orb
       #
       #   @param currency [String] An ISO 4217 currency string. Must be the same as the customer's currency if it i
       #
-      #   @param invoice_date [Time] Optional invoice date to set. Must be in the past, if not set, `invoice_date` is
+      #   @param invoice_date [Time] An ISO 8601 date or timestamp, interpreted in the customer's timezone. Must be i
       #
       #   @param line_items [Array<Orb::Models::InvoiceCreateParams::LineItem>]
       #
@@ -108,7 +109,7 @@ module Orb
       #
       #   @param customer_id [String, nil] The id of the `Customer` to create this invoice for. One of `customer_id` and `e
       #
-      #   @param discount [Orb::Models::PercentageDiscount, Orb::Models::TrialDiscount, Orb::Models::UsageDiscount, Orb::Models::AmountDiscount, nil] An optional discount to attach to the invoice.
+      #   @param discount [Orb::Models::PercentageDiscount, Orb::Models::TrialDiscount, Orb::Models::UsageDiscount, Orb::Models::AmountDiscount, Orb::Models::Discount::TieredPercentage, nil] An optional discount to attach to the invoice.
       #
       #   @param due_date [Date, Time, nil] An optional custom due date for the invoice. If not set, the due date will be ca
       #