Articles in this section

Available Basware APIs

When you configure an export, import, or lookup using the form view designed for the Basware connector, the following API operations are supported:

Note

If your API endpoint isn’t listed here, switch the flow step to HTTP mode and configure the endpoint provided in the Basware API documentation . You can also create a composite endpoint for this application in HTTP mode.

Resource

API endpoint

Export

Import

Accounting documents

Return invoices approved for transfer to accounting

X

Delete data from the Basware API 

X

Return a single approved invoice by invoice ID

X

Acknowledge invoices are no longer offered for next GET operation 

X

Mark invoice transfer P2P as accepted/rejected by receiving system 

X

Mark invoice prebooking as accepted/rejected by receiving system

X

Mark invoice transfer as accepted/rejected by receiving system 

X

Update invoice payment information, including payment date

X

Return high-level invoice status by search criteria such as company code, invoice number and invoice date

X

Return invoice attachment(s) by attachment external code identifier

X

Accounts

Return accounts posted to the Basware API

X

Create new account(s)

X

Delete data from the Basware API 

X

Return a single account record by external code

X

Update fields on specified account 

X

Advanced permissions

Return advanced user rights -records posted to the Basware API

X

Create new advanced user rights -record(s)

X

Delete data from the Basware API 

X

Return a single advanced user rights record by external code

X

Update fields on specified advanced user rights -record preserves existing values in fields, which were not updated

X

Advanced validations

Return coding row validation rules posted to the Basware API

X

Create new coding row validation rule(s)

X

Delete data from the Basware API 

X

Return a single coding row validation rules by external code

X

Update fields on specified coding row validation rule 

X

Application groups

Create new application groups

X

Return application groups

X

Return a single application group by application group code

X

Application response v1

Retrieve the application response contents

X

Companies

Return companies posted to the Basware API

X

Create new companies

X

Return a single company record by company code

X

Contracts

Return contract entities

X

Create new contract entity, overwrites previous if exists

X

Delete data from the Basware API 

X

Return a single contract entity by ID

X

Update contract entity 

X

Cost centers

Return cost centers posted to the Basware API

X

Create new cost center(s)

X

Delete data from the Basware API 

X

Return a single cost center -record by external code -identifier

X

Update fields on specified cost center 

X

Credit notes v2

Retrieve the credit note contents

X

Upload a credit note document to the Basware network

X

Data extract

Return information about available data extracts

X

Return information about files for one data extract 

X

Acknowledge extracts are marked as exported

X

Return definition of supported tables

X

Return change log for definition of supported tables

X

Document import API

Upload document

X

Error feedbacks

Return error messages from receiving end-system(s), based on error time stamp

X

Delete data from the Basware API 

X

Return error messages from receiving end-system(s), based on web service request ID

X

Return error messages from receiving end-system(s), based on interface and external code -identifier of record

X

Exchange rates

Return exchange rates posted to the Basware API

X

Create new exchange rate(s)

X

Delete data from the Basware API

X

Return a single exchange rate -record by external code identifier

X

Update fields on the specified exchange rate 

X

Exported contract spends

Return contract spends exported from Basware P2P

X

Delete data from the Basware API 

X

Return contract spend details exported from Basware P2P by external code

X

Acknowledge contract spends are no longer returned on the next get operation

X

Exported contracts

Return contracts (along with spend totals) exported from Basware P2P

X

Delete data from the Basware API 

X

Return contracts (along with spend totals) exported from Basware P2P by external code

X

Acknowledge contract spends are no longer returned on the next get operation

X

Exported purchase orders

Return purchase orders exported from Basware P2P

X

Delete data from the Basware API 

X

Return a single exported order by external code

X

Acknowledge orders are no longer returned for next GET operation

X

Exported purchase requisitions

Return purchase requisitions exported from the Basware P2P

X

Delete data from the Basware API 

X

Return a single purchase requisition by external code

X

Acknowledge requisitions are no longer returned for next GET operation

X

Files v2

Upload a file related to a business document

X

Fetch a file related to a business document

X

Generic lists

Return list items posted to the Basware API for specified list

X

Create new list item(s)

X

Delete data from the Basware API 

X

Return a single list item, based on specified list and external code

X

Update fields on specified list item 

X

Invoices v3

Retrieve the invoice contents

X

Send invoices to a recipient through the Basware network

X

Matching order lines

Return matching order lines posted to the Basware API

X

Create new matching order line(s)

X

Delete data from the Basware API 

X

Return a single matching order line by external code

X

Update fields on specified matching order line 

X

Matching orders

Return matching order headers posted to the Basware API

X

Create new order header(s), overwrites previous record if exists

X

Delete data from the Basware API 

X

Return a single matching order header by external code

X

Update fields on specified order header 

X

Notification history

Check status of an individual task by task ID 

X

Return task status by search criteria 

X

Notifications v1.1

Notify the Basware network about a change in a business document's status

X

Fetch a list of notifications related to a business document

X

Delete notifications related to a business document

X

Notifications v2

Notify the Basware network about a change in a business document's status

X

Fetch a list of notifications related to a business document

X

Delete notifications related to a business document

X

Orders v2

Send an order to a recipient through the Basware network

X

Retrieve the order contents

X

Organizations

Create new organization element(s)

X

Return existing organization elements

X

Remove existing organization elements in draft state (published = false)

X

Return a single organization element by external code

X

Payment terms

Return payment terms posted to the Basware API

X

Create new payment term entity

X

Delete data from the Basware API 

X

Return a single payment term by external code

X

Update on specified payment term 

X

Projects v2

Return projects posted to the Basware API

X

Create new projects

X

Delete data from the Basware API 

X

Return a single project by external code

X

Update project

X

Purchase goods receipts

Return purchase goods receipts

X

Create new purchase goods receipts

X

Delete data from the Basware API 

X

Return single purchase goods receipts by order ID

X

Purchase orders

Return imported purchase orders

X

Create new purchase order(s)

X

Delete data from the Basware API 

X

Return a single imported purchase order by order ID

X

Update fields on specified order line 

X

Purchase requisitions

Return purchase requisitions posted to the Basware API

X

Create new purchase requisition(s) P2P purchase does not allow 

X

Delete data from the Basware API 

X

Return a single purchase requisition by external code

X

Request status

Return request status responses from receiving end-system(s), based on request ID

X

Return request status responses from receiving end-system(s), based on status and time stamp

X

Acknowledge request status responses are no longer offered for next get operation

X

Subscribe to notifications

Subscribes to receive push notifications

X

List existing subscriptions

X

Delete existing subscriptions

X

Tax codes

Return tax codes posted to the Basware API

X

Create new tax code(s)

X

Delete data from the Basware API 

X

Return a single tax code by external code identifier

X

Update on specified taxcode 

X

User group associated users

Associates users with user group

X

Return user associations with user groups

X

Delete user association with user group

X

User groups

Return user group by external code

X

Return a list of available user groups

X

Create or update user group

X

Delete user groups

X

Users

Return users posted to the Basware API

X

Create new user(s)

X

Delete data from the Basware API 

X

Return a single user by external code

X

Update fields on specified user 

X

Vault archiving

Send the document metadata for archiving and receive pre-signed URL to upload document ZIP file

X

Upload the document ZIP file to be archived using a pre-signed URL

X

Return the status of archived documents 

X

Return archival status of a document

X

Vault indexing

Retrieve index of archived documents

X

Vendor detail v1

Retrieve the vendor details

X

Vendors

Return vendors posted to the Basware API

X

Create new vendor(s), overwrites previous record if exists

X

Delete data from the Basware API 

X

Return a single vendor by external code -identifier

X

Update fields on specified vendor 

X