Beim Benutzen der ITscope-API können einige Fehler vorkommen, die in den meisten Fällen vom Nutzer selbst repariert werden können. In diesem Guide werden je Fehlercode einige häufige Fehlermeldungen aufgeschlüsselt und erklärt, was es mit ihnen auf sich hat.
Allgemeines
Fehler werden von der ITscope-API im folgenden Format ausgegeben (hier exemplarisch als json):
{
"eventId": "abc123456789",
"timestamp": "2023-02-28T11:23:32.530+01:00",
"message": "NotFoundException: No order found with the order ID 123123123"
}400 – Bad Request
Die Anfrage an unseren Server wurde fehlerhaft aufgebaut. In der Nachricht der Fehlermeldung werden meist Informationen bereitgestellt, die einem genau erklären, was an der Anfrage falsch war.
| Fehlernachricht | Erklärung |
Invalid content provided. In element 'ns2:STREET' the value of '' is too short. A minimum length of '1' characters is required. The problem occurred in line 25, within the 'ADDRESS' block. | Das gelieferte XML-Dokument war invalide. In diesem Fall darf das Element „STREET“ nicht leer sein. |
Only orders in the status of arrived can be rejected. | Die angefragte Bestellung ist nicht im Zustand “Empfangen”, weshalb sie nicht abgelehnt werden kann. |
Für die Position Nr. 1 konnte die Bezugsquelle nicht gefunden werden. | Das Produkt aus der Position 1 konnte beim angefragten Lieferanten nicht gefunden werden. |
Adresse des Käufers oder des Empfängers ist unvollständig. Pflichtfelder sind Name, Straße, Postleitzahl und Land. | Eine der Adressen der Anfrage war unvollständig und sollte überarbeitet werden. |
Ingram Kundennummer 123456 entspricht nicht dem Format X, wobei [...]oder Ungültige Travion-Kundennummer 123456 hinterlegt. Eine gültige Kundennummer ist [...] | Die bereitgestellte Kundennummer war nach dem Schema des Lieferanten nicht valide. Im hier abgeschnittenen Teil der Fehlernachricht wird das Schema erklärt. |
401 – Unauthorized
Die Authentifizierung mit unserem Server war nicht erfolgreich. Die Logindaten sollten geprüft werden.
| Fehlernachricht | Erklärung |
Logindaten falsch oder keine Logindaten spezifiziert. | Entweder es wurden keine oder invalide Anmeldedaten der Anfrage ergänzt. |
Authentifizierung des Kunden über Realtime-Preisabruf fehlgeschlagen. Die Bestellung kann nicht versendet werden. | Die Authentifizierung des Kunden für den Realtime-Preisabruf war nicht erfolgreich. Die Realtime-Anmeldedaten sollten überprüft werden. |
403 – Forbidden
Der Zugriff auf die angefragte API-Schnittstelle wurde von unserem Server abgelehnt, da der aktuelle Vertrag diese nicht abdeckt. Um Zugriff zu erhalten, muss der Vertrag aktualisiert werden.
| Fehlernachricht | Erklärung |
The ITscope Order-API is not available for your account. Please make sure your subscription offers the Order-API Module. | Im Vertrag fehlt das Bestell-API (und ggf. das Schnittstellen)-Modul. Diese sollten abonniert werden, um die Aktion durchzuführen. |
404 – Not Found
Die angefragte Ressource konnte nicht gefunden werden. Die übermittelten Parameter sollten überprüft werden.
| Fehlernachricht | Erklärung |
No order found with the order ID ABCDEF-123456-789G | Die angefragte Bestellung ABCDEF-123456-789G konnte nicht gefunden werden. Hierbei wurde die Bestellungs-ID als Parameter geliefert. |
No personalnr or USER_ID parameter was specified in the supplier setup URL | Die Anfrage enthielt invalide Parameter. |
Order not found with orderId ABCDEF-123456-789G and customerNumber 123456 and seller | Die angefragte Bestellung ABCDEF-123456-789G konnte nicht gefunden werden. Hierbei wurde die Bestellungs-ID im Request-Body (XML-Dokument) geliefert. |
500 – Internal Server Error
Die Anfrage konnte nicht verarbeitet werden, da der Server intern auf einen Fehler gestoßen ist. Nur in wenigen Fällen liegt der Fehler direkt beim Benutzer.
503 – Service Unavailable
Wenn innerhalb kurzer Zeit zu viele Anfragen von einer IP-Adresse gesendet werden, blockiert der Server jegliche weitere Anfrage des Nutzers.
| Fehlernachricht | Erklärung |
Rate Limit Exceeded. You are now blocked for 30 minutes. ITscope Web Service and ITscope Api is limited to 200 requests per 30 seconds. | Innerhalb von 30 Sekunden wurden mehr als 200 Anfragen an unseren Server gesendet, weshalb der Benutzer für 30 Minuten blockiert wurde. Weitere Informationen. |