Zum Hauptinhalt springen

Logistikkosten

Frank Birzle avatar
Verfasst von Frank Birzle
Diese Woche aktualisiert

Hinweis: Dieser Artikel wurde automatisch übersetzt. 🤖

1. Basis-URL und Versionierung

Die Basis-URL der Klar API ist https://open-api.getklar.com/ gefolgt von einem Versionsstring, z.B. 04.2024.

Gut zu wissen: Eine vollständige Definition der API-Endpunkte und der verfügbaren Versionen findest du in unserer automatisch generierten API-Spezifikation.

2. Endpunktübersicht und allgemeine Infos

Gut zu wissen: Wenn ein Feld in der API-Spezifikation als erforderlich gekennzeichnet ist, muss es in der Einreichung vorhanden sein. Wenn es nicht erforderlich ist und vorhanden ist, muss es einen gültigen Wert haben, z.B. kann cancelledAt nicht mit einem Wert von 0 übermittelt werden und muss auf undefined gesetzt werden.

Die Logistikkosten-API bietet die folgenden Endpunkte:

  • POST /<VERSION>/logistics-costs/validate

  • POST /<VERSION>/logistics-costs/json

  • GET /logistics-costs/status

POST /<VERSION>/logistics-costs/validate

Mit diesem Endpunkt kannst du deine Logistikkosten-Payload auf Gültigkeit prüfen. Wir prüfen derzeit auf Verstöße gegen die Spezifikation wie erforderliche Felder und Attributtypen, wie z.B. number, string usw. In Zukunft werden wir auch Logikverstoßfehler als Ergebnis einer fehlerhaften Payload zurückgeben. Der Request Body sollte ein JSON-Objekt mit dem Schlüssel "items" enthalten, das ein Array von bis zu 1000 JSON-Objekten vom Typ LogisticsCosts enthalten kann.

Gibt einen HTTP-Code 202 und den folgenden Response Body zurück:

{
"status": "VALID"
}

Gibt einen HTTP-Code 400 und eine Validator-Nachricht zurück, wenn ein Fehler aufgetreten ist:

[{
// ...
"children": [
{
"target": {
// ... LogisticsCosts Objekt
},
"value": null,
"property": "logisticsCosts",
"children": [],
"constraints": {
"isNumber": "logisticsCosts muss eine Zahl sein, die den angegebenen Einschränkungen entspricht."
}
}
]
// ...
}]

POST /<VERSION>/logistics-costs/json

Mit diesem Endpunkt kannst du deine Logistikkostendaten an Klar hochladen.

Der Request Body sollte ein Array von bis zu 1000 JSON-Objekten vom Typ LogisticsCosts enthalten. Die Antwort auf eine erfolgreiche Einreichung ist eine leere Antwort mit einem HTTP-Code 201.

Mit diesem Endpunkt kannst du Logistikkosten sowohl erstellen als auch aktualisieren. Übermittle einfach dieselben Logistikkosten erneut mit korrigierten oder aktualisierten Feldern, z.B. wenn sich die Höhe der für eine Bestellung ausgegebenen Logistikkosten ändert.

Wir bieten derzeit keinen Endpunkt zum vollständigen Löschen von hochgeladenen Daten an. Wenn du eine Einreichung löschen möchtest, schreibe bitte unserem Kundensupport-Team über unseren In-App-Chat oder per E-Mail an [email protected].

GET /logistics-costs/state

Mit diesem Endpunkt kannst du einige Metriken abfragen, wie z.B. den Gesamtbetrag der eingereichten Rückerstattungen total, die Anzahl der in der letzten Einreichung eingereichten lastBatchCount und die Zeit der letzten erfolgreichen / fehlgeschlagenen Einreichung lastSuccess / lastFailure.

Gibt einen HTTP-Statuscode 200 und einen Response Body zurück:

{
"total": "9",
"lastBatchCount": "4",
"lastSuccess": "2023-03-11T12:13:31.193Z",
"lastFailure": "2023-03-11T09:06:50.321Z"
}
Hat dies deine Frage beantwortet?