docker-finance | modern accounting for the power-user

Dedicated to Michael Morgan: a beautiful, beautiful soul.

---

Internal signing keys:

  Aaron Fiore (sole author)

    - 518A22F85BEFD32BCC99C48603F90C4F35E0213E
    - 31ECA5C347A0CC0815EDE730A3EACCFCDA7E685E
    - C8187C585CB07A4DA81CC0F37318B50EBE9C0DA8

Internal repositories (rebased from):

  Staging:

    $ git log -n1 --pretty=format:"%H"
    c8e0cd66f6c89fa7b3c62f72fb524a4cc454b7b6

    $ git rev-list --max-parents=0 HEAD
    ac3863b8c234755855f1aea3a07a853122decdf2

  Private:

    $ git log -n1 --pretty=format:"%H"
    69bb3591eaa2990a9637832bb484690e00c4f926

    $ git rev-list --max-parents=0 HEAD
    a5c1cc9fb593c4cf09bc0adfef6cb6d2964511ae

container/src/hledger-flow/accounts/paypal/paypal-shared.rules

@@ -0,0 +1,123 @@
+# docker-finance | modern accounting for the power-user
+#
+# Copyright (C) 2021-2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+fields timestamp,description_,type,status_,currency_,amount_,code_,balance_,direction,subaccount,in_value,in_ticker,out_value,out_ticker,tx_fee_value,tx_fee_ticker,fiat_value
+
+date-format %Y-%m-%d %H:%M:%S %z
+date %timestamp
+
+description %timestamp
+
+account1 assets:paypal:%subaccount:%currency_
+amount %amount_ %currency_
+
+comment type:%type, status:%status_, direction:%direction
+
+if %description_ ([0-9]|[a-z])
+  comment description:%description_, type:%type, status:%status_, direction:%direction
+
+if %code_ ([0-9]|[a-z])
+  comment description:%description_, type:%type, status:%status_, code:%code_, direction:%direction
+
+# ---------------------------------------------------------------------------- #
+#                                     IN                                       #
+# ---------------------------------------------------------------------------- #
+
+if %direction ^IN$
+  account2 income:paypal:%subaccount:%currency_
+
+if %direction ^IN$
+& %type (^General Card Deposit$|^Bank Deposit to PP Account$|^Reversal of General Account Hold$)
+  account2 equity:paypal:%subaccount:withdrawal:%currency_
+
+# ---------------------------------------------------------------------------- #
+#                                     OUT                                      #
+# ---------------------------------------------------------------------------- #
+
+if %direction ^OUT$
+  amount -%amount_ %currency_
+
+if %direction ^OUT$
+  account2 expenses:paypal:%subaccount:%currency_
+
+if %direction ^OUT$
+& %description_ ^PayPal$
+& %type ^Account Hold for Open Authorization$
+  account2 equity:paypal:%subaccount:deposit:%currency_
+
+# Bank withdrawal
+if %direction ^OUT$
+& %description_ ^$
+& %type (^General Withdrawal$|^User Initiated Withdrawal$)
+  account2 equity:paypal:%subaccount:deposit:%currency_
+
+# Non-balancing-only reports
+if %status_ Reversed
+  amount -%amount_ %currency_
+
+# ---------------------------------------------------------------------------- #
+#                                   Crypto                                     #
+# ---------------------------------------------------------------------------- #
+
+# NOTE: at this time, despite `%type Cryptocurrency`, PayPal offers absolutely
+# no usable information for buys/sells *UNTIL* end of the year tax statements
+# are provided. However, `preprocess` *will* process the 'crypto transactions'
+# CSV provided at that time but *NOT* the 'tax statements' CSV (and not any
+# crypto-related reports entries). This type of periodic release on PayPal's
+# behalf makes development on real verifiable data a patient task.
+
+if %type ^Cryptocurrency$
+  skip
+
+# TODO: only tested against PYUSD (which has no trading fees), need more data for verification
+
+if %in_ticker [a-z]
+  comment description:%description_, type:%type, taxed_as:%type
+
+if %in_ticker [a-z]
+& %type ^BUY$
+  account1 assets:paypal:%subaccount:%in_ticker
+  amount %in_value %in_ticker @@ %out_value %out_ticker
+  account2 assets:paypal:%subaccount:%out_ticker
+  comment2 %timestamp,%type,paypal,%in_ticker,%in_value,%out_ticker,%out_value,,
+
+if %in_ticker [a-z]
+& %type ^SELL$
+  account1 assets:paypal:%subaccount:%out_ticker
+  amount -%out_value %out_ticker @@ %in_value %in_ticker
+  account2 assets:paypal:%subaccount:%in_ticker
+  comment2 %timestamp,%type,paypal,%out_ticker,%out_value,%in_ticker,%in_value,,
+
+# w/ fees
+
+if %in_ticker [a-z]
+& %tx_fee_value [1-9]
+  account3 assets:paypal:%subaccount:%tx_fee_ticker
+  amount3 -%tx_fee_value %tx_fee_ticker
+  account4 expenses:paypal:%subaccount:fees:%tx_fee_ticker
+
+if %in_ticker [a-z]
+& %type ^BUY$
+& %tx_fee_value [1-9]
+  comment2 %timestamp,%type,paypal,%in_ticker,%in_value,%out_ticker,%out_value,%tx_fee_ticker,%tx_fee_value
+
+if %in_ticker [a-z]
+& %type ^SELL$
+& %tx_fee_value [1-9]
+  comment2 %timestamp,%type,paypal,%out_ticker,%out_value,%in_ticker,%in_value,%tx_fee_ticker,%tx_fee_value
+
+# vim: sw=2 sts=2 si ai et