@erp-galoper/types 1.0.1934 → 1.0.1936

package/openapi.ts

@@ -616,6 +616,11 @@ export interface paths {
          *     Optional ``syncableOnlineItems``: standalone/template items only — same gate as
          *     ``should_attempt_product_sync_to_store`` on at least one active store; variants excluded.
          *
+         *     ``landedCostFilter`` controls landed cost service items (service items with a landed cost expense category):
+         *     - ``exclude`` (default): omit landed cost items from the list
+         *     - ``only``: return only landed cost service items
+         *     - ``include``: return every item
+         *
          *     Responses:
          *     - 200: ItemListSchema
          *     - 400: {"message": "Error applying filter {error}", "code": "invalidFilterFormat"}
@@ -12163,6 +12168,214 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/purchase/landed-cost-allocations/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Landed Cost Allocations
+         * @description List landed cost allocations (LCA) for the current branch.
+         *
+         *     **Headers:** `X-Current-Branch` (required)
+         *
+         *     **Query:** standard pagination (`page`, `pageSize`), grid `filters`, optional `search`.
+         *
+         *     **Permission key:** `landedcostallocation = [ view ]`
+         *
+         *     ### Responses
+         *     - **200**: LandedCostAllocationListSchema
+         *     - **400**: invalidFilterFormat, paginationError
+         *     - **403**: permissionDenied, noModuleAccess, noBranchAccess
+         */
+        get: operations["landed_cost_views_list_landed_cost_allocations"];
+        put?: never;
+        /**
+         * Create Landed Cost Allocation
+         * @description Create a landed cost allocation.
+         *
+         *     **No header-level GRN** — each item links a bill line to a GRN item line; multiple GRNs per document are allowed.
+         *
+         *     ### Common 400 error codes
+         *     - itemsRequired
+         *     - purchaseInvoiceItemDoesNotExist
+         *     - goodsReceiptNoteItemDoesNotExist
+         *     - notLandedCostItem
+         *     - landedCostCategoryRequired
+         *     - purchaseInvoiceShouldBePosted
+         *     - purchaseInvoiceShouldBeApproved
+         *     - grnBranchMismatch
+         *     - grnMustBeApproved
+         *     - serviceItemNotAllowed
+         *     - mixedAllocationMethod
+         *     - allocatedAmountExceedsRemaining
+         *     - landedCostFullyAllocated
+         *
+         *     **Permission key:** `landedcostallocation = [ add ]`
+         */
+        post: operations["landed_cost_views_create_landed_cost_allocation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/purchase/landed-cost-allocations/calculate-allocation/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Calculate Landed Cost Allocation
+         * @description Preview allocation amounts **without saving**.
+         *
+         *     **Returns 400** with `errors` when validation fails; **200** with preview data when valid.
+         *
+         *     ### Common 400 error codes
+         *     - itemsRequired
+         *     - purchaseInvoiceItemDoesNotExist
+         *     - goodsReceiptNoteItemDoesNotExist
+         *     - notLandedCostItem
+         *     - landedCostCategoryRequired
+         *     - purchaseInvoiceShouldBePosted
+         *     - purchaseInvoiceShouldBeApproved
+         *     - grnBranchMismatch
+         *     - grnMustBeApproved
+         *     - serviceItemNotAllowed
+         *     - mixedAllocationMethod
+         *     - allocatedAmountExceedsRemaining
+         *     - landedCostFullyAllocated
+         *
+         *     **Permission key:** `landedcostallocation = [ add ]`
+         */
+        post: operations["landed_cost_views_calculate_landed_cost_allocation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/purchase/landed-cost-allocations/{id}/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Landed Cost Allocation
+         * @description Get one LCA by id including all allocation lines and derived `goodsReceiptNotes` list.
+         *
+         *     ### Responses
+         *     - **200**: LandedCostAllocationDetailSchema
+         *     - **403**: permissionDenied, noModuleAccess, noBranchAccess
+         *     - **404**: landedCostAllocationDoesNotExist
+         *
+         *     **Permission key:** `landedcostallocation = [ view ]`
+         */
+        get: operations["landed_cost_views_get_landed_cost_allocation"];
+        /**
+         * Update Landed Cost Allocation
+         * @description Replace a **draft** LCA (full PUT — send complete `items` array and header fields).
+         *
+         *     Re-run `calculate-allocation/` after edits when any row uses `allocationMethod = quantity`.
+         *
+         *     ### Responses
+         *     - **200**: landedCostAllocationUpdated
+         *     - **400**: same item validation codes as create
+         *     - **403**: permissionDenied, landedCostAllocationShouldBeDraft
+         *     - **404**: landedCostAllocationDoesNotExist
+         *
+         *     **Permission key:** `landedcostallocation = [ change ]`
+         */
+        put: operations["landed_cost_views_update_landed_cost_allocation"];
+        post?: never;
+        /**
+         * Delete Landed Cost Allocation
+         * @description Delete an LCA. Reverses inventory and PI allocation effects when the document is not draft.
+         *
+         *     ### Responses
+         *     - **204**: deleted
+         *     - **400**: invalidPassword, noPasswordProvided
+         *     - **403**: permissionDenied, cantMakeActionOnLockedDocument
+         *     - **404**: landedCostAllocationDoesNotExist
+         *
+         *     **Permission key:** `landedcostallocation = [ delete ]`
+         */
+        delete: operations["landed_cost_views_delete_landed_cost_allocation"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/purchase/landed-cost-allocations/{id}/reset-to-draft/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Reset Landed Cost Allocation To Draft
+         * @description Reset a **submitted**, **sent**, or **posted** LCA back to draft.
+         *
+         *     Reverses inventory landed-cost effects, clears line posting snapshots, restores PI bill-line remaining,
+         *     and cancels approval tracking.
+         *
+         *     ### Responses
+         *     - **200**: landedCostAllocationResetToDraft
+         *     - **400**: invalidPassword, noPasswordProvided
+         *     - **403**: permissionDenied, landedCostAllocationShouldBePostedOrSubmittedOrSent, cantMakeActionOnLockedDocument
+         *     - **404**: landedCostAllocationDoesNotExist
+         *
+         *     **Permission key:** `landedcostallocation = [ resettodraft ]`
+         */
+        post: operations["landed_cost_views_reset_landed_cost_allocation_to_draft"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/purchase/landed-cost-allocations/{id}/cancel/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Cancel Landed Cost Allocation
+         * @description Cancel a landed cost allocation.
+         *
+         *     Restores PI bill-line remaining for finalized documents, clears line posting snapshots,
+         *     and cancels approval tracking.
+         *
+         *     ### Responses
+         *     - **200**: landedCostAllocationCanceled
+         *     - **400**: invalidPassword, noPasswordProvided
+         *     - **403**: permissionDenied, landedCostAllocationAlreadyCanceled, cantMakeActionOnLockedDocument
+         *     - **404**: landedCostAllocationDoesNotExist
+         *
+         *     **Permission key:** `landedcostallocation = [ cancel ]`
+         */
+        post: operations["landed_cost_views_cancel_landed_cost_allocation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/purchase/payment-vouchers/calculate-equivalents/": {
         parameters: {
             query?: never;
@@ -12852,19 +13065,19 @@ export interface paths {
         };
         /**
          * List Goods Receipt Notes
-         * @description Endpoint for listing goods receipt notes
+         * @description List goods receipt notes for the current branch.
          *
-         *     Responses:
-         *     - 200: GoodsReceiptListSchema
+         *     ### LCA integration
+         *     Pass `landedCostAllocation=true` to include finalized LCA rows on each GRN line.
+         *     Filter by `status=submitted` and `approvalStatus` in `approved` / `not_required` via grid filters.
+         *     Use inventory item line ids from selected GRNs as `goodsReceiptNoteItem` in the LCA grid.
          *
-         *     - 403: permissionDenied
-         *         - noModuleAccess
-         *         - noBranchAccess
-         *
-         *     - 400: paginationError
-         *         - invalidFilterFormat
-         *         - startDateAndEndDateAreRequiredForCustomPeriodType
+         *     **Headers:** `X-Current-Branch`
          *
+         *     Responses:
+         *     - 200: GoodsReceiptListSchema
+         *     - 403: permissionDenied, noModuleAccess, noBranchAccess
+         *     - 400: paginationError, invalidFilterFormat, startDateAndEndDateAreRequiredForCustomPeriodType
          *     - 500: serverError
          *
          *     Permission key: `goodsreceiptnote = ['view']`
@@ -12937,7 +13150,10 @@ export interface paths {
         };
         /**
          * Get Goods Receipt Note
-         * @description Endpoint for retrieving a single goods receipt note
+         * @description Endpoint for retrieving a single goods receipt note.
+         *
+         *     Each GRN line includes finalized `landedCostAllocations` when any submitted/posted/sent
+         *     LCA has been applied to that line.
          *
          *     Responses:
          *     - 200: GoodsReceiptNoteSchema
@@ -22806,6 +23022,20 @@ export interface paths {
          *         - expenseAccountShouldBeSubAccountOfDefaultExpensesAccount
          *         - defaultGeneralAccountsDoesNotExist
          *         - limitationPeriodIsRequired
+         *         - expenseAccountIsRequired
+         *         - clearingAccountIsRequired
+         *         - varianceAccountIsRequired
+         *         - landedCostClearingAccountMustBeBalanceSheet
+         *         - landedCostVarianceAccountMustBeProfitAndLoss
+         *         - landedCostClearingAccountAndVarianceAccountMustDiffer
+         *         - landedCostClearingAccountDoesNotExist
+         *         - landedCostVarianceAccountDoesNotExist
+         *         - landedCostClearingAccountShouldBeSubsidiaryAccount
+         *         - landedCostVarianceAccountShouldBeSubsidiaryAccount
+         *         - landedCostClearingAccountIsNotActive
+         *         - landedCostVarianceAccountIsNotActive
+         *         - landedCostClearingAccountShouldBeInCompanyOrSecondaryCurrency
+         *         - landedCostVarianceAccountShouldBeInCompanyOrSecondaryCurrency
          *
          *     - 403:
          *         - permissionDenied
@@ -22867,6 +23097,20 @@ export interface paths {
          *         - expenseAccountShouldBeSubAccountOfDefaultExpensesAccount
          *         - defaultGeneralAccountsDoesNotExist
          *         - limitationPeriodIsRequired
+         *         - expenseAccountIsRequired
+         *         - clearingAccountIsRequired
+         *         - varianceAccountIsRequired
+         *         - landedCostClearingAccountMustBeBalanceSheet
+         *         - landedCostVarianceAccountMustBeProfitAndLoss
+         *         - landedCostClearingAccountAndVarianceAccountMustDiffer
+         *         - landedCostClearingAccountDoesNotExist
+         *         - landedCostVarianceAccountDoesNotExist
+         *         - landedCostClearingAccountShouldBeSubsidiaryAccount
+         *         - landedCostVarianceAccountShouldBeSubsidiaryAccount
+         *         - landedCostClearingAccountIsNotActive
+         *         - landedCostVarianceAccountIsNotActive
+         *         - landedCostClearingAccountShouldBeInCompanyOrSecondaryCurrency
+         *         - landedCostVarianceAccountShouldBeInCompanyOrSecondaryCurrency
          *     - 404:
          *         - expenseCategoryDoesNotExist
          *     - 403:
@@ -26648,6 +26892,12 @@ export interface components {
          * @enum {string}
          */
         ItemSortBy: "name" | "shortName" | "skuCode" | "type" | "usage" | "active" | "dateCreated" | "dateModified" | "family" | "brand" | "categories" | "tags" | "";
+        /**
+         * LandedCostFilter
+         * @description Filter items list by landed cost service items.
+         * @enum {string}
+         */
+        LandedCostFilter: "include" | "only" | "exclude";
         /**
          * LogModelName
          * @enum {string}
@@ -26776,6 +27026,18 @@ export interface components {
              */
             default: boolean;
         };
+        /** ItemExpenseCategorySchema */
+        ItemExpenseCategorySchema: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Name */
+            name: string;
+            /** Islandedcost */
+            isLandedCost: boolean;
+        };
         /** ItemListSchema */
         ItemListSchema: {
             info: components["schemas"]["PageInfoSchema"];
@@ -27078,6 +27340,7 @@ export interface components {
              */
             taxes: components["schemas"]["TaxSchema"][];
             transactionalGroup?: components["schemas"]["TransactionalGroupSchema"] | null;
+            expenseCategory?: components["schemas"]["ItemExpenseCategorySchema"] | null;
             /**
              * Isinventorytracked
              * @default false
@@ -27340,6 +27603,7 @@ export interface components {
              */
             taxes: components["schemas"]["TaxSchema"][];
             transactionalGroup?: components["schemas"]["TransactionalGroupSchema"] | null;
+            expenseCategory?: components["schemas"]["ItemExpenseCategorySchema"] | null;
             /**
              * Isinventorytracked
              * @default false
@@ -27877,6 +28141,11 @@ export interface components {
              */
             barcodes: components["schemas"]["BarcodeSchema"][];
             type: components["schemas"]["ItemType"];
+            /**
+             * Expensecategory
+             * @description Only for service items. Filter categories by isLandedCost via grid filters.
+             */
+            expenseCategory?: string | null;
             usage: components["schemas"]["ItemUsage"];
             /**
              * Unitofmeasure
@@ -28113,6 +28382,12 @@ export interface components {
              */
             barcodes: components["schemas"]["BarcodeSchema"][];
             type: components["schemas"]["ItemType"];
+            /**
+             * Expensecategory
+             * @description Only applicable for service items. Assign a landed cost expense category to use this item on purchase invoices for LCA.
+             *             Filter categories via grid filters: `filters[0][field]=isLandedCost&filters[0][value]=true`
+             */
+            expenseCategory?: string | null;
             /**
              * @description - when type is service usage should be disabled and set its value to service
              *             - when type is product usage should be either goods or works only
@@ -28621,6 +28896,11 @@ export interface components {
              */
             barcodes: components["schemas"]["UpdateBarcodeSchema"][];
             type?: components["schemas"]["ItemType"] | null;
+            /**
+             * Expensecategory
+             * @description Only for service items. Filter categories by isLandedCost via grid filters.
+             */
+            expenseCategory?: string | null;
             /**
              * @description - when type is service usage should be disabled and set its value to service
              *             - when type is product usage should be either goods or works only
@@ -28918,6 +29198,11 @@ export interface components {
              */
             barcodes: components["schemas"]["UpdateBarcodeSchema"][];
             type?: components["schemas"]["ItemType"] | null;
+            /**
+             * Expensecategory
+             * @description Only for service items. Filter categories by isLandedCost via grid filters.
+             */
+            expenseCategory?: string | null;
             /**
              * @description - when type is service usage should be disabled and set its value to service
              *             - when type is product usage should be either goods or works only
@@ -43647,6 +43932,11 @@ export interface components {
             dueDate?: string | null;
             status: components["schemas"]["DocumentStatusValue"];
             approvalStatus: components["schemas"]["ApprovalChoices"];
+            /**
+             * @description landedCost when the invoice includes a service item with a landed cost expense category; otherwise regular.
+             * @default regular
+             */
+            invoiceType: components["schemas"]["PurchaseInvoiceTypeSchema"];
             paymentStatus: components["schemas"]["PaymentStatusChoices"];
             receivingStatus: components["schemas"]["ReceivingStatusChoices"];
             /** Usdrate */
@@ -43883,7 +44173,35 @@ export interface components {
             quantityReturnedOrder?: number;
             /** Quantityreturnedinvoice */
             quantityReturnedInvoice?: number;
+            /**
+             * Landedcostremainingamount
+             * @description Bill line amount still available for LCA (supplier currency).
+             */
+            landedCostRemainingAmount?: string | null;
+            /**
+             * Primarylandedcostremainingamount
+             * @description Bill line amount still available for LCA (company currency). Only present when item.expenseCategory is set.
+             *             Decreases when LCAs are **submitted**, **posted**, or **sent**. Draft LCAs do not reduce this value.
+             *             Use with `isLandedCostAllocated` to show [LCA] action on PI detail.
+             */
+            primaryLandedCostRemainingAmount?: string | null;
+            /**
+             * Secondarylandedcostremainingamount
+             * @description Bill line amount still available for LCA (secondary currency).
+             */
+            secondaryLandedCostRemainingAmount?: string | null;
+            /**
+             * Islandedcostallocated
+             * @description True when primaryLandedCostRemainingAmount is zero (fully allocated via posted LCAs).
+             * @default false
+             */
+            isLandedCostAllocated: boolean;
         };
+        /**
+         * PurchaseInvoiceTypeSchema
+         * @enum {string}
+         */
+        PurchaseInvoiceTypeSchema: "regular" | "landedCost";
         /** PurchaseOrderSharedSchema */
         PurchaseOrderSharedSchema: {
             /**
@@ -44485,7 +44803,7 @@ export interface components {
          * TypeSchema
          * @enum {string}
          */
-        TypeSchema: "default" | "creditNote" | "paymentVoucher" | "goodsReceiptNote";
+        TypeSchema: "default" | "creditNote" | "paymentVoucher" | "goodsReceiptNote" | "landedCostAllocation";
         /** PurchaseInvoiceDetailSchema */
         PurchaseInvoiceDetailSchema: {
             /**
@@ -44568,6 +44886,11 @@ export interface components {
             dueDate?: string | null;
             status: components["schemas"]["DocumentStatusValue"];
             approvalStatus: components["schemas"]["ApprovalChoices"];
+            /**
+             * @description landedCost when the invoice includes a service item with a landed cost expense category; otherwise regular.
+             * @default regular
+             */
+            invoiceType: components["schemas"]["PurchaseInvoiceTypeSchema"];
             paymentStatus: components["schemas"]["PaymentStatusChoices"];
             receivingStatus: components["schemas"]["ReceivingStatusChoices"];
             /** Usdrate */
@@ -44800,6 +45123,11 @@ export interface components {
             dueDate?: string | null;
             status: components["schemas"]["DocumentStatusValue"];
             approvalStatus: components["schemas"]["ApprovalChoices"];
+            /**
+             * @description landedCost when the invoice includes a service item with a landed cost expense category; otherwise regular.
+             * @default regular
+             */
+            invoiceType: components["schemas"]["PurchaseInvoiceTypeSchema"];
             paymentStatus: components["schemas"]["PaymentStatusChoices"];
             receivingStatus: components["schemas"]["ReceivingStatusChoices"];
             /** Usdrate */
@@ -45304,6 +45632,560 @@ export interface components {
             /** Password */
             password: string | null;
         };
+        /** LandedCostAllocationListSchema */
+        LandedCostAllocationListSchema: {
+            info: components["schemas"]["PageInfoSchema"];
+            /** Results */
+            results: components["schemas"]["LandedCostAllocationSummarySchema"][];
+        };
+        /** LandedCostAllocationSummarySchema */
+        LandedCostAllocationSummarySchema: {
+            /**
+             * Datecreated
+             * Format: date-time
+             */
+            dateCreated: string;
+            /** Datemodified */
+            dateModified: string | null;
+            createdBy: components["schemas"]["RecordUserSchema"];
+            modifiedBy: components["schemas"]["RecordUserSchema"] | null;
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /**
+             * Serialnumber
+             * @description Document number, e.g. LCA-HQR-2026-1.
+             */
+            serialNumber: string;
+            branch: components["schemas"]["BranchSummaryInfo"];
+            /**
+             * Date
+             * Format: date
+             */
+            date: string;
+            /**
+             * Totalamount
+             * @description Sum of line allocated amounts (supplier currency).
+             */
+            totalAmount: string;
+            /**
+             * Primarytotalamount
+             * @description Sum of line primary allocated amounts.
+             */
+            primaryTotalAmount: string;
+            /**
+             * Secondarytotalamount
+             * @description Sum of line secondary allocated amounts.
+             */
+            secondaryTotalAmount: string;
+            status: components["schemas"]["DocumentStatusValue"];
+            approvalStatus: components["schemas"]["ApprovalValueChoices"];
+            /** Description */
+            description?: string | null;
+            /** Notes */
+            notes?: string | null;
+        };
+        /** ExpenseCategoryAccount */
+        ExpenseCategoryAccount: {
+            /** Id */
+            id: number;
+            /** Name */
+            name: string;
+            /** Accountnumber */
+            accountNumber: string;
+        };
+        /** GoodsReceiptNoteItemSummarySchema */
+        GoodsReceiptNoteItemSummarySchema: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            item: components["schemas"]["LcaDocumentLineItemInfoSchema"];
+            /** Quantityreceived */
+            quantityReceived: number;
+            goodsReceiptNote: components["schemas"]["GoodsReceiptNoteSharedSchema"];
+        };
+        /** GoodsReceiptNoteLcaSummarySchema */
+        GoodsReceiptNoteLcaSummarySchema: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Serialnumber */
+            serialNumber: string;
+            /**
+             * Items
+             * @description GRN lines referenced by this allocation.
+             */
+            items?: components["schemas"]["LcaDocumentLineItemSummarySchema"][];
+        };
+        /** GoodsReceiptNoteSharedSchema */
+        GoodsReceiptNoteSharedSchema: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Serialnumber */
+            serialNumber: string;
+        };
+        /** LandedCostAllocationDetailSchema */
+        LandedCostAllocationDetailSchema: {
+            /**
+             * Datecreated
+             * Format: date-time
+             */
+            dateCreated: string;
+            /** Datemodified */
+            dateModified: string | null;
+            createdBy: components["schemas"]["RecordUserSchema"];
+            modifiedBy: components["schemas"]["RecordUserSchema"] | null;
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /**
+             * Serialnumber
+             * @description Document number, e.g. LCA-HQR-2026-1.
+             */
+            serialNumber: string;
+            branch: components["schemas"]["BranchSummaryInfo"];
+            /**
+             * Date
+             * Format: date
+             */
+            date: string;
+            /**
+             * Totalamount
+             * @description Sum of line allocated amounts (supplier currency).
+             */
+            totalAmount: string;
+            /**
+             * Primarytotalamount
+             * @description Sum of line primary allocated amounts.
+             */
+            primaryTotalAmount: string;
+            /**
+             * Secondarytotalamount
+             * @description Sum of line secondary allocated amounts.
+             */
+            secondaryTotalAmount: string;
+            status: components["schemas"]["DocumentStatusValue"];
+            approvalStatus: components["schemas"]["ApprovalValueChoices"];
+            /** Description */
+            description?: string | null;
+            /** Notes */
+            notes?: string | null;
+            /**
+             * Goodsreceiptnotes
+             * @description Distinct GRNs referenced by allocation lines (supports multi-GRN documents).
+             */
+            goodsReceiptNotes?: components["schemas"]["GoodsReceiptNoteLcaSummarySchema"][];
+            /**
+             * Purchaseinvoices
+             * @description Distinct purchase invoices referenced by allocation lines.
+             */
+            purchaseInvoices?: components["schemas"]["PurchaseInvoiceLcaSummarySchema"][];
+            /** Items */
+            items: components["schemas"]["LandedCostAllocationItemDetailSchema"][];
+        };
+        /** LandedCostAllocationItemDetailSchema */
+        LandedCostAllocationItemDetailSchema: {
+            /**
+             * Id
+             * @description Present on saved documents; null in calculate preview.
+             */
+            id?: string | null;
+            purchaseInvoiceItem: components["schemas"]["PurchaseInvoiceItemSummarySchema"];
+            goodsReceiptNoteItem: components["schemas"]["GoodsReceiptNoteItemSummarySchema"];
+            allocationMethod: components["schemas"]["LandedCostAllocationMethod"];
+            category: components["schemas"]["LandedCostCategorySummarySchema"];
+            /** Allocatedamount */
+            allocatedAmount: string;
+            /** Primaryallocatedamount */
+            primaryAllocatedAmount: string;
+            /** Secondaryallocatedamount */
+            secondaryAllocatedAmount: string;
+        };
+        /**
+         * LandedCostAllocationMethod
+         * @enum {string}
+         */
+        LandedCostAllocationMethod: "quantity" | "manual";
+        /** LandedCostAllocationResponseSchema */
+        LandedCostAllocationResponseSchema: {
+            /** Message */
+            message: string;
+            /**
+             * Code
+             * @description e.g. landedCostAllocationCreated, landedCostAllocationUpdated
+             */
+            code: string;
+            data: components["schemas"]["LandedCostAllocationDetailSchema"];
+        };
+        /** LandedCostCategorySummarySchema */
+        LandedCostCategorySummarySchema: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Name */
+            name: string;
+            /** Islandedcost */
+            isLandedCost: boolean;
+            /** @description GL clearing account (informational; GL posting not active yet). */
+            clearingAccount?: components["schemas"]["ExpenseCategoryAccount"] | null;
+            /** @description GL variance account (informational; GL posting not active yet). */
+            varianceAccount?: components["schemas"]["ExpenseCategoryAccount"] | null;
+        };
+        /** LcaDocumentLineItemInfoSchema */
+        LcaDocumentLineItemInfoSchema: {
+            /** Id */
+            id?: string | null;
+            /** Name */
+            name: string;
+            unitOfMeasure?: components["schemas"]["UnitOfMeasureSummaryInfo"] | null;
+            expenseCategory?: components["schemas"]["ItemExpenseCategorySchema"] | null;
+        };
+        /** LcaDocumentLineItemSummarySchema */
+        LcaDocumentLineItemSummarySchema: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            item: components["schemas"]["LcaDocumentLineItemInfoSchema"];
+            /**
+             * Landedcostremainingamount
+             * @description Bill line amount still available for LCA (supplier currency). Present on purchase invoice lines only.
+             */
+            landedCostRemainingAmount?: string | null;
+            /**
+             * Primarylandedcostremainingamount
+             * @description Bill line amount still available for LCA (company currency). Present on purchase invoice lines only.
+             */
+            primaryLandedCostRemainingAmount?: string | null;
+            /**
+             * Secondarylandedcostremainingamount
+             * @description Bill line amount still available for LCA (secondary currency). Present on purchase invoice lines only.
+             */
+            secondaryLandedCostRemainingAmount?: string | null;
+        };
+        /** PurchaseInvoiceItemSummarySchema */
+        PurchaseInvoiceItemSummarySchema: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            item: components["schemas"]["LcaDocumentLineItemInfoSchema"];
+            purchaseInvoice: components["schemas"]["PurchaseInvoiceSharedSchema"];
+            supplier?: components["schemas"]["ChildSupplierSharedSchema"] | null;
+        };
+        /** PurchaseInvoiceLcaSummarySchema */
+        PurchaseInvoiceLcaSummarySchema: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Serialnumber */
+            serialNumber: string;
+            /**
+             * Items
+             * @description Purchase invoice lines referenced by this allocation.
+             */
+            items?: components["schemas"]["LcaDocumentLineItemSummarySchema"][];
+        };
+        /** PurchaseInvoiceSharedSchema */
+        PurchaseInvoiceSharedSchema: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Serialnumber */
+            serialNumber: string;
+        };
+        /**
+         * ChangedFieldsVersionThree
+         * @enum {string}
+         */
+        ChangedFieldsVersionThree: "amount" | "primaryAmount" | "secondaryAmount" | "primaryRate" | "secondaryRate" | "accountNumber";
+        /** LandedCostAllocationCreateSchema */
+        LandedCostAllocationCreateSchema: {
+            /** Password */
+            password?: string | null;
+            /**
+             * Date
+             * Format: date
+             * @description Allocation document date (YYYY-MM-DD). Used for fiscal year and transaction locking.
+             */
+            date: string;
+            /**
+             * Items
+             * @description Allocation grid rows linking one bill line to one GRN inventory line.
+             *             Each row includes `allocationMethod` (`manual` | `quantity`).
+             *             Build the grid by crossing selected bills (PI lines) with selected GRN item lines.
+             *             At least one row is required. Rows can reference multiple GRNs.
+             */
+            items: components["schemas"]["LandedCostAllocationItemSchema"][];
+            /**
+             * Description
+             * @description Optional header description shown on the document.
+             */
+            description?: string | null;
+            /**
+             * Notes
+             * @description Optional internal notes.
+             */
+            notes?: string | null;
+            /** @description Save as draft or submit for approval. */
+            status: components["schemas"]["DocumentStatusValue"];
+        };
+        /** LandedCostAllocationItemSchema */
+        LandedCostAllocationItemSchema: {
+            /**
+             * Purchaseinvoiceitem
+             * Format: uuid
+             * @description UUID of a **posted purchase invoice line** where the item has a landed cost `expenseCategory`.
+             *             Accepts a plain UUID or a summary object with an `id` field when echoing rows from calculate/detail responses.
+             *             Load bill lines from: `/api/v1/purchase/invoices/?type=landedCostAllocation&includeItems=true&onlyRemaining=true`.
+             *             Each line includes `landedCostRemainingAmount`, `primaryLandedCostRemainingAmount`,
+             *             `secondaryLandedCostRemainingAmount`, and `isLandedCostAllocated` (category is on `item.expenseCategory`).
+             */
+            purchaseInvoiceItem: string;
+            /**
+             * Goodsreceiptnoteitem
+             * Format: uuid
+             * @description UUID of an **inventory GRN line** (not a service item) that will receive part of the bill amount.
+             *             Accepts a plain UUID or a summary object with an `id` field when echoing rows from calculate/detail responses.
+             *             Load eligible GRNs from: `/api/v1/inventory/goods-receipt-notes/?landedCostAllocation=true&filters[0][field]=status&filters[0][value]=submitted&filters[1][field]=approvalStatus&filters[1][value]=approved&filters[1][value]=not_required` and use item line ids from the selected GRN(s).
+             *             Multiple lines may belong to **different GRNs** in the same allocation.
+             */
+            goodsReceiptNoteItem: string;
+            /**
+             * @description How this row's amount is determined:
+             *             - **manual** (default): send `allocatedAmount` for this row.
+             *             - **quantity**: omit `allocatedAmount`; backend splits the bill line's available remaining across all GRN rows sharing the same `purchaseInvoiceItem` with `allocationMethod = quantity`, weighted by `quantityReceived`.
+             *             All rows for the same bill line must use the same method.
+             * @default manual
+             */
+            allocationMethod: components["schemas"]["LandedCostAllocationMethod"];
+            /**
+             * Allocatedamount
+             * @description Allocated amount in supplier currency. Send any one of allocatedAmount, primaryAllocatedAmount,
+             *             or secondaryAllocatedAmount together with changedField; the system calculates the other two.
+             *             - **manual**: required on create/update (any one currency field).
+             *             - **quantity**: omit; backend splits available remaining in company currency across GRN lines.
+             *             Use POST /api/v1/purchase/landed-cost-allocations/calculate-allocation/ to preview before save.
+             */
+            allocatedAmount?: string | null;
+            /**
+             * Primaryallocatedamount
+             * @description Allocated amount in company currency. Use with changedField when entering in primary currency.
+             */
+            primaryAllocatedAmount?: string | null;
+            /**
+             * Secondaryallocatedamount
+             * @description Allocated amount in secondary currency. Use with changedField when entering in secondary currency.
+             */
+            secondaryAllocatedAmount?: string | null;
+            /** @description Which amount field the user edited: amount (supplier), primaryAmount, or secondaryAmount. */
+            changedField?: components["schemas"]["ChangedFieldsVersionThree"] | null;
+        };
+        /** LandedCostAllocationCalculateResponseSchema */
+        LandedCostAllocationCalculateResponseSchema: {
+            /**
+             * Items
+             * @description Preview grid rows — same shape as `items` on GET/create/update allocation responses.
+             */
+            items: components["schemas"]["LandedCostAllocationItemDetailSchema"][];
+            /**
+             * Billsummaries
+             * @description Per-category/bill-line totals for balance indicators in the UI footer.
+             */
+            billSummaries: components["schemas"]["LandedCostBillSummarySchema"][];
+            /**
+             * Totalamount
+             * @description Sum of supplier-currency allocated amounts.
+             */
+            totalAmount: string;
+            /**
+             * Primarytotalamount
+             * @description Sum of company-currency allocated amounts.
+             */
+            primaryTotalAmount: string;
+            /**
+             * Secondarytotalamount
+             * @description Sum of secondary-currency allocated amounts.
+             */
+            secondaryTotalAmount: string;
+        };
+        /** LandedCostBillSummarySchema */
+        LandedCostBillSummarySchema: {
+            /**
+             * Purchaseinvoiceitemid
+             * Format: uuid
+             * @description Bill line id — one summary row per distinct bill line in the grid.
+             */
+            purchaseInvoiceItemId: string;
+            /**
+             * Purchaseinvoiceserial
+             * @description PI number.
+             */
+            purchaseInvoiceSerial: string;
+            /** Categoryid */
+            categoryId?: string | null;
+            /**
+             * Categoryname
+             * @description Category column header in the allocation grid.
+             */
+            categoryName?: string | null;
+            /**
+             * Itemname
+             * @description Service item name on the bill.
+             */
+            itemName: string;
+            /**
+             * Billlineamount
+             * @description Total bill line amount in company currency.
+             */
+            billLineAmount: string;
+            /** Allocatedamount */
+            allocatedAmount: string;
+            /** Primaryallocatedamount */
+            primaryAllocatedAmount: string;
+            /** Secondaryallocatedamount */
+            secondaryAllocatedAmount: string;
+            /** Availableamount */
+            availableAmount: string;
+            /** Primaryavailableamount */
+            primaryAvailableAmount: string;
+            /** Secondaryavailableamount */
+            secondaryAvailableAmount: string;
+            /** Remainingafterallocation */
+            remainingAfterAllocation: string;
+            /** Primaryremainingafterallocation */
+            primaryRemainingAfterAllocation: string;
+            /** Secondaryremainingafterallocation */
+            secondaryRemainingAfterAllocation: string;
+        };
+        /** LandedCostAllocationCalculateSchema */
+        LandedCostAllocationCalculateSchema: {
+            /**
+             * Items
+             * @description Same shape as create/update items (including per-row `allocationMethod`). Does not persist anything.
+             */
+            items: components["schemas"]["LandedCostAllocationItemSchema"][];
+            /**
+             * Landedcostallocationid
+             * @description When editing an existing **draft** LCA, pass its id so available remaining excludes this document's current draft lines.
+             *             Omit on new documents.
+             */
+            landedCostAllocationId?: string | null;
+        };
+        /** LandedCostAllocationItemUpdateSchema */
+        LandedCostAllocationItemUpdateSchema: {
+            /**
+             * Purchaseinvoiceitem
+             * Format: uuid
+             * @description UUID of a **posted purchase invoice line** where the item has a landed cost `expenseCategory`.
+             *             Accepts a plain UUID or a summary object with an `id` field when echoing rows from calculate/detail responses.
+             *             Load bill lines from: `/api/v1/purchase/invoices/?type=landedCostAllocation&includeItems=true&onlyRemaining=true`.
+             *             Each line includes `landedCostRemainingAmount`, `primaryLandedCostRemainingAmount`,
+             *             `secondaryLandedCostRemainingAmount`, and `isLandedCostAllocated` (category is on `item.expenseCategory`).
+             */
+            purchaseInvoiceItem: string;
+            /**
+             * Goodsreceiptnoteitem
+             * Format: uuid
+             * @description UUID of an **inventory GRN line** (not a service item) that will receive part of the bill amount.
+             *             Accepts a plain UUID or a summary object with an `id` field when echoing rows from calculate/detail responses.
+             *             Load eligible GRNs from: `/api/v1/inventory/goods-receipt-notes/?landedCostAllocation=true&filters[0][field]=status&filters[0][value]=submitted&filters[1][field]=approvalStatus&filters[1][value]=approved&filters[1][value]=not_required` and use item line ids from the selected GRN(s).
+             *             Multiple lines may belong to **different GRNs** in the same allocation.
+             */
+            goodsReceiptNoteItem: string;
+            /**
+             * @description How this row's amount is determined:
+             *             - **manual** (default): send `allocatedAmount` for this row.
+             *             - **quantity**: omit `allocatedAmount`; backend splits the bill line's available remaining across all GRN rows sharing the same `purchaseInvoiceItem` with `allocationMethod = quantity`, weighted by `quantityReceived`.
+             *             All rows for the same bill line must use the same method.
+             * @default manual
+             */
+            allocationMethod: components["schemas"]["LandedCostAllocationMethod"];
+            /**
+             * Allocatedamount
+             * @description Allocated amount in supplier currency. Send any one of allocatedAmount, primaryAllocatedAmount,
+             *             or secondaryAllocatedAmount together with changedField; the system calculates the other two.
+             *             - **manual**: required on create/update (any one currency field).
+             *             - **quantity**: omit; backend splits available remaining in company currency across GRN lines.
+             *             Use POST /api/v1/purchase/landed-cost-allocations/calculate-allocation/ to preview before save.
+             */
+            allocatedAmount?: string | null;
+            /**
+             * Primaryallocatedamount
+             * @description Allocated amount in company currency. Use with changedField when entering in primary currency.
+             */
+            primaryAllocatedAmount?: string | null;
+            /**
+             * Secondaryallocatedamount
+             * @description Allocated amount in secondary currency. Use with changedField when entering in secondary currency.
+             */
+            secondaryAllocatedAmount?: string | null;
+            /** @description Which amount field the user edited: amount (supplier), primaryAmount, or secondaryAmount. */
+            changedField?: components["schemas"]["ChangedFieldsVersionThree"] | null;
+            /**
+             * Id
+             * @description Existing line id when updating a draft LCA; omit for new rows.
+             */
+            id?: string | null;
+        };
+        /** LandedCostAllocationUpdateSchema */
+        LandedCostAllocationUpdateSchema: {
+            /** Password */
+            password?: string | null;
+            /**
+             * Date
+             * Format: date
+             * @description Document date (YYYY-MM-DD). Only allowed while status is draft.
+             */
+            date: string;
+            /**
+             * Items
+             * @description Full allocation grid. Include `id` on existing rows to update in place; omit `id` for new rows.
+             *             Rows not sent are removed. Each row has its own `allocationMethod`.
+             */
+            items: components["schemas"]["LandedCostAllocationItemUpdateSchema"][];
+            /** Description */
+            description?: string | null;
+            /** Notes */
+            notes?: string | null;
+            /** @description Save as draft or submit for approval. */
+            status: components["schemas"]["DocumentStatusValue"];
+        };
+        /** LandedCostAllocationDeleteSchema */
+        LandedCostAllocationDeleteSchema: {
+            /**
+             * Password
+             * @default
+             */
+            password: string | null;
+        };
+        /** LandedCostAllocationActionsSchema */
+        LandedCostAllocationActionsSchema: {
+            /**
+             * Password
+             * @default
+             */
+            password: string | null;
+        };
         /** PaymentVoucherCalculateTotalResponse */
         PaymentVoucherCalculateTotalResponse: {
             /**
@@ -45974,6 +46856,11 @@ export interface components {
             dueDate?: string | null;
             status: components["schemas"]["DocumentStatusValue"];
             approvalStatus: components["schemas"]["ApprovalChoices"];
+            /**
+             * @description landedCost when the invoice includes a service item with a landed cost expense category; otherwise regular.
+             * @default regular
+             */
+            invoiceType: components["schemas"]["PurchaseInvoiceTypeSchema"];
             paymentStatus: components["schemas"]["PaymentStatusChoices"];
             receivingStatus: components["schemas"]["ReceivingStatusChoices"];
             /** Usdrate */
@@ -46736,6 +47623,29 @@ export interface components {
             /** Items */
             items: components["schemas"]["CalculatePurchaseReturnInvoiceItemsSchema"][];
         };
+        /** GoodsReceiptNoteItemLandedCostAllocationSchema */
+        GoodsReceiptNoteItemLandedCostAllocationSchema: {
+            /**
+             * Id
+             * Format: uuid
+             * @description Landed cost allocation line id.
+             */
+            id: string;
+            landedCostAllocation: components["schemas"]["LandedCostAllocationMinimalSchema"];
+            /** Categoryname */
+            categoryName: string;
+            allocationMethod: components["schemas"]["LandedCostAllocationMethod"];
+            /**
+             * Primaryallocatedamount
+             * @description Allocated amount in company currency.
+             */
+            primaryAllocatedAmount: string;
+            /**
+             * Purchaseinvoiceserial
+             * @description Purchase invoice that supplied the landed cost amount.
+             */
+            purchaseInvoiceSerial: string;
+        };
         /** GoodsReceiptNoteItemTrackingSchema */
         GoodsReceiptNoteItemTrackingSchema: {
             /**
@@ -46787,6 +47697,12 @@ export interface components {
              * @default []
              */
             tracking: components["schemas"]["GoodsReceiptNoteItemTrackingSchema"][];
+            /**
+             * Landedcostallocations
+             * @description Finalized LCAs applied to this GRN line. Always included on GET; on list, present when `landedCostAllocation=true`.
+             * @default []
+             */
+            landedCostAllocations: components["schemas"]["GoodsReceiptNoteItemLandedCostAllocationSchema"][];
         };
         /** GoodsReceiptNoteSchema */
         GoodsReceiptNoteSchema: {
@@ -46872,8 +47788,8 @@ export interface components {
             /** Allownegativestock */
             allowNegativeStock: boolean;
         };
-        /** PurchaseInvoiceSharedSchema */
-        PurchaseInvoiceSharedSchema: {
+        /** LandedCostAllocationMinimalSchema */
+        LandedCostAllocationMinimalSchema: {
             /**
              * Id
              * Format: uuid
@@ -62567,15 +63483,6 @@ export interface components {
             accountNumber: string;
             currency: components["schemas"]["CurrencySummaryInfo"];
         };
-        /** ExpenseCategoryAccount */
-        ExpenseCategoryAccount: {
-            /** Id */
-            id: number;
-            /** Name */
-            name: string;
-            /** Accountnumber */
-            accountNumber: string;
-        };
         /** ExpenseCategoryDetailSchema */
         ExpenseCategoryDetailSchema: {
             /**
@@ -62594,7 +63501,7 @@ export interface components {
             id: string;
             /** Name */
             name: string;
-            expenseAccount: components["schemas"]["ExpenseCategoryAccount"];
+            expenseAccount?: components["schemas"]["ExpenseCategoryAccount"] | null;
             prepaidExpenseAccount: components["schemas"]["ExpenseCategoryAccount"] | null;
             deferredExpenseAccount: components["schemas"]["ExpenseCategoryAccount"] | null;
             /** Haslimit */
@@ -62606,6 +63513,12 @@ export interface components {
             preferredSupplier: components["schemas"]["AccountWithCurrencySummaryInfo"] | null;
             /** Isactive */
             isActive: boolean;
+            /** Islandedcost */
+            isLandedCost: boolean;
+            /** @description Present when isLandedCost is true. Subsidiary balance sheet account (account type parent name: Assets, Liabilities, Equity, Others). */
+            landedCostClearingAccount?: components["schemas"]["ExpenseCategoryAccount"] | null;
+            /** @description Present when isLandedCost is true. Subsidiary P&L account (account type parent name: Expenses, Income). */
+            landedCostVarianceAccount?: components["schemas"]["ExpenseCategoryAccount"] | null;
             /** Notes */
             notes: string | null;
             /** Description */
@@ -62640,10 +63553,11 @@ export interface components {
             name: string;
             /**
              * Expenseaccount
-             * @description - expense account id
+             * @description - Expense account id — **required when isLandedCost is false**, optional when isLandedCost is true
+             *         - Validation error when required: expenseAccountIsRequired
              *         - get accounts using route /api/v1/chart_of_account/?branchId=1&type=expenses
              */
-            expenseAccount: number;
+            expenseAccount?: number | null;
             /**
              * Prepaidexpenseaccount
              * @description - prepaid expense account id
@@ -62690,6 +63604,36 @@ export interface components {
              * @default true
              */
             isActive: boolean;
+            /**
+             * Islandedcost
+             * @description When true, this category is used for landed cost allocation on purchase invoice service lines.
+             *             When true: landedCostClearingAccount and landedCostVarianceAccount are required; expenseAccount is optional.
+             *             When false: expenseAccount is required; landed cost accounts are ignored.
+             * @default false
+             */
+            isLandedCost: boolean;
+            /**
+             * Landedcostclearingaccount
+             * @description Required when isLandedCost is true.
+             *             Must be a **Subsidiary** chart of account whose **account type parent name** is one of:
+             *             Assets, Liabilities, Equity, Others (balance sheet).
+             *             Cannot be the same account as landedCostVarianceAccount.
+             *             Validation errors: clearingAccountIsRequired, landedCostClearingAccountShouldBeSubsidiaryAccount,
+             *             landedCostClearingAccountMustBeBalanceSheet,
+             *             landedCostClearingAccountAndVarianceAccountMustDiffer.
+             */
+            landedCostClearingAccount?: number | null;
+            /**
+             * Landedcostvarianceaccount
+             * @description Required when isLandedCost is true.
+             *             Must be a **Subsidiary** chart of account whose **account type parent name** is one of:
+             *             Expenses, Income (profit & loss).
+             *             Cannot be the same account as landedCostClearingAccount.
+             *             Validation errors: varianceAccountIsRequired, landedCostVarianceAccountShouldBeSubsidiaryAccount,
+             *             landedCostVarianceAccountMustBeProfitAndLoss,
+             *             landedCostClearingAccountAndVarianceAccountMustDiffer
+             */
+            landedCostVarianceAccount?: number | null;
             /** Notes */
             notes?: string;
             /** Description */
@@ -62871,7 +63815,7 @@ export interface components {
             id: string;
             /** Name */
             name: string;
-            expenseAccount: components["schemas"]["ExpenseCategoryAccount"];
+            expenseAccount?: components["schemas"]["ExpenseCategoryAccount"] | null;
             /** Haslimit */
             hasLimit: boolean;
             /** Limitamount */
@@ -62881,6 +63825,11 @@ export interface components {
             preferredSupplier: components["schemas"]["AccountSummaryInfo"] | null;
             /** Isactive */
             isActive: boolean;
+            /**
+             * Islandedcost
+             * @default false
+             */
+            isLandedCost: boolean;
         };
         /**
          * ExpensePaidByEnum
@@ -63519,11 +64468,6 @@ export interface components {
             /** Password */
             password?: string;
         };
-        /**
-         * ChangedFieldsVersionThree
-         * @enum {string}
-         */
-        ChangedFieldsVersionThree: "amount" | "primaryAmount" | "secondaryAmount" | "primaryRate" | "secondaryRate" | "accountNumber";
         /** ExpensePaymentVoucherCalculateTotalsResponseSchema */
         ExpensePaymentVoucherCalculateTotalsResponseSchema: {
             /** Total */
@@ -65155,6 +66099,8 @@ export interface operations {
                 syncableOnlineItems?: boolean;
                 /** @description When fulfilling a transfer request, pass its ID so availableForSale excludes reservations from other documents but includes quantities reserved for this transfer request. */
                 transferRequestId?: string | null;
+                /** @description Filter landed cost service items: 'exclude' (default) omits them, 'only' returns only landed cost service items, 'include' returns every item. */
+                landedCostFilter?: "include" | "only" | "exclude";
             };
             header?: never;
             path?: never;
@@ -88050,12 +88996,29 @@ export interface operations {
                 search?: string | null;
                 /** @description Filter by branch id */
                 branchId: string;
-                /** @description default: all invoices in range; creditNote: remaining after credits/returns (supplier required); paymentVoucher: unpaid or partially paid; goodsReceiptNote: not received or partially received only. */
-                type?: "default" | "creditNote" | "paymentVoucher" | "goodsReceiptNote";
+                /**
+                 * @description Filter list for downstream document pickers:
+                 *             - **default**: all invoices in date range
+                 *             - **creditNote**: remaining after credits/returns (`supplier` required)
+                 *             - **paymentVoucher**: unpaid or partially paid (`supplier` required)
+                 *             - **goodsReceiptNote**: receiving_status not_received / partially_received
+                 *             - **landedCostAllocation**: posted PIs with landed cost service lines. Use `onlyRemaining` to control whether
+                 *               fully allocated bills are included. Always pass `includeItems=true`. Each item includes
+                 *               `landedCostRemainingAmount`, `primaryLandedCostRemainingAmount`, `secondaryLandedCostRemainingAmount`,
+                 *               `isLandedCostAllocated`, and `item.expenseCategory`.
+                 *               Use item ids as `purchaseInvoiceItem` in LCA create/calculate payloads.
+                 */
+                type?: "default" | "creditNote" | "paymentVoucher" | "goodsReceiptNote" | "landedCostAllocation";
                 /** @description supplier id, required when type is creditNote or paymentVoucher */
                 supplier?: string;
-                /** @description If true, includes invoice items in the response */
+                /** @description Include invoice lines. **Required true** when type=landedCostAllocation (LCA bill picker). */
                 includeItems?: boolean;
+                /**
+                 * @description Only applies when type=landedCostAllocation.
+                 *             - **true** (default): only bills/lines with `primaryLandedCostRemainingAmount > 0` (LCA bill picker).
+                 *             - **false**: include all posted landed cost bill lines, including fully allocated ones.
+                 */
+                onlyRemaining?: boolean;
             };
             header?: never;
             path?: never;
@@ -88152,19 +89115,265 @@ export interface operations {
             };
         };
     };
-    purchase_purchase_invoice_views_get_purchase_invoice: {
+    purchase_purchase_invoice_views_get_purchase_invoice: {
+        parameters: {
+            query?: {
+                type?: "default" | "creditNote" | "paymentVoucher" | "goodsReceiptNote" | "landedCostAllocation";
+                grn?: boolean;
+            };
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PurchaseInvoiceWithEntriesSchema"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessages"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+        };
+    };
+    purchase_purchase_invoice_views_update_purchase_invoice: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PurchaseInvoiceUpdateSchema"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PurchaseInvoiceWithEntriesSchema"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessages"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+        };
+    };
+    purchase_purchase_invoice_views_delete_purchase_invoice: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PurchaseInvoiceDeleteSchema"];
+            };
+        };
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessages"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+        };
+    };
+    purchase_purchase_invoice_views_cancel_purchase_invoice: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PasswordSchema"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PurchaseInvoiceWithEntriesSchema"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessages"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+        };
+    };
+    purchase_purchase_invoice_views_reset_to_draft_purchase_invoice: {
         parameters: {
-            query?: {
-                type?: "default" | "creditNote" | "paymentVoucher" | "goodsReceiptNote";
-                grn?: boolean;
-            };
+            query?: never;
             header?: never;
             path: {
                 id: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PasswordSchema"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -88213,20 +89422,18 @@ export interface operations {
             };
         };
     };
-    purchase_purchase_invoice_views_update_purchase_invoice: {
+    purchase_purchase_invoice_views_export_purchase_invoice: {
         parameters: {
-            query?: never;
+            query: {
+                selectedCurrencies: number[];
+            };
             header?: never;
             path: {
                 id: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["PurchaseInvoiceUpdateSchema"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description OK */
             200: {
@@ -88234,7 +89441,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PurchaseInvoiceWithEntriesSchema"];
+                    "application/json": string;
                 };
             };
             /** @description Bad Request */
@@ -88275,7 +89482,7 @@ export interface operations {
             };
         };
     };
-    purchase_purchase_invoice_views_delete_purchase_invoice: {
+    purchase_purchase_invoice_views_get_purchase_invoice_difference: {
         parameters: {
             query?: never;
             header?: never;
@@ -88284,18 +89491,16 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["PurchaseInvoiceDeleteSchema"];
-            };
-        };
+        requestBody?: never;
         responses: {
-            /** @description No Content */
-            204: {
+            /** @description OK */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["PurchaseInvoiceDifferenceSchema"];
+                };
             };
             /** @description Bad Request */
             400: {
@@ -88335,7 +89540,7 @@ export interface operations {
             };
         };
     };
-    purchase_purchase_invoice_views_cancel_purchase_invoice: {
+    purchase_purchase_invoice_views_export_purchase_invoice_pdf: {
         parameters: {
             query?: never;
             header?: never;
@@ -88344,11 +89549,7 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["PasswordSchema"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description OK */
             200: {
@@ -88356,7 +89557,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PurchaseInvoiceWithEntriesSchema"];
+                    "application/json": string;
                 };
             };
             /** @description Bad Request */
@@ -88374,7 +89575,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MessageResponse"];
+                    "application/json": components["schemas"]["MessageWithCode"];
                 };
             };
             /** @description Not Found */
@@ -88383,7 +89584,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MessageResponse"];
+                    "application/json": components["schemas"]["MessageWithCode"];
                 };
             };
             /** @description Internal Server Error */
@@ -88392,12 +89593,12 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MessageResponse"];
+                    "application/json": components["schemas"]["MessageWithCode"];
                 };
             };
         };
     };
-    purchase_purchase_invoice_views_reset_to_draft_purchase_invoice: {
+    purchase_purchase_invoice_views_send_purchase_invoice_by_email: {
         parameters: {
             query?: never;
             header?: never;
@@ -88408,7 +89609,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["PasswordSchema"];
+                "application/json": components["schemas"]["EmailContentSchema"];
             };
         };
         responses: {
@@ -88418,7 +89619,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PurchaseInvoiceWithEntriesSchema"];
+                    "application/json": components["schemas"]["MessageResponse"];
                 };
             };
             /** @description Bad Request */
@@ -88459,15 +89660,14 @@ export interface operations {
             };
         };
     };
-    purchase_purchase_invoice_views_export_purchase_invoice: {
+    landed_cost_views_list_landed_cost_allocations: {
         parameters: {
-            query: {
-                selectedCurrencies: number[];
+            query?: {
+                /** @description Search by serial number or description. */
+                search?: string | null;
             };
             header?: never;
-            path: {
-                id: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -88478,7 +89678,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": string;
+                    "application/json": components["schemas"]["LandedCostAllocationListSchema"];
                 };
             };
             /** @description Bad Request */
@@ -88499,8 +89699,41 @@ export interface operations {
                     "application/json": components["schemas"]["MessageResponse"];
                 };
             };
-            /** @description Not Found */
-            404: {
+        };
+    };
+    landed_cost_views_create_landed_cost_allocation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["LandedCostAllocationCreateSchema"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LandedCostAllocationResponseSchema"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessages"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -88519,16 +89752,18 @@ export interface operations {
             };
         };
     };
-    purchase_purchase_invoice_views_get_purchase_invoice_difference: {
+    landed_cost_views_calculate_landed_cost_allocation: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                id: string;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["LandedCostAllocationCalculateSchema"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -88536,7 +89771,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PurchaseInvoiceDifferenceSchema"];
+                    "application/json": components["schemas"]["LandedCostAllocationCalculateResponseSchema"];
                 };
             };
             /** @description Bad Request */
@@ -88557,8 +89792,30 @@ export interface operations {
                     "application/json": components["schemas"]["MessageResponse"];
                 };
             };
-            /** @description Not Found */
-            404: {
+        };
+    };
+    landed_cost_views_get_landed_cost_allocation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LandedCostAllocationDetailSchema"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -88566,8 +89823,8 @@ export interface operations {
                     "application/json": components["schemas"]["MessageResponse"];
                 };
             };
-            /** @description Internal Server Error */
-            500: {
+            /** @description Not Found */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -88577,7 +89834,7 @@ export interface operations {
             };
         };
     };
-    purchase_purchase_invoice_views_export_purchase_invoice_pdf: {
+    landed_cost_views_update_landed_cost_allocation: {
         parameters: {
             query?: never;
             header?: never;
@@ -88586,7 +89843,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["LandedCostAllocationUpdateSchema"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -88594,7 +89855,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": string;
+                    "application/json": components["schemas"]["LandedCostAllocationResponseSchema"];
                 };
             };
             /** @description Bad Request */
@@ -88612,7 +89873,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MessageWithCode"];
+                    "application/json": components["schemas"]["MessageResponse"];
                 };
             };
             /** @description Not Found */
@@ -88621,21 +89882,63 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MessageWithCode"];
+                    "application/json": components["schemas"]["MessageResponse"];
                 };
             };
-            /** @description Internal Server Error */
-            500: {
+        };
+    };
+    landed_cost_views_delete_landed_cost_allocation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["LandedCostAllocationDeleteSchema"];
+            };
+        };
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad Request */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MessageWithCode"];
+                    "application/json": components["schemas"]["ErrorMessages"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
                 };
             };
         };
     };
-    purchase_purchase_invoice_views_send_purchase_invoice_by_email: {
+    landed_cost_views_reset_landed_cost_allocation_to_draft: {
         parameters: {
             query?: never;
             header?: never;
@@ -88646,7 +89949,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["EmailContentSchema"];
+                "application/json": components["schemas"]["LandedCostAllocationActionsSchema"];
             };
         };
         responses: {
@@ -88656,7 +89959,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MessageResponse"];
+                    "application/json": components["schemas"]["LandedCostAllocationResponseSchema"];
                 };
             };
             /** @description Bad Request */
@@ -88686,8 +89989,52 @@ export interface operations {
                     "application/json": components["schemas"]["MessageResponse"];
                 };
             };
-            /** @description Internal Server Error */
-            500: {
+        };
+    };
+    landed_cost_views_cancel_landed_cost_allocation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["LandedCostAllocationActionsSchema"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LandedCostAllocationResponseSchema"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessages"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessageResponse"];
+                };
+            };
+            /** @description Not Found */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -89932,6 +91279,8 @@ export interface operations {
                 startDate?: string | null;
                 /** @description End date for custom range (YYYY-MM-DD), this required if the period type is custom */
                 endDate?: string | null;
+                /** @description When true, each GRN line includes finalized `landedCostAllocations` (for LCA picker/history). */
+                landedCostAllocation?: boolean;
             };
             header?: never;
             path?: never;