@spaceinvoices/js-sdk 12.42.0 → 12.43.0

package/dist/generated/expenses/expenses.d.cts

@@ -5,7 +5,7 @@
  * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
  * OpenAPI spec version: 1.0.0
  */
-import type { CreateExpenseBody, CreateExpensePaymentBody, CreateExpenseRecognitionBody, CustomExpenseWrite, Error, Expense, ExpenseCategoryReportResponse, ExpenseDuplicateConflictError, ExpenseRecognitionBackfill, ExpenseRecognitionBackfillResponse, ExpenseRecognitionCreateResponse, ExpenseRecognitionJob, ExpenseRecognitionLookupResponse, ExpenseRecognitionSettingsResponse, ExportExpensesParams, FileMetadata, GetExpenseAttachments200, GetExpenseAttachmentsParams, GetExpenseCategoryReportParams, GetExpensePayments200, GetExpenses200, GetExpensesParams, IdempotencyError, Payment, UpdateExpenseBody, UpdateExpenseRecognitionSettings, UploadExpenseAttachmentBody, ValidationError } from '../model/index.cjs';
+import type { CreateExpenseBody, CreateExpensePaymentBody, CreateExpenseRecognitionBody, CustomExpenseWrite, Error, Expense, ExpenseCategoryReportResponse, ExpenseDuplicateConflictError, ExpensePaymentOpenBalanceError, ExpenseRecognitionBackfill, ExpenseRecognitionBackfillResponse, ExpenseRecognitionCreateResponse, ExpenseRecognitionJob, ExpenseRecognitionLookupResponse, ExpenseRecognitionSettingsResponse, ExportExpensesParams, FileMetadata, GetExpenseAttachments200, GetExpenseAttachmentsParams, GetExpenseCategoryReportParams, GetExpensePayments200, GetExpenses200, GetExpensesParams, IdempotencyError, Payment, UpdateExpenseBody, UpdateExpenseRecognitionSettings, UploadExpenseAttachmentBody, ValidationError } from '../model/index.cjs';
 /**
  * This is the recommended endpoint for normal expense creation. Use it when Space Invoices should validate the supplied totals, tax summaries, and line items, then apply supplier handling, payment tracking initialization, and lifecycle rules.
  * @summary Create expense
@@ -35,7 +35,7 @@ export type createExpenseResponse409 = {
     status: 409;
 };
 export type createExpenseResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type createExpenseResponse500 = {
@@ -124,7 +124,7 @@ export type createCustomExpenseResponse409 = {
     status: 409;
 };
 export type createCustomExpenseResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type createCustomExpenseResponse500 = {
@@ -896,6 +896,7 @@ export type getExpensePaymentsResponse = (getExpensePaymentsResponseSuccess | ge
 export declare const getGetExpensePaymentsUrl: (id: string) => string;
 export declare const getExpensePayments: (id: string, options?: RequestInit) => Promise<getExpensePaymentsResponse>;
 /**
+ * Record a direct payment against a finalized supplier invoice expense. The payment is capped at the expense's open balance (total_with_tax minus the payments already recorded), compared at the currency's minor unit (0.01 EUR, 1 JPY, 0.001 KWD). A payment that would exceed it returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and records nothing. Concurrent payments on one expense are serialized, so they can never together exceed its total.
  * @summary Create a payment for an expense
  */
 export type createExpensePaymentResponse201 = {
@@ -923,7 +924,7 @@ export type createExpensePaymentResponse409 = {
     status: 409;
 };
 export type createExpensePaymentResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type createExpensePaymentResponse500 = {

package/dist/generated/expenses/expenses.d.ts

@@ -5,7 +5,7 @@
  * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
  * OpenAPI spec version: 1.0.0
  */
-import type { CreateExpenseBody, CreateExpensePaymentBody, CreateExpenseRecognitionBody, CustomExpenseWrite, Error, Expense, ExpenseCategoryReportResponse, ExpenseDuplicateConflictError, ExpenseRecognitionBackfill, ExpenseRecognitionBackfillResponse, ExpenseRecognitionCreateResponse, ExpenseRecognitionJob, ExpenseRecognitionLookupResponse, ExpenseRecognitionSettingsResponse, ExportExpensesParams, FileMetadata, GetExpenseAttachments200, GetExpenseAttachmentsParams, GetExpenseCategoryReportParams, GetExpensePayments200, GetExpenses200, GetExpensesParams, IdempotencyError, Payment, UpdateExpenseBody, UpdateExpenseRecognitionSettings, UploadExpenseAttachmentBody, ValidationError } from '../model/index.js';
+import type { CreateExpenseBody, CreateExpensePaymentBody, CreateExpenseRecognitionBody, CustomExpenseWrite, Error, Expense, ExpenseCategoryReportResponse, ExpenseDuplicateConflictError, ExpensePaymentOpenBalanceError, ExpenseRecognitionBackfill, ExpenseRecognitionBackfillResponse, ExpenseRecognitionCreateResponse, ExpenseRecognitionJob, ExpenseRecognitionLookupResponse, ExpenseRecognitionSettingsResponse, ExportExpensesParams, FileMetadata, GetExpenseAttachments200, GetExpenseAttachmentsParams, GetExpenseCategoryReportParams, GetExpensePayments200, GetExpenses200, GetExpensesParams, IdempotencyError, Payment, UpdateExpenseBody, UpdateExpenseRecognitionSettings, UploadExpenseAttachmentBody, ValidationError } from '../model/index.js';
 /**
  * This is the recommended endpoint for normal expense creation. Use it when Space Invoices should validate the supplied totals, tax summaries, and line items, then apply supplier handling, payment tracking initialization, and lifecycle rules.
  * @summary Create expense
@@ -35,7 +35,7 @@ export type createExpenseResponse409 = {
     status: 409;
 };
 export type createExpenseResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type createExpenseResponse500 = {
@@ -124,7 +124,7 @@ export type createCustomExpenseResponse409 = {
     status: 409;
 };
 export type createCustomExpenseResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type createCustomExpenseResponse500 = {
@@ -896,6 +896,7 @@ export type getExpensePaymentsResponse = (getExpensePaymentsResponseSuccess | ge
 export declare const getGetExpensePaymentsUrl: (id: string) => string;
 export declare const getExpensePayments: (id: string, options?: RequestInit) => Promise<getExpensePaymentsResponse>;
 /**
+ * Record a direct payment against a finalized supplier invoice expense. The payment is capped at the expense's open balance (total_with_tax minus the payments already recorded), compared at the currency's minor unit (0.01 EUR, 1 JPY, 0.001 KWD). A payment that would exceed it returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and records nothing. Concurrent payments on one expense are serialized, so they can never together exceed its total.
  * @summary Create a payment for an expense
  */
 export type createExpensePaymentResponse201 = {
@@ -923,7 +924,7 @@ export type createExpensePaymentResponse409 = {
     status: 409;
 };
 export type createExpensePaymentResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type createExpensePaymentResponse500 = {

package/dist/generated/model/createExpenseBody.d.cts

@@ -91,7 +91,7 @@ export type CreateExpenseBody = {
      */
     expected_total_with_tax?: number | null;
     /**
-     * Optional payments to record with the expense. If amounts are omitted, the remaining total_with_tax is split equally. Automatically updates expense payment status.
+     * Optional payments to record with the expense. If amounts are omitted, the remaining total_with_tax is split equally. Explicit amounts together may not exceed total_with_tax; otherwise the request returns 422 with `cause.code` `expense_payment_exceeds_open_balance` and creates nothing. Automatically updates expense payment status.
      * @nullable
      */
     payments?: CreateExpenseBodyPaymentsItem[] | null;

package/dist/generated/model/createExpenseBody.d.ts

@@ -91,7 +91,7 @@ export type CreateExpenseBody = {
      */
     expected_total_with_tax?: number | null;
     /**
-     * Optional payments to record with the expense. If amounts are omitted, the remaining total_with_tax is split equally. Automatically updates expense payment status.
+     * Optional payments to record with the expense. If amounts are omitted, the remaining total_with_tax is split equally. Explicit amounts together may not exceed total_with_tax; otherwise the request returns 422 with `cause.code` `expense_payment_exceeds_open_balance` and creates nothing. Automatically updates expense payment status.
      * @nullable
      */
     payments?: CreateExpenseBodyPaymentsItem[] | null;

package/dist/generated/model/customExpenseWrite.d.cts

@@ -88,7 +88,7 @@ export interface CustomExpenseWrite {
      */
     expected_total_with_tax?: number | null;
     /**
-     * Optional payments to record with the expense. If amounts are omitted, the remaining total_with_tax is split equally. Automatically updates expense payment status.
+     * Optional payments to record with the expense. If amounts are omitted, the remaining total_with_tax is split equally. Explicit amounts together may not exceed total_with_tax; otherwise the request returns 422 with `cause.code` `expense_payment_exceeds_open_balance` and creates nothing. Automatically updates expense payment status.
      * @nullable
      */
     payments?: CustomExpenseWritePaymentsItem[] | null;

package/dist/generated/model/customExpenseWrite.d.ts

@@ -88,7 +88,7 @@ export interface CustomExpenseWrite {
      */
     expected_total_with_tax?: number | null;
     /**
-     * Optional payments to record with the expense. If amounts are omitted, the remaining total_with_tax is split equally. Automatically updates expense payment status.
+     * Optional payments to record with the expense. If amounts are omitted, the remaining total_with_tax is split equally. Explicit amounts together may not exceed total_with_tax; otherwise the request returns 422 with `cause.code` `expense_payment_exceeds_open_balance` and creates nothing. Automatically updates expense payment status.
      * @nullable
      */
     payments?: CustomExpenseWritePaymentsItem[] | null;

package/dist/generated/model/expensePaymentOpenBalanceError.d.cts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v8.5.3 🍺
+ * Do not edit manually.
+ * Space Invoices API
+ * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
+ * OpenAPI spec version: 1.0.0
+ */
+import type { Error } from './error.cjs';
+import type { ExpensePaymentOpenBalanceErrorCause } from './expensePaymentOpenBalanceErrorCause.cjs';
+/**
+ * An expense payment would exceed the expense's open balance by at least half of the currency's minor unit (0.01 EUR, 1 JPY, 0.001 KWD). Nothing was recorded.
+ */
+export type ExpensePaymentOpenBalanceError = Error & {
+    cause: ExpensePaymentOpenBalanceErrorCause;
+};

package/dist/generated/model/expensePaymentOpenBalanceError.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v8.5.3 🍺
+ * Do not edit manually.
+ * Space Invoices API
+ * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
+ * OpenAPI spec version: 1.0.0
+ */
+import type { Error } from './error.js';
+import type { ExpensePaymentOpenBalanceErrorCause } from './expensePaymentOpenBalanceErrorCause.js';
+/**
+ * An expense payment would exceed the expense's open balance by at least half of the currency's minor unit (0.01 EUR, 1 JPY, 0.001 KWD). Nothing was recorded.
+ */
+export type ExpensePaymentOpenBalanceError = Error & {
+    cause: ExpensePaymentOpenBalanceErrorCause;
+};

package/dist/generated/model/expensePaymentOpenBalanceErrorCause.d.cts

@@ -0,0 +1,27 @@
+/**
+ * Generated by orval v8.5.3 🍺
+ * Do not edit manually.
+ * Space Invoices API
+ * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
+ * OpenAPI spec version: 1.0.0
+ */
+import type { ExpensePaymentOpenBalanceErrorCauseCode } from './expensePaymentOpenBalanceErrorCauseCode.cjs';
+export type ExpensePaymentOpenBalanceErrorCause = {
+    code: ExpensePaymentOpenBalanceErrorCauseCode;
+    /**
+     * The expense the payment is for; null when the expense was being created in the same request.
+     * @nullable
+     */
+    expense_id: string | null;
+    /**
+     * Currency of the expense and its payments.
+     * @nullable
+     */
+    currency_code: string | null;
+    /** The requested payment amount as sent, in the expense currency's major unit (for inline payments on expense create, their sum). */
+    amount: number;
+    /** The largest amount at the currency's minor-unit precision that this payment can have. When it is above zero, retrying with it is accepted; zero means no whole minor unit can be recorded. It is based on the open balance for a new or restored payment, and on the open balance plus the payment's current amount for an amount edit. */
+    max_amount: number;
+    /** The expense's open balance (total_with_tax minus the payments already recorded) at the currency's minor-unit precision, never negative. */
+    open_balance: number;
+};

package/dist/generated/model/expensePaymentOpenBalanceErrorCause.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Generated by orval v8.5.3 🍺
+ * Do not edit manually.
+ * Space Invoices API
+ * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
+ * OpenAPI spec version: 1.0.0
+ */
+import type { ExpensePaymentOpenBalanceErrorCauseCode } from './expensePaymentOpenBalanceErrorCauseCode.js';
+export type ExpensePaymentOpenBalanceErrorCause = {
+    code: ExpensePaymentOpenBalanceErrorCauseCode;
+    /**
+     * The expense the payment is for; null when the expense was being created in the same request.
+     * @nullable
+     */
+    expense_id: string | null;
+    /**
+     * Currency of the expense and its payments.
+     * @nullable
+     */
+    currency_code: string | null;
+    /** The requested payment amount as sent, in the expense currency's major unit (for inline payments on expense create, their sum). */
+    amount: number;
+    /** The largest amount at the currency's minor-unit precision that this payment can have. When it is above zero, retrying with it is accepted; zero means no whole minor unit can be recorded. It is based on the open balance for a new or restored payment, and on the open balance plus the payment's current amount for an amount edit. */
+    max_amount: number;
+    /** The expense's open balance (total_with_tax minus the payments already recorded) at the currency's minor-unit precision, never negative. */
+    open_balance: number;
+};

package/dist/generated/model/expensePaymentOpenBalanceErrorCauseCode.d.cts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v8.5.3 🍺
+ * Do not edit manually.
+ * Space Invoices API
+ * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
+ * OpenAPI spec version: 1.0.0
+ */
+export type ExpensePaymentOpenBalanceErrorCauseCode = typeof ExpensePaymentOpenBalanceErrorCauseCode[keyof typeof ExpensePaymentOpenBalanceErrorCauseCode];
+export declare const ExpensePaymentOpenBalanceErrorCauseCode: {
+    readonly expense_payment_exceeds_open_balance: "expense_payment_exceeds_open_balance";
+};

package/dist/generated/model/expensePaymentOpenBalanceErrorCauseCode.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v8.5.3 🍺
+ * Do not edit manually.
+ * Space Invoices API
+ * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
+ * OpenAPI spec version: 1.0.0
+ */
+export type ExpensePaymentOpenBalanceErrorCauseCode = typeof ExpensePaymentOpenBalanceErrorCauseCode[keyof typeof ExpensePaymentOpenBalanceErrorCauseCode];
+export declare const ExpensePaymentOpenBalanceErrorCauseCode: {
+    readonly expense_payment_exceeds_open_balance: "expense_payment_exceeds_open_balance";
+};

package/dist/generated/model/index.d.cts

@@ -570,6 +570,9 @@ export * from './expenseItemRecognitionMethod.cjs';
 export * from './expenseItemTranslations.cjs';
 export * from './expenseItemType.cjs';
 export * from './expenseMetadata.cjs';
+export * from './expensePaymentOpenBalanceError.cjs';
+export * from './expensePaymentOpenBalanceErrorCause.cjs';
+export * from './expensePaymentOpenBalanceErrorCauseCode.cjs';
 export * from './expenseRecognitionBackfill.cjs';
 export * from './expenseRecognitionBackfillResponse.cjs';
 export * from './expenseRecognitionCreateResponse.cjs';

package/dist/generated/model/index.d.ts

@@ -570,6 +570,9 @@ export * from './expenseItemRecognitionMethod.js';
 export * from './expenseItemTranslations.js';
 export * from './expenseItemType.js';
 export * from './expenseMetadata.js';
+export * from './expensePaymentOpenBalanceError.js';
+export * from './expensePaymentOpenBalanceErrorCause.js';
+export * from './expensePaymentOpenBalanceErrorCauseCode.js';
 export * from './expenseRecognitionBackfill.js';
 export * from './expenseRecognitionBackfillResponse.js';
 export * from './expenseRecognitionCreateResponse.js';

package/dist/generated/payments/payments.d.cts

@@ -5,7 +5,7 @@
  * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
  * OpenAPI spec version: 1.0.0
  */
-import type { CreatePaymentBody, Error, FiscalRecoveryError, GetPaymentByIdParams, GetPayments200, GetPaymentsParams, IdempotencyError, Payment, UpdatePaymentBody, ValidationError } from '../model/index.cjs';
+import type { CreatePaymentBody, Error, ExpensePaymentOpenBalanceError, FiscalRecoveryError, GetPaymentByIdParams, GetPayments200, GetPaymentsParams, IdempotencyError, Payment, UpdatePaymentBody, ValidationError } from '../model/index.cjs';
 /**
  * Record a payment against an outgoing document or a supplier expense.
 At least one document reference is required.
@@ -16,6 +16,7 @@ Expense payments support direct supplier invoice payments in V1; AP credit-note
 Document payment totals are automatically updated. Ordinary payments on invoices with linked advances atomically reduce the auto-applied advance amount so combined settlement never exceeds the invoice total.
 Credit note refunds or settlements cannot exceed the remaining credit balance.
 Draft advance invoices may accumulate payments up to their total and must be fully paid before they can be issued. Issued advance invoices must retain exact full payment coverage.
+Expense payments are capped at the expense's open balance (total_with_tax minus the payments already recorded), compared at the currency's minor unit (0.01 EUR, 1 JPY, 0.001 KWD). A payment that would exceed it returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and records nothing. Concurrent payments on one expense are serialized, so they can never together exceed its total.
  * @summary Create a new payment
  */
 export type createPaymentResponse201 = {
@@ -43,7 +44,7 @@ export type createPaymentResponse409 = {
     status: 409;
 };
 export type createPaymentResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type createPaymentResponse500 = {
@@ -140,6 +141,7 @@ Document references cannot be changed.
 If amount is changed, payment totals on all linked outgoing or incoming documents are automatically recalculated. Ordinary invoice payment increases atomically reduce any linked advance allocation.
 System-managed settlement payments cannot be modified.
 For active issued advance invoices, non-amount metadata may be updated, but amount changes must preserve exact full payment coverage.
+An expense payment's amount can be raised up to the expense's open balance plus the payment's current amount; a larger amount returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and leaves the payment unchanged. Lowering an amount is always allowed.
 
 Changing `type` on a payment attached to a fiscalized invoice is not a local edit — the payment method is part of what was reported, so the change is validated and, in Croatia, reported onward. A `422` carries a `cause.code` naming which rule applied:
 
@@ -176,7 +178,7 @@ export type updatePaymentResponse409 = {
     status: 409;
 };
 export type updatePaymentResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type updatePaymentResponse500 = {
@@ -238,7 +240,7 @@ export type deletePaymentResponse = (deletePaymentResponseSuccess | deletePaymen
 export declare const getDeletePaymentUrl: (id: string) => string;
 export declare const deletePayment: (id: string, options?: RequestInit) => Promise<deletePaymentResponse>;
 /**
- * Restore a soft-deleted payment from the trash. Document payment totals are automatically recalculated. Restoring an ordinary invoice payment atomically reduces any linked advance allocation when needed to keep combined settlement within the invoice total.
+ * Restore a soft-deleted payment from the trash. Document payment totals are automatically recalculated. Restoring an ordinary invoice payment atomically reduces any linked advance allocation when needed to keep combined settlement within the invoice total. A restored expense payment must fit the expense's open balance; otherwise the request returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and the payment stays deleted.
  * @summary Restore a deleted payment
  */
 export type restorePaymentResponse200 = {
@@ -262,7 +264,7 @@ export type restorePaymentResponse404 = {
     status: 404;
 };
 export type restorePaymentResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type restorePaymentResponse500 = {

package/dist/generated/payments/payments.d.ts

@@ -5,7 +5,7 @@
  * REST API for invoice management, customer management, and accounting operations. Features include cursor-based pagination for efficient data navigation, flexible JSON querying with MongoDB-style operators, full-text search across multiple fields, and comprehensive metadata support for custom tracking.
  * OpenAPI spec version: 1.0.0
  */
-import type { CreatePaymentBody, Error, FiscalRecoveryError, GetPaymentByIdParams, GetPayments200, GetPaymentsParams, IdempotencyError, Payment, UpdatePaymentBody, ValidationError } from '../model/index.js';
+import type { CreatePaymentBody, Error, ExpensePaymentOpenBalanceError, FiscalRecoveryError, GetPaymentByIdParams, GetPayments200, GetPaymentsParams, IdempotencyError, Payment, UpdatePaymentBody, ValidationError } from '../model/index.js';
 /**
  * Record a payment against an outgoing document or a supplier expense.
 At least one document reference is required.
@@ -16,6 +16,7 @@ Expense payments support direct supplier invoice payments in V1; AP credit-note
 Document payment totals are automatically updated. Ordinary payments on invoices with linked advances atomically reduce the auto-applied advance amount so combined settlement never exceeds the invoice total.
 Credit note refunds or settlements cannot exceed the remaining credit balance.
 Draft advance invoices may accumulate payments up to their total and must be fully paid before they can be issued. Issued advance invoices must retain exact full payment coverage.
+Expense payments are capped at the expense's open balance (total_with_tax minus the payments already recorded), compared at the currency's minor unit (0.01 EUR, 1 JPY, 0.001 KWD). A payment that would exceed it returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and records nothing. Concurrent payments on one expense are serialized, so they can never together exceed its total.
  * @summary Create a new payment
  */
 export type createPaymentResponse201 = {
@@ -43,7 +44,7 @@ export type createPaymentResponse409 = {
     status: 409;
 };
 export type createPaymentResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type createPaymentResponse500 = {
@@ -140,6 +141,7 @@ Document references cannot be changed.
 If amount is changed, payment totals on all linked outgoing or incoming documents are automatically recalculated. Ordinary invoice payment increases atomically reduce any linked advance allocation.
 System-managed settlement payments cannot be modified.
 For active issued advance invoices, non-amount metadata may be updated, but amount changes must preserve exact full payment coverage.
+An expense payment's amount can be raised up to the expense's open balance plus the payment's current amount; a larger amount returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and leaves the payment unchanged. Lowering an amount is always allowed.
 
 Changing `type` on a payment attached to a fiscalized invoice is not a local edit — the payment method is part of what was reported, so the change is validated and, in Croatia, reported onward. A `422` carries a `cause.code` naming which rule applied:
 
@@ -176,7 +178,7 @@ export type updatePaymentResponse409 = {
     status: 409;
 };
 export type updatePaymentResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type updatePaymentResponse500 = {
@@ -238,7 +240,7 @@ export type deletePaymentResponse = (deletePaymentResponseSuccess | deletePaymen
 export declare const getDeletePaymentUrl: (id: string) => string;
 export declare const deletePayment: (id: string, options?: RequestInit) => Promise<deletePaymentResponse>;
 /**
- * Restore a soft-deleted payment from the trash. Document payment totals are automatically recalculated. Restoring an ordinary invoice payment atomically reduces any linked advance allocation when needed to keep combined settlement within the invoice total.
+ * Restore a soft-deleted payment from the trash. Document payment totals are automatically recalculated. Restoring an ordinary invoice payment atomically reduces any linked advance allocation when needed to keep combined settlement within the invoice total. A restored expense payment must fit the expense's open balance; otherwise the request returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and the payment stays deleted.
  * @summary Restore a deleted payment
  */
 export type restorePaymentResponse200 = {
@@ -262,7 +264,7 @@ export type restorePaymentResponse404 = {
     status: 404;
 };
 export type restorePaymentResponse422 = {
-    data: ValidationError;
+    data: ExpensePaymentOpenBalanceError | ValidationError;
     status: 422;
 };
 export type restorePaymentResponse500 = {

package/dist/generated-zod/expenses/expenses.d.cts

@@ -2953,6 +2953,7 @@ export declare const GetExpensePaymentsResponse: zod.ZodObject<{
     }, zod.z.core.$strip>;
 }, zod.z.core.$strip>;
 /**
+ * Record a direct payment against a finalized supplier invoice expense. The payment is capped at the expense's open balance (total_with_tax minus the payments already recorded), compared at the currency's minor unit (0.01 EUR, 1 JPY, 0.001 KWD). A payment that would exceed it returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and records nothing. Concurrent payments on one expense are serialized, so they can never together exceed its total.
  * @summary Create a payment for an expense
  */
 export declare const CreateExpensePaymentParams: zod.ZodObject<{

package/dist/generated-zod/expenses/expenses.d.ts

@@ -2953,6 +2953,7 @@ export declare const GetExpensePaymentsResponse: zod.ZodObject<{
     }, zod.z.core.$strip>;
 }, zod.z.core.$strip>;
 /**
+ * Record a direct payment against a finalized supplier invoice expense. The payment is capped at the expense's open balance (total_with_tax minus the payments already recorded), compared at the currency's minor unit (0.01 EUR, 1 JPY, 0.001 KWD). A payment that would exceed it returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and records nothing. Concurrent payments on one expense are serialized, so they can never together exceed its total.
  * @summary Create a payment for an expense
  */
 export declare const CreateExpensePaymentParams: zod.ZodObject<{

package/dist/generated-zod/payments/payments.d.cts

@@ -16,6 +16,7 @@ Expense payments support direct supplier invoice payments in V1; AP credit-note
 Document payment totals are automatically updated. Ordinary payments on invoices with linked advances atomically reduce the auto-applied advance amount so combined settlement never exceeds the invoice total.
 Credit note refunds or settlements cannot exceed the remaining credit balance.
 Draft advance invoices may accumulate payments up to their total and must be fully paid before they can be issued. Issued advance invoices must retain exact full payment coverage.
+Expense payments are capped at the expense's open balance (total_with_tax minus the payments already recorded), compared at the currency's minor unit (0.01 EUR, 1 JPY, 0.001 KWD). A payment that would exceed it returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and records nothing. Concurrent payments on one expense are serialized, so they can never together exceed its total.
  * @summary Create a new payment
  */
 export declare const createPaymentHeaderXRequestIdMax = 100;
@@ -338,6 +339,7 @@ Document references cannot be changed.
 If amount is changed, payment totals on all linked outgoing or incoming documents are automatically recalculated. Ordinary invoice payment increases atomically reduce any linked advance allocation.
 System-managed settlement payments cannot be modified.
 For active issued advance invoices, non-amount metadata may be updated, but amount changes must preserve exact full payment coverage.
+An expense payment's amount can be raised up to the expense's open balance plus the payment's current amount; a larger amount returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and leaves the payment unchanged. Lowering an amount is always allowed.
 
 Changing `type` on a payment attached to a fiscalized invoice is not a local edit — the payment method is part of what was reported, so the change is validated and, in Croatia, reported onward. A `422` carries a `cause.code` naming which rule applied:
 
@@ -495,7 +497,7 @@ export declare const DeletePaymentHeader: zod.ZodObject<{
     "x-entity-id": zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strip>;
 /**
- * Restore a soft-deleted payment from the trash. Document payment totals are automatically recalculated. Restoring an ordinary invoice payment atomically reduces any linked advance allocation when needed to keep combined settlement within the invoice total.
+ * Restore a soft-deleted payment from the trash. Document payment totals are automatically recalculated. Restoring an ordinary invoice payment atomically reduces any linked advance allocation when needed to keep combined settlement within the invoice total. A restored expense payment must fit the expense's open balance; otherwise the request returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and the payment stays deleted.
  * @summary Restore a deleted payment
  */
 export declare const restorePaymentPathIdRegExp: RegExp;

package/dist/generated-zod/payments/payments.d.ts

@@ -16,6 +16,7 @@ Expense payments support direct supplier invoice payments in V1; AP credit-note
 Document payment totals are automatically updated. Ordinary payments on invoices with linked advances atomically reduce the auto-applied advance amount so combined settlement never exceeds the invoice total.
 Credit note refunds or settlements cannot exceed the remaining credit balance.
 Draft advance invoices may accumulate payments up to their total and must be fully paid before they can be issued. Issued advance invoices must retain exact full payment coverage.
+Expense payments are capped at the expense's open balance (total_with_tax minus the payments already recorded), compared at the currency's minor unit (0.01 EUR, 1 JPY, 0.001 KWD). A payment that would exceed it returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and records nothing. Concurrent payments on one expense are serialized, so they can never together exceed its total.
  * @summary Create a new payment
  */
 export declare const createPaymentHeaderXRequestIdMax = 100;
@@ -338,6 +339,7 @@ Document references cannot be changed.
 If amount is changed, payment totals on all linked outgoing or incoming documents are automatically recalculated. Ordinary invoice payment increases atomically reduce any linked advance allocation.
 System-managed settlement payments cannot be modified.
 For active issued advance invoices, non-amount metadata may be updated, but amount changes must preserve exact full payment coverage.
+An expense payment's amount can be raised up to the expense's open balance plus the payment's current amount; a larger amount returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and leaves the payment unchanged. Lowering an amount is always allowed.
 
 Changing `type` on a payment attached to a fiscalized invoice is not a local edit — the payment method is part of what was reported, so the change is validated and, in Croatia, reported onward. A `422` carries a `cause.code` naming which rule applied:
 
@@ -495,7 +497,7 @@ export declare const DeletePaymentHeader: zod.ZodObject<{
     "x-entity-id": zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strip>;
 /**
- * Restore a soft-deleted payment from the trash. Document payment totals are automatically recalculated. Restoring an ordinary invoice payment atomically reduces any linked advance allocation when needed to keep combined settlement within the invoice total.
+ * Restore a soft-deleted payment from the trash. Document payment totals are automatically recalculated. Restoring an ordinary invoice payment atomically reduces any linked advance allocation when needed to keep combined settlement within the invoice total. A restored expense payment must fit the expense's open balance; otherwise the request returns `422` with `cause.code` `expense_payment_exceeds_open_balance` and the payment stays deleted.
  * @summary Restore a deleted payment
  */
 export declare const restorePaymentPathIdRegExp: RegExp;