Use case
A company sells products to companies in other countries in the European Union.
VAT status specifies the type of VAT processing in Procountor. The invoice VAT status is required for all invoices except travel invoices and expense claims.
VAT status is a key control data item for VAT processing in Procountor. The selected VAT status specifies the type of VAT processing related to the invoice or invoice row (product).
Used endpoints
Users can define the VAT statuses that are in use in their company. GET /vats/default returns VAT statuses for the current company.
Example of VatStatuses part of the response:
"vatStatuses": [
{
"vatStatus": 1,
"description": "Domestic",
"sales": true,
"purchase": false
},
{
"vatStatus": 3,
"description": "Outside of the EU",
"sales": true,
"purchase": false
},
{
"vatStatus": 5,
"description": "EU community sales (product)",
"sales": true,
"purchase": false
},
{
"vatStatus": 12,
"description": "No VAT handling",
"sales": true,
"purchase": true
}
]
The VAT status is mandatory at the invoice header level and optional for invoice rows. If the VAT status has been selected for an invoice row, it will override the VAT status selected at the header level.
{
"type": "SALES_INVOICE",
"status": "UNFINISHED",
"date": "2020-11-25",
"counterParty": {
"identifier": "DE123456789",
"taxCode": "DE123456789",
"counterPartyAddress": {
"name": "Test Company",
"street": "Test str",
"zip": "00000",
"city": "Berlin",
"country": "GERMANY"
}
},
"paymentInfo": {
"paymentMethod": "BANK_TRANSFER",
"currency": "EUR",
"bankAccount": {
"accountNumber": "{{bank_account}}"
},
"dueDate": "2020-12-05",
"currencyRate": 1,
"bankReferenceCode": ""
},
"extraInfo": {
"accountingByRow": true,
"unitPricesIncludeVat": true
},
"discountPercent": 0,
"invoiceRows": [
{
"product": "Product",
"quantity": 1,
"unit": "PIECE",
"unitPrice": 10,
"discountPercent": 0,
"vatPercent": 0
}
],
"vatStatus": 5,
"invoiceChannel": "MAIL",
"language": "ENGLISH",
"additionalInformation": "..."
}
Other information
If the VAT status is other than Domestic, VAT percentage (vatPercent) should be 0%.
{
"product": "Product",
"quantity": 0,
"unit": "PIECE",
"unitPrice": 10,
"discountPercent": 0,
"vatPercent": 0,
"vatStatus": 5
}
The required VAT information clause can be added to the "additionalInformation" field on the invoice request.