Package: ofxstatement-dutch
ofxstatement-dutchThis project provides customofxstatementplugins for these dutch
financial institutions:DEGIRO trader platform, The Netherlands, CSV (https://www.degiro.nl/)ICSCards, The Netherlands, PDF (https://icscards.nl/)ING Bank, The Netherlands, CSV (https://www.ing.nl/)KNAB Online Bank, The Netherlands, CSV (https://www.knab.nl/)ASN Bank, The Netherlands, CSV (https://www.asnbank.nl/)ofxstatementis a tool to convert a proprietary bank statement to OFX
format, suitable for importing into programs like GnuCash or Beancount. The
plugin for ofxstatement parses the bank statement and produces a common data
structure, that is then formatted into an OFX file.The PDF is converted using thepdftotextutility.Installation using Miniconda (minimal conda)This is a quick start guide meant for users on a Windows 10 platform.These are the steps:1. InstallMiniconda for Python 3.x2. Start the Anaconda promptType Anaconda in the search box next to the Windows Start icon in the bottom left of your screen and click the Anaconda Prompt (Miniconda3).
A command line box will open now with (base) as the prompt.3. Create an ofxstatement environmentIn the command line box type "conda create -n ofxstatement":(base)condacreate-nofxstatementPlease note that (base) is the command prompt, not a command to type.4. Switch to the ofxstatement environment and show the installed packages (should be empty the first time)(base)activateofxstatement(ofxstatement)condalist5. Install Python in this environment(ofxstatement)condainstallpython6. Verify the location of pip(ofxstatement)wherepipThis should show something like C:\Users%USERNAME%\Miniconda3\envs\ofxstatement\Scripts\pip.exe7. Install ofxstatement-dutch(ofxstatement)pipinstallofxstatement-dutch8. (optional) Install the Poppler libraryOnly if you need to read PDF files (ICSCards for example):(ofxstatement)condainstall-cconda-forgepoppler9. Test the installationNow a small test to see everything works if you have a KNAB CSV file:(ofxstatement)ofxstatementconvert-tnl-knab"<CSV file>"-The dash (-) at the end of the command ensures that the OFX output will be
sent to the terminal and not to a file.  The double quotes are needed for
files with spaces in its name like
"Knab transactieoverzicht spaarrekening XXXXXXXX - 2020-01-01 - 2020-05-01.csv".10. Launching ofxstatementPlease remember to always start the Anaconda prompt and to activate the
ofxstatement environment first before launching ofxstatement itself, since it
is only installed in that Conda environment.You may create a shortcut to combine both. The target of your shortcut should be something like:C:\Windows\System32\cmd.exe /k C:\Users\%USERNAME%\Miniconda3\condabin\activate.bat ofxstatementPlease continue with the "Usage" section below.InstallationThis section is meant for people who do not want to follow the "Installation
using Miniconda (minimal conda)" section above.PreconditionsFor converting PDFs you have to install the poppler library first, seepdftotext.Using pip$ pip install ofxstatement-dutchDevelopment version from source$ git clone https://github.com/gpaulissen/ofxstatement-dutch.git
$ pip install -e .TroubleshootingThis package depends on ofxstatement with a version at least 0.6.5. This
version may not yet be available in PyPI so install that from source like
this:$ git clone https://github.com/gpaulissen/ofxstatement.git
$ pip install -e .TestTo run the tests from the development version you can use the py.test command:$ py.testYou may need to install the required test packages first:$ pip install -r test_requirements.txtUsageShow installed pluginsThis shows the all installed plugins, not only those from this package:$ ofxstatement list-pluginsYou should see at least:The following plugins are available:

  ...
  nl-degiro        DEGIRO trader platform, The Netherlands, CSV (https://www.degiro.nl/)
  nl-icscards      ICSCards, The Netherlands, PDF (https://icscards.nl/)
  nl-ing           ING Bank, The Netherlands, CSV (https://www.ing.nl/)
  nl-knab          KNAB Online Bank, The Netherlands, CSV (https://www.knab.nl/)
  nl-asn           ASN Bank, The Netherlands, CSV (https://www.asnbank.nl/)
  ...ConvertDEGIRO trader platformThe DEGIRO files do not only contain money statements but also the whole
security transaction history. This tool just emits the money statements coming
from or going to your associated (other) bank account. To be more specific the
deposits (description like "Storting" or "iDEAL storting") and transfers
("Terugstorting"). Maybe in the future the security transaction will be
emitted too, but currentlyofxstatementonly processes money
information.See also the section configuration below.Use something like this:$ ofxstatement convert -t <configuration name> <file>.csv <file>.ofxICSCardsUse something like this:$ ofxstatement convert -t nl-icscards <file>.pdf <file>.ofxOr you can convert the PDF yourself and supply the text as input:$ pdftotext -layout <file>.pdf <file>.txt
$ ofxstatement convert -t nl-icscards <file>.txt <file>.ofxING bankUse something like this:$ ofxstatement convert -t nl-ing <file>.csv <file>.ofxKNAB Online BankUse something like this:$ ofxstatement convert -t nl-knab <file>.csv <file>.ofxASN bankUse something like this:$ ofxstatement convert -t nl-asn <file>.csv <file>.ofxConfigurationFor DEGIRO you need to set an account id, since the statement files do not
contain account information.$ ofxstatement edit-configThis is a sample configuration (do not forget to specify the plugin for each section):[degiro:account1]
plugin = nl-degiro
account_id = account1

[degiro:account2]
plugin = nl-degiro
account_id = account2Change historySee the Changelog (CHANGELOG.md).ChangelogAll notable changes to this project will be documented in this file.The format is based onKeep a Changelog,
and this project adheres toSemantic Versioning.[Unreleased][1.5.0] - 2024-02-18FixedMemo for deposit in deGIRO CSV has changed from "iDEAL storting" to "iDEAL Deposit".Issues with release ?[1.4.1] - 2022-07-19AddedAdded "SHELL = cmd" to Makefile for WindowsChangedTransaction date is now 'Journaaldatum' and not 'Boekingsdatum' for ASN CSV.Enhanced documentation for ASN CSV.The transaction id for ASN CSV is now <'Journaaldatum' in yyyymmdd format>.<'Volgnummer transactie'>[1.4.0] - 2022-07-19AddedReading CSV of the ASN Bank[1.3.3] - 2022-01-05ChangedBuild and test behaviour reviewed[1.3.2] - 2020-08-02RemovedDependency of pdftotext.[1.3.1] - 2020-08-01ChangedLayout of the README improved.Contents of this CHANGELOG for version 1.3.0.[1.3.0] - 2020-08-01Added:Added ability to parse ING balance statements.ChangedImproved installation guide using Miniconda3Improved code quality by using pycodestyle and Python typing module[1.2.1] - 2020-05-01ChangedFixed bug for KNAB converter when counterparty is empty (for
interest for example)[1.2.0] - 2020-03-30AddedAdded converter for:KNAB Online Bank, The Netherlands, CSV (https://www.knab.nl/).ChangedEnhanced header handling for ING and DEGIRO.Enhanced documentation.[1.1.0] - 2020-03-26AddedAdded converter for:DEGIRO trader platform, The Netherlands, CSV (https://www.degiro.nl/).Added reference to the Changelog in the Readme.The Readme mentions test_requirements.txt for installing test modules.More checks concerning the content (dates with start and end
date exclusive) that may result in a ValidationError exception.Added Makefile for keeping the important operations together.ChangedThe generation af a unique OFX id did only return a counter in
case of duplicates.The Readme mentions now my fork of the ofxstatement instead ofhttps://github.com/kedder/ofxstatement.git.Theabout.py file outputs the version number and that is
used in the Makefile.The Makefile depends now on GNU make for tagging a release.MANIFEST.in now includes the Makefile and CHANGELOG.md.Code refactoring.Changed bank id (BIC) for ING from INGBNL2AXXX to INGBNL2A.[1.0.1] - 2020-03-16ChangedAdded poppler library to the instructions.Readme enhanced.[1.0.0] - 2020-03-15AddedFirst version to convert:ICSCards, The Netherlands, PDF (https://icscards.nl/)ING bank, The Netherlands, CSV (https://www.ing.nl/)