File: reading.rst

package info (click to toggle)
python-fints 4.0.0-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 700 kB
  • sloc: python: 5,021; makefile: 196
file content (76 lines) | stat: -rw-r--r-- 2,257 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
Reading operations
==================

.. note::

   Starting from version 3, **all of the methods on this page** can return a ``NeedTANResponse`` instead of actual
   data if your bank requires a TAN. You should then enter a TAN, read our chapter :ref:`tans` to find out more.

Fetching your bank accounts
---------------------------

The most simple method allows you to get all bank accounts that your user has access to:

.. autoclass:: fints.client.FinTS3Client
   :noindex:
   :members: get_sepa_accounts

This method will return a list of named tuples of the following type:

.. autoclass:: fints.models.SEPAAccount

You will need this account object for many further operations to show which account you want to operate on.

.. _information:

Fetching bank information
-------------------------

During the first interaction with the bank some meta information about the bank and your user is transmitted
from the bank.

.. autoclass:: fints.client.FinTS3Client
   :members: get_information
   :noindex:


Fetching account balances
-------------------------

You can fetch the current balance of an account with the ``get_balance`` operation.

.. autoclass:: fints.client.FinTS3Client
  :members: get_balance
  :noindex:

This method will return a list of ``Balance`` objects from the ``mt-940`` library. You can find more information
in `their documentation <https://mt940.readthedocs.io/en/latest/mt940.html#mt940.models.Balance>`_.

.. _transactions:

Reading account transactions
----------------------------

You can fetch the banking statement of an account within a certain timeframe with the ``get_transactions``
operation.

.. autoclass:: fints.client.FinTS3Client
   :members: get_transactions, get_transactions_xml
   :noindex:

This method will return a list of ``Transaction`` objects from the ``mt-940`` library. You can find more information
in `their documentation <https://mt940.readthedocs.io/en/latest/mt940.html#mt940.models.Transaction>`_.


Fetching holdings
-----------------

You can fetch the holdings of an account with the ``get_holdings`` method:

.. autoclass:: fints.client.FinTS3Client
   :members: get_holdings
   :noindex:

This method will return a list of ``Holding`` objects:

.. autoclass:: fints.models.Holding