Visma Purchase Receipt Basic API
The PurchaseReceiptBasic API from Visma — 3 operation(s) for purchasereceiptbasic.
Visma Purchase Receipt Basic API is one of 193 APIs that Visma publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include PurchaseReceiptBasic. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, rate-limit docs, and a support channel.
This API exposes 5 operations across 3 paths, and defines 85 schemas. It is described by OpenAPI 3.2.0, at version v1.
Requests are made against a single base URL, https://api.finance.visma.net.
5 operations
3 paths
85 schemas
2 GET2 POST1 PUT
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Visma Purchase Receipt Basic API declares
1 security scheme
for authenticating requests.
It supports OAuth 2.0 (interactiveapi) using the authorizationCode flow, exposing 5 scopes.
Paths & Operations 5
Across 3 paths, the API surfaces 5 operations — 2 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.
PurchaseReceiptBasic 5
GET
/v1/PurchaseReceiptBasic/{receiptNumber}deprecated
Get a specific Purchase Receipt
PUT
/v1/PurchaseReceiptBasic/{receiptNumber}
Update a specific Purchase Receipt
GET
/v1/PurchaseReceiptBasicdeprecated
Get a range with purchase receipts, ScreenId=PO302000 Please use a page size…
POST
/v1/PurchaseReceiptBasic
Create a Purchase Receipt
POST
/v1/PurchaseReceiptBasic/{receiptNumber}/action/release
Release purchase receipt operation
Schemas 85
The contract defines 85 schemas that model the data the API accepts and returns. The most detailed are PurchaseReceiptLineDto (50 properties), PurchaseReceiptLineBasicUpdateDto (45 properties), PurchaseReceiptBasicDto (36 properties), PurchaseReceiptBasicUpdateDto (27 properties). Each schema is shown below with its type and property counts.
warehouseIdInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The warehouse where the item has been received.
1 property
InventoryNumberDescriptionDto
object
2 properties
customStr4InPurchaseReceiptLineBasicUpdateDto
object
A free custom colum of type string with max length 100.
1 property
DtoValueOfString
object
1 property
receiptQtyInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The quantity of the item in the specified UoM that has been received (listed on released receipts).
1 property
postPeriodInPurchaseReceiptBasicUpdateDto
object
The financial period to which the transactions recorded in the document should be posted. Use the format MMYYYY.
1 property
discountCodeIdInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The code of the line discount that has been applied to this line automatically.
1 property
discountAmountInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The automatically calculated or manually entered discount amount on the line.
1 property
transactionDescriptionInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The description of the receipt or return transaction.
1 property
AllocationsDto
object
This class represents a Allocations for Purchase Receipt Line in PurchaseReceiptController. Used for getting data.
8 properties
PurchaseReceiptBasicDto
object
This class represents a Purchase Receipt in PurchaseReceiptController. Used for getting data.
36 properties
completePoLineInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab A check box that indicates to the system (if selected) that the purchase order line added to this receipt line should be considered co…
1 property
manualDiscountInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab A check box that indicates (if selected) that the discount has been applied manually.
1 property
warehouseInPurchaseReceiptBasicDto
object
Mandatory field: The top part or the Documents details tab Warehouse The warehouse from which the items have been received for transfer orders.
2 properties
customInt1InPurchaseReceiptBasicUpdateDto
object
A free custom colum of type int
1 property
poOrderTypeInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The type of the purchase order related to this purchase receipt.
1 property
branchNumberInPurchaseReceiptBasicDto
object
Mandatory field: Document details tab Branch The branch to which the document belongs.
2 properties
accountIdInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The account used to record the item amount on the purchase receipt; used for non-stock items for which receipt is not required.
1 property
customInt2InPurchaseReceiptLineBasicUpdateDto
object
A free custom colum of type int
1 property
locationIdInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The location where the item has been received.
1 property
branchInPurchaseReceiptLineDto
object
Branch is deprecated, please use BranchNumber instead.
2 properties
customDateTimeUTC1InPurchaseReceiptLineBasicUpdateDto
object
A free custom colum of type DateTime - in UTC timezone
1 property
taxCategoryIdInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The VAT category assigned to the stock item.
1 property
uomInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The unit of measure (UoM) used for the purchased or transferred item. By default, it is the purchase unit.
1 property
lineTypeInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The type of the purchase receipt line.
1 property
customInt2InPurchaseReceiptBasicUpdateDto
object
A free custom colum of type int
1 property
locationInPurchaseReceiptBasicDto
object
Mandatory field: The top part Location The supplier location from which the items should be received or to which they should be returned.
3 properties
PurchaseReceiptLineBasicUpdateDto
object
This class represents a Purchase Receipt Line in PurchaseReceiptBasicContraoller. Used for adding data.
45 properties
customInt1InPurchaseReceiptLineBasicUpdateDto
object
A free custom colum of type int
1 property
customStr2InPurchaseReceiptBasicUpdateDto
object
A free custom colum of type string with max length 100.
1 property
poOrderLineNbrInPurchaseReceiptLineBasicUpdateDto
object
This property replaced by an action please use the following sub-endpoint:/controller/api/v1/PurchaseReceipt/{receiptNumber}/action/addpurchaseorderlines
1 property
DtoValueOfNullableOfDateTime
object
1 property
customDec2InPurchaseReceiptBasicUpdateDto
object
A free custom colum of type decimal with max 4 decimals.
1 property
actualSubInPurchaseReceiptLineDto
object
Document details tab Accrual sub. The subaccount used to record the item amount on the purchase receipt, used for stock items and non-stock items for which a r…
3 properties
subInPurchaseReceiptLineDto
object
Document details tab Sub ID The subaccount to be used to record the non-stock item amount on the purchase receipt (for non-stock items for which receipts are n…
3 properties
customStr1InPurchaseReceiptLineBasicUpdateDto
object
A free custom colum of type string with max length 100.
1 property
actualAccountInPurchaseReceiptLineDto
object
Document details tab Accrual account The accrual account to record the item amount on the purchase receipt; used for stock items and non-stock items for which…
3 properties
customDateTimeUTC1InPurchaseReceiptBasicUpdateDto
object
A free custom colum of type DateTime - in UTC timezone
1 property
accountDescriptionInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The description of this account.
1 property
taxCategoryInPurchaseReceiptLineDto
object
Document details tab VAT category The VAT category assigned to the stock item.
2 properties
DtoValueOfPurchaseReceiptType
object
1 property
customStr2InPurchaseReceiptLineBasicUpdateDto
object
A free custom colum of type string with max length 100.
1 property
accountInPurchaseReceiptLineDto
object
Document details tab Account The account used to record the item amount on the purchase receipt;
3 properties
customStr3InPurchaseReceiptLineBasicUpdateDto
object
A free custom colum of type string with max length 100.
1 property
branchNumberInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The number of the branch to which the purchase receipt line belongs.
1 property
SegmentUpdateDto
object
2 properties
inventoryIdInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The item ID of the received item.
1 property
transferOrderNbrInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The reference number of the transfer order to which this receipt is linked.
1 property
DtoValueOfNullableOfDecimal
object
1 property
customStr3InPurchaseReceiptBasicUpdateDto
object
A free custom colum of type string with max length 100.
1 property
transferOrderLineNbrInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The line number in the transfer order to which this receipt is linked.
1 property
projectInPurchaseReceiptLineDto
object
Document details tab Project The project with which the document is associated. If the document is based on a purchase order, the project is automatically copi…
3 properties
lineNbrInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The number of the purchase receipt line.
1 property
DtoValueOfNullableOfBoolean
object
1 property
customStr5InPurchaseReceiptLineBasicUpdateDto
object
A free custom colum of type string with max length 100.
1 property
warehouseInPurchaseReceiptLineDto
object
Mandatory field: Document details tab Warehouse The warehouse where the item has been received.
2 properties
MetadataDto
object
2 properties
actualAccountIdInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The accrual account to record the item amount on the purchase receipt; used for stock items and non-stock items for which a receipt is…
1 property
PurchaseReceiptBasicUpdateDto
object
This class represents a Purchase Receipt in PurchaseReceiptBasicController. Used for adding data.
27 properties
customDec1InPurchaseReceiptBasicUpdateDto
object
A free custom colum of type decimal with max 4 decimals.
1 property
customDec2InPurchaseReceiptLineBasicUpdateDto
object
A free custom colum of type decimal with max 4 decimals.
1 property
expirationDateInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The expiration date of the received item.
1 property
customStr1InPurchaseReceiptBasicUpdateDto
object
A free custom colum of type string with max length 100.
1 property
lotSerialNumberInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The lot or serial number assigned to the received quantity of the purchased item;
1 property
branchNumberInPurchaseReceiptLineDto
object
Mandatory field: Document details tab Branch The branch for which the item is purchased.
2 properties
PurchaseReceiptLineDto
object
This class represents a Purchase Order Line in PurchaseReceiptContraoller. Used for getting data.
50 properties
customStr4InPurchaseReceiptBasicUpdateDto
object
A free custom colum of type string with max length 100.
1 property
customDec1InPurchaseReceiptLineBasicUpdateDto
object
A free custom colum of type decimal with max 4 decimals.
1 property
supplierInPurchaseReceiptBasicDto
object
Mandatory field: The top part Supplier The supplier from which the items have been received or to which they will be returned.
3 properties
projectTaskIdInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The project task with which the document is associated.
1 property
customStr5InPurchaseReceiptBasicUpdateDto
object
A free custom colum of type string with max length 100.
1 property
discountCodeInPurchaseReceiptLineDto
object
Document details tab Discount code The code of the line discount that has been applied to this line automatically.
2 properties
BackgroundApiAcceptedDto
object
2 properties
discountPercentInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The automatically calculated or manually entered discount percent on the line.
1 property
unitCostInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The cost of a unit of the purchased item.
1 property
transferOrderTypeInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The type of the transfer order to which this receipt is linked.
1 property
projectTaskInPurchaseReceiptLineDto
object
Document details tab Project task The project task with which the document is associated.
3 properties
poOrderNbrInPurchaseReceiptLineBasicUpdateDto
object
This property replaced by an action, please use the following sub-endpoint:/controller/api/v1/PurchaseReceipt/{receiptNumber}/action/addpurchaseorder.
1 property
locationInPurchaseReceiptLineDto
object
Document details tab Location The location where the item has been received.
3 properties
amountInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The amount calculated (after discount has been taken) for the item.
1 property
extCostInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The extended cost of the item, which is the unit price multiplied by the quantity.
1 property
locationInAllocationsDto
object
Location The location in the warehouse.
3 properties
branchIdInPurchaseReceiptLineBasicUpdateDto
object
BranchId is deprecated, please use BranchNumber instead.
1 property
ReleasePurchaseReceiptActionResultDto
object
3 properties
projectIdInPurchaseReceiptLineBasicUpdateDto
object
The Document details tab The project with which the document is associated.
1 property
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Visma 12
Other APIs Visma publishes across the network.
Visma Business NXT GraphQL API
Visma Account API
Visma Accounts API
Visma Agreements API
Visma Allocation Periods API
Visma Approval API
Visma App Store Activation Status API
Visma Article Account Codings API
Visma Article Labels API
Visma Articles API
Visma Attachment API
Visma Attachment Links API
#PurchaseReceiptBasic
Where this information came from
This is an independent, third-party profile of Visma Purchase Receipt Basic API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.