VAT

Make sure you familiarize yourself with the other important concepts of our API:
Products and Articles, Sync Markers
After taking the time to understand these concepts, you will much better understand the basics of our API.

Introduction

VAT (Value-added tax) is an inescapable subject when it comes to sales. It specifies an additional percentage that is charged to the buyer for services or products provided. The seller is responsible for paying this tax. Of course, MplusKASSA support VAT and provides various ways of setting the percentages and changing which VAT percentages are charged and how they are displayed.

VAT codes, percentages and method

The VAT code ( vatCode in the API) is a code that specificies which VAT category an article belongs to. MplusKASSA provides 5 VAT codes for you to configure. The Netherlands has 2 VAT categories, 6% VAT and 21% VAT. In MplusKASSA, those are mapped to VAT code 1 (6%) and VAT code 2 (21%). Other countries may have different VAT percentages, which may be mapped to different VAT codes. To retrieve the VAT mapping of the administration you are working with, you can use the API function getVatGroupList().

The VAT percentage ( vatPercentage in the API) is the actual percentage of VAT that is applied to the article. It is always expressed in 1/100th of a percent. E.g. 21% is expressed as 2100.

The VAT method ( vatMethod in the API) is a property of an invoice or order, that specifies if the VAT should be specified (a) inclusive ( VAT-METHOD-INCLUSIVE), (b) exclusive ( VAT-METHOD-EXCLUSIVE) or (c) shifted ( VAT-METHOD-SHIFTED). Inclusive is usually reserved for business-to-customer transactions, exclusive is generally for business-to-business and shifted is for situations where the VAT is paid by the buyer. For instance, this often happens with international transactions.

getVatGroupList Retrieve the configured VAT percentages

« « « Response « « «

getProducts VAT per article

When you request article details through getProducts, you receive the vatCode and related vatPercentage of the article.

« « « Response « « «

VAT per line

VAT codes and percentages can be overruled on a per-line basis. That means that you can add an article to an order or invoice, but have it use a separate VAT code and even a separate VAT percentage from the default configuration.

» » » Request » » »