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

# BasicPurchaseOrderReceipts: Visma.net Financials Basic Purchase Order Receipts

`read only` `REST`

- Catalog: `VismaNet`
- Schema: `PurchaseOrderBasic`
- Label: Basic Purchase Order Receipts

Get a range of Purchase Order - ScreenId=PO301000
Request page size must be lower or equal to the allowed max page size which is returned as part of the metadata information.
If requested page size is greater than allowed max page size, request will be limited to max page size

Can only retrieve data.

## API Source

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

## Performance Characteristics

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

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `branch` | `` | [ ] |  | Filter on Branch |
| `deliveryDate` | `` | [ ] |  | This value indicates the date the document is due for delivery. Use it to retrieve all records that have the delivery 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:_ __DeliveryDate__ and __DeliveryDateCondition__ are __mutually inclusive__. |
| `deliveryDateCondition` | `` | [ ] |  | 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:_ __DeliveryDate__ and __DeliveryDateCondition__ are __mutually inclusive__. |
| `greaterThanValue` | `` | [ ] |  | Filter on order no. and forward |
| `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 |
| `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__. |
| `orderDate` | `` | [ ] |  | This value indicates the order date. Use it to retrieve all records that have the order 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:_ __OrderDate__ and __OrderDateCondition__ are __mutually inclusive__. |
| `orderDateCondition` | `` | [ ] |  | 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:_ __OrderDate__ and __OrderDateCondition__ are __mutually inclusive__. |
| `orderStatus` | `` | [ ] |  | Select and filter on Status. (Values: Balanced, Cancelled, Closed, Hold, Open, PendingEmail, PendingPrint, Printed, Voided) |
| `orderType` | `` | [ ] |  | Select and filter on Type. (Values: RegularOrder, DropShip, Blanket, StandardBlanket) |
| `supplier` | `` | [ ] |  | Filter on Supplier. |

## Table Columns

The columns of the table `BasicPurchaseOrderReceipts` 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. |
| `branch_name` | `varchar2` | Branch Name | [ ] | filters on the platform, writable, `::ancestor.branch.name` | Click the magnifier. &gt; The name. |
| `branch_number` | `varchar2` | Branch Number | [ ] | filters on the platform, writable, `::ancestor.branch.number` | Click the magnifier. &gt; The identifier. |
| `controlTotal` | `double` | Total for Control | [ ] | filters on the platform, writable, `::ancestor.controlTotal` | The top part &gt; Control total &gt; The order's total amount (including VAT), which you must enter manually when you attempt to save the order with the Balanced status. |
| `controlTotalInBaseCurrency` | `double` | itgen_vnet_controltotalinbasecurrency | [ ] | filters on the platform, writable, `::ancestor.controlTotalInBaseCurrency` | The top part &gt; View base &gt; A button that recalculates the Control total to your base currency if the amount on the purchase order is in another currency then base currency. When you click the button, the button toggles to View currency. |
| `currency` | `varchar2` | Currency | [ ] | writable, `currency` | The top part &gt; Currency &gt; The currency the supplier uses for invoicing. |
| `currency_2` | `varchar2` | itgen_vnet_currency_2 | [ ] | filters on the platform, writable, `::ancestor.currency` | The top part &gt; Currency &gt; The currency the purchase order will be paid in. |
| `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 purchase order was created. |
| `description` | `varchar2` | Description | [ ] | filters on the platform, writable, `::ancestor.description` | The top part &gt; Description &gt; A brief description of the purchase order. |
| `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 you select to give the purchase order the On hold status. |
| `lastModifiedDateTime` | `datetime` | Last Modified | [ ] | filters on the platform, writable, `::ancestor.lastModifiedDateTime` | System generated information. |
| `lineTotal` | `double` | Line Total | [ ] | filters on the platform, writable, `::ancestor.lineTotal` | The top part &gt; Line total &gt; The total sum of the Extended amount entries for all lines in the current purchase order. This value is calculated by the system and users cannot manually change it. |
| `lineTotalInBaseCurrency` | `double` | itgen_vnet_linetotalinbasecurrency | [ ] | filters on the platform, writable, `::ancestor.lineTotalInBaseCurrency` | The top part &gt; View base &gt; A button that recalculates the Line total to your base currency if the amount on the purchase order is in another currency then base currency. When you click the button, the button toggles to View currency. |
| `location_id` | `int32` | Location ID | [ ] | filters on the platform, writable, `::ancestor.location.id` | Click the magnifier &gt; The identifier |
| `location_name` | `varchar2` | Location Name | [ ] | 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` | Icon Notes on top of the window &gt; Pop-up window for providing any user-defined text connected to the document. |
| `orderNbr` | `varchar2` | Order Number | [ ] | filters on the platform, writable, `::ancestor.orderNbr` | The top part &gt; Order no. &gt; The unique reference number of the purchase order, which the system assigns based on the number series assigned to purchase orders of this type, as specified in the PO101000 window. |
| `orderTotal` | `double` | Order Total | [ ] | filters on the platform, writable, `::ancestor.orderTotal` | The Top part &gt; Order total &gt; The total sum for the purchase order, including VAT. This read-only value is the sum of the Line total and VAT total values. |
| `orderTotalInBaseCurrency` | `double` | itgen_vnet_ordertotalinbasecurrency | [ ] | filters on the platform, writable, `::ancestor.orderTotalInBaseCurrency` | The top part &gt; View base &gt; A button that recalculates the Order total to your base currency if the amount on the purchase order is in another currency then base currency. When you click the button, the button toggles to View currency. |
| `orderType` | `varchar2` | Order Type | [ ] | filters on the platform, writable, `::ancestor.orderType` | The top part &gt; Type &gt; The type of the purchase order, which can be one of these options: Normal, Drop-ship, Blanket, Default |
| `owner_id` | `guid` | Owner ID | [ ] | filters on the platform, writable, `::ancestor.owner.id` | Click the magnifier &gt; The identifier |
| `owner_name` | `varchar2` | Owner Name | [ ] | filters on the platform, writable, `::ancestor.owner.name` | Click the magnifier &gt; The displayed name |
| `promisedOn` | `datetime` | Promised on | [ ] | filters on the platform, writable, `::ancestor.promisedOn` | The top part &gt; Delivery date &gt; The date when the supplier promised that the items listed in the order will be received at their destination location. |
| `receiptNumber` | `varchar2` | Receipt Number | [ ] | writable, `receiptNumber` | The top part &gt; Receipt no. &gt; The unique reference number of the purchase receipt, transfer receipt, or return, which the system automatically assigns according to its number series. |
| `status` | `varchar2` | Status | [ ] | writable, `status` | The top part &gt; Status &gt; The current status of the purchase or transfer receipt, or return, which the system assigns automatically. |
| `status_2` | `varchar2` | itgen_vnet_status_2 | [ ] | filters on the platform, writable, `::ancestor.status` | The top part &gt; Status &gt; The system-generated status of the purchase order, which can be one of the following options: On hold, Open, Pending approval, Rejected, Pending printing, Pending e-mail, Closed, Cancelled. |
| `supplierName` | `varchar2` | itgen_vnet_suppliername | [ ] | writable, `supplierName` | The top part &gt; Supplier &gt; The supplier from which the items have been received or to which they will be returned. |
| `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 related to this purchase order. |
| `supplier_internalId` | `int32` | Supplier Internal ID | [ ] | filters on the platform, writable, `::ancestor.supplier.internalId` |  |
| `supplier_name` | `varchar2` | Supplier Name | [ ] | filters on the platform, writable, `::ancestor.supplier.name` | The name of the particular destination of the selected type. |
| `supplier_number` | `varchar2` | Supplier Number | [ ] | filters on the platform, writable, `::ancestor.supplier.number` | The identifier of the particular destination of the selected type. |
| `taxTotal` | `double` | Tax Total | [ ] | filters on the platform, writable, `::ancestor.taxTotal` | The Top part &gt; VAT total &gt; The total VAT amount for all lines added to the current purchase order. This value, also calculated by the system, is the sum of the VAT amounts for each line. |
| `taxTotalInBaseCurrency` | `double` | itgen_vnet_taxtotalinbasecurrency | [ ] | filters on the platform, writable, `::ancestor.taxTotalInBaseCurrency` | The top part &gt; View base &gt; A button that recalculates the VAT total to your base currency if the amount on the purchase order is in another currency then base currency. When you click the button, the button toggles to View currency. |
| `timeStamp` | `blob` | Timestamp | [ ] | filters on the platform, writable, `::ancestor.timeStamp` |  |
| `totalAmt` | `double` | Total Amount | [ ] | writable, `totalAmt` | The top part &gt; Total amt. &gt; The total amount calculated for items received from or returned to the supplier; the sum of all amounts of all stock items listed on the Document details tab. |
| `totalQty` | `double` | Total Quantity | [ ] | writable, `totalQty` | The top part &gt; Total qty. &gt; The total quantity of items received from or returned to the supplier; the sum of all quantities of all stock items listed on the Document details tab. |
| `type` | `varchar2` | Type | [ ] | writable, `type` | The top part &gt; Type &gt; The type of the document, which can be Receipt, Return, or Transfer receipt. |
| `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. This total is calculated as the taxable amount for the VAT with the Include in VAT exempt total check box selected in the TX205000 window. |
| `vatExemptTotalInBaseCurrency` | `double` | itgen_vnet_vatexempttotalinbasecurrency | [ ] | filters on the platform, writable, `::ancestor.vatExemptTotalInBaseCurrency` | The top part &gt; View base &gt; A button that recalculates the VAT exempt total to your base currency if the amount on the purchase order is in another currency then base currency. When you click the button, the button toggles to View currency. |

## Keys

| Key | Column | Refers to | Kind | Description |
|---|---|---|---|---|
| `BasicPurchaseOrderReceipts_branch_number_fk` | `branch_number` | [Branches](VismaNet.Branch.Branches)`.number` | Key |  |
| `BasicPurchaseOrderReceipts_supplier_internalId_fk` | `supplier_internalId` | [Suppliers](VismaNet.Supplier.Suppliers)`.internalId` | Key |  |
| `BasicPurchaseOrderReceipts_supplier_number_fk` | `supplier_number` | [Suppliers](VismaNet.Supplier.Suppliers)`.number` | Key |  |



## 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)

