How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Visma Purchase Order API

The Purchase Order API from Visma — 3 operation(s) for purchase order.

Visma Purchase Order API is one of 193 APIs that Visma publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Purchase Order. 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 77 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 77 schemas 2 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v1
Base URL
https://business.visma.net/api/graphql
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Visma Purchase Order 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.

Purchase Order 5
GET
/v1/purchaseorder/{purchaseOrderNumber}
Get a specific Purchase Order
PurchaseOrder_GetOrderBypurchaseOrderNumber 3 params → 200202
PUT
/v1/purchaseorder/{purchaseOrderNumber}
Update a Purchase Order
PurchaseOrder_PutBypurchaseOrderNumber 3 params body → 204412202
GET
/v1/purchaseorder
Get a range of Purchase Order - ScreenId=PO301000 Request page size must be…
PurchaseOrder_GetAllOrder 17 params → 200202
POST
/v1/purchaseorder
Create a Purchase Order
PurchaseOrder_Post 1 param body → 201202
POST
/v1/purchaseorder/{purchaseorderNbr}/action/createpurchasereceipt
Creates a purchase receipt from an existing purchase order
PurchaseOrder_CreatePurchaseReceiptFromPurchaseOrderBypurchaseorderNbr 2 params body → 200202

Schemas 77

The contract defines 77 schemas that model the data the API accepts and returns. The most detailed are PurchaseOrderDto (67 properties), PurchaseOrderLineDto (47 properties), PurchaseOrderUpdateDto (46 properties), PurchaseOrderLineUpdateDto (40 properties). Each schema is shown below with its type and property counts.

customInt1InPurchaseOrderLineUpdateDto
object
A free custom colum of type int
1 property
remitContactInPurchaseOrderDto
object
Supplier info tab The Supplier contact section The default contact settings for the supplier.
9 properties
CreatePurchaseReceiptActionDto
object
1 property 1 required
DtoValueOfString
object
1 property
countyInPurchaseOrderAddressDto
object
County The county or province.
2 properties
DtoValueOfNullableOfPoLineType
object
1 property
TaxDetailDto
object
This class represents a VAT Detail Line. Used for getting data.
7 properties
inventoryInPurchaseOrderLineDto
object
Item ID The ID of the item.
2 properties
customDec2InPurchaseOrderLineUpdateDto
object
A free custom colum of type decimal with max 4 decimals.
1 property
customStr3InPurchaseOrderLineUpdateDto
object
A free custom colum of type string with max length 100.
1 property
PurchaseOrderDto
object
This class represents a Purchase Order in PurchaseOrderController. Used for getting data.
67 properties
PurchaseOrderUpdateDto
object
This class represent a Purchase Order in Purchase Order Controller. Used to pass data to server for creating or updating an order
46 properties
DtoValueOfNullableOfInt32
object
1 property
glnInPurchaseOrderUpdateDto
object
Mandatory field if Supplier or VatRegistrationId is not specified.
1 property
countryInPurchaseOrderAddressDto
object
Country The country.
4 properties
DtoValueOfPurchaseOrderAddressUpdateDto
object
1 property
projectTaskInPurchaseOrderLineDto
object
Project task The project task with which this purchase order is associated.
3 properties
supplierInPurchaseOrderDto
object
Mandatory field: The top part Supplier The supplier from which the items will be purchased.
3 properties
customInt1InPurchaseOrderUpdateDto
object
A free custom colum of type int
1 property
customDateTimeUTC1InPurchaseOrderUpdateDto
object
A free custom colum of type DateTime - in UTC timezone
1 property
subInPurchaseOrderLineDto
object
Sub. ID The subaccount used to record the purchased non-stock item that does not require receipt (by default, the subaccount generated in accordance with the r…
9 properties
customStr5InPurchaseOrderLineUpdateDto
object
A free custom colum of type string with max length 100.
1 property
customStr3InPurchaseOrderUpdateDto
object
A free custom colum of type string with max length 100.
1 property
DtoValueOfPurchaseOrderContactUpdateDto
object
1 property
branchInPurchaseOrderLineDto
object
Branch The branch associated with the purchase order.
2 properties
supplierInPurchaseOrderUpdateDto
object
Mandatory field if GLN or VatRegistrationId is not specified.
1 property
termsInPurchaseOrderDto
object
Mandatory field: The Supplier info tab The Info section Terms The specific credit terms to be used for the purchase order.
2 properties
ownerInPurchaseOrderDto
object
The top part Owner The employee who is responsible for the purchase order.
2 properties
locationInPurchaseOrderDto
object
Mandatory field: The top part Location Click the magnifier. The supplier location from which the items will be received.
2 properties
DtoValueOfNullableOfPOShippingDestinationType
object
1 property
PurchaseOrderLineUpdateDto
object
This class represent a Purchase Order Line in Purchase Order Controller. Used to pass data to server for creating or updating an order line
40 properties
customDec1InPurchaseOrderLineUpdateDto
object
A free custom colum of type decimal with max 4 decimals.
1 property
customDec1InPurchaseOrderUpdateDto
object
A free custom colum of type decimal with max 4 decimals.
1 property
customStr2InPurchaseOrderLineUpdateDto
object
A free custom colum of type string with max length 100.
1 property
shippingLocationInPurchaseOrderDto
object
Mandatory field: The Shipping instructions tab The Delivery address section Shipping location The location from which the order is to be shipped.
2 properties
vatRegistrationIdInPurchaseOrderUpdateDto
object
Mandatory field if Supplier or GLN is not specified.
1 property
shippingContactInPurchaseOrderDto
object
Supplier information tab The Supplier contact section The supplier contact for matters related to this purchase order.
9 properties
DtoValueOfNullableOfDateTime
object
1 property
customInt2InPurchaseOrderUpdateDto
object
A free custom colum of type int
1 property
TaxCategoryNumberDescriptionDto
object
2 properties
customDateTimeUTC1InPurchaseOrderLineUpdateDto
object
A free custom colum of type DateTime - in UTC timezone
1 property
accountInPurchaseOrderLineDto
object
Account The expense account used to record the purchased non-stock item that does not require receipt (by default, the account specified for the item in the Co…
3 properties
PurchaseReceiptsDto
object
7 properties
discountCodeInPurchaseOrderLineDto
object
Discount code The code of the line discount that has been applied to this line automatically.
2 properties
customStr4InPurchaseOrderLineUpdateDto
object
A free custom colum of type string with max length 100.
1 property
shippingAddressInPurchaseOrderDto
object
Supplier info tab The Supplier address section The default shipping address for the supplier.
9 properties
customStr5InPurchaseOrderUpdateDto
object
A free custom colum of type string with max length 100.
1 property
DiscountDetailUpdateDto
object
This class represent a Discount Detail for Purchase Order in Purchase Order Controller. Used to pass data to server for creating or updating an order
5 properties
SegmentUpdateDto
object
2 properties
DtoValueOfNullableOfDecimal
object
1 property
PurchaseOrderLineDto
object
This class represents a Purchase Order Line in PurchaseOrderController. Used for getting data.
47 properties
SegmentDto
object
4 properties
shipToInPurchaseOrderDto
object
Shipping instructions tab The Delivery address section Ship to The particular destination of the selected type.
3 properties
DtoValueOfNullableOfBoolean
object
1 property
PurchaseOrderAddressUpdateDto
object
8 properties
MetadataDto
object
2 properties
customStr1InPurchaseOrderLineUpdateDto
object
A free custom colum of type string with max length 100.
1 property
branchInPurchaseOrderDto
object
Document details tab Branch The branch to receive the item.
2 properties
DtoValueOfNullableOfGuid
object
1 property
DtoValueOfBoolean
object
1 property
vatIdInTaxDetailDto
object
VAT ID The ID of the specific VAT applied.
2 properties
taxCategoryInPurchaseOrderLineDto
object
VAT category The VAT category assigned to the ordered stock item.
2 properties
customDec2InPurchaseOrderUpdateDto
object
A free custom colum of type decimal with max 4 decimals.
1 property
remitAddressInPurchaseOrderDto
object
Supplier info tab The Supplier address section The default contact setting for the supplier.
9 properties
projectInPurchaseOrderLineDto
object
Project The project with which this purchase order line is associated.
3 properties
DtoValueOfNullableOfPurchaseOrderReceiptAction
object
1 property
customInt2InPurchaseOrderLineUpdateDto
object
A free custom colum of type int
1 property
PurchaseOrderContactUpdateDto
object
8 properties
warehouseInPurchaseOrderDto
object
Document details tab Warehouse The warehouse to receive the item listed on the order.
2 properties
supplierVatZoneInPurchaseOrderDto
object
Supplier info tab The Info section Supplier VAT zone The VAT zone of the supplier's location.
6 properties
BackgroundApiAcceptedDto
object
2 properties
DiscountDetailDto
object
12 properties
customStr2InPurchaseOrderUpdateDto
object
A free custom colum of type string with max length 100.
1 property
DtoValueOfNullableOfPurchaseOrderType
object
1 property
warehouseInPurchaseOrderLineDto
object
Warehouse The warehouse to receive the item listed on the order.
2 properties
customStr1InPurchaseOrderUpdateDto
object
A free custom colum of type string with max length 100.
1 property
customStr4InPurchaseOrderUpdateDto
object
A free custom colum of type string with max length 100.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

visma-purchase-order-api-openapi.yml Raw ↑

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
Where this information came from

This is an independent, third-party profile of Visma Purchase Order 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.