---
title: "PurchaseReceiptBasicPurchaseReceiptBasicByreceiptNumber (Visma.net Financials)"
description: "itgen_vnet_purchasereceiptbasicpurchasereceiptbasicbyreceiptnumber_plural"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/vismanet/VismaNet.PurchaseReceiptBasic.PurchaseReceiptBasicPurchaseReceiptBasicByreceiptNumber
original: https://documentation.invantive.eu/en/datamodels/vismanet/VismaNet.PurchaseReceiptBasic.PurchaseReceiptBasicPurchaseReceiptBasicByreceiptNumber
updated: 2026-11-01T17:49:50Z
license: https://documentation.invantive.eu/en/
---

# PurchaseReceiptBasicPurchaseReceiptBasicByreceiptNumber: Visma.net Financials itgen_vnet_purchasereceiptbasicpurchasereceiptbasicbyreceiptnumber_plural

`read only` `REST`

- Catalog: `VismaNet`
- Schema: `PurchaseReceiptBasic`
- Label: itgen_vnet_purchasereceiptbasicpurchasereceiptbasicbyreceiptnumber_plural

Get a specific Purchase Receipt
Data for a single Purchase Receipt Basic. 
The response headers include an ETag after a successful GET operation.This method will be removed starting 15th September 2026. Please use GET api/v2/PurchaseReceipt instead.

Can only retrieve data.

## Summary

Data for a single Purchase Receipt Basic. <br></br>
The response headers include an ETag after a successful GET operation.This method will be removed starting 15th September 2026. Please use GET api/v2/PurchaseReceipt instead.

## API Source

- Endpoint: `/v1/PurchaseReceiptBasic/{receiptNumber}`
- Operation: `get /v1/PurchaseReceiptBasic/{receiptNumber}`

## 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 |
|---|---|:---:|---|---|
| `includeCustomFreeFields` | `` | [ ] |  | Optional parameter to request custom free fields. |
| `receiptNumber` | `` | [x] |  | Identifies the Purchase Receipt |

## Table Columns

The columns of the table `PurchaseReceiptBasicPurchaseReceiptBasicByreceiptNumber` 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. |
| `branchNumber_name` | `varchar2` | Branch Name | [ ] | filters on the platform, writable, `branchNumber.name` | Click the magnifier. &gt; The name. |
| `branchNumber_number` | `varchar2` | Branch Number | [ ] | filters on the platform, writable, `branchNumber.number` | Click the magnifier. &gt; The identifier. |
| `controlQty` | `double` | itgen_vnet_controlqty | [ ] | filters on the platform, writable, `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, `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, `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 | [ ] | filters on the platform, writable, `currency` | The top part &gt; Currency &gt; The currency the supplier uses for invoicing. |
| `customDateTimeUTC1` | `datetime` | itgen_vnet_customdatetimeutc1 | [ ] | filters on the platform, writable, `customDateTimeUTC1` | A free custom colum of type DateTime - in UTC timezone |
| `customDec1` | `double` | itgen_vnet_customdec1 | [ ] | filters on the platform, writable, `customDec1` | A free custom colum of type decimal with max 4 decimals. |
| `customDec2` | `double` | itgen_vnet_customdec2 | [ ] | filters on the platform, writable, `customDec2` | A free custom colum of type decimal with max 4 decimals. |
| `customInt1` | `int32` | itgen_vnet_customint1 | [ ] | filters on the platform, writable, `customInt1` | A free custom colum of type int |
| `customInt2` | `int32` | itgen_vnet_customint2 | [ ] | filters on the platform, writable, `customInt2` | A free custom colum of type int |
| `customStr1` | `varchar2` | itgen_vnet_customstr1 | [ ] | filters on the platform, writable, `customStr1` | A free custom colum of type string with max length 100. |
| `customStr2` | `varchar2` | itgen_vnet_customstr2 | [ ] | filters on the platform, writable, `customStr2` | A free custom colum of type string with max length 100. |
| `customStr3` | `varchar2` | itgen_vnet_customstr3 | [ ] | filters on the platform, writable, `customStr3` | A free custom colum of type string with max length 100. |
| `customStr4` | `varchar2` | itgen_vnet_customstr4 | [ ] | filters on the platform, writable, `customStr4` | A free custom colum of type string with max length 100. |
| `customStr5` | `varchar2` | itgen_vnet_customstr5 | [ ] | filters on the platform, writable, `customStr5` | A free custom colum of type string with max length 100. |
| `date` | `datetime` | Date | [ ] | filters on the platform, writable, `date` | Mandatory field: The top part &gt; Date* &gt; The date when the receipt document was created. |
| `dueDate` | `datetime` | Due Date | [ ] | filters on the platform, writable, `dueDate` | This value indicates the date the document is due |
| `errorInfo` | `varchar2` | Error Message | [ ] | filters on the platform, writable, `errorInfo` |  |
| `exchangeRate` | `double` | Exchange Rate | [ ] | filters on the platform, writable, `exchangeRate` |  |
| `hold` | `char` | Hold | [ ] | filters on the platform, writable, `hold` | The top part &gt; Hold &gt; A check box that indicates (if selected) that the document has the On hold status. |
| `lastModifiedDateTime` | `datetime` | Last Modified | [ ] | filters on the platform, writable, `lastModifiedDateTime` | System generated information. |
| `location_countryId` | `varchar2` | Location Country ID | [ ] | filters on the platform, writable, `location.countryId` | Location*. |
| `location_id` | `varchar2` | Location ID | [ ] | filters on the platform, writable, `location.id` | Click the magnifier &gt; The identifier |
| `location_name` | `varchar2` | Location Name | [ ] | filters on the platform, writable, `location.name` | Click the magnifier &gt; The displayed name |
| `metadata_maxPageSize` | `int64` | Metadata Max Pagesize | [ ] | filters on the platform, writable, `metadata.maxPageSize` |  |
| `metadata_totalCount` | `int64` | Total Count | [ ] | filters on the platform, writable, `metadata.totalCount` |  |
| `postPeriod` | `varchar2` | Post Period | [ ] | filters on the platform, writable, `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. |
| `receiptNbr` | `varchar2` | Receipt Number | [ ] | filters on the platform, writable, `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, `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, `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, `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 | [ ] | filters on the platform, writable, `supplier.internalId` |  |
| `supplier_name` | `varchar2` | Supplier Name | [ ] | filters on the platform, writable, `supplier.name` | The name of the particular destination of the selected type. |
| `supplier_number` | `varchar2` | Supplier Number | [ ] | filters on the platform, writable, `supplier.number` | The identifier of the particular destination of the selected type. |
| `timeStamp` | `blob` | Timestamp | [ ] | filters on the platform, writable, `timeStamp` | The top part &gt; Tstamp &gt; The timestamp of the purchase receipt. |
| `totalAmt` | `double` | Total Amount | [ ] | filters on the platform, writable, `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, `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, `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, `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, `warehouse.description` | Click on the magnifier. &gt; The description. |
| `warehouse_id` | `varchar2` | Warehouse ID | [ ] | filters on the platform, writable, `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)

