Adress-Verknuepfungen

Mit Adress-Verknuepfungen verwalten Sie die Verknuepfungen zwischen einer Geschaeftsentitaet (Kunde, Lieferant, …) und bestehenden Adressen. Sie verknuepfen eine Adresse ueber ihre ID und einen Adresstyp, setzen eine Standardadresse und loesen Verknuepfungen. Die Adresse selbst wird hier nicht angelegt.
Bereiche
- Verknuepfte Adressen: verknuepfte Adressen der Entitaet auflisten, nach Adresstyp filtern, Standard setzen und loesen.
- Adresse verknuepfen: eine bestehende Adresse per ID und Adresstyp verknuepfen.
- Hilfe: In-App-Hinweise.
Felder und Konzepte
- Adress-Verknuepfung:
entity_type,entity_id,address_id,address_type,is_default.
Backend-Vertrag
Alle Routen sind mandantenbezogen (aus dem Request aufgeloest). Gemountet unter /api/addresses/links.
GET /api/addresses/links?entity_type=&entity_id=&address_type=— Verknuepfungen auflisten (Filter). Die Parameternamen sindentity_type/entity_id/address_type.POST /api/addresses/links— bestehende Adresse verknuepfen. Body:{entity_type, entity_id, address_id, address_type, is_default?}. Liefert 201 bzw. 409 bei Duplikat.PATCH /api/addresses/links/{linkId}/default— Verknuepfung zum Standard befoerdern. PATCH, nicht POST.DELETE /api/addresses/links/{linkId}— Verknuepfung loesen.
Die Authentifizierung erfolgt ueber httpOnly-Cookie + CSRF via @it-tremmel.de/platform-http authedFetch (credentials: 'include'); es werden keine Tokens aus localStorage gelesen.
Typischer Ablauf
- Adresse verknuepfen oeffnen und eine bestehende Adress-ID und einen Typ eingeben.
- Optional als Standard markieren; absenden, um die Verknuepfung anzulegen.
- Unter Verknuepfte Adressen eine andere Verknuepfung als Standard setzen oder eine Verknuepfung loesen.