API Prozessstatus
Nach der Bestätigung von Bestellungen und der Aktualisierung Ihres Angebots über die API ist es wichtig, dass Sie immer einen sogenannten „Prozessstatus“ abfragen. Auf dieser Seite erklären wir, was ein Prozessstatus ist und warum es wichtig ist, diesen abzufragen.
Nach einer Anfrage, bei der Daten geändert werden, wie zum Beispiel die Anpassung eines Preises eines artikels oder die Bearbeitung einer Bestellung, ist es wichtig, dass immer ein Prozessstatus abgefragt wird. Ein Prozessstatus zeigt an, ob eine solche Art von Anfrage (POST, PUT oder DELETE Request) tatsächlich korrekt im bol-System verarbeitet wurde. Das heißt, der Prozessstatus gibt an, ob Ihre Anpassung bearbeitet wurde.
Erläuterung des Prozesses
Wenn Sie beispielsweise eine bol-Bestellung aus Ihrem eigenen System bestätigen, bedeutet dies nicht, dass die Bestellung auch direkt korrekt über bol verarbeitet wurde. Anfragen (Requests), bei denen Daten geändert werden, werden nämlich zuerst in eine Warteschlange gestellt. Die Retailer API arbeitet ständig aus der Warteschlange heraus, um alle Requests zu bearbeiten. Abhängig von der Anzahl der Requests in der Warteschlange kann die Bearbeitungszeit für einen Request variieren. Wenn ein Request an erster Stelle in der Warteschlange steht, leiten wir ihn an einen anderen internen Dienst weiter. Ein Prozessstatus zeigt an, ob ein Request tatsächlich korrekt von unseren internen Diensten verarbeitet wurde.
Wenn Sie einen Prozessstatus abfragen, geben wir einen der folgenden Status zurück: SUCCESS, FAILURE, PENDING oder TIMEOUT. Nachfolgend finden Sie eine kurze Erläuterung der verschiedenen Status:
- SUCCESS zeigt an, dass ein Request korrekt von uns verarbeitet wurde, Sie müssen keine weiteren Maßnahmen ergreifen.
- FAILURE zeigt an, dass der Request nicht korrekt verarbeitet wurde. Wir geben immer eine Erläuterung zurück, warum die Anpassung nicht erfolgreich war. Verwenden Sie die Erläuterung in der Fehlermeldung eines FAILURE, um den Request bei Bedarf anzupassen.
- PENDING zeigt an, dass der Request noch weiter verarbeitet werden muss. Fragen Sie den Prozessstatus des Requests zu einem späteren Zeitpunkt erneut ab, um den endgültigen Status zu erhalten.
- Wenn das System einen Request nicht innerhalb eines bestimmten Zeitraums verarbeiten konnte, geben wir den Status TIMEOUT zurück. Bei einem TIMEOUT müssen Sie den ursprünglichen Request zu einem späteren Zeitpunkt erneut senden.
Weitere Informationen zum Prozessstatus finden Sie hier.