Häufige EDI-Fehlermeldungen

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.