@metronome/sdk 0.1.0-beta.8 → 0.1.0

package/src/resources/shared.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import * as Shared from './shared';
+import * as Shared from "./shared.js";
 
 export interface BaseUsageFilter {
   group_key: string;
@@ -34,6 +34,12 @@ export interface Commit {
 
   applicable_product_tags?: Array<string>;
 
+  /**
+   * RFC 3339 timestamp indicating when the commit was archived. If not provided, the
+   * commit is not archived.
+   */
+  archived_at?: string;
+
   /**
    * The current balance of the credit or commit. This balance reflects the amount of
    * credit or commit that the customer has access to use at this moment - thus,
@@ -48,10 +54,15 @@ export interface Commit {
 
   contract?: Commit.Contract;
 
-  custom_fields?: Record<string, string>;
+  custom_fields?: { [key: string]: string };
 
   description?: string;
 
+  /**
+   * Optional configuration for commit hierarchy access control
+   */
+  hierarchy_configuration?: Commit.HierarchyConfiguration;
+
   /**
    * The contract that this commit will be billed on.
    */
@@ -73,6 +84,7 @@ export interface Commit {
     | Commit.PrepaidCommitExpirationLedgerEntry
     | Commit.PrepaidCommitCanceledLedgerEntry
     | Commit.PrepaidCommitCreditedLedgerEntry
+    | Commit.PrepaidCommitSeatBasedAdjustmentLedgerEntry
     | Commit.PostpaidCommitInitialBalanceLedgerEntry
     | Commit.PostpaidCommitAutomatedInvoiceDeductionLedgerEntry
     | Commit.PostpaidCommitRolloverLedgerEntry
@@ -106,6 +118,13 @@ export interface Commit {
    */
   salesforce_opportunity_id?: string;
 
+  /**
+   * List of filters that determine what kind of customer usage draws down a commit
+   * or credit. A customer's usage needs to meet the condition of at least one of the
+   * specifiers to contribute to a commit's or credit's drawdown.
+   */
+  specifiers?: Array<Commit.Specifier>;
+
   /**
    * Prevents the creation of duplicates. If a request to create a commit or credit
    * is made with a uniqueness key that was previously used to create a commit or
@@ -126,6 +145,32 @@ export namespace Commit {
     id: string;
   }
 
+  /**
+   * Optional configuration for commit hierarchy access control
+   */
+  export interface HierarchyConfiguration {
+    child_access:
+      | HierarchyConfiguration.CommitHierarchyChildAccessAll
+      | HierarchyConfiguration.CommitHierarchyChildAccessNone
+      | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+  }
+
+  export namespace HierarchyConfiguration {
+    export interface CommitHierarchyChildAccessAll {
+      type: 'ALL';
+    }
+
+    export interface CommitHierarchyChildAccessNone {
+      type: 'NONE';
+    }
+
+    export interface CommitHierarchyChildAccessContractIDs {
+      contract_ids: Array<string>;
+
+      type: 'CONTRACT_IDS';
+    }
+  }
+
   /**
    * The contract that this commit will be billed on.
    */
@@ -201,6 +246,16 @@ export namespace Commit {
     type: 'PREPAID_COMMIT_CREDITED';
   }
 
+  export interface PrepaidCommitSeatBasedAdjustmentLedgerEntry {
+    amount: number;
+
+    segment_id: string;
+
+    timestamp: string;
+
+    type: 'PREPAID_COMMIT_SEAT_BASED_ADJUSTMENT';
+  }
+
   export interface PostpaidCommitInitialBalanceLedgerEntry {
     amount: number;
 
@@ -276,6 +331,23 @@ export namespace Commit {
 
     contract_id: string;
   }
+
+  export interface Specifier {
+    presentation_group_values?: { [key: string]: string };
+
+    pricing_group_values?: { [key: string]: string };
+
+    /**
+     * If provided, the specifier will only apply to the product with the specified ID.
+     */
+    product_id?: string;
+
+    /**
+     * If provided, the specifier will only apply to products with all the specified
+     * tags.
+     */
+    product_tags?: Array<string>;
+  }
 }
 
 export interface ContractWithoutAmendments {
@@ -304,6 +376,14 @@ export interface ContractWithoutAmendments {
 
   ending_before?: string;
 
+  /**
+   * Either a **parent** configuration with a list of children or a **child**
+   * configuration with a single parent.
+   */
+  hierarchy_configuration?:
+    | ContractWithoutAmendments.ParentHierarchyConfiguration
+    | ContractWithoutAmendments.ChildHierarchyConfiguration;
+
   name?: string;
 
   net_payment_terms_days?: number;
@@ -313,6 +393,8 @@ export interface ContractWithoutAmendments {
    */
   netsuite_sales_order_id?: string;
 
+  prepaid_balance_threshold_configuration?: ContractWithoutAmendments.PrepaidBalanceThresholdConfiguration;
+
   /**
    * This field's availability is dependent on your client's configuration.
    */
@@ -343,6 +425,8 @@ export interface ContractWithoutAmendments {
    */
   scheduled_charges_on_usage_invoices?: 'ALL';
 
+  spend_threshold_configuration?: ContractWithoutAmendments.SpendThresholdConfiguration;
+
   /**
    * This field's availability is dependent on your client's configuration.
    */
@@ -366,7 +450,191 @@ export namespace ContractWithoutAmendments {
      */
     billing_anchor_date: string;
 
-    frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL';
+    frequency: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+  }
+
+  export interface ParentHierarchyConfiguration {
+    /**
+     * List of contracts that belong to this parent.
+     */
+    children: Array<ParentHierarchyConfiguration.Child>;
+  }
+
+  export namespace ParentHierarchyConfiguration {
+    export interface Child {
+      contract_id: string;
+
+      customer_id: string;
+    }
+  }
+
+  export interface ChildHierarchyConfiguration {
+    /**
+     * The single parent contract/customer for this child.
+     */
+    parent: ChildHierarchyConfiguration.Parent;
+  }
+
+  export namespace ChildHierarchyConfiguration {
+    /**
+     * The single parent contract/customer for this child.
+     */
+    export interface Parent {
+      contract_id: string;
+
+      customer_id: string;
+    }
+  }
+
+  export interface PrepaidBalanceThresholdConfiguration {
+    commit: PrepaidBalanceThresholdConfiguration.Commit;
+
+    /**
+     * When set to false, the contract will not be evaluated against the
+     * threshold_amount. Toggling to true will result an immediate evaluation,
+     * regardless of prior state.
+     */
+    is_enabled: boolean;
+
+    payment_gate_config: PrepaidBalanceThresholdConfiguration.PaymentGateConfig;
+
+    /**
+     * Specify the amount the balance should be recharged to.
+     */
+    recharge_to_amount: number;
+
+    /**
+     * Specify the threshold amount for the contract. Each time the contract's prepaid
+     * balance lowers to this amount, a threshold charge will be initiated.
+     */
+    threshold_amount: number;
+
+    /**
+     * If provided, the threshold, recharge-to amount, and the resulting threshold
+     * commit amount will be in terms of this credit type instead of the fiat currency.
+     */
+    custom_credit_type_id?: string;
+  }
+
+  export namespace PrepaidBalanceThresholdConfiguration {
+    export interface Commit {
+      /**
+       * The commit product that will be used to generate the line item for commit
+       * payment.
+       */
+      product_id: string;
+
+      /**
+       * Which products the threshold commit applies to. If applicable_product_ids,
+       * applicable_product_tags or specifiers are not provided, the commit applies to
+       * all products.
+       */
+      applicable_product_ids?: Array<string>;
+
+      /**
+       * Which tags the threshold commit applies to. If applicable_product_ids,
+       * applicable_product_tags or specifiers are not provided, the commit applies to
+       * all products.
+       */
+      applicable_product_tags?: Array<string>;
+
+      description?: string;
+
+      /**
+       * Specify the name of the line item for the threshold charge. If left blank, it
+       * will default to the commit product name.
+       */
+      name?: string;
+
+      /**
+       * List of filters that determine what kind of customer usage draws down a commit
+       * or credit. A customer's usage needs to meet the condition of at least one of the
+       * specifiers to contribute to a commit's or credit's drawdown. This field cannot
+       * be used together with `applicable_product_ids` or `applicable_product_tags`.
+       */
+      specifiers?: Array<Commit.Specifier>;
+    }
+
+    export namespace Commit {
+      export interface Specifier {
+        presentation_group_values?: { [key: string]: string };
+
+        pricing_group_values?: { [key: string]: string };
+
+        /**
+         * If provided, the specifier will only apply to the product with the specified ID.
+         */
+        product_id?: string;
+
+        /**
+         * If provided, the specifier will only apply to products with all the specified
+         * tags.
+         */
+        product_tags?: Array<string>;
+      }
+    }
+
+    export interface PaymentGateConfig {
+      /**
+       * Gate access to the commit balance based on successful collection of payment.
+       * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
+       * facilitate payment using your own payment integration. Select NONE if you do not
+       * wish to payment gate the commit balance.
+       */
+      payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
+
+      /**
+       * Only applicable if using PRECALCULATED as your tax type.
+       */
+      precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
+
+      /**
+       * Only applicable if using STRIPE as your payment gate type.
+       */
+      stripe_config?: PaymentGateConfig.StripeConfig;
+
+      /**
+       * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
+       * not wish Metronome to calculate tax on your behalf. Leaving this field blank
+       * will default to NONE.
+       */
+      tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
+    }
+
+    export namespace PaymentGateConfig {
+      /**
+       * Only applicable if using PRECALCULATED as your tax type.
+       */
+      export interface PrecalculatedTaxConfig {
+        /**
+         * Amount of tax to be applied. This should be in the same currency and
+         * denomination as the commit's invoice schedule
+         */
+        tax_amount: number;
+
+        /**
+         * Name of the tax to be applied. This may be used in an invoice line item
+         * description.
+         */
+        tax_name?: string;
+      }
+
+      /**
+       * Only applicable if using STRIPE as your payment gate type.
+       */
+      export interface StripeConfig {
+        /**
+         * If left blank, will default to INVOICE
+         */
+        payment_type: 'INVOICE' | 'PAYMENT_INTENT';
+
+        /**
+         * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
+         * your payment type.
+         */
+        invoice_metadata?: { [key: string]: string };
+      }
+    }
   }
 
   export interface RecurringCommit {
@@ -421,6 +689,11 @@ export namespace ContractWithoutAmendments {
      */
     ending_before?: string;
 
+    /**
+     * Optional configuration for recurring commit/credit hierarchy access control
+     */
+    hierarchy_configuration?: RecurringCommit.HierarchyConfiguration;
+
     /**
      * The amount the customer should be billed for the commit. Not required.
      */
@@ -436,12 +709,34 @@ export namespace ContractWithoutAmendments {
      */
     netsuite_sales_order_id?: string;
 
+    /**
+     * Determines whether the first and last commit will be prorated. If not provided,
+     * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
+     */
+    proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
+
+    /**
+     * The frequency at which the recurring commits will be created. If not provided: -
+     * The commits will be created on the usage invoice frequency. If provided: - The
+     * period defined in the duration will correspond to this frequency. - Commits will
+     * be created aligned with the recurring commit's starting_at rather than the usage
+     * invoice dates.
+     */
+    recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+
     /**
      * Will be passed down to the individual commits. This controls how much of an
      * individual unexpired commit will roll over upon contract transition. Must be
      * between 0 and 1.
      */
     rollover_fraction?: number;
+
+    /**
+     * List of filters that determine what kind of customer usage draws down a commit
+     * or credit. A customer's usage needs to meet the condition of at least one of the
+     * specifiers to contribute to a commit's or credit's drawdown.
+     */
+    specifiers?: Array<RecurringCommit.Specifier>;
   }
 
   export namespace RecurringCommit {
@@ -451,9 +746,9 @@ export namespace ContractWithoutAmendments {
     export interface AccessAmount {
       credit_type_id: string;
 
-      quantity: number;
-
       unit_price: number;
+
+      quantity?: number;
     }
 
     /**
@@ -475,6 +770,32 @@ export namespace ContractWithoutAmendments {
       id: string;
     }
 
+    /**
+     * Optional configuration for recurring commit/credit hierarchy access control
+     */
+    export interface HierarchyConfiguration {
+      child_access:
+        | HierarchyConfiguration.CommitHierarchyChildAccessAll
+        | HierarchyConfiguration.CommitHierarchyChildAccessNone
+        | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+    }
+
+    export namespace HierarchyConfiguration {
+      export interface CommitHierarchyChildAccessAll {
+        type: 'ALL';
+      }
+
+      export interface CommitHierarchyChildAccessNone {
+        type: 'NONE';
+      }
+
+      export interface CommitHierarchyChildAccessContractIDs {
+        contract_ids: Array<string>;
+
+        type: 'CONTRACT_IDS';
+      }
+    }
+
     /**
      * The amount the customer should be billed for the commit. Not required.
      */
@@ -485,6 +806,23 @@ export namespace ContractWithoutAmendments {
 
       unit_price: number;
     }
+
+    export interface Specifier {
+      presentation_group_values?: { [key: string]: string };
+
+      pricing_group_values?: { [key: string]: string };
+
+      /**
+       * If provided, the specifier will only apply to the product with the specified ID.
+       */
+      product_id?: string;
+
+      /**
+       * If provided, the specifier will only apply to products with all the specified
+       * tags.
+       */
+      product_tags?: Array<string>;
+    }
   }
 
   export interface RecurringCredit {
@@ -540,9 +878,9 @@ export namespace ContractWithoutAmendments {
     ending_before?: string;
 
     /**
-     * The amount the customer should be billed for the commit. Not required.
+     * Optional configuration for recurring commit/credit hierarchy access control
      */
-    invoice_amount?: RecurringCredit.InvoiceAmount;
+    hierarchy_configuration?: RecurringCredit.HierarchyConfiguration;
 
     /**
      * Displayed on invoices. Will be passed through to the individual commits
@@ -554,12 +892,34 @@ export namespace ContractWithoutAmendments {
      */
     netsuite_sales_order_id?: string;
 
+    /**
+     * Determines whether the first and last commit will be prorated. If not provided,
+     * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
+     */
+    proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
+
+    /**
+     * The frequency at which the recurring commits will be created. If not provided: -
+     * The commits will be created on the usage invoice frequency. If provided: - The
+     * period defined in the duration will correspond to this frequency. - Commits will
+     * be created aligned with the recurring commit's starting_at rather than the usage
+     * invoice dates.
+     */
+    recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+
     /**
      * Will be passed down to the individual commits. This controls how much of an
      * individual unexpired commit will roll over upon contract transition. Must be
      * between 0 and 1.
      */
     rollover_fraction?: number;
+
+    /**
+     * List of filters that determine what kind of customer usage draws down a commit
+     * or credit. A customer's usage needs to meet the condition of at least one of the
+     * specifiers to contribute to a commit's or credit's drawdown.
+     */
+    specifiers?: Array<RecurringCredit.Specifier>;
   }
 
   export namespace RecurringCredit {
@@ -569,9 +929,9 @@ export namespace ContractWithoutAmendments {
     export interface AccessAmount {
       credit_type_id: string;
 
-      quantity: number;
-
       unit_price: number;
+
+      quantity?: number;
     }
 
     /**
@@ -594,14 +954,46 @@ export namespace ContractWithoutAmendments {
     }
 
     /**
-     * The amount the customer should be billed for the commit. Not required.
+     * Optional configuration for recurring commit/credit hierarchy access control
      */
-    export interface InvoiceAmount {
-      credit_type_id: string;
+    export interface HierarchyConfiguration {
+      child_access:
+        | HierarchyConfiguration.CommitHierarchyChildAccessAll
+        | HierarchyConfiguration.CommitHierarchyChildAccessNone
+        | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+    }
 
-      quantity: number;
+    export namespace HierarchyConfiguration {
+      export interface CommitHierarchyChildAccessAll {
+        type: 'ALL';
+      }
 
-      unit_price: number;
+      export interface CommitHierarchyChildAccessNone {
+        type: 'NONE';
+      }
+
+      export interface CommitHierarchyChildAccessContractIDs {
+        contract_ids: Array<string>;
+
+        type: 'CONTRACT_IDS';
+      }
+    }
+
+    export interface Specifier {
+      presentation_group_values?: { [key: string]: string };
+
+      pricing_group_values?: { [key: string]: string };
+
+      /**
+       * If provided, the specifier will only apply to the product with the specified ID.
+       */
+      product_id?: string;
+
+      /**
+       * If provided, the specifier will only apply to products with all the specified
+       * tags.
+       */
+      product_tags?: Array<string>;
     }
   }
 
@@ -633,6 +1025,105 @@ export namespace ContractWithoutAmendments {
     reseller_contract_value?: number;
   }
 
+  export interface SpendThresholdConfiguration {
+    commit: SpendThresholdConfiguration.Commit;
+
+    /**
+     * When set to false, the contract will not be evaluated against the
+     * threshold_amount. Toggling to true will result an immediate evaluation,
+     * regardless of prior state.
+     */
+    is_enabled: boolean;
+
+    payment_gate_config: SpendThresholdConfiguration.PaymentGateConfig;
+
+    /**
+     * Specify the threshold amount for the contract. Each time the contract's usage
+     * hits this amount, a threshold charge will be initiated.
+     */
+    threshold_amount: number;
+  }
+
+  export namespace SpendThresholdConfiguration {
+    export interface Commit {
+      /**
+       * The commit product that will be used to generate the line item for commit
+       * payment.
+       */
+      product_id: string;
+
+      description?: string;
+
+      /**
+       * Specify the name of the line item for the threshold charge. If left blank, it
+       * will default to the commit product name.
+       */
+      name?: string;
+    }
+
+    export interface PaymentGateConfig {
+      /**
+       * Gate access to the commit balance based on successful collection of payment.
+       * Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to
+       * facilitate payment using your own payment integration. Select NONE if you do not
+       * wish to payment gate the commit balance.
+       */
+      payment_gate_type: 'NONE' | 'STRIPE' | 'EXTERNAL';
+
+      /**
+       * Only applicable if using PRECALCULATED as your tax type.
+       */
+      precalculated_tax_config?: PaymentGateConfig.PrecalculatedTaxConfig;
+
+      /**
+       * Only applicable if using STRIPE as your payment gate type.
+       */
+      stripe_config?: PaymentGateConfig.StripeConfig;
+
+      /**
+       * Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
+       * not wish Metronome to calculate tax on your behalf. Leaving this field blank
+       * will default to NONE.
+       */
+      tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
+    }
+
+    export namespace PaymentGateConfig {
+      /**
+       * Only applicable if using PRECALCULATED as your tax type.
+       */
+      export interface PrecalculatedTaxConfig {
+        /**
+         * Amount of tax to be applied. This should be in the same currency and
+         * denomination as the commit's invoice schedule
+         */
+        tax_amount: number;
+
+        /**
+         * Name of the tax to be applied. This may be used in an invoice line item
+         * description.
+         */
+        tax_name?: string;
+      }
+
+      /**
+       * Only applicable if using STRIPE as your payment gate type.
+       */
+      export interface StripeConfig {
+        /**
+         * If left blank, will default to INVOICE
+         */
+        payment_type: 'INVOICE' | 'PAYMENT_INTENT';
+
+        /**
+         * Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
+         * your payment type.
+         */
+        invoice_metadata?: { [key: string]: string };
+      }
+    }
+  }
+
   export interface UsageFilter {
     current: Shared.BaseUsageFilter | null;
 
@@ -684,10 +1175,15 @@ export interface Credit {
 
   contract?: Credit.Contract;
 
-  custom_fields?: Record<string, string>;
+  custom_fields?: { [key: string]: string };
 
   description?: string;
 
+  /**
+   * Optional configuration for credit hierarchy access control
+   */
+  hierarchy_configuration?: Credit.HierarchyConfiguration;
+
   /**
    * A list of ordered events that impact the balance of a credit. For example, an
    * invoice deduction or an expiration.
@@ -699,6 +1195,7 @@ export interface Credit {
     | Credit.CreditCanceledLedgerEntry
     | Credit.CreditCreditedLedgerEntry
     | Credit.CreditManualLedgerEntry
+    | Credit.CreditSeatBasedAdjustmentLedgerEntry
   >;
 
   name?: string;
@@ -721,6 +1218,13 @@ export interface Credit {
    */
   salesforce_opportunity_id?: string;
 
+  /**
+   * List of filters that determine what kind of customer usage draws down a commit
+   * or credit. A customer's usage needs to meet the condition of at least one of the
+   * specifiers to contribute to a commit's or credit's drawdown.
+   */
+  specifiers?: Array<Credit.Specifier>;
+
   /**
    * Prevents the creation of duplicates. If a request to create a commit or credit
    * is made with a uniqueness key that was previously used to create a commit or
@@ -741,6 +1245,32 @@ export namespace Credit {
     id: string;
   }
 
+  /**
+   * Optional configuration for credit hierarchy access control
+   */
+  export interface HierarchyConfiguration {
+    child_access:
+      | HierarchyConfiguration.CommitHierarchyChildAccessAll
+      | HierarchyConfiguration.CommitHierarchyChildAccessNone
+      | HierarchyConfiguration.CommitHierarchyChildAccessContractIDs;
+  }
+
+  export namespace HierarchyConfiguration {
+    export interface CommitHierarchyChildAccessAll {
+      type: 'ALL';
+    }
+
+    export interface CommitHierarchyChildAccessNone {
+      type: 'NONE';
+    }
+
+    export interface CommitHierarchyChildAccessContractIDs {
+      contract_ids: Array<string>;
+
+      type: 'CONTRACT_IDS';
+    }
+  }
+
   export interface CreditSegmentStartLedgerEntry {
     amount: number;
 
@@ -806,6 +1336,33 @@ export namespace Credit {
 
     type: 'CREDIT_MANUAL';
   }
+
+  export interface CreditSeatBasedAdjustmentLedgerEntry {
+    amount: number;
+
+    segment_id: string;
+
+    timestamp: string;
+
+    type: 'CREDIT_SEAT_BASED_ADJUSTMENT';
+  }
+
+  export interface Specifier {
+    presentation_group_values?: { [key: string]: string };
+
+    pricing_group_values?: { [key: string]: string };
+
+    /**
+     * If provided, the specifier will only apply to the product with the specified ID.
+     */
+    product_id?: string;
+
+    /**
+     * If provided, the specifier will only apply to products with all the specified
+     * tags.
+     */
+    product_tags?: Array<string>;
+  }
 }
 
 export interface CreditTypeData {
@@ -821,7 +1378,7 @@ export interface Discount {
 
   schedule: SchedulePointInTime;
 
-  custom_fields?: Record<string, string>;
+  custom_fields?: { [key: string]: string };
 
   name?: string;
 
@@ -921,16 +1478,18 @@ export interface Override {
    * Only set for CUSTOM rate_type. This field is interpreted by custom rate
    * processors.
    */
-  value?: Record<string, unknown>;
+  value?: { [key: string]: unknown };
 }
 
 export namespace Override {
   export interface OverrideSpecifier {
+    billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+
     commit_ids?: Array<string>;
 
-    presentation_group_values?: Record<string, string | null>;
+    presentation_group_values?: { [key: string]: string | null };
 
-    pricing_group_values?: Record<string, string>;
+    pricing_group_values?: { [key: string]: string };
 
     product_id?: string;
 
@@ -956,7 +1515,7 @@ export namespace Override {
      * Only set for CUSTOM rate_type. This field is interpreted by custom rate
      * processors.
      */
-    custom_rate?: Record<string, unknown>;
+    custom_rate?: { [key: string]: unknown };
 
     /**
      * Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be
@@ -1041,7 +1600,7 @@ export interface ProService {
    */
   unit_price: number;
 
-  custom_fields?: Record<string, string>;
+  custom_fields?: { [key: string]: string };
 
   description?: string;
 
@@ -1060,7 +1619,7 @@ export interface Rate {
    * Only set for CUSTOM rate_type. This field is interpreted by custom rate
    * processors.
    */
-  custom_rate?: Record<string, unknown>;
+  custom_rate?: { [key: string]: unknown };
 
   /**
    * Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be
@@ -1078,7 +1637,7 @@ export interface Rate {
    * if pricing groups are used, this will contain the values used to calculate the
    * price
    */
-  pricing_group_values?: Record<string, string>;
+  pricing_group_values?: { [key: string]: string };
 
   /**
    * Default quantity. For SUBSCRIPTION rate_type, this must be >=0.
@@ -1105,7 +1664,9 @@ export interface ScheduledCharge {
 
   schedule: SchedulePointInTime;
 
-  custom_fields?: Record<string, string>;
+  archived_at?: string;
+
+  custom_fields?: { [key: string]: string };
 
   /**
    * displayed on invoices
@@ -1156,13 +1717,13 @@ export namespace SchedulePointInTime {
 
     amount: number;
 
-    invoice_id: string;
-
     quantity: number;
 
     timestamp: string;
 
     unit_price: number;
+
+    invoice_id?: string | null;
   }
 }