A python library to get the vat right in the EU.
Project description
Eurovat
A python library to get the vat right in the EU.
Features
- fetch vat-rates from tedb
- get the proper vat-rate
- VIES validation
- cn-code helpers
Planned features
- fetch newest rates daily with gh-actions and submit automated PR's
Installation
just use pip:
pip install eurovat
Vat rates
you can query the vat-registry with the following arguments:
- country
- iso-code or
eurovat.EUState
object
- iso-code or
- cn-code
- optional
- get reduced rates for certain cn-codes
- cpa-code
- optional
- get reduced rates for certain cpa-codes
- date
- optional
- get temporary reduced rates for the given date
import eurovat
import datetime
registry = eurovat.VatRuleRegistry()
registry.date_begin = datetime.datetime(1970, 1, 1)
# This will try to write to vat_rules.json in the package directory
registry.update()
# This will update the in-memory database, all changes will be lost
registry.fetch()
# get a historic vat-rate
rate1 = registry.get_vat_rate("AT", "49020000", date=datetime.datetime(year=2019, month=10, day=5))
# rate1 = 10
rate2 = registry.get_vat_rate("AT", "49020000", date=datetime.datetime(year=2016, month=10, day=5))
# rate2 = 20
Update the registry
keep the registry up-to-date from time to time:
registry.update()
this will require write access to the package-file vat_rules.json
. There are alternative storage locations available:
Filesystem cache
when writing to package data is not an option, you can use a custom cache-file:
import eurovat
import datetime
class Registry(eurovat.VatRuleRegistry):
cache = eurovat.FilesystemCache("/tmp/vat_rules.json")
date_begin = datetime.datetime(1970, 1, 1)
registry = Registry()
registry.update()
Django cache
This will use Django's cache backend to store vat-rules
import eurovat
import datetime
from eurovat.cache.django import DjangoCache
class Registry(eurovat.VatRuleRegistry):
cache = DjangoCache("eurovat_rates")
date_begin = datetime.datetime(1970, 1, 1)
registry = Registry()
registry.update()
Custom cache
You can use a custom cache too. Find an example in eurovat.cache.django
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
eurovat-0.10.1.tar.gz
(115.7 kB
view hashes)
Built Distribution
eurovat-0.10.1-py3-none-any.whl
(120.0 kB
view hashes)