This project is a plugin for ofxstatement that will process a JSON file of investment account transaction history from Charles Schwab and convert it to OFX format, suitable for importing into GnuCash.
Use pipenv to run the converter:
$ pip3 install pipenv --user (if it hasn't already been set up)
$ cd ofxstatement-schwab-json
$ pipenv sync --dev
$ pipenv shell
$ ofxstatement convert -t schwab_json Name_XXX321_Transactions_20240101-123456.json import.ofx
Schwab doesn't provide ratio information for stock splits which is required for
the OFX <SPLIT> element.
Nor does GnuCash support importing the OFX <SPLIT> element.
So that you at least get some information imported,
these generate <TRANSFER> transactions and a warning message to remind you
that you'll likely want to manually update these transactions depending on
how you choose to track splits and their cost basis.
One approach for tracking splits in GnuCash is to change the import transaction to reverse out the existing lots and their remaining cost bases, and add back in the new total shares with a corresponding buy cost.
For example, a 4:1 split on 100 shares would be imported as a net 300 share transfer. Change that transaction to be:
- -100 shares at a sale price of the remaining cost basis
- +400 shares at a buy price of the remaining cost basis
The date won't be correct for calculating the long-term capital gain tax implications, but at least the per-share gain calculations should be correct.
Use pipenv to make a clean development environment.
$ cd ofxstatement-schwab-json
$ pipenv sync --dev
$ pipenv shell
$ pytest
$ pip3 install mypy black
$ mypy src
$ black src
This will download all the dependencies and install them into your virtual environment. After this, you should be able to do:
$ ofxstatement list-plugins
The following plugins are available:
schwab_json Parses Schwab JSON export of investment transactions
After running pipenv shell, run pipenv update to update everything.
$ python -m build