Change rate_comments values from string to list to capture all TEDB annotations per rate

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: madisvain

docs/docs/api/vat-rates.md

@@ -67,7 +67,7 @@ GET https://api.vatcomply.com/vat_rates
 | `parking_rate`       | number\|null  | Parking rate, if applicable                    |
 | `currency`           | string        | Country currency code                          |
 | `member_state`       | boolean       | Always `true` (EU member state)                |
-| `rate_comments`      | object        | Map of rate value to TEDB annotation (e.g. geographic limitation). Empty object if no comments. |
+| `rate_comments`      | object        | Map of rate value to list of TEDB annotations (e.g. geographic limitations, applicable categories). Empty object if no comments. |
 
 ## Filter by Country
 

vatcomply/management/commands/load_vat_rates.py

@@ -93,7 +93,11 @@ def handle(self, *args, **options):
             category = result.get("category")
             annotation = comment or (category.get("description", "") if category else "")
             if annotation:
-                info["rate_comments"][str(float(value))] = annotation
+                key = str(float(value))
+                if key not in info["rate_comments"]:
+                    info["rate_comments"][key] = []
+                if annotation not in info["rate_comments"][key]:
+                    info["rate_comments"][key].append(annotation)
 
         # Build country name + currency lookup
         country_lookup = {}

vatcomply/schemas.py

@@ -108,7 +108,7 @@ class VATRateSchema(Serializer):
     parking_rate: float | None = None
     currency: str = ""
     member_state: bool = True
-    rate_comments: dict[str, str] = {}
+    rate_comments: dict[str, list[str]] = {}
 
 
 class RatesResponseSchema(Serializer):

vatcomply/tests/test_vat_rates.py

@@ -90,7 +90,7 @@ def test_vat_rates_austria_rate_comments(client, vat_rates_db):
     at = data[0]
     assert at["standard_rate"] == 20.0
     assert 19.0 in at["reduced_rates"]
-    assert at["rate_comments"]["19.0"] == "Jungholz, Mittelberg"
+    assert at["rate_comments"]["19.0"] == ["Jungholz, Mittelberg"]
     assert at["parking_rate"] == 13.0