orb-billing 5.15.0 → 5.16.0

package/resources/shared.d.ts

@@ -1537,8 +1537,18 @@ export interface InvoiceTiny {
      */
     id: string;
 }
+/**
+ * A minimal representation of an Item containing only the essential identifying
+ * information.
+ */
 export interface ItemSlim {
+    /**
+     * The Orb-assigned unique identifier for the item.
+     */
     id: string;
+    /**
+     * The name of the item.
+     */
     name: string;
 }
 /**
@@ -7770,7 +7780,7 @@ export interface PlanPhaseUsageDiscountAdjustment {
  * For more on the types of prices, see
  * [the core concepts documentation](/core-concepts#plan-and-price)
  */
-export type Price = Price.UnitPrice | Price.TieredPrice | Price.BulkPrice | Price.PackagePrice | Price.MatrixPrice | Price.ThresholdTotalAmountPrice | Price.TieredPackagePrice | Price.TieredWithMinimumPrice | Price.GroupedTieredPrice | Price.TieredPackageWithMinimumPrice | Price.PackageWithAllocationPrice | Price.UnitWithPercentPrice | Price.MatrixWithAllocationPrice | Price.TieredWithProrationPrice | Price.UnitWithProrationPrice | Price.GroupedAllocationPrice | Price.BulkWithProrationPrice | Price.GroupedWithProratedMinimumPrice | Price.GroupedWithMeteredMinimumPrice | Price.GroupedWithMinMaxThresholdsPrice | Price.MatrixWithDisplayNamePrice | Price.GroupedTieredPackagePrice | Price.MaxGroupTieredPackagePrice | Price.ScalableMatrixWithUnitPricingPrice | Price.ScalableMatrixWithTieredPricingPrice | Price.CumulativeGroupedBulkPrice | Price.MinimumCompositePrice;
+export type Price = Price.UnitPrice | Price.TieredPrice | Price.BulkPrice | Price.PackagePrice | Price.MatrixPrice | Price.ThresholdTotalAmountPrice | Price.TieredPackagePrice | Price.TieredWithMinimumPrice | Price.GroupedTieredPrice | Price.TieredPackageWithMinimumPrice | Price.PackageWithAllocationPrice | Price.UnitWithPercentPrice | Price.MatrixWithAllocationPrice | Price.TieredWithProrationPrice | Price.UnitWithProrationPrice | Price.GroupedAllocationPrice | Price.BulkWithProrationPrice | Price.GroupedWithProratedMinimumPrice | Price.GroupedWithMeteredMinimumPrice | Price.GroupedWithMinMaxThresholdsPrice | Price.MatrixWithDisplayNamePrice | Price.GroupedTieredPackagePrice | Price.MaxGroupTieredPackagePrice | Price.ScalableMatrixWithUnitPricingPrice | Price.ScalableMatrixWithTieredPricingPrice | Price.CumulativeGroupedBulkPrice | Price.MinimumCompositePrice | Price.PercentCompositePrice | Price.EventOutputPrice;
 export declare namespace Price {
     interface UnitPrice {
         id: string;
@@ -7791,6 +7801,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -7854,6 +7868,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -7921,6 +7939,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -7980,6 +8002,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -8043,6 +8069,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * Configuration for matrix pricing
@@ -8106,6 +8136,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -8200,6 +8234,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -8296,6 +8334,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -8402,6 +8444,10 @@ export declare namespace Price {
          */
         grouped_tiered_config: GroupedTieredPrice.GroupedTieredConfig;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -8492,6 +8538,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -8590,6 +8640,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -8672,6 +8726,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -8750,6 +8808,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * Configuration for matrix_with_allocation pricing
@@ -8813,6 +8875,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -8903,6 +8969,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -8981,6 +9051,10 @@ export declare namespace Price {
          */
         grouped_allocation_config: GroupedAllocationPrice.GroupedAllocationConfig;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -9063,6 +9137,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -9152,6 +9230,10 @@ export declare namespace Price {
          */
         grouped_with_prorated_minimum_config: GroupedWithProratedMinimumPrice.GroupedWithProratedMinimumConfig;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -9234,6 +9316,10 @@ export declare namespace Price {
          */
         grouped_with_metered_minimum_config: GroupedWithMeteredMinimumPrice.GroupedWithMeteredMinimumConfig;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -9358,6 +9444,10 @@ export declare namespace Price {
          */
         grouped_with_min_max_thresholds_config: GroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -9440,6 +9530,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * Configuration for matrix_with_display_name pricing
@@ -9541,6 +9635,10 @@ export declare namespace Price {
          */
         grouped_tiered_package_config: GroupedTieredPackagePrice.GroupedTieredPackageConfig;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -9635,6 +9733,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * Configuration for max_group_tiered_package pricing
@@ -9732,6 +9834,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -9841,6 +9947,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -9963,6 +10073,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -10056,6 +10170,10 @@ export declare namespace Price {
         external_price_id: string | null;
         fixed_price_quantity: number | null;
         invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
         item: Shared.ItemSlim;
         /**
          * @deprecated
@@ -10115,6 +10233,167 @@ export declare namespace Price {
             prorated?: boolean;
         }
     }
+    interface PercentCompositePrice {
+        id: string;
+        billable_metric: Shared.BillableMetricTiny | null;
+        billing_cycle_configuration: Shared.BillingCycleConfiguration;
+        billing_mode: 'in_advance' | 'in_arrear';
+        cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+        composite_price_filters: Array<Shared.TransformPriceFilter> | null;
+        conversion_rate: number | null;
+        conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+        created_at: string;
+        credit_allocation: Shared.Allocation | null;
+        currency: string;
+        /**
+         * @deprecated
+         */
+        discount: Shared.Discount | null;
+        external_price_id: string | null;
+        fixed_price_quantity: number | null;
+        invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
+        item: Shared.ItemSlim;
+        /**
+         * @deprecated
+         */
+        maximum: Shared.Maximum | null;
+        /**
+         * @deprecated
+         */
+        maximum_amount: string | null;
+        /**
+         * User specified key-value pairs for the resource. If not present, this defaults
+         * to an empty dictionary. 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;
+        };
+        /**
+         * @deprecated
+         */
+        minimum: Shared.Minimum | null;
+        /**
+         * @deprecated
+         */
+        minimum_amount: string | null;
+        /**
+         * The pricing model type
+         */
+        model_type: 'percent';
+        name: string;
+        /**
+         * Configuration for percent pricing
+         */
+        percent_config: PercentCompositePrice.PercentConfig;
+        plan_phase_order: number | null;
+        price_type: 'usage_price' | 'fixed_price' | 'composite_price';
+        /**
+         * The price id this price replaces. This price will take the place of the replaced
+         * price in plan version migrations.
+         */
+        replaces_price_id: string | null;
+        dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
+    }
+    namespace PercentCompositePrice {
+        /**
+         * Configuration for percent pricing
+         */
+        interface PercentConfig {
+            /**
+             * What percent of the component subtotals to charge
+             */
+            percent: number;
+        }
+    }
+    interface EventOutputPrice {
+        id: string;
+        billable_metric: Shared.BillableMetricTiny | null;
+        billing_cycle_configuration: Shared.BillingCycleConfiguration;
+        billing_mode: 'in_advance' | 'in_arrear';
+        cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+        composite_price_filters: Array<Shared.TransformPriceFilter> | null;
+        conversion_rate: number | null;
+        conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+        created_at: string;
+        credit_allocation: Shared.Allocation | null;
+        currency: string;
+        /**
+         * @deprecated
+         */
+        discount: Shared.Discount | null;
+        /**
+         * Configuration for event_output pricing
+         */
+        event_output_config: EventOutputPrice.EventOutputConfig;
+        external_price_id: string | null;
+        fixed_price_quantity: number | null;
+        invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+        /**
+         * A minimal representation of an Item containing only the essential identifying
+         * information.
+         */
+        item: Shared.ItemSlim;
+        /**
+         * @deprecated
+         */
+        maximum: Shared.Maximum | null;
+        /**
+         * @deprecated
+         */
+        maximum_amount: string | null;
+        /**
+         * User specified key-value pairs for the resource. If not present, this defaults
+         * to an empty dictionary. 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;
+        };
+        /**
+         * @deprecated
+         */
+        minimum: Shared.Minimum | null;
+        /**
+         * @deprecated
+         */
+        minimum_amount: string | null;
+        /**
+         * The pricing model type
+         */
+        model_type: 'event_output';
+        name: string;
+        plan_phase_order: number | null;
+        price_type: 'usage_price' | 'fixed_price' | 'composite_price';
+        /**
+         * The price id this price replaces. This price will take the place of the replaced
+         * price in plan version migrations.
+         */
+        replaces_price_id: string | null;
+        dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
+    }
+    namespace EventOutputPrice {
+        /**
+         * Configuration for event_output pricing
+         */
+        interface EventOutputConfig {
+            /**
+             * The key in the event data to extract the unit rate from.
+             */
+            unit_rating_key: string;
+            /**
+             * An optional key in the event data to group by (e.g., event ID). All events will
+             * also be grouped by their unit rate.
+             */
+            grouping_key?: string | null;
+        }
+    }
 }
 /**
  * The Price Interval resource represents a period of time for which a price will