wlfb/fb
SHA256
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: finanz-api – Doppelzählungs-Schutz (409) und reservierter Präfix System- (Tool v0.12.0)

Browse Source 
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
rdms
2026-09-29 07:40:33 +02:00
co-authored by Claude Opus 5.5
parent 17fca90c9e
commit 59e5a9cdd4
2 changed files with 21 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude/skills/finanz-api/SKILL.md
+17 -2
View File
@@ -42,7 +42,7 @@ curl -s -H "Authorization: Bearer $KEY" \
## Kategorien (`/api/categories`)
`GET`/`POST` (`name`).
`GET`/`POST` (`name`). Namen mit Präfix `System-` sind reserviert (422).
```bash
curl -s -H "Authorization: Bearer $KEY" http://127.0.0.1:8096/api/categories | jq
@@ -82,6 +82,13 @@ curl -s -X POST -H "Authorization: Bearer $KEY" \
`end_date`, `category_id`), `PATCH`/`DELETE /{id}`, sowie
`GET /recurring/suggestions` (Muster-Erkennung aus importierten Buchungen).
**Doppelzählungs-Schutz:** `POST`/`PATCH` antworten mit `409` und
`detail.code == "doppelzaehlung_kredit"` (plus `meldung`, `konflikte`), wenn
ein monatlicher Ausgabe-Posten vermutlich einer Kreditrate entspricht. Dann
**den Nutzer fragen**; nur nach ausdrücklicher Zustimmung erneut mit
`"doppelzaehlung_bestaetigt": true` senden. Besser: Kreditraten nur über
`/api/loans` pflegen.
```bash
curl -s -H "Authorization: Bearer $KEY" \
http://127.0.0.1:8096/api/recurring/suggestions | jq
@@ -103,6 +110,13 @@ curl -s -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/js
`payout_date`, `repayment_type`: `annuity`|`bullet`), `PATCH`/`DELETE /{id}`,
`GET /{id}/schedule` (Tilgungsplan: Rate, Zins, Tilgung, Restschuld je Termin).
**Doppelzählungs-Schutz:** `POST`/`PATCH` antworten mit `409` und
`detail.code == "doppelzaehlung_kredit"` (plus `meldung`, `konflikte`), wenn
ein monatlicher Ausgabe-Posten vermutlich einer Kreditrate entspricht. Dann
**den Nutzer fragen**; nur nach ausdrücklicher Zustimmung erneut mit
`"doppelzaehlung_bestaetigt": true` senden. Besser: Kreditraten nur über
`/api/loans` pflegen.
```bash
curl -s -H "Authorization: Bearer $KEY" \
http://127.0.0.1:8096/api/loans/1/schedule | jq
@@ -111,7 +125,8 @@ curl -s -H "Authorization: Bearer $KEY" \
## Szenarien (`/api/scenarios`)
`GET`/`POST` (`name`, `description`, `include_recurring`, `include_planned`),
`PATCH`/`DELETE /{id}`. Kredit zuordnen: `POST`/`DELETE
`PATCH`/`DELETE /{id}`. Namen mit Präfix `System-` sind reserviert (422).
Kredit zuordnen: `POST`/`DELETE
/{id}/loans/{loan_id}`. Modifikator hinzufügen: `POST /{id}/modifiers` mit
`target_type` (`category`|`recurring`), `target_id`, `kind`
(`percent`|`absolute`|`remove`), `value`; löschen über `DELETE