Add info of the source of a transaction

Author: rennerocha

thebook/bookkeeping/migrations/0021_transaction_source.py

@@ -0,0 +1,22 @@
+# Generated by Django 5.2.10 on 2026-03-06 20:45
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("bookkeeping", "0020_remove_categorymatchrule_priority"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="transaction",
+            name="source",
+            field=models.CharField(
+                blank=True,
+                default="",
+                help_text="Source of the transaction (e.g. manual, paypal-webhook, etc.)",
+            ),
+        ),
+    ]

thebook/bookkeeping/models.py

@@ -244,6 +244,11 @@ class Transaction(models.Model):
     amount = models.DecimalField(max_digits=10, decimal_places=2)
     notes = models.TextField(blank=True)
 
+    source = models.CharField(
+        blank=True,
+        default="",
+        help_text="Source of the transaction (e.g. manual, paypal-webhook, etc.)",
+    )
     created_at = models.DateTimeField(auto_now_add=True)
     updated_at = models.DateTimeField(auto_now=True)
 

thebook/webhooks/managers.py

@@ -88,5 +88,6 @@ def fetch_transactions(start_date: datetime.date, end_date: datetime.date):
                 amount=amount,
                 bank_account=bank_account,
                 category=bank_account_transfer_category,
+                source="paypal-fetch-transactions",
                 created_by=user,
             )

thebook/webhooks/models.py

@@ -112,6 +112,7 @@ def process(self, bank_account=None, user=None):
                 description=description,
                 amount=amount,
                 bank_account=bank_account,
+                source="openpix-webhook",
                 created_by=user,
             )
             Transaction.objects.create(
@@ -121,6 +122,7 @@ def process(self, bank_account=None, user=None):
                 amount=openpix_fee,
                 bank_account=bank_account,
                 category=bank_fee_category,
+                source="openpix-webhook",
                 created_by=user,
             )
 
@@ -277,6 +279,7 @@ def process(self, bank_account=None, user=None):
                 description=description,
                 amount=amount,
                 bank_account=bank_account,
+                source="paypal-webhook",
                 created_by=user,
             )
 
@@ -288,6 +291,7 @@ def process(self, bank_account=None, user=None):
                     amount=fee,
                     bank_account=bank_account,
                     category=bank_fee_category,
+                    source="paypal-webhook",
                     created_by=user,
                 )
 

thebook/webhooks/openpix/services.py

@@ -88,6 +88,7 @@ def fetch_transactions(start_date: datetime.date, end_date: datetime.date):
                 amount=decimal.Decimal(str(transaction_amount)),
                 bank_account=bank_account,
                 category=transaction_category,
+                source="openpix-fetch-transactions",
                 created_by=user,
             )
         )
@@ -104,6 +105,7 @@ def fetch_transactions(start_date: datetime.date, end_date: datetime.date):
                 amount=transaction_fee_amount,
                 bank_account=bank_account,
                 category=bank_fee_category,
+                source="openpix-fetch-transactions",
                 created_by=user,
             )
         )

thebook/webhooks/paypal/services.py

@@ -104,6 +104,7 @@ def fetch_transactions(start_date: datetime.date, end_date: datetime.date):
                 amount=transaction_amount + transaction_fee_amount,
                 bank_account=bank_account,
                 category=transaction_category,
+                source="paypal-fetch-transactions",
                 created_by=user,
             )
         )
@@ -117,6 +118,7 @@ def fetch_transactions(start_date: datetime.date, end_date: datetime.date):
                     amount=transaction_fee_amount,
                     bank_account=bank_account,
                     category=bank_fee_category,
+                    source="paypal-fetch-transactions",
                     created_by=user,
                 )
             )