@leaflow/sdk 0.109.0 → 0.110.0

package/dist/billing/v1/generated/functions.d.ts

@@ -5,7 +5,7 @@
  * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
  * OpenAPI spec version: v1
  */
-import type { AccountBalance, ActiveResourceList, AllowanceList, AutoRenewSet, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, Cancellation, CancellationCreate, CancellationList, CheckoutOrderRequest, CreditGrantList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListCreditGrantsParams, ListCurrenciesParams, ListEntitlementsParams, ListInvoiceItemsParams, ListInvoicesParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRatesHeaders, ListRatesParams, ListRefundsParams, ListRenewalPricesParams, ListSpendParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, MeteredUsage, NotModifiedResponse, Order, OrderItemList, OrderList, PayInvoiceRequest, PayTogetherRequest, PaymentMethod, PaymentMethodList, PaymentMethodSetup, PaymentMethodSetupResult, PaymentOptionList, PaymentPreview, PaymentResult, Plan, PlanList, PreviewInvoicePaymentParams, Price, PriceList, Product, ProductID, ProductList, ProjectAssignment, ProjectAssignmentList, Quote, QuoteRequest, RateList, RefundList, RenewRequest, RenewalOrderRequest, RenewalPriceList, SetProjectAssignmentRequest, SpendRowList, Subscription, SubscriptionList, TopUp, TopUpCreate, TopUpList, TransactionList, UsageChargeList } from "./models.js";
+import type { AccountBalance, ActiveResourceList, AllowanceList, AutoRenewSet, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, Cancellation, CancellationCreate, CancellationList, CheckoutOrderRequest, CreditGrantList, CreditNote, CreditNoteItemList, CreditNoteList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListCreditGrantsParams, ListCreditNoteItemsParams, ListCreditNotesParams, ListCurrenciesParams, ListEntitlementsParams, ListInvoiceItemsParams, ListInvoicesParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRatesHeaders, ListRatesParams, ListRefundsParams, ListRenewalPricesParams, ListSpendParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, MeteredUsage, NotModifiedResponse, Order, OrderCancel, OrderItemList, OrderList, PayInvoiceRequest, PayTogetherRequest, PaymentMethod, PaymentMethodList, PaymentMethodSetup, PaymentMethodSetupResult, PaymentOptionList, PaymentPreview, PaymentResult, Plan, PlanList, PreviewInvoicePaymentParams, Price, PriceList, Product, ProductID, ProductList, ProjectAssignment, ProjectAssignmentList, Quote, QuoteRequest, RateList, RefundList, RenewRequest, RenewalOrderRequest, RenewalPriceList, SetProjectAssignmentRequest, SpendRowList, Subscription, SubscriptionList, TopUp, TopUpCreate, TopUpList, TransactionList, UsageChargeList } from "./models.js";
 export type HTTPStatusCode1xx = 100 | 101 | 102 | 103;
 export type HTTPStatusCode2xx = 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207;
 export type HTTPStatusCode3xx = 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308;
@@ -729,6 +729,69 @@ export declare const getListCreditGrantsUrl: (params?: ListCreditGrantsParams) =
  * @summary List credit grants
  */
 export declare const listCreditGrants: (params?: ListCreditGrantsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCreditGrantsResponse>;
+export type listCreditNotesResponse200 = {
+    data: CreditNoteList;
+    status: 200;
+};
+export type listCreditNotesResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type listCreditNotesResponseSuccess = listCreditNotesResponse200 & {
+    headers: Headers;
+};
+export type listCreditNotesResponseError = listCreditNotesResponseDefault & {
+    headers: Headers;
+};
+export type listCreditNotesResponse = listCreditNotesResponseSuccess | listCreditNotesResponseError;
+export declare const getListCreditNotesUrl: (params?: ListCreditNotesParams) => string;
+/**
+ * Newest issued_at first, then ID. Requires authorization for the invoice's billing account. Filters narrow authorized results and apply before counting and paging.
+ * @summary List credit notes
+ */
+export declare const listCreditNotes: (params?: ListCreditNotesParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCreditNotesResponse>;
+export type getCreditNoteResponse200 = {
+    data: CreditNote;
+    status: 200;
+};
+export type getCreditNoteResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type getCreditNoteResponseSuccess = getCreditNoteResponse200 & {
+    headers: Headers;
+};
+export type getCreditNoteResponseError = getCreditNoteResponseDefault & {
+    headers: Headers;
+};
+export type getCreditNoteResponse = getCreditNoteResponseSuccess | getCreditNoteResponseError;
+export declare const getGetCreditNoteUrl: (creditNoteId: string) => string;
+/**
+ * Requires authorization for the invoice's billing account.
+ * @summary Get credit note
+ */
+export declare const getCreditNote: (creditNoteId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getCreditNoteResponse>;
+export type listCreditNoteItemsResponse200 = {
+    data: CreditNoteItemList;
+    status: 200;
+};
+export type listCreditNoteItemsResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type listCreditNoteItemsResponseSuccess = listCreditNoteItemsResponse200 & {
+    headers: Headers;
+};
+export type listCreditNoteItemsResponseError = listCreditNoteItemsResponseDefault & {
+    headers: Headers;
+};
+export type listCreditNoteItemsResponse = listCreditNoteItemsResponseSuccess | listCreditNoteItemsResponseError;
+export declare const getListCreditNoteItemsUrl: (creditNoteId: string, params?: ListCreditNoteItemsParams) => string;
+/**
+ * The original invoice lines reduced by this note. Requires authorization for their invoice's billing account.
+ * @summary List credit note items
+ */
+export declare const listCreditNoteItems: (creditNoteId: string, params?: ListCreditNoteItemsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCreditNoteItemsResponse>;
 export type listRefundsResponse200 = {
     data: RefundList;
     status: 200;
@@ -1228,20 +1291,27 @@ export type cancelOrderResponseError = (cancelOrderResponse409 | cancelOrderResp
 export type cancelOrderResponse = cancelOrderResponseSuccess | cancelOrderResponseError;
 export declare const getCancelOrderUrl: (orderId: string) => string;
 /**
- * Withdraws an unaccepted order without recording a delivery failure. Payment may be absent,
- * partial or complete; the order becomes canceled and any collected amount is automatically
- * returned to its original payment sources. External payment-method refunds can finish
- * asynchronously. Canceling an already canceled order returns it unchanged. A previously failed
- * order keeps its failure outcome. The order and financial history are retained.
+ * Cancels the selected, still-undelivered items of an unaccepted order without recording a
+ * delivery failure. Omit order_item_ids to select every still-pending item, or name one or
+ * more items. Successful items remain delivered and are not refunded. Whole-order and partial
+ * cancellation both require confirmed non-delivery and necessary cleanup. The order keeps
+ * its existing pending phase while any item is still pending; its final outcome follows all
+ * item outcomes. Previously failed items keep their failure outcome.
+ *
+ * Payment may be absent, partial or complete. Confirmed checkout keeps the selected items'
+ * agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
+ * are returned to their original payment sources. When checkout has not been confirmed, the
+ * remaining items are quoted again. External payment-method refunds can finish asynchronously.
+ * The order and financial history are retained; the same cancellation does not refund twice.
  *
- * Refused once the order is accepted: its owning service must coordinate cancellation during
- * provisioning and confirm non-delivery and necessary cleanup before recording cancellation.
- * Delivered items are ended through subscription cancellation. An unknown or in-flight payment
- * outcome must first be reconciled; it is not assumed to be unpaid. Scheduled changes continue
- * to be canceled through the service that owns them. Refund quotations use CreateQuote.refund.
+ * Once the order is accepted, its owning service coordinates cancellation and confirms
+ * non-delivery and cleanup through the cancellation RPC. Delivered items are ended through
+ * subscription cancellation. Unknown delivery or payment outcomes are not refund evidence;
+ * in-flight or unknown payments must be reconciled first. Scheduled changes continue to be
+ * canceled through the owning service. Refund quotations use CreateQuote.refund.
  * @summary Cancel order
  */
-export declare const cancelOrder: (orderId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<cancelOrderResponse>;
+export declare const cancelOrder: (orderId: string, orderCancel?: OrderCancel, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<cancelOrderResponse>;
 export type listOrderItemsResponse200 = {
     data: OrderItemList;
     status: 200;

package/dist/billing/v1/generated/functions.js

@@ -805,6 +805,72 @@ export const listCreditGrants = async (params, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
+export const getListCreditNotesUrl = (params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value !== undefined) {
+            normalizedParams.append(key, value === null ? "null" : String(value));
+        }
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0
+        ? `https://billing.leaflow.cloud/api/v1/credit-notes?${stringifiedParams}`
+        : `https://billing.leaflow.cloud/api/v1/credit-notes`;
+};
+/**
+ * Newest issued_at first, then ID. Requires authorization for the invoice's billing account. Filters narrow authorized results and apply before counting and paging.
+ * @summary List credit notes
+ */
+export const listCreditNotes = async (params, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getListCreditNotesUrl(params), {
+        ...options,
+        method: "GET",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
+export const getGetCreditNoteUrl = (creditNoteId) => {
+    return `https://billing.leaflow.cloud/api/v1/credit-notes/${encodeURIComponent(String(creditNoteId))}`;
+};
+/**
+ * Requires authorization for the invoice's billing account.
+ * @summary Get credit note
+ */
+export const getCreditNote = async (creditNoteId, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getGetCreditNoteUrl(creditNoteId), {
+        ...options,
+        method: "GET",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
+export const getListCreditNoteItemsUrl = (creditNoteId, params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value !== undefined) {
+            normalizedParams.append(key, value === null ? "null" : String(value));
+        }
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0
+        ? `https://billing.leaflow.cloud/api/v1/credit-notes/${encodeURIComponent(String(creditNoteId))}/items?${stringifiedParams}`
+        : `https://billing.leaflow.cloud/api/v1/credit-notes/${encodeURIComponent(String(creditNoteId))}/items`;
+};
+/**
+ * The original invoice lines reduced by this note. Requires authorization for their invoice's billing account.
+ * @summary List credit note items
+ */
+export const listCreditNoteItems = async (creditNoteId, params, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getListCreditNoteItemsUrl(creditNoteId, params), {
+        ...options,
+        method: "GET",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
 export const getListRefundsUrl = (params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {
@@ -1351,23 +1417,47 @@ export const getCancelOrderUrl = (orderId) => {
     return `https://billing.leaflow.cloud/api/v1/orders/${encodeURIComponent(String(orderId))}/cancel`;
 };
 /**
- * Withdraws an unaccepted order without recording a delivery failure. Payment may be absent,
- * partial or complete; the order becomes canceled and any collected amount is automatically
- * returned to its original payment sources. External payment-method refunds can finish
- * asynchronously. Canceling an already canceled order returns it unchanged. A previously failed
- * order keeps its failure outcome. The order and financial history are retained.
+ * Cancels the selected, still-undelivered items of an unaccepted order without recording a
+ * delivery failure. Omit order_item_ids to select every still-pending item, or name one or
+ * more items. Successful items remain delivered and are not refunded. Whole-order and partial
+ * cancellation both require confirmed non-delivery and necessary cleanup. The order keeps
+ * its existing pending phase while any item is still pending; its final outcome follows all
+ * item outcomes. Previously failed items keep their failure outcome.
  *
- * Refused once the order is accepted: its owning service must coordinate cancellation during
- * provisioning and confirm non-delivery and necessary cleanup before recording cancellation.
- * Delivered items are ended through subscription cancellation. An unknown or in-flight payment
- * outcome must first be reconciled; it is not assumed to be unpaid. Scheduled changes continue
- * to be canceled through the service that owns them. Refund quotations use CreateQuote.refund.
+ * Payment may be absent, partial or complete. Confirmed checkout keeps the selected items'
+ * agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
+ * are returned to their original payment sources. When checkout has not been confirmed, the
+ * remaining items are quoted again. External payment-method refunds can finish asynchronously.
+ * The order and financial history are retained; the same cancellation does not refund twice.
+ *
+ * Once the order is accepted, its owning service coordinates cancellation and confirms
+ * non-delivery and cleanup through the cancellation RPC. Delivered items are ended through
+ * subscription cancellation. Unknown delivery or payment outcomes are not refund evidence;
+ * in-flight or unknown payments must be reconciled first. Scheduled changes continue to be
+ * canceled through the owning service. Refund quotations use CreateQuote.refund.
  * @summary Cancel order
  */
-export const cancelOrder = async (orderId, options, fetchFn) => {
+export const cancelOrder = async (orderId, orderCancel, options, fetchFn) => {
+    const getHeaders = (h) => {
+        if (!h)
+            return {};
+        if (h instanceof Headers)
+            return Object.fromEntries(h.entries());
+        if (Symbol.iterator in h) {
+            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+        }
+        const headers = {};
+        for (const [name, value] of Object.entries(h)) {
+            if (value !== undefined)
+                headers[name] = value;
+        }
+        return headers;
+    };
     const res = await (fetchFn ?? fetch)(getCancelOrderUrl(orderId), {
         ...options,
         method: "POST",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(orderCancel),
     });
     const body = [204, 205, 304].includes(res.status) ? null : await res.text();
     const data = body ? JSON.parse(body) : {};

package/dist/billing/v1/generated/models.d.ts

@@ -30,6 +30,14 @@ export declare const RefundPolicy: {
     readonly none: "none";
     readonly prorated: "prorated";
 };
+export interface OrderCancel {
+    /**
+     * Omit to select all still-pending items. Explicit selections name one or more items of this order; successful items cannot be reversed here.
+     * @minItems 1
+     * @maxItems 100
+     */
+    order_item_ids?: string[];
+}
 /**
  * A decimal string, in the currency stated alongside it.
  *
@@ -1304,7 +1312,11 @@ export interface Invoice {
     /** Subtotal less discount plus tax. Balance and credit grants are payment sources, not reductions of the receivable. */
     total: Money;
     amount_paid?: Money;
-    /** What is still collectible after applied credits and successful payments; never below zero. A draft order invoice is not collectible until checkout confirms it, and a paid or void invoice has none. */
+    /** Issued, non-void credit notes that reduced unpaid receivables. Does not rewrite the original invoice total. */
+    unpaid_credit_notes_amount: Money;
+    /** Issued credit notes against payments already received. This is a return obligation, not evidence of completed refunds. */
+    paid_credit_notes_amount: Money;
+    /** What is still collectible after unpaid credit notes and successful payments; never below zero. A draft order invoice is not collectible until checkout confirms it, and a paid or void invoice has none. */
     amount_due: Money;
     /** @nullable */
     period_start?: string | null;
@@ -1416,6 +1428,50 @@ export interface CreditGrantList {
     items: CreditGrant[];
     pagination: OffsetPagination;
 }
+export type CreditNoteStatus = (typeof CreditNoteStatus)[keyof typeof CreditNoteStatus];
+export declare const CreditNoteStatus: {
+    readonly issued: "issued";
+    readonly void: "void";
+};
+/**
+ * An issued invoice reduction. Its credited amount is unpaid_amount plus paid_amount. A paid credit records a return obligation; refund_id identifies its refund, whose outcome may still be pending. Original invoice amounts remain unchanged.
+ */
+export interface CreditNote {
+    id: string;
+    invoice_id: string;
+    currency: string;
+    issued_at: string;
+    status: CreditNoteStatus;
+    /**
+     * When this note was voided; null while issued.
+     * @nullable
+     */
+    voided_at: string | null;
+    /** The reduction of unpaid receivables. A void note no longer reduces what is due. */
+    unpaid_amount: Money;
+    /** The credited part of payments already received. This is not proof that its refund has completed. */
+    paid_amount: Money;
+    /**
+     * The refund to the original payment sources, or null when no paid amount was credited.
+     * @nullable
+     */
+    refund_id: string | null;
+}
+export interface CreditNoteItem {
+    id: string;
+    credit_note_id: string;
+    invoice_item_id: string;
+    unpaid_amount: Money;
+    paid_amount: Money;
+}
+export interface CreditNoteList {
+    items: CreditNote[];
+    pagination: OffsetPagination;
+}
+export interface CreditNoteItemList {
+    items: CreditNoteItem[];
+    pagination: OffsetPagination;
+}
 /**
  * Use balance_amount, credit_amount and gateway_amount, which also show a refund split between several destinations.
  * @deprecated
@@ -1911,8 +1967,12 @@ export interface InvoiceSummary {
     tax_amount: string;
     total: string;
     amount_paid: string;
+    /** Issued, non-void credit notes that reduced unpaid receivables. Does not rewrite the original invoice total. */
+    unpaid_credit_notes_amount: Money;
+    /** Issued credit notes against payments already received. This is a return obligation, not evidence of completed refunds. */
+    paid_credit_notes_amount: Money;
     /**
-     * What is still collectible after applied credits and successful payments; never below zero.
+     * What is still collectible after unpaid credit notes and successful payments; never below zero.
      * @pattern ^\d+(\.\d{1,10})?$
      */
     amount_due: string;
@@ -2046,7 +2106,6 @@ export interface Order {
     /** How the order was paid. Absent until it is paid. */
     paid_with?: PaidWith;
     account?: AccountIdentity;
-    cancel_reason?: string;
     change_effective_at?: string;
     id: string;
     /**
@@ -2834,6 +2893,42 @@ export declare const ListCreditGrantsStatus: {
     readonly expired: "expired";
     readonly voided: "voided";
 };
+export type ListCreditNotesParams = {
+    /**
+     * 1-based page number. Defaults to 1.
+     * @minimum 1
+     * @maximum 2147483647
+     */
+    page?: number;
+    /**
+     * Items per page. Defaults to 50; at most 200.
+     * @minimum 1
+     * @maximum 200
+     */
+    page_size?: number;
+    /**
+     * Restrict to one of your accounts. All of them when omitted.
+     */
+    billing_account_id?: AccountIdQueryParameter;
+    /**
+     * Only the notes for this invoice.
+     */
+    invoice_id?: string;
+};
+export type ListCreditNoteItemsParams = {
+    /**
+     * 1-based page number. Defaults to 1.
+     * @minimum 1
+     * @maximum 2147483647
+     */
+    page?: number;
+    /**
+     * Items per page. Defaults to 50; at most 200.
+     * @minimum 1
+     * @maximum 200
+     */
+    page_size?: number;
+};
 export type ListRefundsParams = {
     /**
      * 1-based page number. Defaults to 1.

package/dist/billing/v1/generated/models.js

@@ -160,6 +160,10 @@ export const CreditGrantStatus = {
     expired: "expired",
     voided: "voided",
 };
+export const CreditNoteStatus = {
+    issued: "issued",
+    void: "void",
+};
 export const RefundDestination = {
     balance: "balance",
     gateway: "gateway",

package/dist/billing/v1/generated/schemas.zod.d.ts

@@ -428,6 +428,42 @@ export declare const ListCreditGrantsQueryParams: zod.ZodObject<{
         voided: "voided";
     }>>;
 }, zod.z.core.$strict>;
+/**
+ * Newest issued_at first, then ID. Requires authorization for the invoice's billing account. Filters narrow authorized results and apply before counting and paging.
+ * @summary List credit notes
+ */
+export declare const listCreditNotesQueryPageDefault = 1;
+export declare const listCreditNotesQueryPageMax = 2147483647;
+export declare const listCreditNotesQueryPageSizeDefault = 50;
+export declare const listCreditNotesQueryPageSizeMax = 200;
+export declare const ListCreditNotesQueryParams: zod.ZodObject<{
+    page: zod.ZodDefault<zod.ZodInt>;
+    page_size: zod.ZodDefault<zod.ZodInt>;
+    billing_account_id: zod.ZodOptional<zod.ZodInt>;
+    invoice_id: zod.ZodOptional<zod.ZodUUID>;
+}, zod.z.core.$strict>;
+/**
+ * Requires authorization for the invoice's billing account.
+ * @summary Get credit note
+ */
+export declare const GetCreditNoteParams: zod.ZodObject<{
+    creditNoteId: zod.ZodUUID;
+}, zod.z.core.$strict>;
+/**
+ * The original invoice lines reduced by this note. Requires authorization for their invoice's billing account.
+ * @summary List credit note items
+ */
+export declare const ListCreditNoteItemsParams: zod.ZodObject<{
+    creditNoteId: zod.ZodUUID;
+}, zod.z.core.$strict>;
+export declare const listCreditNoteItemsQueryPageDefault = 1;
+export declare const listCreditNoteItemsQueryPageMax = 2147483647;
+export declare const listCreditNoteItemsQueryPageSizeDefault = 50;
+export declare const listCreditNoteItemsQueryPageSizeMax = 200;
+export declare const ListCreditNoteItemsQueryParams: zod.ZodObject<{
+    page: zod.ZodDefault<zod.ZodInt>;
+    page_size: zod.ZodDefault<zod.ZodInt>;
+}, zod.z.core.$strict>;
 /**
  * Newest first.
  * @summary List refunds
@@ -847,22 +883,32 @@ export declare const CheckoutOrderBody: zod.ZodObject<{
     expected_amount: zod.ZodOptional<zod.ZodIntersection<zod.ZodString, zod.ZodString>>;
 }, zod.z.core.$strict>;
 /**
- * Withdraws an unaccepted order without recording a delivery failure. Payment may be absent,
- * partial or complete; the order becomes canceled and any collected amount is automatically
- * returned to its original payment sources. External payment-method refunds can finish
- * asynchronously. Canceling an already canceled order returns it unchanged. A previously failed
- * order keeps its failure outcome. The order and financial history are retained.
+ * Cancels the selected, still-undelivered items of an unaccepted order without recording a
+ * delivery failure. Omit order_item_ids to select every still-pending item, or name one or
+ * more items. Successful items remain delivered and are not refunded. Whole-order and partial
+ * cancellation both require confirmed non-delivery and necessary cleanup. The order keeps
+ * its existing pending phase while any item is still pending; its final outcome follows all
+ * item outcomes. Previously failed items keep their failure outcome.
  *
- * Refused once the order is accepted: its owning service must coordinate cancellation during
- * provisioning and confirm non-delivery and necessary cleanup before recording cancellation.
- * Delivered items are ended through subscription cancellation. An unknown or in-flight payment
- * outcome must first be reconciled; it is not assumed to be unpaid. Scheduled changes continue
- * to be canceled through the service that owns them. Refund quotations use CreateQuote.refund.
+ * Payment may be absent, partial or complete. Confirmed checkout keeps the selected items'
+ * agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
+ * are returned to their original payment sources. When checkout has not been confirmed, the
+ * remaining items are quoted again. External payment-method refunds can finish asynchronously.
+ * The order and financial history are retained; the same cancellation does not refund twice.
+ *
+ * Once the order is accepted, its owning service coordinates cancellation and confirms
+ * non-delivery and cleanup through the cancellation RPC. Delivered items are ended through
+ * subscription cancellation. Unknown delivery or payment outcomes are not refund evidence;
+ * in-flight or unknown payments must be reconciled first. Scheduled changes continue to be
+ * canceled through the owning service. Refund quotations use CreateQuote.refund.
  * @summary Cancel order
  */
 export declare const CancelOrderParams: zod.ZodObject<{
     orderId: zod.ZodUUID;
 }, zod.z.core.$strict>;
+export declare const CancelOrderBody: zod.ZodObject<{
+    order_item_ids: zod.ZodOptional<zod.ZodArray<zod.ZodUUID>>;
+}, zod.z.core.$strict>;
 /**
  * One entry per item bought, with the price charged and the period it covers.
  * @summary List order items

package/dist/billing/v1/generated/schemas.zod.js

@@ -11,6 +11,7 @@ import { BillingAccountCreate } from "./validators/billingAccountCreate.zod.js";
 import { BillingAccountUpdate } from "./validators/billingAccountUpdate.zod.js";
 import { CancellationCreate } from "./validators/cancellationCreate.zod.js";
 import { CheckoutOrderRequest } from "./validators/checkoutOrderRequest.zod.js";
+import { OrderCancel } from "./validators/orderCancel.zod.js";
 import { PayInvoiceRequest } from "./validators/payInvoiceRequest.zod.js";
 import { PayTogetherRequest } from "./validators/payTogetherRequest.zod.js";
 import { PaymentMethodSetup } from "./validators/paymentMethodSetup.zod.js";
@@ -529,6 +530,65 @@ export const ListCreditGrantsQueryParams = zod.strictObject({
         .describe("Restrict to one of your accounts. All of them when omitted."),
     status: zod.enum(["active", "depleted", "expired", "voided"]).optional(),
 });
+/**
+ * Newest issued_at first, then ID. Requires authorization for the invoice's billing account. Filters narrow authorized results and apply before counting and paging.
+ * @summary List credit notes
+ */
+export const listCreditNotesQueryPageDefault = 1;
+export const listCreditNotesQueryPageMax = 2147483647;
+export const listCreditNotesQueryPageSizeDefault = 50;
+export const listCreditNotesQueryPageSizeMax = 200;
+export const ListCreditNotesQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listCreditNotesQueryPageMax)
+        .default(listCreditNotesQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listCreditNotesQueryPageSizeMax)
+        .default(listCreditNotesQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    invoice_id: zod.uuid().optional().describe("Only the notes for this invoice."),
+});
+/**
+ * Requires authorization for the invoice's billing account.
+ * @summary Get credit note
+ */
+export const GetCreditNoteParams = zod.strictObject({
+    creditNoteId: zod.uuid(),
+});
+/**
+ * The original invoice lines reduced by this note. Requires authorization for their invoice's billing account.
+ * @summary List credit note items
+ */
+export const ListCreditNoteItemsParams = zod.strictObject({
+    creditNoteId: zod.uuid(),
+});
+export const listCreditNoteItemsQueryPageDefault = 1;
+export const listCreditNoteItemsQueryPageMax = 2147483647;
+export const listCreditNoteItemsQueryPageSizeDefault = 50;
+export const listCreditNoteItemsQueryPageSizeMax = 200;
+export const ListCreditNoteItemsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listCreditNoteItemsQueryPageMax)
+        .default(listCreditNoteItemsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listCreditNoteItemsQueryPageSizeMax)
+        .default(listCreditNoteItemsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
 /**
  * Newest first.
  * @summary List refunds
@@ -977,22 +1037,30 @@ export const CheckoutOrderParams = zod.strictObject({
 });
 export const CheckoutOrderBody = CheckoutOrderRequest;
 /**
- * Withdraws an unaccepted order without recording a delivery failure. Payment may be absent,
- * partial or complete; the order becomes canceled and any collected amount is automatically
- * returned to its original payment sources. External payment-method refunds can finish
- * asynchronously. Canceling an already canceled order returns it unchanged. A previously failed
- * order keeps its failure outcome. The order and financial history are retained.
+ * Cancels the selected, still-undelivered items of an unaccepted order without recording a
+ * delivery failure. Omit order_item_ids to select every still-pending item, or name one or
+ * more items. Successful items remain delivered and are not refunded. Whole-order and partial
+ * cancellation both require confirmed non-delivery and necessary cleanup. The order keeps
+ * its existing pending phase while any item is still pending; its final outcome follows all
+ * item outcomes. Previously failed items keep their failure outcome.
+ *
+ * Payment may be absent, partial or complete. Confirmed checkout keeps the selected items'
+ * agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
+ * are returned to their original payment sources. When checkout has not been confirmed, the
+ * remaining items are quoted again. External payment-method refunds can finish asynchronously.
+ * The order and financial history are retained; the same cancellation does not refund twice.
  *
- * Refused once the order is accepted: its owning service must coordinate cancellation during
- * provisioning and confirm non-delivery and necessary cleanup before recording cancellation.
- * Delivered items are ended through subscription cancellation. An unknown or in-flight payment
- * outcome must first be reconciled; it is not assumed to be unpaid. Scheduled changes continue
- * to be canceled through the service that owns them. Refund quotations use CreateQuote.refund.
+ * Once the order is accepted, its owning service coordinates cancellation and confirms
+ * non-delivery and cleanup through the cancellation RPC. Delivered items are ended through
+ * subscription cancellation. Unknown delivery or payment outcomes are not refund evidence;
+ * in-flight or unknown payments must be reconciled first. Scheduled changes continue to be
+ * canceled through the owning service. Refund quotations use CreateQuote.refund.
  * @summary Cancel order
  */
 export const CancelOrderParams = zod.strictObject({
     orderId: zod.uuid(),
 });
+export const CancelOrderBody = OrderCancel;
 /**
  * One entry per item bought, with the price charged and the period it covers.
  * @summary List order items

package/dist/billing/v1/generated/validators/creditNote.zod.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const CreditNote: zod.ZodObject<{
+    id: zod.ZodUUID;
+    invoice_id: zod.ZodUUID;
+    currency: zod.ZodString;
+    issued_at: zod.z.ZodISODateTime;
+    status: zod.ZodEnum<{
+        void: "void";
+        issued: "issued";
+    }>;
+    voided_at: zod.ZodNullable<zod.z.ZodISODateTime>;
+    unpaid_amount: zod.ZodString;
+    paid_amount: zod.ZodString;
+    refund_id: zod.ZodNullable<zod.ZodUUID>;
+}, zod.z.core.$strict>;
+export type CreditNote = zod.input<typeof CreditNote>;
+export type CreditNoteOutput = zod.output<typeof CreditNote>;

package/dist/billing/v1/generated/validators/creditNote.zod.js

@@ -0,0 +1,28 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+export const CreditNote = zod
+    .strictObject({
+    id: zod.uuid(),
+    invoice_id: zod.uuid(),
+    currency: zod.string(),
+    issued_at: zod.iso.datetime({ offset: true }),
+    status: zod.enum(["issued", "void"]),
+    voided_at: zod.iso
+        .datetime({ offset: true })
+        .nullable()
+        .describe("When this note was voided; null while issued."),
+    unpaid_amount: Money.describe("The reduction of unpaid receivables. A void note no longer reduces what is due."),
+    paid_amount: Money.describe("The credited part of payments already received. This is not proof that its refund has completed."),
+    refund_id: zod
+        .uuid()
+        .nullable()
+        .describe("The refund to the original payment sources, or null when no paid amount was credited."),
+})
+    .describe("An issued invoice reduction. Its credited amount is unpaid_amount plus paid_amount. A paid credit records a return obligation; refund_id identifies its refund, whose outcome may still be pending. Original invoice amounts remain unchanged.");

package/dist/billing/v1/generated/validators/creditNoteItem.zod.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const CreditNoteItem: zod.ZodObject<{
+    id: zod.ZodUUID;
+    credit_note_id: zod.ZodUUID;
+    invoice_item_id: zod.ZodUUID;
+    unpaid_amount: zod.ZodString;
+    paid_amount: zod.ZodString;
+}, zod.z.core.$strict>;
+export type CreditNoteItem = zod.input<typeof CreditNoteItem>;
+export type CreditNoteItemOutput = zod.output<typeof CreditNoteItem>;

package/dist/billing/v1/generated/validators/creditNoteItem.zod.js

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+export const CreditNoteItem = zod.strictObject({
+    id: zod.uuid(),
+    credit_note_id: zod.uuid(),
+    invoice_item_id: zod.uuid(),
+    unpaid_amount: Money,
+    paid_amount: Money,
+});

package/dist/billing/v1/generated/validators/creditNoteItemList.zod.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const CreditNoteItemList: zod.ZodObject<{
+    items: zod.ZodArray<zod.ZodObject<{
+        id: zod.ZodUUID;
+        credit_note_id: zod.ZodUUID;
+        invoice_item_id: zod.ZodUUID;
+        unpaid_amount: zod.ZodString;
+        paid_amount: zod.ZodString;
+    }, zod.z.core.$strict>>;
+    pagination: zod.ZodObject<{
+        page: zod.ZodInt;
+        page_size: zod.ZodInt;
+        total_count: zod.ZodOptional<zod.ZodInt>;
+    }, zod.z.core.$strict>;
+}, zod.z.core.$strict>;
+export type CreditNoteItemList = zod.input<typeof CreditNoteItemList>;
+export type CreditNoteItemListOutput = zod.output<typeof CreditNoteItemList>;

package/dist/billing/v1/generated/validators/creditNoteItemList.zod.js

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { CreditNoteItem } from "./creditNoteItem.zod.js";
+import { OffsetPagination } from "./offsetPagination.zod.js";
+export const CreditNoteItemList = zod.strictObject({
+    items: zod.array(CreditNoteItem),
+    pagination: OffsetPagination,
+});

package/dist/billing/v1/generated/validators/creditNoteList.zod.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const CreditNoteList: zod.ZodObject<{
+    items: zod.ZodArray<zod.ZodObject<{
+        id: zod.ZodUUID;
+        invoice_id: zod.ZodUUID;
+        currency: zod.ZodString;
+        issued_at: zod.z.ZodISODateTime;
+        status: zod.ZodEnum<{
+            void: "void";
+            issued: "issued";
+        }>;
+        voided_at: zod.ZodNullable<zod.z.ZodISODateTime>;
+        unpaid_amount: zod.ZodString;
+        paid_amount: zod.ZodString;
+        refund_id: zod.ZodNullable<zod.ZodUUID>;
+    }, zod.z.core.$strict>>;
+    pagination: zod.ZodObject<{
+        page: zod.ZodInt;
+        page_size: zod.ZodInt;
+        total_count: zod.ZodOptional<zod.ZodInt>;
+    }, zod.z.core.$strict>;
+}, zod.z.core.$strict>;
+export type CreditNoteList = zod.input<typeof CreditNoteList>;
+export type CreditNoteListOutput = zod.output<typeof CreditNoteList>;

package/dist/billing/v1/generated/validators/creditNoteList.zod.js

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { CreditNote } from "./creditNote.zod.js";
+import { OffsetPagination } from "./offsetPagination.zod.js";
+export const CreditNoteList = zod.strictObject({
+    items: zod.array(CreditNote),
+    pagination: OffsetPagination,
+});

package/dist/billing/v1/generated/validators/invoice.zod.d.ts

@@ -44,6 +44,8 @@ export declare const Invoice: zod.ZodObject<{
     credit_applied: zod.ZodOptional<zod.ZodString>;
     total: zod.ZodString;
     amount_paid: zod.ZodOptional<zod.ZodString>;
+    unpaid_credit_notes_amount: zod.ZodString;
+    paid_credit_notes_amount: zod.ZodString;
     amount_due: zod.ZodString;
     period_start: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
     period_end: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;

package/dist/billing/v1/generated/validators/invoice.zod.js

@@ -32,7 +32,9 @@ export const Invoice = zod.strictObject({
     credit_applied: Money.optional().describe("Successful credit-grant payments included in amount_paid. Does not reduce the receivable or tax base."),
     total: Money.describe("Subtotal less discount plus tax. Balance and credit grants are payment sources, not reductions of the receivable."),
     amount_paid: Money.optional(),
-    amount_due: Money.describe("What is still collectible after applied credits and successful payments; never below zero. A draft order invoice is not collectible until checkout confirms it, and a paid or void invoice has none."),
+    unpaid_credit_notes_amount: Money.describe("Issued, non-void credit notes that reduced unpaid receivables. Does not rewrite the original invoice total."),
+    paid_credit_notes_amount: Money.describe("Issued credit notes against payments already received. This is a return obligation, not evidence of completed refunds."),
+    amount_due: Money.describe("What is still collectible after unpaid credit notes and successful payments; never below zero. A draft order invoice is not collectible until checkout confirms it, and a paid or void invoice has none."),
     period_start: zod.iso.datetime({ offset: true }).nullish(),
     period_end: zod.iso.datetime({ offset: true }).nullish().describe("Exclusive."),
     customer_name: zod

package/dist/billing/v1/generated/validators/invoiceList.zod.d.ts

@@ -45,6 +45,8 @@ export declare const InvoiceList: zod.ZodObject<{
         credit_applied: zod.ZodOptional<zod.ZodString>;
         total: zod.ZodString;
         amount_paid: zod.ZodOptional<zod.ZodString>;
+        unpaid_credit_notes_amount: zod.ZodString;
+        paid_credit_notes_amount: zod.ZodString;
         amount_due: zod.ZodString;
         period_start: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
         period_end: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;

package/dist/billing/v1/generated/validators/invoiceSummary.zod.d.ts

@@ -24,6 +24,8 @@ export declare const InvoiceSummary: zod.ZodObject<{
     tax_amount: zod.ZodString;
     total: zod.ZodString;
     amount_paid: zod.ZodString;
+    unpaid_credit_notes_amount: zod.ZodString;
+    paid_credit_notes_amount: zod.ZodString;
     amount_due: zod.ZodString;
     amount_refunded: zod.ZodString;
     due_at: zod.ZodOptional<zod.z.ZodISODateTime>;

package/dist/billing/v1/generated/validators/invoiceSummary.zod.js

@@ -7,6 +7,7 @@
  */
 import * as zod from "zod";
 import { InvoiceStatus } from "./invoiceStatus.zod.js";
+import { Money } from "./money.zod.js";
 export const invoiceSummaryAmountDueRegExp = new RegExp("^\\d+(\\.\\d{1,10})?$");
 export const InvoiceSummary = zod
     .strictObject({
@@ -21,10 +22,12 @@ export const InvoiceSummary = zod
     tax_amount: zod.string(),
     total: zod.string(),
     amount_paid: zod.string(),
+    unpaid_credit_notes_amount: Money.describe("Issued, non-void credit notes that reduced unpaid receivables. Does not rewrite the original invoice total."),
+    paid_credit_notes_amount: Money.describe("Issued credit notes against payments already received. This is a return obligation, not evidence of completed refunds."),
     amount_due: zod
         .string()
         .regex(invoiceSummaryAmountDueRegExp)
-        .describe("What is still collectible after applied credits and successful payments; never below zero."),
+        .describe("What is still collectible after unpaid credit notes and successful payments; never below zero."),
     amount_refunded: zod.string(),
     due_at: zod.iso.datetime({ offset: true }).optional(),
 })

package/dist/billing/v1/generated/validators/listCreditNoteItemsParams.zod.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const listCreditNoteItemsParamsPageDefault = 1;
+export declare const listCreditNoteItemsParamsPageMax = 2147483647;
+export declare const listCreditNoteItemsParamsPageSizeDefault = 50;
+export declare const listCreditNoteItemsParamsPageSizeMax = 200;
+export declare const ListCreditNoteItemsParams: zod.ZodObject<{
+    page: zod.ZodDefault<zod.ZodInt>;
+    page_size: zod.ZodDefault<zod.ZodInt>;
+}, zod.z.core.$strict>;
+export type ListCreditNoteItemsParams = zod.input<typeof ListCreditNoteItemsParams>;
+export type ListCreditNoteItemsParamsOutput = zod.output<typeof ListCreditNoteItemsParams>;

package/dist/billing/v1/generated/validators/listCreditNoteItemsParams.zod.js

@@ -0,0 +1,24 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export const listCreditNoteItemsParamsPageDefault = 1;
+export const listCreditNoteItemsParamsPageMax = 2147483647;
+export const listCreditNoteItemsParamsPageSizeDefault = 50;
+export const listCreditNoteItemsParamsPageSizeMax = 200;
+export const ListCreditNoteItemsParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listCreditNoteItemsParamsPageMax)
+        .default(listCreditNoteItemsParamsPageDefault),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listCreditNoteItemsParamsPageSizeMax)
+        .default(listCreditNoteItemsParamsPageSizeDefault),
+});

package/dist/billing/v1/generated/validators/listCreditNotesParams.zod.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const listCreditNotesParamsPageDefault = 1;
+export declare const listCreditNotesParamsPageMax = 2147483647;
+export declare const listCreditNotesParamsPageSizeDefault = 50;
+export declare const listCreditNotesParamsPageSizeMax = 200;
+export declare const ListCreditNotesParams: zod.ZodObject<{
+    page: zod.ZodDefault<zod.ZodInt>;
+    page_size: zod.ZodDefault<zod.ZodInt>;
+    billing_account_id: zod.ZodOptional<zod.ZodInt>;
+    invoice_id: zod.ZodOptional<zod.ZodUUID>;
+}, zod.z.core.$strict>;
+export type ListCreditNotesParams = zod.input<typeof ListCreditNotesParams>;
+export type ListCreditNotesParamsOutput = zod.output<typeof ListCreditNotesParams>;

package/dist/billing/v1/generated/validators/listCreditNotesParams.zod.js

@@ -0,0 +1,26 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export const listCreditNotesParamsPageDefault = 1;
+export const listCreditNotesParamsPageMax = 2147483647;
+export const listCreditNotesParamsPageSizeDefault = 50;
+export const listCreditNotesParamsPageSizeMax = 200;
+export const ListCreditNotesParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listCreditNotesParamsPageMax)
+        .default(listCreditNotesParamsPageDefault),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listCreditNotesParamsPageSizeMax)
+        .default(listCreditNotesParamsPageSizeDefault),
+    billing_account_id: zod.int().optional(),
+    invoice_id: zod.uuid().optional(),
+});

package/dist/billing/v1/generated/validators/order.zod.d.ts

@@ -32,6 +32,8 @@ export declare const Order: zod.ZodObject<{
         tax_amount: zod.ZodString;
         total: zod.ZodString;
         amount_paid: zod.ZodString;
+        unpaid_credit_notes_amount: zod.ZodString;
+        paid_credit_notes_amount: zod.ZodString;
         amount_due: zod.ZodString;
         amount_refunded: zod.ZodString;
         due_at: zod.ZodOptional<zod.z.ZodISODateTime>;
@@ -48,7 +50,6 @@ export declare const Order: zod.ZodObject<{
         name: zod.ZodString;
         currency: zod.ZodString;
     }, zod.z.core.$strict>>;
-    cancel_reason: zod.ZodOptional<zod.ZodString>;
     change_effective_at: zod.ZodOptional<zod.z.ZodISODateTime>;
     id: zod.ZodUUID;
     project_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;

package/dist/billing/v1/generated/validators/order.zod.js

@@ -25,7 +25,6 @@ export const Order = zod
     invoice: InvoiceSummary.optional(),
     paid_with: PaidWith.optional().describe("How the order was paid. Absent until it is paid."),
     account: AccountIdentity.optional(),
-    cancel_reason: zod.string().optional(),
     change_effective_at: zod.iso.datetime({ offset: true }).optional(),
     id: zod.uuid(),
     project_id: zod

package/dist/billing/v1/generated/validators/orderCancel.zod.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const orderCancelOrderItemIdsMax = 100;
+export declare const OrderCancel: zod.ZodObject<{
+    order_item_ids: zod.ZodOptional<zod.ZodArray<zod.ZodUUID>>;
+}, zod.z.core.$strict>;
+export type OrderCancel = zod.input<typeof OrderCancel>;
+export type OrderCancelOutput = zod.output<typeof OrderCancel>;

package/dist/billing/v1/generated/validators/orderCancel.zod.js

@@ -0,0 +1,17 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export const orderCancelOrderItemIdsMax = 100;
+export const OrderCancel = zod.strictObject({
+    order_item_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(orderCancelOrderItemIdsMax)
+        .optional()
+        .describe("Omit to select all still-pending items. Explicit selections name one or more items of this order; successful items cannot be reversed here."),
+});

package/dist/billing/v1/generated/validators/orderList.zod.d.ts

@@ -33,6 +33,8 @@ export declare const OrderList: zod.ZodObject<{
             tax_amount: zod.ZodString;
             total: zod.ZodString;
             amount_paid: zod.ZodString;
+            unpaid_credit_notes_amount: zod.ZodString;
+            paid_credit_notes_amount: zod.ZodString;
             amount_due: zod.ZodString;
             amount_refunded: zod.ZodString;
             due_at: zod.ZodOptional<zod.z.ZodISODateTime>;
@@ -49,7 +51,6 @@ export declare const OrderList: zod.ZodObject<{
             name: zod.ZodString;
             currency: zod.ZodString;
         }, zod.z.core.$strict>>;
-        cancel_reason: zod.ZodOptional<zod.ZodString>;
         change_effective_at: zod.ZodOptional<zod.z.ZodISODateTime>;
         id: zod.ZodUUID;
         project_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;

package/dist/routes.d.ts

@@ -1,4 +1,28 @@
 export declare const routes: readonly [{
+    readonly service: "billing";
+    readonly contract: "billing";
+    readonly method: "GET";
+    readonly path: "/api/v1/credit-notes";
+    readonly operationId: "list-credit-notes";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://billing.leaflow.cloud";
+}, {
+    readonly service: "billing";
+    readonly contract: "billing";
+    readonly method: "GET";
+    readonly path: "/api/v1/credit-notes/{creditNoteId}";
+    readonly operationId: "get-credit-note";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://billing.leaflow.cloud";
+}, {
+    readonly service: "billing";
+    readonly contract: "billing";
+    readonly method: "GET";
+    readonly path: "/api/v1/credit-notes/{creditNoteId}/items";
+    readonly operationId: "list-credit-note-items";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://billing.leaflow.cloud";
+}, {
     readonly service: "account";
     readonly contract: "account";
     readonly method: "GET";

package/dist/routes.js

@@ -1,5 +1,32 @@
 // Static contract routing and authentication facts for frontend gateways.
 export const routes = [
+    {
+        service: "billing",
+        contract: "billing",
+        method: "GET",
+        path: "/api/v1/credit-notes",
+        operationId: "list-credit-notes",
+        securityScheme: "AccessToken",
+        upstreamUrl: "https://billing.leaflow.cloud",
+    },
+    {
+        service: "billing",
+        contract: "billing",
+        method: "GET",
+        path: "/api/v1/credit-notes/{creditNoteId}",
+        operationId: "get-credit-note",
+        securityScheme: "AccessToken",
+        upstreamUrl: "https://billing.leaflow.cloud",
+    },
+    {
+        service: "billing",
+        contract: "billing",
+        method: "GET",
+        path: "/api/v1/credit-notes/{creditNoteId}/items",
+        operationId: "list-credit-note-items",
+        securityScheme: "AccessToken",
+        upstreamUrl: "https://billing.leaflow.cloud",
+    },
     {
         service: "account",
         contract: "account",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leaflow/sdk",
-  "version": "0.109.0",
+  "version": "0.110.0",
   "description": "Leaflow 平台 API 的 TypeScript SDK",
   "license": "MIT",
   "repository": {