@revkeen/sdk 1.20260312.41

package/api/resources/invoices/client/Client.js

@@ -0,0 +1,964 @@
+// This file was auto-generated by Fern from our API Definition.
+import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.js";
+import { mergeHeaders } from "../../../../core/headers.js";
+import * as core from "../../../../core/index.js";
+import * as environments from "../../../../environments.js";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.js";
+import * as errors from "../../../../errors/index.js";
+import * as RevKeen from "../../../index.js";
+/**
+ * Create, send, and manage invoices. Track payment status and send reminders.
+ *
+ * **Required Scopes:**
+ * - `invoices:read` - List and retrieve invoices
+ * - `invoices:write` - Create, update, send, finalize invoices
+ *
+ * **MCP Tools:** `invoices_list`, `invoices_get`, `invoices_create`, `invoices_send`, `invoices_finalize`
+ */
+export class InvoicesClient {
+    constructor(options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * Create or update multiple invoices by external system ID. Supports up to 100 invoices per request with stale update protection and immutable field guardrails.
+     *
+     * @param {RevKeen.InvoicesExternalBatchRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     * @throws {@link RevKeen.UnauthorizedError}
+     * @throws {@link RevKeen.ForbiddenError}
+     *
+     * @example
+     *     await client.invoices.externalbatch({
+     *         source: "practicehub",
+     *         invoices: [{
+     *                 external_id: "INV-12345"
+     *             }]
+     *     })
+     */
+    externalbatch(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__externalbatch(request, requestOptions));
+    }
+    async __externalbatch(request, requestOptions) {
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, "invoices/external/batch"),
+            method: "PUT",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: request,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: _response.body,
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new RevKeen.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new RevKeen.ForbiddenError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "PUT", "/invoices/external/batch");
+    }
+    /**
+     * List invoices with pagination and filtering.
+     *
+     * @param {RevKeen.InvoicesListRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.invoices.list()
+     */
+    list(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
+    }
+    async __list(request = {}, requestOptions) {
+        const { status, customerId, limit, offset } = request;
+        const _queryParams = {
+            status,
+            customerId,
+            limit,
+            offset,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, "invoices"),
+            method: "GET",
+            headers: _headers,
+            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            throw new errors.RevKeenError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/invoices");
+    }
+    /**
+     * Create a new invoice.
+     *
+     * @param {RevKeen.InvoicesCreateRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.invoices.create({
+     *         customer_uuid: "customer_uuid",
+     *         total_minor: 1
+     *     })
+     */
+    create(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
+    }
+    async __create(request, requestOptions) {
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, "invoices"),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: request,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            throw new errors.RevKeenError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/invoices");
+    }
+    /**
+     * Get a single invoice by ID.
+     *
+     * @param {RevKeen.InvoicesRetrieveRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.invoices.retrieve({
+     *         id: "id"
+     *     })
+     */
+    retrieve(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__retrieve(request, requestOptions));
+    }
+    async __retrieve(request, requestOptions) {
+        const { id } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}`),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            throw new errors.RevKeenError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/invoices/{id}");
+    }
+    /**
+     * Delete an invoice.
+     *
+     * @param {RevKeen.InvoicesDeleteRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.invoices.delete({
+     *         id: "id"
+     *     })
+     */
+    delete(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__delete(request, requestOptions));
+    }
+    async __delete(request, requestOptions) {
+        const { id } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}`),
+            method: "DELETE",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            throw new errors.RevKeenError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "DELETE", "/invoices/{id}");
+    }
+    /**
+     * Update an existing invoice.
+     *
+     * @param {RevKeen.InvoicesUpdateRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.invoices.update({
+     *         id: "id"
+     *     })
+     */
+    update(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__update(request, requestOptions));
+    }
+    async __update(request, requestOptions) {
+        const { id, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}`),
+            method: "PATCH",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            throw new errors.RevKeenError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "PATCH", "/invoices/{id}");
+    }
+    /**
+     * Issue a full or partial refund for a paid invoice. Emits invoice.refunded notification to customer.
+     *
+     * @param {RevKeen.InvoicesRefundRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     *
+     * @example
+     *     await client.invoices.refund({
+     *         id: "id"
+     *     })
+     */
+    refund(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__refund(request, requestOptions));
+    }
+    async __refund(request, requestOptions) {
+        const { id, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}/refund`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/invoices/{id}/refund");
+    }
+    /**
+     * Reject an invoice during approval workflow. Returns invoice to draft status with rejection details.
+     *
+     * @param {RevKeen.InvoicesRejectRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     *
+     * @example
+     *     await client.invoices.reject({
+     *         id: "id",
+     *         reason: "Invoice totals do not match purchase order"
+     *     })
+     */
+    reject(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__reject(request, requestOptions));
+    }
+    async __reject(request, requestOptions) {
+        const { id, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}/reject`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/invoices/{id}/reject");
+    }
+    /**
+     * List comments for an invoice. Use includeInternal=true to include internal comments (merchant only).
+     *
+     * @param {RevKeen.InvoicesCommentsListRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.invoices.commentsList({
+     *         id: "id",
+     *         includeInternal: "false"
+     *     })
+     */
+    commentsList(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__commentsList(request, requestOptions));
+    }
+    async __commentsList(request, requestOptions) {
+        const { id, includeInternal } = request;
+        const _queryParams = {
+            includeInternal,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}/comments`),
+            method: "GET",
+            headers: _headers,
+            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: _response.body,
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            throw new errors.RevKeenError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/invoices/{id}/comments");
+    }
+    /**
+     * Add a comment to an invoice. Set isInternal to true for merchant-only comments.
+     *
+     * @param {RevKeen.InvoicesCommentsAddRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.invoices.commentsAdd({
+     *         id: "id",
+     *         content: "Payment reminder sent to customer"
+     *     })
+     */
+    commentsAdd(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__commentsAdd(request, requestOptions));
+    }
+    async __commentsAdd(request, requestOptions) {
+        const { id, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}/comments`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            throw new errors.RevKeenError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/invoices/{id}/comments");
+    }
+    /**
+     * Create or update an invoice identified by external source and ID. Used by integrations (PracticeHub, Wodify) to sync invoices.
+     *
+     * @param {RevKeen.InvoicesExternalUpsertByExternalIdRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     * @throws {@link RevKeen.ConflictError}
+     * @throws {@link RevKeen.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.invoices.externalUpsertbyexternalid({
+     *         source: "practicehub",
+     *         externalId: "INV-12345"
+     *     })
+     */
+    externalUpsertbyexternalid(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__externalUpsertbyexternalid(request, requestOptions));
+    }
+    async __externalUpsertbyexternalid(request, requestOptions) {
+        const { source, externalId, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/external/${core.url.encodePathParam(source)}/${core.url.encodePathParam(externalId)}`),
+            method: "PUT",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: _response.body,
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new RevKeen.ConflictError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new RevKeen.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "PUT", "/invoices/external/{source}/{externalId}");
+    }
+    /**
+     * Finalizes a draft invoice, locking it for payment. Assigns invoice number and generates public token. After finalization, financial fields become immutable.
+     *
+     * @param {RevKeen.InvoicesFinalizeRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     * @throws {@link RevKeen.NotFoundError}
+     *
+     * @example
+     *     await client.invoices.finalize({
+     *         id: "id"
+     *     })
+     */
+    finalize(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__finalize(request, requestOptions));
+    }
+    async __finalize(request, requestOptions) {
+        const { id, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}/finalize`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/invoices/{id}/finalize");
+    }
+    /**
+     * Voids an invoice. Only invoices without recorded payments can be voided. Use refund instead for paid invoices.
+     *
+     * @param {RevKeen.InvoicesVoidRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     * @throws {@link RevKeen.NotFoundError}
+     *
+     * @example
+     *     await client.invoices.void({
+     *         id: "id"
+     *     })
+     */
+    void(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__void(request, requestOptions));
+    }
+    async __void(request, requestOptions) {
+        const { id, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}/void`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/invoices/{id}/void");
+    }
+    /**
+     * Sends an invoice to the customer via the specified channel (email, SMS, or WhatsApp). Invoice must be approved first.
+     *
+     * @param {RevKeen.InvoicesSendRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     * @throws {@link RevKeen.NotFoundError}
+     *
+     * @example
+     *     await client.invoices.send({
+     *         id: "id"
+     *     })
+     */
+    send(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__send(request, requestOptions));
+    }
+    async __send(request, requestOptions) {
+        const { id, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}/send`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/invoices/{id}/send");
+    }
+    /**
+     * Records a manual payment against an invoice. Use this for cash, check, bank transfer, or other offline payments.
+     *
+     * @param {RevKeen.InvoicesPayRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     * @throws {@link RevKeen.NotFoundError}
+     *
+     * @example
+     *     await client.invoices.pay({
+     *         id: "id"
+     *     })
+     */
+    pay(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__pay(request, requestOptions));
+    }
+    async __pay(request, requestOptions) {
+        const { id, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}/pay`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/invoices/{id}/pay");
+    }
+    /**
+     * Check if an invoice is eligible for credit notes and get the maximum creditable amount.
+     *
+     * @param {RevKeen.InvoicesCreditEligibilityRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.NotFoundError}
+     *
+     * @example
+     *     await client.invoices.creditEligibility({
+     *         id: "id"
+     *     })
+     */
+    creditEligibility(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__creditEligibility(request, requestOptions));
+    }
+    async __creditEligibility(request, requestOptions) {
+        const { id } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}/credit-eligibility`),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/invoices/{id}/credit-eligibility");
+    }
+    /**
+     * List all credit notes issued for an invoice.
+     *
+     * @param {RevKeen.InvoicesCreditNotesListRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.NotFoundError}
+     *
+     * @example
+     *     await client.invoices.creditNotesList({
+     *         id: "id"
+     *     })
+     */
+    creditNotesList(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__creditNotesList(request, requestOptions));
+    }
+    async __creditNotesList(request, requestOptions) {
+        const { id } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}/credit-notes`),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/invoices/{id}/credit-notes");
+    }
+    /**
+     * Issue a credit note for a paid or partially paid invoice. Use this instead of void for invoices that have received payment.
+     *
+     * @param {RevKeen.InvoicesCreditNoteIssueRequest} request
+     * @param {InvoicesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     * @throws {@link RevKeen.NotFoundError}
+     * @throws {@link RevKeen.ConflictError}
+     *
+     * @example
+     *     await client.invoices.creditNoteIssue({
+     *         id: "id",
+     *         amount_minor: 5000,
+     *         reason: "Service issue - partial refund for outage"
+     *     })
+     */
+    creditNoteIssue(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__creditNoteIssue(request, requestOptions));
+    }
+    async __creditNoteIssue(request, requestOptions) {
+        const { id, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.RevKeenEnvironment.Default, `invoices/${core.url.encodePathParam(id)}/credit-note`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new RevKeen.ConflictError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/invoices/{id}/credit-note");
+    }
+}
+//# sourceMappingURL=Client.js.map