Curosa
Supplier Portal API Reference New

Fulfilment

Lagerbestand im Logistikzentrum

Abrufen und Aktualisieren von Bestandsmengen in Logistikzentren

Übersicht

Die Endpunkte für den Lagerbestand im Logistikzentrum ermöglichen es Ihnen, das Inventar nach Logistikzentrum abzurufen und Bestandsmengen für einzelne oder mehrere Produkte zu aktualisieren.

Authentifizierung

Alle Endpunkte erfordern eine Authentifizierung. Geben Sie Ihren API-Token im Authorization-Header an. Weitere Informationen zum Erhalt eines Tokens finden Sie im Leitfaden zur Authentifizierung.

Lagerbestand im Logistikzentrum auflisten

Rufen Sie die Bestandsmengen über Ihre Logistikzentren hinweg ab.

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

Anfrage

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

Antwort

Gibt eine 200 OK-Antwort zurück:

{
    "data": [
        {
            "distribution_centre_code": "DEMO-DC",
            "sku": "DEMO001",
            "platform_sku": "201.228.141",
            "stock_quantity": 0,
            "stock_quantity_allocated": 0,
            "stock_quantity_free": 0,
            "inbound_quantity": 0,
            "inbound_quantity_allocated": 0,
            "inbound_quantity_free": 0
        }
    ],
    "links": {
        "first": null,
        "last": null,
        "prev": null,
        "next": null
    },
    "meta": {
        "path": "https://curosa.test/api/v1/distribution-centre-stocks",
        "per_page": 100,
        "next_cursor": null,
        "prev_cursor": null
    }
}

Lagerbestand im Logistikzentrum aktualisieren

Aktualisieren Sie die Bestandsmenge für ein einzelnes Produkt in einem Logistikzentrum.

Endpunkt: POST https://curosa.com/api/v1/distribution-centre-stocks

Anfrage

curl --location 'https://curosa.com/api/v1/distribution-centre-stocks' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "distribution_centre_code": "DEMO-DC",
    "sku": "DEMO001",
    "stock_quantity": 10
}'

Anfrage-Body

Feld Typ Erforderlich Beschreibung
distribution_centre_code String Ja Kennung des Logistikzentrums
sku String Ja Lieferanten-SKU
stock_quantity Integer Ja Neue Bestandsmenge

Antwort

{
    "updated": [
        {
            "distribution_centre_code": "DEMO-DC",
            "platform_sku": "201.228.141",
            "sku": "DEMO001",
            "stock_quantity": 10
        }
    ],
    "errors": []
}

Massenaktualisierung des Lagerbestands im Logistikzentrum

Aktualisieren Sie Bestandsmengen für mehrere Artikel in einer einzigen Anfrage.

Endpunkt: POST https://curosa.com/api/v1/distribution-centre-stocks/bulk-update

Anfrage

curl --location 'https://curosa.com/api/v1/distribution-centre-stocks/bulk-update' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '[
    {
        "distribution_centre_code": "DEMO-DC",
        "sku": "DEMO001",
        "stock_quantity": 0
    },
    {
        "distribution_centre_code": "DEMO-DC",
        "sku": "DEMO004",
        "stock_quantity": 0
    }
]'

Anfrage-Body

Ein Array von Bestandsaktualisierungsobjekten. Jedes Objekt erfordert:

  • distribution_centre_code (String)
  • sku (String)
  • stock_quantity (Integer)

Rate Limiting (Ratenbegrenzung)

Die Endpunkte für den Lagerbestand im Logistikzentrum sind 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.