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