# Adressen

Die Addresses API ist ein flexibles, typgesteuertes System. Jede Adresse besitzt ein Feld `type`, das Geltungsbereich und Zweck bestimmt. Dieselben Endpunkte unterstützen alle Typen.

## Adresstypen

| Typ | Geltungsbereich | Beschreibung |
|---|---|---|
| `shipping_address` | Je Nutzer | Persönliche Lieferadresse des Kunden |
| `billing_address` | Je Nutzer | Rechnungsadresse des Kunden |
| `storage_hub` | Tenant-weit | Abholpunkt, Lager, Filiale oder anderer gemeinsamer Sammelort |

> **`storage_hub` ist ein Sonderfall:** Der Typ gehört zum Tenant, nicht zu einem Nutzer. Jeder Kunde kann alle Speicherzentren ohne Anmeldung abrufen. Verwenden Sie sie für Abholung im Geschäft, Lagerlisten, Abgabestellen oder andere physische Standorte Ihres Unternehmens.

## Mögliche Anwendungen von `storage_hub`

- **Click & Collect** — Filialen beim Checkout als Abholpunkte anzeigen
- **Lagernetzwerk** — Versandzentren für Logistik- oder B2B-Abläufe bereitstellen
- **Händlergeschäfte** — Verkäufern ermöglichen, ihr Geschäft als Abholpunkt einzutragen
- **Abgabenetzwerk** — Drittanbieter- oder Franchise-Standorte anbieten

Die vollständige Anleitung finden Sie unter [Speicherzentren](/de/addresses/storage-hubs).

## Adressobjekt

| Feld | Typ | Beschreibung |
|---|---|---|
| `id` | integer | Eindeutige ID der Adresse |
| `name` | string | Kontakt- oder Standortname |
| `phone_number` | string | Telefonnummer des Kontakts |
| `address_line_1` | string | Straßenadresse |
| `address_line_2` | string | Wohnung, Etage oder Gebäude |
| `city` | string | Stadt |
| `state` | string | Bundesstaat oder Region |
| `post_code` | string | Postleitzahl |
| `country` | string | Name des Landes |
| `country_code` | string | ISO-Ländercode |
| `landmark` | string | Orientierungspunkt oder Wegbeschreibung in der Nähe |
| `formatted_address` | string | Vollständige Anzeigeadresse |
| `type` | string | Adresstyp, siehe Tabelle oben |
| `current_address` | boolean | Gibt an, ob dies die aktuell ausgewählte Adresse des Nutzers ist (nur nutzerbezogene Typen) |
| `coordinates.latitude` | number | GPS-Breitengrad |
| `coordinates.longitude` | number | GPS-Längengrad |