Curosa
Supplier Portal API Reference New

Core resources

Distributionszentren

Rufen Sie eine Liste der verfügbaren Distributionszentren ab, in denen Sie Ihre Produkte lagern und abwickeln können

Übersicht

Der Endpunkt für Distributionszentren gibt alle Distributionszentren zurück, die für Ihr Lieferantenkonto verfügbar sind. Jedes Distributionszentrum ist einem bestimmten Standort zugeordnet und beschreibt dessen betriebliche Kapazitäten. Codes für Distributionszentren werden in der gesamten API referenziert, wenn mit Inventar und Bestandsaktualisierungen gearbeitet wird.

Authentifizierung

Dieser Endpunkt erfordert eine Authentifizierung. Geben Sie Ihr API-Token im Authorization-Header an. Weitere Informationen zum Erhalt eines Tokens finden Sie im Authentifizierungs-Leitfaden.

Alle Distributionszentren auflisten

Rufen Sie eine Liste aller für Ihr Konto verfügbaren Distributionszentren ab.

Endpunkt: GET https://curosa.com/api/v1/distribution-centres

Anfrage

curl --location 'https://curosa.com/api/v1/distribution-centres' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

Antwort

Gibt ein 200 OK mit einem data-Array zurück, das alle Distributionszentren enthält:

{
    "data": [
        {
            "code": "DEMO-DC",
            "name": "Demo Distribution Centre",
            "site": {
                "code": "UK",
                "name": "United Kingdom"
            },
            "is_supplier_dc": true,
            "is_fulfillment_centre": true,
            "is_warehouse": true,
            "is_active": true,
            "leadtime_days": 0,
            "cutoff_time": "17:00:00"
        }
    ]
}

Antwortfelder:

Feld Typ Beschreibung
code string Eindeutige Kennung für das Distributionszentrum. Wird als Referenz in anderen API-Aufrufen verwendet
name string Anzeigename des Distributionszentrums
site object Der Standort, zu dem dieses Distributionszentrum gehört
site.code string Standortkennung (z. B. „UK“)
site.name string Anzeigename des Standorts (z. B. „United Kingdom“)
is_supplier_dc boolean Gibt an, ob es sich um ein vom Lieferanten verwaltetes Distributionszentrum handelt
is_fulfillment_centre boolean Gibt an, ob dieses Zentrum Kundenbestellungen abwickeln kann
is_warehouse boolean Gibt an, ob dieses Zentrum Lagerbestände führen kann
is_active boolean Gibt an, ob dieses Distributionszentrum derzeit betriebsbereit ist
leadtime_days integer Anzahl der für die Bearbeitung vor dem Versand erforderlichen Tage
cutoff_time string Tägliche Bestellannahmefrist, nach der Bestellungen am nächsten Tag bearbeitet werden (Format: „HH:MM:SS“)

Verwendung von Distributionszentrum-Codes

Der code-Wert wird verwendet, wenn in anderen API-Aufrufen auf ein Distributionszentrum verwiesen wird, z. B. beim Festlegen von Lagerbeständen für ein Produkt:

{
    "distribution_centre_stock": [
        {
            "distribution_centre_code": "DEMO-DC",
            "stock_quantity": 50
        }
    ]
}

Ratenbegrenzung

Dieser Endpunkt ist auf 3.600 Anfragen pro Stunde begrenzt. Das aktuelle Limit und die verbleibenden Anfragen werden in den Antwort-Headern als x-ratelimit-limit und x-ratelimit-remaining zurückgegeben.