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).

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
CAP-XXX-00-E00002	Plugin veraltet	Das gewählte Carrier API Plugin ist veraltet und der Webservice wurde vom Frachtführer abgekündigt. 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.
CAP-XXX-02-E00006	Der Webservice hat den Sendungsstaus nicht in angemessener Zeit geändert	Bei asynchronen Webservices (z.B: Inpost24 oder FedEx Stratus) wartet die Carrier API bis vom Webservice ein Abgeschlossen- oder Fehler-Status zurück kommt. Sollte dies nicht rechtzeitig erfolgen, dann wirft die Carrier API diesen Fehler.

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
AS2	Amazon Shipping API v2
ASM	Amazon Selling Partner API - Merchant Fulfillment
ASV	Amazon Selling Partner API - Vendor Direct
DVF	AM.Exchange (DV-Freimachung)
ANL	Angel
APC	APC Overnight
ACO	Arco
ASE	Asendia
ATL	Atlas
CAL	Canis Lupus
CAR	Carousel
CEN	Centiro
CHR	Chronopost
CIP	Citipost
COU	Coureon
DSK	Danske
DCS	DCS
KUR	Der Kurier
DHP	DHL 24 PL
DEC	DHL eConnect
DHA	DHL ELP (Abholung)
DBB	DHL ES B2B
DHE	DHL ES B2C
DEL	DHL Express Routing Live
DET	DHL Express Routing Test
DHH	DHL Global Web Service (Ungarn)
DHN	DHL NL
DRL	DHL Retoure International (Legacy - veraltet)
DRI	DHL Retoure International
DHS	DHL SK (Slowakei)
DPD	DPD
DPA	DPD AT (Österreich)
DFR	DPD FR (Frankreich)
DPC	DPD HR (Kroatien)
DPH	DPD HU (Ungarn)
DPP	DPD DE Parcelshop Suche
DPL	DPD PL (Polen)
DPR	DPD RO (Rumänien)
EPK	Europaket
FTD	Fedex Trade Documents
FXA	Fedex (Abholung)
FXP	Fedex PL (Polen)
FXS	Fedex Stratus REST API
FED	Fedex
FAC	Fiege Amazon Carma
GPP	General Purpose (konfigurierbar), auch G00 - G99
GEO	Geodis
GLO	Glovo
GLL	GLS CZ (Tschechien)
GLD	GLS DK (Dänemark)
GLE	GLS ES (Spanien)
GLF	GLS FR (Frankreich)
GLH	GLS HU (Ungarn)
GLI	GLS IT (Italien)
GLN	GLS NL (Niederlande)
GLP	GLS PL (Polen)
GPS	GLS Parcel Shop (GLS DE Parcelshop Suche)
GSA	GLS AT / Ship IT (Österreich)
GSD	GLS DK / Ship IT (Dänemark)
GSF	GLS FR / Ship IT (Frankreich)
GSP	GLS PL / Ship IT (Polen)
GLS	GLS DE / Ship IT (Deutschland)
GLK	GLS SK (Slowakei)
GTT	GLS DE Track & Trace
HMP	Hellmann PL (Polen)
HBG	Hermes Border Guru
HES	Hermes Einrichtungs Service (HES)
HEH	Hermes Shipping Interface (HSI)
HRB	Hornbach
ICS	ICS
INP	Inpost24
DIM	Internetmarke (Deutsche Post)
IZP	Infens Zustellprofi
KOV	Kommt Overnight
LFG	Liefergrün
LGX	Log X Star
MON	Mondial Relay
PPL	PPL
NCX	Nacex
OMS	Omest
ONT	Ontime
PLW	Palletways
PIL	Pilot
PAT	Post AT (Österreich)
PHR	Posti HR (Kroatien)
PFI	Posti FI (Finnland)
PON	Post Nord
PSI	Post SI (Slovenien)
PSK	Post SK (Slovakei)
PPL	PPL
SHA	Schenker AT (Österreich)
SHD	Schenker
SHS	Schenker SE (Schweden)
SND	Sending
SES	Seven Senders (7senders)
SPR	SPRING
TDN	TDN
TRM	Tiramizoo
TMP	TMParcel
TNI	TNT IT (Italien)
TNF	TNT FR (Frankreich)
TNN	TNT Post NL (Niederlande)
TBN	TNT NL - Retoure Belgien
TNT	TNT (Deutschland)
TOH	TOF HU (Ungarn)
TPN	TPN
0	0
UPG	UPS GG (Gefahrgut PreAvis)
UPP	UPS Paperless Document
UPA	UPS Pickup (Abholung)
UPA	UPS Pickup (Abholung)
UPT	UPS Tarifierung
VNP	Venipak
WYF	Wayfair