@flexprice/mcp-server 2.0.15 → 2.0.20

package/src/models/coupon.ts

@@ -0,0 +1,56 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { CouponCadence, CouponCadence$zodSchema } from "./couponcadence.js";
+import { CouponType, CouponType$zodSchema } from "./coupontype.js";
+import { Status, Status$zodSchema } from "./status.js";
+
+export type Coupon = {
+  amount_off?: string | undefined;
+  cadence?: CouponCadence | undefined;
+  created_at?: string | undefined;
+  created_by?: string | undefined;
+  currency?: string | undefined;
+  duration_in_periods?: number | undefined;
+  environment_id?: string | undefined;
+  id?: string | undefined;
+  max_redemptions?: number | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  name?: string | undefined;
+  percentage_off?: string | undefined;
+  redeem_after?: string | undefined;
+  redeem_before?: string | undefined;
+  rules?: { [k: string]: any } | undefined;
+  status?: Status | undefined;
+  tenant_id?: string | undefined;
+  total_redemptions?: number | undefined;
+  type?: CouponType | undefined;
+  updated_at?: string | undefined;
+  updated_by?: string | undefined;
+};
+
+export const Coupon$zodSchema: z.ZodType<Coupon> = z.object({
+  amount_off: z.string().optional(),
+  cadence: CouponCadence$zodSchema.optional(),
+  created_at: z.iso.datetime({ offset: true }).optional(),
+  created_by: z.string().optional(),
+  currency: z.string().optional(),
+  duration_in_periods: z.int().optional(),
+  environment_id: z.string().optional(),
+  id: z.string().optional(),
+  max_redemptions: z.int().optional(),
+  metadata: z.record(z.string(), z.string()).optional(),
+  name: z.string().optional(),
+  percentage_off: z.string().optional(),
+  redeem_after: z.string().optional(),
+  redeem_before: z.string().optional(),
+  rules: z.record(z.string(), z.any()).optional(),
+  status: Status$zodSchema.optional(),
+  tenant_id: z.string().optional(),
+  total_redemptions: z.int().optional(),
+  type: CouponType$zodSchema.optional(),
+  updated_at: z.iso.datetime({ offset: true }).optional(),
+  updated_by: z.string().optional(),
+});

package/src/models/couponapplicationresponse.ts

@@ -0,0 +1,59 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { CouponType, CouponType$zodSchema } from "./coupontype.js";
+import { Status, Status$zodSchema } from "./status.js";
+
+export type CouponApplicationResponse = {
+  applied_at?: string | undefined;
+  coupon_association_id?: string | undefined;
+  coupon_id?: string | undefined;
+  coupon_snapshot?: { [k: string]: any } | undefined;
+  created_at?: string | undefined;
+  created_by?: string | undefined;
+  currency?: string | undefined;
+  discount_percentage?: string | undefined;
+  discount_type?: CouponType | undefined;
+  discounted_amount?: string | undefined;
+  environment_id?: string | undefined;
+  final_price?: string | undefined;
+  id?: string | undefined;
+  invoice_id?: string | undefined;
+  invoice_line_item_id?: string | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  original_price?: string | undefined;
+  status?: Status | undefined;
+  subscription_id?: string | undefined;
+  tenant_id?: string | undefined;
+  updated_at?: string | undefined;
+  updated_by?: string | undefined;
+};
+
+export const CouponApplicationResponse$zodSchema: z.ZodType<
+  CouponApplicationResponse
+> = z.object({
+  applied_at: z.iso.datetime({ offset: true }).optional(),
+  coupon_association_id: z.string().optional(),
+  coupon_id: z.string().optional(),
+  coupon_snapshot: z.record(z.string(), z.any()).optional(),
+  created_at: z.iso.datetime({ offset: true }).optional(),
+  created_by: z.string().optional(),
+  currency: z.string().optional(),
+  discount_percentage: z.string().optional(),
+  discount_type: CouponType$zodSchema.optional(),
+  discounted_amount: z.string().optional(),
+  environment_id: z.string().optional(),
+  final_price: z.string().optional(),
+  id: z.string().optional(),
+  invoice_id: z.string().optional(),
+  invoice_line_item_id: z.string().optional(),
+  metadata: z.record(z.string(), z.string()).optional(),
+  original_price: z.string().optional(),
+  status: Status$zodSchema.optional(),
+  subscription_id: z.string().optional(),
+  tenant_id: z.string().optional(),
+  updated_at: z.iso.datetime({ offset: true }).optional(),
+  updated_by: z.string().optional(),
+});

package/src/models/couponassociationresponse.ts

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { Coupon, Coupon$zodSchema } from "./coupon.js";
+import { Status, Status$zodSchema } from "./status.js";
+
+export type CouponAssociationResponse = {
+  coupon?: Coupon | undefined;
+  coupon_id?: string | undefined;
+  created_at?: string | undefined;
+  created_by?: string | undefined;
+  end_date?: string | undefined;
+  environment_id?: string | undefined;
+  id?: string | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  start_date?: string | undefined;
+  status?: Status | undefined;
+  subscription_id?: string | undefined;
+  subscription_line_item_id?: string | undefined;
+  subscription_phase_id?: string | undefined;
+  tenant_id?: string | undefined;
+  updated_at?: string | undefined;
+  updated_by?: string | undefined;
+};
+
+export const CouponAssociationResponse$zodSchema: z.ZodType<
+  CouponAssociationResponse
+> = z.object({
+  coupon: Coupon$zodSchema.optional(),
+  coupon_id: z.string().optional(),
+  created_at: z.iso.datetime({ offset: true }).optional(),
+  created_by: z.string().optional(),
+  end_date: z.iso.datetime({ offset: true }).optional().describe("Optional"),
+  environment_id: z.string().optional(),
+  id: z.string().optional(),
+  metadata: z.record(z.string(), z.string()).optional(),
+  start_date: z.iso.datetime({ offset: true }).optional(),
+  status: Status$zodSchema.optional(),
+  subscription_id: z.string().optional().describe("Mandatory"),
+  subscription_line_item_id: z.string().optional().describe("Optional"),
+  subscription_phase_id: z.string().optional().describe("Optional"),
+  tenant_id: z.string().optional(),
+  updated_at: z.iso.datetime({ offset: true }).optional(),
+  updated_by: z.string().optional(),
+});

package/src/models/createbulkpricerequest.ts

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  CreatePriceRequest,
+  CreatePriceRequest$zodSchema,
+} from "./createpricerequest.js";
+
+export type CreateBulkPriceRequest = { items: Array<CreatePriceRequest> };
+
+export const CreateBulkPriceRequest$zodSchema: z.ZodType<
+  CreateBulkPriceRequest
+> = z.object({
+  items: z.array(CreatePriceRequest$zodSchema),
+});

package/src/models/createbulkpriceresponse.ts

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { PriceResponse, PriceResponse$zodSchema } from "./priceresponse.js";
+
+export type CreateBulkPriceResponse = {
+  items?: Array<PriceResponse> | undefined;
+};
+
+export const CreateBulkPriceResponse$zodSchema: z.ZodType<
+  CreateBulkPriceResponse
+> = z.object({
+  items: z.array(PriceResponse$zodSchema).optional(),
+});

package/src/models/createcreditgrantrequest.ts

@@ -0,0 +1,71 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  CreditGrantCadence,
+  CreditGrantCadence$zodSchema,
+} from "./creditgrantcadence.js";
+import {
+  CreditGrantExpiryDurationUnit,
+  CreditGrantExpiryDurationUnit$zodSchema,
+} from "./creditgrantexpirydurationunit.js";
+import {
+  CreditGrantExpiryType,
+  CreditGrantExpiryType$zodSchema,
+} from "./creditgrantexpirytype.js";
+import {
+  CreditGrantPeriod,
+  CreditGrantPeriod$zodSchema,
+} from "./creditgrantperiod.js";
+import {
+  CreditGrantScope,
+  CreditGrantScope$zodSchema,
+} from "./creditgrantscope.js";
+
+export type CreateCreditGrantRequest = {
+  cadence: CreditGrantCadence;
+  conversion_rate?: string | undefined;
+  credits: string;
+  end_date?: string | undefined;
+  expiration_duration?: number | undefined;
+  expiration_duration_unit?: CreditGrantExpiryDurationUnit | undefined;
+  expiration_type?: CreditGrantExpiryType | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  name: string;
+  period?: CreditGrantPeriod | undefined;
+  period_count?: number | undefined;
+  plan_id?: string | undefined;
+  priority?: number | undefined;
+  scope: CreditGrantScope;
+  start_date?: string | undefined;
+  subscription_id?: string | undefined;
+  topup_conversion_rate?: string | undefined;
+};
+
+export const CreateCreditGrantRequest$zodSchema: z.ZodType<
+  CreateCreditGrantRequest
+> = z.object({
+  cadence: CreditGrantCadence$zodSchema,
+  conversion_rate: z.string().optional().describe(
+    "amount in the currency =  number of credits * conversion_rate\nex if conversion_rate is 1, then 1 USD = 1 credit\nex if conversion_rate is 2, then 1 USD = 0.5 credits\nex if conversion_rate is 0.5, then 1 USD = 2 credits",
+  ),
+  credits: z.string(),
+  end_date: z.iso.datetime({ offset: true }).optional(),
+  expiration_duration: z.int().optional(),
+  expiration_duration_unit: CreditGrantExpiryDurationUnit$zodSchema.optional(),
+  expiration_type: CreditGrantExpiryType$zodSchema.optional(),
+  metadata: z.record(z.string(), z.string()).optional(),
+  name: z.string(),
+  period: CreditGrantPeriod$zodSchema.optional(),
+  period_count: z.int().optional(),
+  plan_id: z.string().optional(),
+  priority: z.int().optional(),
+  scope: CreditGrantScope$zodSchema,
+  start_date: z.iso.datetime({ offset: true }).optional(),
+  subscription_id: z.string().optional(),
+  topup_conversion_rate: z.string().optional().describe(
+    "topup_conversion_rate is the conversion rate for the topup to the currency\nex if topup_conversion_rate is 1, then 1 USD = 1 credit\nex if topup_conversion_rate is 2, then 1 USD = 0.5 credits\nex if topup_conversion_rate is 0.5, then 1 USD = 2 credits",
+  ),
+});

package/src/models/createcustomerop.ts

@@ -4,19 +4,16 @@
 
 import * as z from "zod";
 import {
-  DtoCustomerResponse,
-  DtoCustomerResponse$zodSchema,
-} from "./dtocustomerresponse.js";
-import {
-  ErrorsErrorResponse,
-  ErrorsErrorResponse$zodSchema,
-} from "./errorserrorresponse.js";
+  CustomerResponse,
+  CustomerResponse$zodSchema,
+} from "./customerresponse.js";
+import { ErrorResponse, ErrorResponse$zodSchema } from "./errorresponse.js";
 
-export type CreateCustomerResponse = DtoCustomerResponse | ErrorsErrorResponse;
+export type CreateCustomerResponse = CustomerResponse | ErrorResponse;
 
 export const CreateCustomerResponse$zodSchema: z.ZodType<
   CreateCustomerResponse
 > = z.union([
-  DtoCustomerResponse$zodSchema,
-  ErrorsErrorResponse$zodSchema,
+  CustomerResponse$zodSchema,
+  ErrorResponse$zodSchema,
 ]);

package/src/models/createcustomerrequest.ts

@@ -0,0 +1,79 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  CreateEntityIntegrationMappingRequest,
+  CreateEntityIntegrationMappingRequest$zodSchema,
+} from "./createentityintegrationmappingrequest.js";
+import {
+  TaxRateOverride,
+  TaxRateOverride$zodSchema,
+} from "./taxrateoverride.js";
+
+/**
+ * Request object for creating a new customer in the system
+ */
+export type CreateCustomerRequest = {
+  address_city?: string | undefined;
+  address_country?: string | undefined;
+  address_line1?: string | undefined;
+  address_line2?: string | undefined;
+  address_postal_code?: string | undefined;
+  address_state?: string | undefined;
+  email?: string | undefined;
+  external_id: string;
+  integration_entity_mapping?:
+    | Array<CreateEntityIntegrationMappingRequest>
+    | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  name?: string | undefined;
+  skip_onboarding_workflow?: boolean | undefined;
+  tax_rate_overrides?: Array<TaxRateOverride> | undefined;
+};
+
+export const CreateCustomerRequest$zodSchema: z.ZodType<CreateCustomerRequest> =
+  z.object({
+    address_city: z.string().optional().describe(
+      "address_city is the city name with maximum 100 characters",
+    ),
+    address_country: z.string().optional().describe(
+      "address_country is the two-letter ISO 3166-1 alpha-2 country code",
+    ),
+    address_line1: z.string().optional().describe(
+      "address_line1 is the primary address line with maximum 255 characters",
+    ),
+    address_line2: z.string().optional().describe(
+      "address_line2 is the secondary address line with maximum 255 characters",
+    ),
+    address_postal_code: z.string().optional().describe(
+      "address_postal_code is the ZIP code or postal code with maximum 20 characters",
+    ),
+    address_state: z.string().optional().describe(
+      "address_state is the state, province, or region name with maximum 100 characters",
+    ),
+    email: z.string().optional().describe(
+      "email is the customer's email address and must be a valid email format if provided",
+    ),
+    external_id: z.string().describe(
+      "external_id is the unique identifier from your system to reference this customer (required)",
+    ),
+    integration_entity_mapping: z.array(
+      CreateEntityIntegrationMappingRequest$zodSchema,
+    ).optional().describe(
+      "integration_entity_mapping contains provider integration mappings for this customer",
+    ),
+    metadata: z.record(z.string(), z.string()).optional().describe(
+      "metadata contains additional key-value pairs for storing extra information",
+    ),
+    name: z.string().optional().describe(
+      "name is the full name or company name of the customer",
+    ),
+    skip_onboarding_workflow: z.boolean().optional().describe(
+      "skip_onboarding_workflow when true, prevents the customer onboarding workflow from being triggered\nThis is used internally when a customer is created via a workflow to prevent infinite loops\nDefault: false",
+    ),
+    tax_rate_overrides: z.array(TaxRateOverride$zodSchema).optional().describe(
+      "tax_rate_overrides contains tax rate configurations to be linked to this customer",
+    ),
+  }).describe("Request object for creating a new customer in the system");

package/src/models/createentityintegrationmappingrequest.ts

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  IntegrationEntityType,
+  IntegrationEntityType$zodSchema,
+} from "./integrationentitytype.js";
+
+export type CreateEntityIntegrationMappingRequest = {
+  entity_id: string;
+  entity_type: IntegrationEntityType;
+  metadata?: { [k: string]: any } | undefined;
+  provider_entity_id: string;
+  provider_type: string;
+};
+
+export const CreateEntityIntegrationMappingRequest$zodSchema: z.ZodType<
+  CreateEntityIntegrationMappingRequest
+> = z.object({
+  entity_id: z.string(),
+  entity_type: IntegrationEntityType$zodSchema,
+  metadata: z.record(z.string(), z.any()).optional(),
+  provider_entity_id: z.string(),
+  provider_type: z.string(),
+});

package/src/models/createinvoicelineitemrequest.ts

@@ -0,0 +1,90 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { CommitmentInfo, CommitmentInfo$zodSchema } from "./commitmentinfo.js";
+
+export type CreateInvoiceLineItemRequest = {
+  amount: string;
+  commitment_info?: CommitmentInfo | undefined;
+  display_name?: string | undefined;
+  entity_id?: string | undefined;
+  entity_type?: string | undefined;
+  invoice_level_discount?: string | undefined;
+  line_item_discount?: string | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  meter_display_name?: string | undefined;
+  meter_id?: string | undefined;
+  period_end?: string | undefined;
+  period_start?: string | undefined;
+  plan_display_name?: string | undefined;
+  plan_id?: string | undefined;
+  prepaid_credits_applied?: string | undefined;
+  price_id?: string | undefined;
+  price_type?: string | undefined;
+  price_unit?: string | undefined;
+  price_unit_amount?: string | undefined;
+  quantity: string;
+};
+
+export const CreateInvoiceLineItemRequest$zodSchema: z.ZodType<
+  CreateInvoiceLineItemRequest
+> = z.object({
+  amount: z.string().describe(
+    "amount is the monetary amount for this line item",
+  ),
+  commitment_info: CommitmentInfo$zodSchema.optional(),
+  display_name: z.string().optional().describe(
+    "display_name is the optional human-readable name for this line item",
+  ),
+  entity_id: z.string().optional().describe(
+    "entity_id is the optional unique identifier of the entity associated with this line item",
+  ),
+  entity_type: z.string().optional().describe(
+    "entity_type is the optional type of the entity associated with this line item",
+  ),
+  invoice_level_discount: z.string().optional().describe(
+    "invoice_level_discount is the discount amount in invoice currency applied to all line items on the invoice.",
+  ),
+  line_item_discount: z.string().optional().describe(
+    "line_item_discount is the discount amount in invoice currency applied directly to this line item.",
+  ),
+  metadata: z.record(z.string(), z.string()).optional(),
+  meter_display_name: z.string().optional().describe(
+    "meter_display_name is the optional human-readable name of the meter",
+  ),
+  meter_id: z.string().optional().describe(
+    "meter_id is the optional unique identifier of the meter used for usage tracking",
+  ),
+  period_end: z.iso.datetime({ offset: true }).optional().describe(
+    "period_end is the optional end date of the period this line item covers",
+  ),
+  period_start: z.iso.datetime({ offset: true }).optional().describe(
+    "period_start is the optional start date of the period this line item covers",
+  ),
+  plan_display_name: z.string().optional().describe(
+    "plan_display_name is the optional human-readable name of the plan",
+  ),
+  plan_id: z.string().optional().describe(
+    "TODO: !REMOVE after migration\nplan_id is the optional unique identifier of the plan associated with this line item",
+  ),
+  prepaid_credits_applied: z.string().optional().describe(
+    "prepaid_credits_applied is the amount in invoice currency reduced from this line item due to prepaid credits application.",
+  ),
+  price_id: z.string().optional().describe(
+    "price_id is the optional unique identifier of the price associated with this line item",
+  ),
+  price_type: z.string().optional().describe(
+    "price_type indicates the type of pricing (fixed, usage, tiered, etc.)",
+  ),
+  price_unit: z.string().optional().describe(
+    "price_unit is the optional 3-digit ISO code of the price unit associated with this line item",
+  ),
+  price_unit_amount: z.string().optional().describe(
+    "price_unit_amount is the optional amount converted to the price unit currency",
+  ),
+  quantity: z.string().describe(
+    "quantity is the quantity of units for this line item",
+  ),
+});

package/src/models/createinvoiceop.ts

@@ -3,19 +3,16 @@
  */
 
 import * as z from "zod";
+import { ErrorResponse, ErrorResponse$zodSchema } from "./errorresponse.js";
 import {
-  DtoInvoiceResponse,
-  DtoInvoiceResponse$zodSchema,
-} from "./dtoinvoiceresponse.js";
-import {
-  ErrorsErrorResponse,
-  ErrorsErrorResponse$zodSchema,
-} from "./errorserrorresponse.js";
+  InvoiceResponse,
+  InvoiceResponse$zodSchema,
+} from "./invoiceresponse.js";
 
-export type CreateInvoiceResponse = DtoInvoiceResponse | ErrorsErrorResponse;
+export type CreateInvoiceResponse = InvoiceResponse | ErrorResponse;
 
 export const CreateInvoiceResponse$zodSchema: z.ZodType<CreateInvoiceResponse> =
   z.union([
-    DtoInvoiceResponse$zodSchema,
-    ErrorsErrorResponse$zodSchema,
+    InvoiceResponse$zodSchema,
+    ErrorResponse$zodSchema,
   ]);

package/src/models/createinvoicerequest.ts

@@ -0,0 +1,134 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  CreateInvoiceLineItemRequest,
+  CreateInvoiceLineItemRequest$zodSchema,
+} from "./createinvoicelineitemrequest.js";
+import {
+  InvoiceBillingReason,
+  InvoiceBillingReason$zodSchema,
+} from "./invoicebillingreason.js";
+import { InvoiceCoupon, InvoiceCoupon$zodSchema } from "./invoicecoupon.js";
+import {
+  InvoiceLineItemCoupon,
+  InvoiceLineItemCoupon$zodSchema,
+} from "./invoicelineitemcoupon.js";
+import { InvoiceStatus, InvoiceStatus$zodSchema } from "./invoicestatus.js";
+import { InvoiceType, InvoiceType$zodSchema } from "./invoicetype.js";
+import { PaymentStatus, PaymentStatus$zodSchema } from "./paymentstatus.js";
+import {
+  TaxRateOverride,
+  TaxRateOverride$zodSchema,
+} from "./taxrateoverride.js";
+import {
+  TaxRateResponse,
+  TaxRateResponse$zodSchema,
+} from "./taxrateresponse.js";
+
+export type CreateInvoiceRequest = {
+  amount_due: string;
+  amount_paid?: string | undefined;
+  billing_period?: string | undefined;
+  billing_reason?: InvoiceBillingReason | undefined;
+  coupons?: Array<string> | undefined;
+  currency: string;
+  customer_id: string;
+  description?: string | undefined;
+  due_date?: string | undefined;
+  idempotency_key?: string | undefined;
+  invoice_coupons?: Array<InvoiceCoupon> | undefined;
+  invoice_number?: string | undefined;
+  invoice_pdf_url?: string | undefined;
+  invoice_status?: InvoiceStatus | undefined;
+  invoice_type?: InvoiceType | undefined;
+  line_item_coupons?: Array<InvoiceLineItemCoupon> | undefined;
+  line_items?: Array<CreateInvoiceLineItemRequest> | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  payment_status?: PaymentStatus | undefined;
+  period_end?: string | undefined;
+  period_start?: string | undefined;
+  prepared_tax_rates?: Array<TaxRateResponse> | undefined;
+  subscription_id?: string | undefined;
+  subtotal: string;
+  tax_rate_overrides?: Array<TaxRateOverride> | undefined;
+  tax_rates?: Array<string> | undefined;
+  total: string;
+  total_prepaid_applied?: string | undefined;
+};
+
+export const CreateInvoiceRequest$zodSchema: z.ZodType<CreateInvoiceRequest> = z
+  .object({
+    amount_due: z.string().describe(
+      "amount_due is the total amount that needs to be paid for this invoice",
+    ),
+    amount_paid: z.string().optional().describe(
+      "amount_paid is the amount that has been paid towards this invoice",
+    ),
+    billing_period: z.string().optional().describe(
+      "billing_period is the period this invoice covers (e.g., \"monthly\", \"yearly\")",
+    ),
+    billing_reason: InvoiceBillingReason$zodSchema.optional(),
+    coupons: z.array(z.string()).optional().describe("coupons"),
+    currency: z.string().describe(
+      "currency is the three-letter ISO currency code (e.g., USD, EUR) for the invoice",
+    ),
+    customer_id: z.string().describe(
+      "customer_id is the unique identifier of the customer this invoice belongs to",
+    ),
+    description: z.string().optional().describe(
+      "description is an optional text description of the invoice",
+    ),
+    due_date: z.iso.datetime({ offset: true }).optional().describe(
+      "due_date is the date by which payment is expected",
+    ),
+    idempotency_key: z.string().optional().describe(
+      "idempotency_key is an optional key used to prevent duplicate invoice creation",
+    ),
+    invoice_coupons: z.array(InvoiceCoupon$zodSchema).optional().describe(
+      "Invoice Coupons",
+    ),
+    invoice_number: z.string().optional().describe(
+      "invoice_number is an optional human-readable identifier for the invoice",
+    ),
+    invoice_pdf_url: z.string().optional().describe(
+      "invoice_pdf_url is the URL where customers can download the PDF version of this invoice",
+    ),
+    invoice_status: InvoiceStatus$zodSchema.optional(),
+    invoice_type: InvoiceType$zodSchema.optional(),
+    line_item_coupons: z.array(InvoiceLineItemCoupon$zodSchema).optional()
+      .describe("Invoice Line Item Coupons"),
+    line_items: z.array(CreateInvoiceLineItemRequest$zodSchema).optional()
+      .describe(
+        "line_items contains the individual items that make up this invoice",
+      ),
+    metadata: z.record(z.string(), z.string()).optional(),
+    payment_status: PaymentStatus$zodSchema.optional(),
+    period_end: z.iso.datetime({ offset: true }).optional().describe(
+      "period_end is the end date of the billing period",
+    ),
+    period_start: z.iso.datetime({ offset: true }).optional().describe(
+      "period_start is the start date of the billing period",
+    ),
+    prepared_tax_rates: z.array(TaxRateResponse$zodSchema).optional().describe(
+      "prepared_tax_rates contains the tax rates pre-resolved by the caller (e.g., billing service)",
+    ),
+    subscription_id: z.string().optional().describe(
+      "subscription_id is the optional unique identifier of the subscription associated with this invoice",
+    ),
+    subtotal: z.string().describe(
+      "subtotal is the amount before taxes and discounts are applied",
+    ),
+    tax_rate_overrides: z.array(TaxRateOverride$zodSchema).optional().describe(
+      "tax_rate_overrides is the tax rate overrides to be applied to the invoice",
+    ),
+    tax_rates: z.array(z.string()).optional().describe("tax_rates"),
+    total: z.string().describe(
+      "total is the total amount of the invoice including taxes and discounts",
+    ),
+    total_prepaid_applied: z.string().optional().describe(
+      "total_prepaid_applied is the total amount of prepaid applied to this invoice.",
+    ),
+  });