Carrier API Fehlercodes

Allgemeines

Fehlercodes in der Carrier API sind nach dem Schema AAA-SSS-GG-L[Code], wobei

• AAA = Applikation, in diesem Fall nur CAP für Carrier API
• SSS = Subgruppe, in diesem Fall das Plugin. Eine Auflistung der Plugins finden Sie weiter unten.
• GG = Fehlergruppe, diese teilt den Fehler in Kategorien, woher die Ursache in der Regel kommt
• L = Fehler-Level, wie schwerwiegend der Fehler ist: W = Warning, E = Error, C = Critical, F = Fatal
• [Code] = Ein numerischer Code, welche den Fehler in dieser Gruppe eindeutig zuordnet.

Beispiel: CAP-HEH-02-E00005

Bedeutet in diesem Fall ein Fehler innerhalb des Hermes HSI Moduls in der Gruppe 02 (Inhaltliche Fehler) mit dem Code 5 (Authentifizierung fehlgeschlagen).

In älteren Versionen der Carrier API war die Subgruppe Teil des Codes, also AAA-GG-LSSS[Code] Das obige Beispiel würde dann wie folgt lauten: CAP-02-EHEH05

Um einen solchen Fehlercode auf dieser Seite finden zu können, müssten Sie erst diesen Code in das neue Schema umwandeln, d.h. HEH durch 000 ersetzen und hinter das "CAP" "-HEH" hinzufügen.

Um einen Fehler zu suchen, suchen Sie bitte auf dieser Seite (Strg+F) zunächst mit dem eigentlichen Code.

Falls Sie den Code nicht direkt finden können, ersetzen Sie bitte die Subgruppe z.B. "HEH" durch XXX. Aus dem obigen Beispiel: CAP-XXX-02-E00005. Dieser Code ist in der Gruppe 02 vorhanden.

Gruppe 00 - Grundlegende Fehler

Diese Fehler treten auf, wenn die Fehlerursache nicht bekannt ist (z.B. 00000 - Undefinierter Fehler) oder ein grundlegendes Problem in der Funktionweise der Carrier API vorliegt.

Code	Text	Beschreibung
CAP-XXX-00-E00000	Fehler in Webservice Anfrage: [Fehlermeldung]	Fehlerursache nicht bekannt. Genaue Fehlermeldung untersuchen, ggf. Logs einsehen.
CAP-XXX-00-E00001	Plugin kann nicht erstellt werden	Problem beim aufrufen des jeweiligen Webservice-Plugins. Bitte Support kontaktieren

Gruppe 01 - Technische Fehler in der Anfrage

Diese Fehler treten auf, wenn die Anfrage aufgrund eines technischen Fehlers nicht erfolgreich war. Dies können temporäre Probleme sein, wenn der Server z.B. nicht erreichbar ist (00001 - Verbindungsfehler) oder überlastet ist (00002 - Read timeout). Oder aber grundlegende Probleme welche einen Eingriff erfordern (00004 - Zertifikatsfehler).

Code	Text	Beschreibung
CAP-XXX-01-C00001	[Connection error / Connection timeout] Es konnte keine Verbindung zum Webservice hergestellt werden. Bitte prüfen Sie Ihre Internet-Verbindung, URL, Firewall-, oder Proxy-Einstellungen.	Connection error: Verbindung nicht möglich. Eventuell wurde die Anfrage blockiert. Connect timeout: Die Carrier API konnte nicht feststellen, dass die Verbindung blockiert wurde. Eventuell ist die Verbindungsqualität nicht ausreichend.
CAP-XXX-01-E00002	Read timeout: Der Webservice hat nicht rechtzeitig auf die Anfrage reagiert.	In der Regel ist der Server vom Frachtführer überlastet. Sie können in den allgemeinen Einstellungen oder für diesen Endpoint versuchen, den Read timeout auf einen höheren Wert zu stellen.
CAP-XXX-01-C00003	DNS Fehler: Die URL [URL] ist unbekannt	Entweder blockiert Ihr DNS-Server die Anfrage der Carrier API oder die hinterlegte URL ist nicht korrekt.
CAP-XXX-01-C00004	Zertifikat vom Webservice kann nicht verifiziert werden. Bitte prüfen Sie Ihre Firewall oder URL.	Falls Ihre Firewall eine deep packet inspection enthält, stellt Sie ein Zwischen-Zertifikat bereit, welches der Carrier API nicht bekannt ist. Das wird von der Carrier-API als Man-in-the-Middle-Angriff interpretiert. Wenn Sie dem Zertifikat vertrauen, können Sie es X.509 kodiert unter [CarrierAPI]\config\certs hinterlegen.
CAP-XXX-01-F00005	Deserialisierungsfehler: Der Webservice hat ein ungültiges Dokument zurückgemeldet.	Bitte Support kontaktieren.
CAP-XXX-01-E00006	Labelkonvertierung fehlgeschlagen	Bitte Support kontaktieren.

Gruppe 02 - Inhaltliche Fehler in der Anfrage

Die Kommunikation mit dem Webservice war erfolgreich, allerdings entspricht die Antwort nicht der Erwartung. In der Regel hat der Webservice einen Fehler in der Anfrage (Sendungsdatensatz) gefunden und gibt diesen zurück.

Code	Text	Beschreibung
CAP-XXX-02-E00001	Allgemeiner Rückmeldungs-Fehler	Die Carrier API kann den Fehler nicht genau zuordnen. Bitte prüfen Sie die genaue Fehlermeldung zu diesem Fehlercode.
CAP-XXX-02-E00002	Fehler vom Webservice: [Fehlertext]	Der Webservice hat einen genauen Fehlercode und/oder Fehlertext zurückgemeldet. Bitte diesen genau prüfen und ggf. den Datensatz korrigieren.
CAP-XXX-02-E00003	Ungültige Antwort von Webservice: [Fehler-Detail]	Die Antwort vom Webservice entspricht nicht den Konventionen, welche der Carrier API bekannt sind. Es fehlen u.U. Pflichtfelder in der Antwort (z.B. Tracking-Nummer oder Label-Daten). Bitte prüfen Sie die Fehler-Details und kontaktieren Sie ggf. den Support.
CAP-XXX-02-E00004	Webservice hat HTTP [HTTP-Code] zurückgegeben	Es sind keine genauen Fehler-Details bekannt, außer dass der Webservice generell ein "Nicht-OK" zurückgegeben hat. In den Logs der Carrier API finden Sie in der Regel die gesamte Antwort des Webservice, welche eventuell weitere Details enthalten.
CAP-XXX-02-E00005	Authentifizierung mit dem Webservice fehlgeschlagen. Bitte prüfen Sie Ihre Zugangsdaten.	In der Regel sind die in der Carrier API hinterlegten Zugangsdaten falsch, oder der Frachtführer hat Ihren Account noch nicht freigeschaltet.

Gruppe 03 - Validierungsfehler

Bei manchen Frachtführern führt die Carrier API eine begrenzte Validierung selbst durch und gibt bereits vor der Anfrage an den Webservice einen Fehler zurück, wenn absehbar ist, dass diese Anfrage beim Frachtführer nicht akzeptiert wird.

Code	Text	Beschreibung
CAP-XXX-03-E00001	Validierungsfehler: [Fehler-Details]	Validierungsfehler, welcher nicht unter einer der folgenden Kategorien zutrifft. Bitte die Fehler-Details prüfen.
CAP-XXX-03-E00002	Ungültige Referenznummer	Der Webservice benötigt eine eindeutige Referenz-Nummer (z.B. Lieferschein-Nr.)
CAP-XXX-03-E00003	Empfänger Adresse ist ungültig	z.B. fehlende PLZ, Straße, Haus-Nr. usw.
CAP-XXX-03-E00004	Straße und Hausnummer muss getrennt werden	In der Sendung müssen Straße und Hausnummer separiert werden. Entweder wurde die Trennung im HVS32 nicht konfiguriert (Support kontaktieren) oder die Trennung war nicht erfolgreich (Datensatz kontrollieren: Hausnummer ganz am Ende oder Anfang der Straße?)
CAP-XXX-03-E00005	Trennung von Vor- und Nachname nicht möglich für: [Name]	Für die Trennung von Vor- und Nachnamen sind immer zwei Wörter erforderlich.
CAP-XXX-03-E00006	Ungültige Frankatur/Incoterm	Entweder fehlt eine Frankatur komplett oder der Frachtführer akzeptiert nur ganz bestimmte Frankaturen.
CAP-XXX-03-E00007	Termin Datum ist nicht gültig	Es wurde ein Dienst ausgewählt welcher ein Termin-Datum erwartet. Dieses ist entweder nicht belegt oder liegt in der Vergangenheit.
CAP-XXX-03-E00008	Kunden- / Account-Nr. ist ungültig	Die Kunden-Nr. im HVS32-Konfigurator oder der Benutzer im Carrier API Konfigurator entspricht nicht den Vorgaben des Frachtführers (z.B. numerisch).
CAP-XXX-03-E00009	Sendungsnummer ist ungültig	Das HVS32 sollte eigentlich eine (Versand-)Sendungs-Nummer erzeugen (Support kontaktieren) oder erwartet diese aus dem Vorsystem (Datensatz prüfen).
CAP-XXX-03-E00010	Trackingnummer ist ungültig	Das HVS32 sollte eigentlich eine Trackingnummer erzeugen (Support kontaktieren) oder erwartet diese aus dem Vorsystem (Datensatz prüfen).
CAP-XXX-03-E00011	Sonderdienst-ID ist ungültig	Der konfigurierte Dienst ist für diesen Frachtführer nicht gültig.
CAP-XXX-03-E00012	Ungültige E-Mail Adresse	Diese Sendung benötigt mit dem gewählten Dienst eine E-Mail Adresse. Diese wurde nicht übergeben. Bitte prüfen Sie den Datensatz.
CAP-XXX-03-E00013	Ungültige Telefonnummer	Diese Sendung benötigt mit dem gewählten Dienst eine Telefon-Nummer. Diese wurde nicht übergeben. Bitte prüfen Sie den Datensatz.
CAP-XXX-03-E00014	Ungültiger Warenwert	Diese Sendung benötigt mit dem gewählten Dienst einen Warenwert. Diese wurde nicht übergeben oder ist keine gültige Zahl. Bitte prüfen Sie den Datensatz.
CAP-XXX-03-E00015	Ungültiger Versicherungswert	Diese Sendung benötigt mit dem gewählten Dienst einen Versicherungswert. Diese wurde nicht übergeben oder ist keine gültige Zahl. Bitte prüfen Sie den Datensatz.
CAP-XXX-03-E00016	Ungültige ID für Paketshop	Für diese Sendung wurde eine Paketshop-Lieferung gewählt. Allerdings fehlt die dazugehörige Paketshop-ID oder sie ist nicht gültig (z.B. numerisch).
CAP-XXX-03-E00017	Fehlende Information für gewählten Service	Für diese Sendung wurde ein spezifischer Dienst gewählt. Allerdings fehlen für diesen Dienst zusätzliche Informationen, welche nun notwendig sind.
CAP-XXX-03-E00030	Gewicht ist ungültig	Das angegebene Packstück-Gewicht entspricht nicht den Vorgaben des Frachtführers (z.B. 0 kg oder mehr als der Frachtführer akzeptiert). Bitte prüfen Sie den Datensatz.
CAP-XXX-03-E00031	Paketabmessungen sind ungültig.	Der Frachtführer erwartet Paketabmessungen welche im Datensatz fehlen. Bitte prüfen Sie den Datensatz.
CAP-XXX-03-E00032	Verpackungart-ID ist ungültig	Entweder fehlt die Verpackungsart komplett oder der Frachtführer akzeptiert nur ganz bestimmte Verpackungsarten.
CAP-XXX-03-E00033	Paketinhalt ist ungültig	Diese Sendung benötigt mit dem gewählten Dienst den Paketinhalt. Dieser wurde nicht übergeben. Bitte prüfen Sie den Datensatz.
CAP-XXX-03-E00038	Keine Artikeldaten im Packstück vorhanden	Sendungen ins EU-Ausland benötigen in der Regel zusätzlich Artikeldaten um die Zollinformationen korrekt zu übergeben.
CAP-XXX-03-E00039	Keine Gefahrgutdaten im Packstück vorhanden	Beim gewählten Dienst handelt es sich um einen Gefahrgut-Dienst. Allerdings fehlen im Datensatz die Gefahrgutdaten.

Gruppe 04 - Konfigurationsfehler

Fehler der Gruppe 04 haben Ihre Ursache meist in einem nicht vollständig konfiguriertem Modul im HVS32 oder in der Carrier API. Unter Umständen kann aber auch der Datensatz fehlerhaft sein und auf eine falsche Konfiguration verweisen (z.B. wenn eine ungültige Versandart übergeben wurde).

Code	Text	Beschreibung
CAP-000-04-C00001	Keine Versandart gefunden für ID: [Versandart-ID]	Die Carrier API kann keinen Konfigurationseintrag mit der gewählten Versandart-ID finden. Entweder ist die Konfiguration unvollständig oder die übergebene Versandart-ID ist falsch.
CAP-000-04-C00002	Kein Auftragggeber gefunden für ID: [Auftraggeber-ID]	Die Carrier API kann keinen Konfigurationseintrag mit der gewählten Auftraggeber-ID finden. Entweder ist die Konfiguration unvollständig oder die übergebene Auftraggeber-ID ist falsch.
CAP-000-04-C00003	Plugin [Plugin] ist nicht lizensiert	Die Versandart bzw. der Endpoint verweist auf ein Frachtführer-Plugin welches noch nicht oder nicht mehr lizensiert ist. Bitte kontaktieren Sie den Support.
CAP-XXX-04-C00004	Kein Endpoint definiert für Versandart: [Versandart-ID]	Die gewählte Versandart wurde in der Carrier API gefunden allerdings nicht den Endpoint, auf welche diese Versandart verweist. Bitte kontaktieren Sie den Support.
CAP-XXX-04-C00005	Endpoint URL ist ungültig: [URL]	Bei der im Endpoint konfigurierten URL handelt es sich nicht um eine gültige URL. Bitte kontaktieren Sie den Support.
CAP-XXX-04-C00006	Ungültige Konfiguration für: [Konfigurations-Details]	Eine Frachtführer-spezifische Konfiguration ist unvollständig. Bitte prüfen Sie die Detaillierte Fehlermeldung für mehr Details

Frachtführer-Spezifische Fehler

Manche Frachtführer haben spezialisierte Fehlercodes, sofern es sich um einen Fehler handelt, welcher nicht allgemein zugeordnet werden kann. In den meisten Fehlern handelt es sich um erweiterte Validierungsfehler aus der Gruppe 03.

GLS Ship IT

Code	Text	Beschreibung
CAP-GLS-03-E00050	Ungültige GLS Contact ID	Die im HVS32 konfigurierte Contact ID fehlt oder ist ungültig

Hermes Shipping Interface (HSI)

Code	Text	Beschreibung
CAP-HEH-03-E00050	Ungültige Verpackungsart und Abmessungen. Mindestens eine Angabe ist erforderlich.	Hermes hat Verpackungen im Format XS, S, M, L, XL
CAP-HEH-03-E00051	Ungültiges Geburtsdatum für Ident-Service	Für diese Sendung wurde ein Ident-Service gewählt. Das Geburtsdatum fehlt allerdings oder handelt sich nicht um ein gültiges Datum.

Schenker AT

Code	Text	Beschreibung
CAP-SHA-03-E00050	Fehler in Gefahrgutsatz. Ungültige UN Nummer.	Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die UN-Nummer
CAP-SHA-03-E00051	Fehler in Gefahrgutsatz. Ungültige GG-Klasse.	Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Klasse.
CAP-SHA-03-E00052	Fehler in Gefahrgutsatz. Ungültiges GG-Gewicht.	Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie das GG-Gewicht.
CAP-SHA-03-E00053	Fehler in Gefahrgutsatz. Ungültige GG-Verpackung.	Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsart.
CAP-SHA-03-E00054	Fehler in Gefahrgutsatz. Ungültige GG-Verpackungsgruppe.	Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsgruppe.
CAP-SHA-03-E00055	Fehler in Gefahrgutsatz. Ungültige Bezeichnung.	Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Bezeichnung
CAP-SHA-03-E00056	Fehler in Gefahrgutsatz. Keine Netto-Explosivmasse definiert für GG-Klasse 1.	Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die Netto-Explosivmasse. Außerdem: Wurde mit Schenker AT abgesprochen, dass Sie Torpedos verschicken?
CAP-SHA-03-E00057	Fehler in Gefahrgutsatz. Ungültiger Mengen-Typ.	Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie den Mengen-Typ (kg oder l)

Plugin Codes

Jedes Plugin hat seine eigene Sub-Gruppe für einen Fehlercode. Nachfolgend aufgelistet sind alle Plugins.

Code	Plugin
000	Unbekannt - Plugin konnte noch nicht ermittelt werden
AGX	AGX
AMZ	Amazon Merchant Fulfillment
ASE	Asendia
ATL	Atlas
CHR	Chronopost
COU	Coureon
DCS	DCS
DEL	DHL Express Routing Live
DET	DHL Express Routing Test
DHA	DHL ELP (Abholung)
DHE	DHL ES
DHH	DHL Global Web Service (Ungarn)
DHN	DHL NL
DHP	DHL 24 PL
DHS	DHL SK (Slowakei)
DIM	Internetmarke (Deutsche Post)
DRI	DHL Retoure International
DRL	DHL Retoure International (Legacy - veraltet)
DVF	AM.Exchange (DV-Freimachung)
FED	Fedex
FXA	Fedex (Abholung)
FXS	Fedex Stratus REST API
GEO	Geodis
GLD	GLS DK (Dänemark)
GLI	GLS IT (Italien)
GLL	GLS CZ (Tschechien)
GLN	GLS NL (Niederlande)
GLS	GLS Ship IT (Deutschland)
GPP	General Purpose (konfigurierbar)
GPS	GLS Parcel Shop (GLS DE Parcelshop Suche)
HEH	Hermes Shipping Interface (HSI)
HEL	Hermes (Legacy - veraltet)
INP	Inpost24
KUR	Der Kurier
MON	Mondial Relay
ONT	Ontime
PAT	Post AT (Österreich)
PIL	Pilot
PPL	PPL
PSI	Post SI (Slovenien)
SES	Seven Senders (7senders)
SHA	Schenker AT (Österreich)
SHD	Schenker
SHS	Schenker SE (Schweden)
TNI	TNT IT (Italien)
TNN	TNT Post NL (Niederlande)
TNT	TNT (Deutschland)
TOH	TOF HU (Ungarn)
TPN	TPN
TRA	Tradebyte
UPA	UPS Pickup (Abholung)
UPG	UPS GG (Gefahrgut PreAvis)
UPP	UPS Paperless Document
UPT	UPS Tarifierung