orb-billing 6.14.0 → 6.16.0

package/src/resources/beta/beta.ts

@@ -377,6 +377,7 @@ export namespace BetaCreatePlanVersionParams {
       | Shared.NewPlanPackageWithAllocationPrice
       | Shared.NewPlanUnitWithPercentPrice
       | Shared.NewPlanMatrixWithAllocationPrice
+      | AddPrice.NewPlanTieredMatrixWithAllocationPrice
       | AddPrice.NewPlanMatrixWithThresholdDiscountsPrice
       | AddPrice.NewPlanTieredWithProrationPrice
       | Shared.NewPlanUnitWithProrationPrice
@@ -852,6 +853,167 @@ export namespace BetaCreatePlanVersionParams {
       }
     }
 
+    export interface NewPlanTieredMatrixWithAllocationPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'tiered_matrix_with_allocation';
+
+      /**
+       * The name of the price.
+       */
+      name: string;
+
+      /**
+       * Configuration for tiered_matrix_with_allocation pricing
+       */
+      tiered_matrix_with_allocation_config: NewPlanTieredMatrixWithAllocationPrice.TieredMatrixWithAllocationConfig;
+
+      /**
+       * The id of the billable metric for the price. Only needed if the price is
+       * usage-based.
+       */
+      billable_metric_id?: string | null;
+
+      /**
+       * If the Price represents a fixed cost, the price will be billed in-advance if
+       * this is true, and in-arrears if this is false.
+       */
+      billed_in_advance?: boolean | null;
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+
+      /**
+       * The per unit conversion rate of the price currency to the invoicing currency.
+       */
+      conversion_rate?: number | null;
+
+      /**
+       * The configuration for the rate of the price currency to the invoicing currency.
+       */
+      conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+
+      /**
+       * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+       * price is billed.
+       */
+      currency?: string | null;
+
+      /**
+       * For dimensional price: specifies a price group and dimension values
+       */
+      dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+
+      /**
+       * An alias for the price.
+       */
+      external_price_id?: string | null;
+
+      /**
+       * If the Price represents a fixed cost, this represents the quantity of units
+       * applied.
+       */
+      fixed_price_quantity?: number | null;
+
+      /**
+       * The property used to group this price on an invoice
+       */
+      invoice_grouping_key?: string | null;
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+
+      /**
+       * The ID of the license type to associate with this price. On a usage price this
+       * also marks the price as eligible to draw down from that license type's
+       * allocation; a usage price created without it is billed normally. Usage prices
+       * with a license type must use the `unit` model, and only draw down when their
+       * currency matches the allocation's.
+       */
+      license_type_id?: string | null;
+
+      /**
+       * User-specified key/value pairs for the resource. Individual keys can be removed
+       * by setting the value to `null`, and the entire metadata mapping can be cleared
+       * by setting `metadata` to `null`.
+       */
+      metadata?: { [key: string]: string | null } | null;
+
+      /**
+       * A transient ID that can be used to reference this price when adding adjustments
+       * in the same API call.
+       */
+      reference_id?: string | null;
+    }
+
+    export namespace NewPlanTieredMatrixWithAllocationPrice {
+      /**
+       * Configuration for tiered_matrix_with_allocation pricing
+       */
+      export interface TieredMatrixWithAllocationConfig {
+        /**
+         * Usage allocation, pooled across all matrix cells
+         */
+        allocation: string;
+
+        /**
+         * Per unit rate for usage whose matrix cell has no configured tiers
+         */
+        default_unit_amount: string;
+
+        /**
+         * One or two event property values to evaluate matrix cells by
+         */
+        dimensions: Array<string>;
+
+        /**
+         * Graduated tiers keyed by matrix cell; usage in a cell is tiered only against its
+         * own rows
+         */
+        tiers: Array<TieredMatrixWithAllocationConfig.Tier>;
+      }
+
+      export namespace TieredMatrixWithAllocationConfig {
+        /**
+         * Configuration for a single tier scoped to one matrix cell
+         */
+        export interface Tier {
+          /**
+           * The matrix cell this tier applies to, as one or two dimension values
+           */
+          dimension_values: Array<string>;
+
+          /**
+           * Exclusive tier starting value. The tier runs up to and including the next bound
+           * configured for the same matrix cell.
+           */
+          tier_lower_bound: string;
+
+          /**
+           * Per unit amount
+           */
+          unit_amount: string;
+        }
+      }
+    }
+
     export interface NewPlanMatrixWithThresholdDiscountsPrice {
       /**
        * The cadence to bill for this price on.
@@ -2196,6 +2358,7 @@ export namespace BetaCreatePlanVersionParams {
       | Shared.NewPlanPackageWithAllocationPrice
       | Shared.NewPlanUnitWithPercentPrice
       | Shared.NewPlanMatrixWithAllocationPrice
+      | ReplacePrice.NewPlanTieredMatrixWithAllocationPrice
       | ReplacePrice.NewPlanMatrixWithThresholdDiscountsPrice
       | ReplacePrice.NewPlanTieredWithProrationPrice
       | Shared.NewPlanUnitWithProrationPrice
@@ -2671,6 +2834,167 @@ export namespace BetaCreatePlanVersionParams {
       }
     }
 
+    export interface NewPlanTieredMatrixWithAllocationPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'tiered_matrix_with_allocation';
+
+      /**
+       * The name of the price.
+       */
+      name: string;
+
+      /**
+       * Configuration for tiered_matrix_with_allocation pricing
+       */
+      tiered_matrix_with_allocation_config: NewPlanTieredMatrixWithAllocationPrice.TieredMatrixWithAllocationConfig;
+
+      /**
+       * The id of the billable metric for the price. Only needed if the price is
+       * usage-based.
+       */
+      billable_metric_id?: string | null;
+
+      /**
+       * If the Price represents a fixed cost, the price will be billed in-advance if
+       * this is true, and in-arrears if this is false.
+       */
+      billed_in_advance?: boolean | null;
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+
+      /**
+       * The per unit conversion rate of the price currency to the invoicing currency.
+       */
+      conversion_rate?: number | null;
+
+      /**
+       * The configuration for the rate of the price currency to the invoicing currency.
+       */
+      conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+
+      /**
+       * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+       * price is billed.
+       */
+      currency?: string | null;
+
+      /**
+       * For dimensional price: specifies a price group and dimension values
+       */
+      dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+
+      /**
+       * An alias for the price.
+       */
+      external_price_id?: string | null;
+
+      /**
+       * If the Price represents a fixed cost, this represents the quantity of units
+       * applied.
+       */
+      fixed_price_quantity?: number | null;
+
+      /**
+       * The property used to group this price on an invoice
+       */
+      invoice_grouping_key?: string | null;
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+
+      /**
+       * The ID of the license type to associate with this price. On a usage price this
+       * also marks the price as eligible to draw down from that license type's
+       * allocation; a usage price created without it is billed normally. Usage prices
+       * with a license type must use the `unit` model, and only draw down when their
+       * currency matches the allocation's.
+       */
+      license_type_id?: string | null;
+
+      /**
+       * User-specified key/value pairs for the resource. Individual keys can be removed
+       * by setting the value to `null`, and the entire metadata mapping can be cleared
+       * by setting `metadata` to `null`.
+       */
+      metadata?: { [key: string]: string | null } | null;
+
+      /**
+       * A transient ID that can be used to reference this price when adding adjustments
+       * in the same API call.
+       */
+      reference_id?: string | null;
+    }
+
+    export namespace NewPlanTieredMatrixWithAllocationPrice {
+      /**
+       * Configuration for tiered_matrix_with_allocation pricing
+       */
+      export interface TieredMatrixWithAllocationConfig {
+        /**
+         * Usage allocation, pooled across all matrix cells
+         */
+        allocation: string;
+
+        /**
+         * Per unit rate for usage whose matrix cell has no configured tiers
+         */
+        default_unit_amount: string;
+
+        /**
+         * One or two event property values to evaluate matrix cells by
+         */
+        dimensions: Array<string>;
+
+        /**
+         * Graduated tiers keyed by matrix cell; usage in a cell is tiered only against its
+         * own rows
+         */
+        tiers: Array<TieredMatrixWithAllocationConfig.Tier>;
+      }
+
+      export namespace TieredMatrixWithAllocationConfig {
+        /**
+         * Configuration for a single tier scoped to one matrix cell
+         */
+        export interface Tier {
+          /**
+           * The matrix cell this tier applies to, as one or two dimension values
+           */
+          dimension_values: Array<string>;
+
+          /**
+           * Exclusive tier starting value. The tier runs up to and including the next bound
+           * configured for the same matrix cell.
+           */
+          tier_lower_bound: string;
+
+          /**
+           * Per unit amount
+           */
+          unit_amount: string;
+        }
+      }
+    }
+
     export interface NewPlanMatrixWithThresholdDiscountsPrice {
       /**
        * The cadence to bill for this price on.

package/src/resources/beta/external-plan-id.ts

@@ -229,6 +229,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       | Shared.NewPlanPackageWithAllocationPrice
       | Shared.NewPlanUnitWithPercentPrice
       | Shared.NewPlanMatrixWithAllocationPrice
+      | AddPrice.NewPlanTieredMatrixWithAllocationPrice
       | AddPrice.NewPlanMatrixWithThresholdDiscountsPrice
       | AddPrice.NewPlanTieredWithProrationPrice
       | Shared.NewPlanUnitWithProrationPrice
@@ -704,6 +705,167 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       }
     }
 
+    export interface NewPlanTieredMatrixWithAllocationPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'tiered_matrix_with_allocation';
+
+      /**
+       * The name of the price.
+       */
+      name: string;
+
+      /**
+       * Configuration for tiered_matrix_with_allocation pricing
+       */
+      tiered_matrix_with_allocation_config: NewPlanTieredMatrixWithAllocationPrice.TieredMatrixWithAllocationConfig;
+
+      /**
+       * The id of the billable metric for the price. Only needed if the price is
+       * usage-based.
+       */
+      billable_metric_id?: string | null;
+
+      /**
+       * If the Price represents a fixed cost, the price will be billed in-advance if
+       * this is true, and in-arrears if this is false.
+       */
+      billed_in_advance?: boolean | null;
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+
+      /**
+       * The per unit conversion rate of the price currency to the invoicing currency.
+       */
+      conversion_rate?: number | null;
+
+      /**
+       * The configuration for the rate of the price currency to the invoicing currency.
+       */
+      conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+
+      /**
+       * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+       * price is billed.
+       */
+      currency?: string | null;
+
+      /**
+       * For dimensional price: specifies a price group and dimension values
+       */
+      dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+
+      /**
+       * An alias for the price.
+       */
+      external_price_id?: string | null;
+
+      /**
+       * If the Price represents a fixed cost, this represents the quantity of units
+       * applied.
+       */
+      fixed_price_quantity?: number | null;
+
+      /**
+       * The property used to group this price on an invoice
+       */
+      invoice_grouping_key?: string | null;
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+
+      /**
+       * The ID of the license type to associate with this price. On a usage price this
+       * also marks the price as eligible to draw down from that license type's
+       * allocation; a usage price created without it is billed normally. Usage prices
+       * with a license type must use the `unit` model, and only draw down when their
+       * currency matches the allocation's.
+       */
+      license_type_id?: string | null;
+
+      /**
+       * User-specified key/value pairs for the resource. Individual keys can be removed
+       * by setting the value to `null`, and the entire metadata mapping can be cleared
+       * by setting `metadata` to `null`.
+       */
+      metadata?: { [key: string]: string | null } | null;
+
+      /**
+       * A transient ID that can be used to reference this price when adding adjustments
+       * in the same API call.
+       */
+      reference_id?: string | null;
+    }
+
+    export namespace NewPlanTieredMatrixWithAllocationPrice {
+      /**
+       * Configuration for tiered_matrix_with_allocation pricing
+       */
+      export interface TieredMatrixWithAllocationConfig {
+        /**
+         * Usage allocation, pooled across all matrix cells
+         */
+        allocation: string;
+
+        /**
+         * Per unit rate for usage whose matrix cell has no configured tiers
+         */
+        default_unit_amount: string;
+
+        /**
+         * One or two event property values to evaluate matrix cells by
+         */
+        dimensions: Array<string>;
+
+        /**
+         * Graduated tiers keyed by matrix cell; usage in a cell is tiered only against its
+         * own rows
+         */
+        tiers: Array<TieredMatrixWithAllocationConfig.Tier>;
+      }
+
+      export namespace TieredMatrixWithAllocationConfig {
+        /**
+         * Configuration for a single tier scoped to one matrix cell
+         */
+        export interface Tier {
+          /**
+           * The matrix cell this tier applies to, as one or two dimension values
+           */
+          dimension_values: Array<string>;
+
+          /**
+           * Exclusive tier starting value. The tier runs up to and including the next bound
+           * configured for the same matrix cell.
+           */
+          tier_lower_bound: string;
+
+          /**
+           * Per unit amount
+           */
+          unit_amount: string;
+        }
+      }
+    }
+
     export interface NewPlanMatrixWithThresholdDiscountsPrice {
       /**
        * The cadence to bill for this price on.
@@ -2048,6 +2210,7 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       | Shared.NewPlanPackageWithAllocationPrice
       | Shared.NewPlanUnitWithPercentPrice
       | Shared.NewPlanMatrixWithAllocationPrice
+      | ReplacePrice.NewPlanTieredMatrixWithAllocationPrice
       | ReplacePrice.NewPlanMatrixWithThresholdDiscountsPrice
       | ReplacePrice.NewPlanTieredWithProrationPrice
       | Shared.NewPlanUnitWithProrationPrice
@@ -2523,6 +2686,167 @@ export namespace ExternalPlanIDCreatePlanVersionParams {
       }
     }
 
+    export interface NewPlanTieredMatrixWithAllocationPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * The id of the item the price will be associated with.
+       */
+      item_id: string;
+
+      /**
+       * The pricing model type
+       */
+      model_type: 'tiered_matrix_with_allocation';
+
+      /**
+       * The name of the price.
+       */
+      name: string;
+
+      /**
+       * Configuration for tiered_matrix_with_allocation pricing
+       */
+      tiered_matrix_with_allocation_config: NewPlanTieredMatrixWithAllocationPrice.TieredMatrixWithAllocationConfig;
+
+      /**
+       * The id of the billable metric for the price. Only needed if the price is
+       * usage-based.
+       */
+      billable_metric_id?: string | null;
+
+      /**
+       * If the Price represents a fixed cost, the price will be billed in-advance if
+       * this is true, and in-arrears if this is false.
+       */
+      billed_in_advance?: boolean | null;
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+
+      /**
+       * The per unit conversion rate of the price currency to the invoicing currency.
+       */
+      conversion_rate?: number | null;
+
+      /**
+       * The configuration for the rate of the price currency to the invoicing currency.
+       */
+      conversion_rate_config?: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+
+      /**
+       * An ISO 4217 currency string, or custom pricing unit identifier, in which this
+       * price is billed.
+       */
+      currency?: string | null;
+
+      /**
+       * For dimensional price: specifies a price group and dimension values
+       */
+      dimensional_price_configuration?: Shared.NewDimensionalPriceConfiguration | null;
+
+      /**
+       * An alias for the price.
+       */
+      external_price_id?: string | null;
+
+      /**
+       * If the Price represents a fixed cost, this represents the quantity of units
+       * applied.
+       */
+      fixed_price_quantity?: number | null;
+
+      /**
+       * The property used to group this price on an invoice
+       */
+      invoice_grouping_key?: string | null;
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: Shared.NewBillingCycleConfiguration | null;
+
+      /**
+       * The ID of the license type to associate with this price. On a usage price this
+       * also marks the price as eligible to draw down from that license type's
+       * allocation; a usage price created without it is billed normally. Usage prices
+       * with a license type must use the `unit` model, and only draw down when their
+       * currency matches the allocation's.
+       */
+      license_type_id?: string | null;
+
+      /**
+       * User-specified key/value pairs for the resource. Individual keys can be removed
+       * by setting the value to `null`, and the entire metadata mapping can be cleared
+       * by setting `metadata` to `null`.
+       */
+      metadata?: { [key: string]: string | null } | null;
+
+      /**
+       * A transient ID that can be used to reference this price when adding adjustments
+       * in the same API call.
+       */
+      reference_id?: string | null;
+    }
+
+    export namespace NewPlanTieredMatrixWithAllocationPrice {
+      /**
+       * Configuration for tiered_matrix_with_allocation pricing
+       */
+      export interface TieredMatrixWithAllocationConfig {
+        /**
+         * Usage allocation, pooled across all matrix cells
+         */
+        allocation: string;
+
+        /**
+         * Per unit rate for usage whose matrix cell has no configured tiers
+         */
+        default_unit_amount: string;
+
+        /**
+         * One or two event property values to evaluate matrix cells by
+         */
+        dimensions: Array<string>;
+
+        /**
+         * Graduated tiers keyed by matrix cell; usage in a cell is tiered only against its
+         * own rows
+         */
+        tiers: Array<TieredMatrixWithAllocationConfig.Tier>;
+      }
+
+      export namespace TieredMatrixWithAllocationConfig {
+        /**
+         * Configuration for a single tier scoped to one matrix cell
+         */
+        export interface Tier {
+          /**
+           * The matrix cell this tier applies to, as one or two dimension values
+           */
+          dimension_values: Array<string>;
+
+          /**
+           * Exclusive tier starting value. The tier runs up to and including the next bound
+           * configured for the same matrix cell.
+           */
+          tier_lower_bound: string;
+
+          /**
+           * Per unit amount
+           */
+          unit_amount: string;
+        }
+      }
+    }
+
     export interface NewPlanMatrixWithThresholdDiscountsPrice {
       /**
        * The cadence to bill for this price on.