VAT Prices Calculations

Using our price endpoints, you may request the API to calculate VAT compliant prices for you.

VatZen is Deprecated since January 2022 and API server will be shut down soon!
Hot and Cold Price Calculations
Just as with validations, at VatZen we have a concept of 2 price types: Hot and Cold.
Cold prices works in fire-and-forget way. Meaning that you simply call our endpoint and we return you the data, which is never stored afterwards.
Hot prices endpoint is different from the cold one in the way that all the requests you make has id's assigned and stored in our DB. And you can always fetch this prices (fetch them all of fetch by id). For example, you can create them on the server side and then retrieve on the client.
Cold validations are performed via price endpoint, end hot validation use prices CRUD endpoints. You can get more details below.
Price Entity
Base of our prices endpoints is the Price entity, which is returned from all pricing-related endpoints. You can find the description of the Pricing entity below:
Field
Type
Example
Description
id
String or null
abc123cba
Uniq id assigned only for hot price calculations. You can use this id to retrieve the price info later.
amount
Object
---
Object, which represents the calculation results.
amount.total_incl_vat
Number
12000
Total amount in cents, including VAT.
amount.total_excl_vat
Number
10000
Total amount in cents, excluding VAT.
amount.vat_amount
Number
2000
VAT amount in cents.
category
String or null
ebook
Category used for calculating the vat rate.
vat_rate
Number
20
VAT Value in percents
country
Object
---
Information about the country, which was the target for your calculations
country.code
String
DE
2 symbol ISO country code
country.name
String
Germany
English name of the country
country.local_name
String
Deutschland
Local name of the country, defaults to English
country.member_state
Boolean
true
Identifies if the requested country a member state or not
get
https://api.vatzen.com
/v1/price
Calculate Price (Cold Price endpoint)
post
https://api.vatzen.com
/v1/prices
Calculate Price and store in the DB
get
https://api.vatzen.com
/v1/prices/:price_id
Get Price by ID
get
https://api.vatzen.com
/v1/prices
Get All Prices

API Description - Previous

VAT Number Validations

Next - API Description

Generate Invoce

Last modified 11mo ago

Field	Type	Example	Description
`id`	`String` or `null`	`abc123cba`	Uniq id assigned only for hot price calculations. You can use this id to retrieve the price info later.
`amount`	`Object`	`---`	Object, which represents the calculation results.
`amount.total_incl_vat`	`Number`	`12000`	Total amount in cents, including VAT.
`amount.total_excl_vat`	`Number`	`10000`	Total amount in cents, excluding VAT.
`amount.vat_amount`	`Number`	`2000`	VAT amount in cents.
`category`	`String` or `null`	`ebook`	Category used for calculating the vat rate.
`vat_rate`	`Number`	`20`	VAT Value in percents
`country`	`Object`	`---`	Information about the country, which was the target for your calculations
`country.code`	`String`	`DE`	2 symbol ISO country code
`country.name`	`String`	`Germany`	English name of the country
`country.local_name`	`String`	`Deutschland`	Local name of the country, defaults to English
`country.member_state`	`Boolean`	`true`	Identifies if the requested country a member state or not