@flexprice/sdk 2.1.26 → 2.1.33

package/src/sdk/models/invoice-filter.ts

@@ -76,6 +76,10 @@ export type InvoiceFilter = {
    */
   externalCustomerId?: string | undefined;
   filters?: Array<FilterCondition> | undefined;
+  /**
+   * finalized_at_gte filters invoices finalized at or after the given instant
+   */
+  finalizedAtGte?: Date | undefined;
   /**
    * invoice_ids restricts results to invoices with the specified IDs
    *
@@ -135,6 +139,10 @@ export type InvoiceFilter = {
    * Only returns invoices that were created as part of the specified subscription's billing
    */
   subscriptionId?: string | undefined;
+  /**
+   * voided_at_gte filters invoices voided at or after the given instant
+   */
+  voidedAtGte?: Date | undefined;
 };
 
 /** @internal */
@@ -153,6 +161,7 @@ export type InvoiceFilter$Outbound = {
   expand?: string | undefined;
   external_customer_id?: string | undefined;
   filters?: Array<FilterCondition$Outbound> | undefined;
+  finalized_at_gte?: string | undefined;
   invoice_ids?: Array<string> | undefined;
   invoice_status?: Array<string> | undefined;
   invoice_type?: string | undefined;
@@ -170,6 +179,7 @@ export type InvoiceFilter$Outbound = {
   status?: string | undefined;
   subscription_customer_id?: Array<string> | undefined;
   subscription_id?: string | undefined;
+  voided_at_gte?: string | undefined;
 };
 
 /** @internal */
@@ -187,6 +197,9 @@ export const InvoiceFilter$outboundSchema: z.ZodMiniType<
     expand: z.optional(z.string()),
     externalCustomerId: z.optional(z.string()),
     filters: z.optional(z.array(FilterCondition$outboundSchema)),
+    finalizedAtGte: z.optional(
+      z.pipe(z.date(), z.transform(v => v.toISOString())),
+    ),
     invoiceIds: z.optional(z.array(z.string())),
     invoiceStatus: z.optional(z.array(InvoiceStatus$outboundSchema)),
     invoiceType: z.optional(InvoiceType$outboundSchema),
@@ -204,6 +217,9 @@ export const InvoiceFilter$outboundSchema: z.ZodMiniType<
     status: z.optional(Status$outboundSchema),
     subscriptionCustomerId: z.optional(z.array(z.string())),
     subscriptionId: z.optional(z.string()),
+    voidedAtGte: z.optional(
+      z.pipe(z.date(), z.transform(v => v.toISOString())),
+    ),
   }),
   z.transform((v) => {
     return remap$(v, {
@@ -213,6 +229,7 @@ export const InvoiceFilter$outboundSchema: z.ZodMiniType<
       customerId: "customer_id",
       endTime: "end_time",
       externalCustomerId: "external_customer_id",
+      finalizedAtGte: "finalized_at_gte",
       invoiceIds: "invoice_ids",
       invoiceStatus: "invoice_status",
       invoiceType: "invoice_type",
@@ -225,6 +242,7 @@ export const InvoiceFilter$outboundSchema: z.ZodMiniType<
       startTime: "start_time",
       subscriptionCustomerId: "subscription_customer_id",
       subscriptionId: "subscription_id",
+      voidedAtGte: "voided_at_gte",
     });
   }),
 );

package/src/sdk/models/invoice-line-item-response.ts

@@ -11,6 +11,10 @@ import {
   CommitmentInfo,
   CommitmentInfo$inboundSchema,
 } from "./commitment-info.js";
+import {
+  CustomCurrencyLineItem,
+  CustomCurrencyLineItem$inboundSchema,
+} from "./custom-currency-line-item.js";
 import { SDKValidationError } from "./sdk-validation-error.js";
 import {
   SourceUsageItem,
@@ -35,6 +39,7 @@ export type InvoiceLineItemResponse = {
   createdAt?: Date | undefined;
   createdBy?: string | undefined;
   currency?: string | undefined;
+  customCurrency?: CustomCurrencyLineItem | undefined;
   customerId?: string | undefined;
   displayName?: string | undefined;
   entityId?: string | undefined;
@@ -104,6 +109,7 @@ export const InvoiceLineItemResponse$inboundSchema: z.ZodMiniType<
     created_at: types.optional(types.date()),
     created_by: types.optional(types.string()),
     currency: types.optional(types.string()),
+    custom_currency: types.optional(CustomCurrencyLineItem$inboundSchema),
     customer_id: types.optional(types.string()),
     display_name: types.optional(types.string()),
     entity_id: types.optional(types.string()),
@@ -142,6 +148,7 @@ export const InvoiceLineItemResponse$inboundSchema: z.ZodMiniType<
       "commitment_info": "commitmentInfo",
       "created_at": "createdAt",
       "created_by": "createdBy",
+      "custom_currency": "customCurrency",
       "customer_id": "customerId",
       "display_name": "displayName",
       "entity_id": "entityId",

package/src/sdk/models/invoice-modify-line-item-action.ts

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const InvoiceModifyLineItemAction = {
+  Add: "add",
+  Update: "update",
+  Remove: "remove",
+} as const;
+export type InvoiceModifyLineItemAction = ClosedEnum<
+  typeof InvoiceModifyLineItemAction
+>;
+
+/** @internal */
+export const InvoiceModifyLineItemAction$outboundSchema: z.ZodMiniEnum<
+  typeof InvoiceModifyLineItemAction
+> = z.enum(InvoiceModifyLineItemAction);

package/src/sdk/models/invoice-modify-line-item-params.ts

@@ -0,0 +1,76 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import {
+  AddLineItemRequest,
+  AddLineItemRequest$Outbound,
+  AddLineItemRequest$outboundSchema,
+} from "./add-line-item-request.js";
+import {
+  InvoiceModifyLineItemAction,
+  InvoiceModifyLineItemAction$outboundSchema,
+} from "./invoice-modify-line-item-action.js";
+import {
+  UpdateLineItemRequest,
+  UpdateLineItemRequest$Outbound,
+  UpdateLineItemRequest$outboundSchema,
+} from "./update-line-item-request.js";
+
+export type InvoiceModifyLineItemParams = {
+  action: InvoiceModifyLineItemAction;
+  /**
+   * Required for action 'add'. Must contain at least one line item.
+   */
+  items?: Array<AddLineItemRequest> | undefined;
+  /**
+   * Required for action 'update' (one line item per call; edits are versioned, so the id changes).
+   */
+  lineItemId?: string | undefined;
+  /**
+   * Required for action 'remove'. Must contain at least one line item ID.
+   */
+  lineItemIds?: Array<string> | undefined;
+  update?: UpdateLineItemRequest | undefined;
+};
+
+/** @internal */
+export type InvoiceModifyLineItemParams$Outbound = {
+  action: string;
+  items?: Array<AddLineItemRequest$Outbound> | undefined;
+  line_item_id?: string | undefined;
+  line_item_ids?: Array<string> | undefined;
+  update?: UpdateLineItemRequest$Outbound | undefined;
+};
+
+/** @internal */
+export const InvoiceModifyLineItemParams$outboundSchema: z.ZodMiniType<
+  InvoiceModifyLineItemParams$Outbound,
+  InvoiceModifyLineItemParams
+> = z.pipe(
+  z.object({
+    action: InvoiceModifyLineItemAction$outboundSchema,
+    items: z.optional(z.array(AddLineItemRequest$outboundSchema)),
+    lineItemId: z.optional(z.string()),
+    lineItemIds: z.optional(z.array(z.string())),
+    update: z.optional(UpdateLineItemRequest$outboundSchema),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      lineItemId: "line_item_id",
+      lineItemIds: "line_item_ids",
+    });
+  }),
+);
+
+export function invoiceModifyLineItemParamsToJSON(
+  invoiceModifyLineItemParams: InvoiceModifyLineItemParams,
+): string {
+  return JSON.stringify(
+    InvoiceModifyLineItemParams$outboundSchema.parse(
+      invoiceModifyLineItemParams,
+    ),
+  );
+}

package/src/sdk/models/invoice-modify-response.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import {
+  InvoiceResponse,
+  InvoiceResponse$inboundSchema,
+} from "./invoice-response.js";
+import { SDKValidationError } from "./sdk-validation-error.js";
+
+export type InvoiceModifyResponse = {
+  invoice?: InvoiceResponse | undefined;
+};
+
+/** @internal */
+export const InvoiceModifyResponse$inboundSchema: z.ZodMiniType<
+  InvoiceModifyResponse,
+  unknown
+> = z.object({
+  invoice: types.optional(InvoiceResponse$inboundSchema),
+});
+
+export function invoiceModifyResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<InvoiceModifyResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => InvoiceModifyResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'InvoiceModifyResponse' from JSON`,
+  );
+}

package/src/sdk/models/invoice-modify-type.ts

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const InvoiceModifyType = {
+  LineItem: "line_item",
+} as const;
+export type InvoiceModifyType = ClosedEnum<typeof InvoiceModifyType>;
+
+/** @internal */
+export const InvoiceModifyType$outboundSchema: z.ZodMiniEnum<
+  typeof InvoiceModifyType
+> = z.enum(InvoiceModifyType);

package/src/sdk/models/invoice-response.ts

@@ -7,10 +7,18 @@ import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
+import {
+  CheckoutSessionResponse,
+  CheckoutSessionResponse$inboundSchema,
+} from "./checkout-session-response.js";
 import {
   CouponApplicationResponse,
   CouponApplicationResponse$inboundSchema,
 } from "./coupon-application-response.js";
+import {
+  CustomCurrency,
+  CustomCurrency$inboundSchema,
+} from "./custom-currency.js";
 import {
   CustomerResponse,
   CustomerResponse$inboundSchema,
@@ -19,6 +27,10 @@ import {
   InvoiceLineItemResponse,
   InvoiceLineItemResponse$inboundSchema,
 } from "./invoice-line-item-response.js";
+import {
+  InvoiceSourceType,
+  InvoiceSourceType$inboundSchema,
+} from "./invoice-source-type.js";
 import {
   InvoiceStatus,
   InvoiceStatus$inboundSchema,
@@ -38,6 +50,11 @@ import {
   TaxAppliedResponse,
   TaxAppliedResponse$inboundSchema,
 } from "./tax-applied-response.js";
+import {
+  TaxExemptionReasonCode,
+  TaxExemptionReasonCode$inboundSchema,
+} from "./tax-exemption-reason-code.js";
+import { TaxSummary, TaxSummary$inboundSchema } from "./tax-summary.js";
 
 export type InvoiceResponse = {
   /**
@@ -71,6 +88,7 @@ export type InvoiceResponse = {
    * billing_sequence is the sequential number indicating the billing cycle for subscription invoices
    */
   billingSequence?: number | undefined;
+  checkoutSession?: CheckoutSessionResponse | undefined;
   /**
    * coupon_applications contains the coupon applications associated with this invoice (overrides embedded field)
    */
@@ -81,6 +99,7 @@ export type InvoiceResponse = {
    * currency is the three-letter ISO currency code (e.g., USD, EUR, GBP) that applies to all monetary amounts on this invoice
    */
   currency?: string | undefined;
+  customCurrency?: CustomCurrency | undefined;
   /**
    * Customer response object containing all customer information
    */
@@ -174,6 +193,7 @@ export type InvoiceResponse = {
    * These are actual refunds issued to the customer.
    */
   refundedAmount?: string | undefined;
+  sourceType?: InvoiceSourceType | undefined;
   status?: Status | undefined;
   subscription?: SubscriptionResponse | undefined;
   /**
@@ -191,6 +211,8 @@ export type InvoiceResponse = {
    * subtotal is the sum of all line items before any taxes, discounts, or additional fees
    */
   subtotal?: string | undefined;
+  taxExemptionReasonCode?: TaxExemptionReasonCode | undefined;
+  taxSummary?: TaxSummary | undefined;
   /**
    * tax_applied_records contains the tax applied records associated with this invoice
    */
@@ -237,12 +259,14 @@ export const InvoiceResponse$inboundSchema: z.ZodMiniType<
     billing_period: types.optional(types.string()),
     billing_reason: types.optional(types.string()),
     billing_sequence: types.optional(types.number()),
+    checkout_session: types.optional(CheckoutSessionResponse$inboundSchema),
     coupon_applications: types.optional(
       z.array(CouponApplicationResponse$inboundSchema),
     ),
     created_at: types.optional(types.date()),
     created_by: types.optional(types.string()),
     currency: types.optional(types.string()),
+    custom_currency: types.optional(CustomCurrency$inboundSchema),
     customer: types.optional(CustomerResponse$inboundSchema),
     customer_id: types.optional(types.string()),
     description: types.optional(types.string()),
@@ -267,6 +291,7 @@ export const InvoiceResponse$inboundSchema: z.ZodMiniType<
     period_start: types.optional(types.date()),
     recalculated_invoice_id: types.optional(types.string()),
     refunded_amount: types.optional(types.string()),
+    source_type: types.optional(InvoiceSourceType$inboundSchema),
     status: types.optional(Status$inboundSchema),
     subscription: types.optional(
       z.lazy(() => SubscriptionResponse$inboundSchema),
@@ -274,6 +299,10 @@ export const InvoiceResponse$inboundSchema: z.ZodMiniType<
     subscription_customer_id: types.optional(types.string()),
     subscription_id: types.optional(types.string()),
     subtotal: types.optional(types.string()),
+    tax_exemption_reason_code: types.optional(
+      TaxExemptionReasonCode$inboundSchema,
+    ),
+    tax_summary: types.optional(TaxSummary$inboundSchema),
     taxes: types.optional(z.array(TaxAppliedResponse$inboundSchema)),
     tenant_id: types.optional(types.string()),
     total: types.optional(types.string()),
@@ -294,9 +323,11 @@ export const InvoiceResponse$inboundSchema: z.ZodMiniType<
       "billing_period": "billingPeriod",
       "billing_reason": "billingReason",
       "billing_sequence": "billingSequence",
+      "checkout_session": "checkoutSession",
       "coupon_applications": "couponApplications",
       "created_at": "createdAt",
       "created_by": "createdBy",
+      "custom_currency": "customCurrency",
       "customer_id": "customerId",
       "due_date": "dueDate",
       "environment_id": "environmentId",
@@ -317,8 +348,11 @@ export const InvoiceResponse$inboundSchema: z.ZodMiniType<
       "period_start": "periodStart",
       "recalculated_invoice_id": "recalculatedInvoiceId",
       "refunded_amount": "refundedAmount",
+      "source_type": "sourceType",
       "subscription_customer_id": "subscriptionCustomerId",
       "subscription_id": "subscriptionId",
+      "tax_exemption_reason_code": "taxExemptionReasonCode",
+      "tax_summary": "taxSummary",
       "tenant_id": "tenantId",
       "total_discount": "totalDiscount",
       "total_prepaid_credits_applied": "totalPrepaidCreditsApplied",

package/src/sdk/models/invoice-source-type.ts

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const InvoiceSourceType = {
+  Checkout: "checkout",
+} as const;
+export type InvoiceSourceType = ClosedEnum<typeof InvoiceSourceType>;
+
+/** @internal */
+export const InvoiceSourceType$inboundSchema: z.ZodMiniEnum<
+  typeof InvoiceSourceType
+> = z.enum(InvoiceSourceType);

package/src/sdk/models/invoice-sync-settings.ts

@@ -11,6 +11,10 @@ import {
   BillingPeriod,
   BillingPeriod$inboundSchema,
 } from "./billing-period.js";
+import {
+  GlobalCustomField,
+  GlobalCustomField$inboundSchema,
+} from "./global-custom-field.js";
 import {
   MetadataCustomField,
   MetadataCustomField$inboundSchema,
@@ -23,21 +27,37 @@ import {
 
 export type InvoiceSyncSettings = {
   /**
-   * MetadataCustomFields copies metadata values onto Zoho invoice custom fields
+   * Zoho chart-of-accounts id ("Deposit To"). Empty omits account_id, leaving Zoho's
+   *
+   * @remarks
+   * Undeposited Funds default.a
+   */
+  depositToAccountId?: string | undefined;
+  /**
+   * Fixed values written to Zoho invoice custom fields on every sync, independent of
    *
    * @remarks
-   * verbatim.
+   * any metadata source.
+   */
+  globalCustomFields?: Array<GlobalCustomField> | undefined;
+  /**
+   * Copies metadata values onto Zoho invoice custom fields verbatim.
    */
   metadataCustomFields?: Array<MetadataCustomField> | undefined;
   normalizeFixedTo?: BillingPeriod | undefined;
+  /**
+   * Zoho payment modes are merchant-editable free strings with no id, so this is passed
+   *
+   * @remarks
+   * through verbatim. Empty means DefaultZohoPaymentMode.
+   */
+  paymentMode?: string | undefined;
   servicePeriodCustomFields?: ServicePeriodCustomFields | undefined;
   /**
-   * SubmitForApproval submits the synced invoice into the merchant's Zoho Books approval
+   * Zoho rejects payments on draft invoices, and merchants configure a Zoho auto-approval
    *
    * @remarks
-   * flow before recording payment. Zoho rejects payments on draft invoices, and merchants
-   * configure a Zoho auto-approval rule for FlexPrice-sent invoices, so we submit, wait for
-   * that rule to fire, then pay.
+   * rule for FlexPrice-sent invoices, so we submit, wait for that rule to fire, then pay.
    */
   submitForApproval?: boolean | undefined;
 };
@@ -48,10 +68,15 @@ export const InvoiceSyncSettings$inboundSchema: z.ZodMiniType<
   unknown
 > = z.pipe(
   z.object({
+    deposit_to_account_id: types.optional(types.string()),
+    global_custom_fields: types.optional(
+      z.array(GlobalCustomField$inboundSchema),
+    ),
     metadata_custom_fields: types.optional(
       z.array(MetadataCustomField$inboundSchema),
     ),
     normalize_fixed_to: types.optional(BillingPeriod$inboundSchema),
+    payment_mode: types.optional(types.string()),
     service_period_custom_fields: types.optional(
       ServicePeriodCustomFields$inboundSchema,
     ),
@@ -59,8 +84,11 @@ export const InvoiceSyncSettings$inboundSchema: z.ZodMiniType<
   }),
   z.transform((v) => {
     return remap$(v, {
+      "deposit_to_account_id": "depositToAccountId",
+      "global_custom_fields": "globalCustomFields",
       "metadata_custom_fields": "metadataCustomFields",
       "normalize_fixed_to": "normalizeFixedTo",
+      "payment_mode": "paymentMode",
       "service_period_custom_fields": "servicePeriodCustomFields",
       "submit_for_approval": "submitForApproval",
     });

package/src/sdk/models/line-item-change.ts

@@ -0,0 +1,48 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+
+export type LineItemChange = {
+  /**
+   * Amount reprices the charge. Flat fee only for now.
+   */
+  amount?: string | undefined;
+  effectiveDate?: Date | undefined;
+  id: string;
+  quantity?: string | undefined;
+};
+
+/** @internal */
+export type LineItemChange$Outbound = {
+  amount?: string | undefined;
+  effective_date?: string | undefined;
+  id: string;
+  quantity?: string | undefined;
+};
+
+/** @internal */
+export const LineItemChange$outboundSchema: z.ZodMiniType<
+  LineItemChange$Outbound,
+  LineItemChange
+> = z.pipe(
+  z.object({
+    amount: z.optional(z.string()),
+    effectiveDate: z.optional(
+      z.pipe(z.date(), z.transform(v => v.toISOString())),
+    ),
+    id: z.string(),
+    quantity: z.optional(z.string()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      effectiveDate: "effective_date",
+    });
+  }),
+);
+
+export function lineItemChangeToJSON(lineItemChange: LineItemChange): string {
+  return JSON.stringify(LineItemChange$outboundSchema.parse(lineItemChange));
+}

package/src/sdk/models/line-item-grouping.ts

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
+
+export const LineItemGrouping = {
+  PerChargePeriod: "per_charge_period",
+  PerBillingPeriod: "per_billing_period",
+} as const;
+export type LineItemGrouping = OpenEnum<typeof LineItemGrouping>;
+
+/** @internal */
+export const LineItemGrouping$inboundSchema: z.ZodMiniType<
+  LineItemGrouping,
+  unknown
+> = openEnums.inboundSchema(LineItemGrouping);
+/** @internal */
+export const LineItemGrouping$outboundSchema: z.ZodMiniType<
+  string,
+  LineItemGrouping
+> = openEnums.outboundSchema(LineItemGrouping);

package/src/sdk/models/list-addon-associations-response.ts

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import {
+  AddonAssociationResponse,
+  AddonAssociationResponse$inboundSchema,
+} from "./addon-association-response.js";
+import {
+  PaginationResponse,
+  PaginationResponse$inboundSchema,
+} from "./pagination-response.js";
+import { SDKValidationError } from "./sdk-validation-error.js";
+
+export type ListAddonAssociationsResponse = {
+  items?: Array<AddonAssociationResponse> | undefined;
+  pagination?: PaginationResponse | undefined;
+};
+
+/** @internal */
+export const ListAddonAssociationsResponse$inboundSchema: z.ZodMiniType<
+  ListAddonAssociationsResponse,
+  unknown
+> = z.object({
+  items: types.optional(z.array(AddonAssociationResponse$inboundSchema)),
+  pagination: types.optional(PaginationResponse$inboundSchema),
+});
+
+export function listAddonAssociationsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<ListAddonAssociationsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListAddonAssociationsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListAddonAssociationsResponse' from JSON`,
+  );
+}