Eurovat

A python library to get the vat right in the EU.

Features

• fetch vat-rates from tedb
• get the proper vat-rate
  • for cn-codes
  • for cpa-codes - UNTESTED/PARTIAL SUPPORT
  • for a given datetime (temporary vat-rates)
• 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
• 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