# Versandarten des Tenants

Verwalten Sie die Versandarten für Kunden. Jede basiert auf einer Plattformvorlage und kann je Tenant mit Name, Hinweis, Reihenfolge sowie Aktiv- und Standardstatus angepasst werden.

## Typen

| Typ | Beschreibung |
|---|---|
| standard | Manuell konfigurierte Pauschale oder kostenloser Versand. |
| external | Dynamische Echtzeitpreise einer Drittanbieter-Erweiterung beim Checkout. |
| sendcloud | Sendcloud-Integration für Versandetiketten und Zustellerauswahl. |

## Admin- und Kundenzugriff

- GET /v1/tenants/shipping_methods ist öffentlich und gibt nur aktive Methoden zurück. Mit account_id können Sie nach Verkäuferkonto filtern.
- POST, PUT und DELETE sind Admins vorbehalten.
- GET /:id/external ruft Live-Preise einer Erweiterung für den Checkout ab.

## Versandarten auflisten

GET /v1/tenants/shipping_methods — Optionaler Parameter account_id (integer) zum Filtern nach Verkäuferkonto.

Antwortfelder: id (Kennung), name (lokalisierter Anzeigename), note (Kundenhinweis), logo_path (Bild-URL), type (standard, external, sendcloud), channel (z. B. delivery oder pickup), default (beim Checkout vorausgewählt), active (für Kunden verfügbar), order_by (aufsteigende Sortierung) und metadata (Erweiterungskonfiguration, z. B. extension_id).

## Versandart hinzufügen

POST /v1/tenants/shipping_methods — Nur Admins.

shipping_method-Body: shipping_method_id (integer, erforderlich, Plattformvorlagen-ID), name (string, erforderlich), note (string, optional), default (boolean, erforderlich; hebt andere Standardmethoden auf), active (boolean, erforderlich), order_by (integer, optional) und metadata (object, optional, z. B. extension_id).

## Ändern oder archivieren

PUT /v1/tenants/shipping_methods/:shipping_method_id aktualisiert die Methode mit denselben Feldern wie POST. DELETE /v1/tenants/shipping_methods/:shipping_method_id archiviert sie und entfernt sie aus dem Checkout. Nur Admins.

## Externe Preise

GET /v1/tenants/shipping_methods/:shipping_method_id/external ruft dynamische Preise ab. Die Methode muss metadata.extension_id besitzen und die Erweiterung das Ereignis external_shipping_methods unterstützen.

Parameter: shipping_address_id (integer, gespeicherte Kundenadresse zur Preisberechnung) und uuid (string, Warenkorb-UUID zum Abruf des aktuellen Inhalts).

Antwort: external_shipping_methods, Array der von der Erweiterung gelieferten Zustelloptionen.