Depending on your business scenarios and the Basware systems you have in use, you will be using different Basware APIs to support your business. Here are the APIs typically used by our clients in some of the common business scenarios.

 

Business scenarios:
 
 
Master data can also be maintained manually in P2P. However, customers usually prefer to import most of the the data using integrations.
  
Use case / API name Purpose Remarks
Transfer approved invoices to accounting
GET accountingDocuments Transfer invoices approved for payment to accounting system  
POST accountingDocuments/acknowledge Mark invoice as fetched  
POST accountingDocuments/prebookResponse Mark invoice as prebooked in accounting system Only when prebooking is required. Generally prebooking is not in use.
POST accountingDocuments/paymentResponse Mark invoice as transferred to accounting system  
POST accountingDocuments/paymentResponse Update invoice payment date Required with Basware Analytics
Import master data
POST accounts Import accounts from EPR  
POST costCenters Import cost centers from ERP  
POST vendors Import vendors from ERP  
POST genericLists Import additional coding dimensions from ERP Supports multiple dimensions. Not generally used in all projects.
POST exchangeRates Import exchange rated Not generally used in all projects.
POST paymentTerms Import payment terms from ERP Not generally used in all projects.
POST taxCodes Import tax codes from ERP Not generally used in all projects.
POST advancedValidations Import invoice coding row validation rules from ERP Not generally used in all projects.
POST users Import users Not generally used in all projects.
POST advancedPermissions Import user approval rights -information Not generally used in all projects.
Error handling
GET errorFeedbacks Error handling Returns errors asynchronously from Basware target systems.

In addition to the APIs listed in the "Integrating to Basware AP Automation for accounts payable processing" section, you will need:

Use case / API name Purpose Remarks
Import external matching orders
POST matchingOrders Import order header data  
POST matchingOrderLines Import order lines and goods receipts  
PATCH matchingOrderLines Add goods receipts to order lines when source system(s) cannot send both GRs and order lines in a single request. Optional
Use case / API name Purpose Remarks
POST invoices Send electronic invoices  
POST  creditNotes Send electronic credit notes  
POST files Add attachments to invoices / credit notes. File(s) need to be posted before the related invoice.
GET notifications Status notifications and error handling  
DELETE notifications Remove received notifications  

 

Use case / API name Purpose Remarks
GET notifications Get list of invoice id:s to fetch  
GET invoices Receive electronic invoices  
GET  creditNotes Receive electronic credit notes  
GET files Receive attachments to invoices / credit notes.  
POST notifications Post invoice status notifications.  
DELETE notifications Remove processed notifications.  

 

Use case / API name Purpose Remarks
POST vendors Import vendors from ERP In "P2P APIs".
GET notifications List vendor id's proposed for changes in ERP.

in "Network APIs"

GET vendorDetails Get vendor changes to ERP for approval

API documentation currently not available online.

DELETE notifications Remove vendor id's previously proposed for change in ERP.

In "Network APIs".

POST companies Import companies

In "P2P APIs".

Typically not used in most projects.

GET errorFeedbacks Error handling

In "P2P APIs".

Returns errors asynchronously from Basware target systems.

 

In addition to APIs in "Accounts payable processing" -section, some of the following APIs are used depending on which parts of purchasing process are done in Basware P2P Purchase and which parts are done in external purchasing system.

Use case / API name Purpose Remarks
Import data
POST purchaseRequisitions Import purchase requisitions to P2P Purchase  
POST purchaseOrders Import purchase orders to P2P Purchase

Available Q3/2020.

POST goodsReceipts Import goods receipts to P2P Purchase Available Q3/2020.
POST contracts Import contracts to P2P Purchase Typically not used in most projects.
Export data
GET exportedPurchaseOrders Export order with goods receipts from P2P purchase Data is refreshed when order status updates.
GET exportedPurchaseRequisitions Export purchase requisition from P2P purchase Data is refreshed when requisition status updates. Available Q4/2020.
Error handling
GET errorFeedbacks Error handling Returns errors asynchronously from Basware target systems.

 

Use case / API name Purpose Remarks
POST vendors Import vendors from ERP  
POST contracts Export contracts from external purchasing system.

Typically not used in most projects. API documentation currently not available online

GET errorFeedbacks Error handling Returns errors asynchronously from Basware target systems.

 

See sections "Accounts payable processing" and "Sending e-invoices to your Customers".