---
title: "BasicPurchaseReceiptLandCosts (Visma.net Financials)"
description: "Basic Purchase Receipt Landed Costs"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/vismanet/VismaNet.PurchaseReceipt.BasicPurchaseReceiptLandCosts
original: https://documentation.invantive.eu/en/datamodels/vismanet/VismaNet.PurchaseReceipt.BasicPurchaseReceiptLandCosts
updated: 2026-11-01T17:49:50Z
license: https://documentation.invantive.eu/en/
---

# BasicPurchaseReceiptLandCosts: Visma.net Financials Basic Purchase Receipt Landed Costs

`read only` `REST`

- Catalog: `VismaNet`
- Schema: `PurchaseReceipt`
- Label: Basic Purchase Receipt Landed Costs

Get a range of Purchase Receipts - ScreenId=PO302000
Please use a page size lower or equal to the allowed max page size which is 500
This method will be removed starting 15th September 2026. Please use GET api/v2/PurchaseReceipt instead.

Can only retrieve data.

## Summary

This method will be removed starting 15th September 2026. Please use GET api/v2/PurchaseReceipt instead.

## API Source

- Endpoint: `/v1/PurchaseReceipt`
- Operation: `get /v1/PurchaseReceipt`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 155 |
| Full scan rows per minute | 29,100 |
| Point query rows per minute | 387 |

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `branch` | `` | [ ] |  |  |
| `dueDate` | `` | [ ] |  | This value indicates the date the document is due. Use it to retrieve all records that have the due date since that time, up to the future.  Accepted format: * ```yyyy-MM-dd``` * ```yyyy-MM-dd HH:mm:ss``` * ```yyyy-MM-dd HH:mm:ss.FFF``` * ```yyyy-MM-ddTHH:mm:ss``` * ```yyyy-MM-ddTHH:mm:ss.FFF```  _Note:_ __DueDate__ and __DueDateCondition__ are __mutually inclusive__. |
| `dueDateCondition` | `` | [ ] |  | This value represents the condition to be applied to the Due Date when retrieving records.  Accepted values (without the single quotes): * '&gt;' for greater than * '&lt;' for less than * '&gt;=' for greater than or equal * '&lt;=' for less than or equal  _Note:_ __DueDate__ and __DueDateCondition__ are __mutually inclusive__. |
| `finPeriod` | `` | [ ] |  | Filter by financial period, format YYYYPP |
| `greaterThanValue` | `` | [ ] |  |  |
| `includeCustomFreeFields` | `` | [ ] |  | Parameter to include custom free fields information in the result set, if true then custom free fields will be included in the result set Works only with PurchaseRecieptBasic and v2 of PurchaseReceipts. |
| `lastModifiedDateTime` | `` | [ ] |  | This value, generated by the system, indicates the last time the record was modified. Use it to retrieve all records that have been modified since that time, up to the present.  Accepted format: * ```yyyy-MM-dd``` * ```yyyy-MM-dd HH:mm:ss``` * ```yyyy-MM-dd HH:mm:ss.FFF``` * ```yyyy-MM-ddTHH:mm:ss``` * ```yyyy-MM-ddTHH:mm:ss.FFF```  _Note:_ __LastModifiedDateTime__ and __LastModifiedDateTimeCondition__ are __mutually inclusive__. |
| `lastModifiedDateTimeCondition` | `` | [ ] |  | This value represents the condition to be applied when retrieving records.  Accepted values (without the single quotes): * '&gt;' for greater than * '&lt;' for less than * '&gt;=' for greater than or equal * '&lt;=' for less than or equal  _Note:_ __LastModifiedDateTime__ and __LastModifiedDateTimeCondition__ are __mutually inclusive__. |
| `poOrderNbr` | `` | [ ] |  |  |
| `receiptDate` | `` | [ ] |  | This value indicates the receipt date. Use it to retrieve all records that have the receipt date since that time, up to the future.  Accepted format: * ```yyyy-MM-dd``` * ```yyyy-MM-dd HH:mm:ss``` * ```yyyy-MM-dd HH:mm:ss.FFF``` * ```yyyy-MM-ddTHH:mm:ss``` * ```yyyy-MM-ddTHH:mm:ss.FFF```  _Note:_ __ReceiptDate__ and __ReceiptDateCondition__ are __mutually inclusive__. |
| `receiptDateCondition` | `` | [ ] |  | This value represents the condition to be applied to the order date when retrieving records.  Accepted values (without the single quotes): * '&gt;' for greater than * '&lt;' for less than * '&gt;=' for greater than or equal * '&lt;=' for less than or equal  _Note:_ __ReceiptDate__ and __ReceiptDateCondition__ are __mutually inclusive__. |
| `receiptType` | `` | [ ] |  | Values: PoReceipt, PoReturn, TransferReceipt. |
| `status` | `` | [ ] |  | Values: Hold, Balanced, Released, Cancelled. |
| `supplier` | `` | [ ] |  |  |

## Table Columns

The columns of the table `BasicPurchaseReceiptLandCosts` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `COMPANY_CODE` | `varchar2(30)` | Company Code | [x] | writable | Partition code, segmenting the data. |
| `COMPANY_NAME` | `varchar2(240)` | Company Name | [x] | writable | Name of the partition. |
| `amount` | `double` | Amount | [ ] | writable, `amount` | Landed costs tab &gt; Amount &gt; A non-zero amount of the landed cost. |
| `apBillDate` | `datetime` | itgen_vnet_apbilldate | [ ] | writable, `apBillDate` | Landed costs tab &gt; Purchase invoice date &gt; The date of the purchase invoice for the landed cost. |
| `apDocType` | `varchar2` | itgen_vnet_apdoctype | [ ] | writable, `apDocType` | Landed costs tab &gt; Supplier document type &gt; The type of the supplier document generated for the landed cost. |
| `apRefNbr` | `varchar2` | itgen_vnet_aprefnbr | [ ] | writable, `apRefNbr` | Landed costs tab &gt; Supplier ref. &gt; The reference number of the supplier document generated for the landed cost. |
| `branchNumber_name` | `varchar2` | Branch Name | [ ] | filters on the platform, writable, `::ancestor.branchNumber.name` | Click the magnifier. &gt; The name. |
| `branchNumber_number` | `varchar2` | Branch Number | [ ] | filters on the platform, writable, `::ancestor.branchNumber.number` | Click the magnifier. &gt; The identifier. |
| `controlQty` | `double` | itgen_vnet_controlqty | [ ] | filters on the platform, writable, `::ancestor.controlQty` | The top part &gt; Control qty. &gt; The total quantity of goods on the receipt or return |
| `controlTotal` | `double` | Total for Control | [ ] | filters on the platform, writable, `::ancestor.controlTotal` | The top part &gt; Control amt. &gt; The total amount of the receipt or return, which you manually enter. |
| `createBill` | `char` | Create Bill | [ ] | filters on the platform, writable, `::ancestor.createBill` | The top part &gt; Create invoice &gt; A check box that you select if the system must create an appropriate invoice (or adjustment) automatically when the purchase receipt is released. |
| `currency` | `varchar2` | Currency | [ ] | writable, `currency` | Landed costs tab &gt; Currency &gt; The currency used for the landed cost. |
| `currency_2` | `varchar2` | itgen_vnet_currency_2 | [ ] | filters on the platform, writable, `::ancestor.currency` | The top part &gt; Currency &gt; The currency the supplier uses for invoicing. |
| `customDateTimeUTC1` | `datetime` | itgen_vnet_customdatetimeutc1 | [ ] | filters on the platform, writable, `::ancestor.customDateTimeUTC1` | A free custom colum of type DateTime - in UTC timezone |
| `customDec1` | `double` | itgen_vnet_customdec1 | [ ] | filters on the platform, writable, `::ancestor.customDec1` | A free custom colum of type decimal with max 4 decimals. |
| `customDec2` | `double` | itgen_vnet_customdec2 | [ ] | filters on the platform, writable, `::ancestor.customDec2` | A free custom colum of type decimal with max 4 decimals. |
| `customInt1` | `int32` | itgen_vnet_customint1 | [ ] | filters on the platform, writable, `::ancestor.customInt1` | A free custom colum of type int |
| `customInt2` | `int32` | itgen_vnet_customint2 | [ ] | filters on the platform, writable, `::ancestor.customInt2` | A free custom colum of type int |
| `customStr1` | `varchar2` | itgen_vnet_customstr1 | [ ] | filters on the platform, writable, `::ancestor.customStr1` | A free custom colum of type string with max length 100. |
| `customStr2` | `varchar2` | itgen_vnet_customstr2 | [ ] | filters on the platform, writable, `::ancestor.customStr2` | A free custom colum of type string with max length 100. |
| `customStr3` | `varchar2` | itgen_vnet_customstr3 | [ ] | filters on the platform, writable, `::ancestor.customStr3` | A free custom colum of type string with max length 100. |
| `customStr4` | `varchar2` | itgen_vnet_customstr4 | [ ] | filters on the platform, writable, `::ancestor.customStr4` | A free custom colum of type string with max length 100. |
| `customStr5` | `varchar2` | itgen_vnet_customstr5 | [ ] | filters on the platform, writable, `::ancestor.customStr5` | A free custom colum of type string with max length 100. |
| `date` | `datetime` | Date | [ ] | filters on the platform, writable, `::ancestor.date` | Mandatory field: The top part &gt; Date* &gt; The date when the receipt document was created. |
| `description` | `varchar2` | Description | [ ] | writable, `description` | Mandatory field: Landed costs tab &gt; Description* &gt; The description of the landed cost code. |
| `dueDate` | `datetime` | Due Date | [ ] | filters on the platform, writable, `::ancestor.dueDate` | This value indicates the date the document is due |
| `errorInfo` | `varchar2` | Error Message | [ ] | filters on the platform, writable, `::ancestor.errorInfo` |  |
| `exchangeRate` | `double` | Exchange Rate | [ ] | filters on the platform, writable, `::ancestor.exchangeRate` |  |
| `hold` | `char` | Hold | [ ] | filters on the platform, writable, `::ancestor.hold` | The top part &gt; Hold &gt; A check box that indicates (if selected) that the document has the On hold status. |
| `inDocType` | `varchar2` | itgen_vnet_indoctype | [ ] | writable, `inDocType` | Landed costs tab &gt; Inventory doc. type &gt; The type of the document generated in the Inventory workspace for this landed cost. |
| `inRefNbr` | `varchar2` | itgen_vnet_inrefnbr | [ ] | writable, `inRefNbr` | Landed costs tab &gt; Inventory ref. no. &gt; The reference number of the document generated in the Inventory workspace for this landed cost. |
| `inventory_description` | `varchar2` | Inventory Description | [ ] | writable, `inventory.description` | Name of item/description |
| `inventory_number` | `varchar2` | Inventory Number | [ ] | writable, `inventory.number` | Number of item |
| `landedCostCode` | `varchar2` | itgen_vnet_landedcostcode | [ ] | writable, `landedCostCode` | Mandatory field: Landed costs tab &gt; Landed costs* &gt; Landed cost code &gt; The landed cost code associated with the landed costs incurred for this purchase or transfer receipt. |
| `lastModifiedDateTime` | `datetime` | Last Modified | [ ] | filters on the platform, writable, `::ancestor.lastModifiedDateTime` | System generated information. |
| `lineNbr` | `int32` | itgen_vnet_linenbr | [ ] | writable, `lineNbr` | Landed costs tab &gt; Line number |
| `location_countryId` | `varchar2` | Location Country ID | [ ] | writable, `location.countryId` | Location*. |
| `location_countryId_2` | `varchar2` | Location Country ID 2 | [ ] | filters on the platform, writable, `::ancestor.location.countryId` | Location*. |
| `location_id` | `varchar2` | Location ID | [ ] | writable, `location.id` | Click the magnifier &gt; The identifier |
| `location_id_2` | `varchar2` | Location ID 2 | [ ] | filters on the platform, writable, `::ancestor.location.id` | Click the magnifier &gt; The identifier |
| `location_name` | `varchar2` | Location Name | [ ] | writable, `location.name` | Click the magnifier &gt; The displayed name |
| `location_name_2` | `varchar2` | Location Name 2 | [ ] | filters on the platform, writable, `::ancestor.location.name` | Click the magnifier &gt; The displayed name |
| `metadata_maxPageSize` | `int64` | Metadata Max Pagesize | [ ] | filters on the platform, writable, `::ancestor.metadata.maxPageSize` |  |
| `metadata_totalCount` | `int64` | Total Count | [ ] | filters on the platform, writable, `::ancestor.metadata.totalCount` |  |
| `note` | `varchar2` | Note | [ ] | filters on the platform, writable, `::ancestor.note` |  |
| `postPeriod` | `varchar2` | Post Period | [ ] | filters on the platform, writable, `::ancestor.postPeriod` | Mandatory field: The top part &gt; Post period* &gt; The financial period to which the transactions recorded in the document should be posted. Format MMYYYY. |
| `postponePurchaseInvoiceCreation` | `char` | itgen_vnet_postponepurchaseinvoicecreation | [ ] | writable, `postponePurchaseInvoiceCreation` | Landed costs tab &gt; Postpone creation of purchase invoice &gt; A check box that indicates (if selected) that a related supplier ledger invoice for the incurred landed costs must be created later. |
| `purchaseInvoiceNbr` | `varchar2` | itgen_vnet_purchaseinvoicenbr | [ ] | writable, `purchaseInvoiceNbr` |  |
| `receiptNbr` | `varchar2` | Receipt Number | [ ] | filters on the platform, writable, `::ancestor.receiptNbr` | The top part &gt; Receipt no. &gt; The unique reference number of the purchase receipt. |
| `receiptType` | `varchar2` | Receipt Type | [ ] | filters on the platform, writable, `::ancestor.receiptType` | The top part &gt; Type &gt; The type of the document, which can be one of the following options: Receipt, Return, Transfer receipt. |
| `status` | `varchar2` | Status | [ ] | filters on the platform, writable, `::ancestor.status` | The top part &gt; Status &gt; The current status of the purchase or transfer receipt, or return, which the system assigns automatically. On hold, Balanced, Released. |
| `supplierRef` | `varchar2` | Supplier Reference | [ ] | filters on the platform, writable, `::ancestor.supplierRef` | The top part &gt; Supplier ref. &gt; The reference number of the supplier document this receipt or return is based on. |
| `supplier_internalId` | `int32` | Supplier Internal ID | [ ] | writable, `supplier.internalId` |  |
| `supplier_internalId_2` | `int32` | itgen_vnet_supplier_internalid_2 | [ ] | filters on the platform, writable, `::ancestor.supplier.internalId` |  |
| `supplier_name` | `varchar2` | Supplier Name | [ ] | writable, `supplier.name` | The name of the particular destination of the selected type. |
| `supplier_name_2` | `varchar2` | itgen_vnet_supplier_name_2 | [ ] | filters on the platform, writable, `::ancestor.supplier.name` | The name of the particular destination of the selected type. |
| `supplier_number` | `varchar2` | Supplier Number | [ ] | writable, `supplier.number` | The identifier of the particular destination of the selected type. |
| `supplier_number_2` | `varchar2` | itgen_vnet_supplier_number_2 | [ ] | filters on the platform, writable, `::ancestor.supplier.number` | The identifier of the particular destination of the selected type. |
| `taxCategory_description` | `varchar2` | itgen_vnet_taxcategory_description | [ ] | writable, `taxCategory.description` | Name of item/description |
| `taxCategory_number` | `varchar2` | itgen_vnet_taxcategory_number | [ ] | writable, `taxCategory.number` | Number of item |
| `terms_description` | `varchar2` | Terms Description | [ ] | writable, `terms.description` | Click on the magnifier. &gt; The description. |
| `terms_id` | `varchar2` | Terms ID | [ ] | writable, `terms.id` | Click on the magnifier. &gt; The identifier. |
| `timeStamp` | `blob` | Timestamp | [ ] | filters on the platform, writable, `::ancestor.timeStamp` | The top part &gt; Tstamp &gt; The timestamp of the purchase receipt. |
| `totalAmt` | `double` | Total Amount | [ ] | filters on the platform, writable, `::ancestor.totalAmt` | The top part &gt; Total amt. &gt; The total amount calculated for items received from or returned to the supplier. |
| `totalQty` | `double` | Total Quantity | [ ] | filters on the platform, writable, `::ancestor.totalQty` | The top part &gt; Total qty. &gt; The total quantity of items received from or returned to the supplier. |
| `vatExemptTotal` | `double` | VAT Exempt Total | [ ] | filters on the platform, writable, `::ancestor.vatExemptTotal` | The top part &gt; VAT exempt total &gt; The document total that is exempt from VAT. |
| `vatTaxableTotal` | `double` | VAT Taxable Total | [ ] | filters on the platform, writable, `::ancestor.vatTaxableTotal` | The top part &gt; VAT taxable total &gt; The document total that is subjected to VAT. |
| `warehouse_description` | `varchar2` | Warehouse Description | [ ] | filters on the platform, writable, `::ancestor.warehouse.description` | Click on the magnifier. &gt; The description. |
| `warehouse_id` | `varchar2` | Warehouse ID | [ ] | filters on the platform, writable, `::ancestor.warehouse.id` | Click on the magnifier. &gt; The identifier. |



## Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

- [Visma.net Financials](/en/release-notes/drivers?driver=visma-net-financials)

