impotsgouvdata 0.1.0

Retrieve taxpayer data from impots.gouv.fr.

impotsgouvdata

impotsgouvdata is a Python library designed to retrieve taxpayer data from https://www.impots.gouv.fr (the French tax administration website).

For the moment, the library only supports the retrieval of tax documents for private individuals.

Installation

impotsgouvdata can be installed using pip :

pip install impotsgouvdata

Usage

from impotsgouvdata import ImpotsGouvData

# Create a `ImpotsGouvData` instance with a fiscal number and a password
igd = ImpotsGouvData(fiscal_number='1234567891234', password='password')

# Log on to impots.gouv.fr
igd.login()

# Get civil data
igd.last_name # 'Dupont'
igd.first_name # 'Jean'
igd.birth_date # datetime.date(1970, 6, 30)

# Iter over tax documents
for doc in igd.iter_documents():
    print(doc) # IncomeTaxNotice, IncomeTaxReturn, etc.

Dependencies

impotsgouvdata makes use of the following libraries:

• requests (Apache-2.0 license)
• Beautiful Soup (MIT license)
• lxml (BSD license)

License

impotsgouvdata is developed under CeCILL-C license.