@aimee.shop/sdk 0.19.0 → 0.20.0-dev.157

package/dist/generated/core-api.d.ts

@@ -1459,7 +1459,7 @@ export interface paths {
         head?: never;
         /**
          * Update a tenant
-         * @description Update an existing tenant with new data. Tenant owners can update their own tenant settings.
+         * @description Update an existing tenant with new data. Tenant owners can update their own tenant settings. billingType, isSandbox, sandboxTenantId and productionTenantId are staff-only and rejected here.
          */
         patch: operations['TenantsController_update'];
         trace?: never;
@@ -1495,7 +1495,7 @@ export interface paths {
         put?: never;
         /**
          * Suspend a tenant
-         * @description Suspend a tenant by setting its status to suspended. This prevents access to the tenant while preserving data. Platform admin only; audited.
+         * @description Suspend a tenant by setting its status to suspended. This prevents access to the tenant while preserving data. The cause (default manual), reason, time and actor are kept on the tenant until it is activated. Platform admin only; audited.
          */
         post: operations['TenantsController_suspend'];
         delete?: never;
@@ -1504,6 +1504,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/tenants/{id}/billing-type': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Set a tenant billing type
+         * @description Change how Aimee collects the platform fee from this tenant. Platform admin only; audited.
+         */
+        post: operations['TenantsController_setBillingType'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/tenants/{id}/sandbox': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Set whether a tenant is a sandbox
+         * @description Sandbox tenants skip billing usage and cannot use live payment credentials. Platform admin only; audited.
+         */
+        post: operations['TenantsController_setSandbox'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/tenants/{id}/activate': {
         parameters: {
             query?: never;
@@ -7892,7 +7932,7 @@ export interface paths {
         };
         /**
          * Get platform billing usage for a UTC calendar month
-         * @description Returns billable order GMV (discounted merchandise + shipping, excluding tax) aggregated per currency and per store for the organization (tenant). Fee is 2% of net GMV computed at read time. Sandbox store orders are excluded. This is a mutable event-backed read model; do not charge from it directly (#63).
+         * @description Returns billable order GMV (discounted merchandise + shipping, excluding tax) aggregated per currency and per store for the organization (tenant). Fee is the rate card's graduated GMV line, estimated at read time. Sandbox store orders are excluded. This is a mutable event-backed read model; do not charge from it directly (#63).
          */
         get: operations['BillingUsageController_getUsage'];
         put?: never;
@@ -7950,7 +7990,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get a finalized platform invoice by id */
+        /**
+         * Get a finalized platform invoice by id
+         * @description Includes the rated lines with their tier breakdown (core-api#71).
+         */
         get: operations['PlatformInvoicesController_getOne'];
         put?: never;
         post?: never;
@@ -7978,6 +8021,149 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/billing/rate-card': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the rate card version that rates the organization
+         * @description The organization's own negotiated card when it has one in effect, else the platform default.
+         */
+        get: operations['PlatformBillingRatesController_getRateCard'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/billing/estimate': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the provisional platform fee for an open period
+         * @description Rates the period so far with the same code as invoice finalization: one estimate per open currency, with lines and tier breakdown.
+         */
+        get: operations['PlatformBillingRatesController_getEstimate'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/billing/metered-usage': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get metered AimeeBot token usage for a period
+         * @description Input and output tokens, with whether the rate card charges for each (billed = false is shown as not charged).
+         */
+        get: operations['PlatformBillingRatesController_getMeteredUsage'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/billing/admin/rate-cards': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List rate card versions (system admin)
+         * @description A tenant's versions with tenantId, else the platform default's. Newest version first per currency.
+         */
+        get: operations['RateCardsAdminController_list'];
+        put?: never;
+        /**
+         * Create a rate card version (system admin)
+         * @description Adds the next version for a tenant (or the platform default when tenantId is omitted), effective from a period boundary no earlier than the current period. Versions are immutable.
+         */
+        post: operations['RateCardsAdminController_create'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/billing/admin/rate-cards/{id}': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a rate card version (system admin) */
+        get: operations['RateCardsAdminController_getOne'];
+        put?: never;
+        post?: never;
+        /**
+         * Delete an unused rate card version (system admin)
+         * @description Only a version no invoice used. A platform default version already in effect cannot be deleted.
+         */
+        delete: operations['RateCardsAdminController_remove'];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/billing/admin/charges': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List a tenant's one-off charges (system admin) */
+        get: operations['BillingChargesAdminController_list'];
+        put?: never;
+        /**
+         * Add a one-off charge or credit (system admin)
+         * @description Lands on the period's invoice as a one_off line. The period must be the current one or later and not finalized. A credit (category credit) has a negative unitPriceCents.
+         */
+        post: operations['BillingChargesAdminController_create'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/billing/admin/charges/{id}': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Remove a one-off charge from an open period (system admin) */
+        delete: operations['BillingChargesAdminController_remove'];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/returns': {
         parameters: {
             query?: never;
@@ -16067,6 +16253,15 @@ export interface components {
              * @enum {string|null}
              */
             suspensionCause?: 'manual' | 'non_payment' | null;
+            /** @description Reason given for the current suspension; null unless status is suspended. */
+            suspensionReason?: string | null;
+            /**
+             * Format: date-time
+             * @description When the current suspension started; null unless status is suspended.
+             */
+            suspendedAt?: string | null;
+            /** @description Staff user who suspended the tenant; null for a system (non_payment) suspension or when not suspended. */
+            suspendedBy?: string | null;
             /**
              * @description Platform fee collection path. SELF_SERVICE_CARD for public signup; ENTERPRISE_INVOICE for hand-onboarded orgs. Null when not set.
              * @example SELF_SERVICE_CARD
@@ -16275,28 +16470,6 @@ export interface components {
              * @example ACME
              */
             orderNumberPrefix?: string;
-            /**
-             * @description Whether this tenant is a sandbox environment
-             * @default false
-             * @example false
-             */
-            isSandbox?: boolean;
-            /**
-             * @description Platform fee collection path. SELF_SERVICE_CARD for public signup; ENTERPRISE_INVOICE for hand-onboarded orgs.
-             * @example SELF_SERVICE_CARD
-             * @enum {string}
-             */
-            billingType?: 'SELF_SERVICE_CARD' | 'ENTERPRISE_INVOICE';
-            /**
-             * @description UUID of the sandbox tenant (for production tenants)
-             * @example 550e8400-e29b-41d4-a716-446655440000
-             */
-            sandboxTenantId?: string;
-            /**
-             * @description UUID of the production tenant (for sandbox tenants)
-             * @example 550e8400-e29b-41d4-a716-446655440000
-             */
-            productionTenantId?: string;
             /**
              * @description CMS type (strapi, contentful, sanity, etc.)
              * @example strapi
@@ -16400,6 +16573,27 @@ export interface components {
              * @example Suspended after repeated charge failures
              */
             notes?: string;
+            /**
+             * @description Why the tenant is suspended. non_payment is lifted automatically when the unpaid platform invoice is paid.
+             * @default manual
+             * @enum {string}
+             */
+            cause?: 'manual' | 'non_payment';
+        };
+        SetTenantBillingTypeDto: {
+            /**
+             * @description Platform fee collection path. SELF_SERVICE_CARD charges the vaulted card; ENTERPRISE_INVOICE is invoiced manually.
+             * @example ENTERPRISE_INVOICE
+             * @enum {string}
+             */
+            billingType: 'SELF_SERVICE_CARD' | 'ENTERPRISE_INVOICE';
+        };
+        SetTenantSandboxDto: {
+            /**
+             * @description Whether the tenant is a sandbox. Sandbox tenants skip billing usage and cannot use live payment credentials.
+             * @example false
+             */
+            isSandbox: boolean;
         };
         ActivateTenantDto: {
             /**
@@ -16449,6 +16643,12 @@ export interface components {
              * @example en-US
              */
             defaultLocale?: string;
+            /**
+             * @description Platform fee collection path. Defaults to ENTERPRISE_INVOICE when omitted.
+             * @example ENTERPRISE_INVOICE
+             * @enum {string}
+             */
+            billingType?: 'SELF_SERVICE_CARD' | 'ENTERPRISE_INVOICE';
             /**
              * @description Store name
              * @example Acme Store
@@ -31236,7 +31436,7 @@ export interface components {
              */
             gmvCents: string;
             /**
-             * @description Platform fee (2% of gmvCents) in cents as string
+             * @description Estimated GMV fee in cents (the rate card's GMV line; a store's share by GMV); negative is a credit
              * @example 3000
              */
             feeCents: string;
@@ -31265,8 +31465,8 @@ export interface components {
             /** @example 2026-07 */
             period: string;
             /**
-             * @description Platform fee rate as a fraction (0.02 = 2%)
-             * @example 0.02
+             * @description Effective GMV rate of the estimate as a fraction (0.0085 = 0.85%)
+             * @example 0.0085
              */
             rate: number;
             currencies: components['schemas']['BillingUsageCurrencyTotalDto'][];
@@ -31288,6 +31488,52 @@ export interface components {
             /** @example -2000 */
             adjustmentGmvCents: string;
         };
+        TierBreakdownResponseDto: {
+            /**
+             * @description Bracket or tier lower bound (GMV brackets are on trailing-12-period net GMV, in cents)
+             * @example 0
+             */
+            fromQuantity: string;
+            /** @example 200000000 */
+            toQuantity: string | null;
+            /**
+             * @description Part of the period quantity in this bracket (signed for GMV)
+             * @example 1250000
+             */
+            quantity: string;
+            /**
+             * @description GMV brackets: rate in basis points
+             * @example 100
+             */
+            basisPoints: number | null;
+            /** @description Usage tiers: cents per unitSize */
+            unitPriceCents: string | null;
+            /** @example 12500 */
+            amountCents: string;
+        };
+        PlatformInvoiceLineResponseDto: {
+            /** @enum {string} */
+            type: 'gmv_graduated' | 'usage_graduated' | 'recurring_flat' | 'minimum' | 'one_off';
+            /** @example Platform fee on net GMV */
+            description: string;
+            /** @description gmv, ai_input_tokens, ai_output_tokens; null otherwise */
+            metric: string | null;
+            /**
+             * @description Quantity rated (signed for GMV)
+             * @example 1250000
+             */
+            quantity: string;
+            /** @enum {string} */
+            unit: 'cents' | 'tokens' | 'period' | 'each';
+            /**
+             * @description Signed amount in cents
+             * @example 12500
+             */
+            amountCents: string;
+            tierBreakdown: components['schemas']['TierBreakdownResponseDto'][] | null;
+            rateCardLineId: string | null;
+            billingChargeId: string | null;
+        };
         PlatformInvoiceResponseDto: {
             id: string;
             /** @example 2026-07 */
@@ -31295,10 +31541,12 @@ export interface components {
             /** @example USD */
             currency: string;
             /**
-             * @description Fee rate snapshot at finalize (0.02 = 2%)
-             * @example 0.02
+             * @description Effective GMV rate: the GMV line over net GMV (0.0085 = 0.85%). Invoices finalized before rate cards hold the flat 0.02.
+             * @example 0.0085
              */
             rate: number;
+            /** @description Rate card version that rated the invoice; null before rate cards */
+            rateCardId: string | null;
             /**
              * @description Net billable GMV cents as string
              * @example 150000
@@ -31309,7 +31557,7 @@ export interface components {
             /** @example -10000 */
             adjustmentGmvCents: string;
             /**
-             * @description Raw platform fee cents (half-up 2% of max(gmv,0) at invoice total)
+             * @description Platform fee cents: the sum of the lines, floored at 0 (a negative sum is creditGeneratedCents)
              * @example 3000
              */
             feeCents: string;
@@ -31345,6 +31593,8 @@ export interface components {
             collectionUpdatedAt?: string | null;
             finalizedAt: string;
             storeBreakdown?: components['schemas']['PlatformInvoiceStoreBreakdownDto'][];
+            /** @description Rated lines with tier breakdown (detail only; empty before rate cards) */
+            lines?: components['schemas']['PlatformInvoiceLineResponseDto'][];
         };
         PlatformInvoiceListResponseDto: {
             invoices: components['schemas']['PlatformInvoiceResponseDto'][];
@@ -31383,6 +31633,225 @@ export interface components {
             /** Format: date-time */
             createdAt: string;
         };
+        GmvTierResponseDto: {
+            /** @example 200000000 */
+            upToCents: string | null;
+            /** @example 100 */
+            basisPoints: number;
+        };
+        UsageTierResponseDto: {
+            /** @example 10000000 */
+            upToQuantity: string | null;
+            /** @example 300 */
+            unitPriceCents: string;
+        };
+        RateCardLineResponseDto: {
+            id: string;
+            /** @enum {string} */
+            type: 'gmv_graduated' | 'usage_graduated' | 'recurring_flat' | 'minimum';
+            description: string;
+            metric: string | null;
+            unitSize: string | null;
+            includedQuantity: string | null;
+            gmvTiers: components['schemas']['GmvTierResponseDto'][] | null;
+            usageTiers: components['schemas']['UsageTierResponseDto'][] | null;
+            amountCents: string | null;
+            startPeriod: string | null;
+            endPeriod: string | null;
+        };
+        RateCardResponseDto: {
+            id: string;
+            tenantId: string | null;
+            /** @description True for a platform default version */
+            isPlatformDefault: boolean;
+            /** @example USD */
+            currency: string;
+            /** @example 1 */
+            version: number;
+            /** @example 2026-11 */
+            effectiveFromPeriod: string;
+            name: string;
+            createdAt: string;
+            lines: components['schemas']['RateCardLineResponseDto'][];
+        };
+        PlatformFeeCurrencyEstimateDto: {
+            /** @example USD */
+            currency: string;
+            rateCardId: string;
+            /** @example 1 */
+            rateCardVersion: number;
+            rateCardName: string;
+            isPlatformDefault: boolean;
+            /** @description Period net GMV so far, in cents */
+            gmvCents: string;
+            /** @description Net GMV of the previous 11 periods: where this period starts on the bracket ladder */
+            priorGmvCents: string;
+            /** @description Signed sum of the lines before credits; a negative sum becomes credit */
+            totalCents: string;
+            lines: components['schemas']['PlatformInvoiceLineResponseDto'][];
+        };
+        PlatformFeeEstimateResponseDto: {
+            /** @example 2026-11 */
+            period: string;
+            /** @description One estimate per currency still open for the period. Provisional: usage can still change; finalized periods are on the invoices. */
+            currencies: components['schemas']['PlatformFeeCurrencyEstimateDto'][];
+        };
+        MeteredUsageMetricDto: {
+            /** @enum {string} */
+            metric: 'ai_input_tokens' | 'ai_output_tokens';
+            /** @example 1250000 */
+            quantity: string;
+            /** @description Whether the tenant's rate card (default currency) charges for this metric; false = shown as not charged */
+            billed: boolean;
+        };
+        MeteredUsageResponseDto: {
+            /** @example 2026-11 */
+            period: string;
+            metrics: components['schemas']['MeteredUsageMetricDto'][];
+        };
+        AdminRateCardResponseDto: {
+            id: string;
+            tenantId: string | null;
+            /** @description True for a platform default version */
+            isPlatformDefault: boolean;
+            /** @example USD */
+            currency: string;
+            /** @example 1 */
+            version: number;
+            /** @example 2026-11 */
+            effectiveFromPeriod: string;
+            name: string;
+            createdAt: string;
+            lines: components['schemas']['RateCardLineResponseDto'][];
+            /** @description Finalized invoices rated by this version (0 = deletable) */
+            invoiceCount: number;
+        };
+        AdminRateCardListResponseDto: {
+            rateCards: components['schemas']['AdminRateCardResponseDto'][];
+        };
+        GmvTierInputDto: {
+            /**
+             * @description Upper bound of the bracket on trailing-12-period net GMV, in cents. Null on the last (open) bracket.
+             * @example 200000000
+             */
+            upToCents: number | null;
+            /**
+             * @description Rate in basis points (100 = 1%)
+             * @example 100
+             */
+            basisPoints: number;
+        };
+        UsageTierInputDto: {
+            /**
+             * @description Upper bound of the tier on the period quantity (included quantity counts). Null on the last (open) tier.
+             * @example 10000000
+             */
+            upToQuantity: number | null;
+            /**
+             * @description Price in cents per unitSize of quantity in this tier
+             * @example 300
+             */
+            unitPriceCents: number;
+        };
+        RateCardLineInputDto: {
+            /** @enum {string} */
+            type: 'gmv_graduated' | 'usage_graduated' | 'recurring_flat' | 'minimum';
+            /** @example Platform fee on net GMV */
+            description: string;
+            /**
+             * @description usage_graduated: metered metric
+             * @enum {string}
+             */
+            metric?: 'ai_input_tokens' | 'ai_output_tokens';
+            /**
+             * @description usage_graduated: quantity one unitPriceCents buys
+             * @example 1000000
+             */
+            unitSize?: number;
+            /**
+             * @description usage_graduated: quantity free each period
+             * @example 0
+             */
+            includedQuantity?: number;
+            /** @description gmv_graduated: brackets, lowest first; last is open */
+            gmvTiers?: components['schemas']['GmvTierInputDto'][];
+            /** @description usage_graduated: tiers, lowest first; last is open */
+            usageTiers?: components['schemas']['UsageTierInputDto'][];
+            /**
+             * @description recurring_flat: amount per period; minimum: floor on the card lines, in cents
+             * @example 50000
+             */
+            amountCents?: number;
+            /**
+             * @description recurring_flat: first period billed (YYYY-MM)
+             * @example 2026-11
+             */
+            startPeriod?: string;
+            /**
+             * @description recurring_flat: last period billed (YYYY-MM); omit for open
+             * @example 2027-10
+             */
+            endPeriod?: string;
+        };
+        CreateRateCardVersionDto: {
+            /** @description Tenant the version belongs to. Omit for a new platform default version. */
+            tenantId?: string;
+            /** @example USD */
+            currency: string;
+            /**
+             * @description First UTC period this version rates; the current period or later
+             * @example 2026-11
+             */
+            effectiveFromPeriod: string;
+            /** @example SoClean negotiated terms 2026 */
+            name: string;
+            lines: components['schemas']['RateCardLineInputDto'][];
+        };
+        BillingChargeResponseDto: {
+            id: string;
+            tenantId: string;
+            /** @example 2026-11 */
+            period: string;
+            /** @example USD */
+            currency: string;
+            /** @enum {string} */
+            category: 'consulting' | 'addon' | 'service' | 'credit';
+            description: string;
+            quantity: number;
+            /** @example 15000 */
+            unitPriceCents: string;
+            /** @example 120000 */
+            amountCents: string;
+            reference: string | null;
+            createdBy: string;
+            createdAt: string;
+        };
+        BillingChargeListResponseDto: {
+            charges: components['schemas']['BillingChargeResponseDto'][];
+        };
+        CreateBillingChargeDto: {
+            tenantId: string;
+            /**
+             * @description Open UTC period YYYY-MM: the current period or later
+             * @example 2026-11
+             */
+            period: string;
+            /** @example USD */
+            currency: string;
+            /** @enum {string} */
+            category: 'consulting' | 'addon' | 'service' | 'credit';
+            /** @example Catalog migration consulting (8h) */
+            description: string;
+            /** @example 8 */
+            quantity: number;
+            /**
+             * @description Cents per unit; negative for a credit, positive otherwise
+             * @example 15000
+             */
+            unitPriceCents: number;
+            /** @description Contract, ticket or PO reference */
+            reference?: string;
+        };
         ReturnItemDto: {
             /**
              * @description Order item ID to return
@@ -40254,6 +40723,88 @@ export interface operations {
             };
         };
     };
+    TenantsController_setBillingType: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Tenant ID (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['SetTenantBillingTypeDto'];
+            };
+        };
+        responses: {
+            /** @description Billing type set */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['TenantDto'];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Tenant not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    TenantsController_setSandbox: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Tenant ID (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['SetTenantSandboxDto'];
+            };
+        };
+        responses: {
+            /** @description Sandbox flag set */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['TenantDto'];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Tenant not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     TenantsController_activate: {
         parameters: {
             query?: never;
@@ -55017,6 +55568,392 @@ export interface operations {
             };
         };
     };
+    PlatformBillingRatesController_getRateCard: {
+        parameters: {
+            query?: {
+                currency?: string;
+                /** @description UTC period YYYY-MM (defaults to the current UTC month) */
+                period?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RateCardResponseDto'];
+                };
+            };
+            /** @description Missing platform-billing:read */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No card for the currency */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    PlatformBillingRatesController_getEstimate: {
+        parameters: {
+            query?: {
+                /** @description UTC period YYYY-MM (defaults to the current UTC month) */
+                period?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['PlatformFeeEstimateResponseDto'];
+                };
+            };
+            /** @description Invalid period key */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing platform-billing:read */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    PlatformBillingRatesController_getMeteredUsage: {
+        parameters: {
+            query?: {
+                /** @description UTC period YYYY-MM (defaults to the current UTC month) */
+                period?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['MeteredUsageResponseDto'];
+                };
+            };
+            /** @description Invalid period key */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing platform-billing:read */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    RateCardsAdminController_list: {
+        parameters: {
+            query?: {
+                /** @description Tenant whose versions to list. Omit for the platform default's versions. */
+                tenantId?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['AdminRateCardListResponseDto'];
+                };
+            };
+            /** @description System admin required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    RateCardsAdminController_create: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['CreateRateCardVersionDto'];
+            };
+        };
+        responses: {
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['AdminRateCardResponseDto'];
+                };
+            };
+            /** @description Invalid lines or period */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description System admin required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Tenant not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description A version already starts in that period, or an invoice from it on is finalized */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    RateCardsAdminController_getOne: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['AdminRateCardResponseDto'];
+                };
+            };
+            /** @description System admin required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    RateCardsAdminController_remove: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Deleted */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description System admin required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Version in use */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    BillingChargesAdminController_list: {
+        parameters: {
+            query: {
+                tenantId: string;
+                period?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['BillingChargeListResponseDto'];
+                };
+            };
+            /** @description System admin required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    BillingChargesAdminController_create: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['CreateBillingChargeDto'];
+            };
+        };
+        responses: {
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['BillingChargeResponseDto'];
+                };
+            };
+            /** @description Invalid amount or period */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description System admin required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Tenant not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Period already finalized */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    BillingChargesAdminController_remove: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Removed */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description System admin required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Period already finalized */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     ReturnsController_listReturns: {
         parameters: {
             query?: {