The following changes will be released to Visma Severa's API in the next release:

General changes to API

Change (identifier)

GetEntitySchemaVersion method has been added to API. Use this method to compare if Visma Severa API has breaking changes in entities. This feature is recommended to be used in all integrations. Value is updated by Visma Severa when existing entities are changed. When value has been changed, update your service reference for your integration to work correctly. (2999)
Previously, when using Visma Severa API, one could get "Access denied" error from time to time when making API calls. Visma Severa API has been improved internally so that the error won't come anymore. (3309, 3086).
When API call is made and data is not found, Visma Severa API might return NotFoundException, null or an empty list. API documentation has been improved to tell how a method behaves when no data is found. At the same time various methods have been improved regarding this. (2696)
API documentation has been updated to contain better quality data. Unnecessary documentation has been hidden (for example constructors for Severa's exception classes), and missing documentation of interfaces and entities has been added.

Interface changes

Interface name

Change (identifier)

IAccountInserting / updating account: Previously it has been possible to insert account rating that was not valid. This caused an exception in Severa's Account page. This has been fixed so that given account rating is validated and error thrown if it is not in the acceptable range, and API documentation has been updated. (3130)
IAccountInserting / updating account: Previously it has been possible to insert account with negative account number. This has been fixed so that only positive numbers are accepted. (3132)
IAccountInserting / updating account: Previously it has been possible to insert account with negative payment term and overdue interest. This has been fixed so that only 0 or positive numbers are accepted. (3133)
IContactInserting / updating contact: Previously it has been possible to insert contact with custom salutation. In Severa, salutations are translated to different languages by the system itself, and custom salutation caused issues. This has been fixed so that only "Ms.", "Mrs." or "Mr." are accepted as salutation, and API documentation has been updated. (2674)
ISettingsRemoved from API, did not have any functionality. (2786)
ISearchRemoved from API, did not have any functionality. (2787)
IDictionaryRemoved from API, did not have any functionality. (2702)
ILanguageWas excluded from API documentation, now is visible. (2988)
IHourEntryHourEntry has TaskGUID and PhaseGUID, which mean the same thing. When AddNewHourEntry method was used, using only PhaseGUID caused an exception. Method has been fixed to support both TaskGUID and PhaseGUID. (1715)
IInvoiceSetting invoice number: Previously, in a situation where the set invoice number was the same than organization's "next invoice number" in Severa's settings, next invoice number was not updated and organization could get two invoices with the same number. Logic has been changed so that "next invoice number" information is updated. (3284)
IItemDeleting items: Previously it has been possible to delete items, which have been on read-only travel reimbursements. This has been fixed so that deleting such items is not possible anymore. (2674)
ICaseAPI documentation has been updated regarding ValidationExeption when deleting case or product. (3033)
ICaseInserting / updating case: Previously it has been possible to insert expected value to case without giving sales status. This has been fixed so that sales status is required, otherwise expected value is ignored and not added to case. API documentation has been updated. (3290)
IProductAPI documentation has been updated regarding ValidationExeption when deleting case or product. (3033)
IProductDeleteTravelExpense, DeleteProduct: Previously it has been possible to delete travel or product from Visma Severa's settings through API even if the travel/product would have been used when making travel / product entries. This has been fixed so that deleting travels / products which are in use, isn't possible. (2782)

Entity changes

Entity name

Change (identifier)

BusinessUnitShowLogoOnInvoices has been obsoleted, did not have any functionality. Showing logo functionality is on invoice template. (2172)
BusinessUnitShowLogoOnPdfReports has been obsoleted, did not have any functionality. (2172)
CaseOverdueInterest has been obsoleted, did not have any functionality. (3291)
InvoiceVATIncreaseBaseAmount method removed, did not have any functionality. (2972)
InvoiceDetailsContains many properties that do not have any value ever, comments added. (2971)
HourEntryHourEntry has TaskGUID and PhaseGUID, which mean the same thing. When AddNewHourEntry method was used, using only PhaseGUID caused an exception. Method has been fixed to support both TaskGUID and PhaseGUID. (1715)
AccountImportID_GUID has been removed from the entity, did not have any functionality. (2985)
AddressImportID_GUID has been removed from the entity, did not have any functionality. (2985)
CompanyImportID_GUID has been removed from the entity, did not have any functionality. (2985)
ContactImportID_GUID has been removed from the entity, did not have any functionality. (2985)
PhaseGetOptionsAdded to API documentation. (2559)


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.