Wiki - Heidler Strichcode GmbH - Benutzerbeiträge [de]

IRIS Installation (Windows)

2023-12-11T11:04:52Z

Sbaumbach: /* MariaDB */

== Hinweis zur Installation auf Windows ==
Die hier formulierte Installationsanleitung beschreibt die Installation von [[IRIS Cloudsystem|IRIS]] auf einem Windows System.

Allerdings möchten wir an dieser Stelle darauf hinweisen, dass die [[IRIS Installation (Docker)|Installation unter Docker]] die simplere Methode zur Installation von IRIS ist.

Im Docker-Container sind diverse Dienste schon vorbereitet, welche hier manuell installiert und konfiguriert werden müssen, dazu zählen u.a.:

* MariaDB
* Interne Zertifizierungsstelle (interne Root CA)
* Reverse Proxy / Webserver

Eine Installation unter Windows ist nur zu empfehlen, wenn man sich mit den o.g. Diensten / Tools bereits sehr gut auskennt.

== MariaDB ==
Für die Installation von IRIS wird eine installierte MariaDB vorausgesetzt:

https://mariadb.org/

Wir testen IRIS hierbei immer gegen die letzte LTS-Version von MariaDB. Zum jetzigen Zeitpunkt (11.12.2023) ist das die Version 10.11.

Zur Administration der Datenbank können Sie ein Tool Ihrer Wahl nehmen, z.B. [https://dbeaver.io/ DBeaver], [https://www.heidisql.com/ HeidiSQL] oder das bei der Installation mitgelieferte Kommandozeilentool mysql.

=== Datenbanken ===
Zum Anlegen der Datenbanken können Sie folgendes Script als root User ausführen:<syntaxhighlight lang="sql" line="1" start="1">
create database iris_common character set = 'utf8mb4' collate 'utf8mb4_general_ci';
create database iris_account character set = 'utf8mb4' collate 'utf8mb4_general_ci';
create database iris_shipping character set = 'utf8mb4' collate 'utf8mb4_general_ci';
</syntaxhighlight>

=== User ===
Zur besseren Sicherheit sollten jede Datenbank mit einem eigenen User versehen werden, wobei jeder User nur auf diese eine Datenbank Zugriff hat.

Bitte verwenden Sie ein sicheres Passwort, sowie für jeden Benutzer ein anderes Passwort, und ersetzen Sie es in den Befehlen unten.

Falls Sie die MariaDB und IRIS auf unterschiedlichen Servern installieren, dann ersetzen Sie bitte den Teil @'localhost' durch die IP Adresse, wo IRIS installiert wird oder eine geeignete Wildcard, z.B. @'10.0.0.15' oder @'10.0.0.%'<syntaxhighlight lang="sql" line="1" start="1">
-- User for iris_common. Please replace the password with a secure random password
create user 'iris_common'@'localhost' identified by 'secure_password_for_iris_common_to_be_replaced';
grant all on iris_common.* to 'iris_common'@'localhost';

-- User for iris_account. Please replace the password with a secure random password
create user 'iris_account'@'localhost' identified by 'secure_password_for_iris_account_to_be_replaced';
grant all on iris_account.* to 'iris_account'@'localhost';

-- User for iris_shipping. Please replace the password with a secure random password
create user 'iris_shipping'@'localhost' identified by 'secure_password_for_iris_shipping_to_be_replaced';
grant all on iris_shipping.* to 'iris_shipping'@'localhost';

flush privileges;
</syntaxhighlight>

=== Verschlüsselung der Verbindung ===
Die Verbindung zur MariaDB muss mit TLS/SSL abgesichert werden.

Hierzu können Sie nach offizieller Anleitung vorgehen:

https://mariadb.com/kb/en/securing-connections-for-client-and-server/

Zum Erstellen des Zertifikats verwenden Sie bitte Ihre interne Zertifizierungs-Stelle (interne Root CA).

Bitte prüfen Sie die verschlüsselte Verbindung bevor Sie fortfahren.

== Installation iris-account ==
Sie erhalten das Setup von iris-account von unserem Support.

=== Installation ===
Für die Erstinstallation folgen Sie bitte dem Installer. Im Folgenden nehmen wir eine Installation auf C:\Heidler\iris\account an. Sollte Ihre Installation abweichen, ersetzen Sie bitte die Pfade entsprechend.

=== Datenbank-Verbindung ===
Zunächst muss die Verbindung zur Datenbank konfiguriert werden. iris-account benötigt eine Verbindung zu den Datenbanken iris_account und iris_common.

Sie finden die vorbereiteten Konfigurationsdateien unter: C:\Heidler\iris\account\config\database

Hier bitte die zwei Dateien kopieren und die Endung .example entfernen.

Danach bitte die Konfigurationsdateien anpassen. Die Dateien selbst enthalten eine Dokumentation und Erklärung zu jedem Parameter.

Wichtig: .properties Dateien können Sonderzeichen beinhalten, diese werden mit einem \ escaped. Sollten Sie einen Backslash benötigen (z.B. als Teil der Pfadangabe des Zertifikates), dann müssen Sie dies auch mit einem \ escapen. Beispiel:

serverCertificate=C:\\Heidler\\iris\\ssl\\ca.crt

=== Port ===
Standardmäßig starten iris-account einen HTTP-Webservice auf Port 9710.

Zum Ändern des Ports editieren Sie bitte die Datei: C:\Heidler\iris\account\config\service.properties

=== Erster Start ===
Sie können nun iris-account testweise starten.

Nach dem Start erhalten Sie eine Log-Datei unter: C:\Heidler\iris\account\logs\service.log

Wenn alles erfolgreich gestartet wurde, dann erhalten Sie einen Eintrag, der so ähnlich lautet:<syntaxhighlight lang="text" line="1" start="1">
2023-02-08 17:22:38.926 -08 WARN [main] (init.ServiceInitializer:166) - A new user has been created.:
Username: root@localhost
Password: P6oV-GK3GYsdnn_5usDg1tBmn00
Please login with this user and change your password immediately!
</syntaxhighlight>Bitte notieren Sie sich diesen Benutzer + Passwort umgehend.

=== HTTPS ===
Um HTTPS für iris-account zu aktivieren, hinterlegen Sie bitte das Server-Zertifikat im X.509 Format und den Private-Key im PKCS#8 Format unter folgenden Dateinamen:

C:\Heidler\iris\account\config\server-cert.pem

C:\Heidler\iris\account\config\server-privatekey-pkcs8.pem

Die Zertifikate müssen Sie mit Ihrer internen Zertifizierungsstelle erstellen (interne Root CA).

Nach dem Hinterlegen starten Sie bitte den Dienst neu.

Im Log sollten Sie dann nach dem Neustart diesen Log-Eintrag finden:<syntaxhighlight lang="text" line="1" start="1">
2023-02-08 17:27:44.367 -08 INFO [main] (rest.WebServer:88) - Starting https server on port 9710
</syntaxhighlight>

== Installation iris-shipping ==
Sie erhalten das Setup von iris-shipping von unserem Support.

=== Installation ===
Für die Erstinstallation folgen Sie bitte dem Installer. Im Folgenden nehmen wir eine Installation auf C:\Heidler\iris\shipping an. Sollte Ihre Installation abweichen, ersetzen Sie bitte die Pfade entsprechend.

=== Datenbank-Verbindung ===
Zunächst muss die Verbindung zur Datenbank konfiguriert werden. iris-account benötigt eine Verbindung zu den Datenbanken iris_shipping und iris_common.

Sie finden die vorbereiteten Konfigurationsdateien unter: C:\Heidler\iris\shipping\config\database

Hier bitte die zwei Dateien kopieren und die Endung .example entfernen.

Danach bitte die Konfigurationsdateien anpassen. Die Dateien selbst enthalten eine Dokumentation und Erklärung zu jedem Parameter.

Wichtig: .properties Dateien können Sonderzeichen beinhalten, diese werden mit einem \ escaped. Sollten Sie einen Backslash benötigen (z.B. als Teil der Pfadangabe des Zertifikates), dann müssen Sie dies auch mit einem \ escapen. Beispiel:

serverCertificate=C:\\Heidler\\iris\\ssl\\ca.crt

=== Port ===
Standardmäßig starten iris-shipping einen HTTP-Webservice auf Port 9720.

Zum Ändern des Ports editieren Sie bitte die Datei: C:\Heidler\iris\shipping\config\service.properties

=== Erster Start ===
Sie können nun iris-shipping testweise starten.

Nach dem Start erhalten Sie eine Log-Datei unter: C:\Heidler\iris\account\logs\service.log

=== HTTPS ===
Um HTTPS für iris-account zu aktivieren, hinterlegen Sie bitte das Server-Zertifikat im X.509 Format und den Private-Key im PKCS#8 Format unter folgenden Dateinamen:

C:\Heidler\iris\shipping\config\server-cert.pem

C:\Heidler\iris\shipping\config\server-privatekey-pkcs8.pem

Die Zertifikate müssen Sie mit Ihrer internen Zertifizierungsstelle erstellen (interne Root CA).

Nach dem Hinterlegen starten Sie bitte den Dienst neu.

Im Log sollten Sie dann nach dem Neustart diesen Log-Eintrag finden:<syntaxhighlight lang="text" line="1" start="1">
2023-02-08 17:33:47.257 -08 INFO [main] (rest.WebServer:88) - Starting https server on port 9720
</syntaxhighlight>

== Installation Frontend ==
Sie erhalten die Frontend-Dateien für IRIS von unserem Support.

Bitte entpacken Sie diese Dateien an einem Ort, wo Ihr Webserver / Reverse-Proxy Zugriff hat und diese veröffentlichen kann (z.B. C:\Heidler\iris\frontend).

== Reverse Proxy + Web Server ==

Bitte installieren Sie einen geeigneten Reverse Proxy und Webserver, welcher die Anfragen aus dem Internet entgegennimmt und sowohl das Frontend ausliefern, als auch Anfragen an IRIS weiterleiten kann.

Der Reverse Proxy muss folgende Aufgaben übernehmen:

* Öffentlicher HTTPS-Server mit gültigem und anerkanntem HTTPS-Zertifikat
* Automatische Weiterleitung von HTTP-Anfragen auf HTTPS
* Auslieferung der statischen Frontend-Dateien (Inhalt vom Frontend-Vereichnis entspricht dem URL-Pfad)
** z.B. https://<domain>/ zu [frontend]\index.html
** z.B. https://<domain>/js/site.js zu [frontend]\js\site.js
* Umleitung aller Anfragen auf /account an iris-account, inkl. des URL-Teils /account
** z.B. https://<domain>/account/validate zu https://<servername>:9710/account/validate
* Umleitung aller Anfragen auf /v2/hsc/shipping an iris-shipping, inkl. des URL-Teils /v2/hsc/shipping
** z.B. https://<domain>/v2/hsc/shipping/echo/test zu https://<servername>:9720/v2/hsc/shipping/echo/test

Intern haben wir diese Konfiguration bereits mit nginx und auch IIS testen können.

Bitte beachten Sie allerdings, dass wir Ihnen keine Unterstützung bei der Konfiguration von externen Diensten geben können.

IRIS General description

2023-12-07T07:59:35Z

Sbaumbach: /* Challenges */

[[de:IRIS Allgemeine Beschreibung]]
[[IRIS cloud system|IRIS]] enables you to securely publish functions of the HVS32 dispatch system into the public internet (cloud capability).

== Issues with cloud systems ==
In principle, the HVS32 can be operated in cloud environments without hesitation, provided that the connection from the upstream system (ERP or WMS, hereinafter referred to as just ERP for simplicity) to the HVS32 is in a shared, secure, internal network.
[[Datei:IRIS internal network.png|alternativtext=|zentriert|rahmenlos|717x717px]]
Problems arise, however, when a connection is to take place across networks:
[[Datei:IRIS Problem across networks.png|alternativtext=|zentriert|rahmenlos|702x702px]]
Then this connection between two networks must be secured.

Secured means: Both the connection must be encrypted and each incoming connection must be authenticated and authorized.

There are two possibilities for this. The bridging of the networks by means of VPN or the secured publication of the HVS32 functions to the Internet with IRIS, a software developed by Heidler Strichcode.

== VPN vs IRIS ==
There is no 100% perfect solution for securing the network bridge. Mostly you have to choose a compromise depending on the case.

Here we will list the common advantages and disadvantages of a VPN connection compared to IRIS to help you decide.

{| class="wikitable"
|+
!VPN
!IRIS
|-
|'''+''' Simple setup
|'''+''' Accessible from the internet
|-
|'''+''' No further safety concerns
|'''+''' Accessible for multiple ERP systems simultaneously
|-
|'''+''' Only minor change effort for existing systems
|'''+''' Also accessible from [https://en.wikipedia.org/wiki/Software_as_a_Service SaaS] ERP systems
|-
|'''-''' Only possible with self-hosted (installed) ERP system
[https://en.wikipedia.org/wiki/Software_as_a_Service SaaS] based ERP systems are not possible.
|'''+''' Developed according to the latest safety standards
|-
|'''-''' HVS32 is only accessible within these 2 networks
The VPN connection becomes mandatory for every client
|'''+''' Future features possible, e.g. information in web interface (in planning)
|-
|'''-''' Difficult scalability
Multiple ERP systems only with extension of VPN connection
|'''-''' Complex setup of all security-related technologies
|-
|
|'''-''' Higher technical requirements for clients (ERP systems)
|-
|
|'''-''' Regular (security) updates required
|}

== IRIS in the cloud environment ==
If you decided to use IRIS, the IRIS system would integrate with your internal corporate or cloud network as follows:
[[Datei:IRIS in the network.png|alternativtext=|zentriert|rahmenlos|694x694px]]
All requests to IRIS are encrypted, authenticated, and authorized.

Encrypted: Encryption is possible via HTTPS using TLSv1.2 or TLSv1.3 (if supported by the client).

Authenticated: Each user is given a personal account in the IRIS system with which to log in.

Authorized: Authorizations for functions in the dispatch system can be assigned for each user, according to the [https://en.wikipedia.org/wiki/Role-based_access_control RBAC system]

In addition, the IRIS system can manage multiple HVS32 systems simultaneously.

Example:

You use both a test and a production system. Using a simple identifier in the request to IRIS, the request is forwarded to the respective system.

You use different HVS32 installations for multiple sites. However: All HVS32 installations must then be located in the same internal company network.

== Challenges ==
Every new software naturally comes with new challenges and requirements for the system.

We would like to point out at this point that the introduction of a security-relevant application such as IRIS can also bring with it various challenges and the security of the overall system must also be regularly checked from all sides.

We have described further details on the requirements for an installation on our [[IRIS System requirements|IRIS system requirements]] page.

In addition, however, these security requirements also make ERP system connectivity more complex. Additional challenges arise for the ERP system, which must also implement these requirements at least as a client of the shipping system.

Therefore, please also schedule a meeting with your ERP system vendor to discuss these requirements. These include:

* Only possible with our latest [https://interface.heidler-strichcode.de/ REST interface]
* Requests only via an HTTPS connection
* Authentication using [[wikipedia:OAuth|OAuth2]] (Authorization Code / Client Credentials)

IRIS General description

2023-12-07T07:59:17Z

Sbaumbach: /* Challenges */

[[de:IRIS Allgemeine Beschreibung]]
[[IRIS cloud system|IRIS]] enables you to securely publish functions of the HVS32 dispatch system into the public internet (cloud capability).

== Issues with cloud systems ==
In principle, the HVS32 can be operated in cloud environments without hesitation, provided that the connection from the upstream system (ERP or WMS, hereinafter referred to as just ERP for simplicity) to the HVS32 is in a shared, secure, internal network.
[[Datei:IRIS internal network.png|alternativtext=|zentriert|rahmenlos|717x717px]]
Problems arise, however, when a connection is to take place across networks:
[[Datei:IRIS Problem across networks.png|alternativtext=|zentriert|rahmenlos|702x702px]]
Then this connection between two networks must be secured.

Secured means: Both the connection must be encrypted and each incoming connection must be authenticated and authorized.

There are two possibilities for this. The bridging of the networks by means of VPN or the secured publication of the HVS32 functions to the Internet with IRIS, a software developed by Heidler Strichcode.

== VPN vs IRIS ==
There is no 100% perfect solution for securing the network bridge. Mostly you have to choose a compromise depending on the case.

Here we will list the common advantages and disadvantages of a VPN connection compared to IRIS to help you decide.

{| class="wikitable"
|+
!VPN
!IRIS
|-
|'''+''' Simple setup
|'''+''' Accessible from the internet
|-
|'''+''' No further safety concerns
|'''+''' Accessible for multiple ERP systems simultaneously
|-
|'''+''' Only minor change effort for existing systems
|'''+''' Also accessible from [https://en.wikipedia.org/wiki/Software_as_a_Service SaaS] ERP systems
|-
|'''-''' Only possible with self-hosted (installed) ERP system
[https://en.wikipedia.org/wiki/Software_as_a_Service SaaS] based ERP systems are not possible.
|'''+''' Developed according to the latest safety standards
|-
|'''-''' HVS32 is only accessible within these 2 networks
The VPN connection becomes mandatory for every client
|'''+''' Future features possible, e.g. information in web interface (in planning)
|-
|'''-''' Difficult scalability
Multiple ERP systems only with extension of VPN connection
|'''-''' Complex setup of all security-related technologies
|-
|
|'''-''' Higher technical requirements for clients (ERP systems)
|-
|
|'''-''' Regular (security) updates required
|}

== IRIS in the cloud environment ==
If you decided to use IRIS, the IRIS system would integrate with your internal corporate or cloud network as follows:
[[Datei:IRIS in the network.png|alternativtext=|zentriert|rahmenlos|694x694px]]
All requests to IRIS are encrypted, authenticated, and authorized.

Encrypted: Encryption is possible via HTTPS using TLSv1.2 or TLSv1.3 (if supported by the client).

Authenticated: Each user is given a personal account in the IRIS system with which to log in.

Authorized: Authorizations for functions in the dispatch system can be assigned for each user, according to the [https://en.wikipedia.org/wiki/Role-based_access_control RBAC system]

In addition, the IRIS system can manage multiple HVS32 systems simultaneously.

Example:

You use both a test and a production system. Using a simple identifier in the request to IRIS, the request is forwarded to the respective system.

You use different HVS32 installations for multiple sites. However: All HVS32 installations must then be located in the same internal company network.

== Challenges ==
Every new software naturally comes with new challenges and requirements for the system.

We would like to point out at this point that the introduction of a security-relevant application such as IRIS can also bring with it various challenges and the security of the overall system must also be regularly checked from all sides.

We have described further details on the requirements for an installation on our [[Index.php?title=IRIS System requirements|IRIS system requirements]] page.

In addition, however, these security requirements also make ERP system connectivity more complex. Additional challenges arise for the ERP system, which must also implement these requirements at least as a client of the shipping system.

Therefore, please also schedule a meeting with your ERP system vendor to discuss these requirements. These include:

* Only possible with our latest [https://interface.heidler-strichcode.de/ REST interface]
* Requests only via an HTTPS connection
* Authentication using [[wikipedia:OAuth|OAuth2]] (Authorization Code / Client Credentials)

IRIS Allgemeine Beschreibung

2023-12-07T07:57:51Z

Sbaumbach: /* Herausforderungen */

[[en:IRIS General description]]
[[IRIS Cloudsystem|IRIS]] ermöglicht das sichere Veröffentlichen von Funktionen des HVS32 Versandsystems in das öffentliche Internet (Cloud-Fähigkeit).

== Problematik bei Cloud-Systemen ==
Grundsätzlich kann das HVS32 ohne Bedenken in Cloud-Umgebungen betrieben werden, sofern die Verbindung vom Vorsystem (ERP bzw. WMS, nachfolgend der Einfachheit halber nur ERP genannt) zum HVS32 in einem gemeinsamen, gesicherten, internen Netzwerk ist.

[[Datei:IRIS internes Netzwerk.png|zentriert|rahmenlos|717x717px]]Probleme entstehen allerdings, wenn eine Verbindung Netzwerk-übergreifend stattfinden soll.:
[[Datei:IRIS Problem Netzwerkübergreifend.png|zentriert|rahmenlos|702x702px]]

Dann muss diese Verbindung zwischen zwei Netzwerken abgesichert werden.

Abgesichert heißt: Sowohl die Verbindung muss verschlüsselt werden als auch jede eingehende Verbindung muss authentifiziert und autorisiert werden.

Hierfür gibt es zwei Möglichkeiten. Die Überbrückung der Netzwerke mittels VPN oder die abgesicherte Veröffentlichung der HVS32-Funktionen in das Internet mit IRIS, einer von Heidler Strichcode entwickelten Software.

== VPN vs IRIS ==
Zur Absicherung der Netzwerk-Brücke gibt es keine zu 100% perfekte Lösung. Meist muss man sich für einen Kompromiss je nach Fall entscheiden.

Hier sollen die gängigen Vorteile und Nachteile einer VPN Verbindung im Vergleich zu IRIS aufgelistet werden, um Ihnen die Entscheidung zu erleichtern.
{| class="wikitable"
|+
!VPN
!IRIS
|-
|'''+''' Einfache Einrichtung
|'''+''' Aus dem Internet erreichbar
|-
|'''+''' Keine weiteren Sicherheitsbedenken
|'''+''' Für mehrere ERP Systeme gleichzeitig erreichbar
|-
|'''+''' Für Bestandssysteme nur geringer Änderungsaufwand
|'''+''' Auch von [https://de.wikipedia.org/wiki/Software_as_a_Service SaaS] ERP Systemen erreichbar
|-
|'''-''' Nur mit selbst gehosteten (installierten) ERP System möglich.
[https://de.wikipedia.org/wiki/Software_as_a_Service SaaS] basierte ERP Systeme sind nicht möglich.
|'''+''' Entwickelt nach modernsten Sicherheitsstandards
|-
|'''-''' HVS32 ist nur innerhalb dieser 2 Netzwerke erreichbar
Die VPN Verbindung wird zur Pflicht für jeden Client
|'''+''' Zukünftige Features möglich, z.B. Auskunft in Weboberfläche (in Planung)
|-
|'''-''' Erschwerte Skalierbarkeit
Mehrere ERP-Systeme nur mit Erweiterung der VPN-Verbindung
|'''-''' Komplexe Einrichtung aller Sicherheits-relevanten Technologien
|-
|
|'''-''' Höhere technische Anforderungen an Clients (ERP-Systeme)
|-
|
|'''-''' Regelmäßige (Sicherheits-)Updates erforderlich
|}

== IRIS in der Cloud-Umgebung ==
Sollten Sie sich für IRIS entschieden haben, so würde sich das IRIS System in Ihr internes Firmen- oder Cloud-Netzwerk wie folgt einbinden:
[[Datei:IRIS im Netzwerk.png|zentriert|rahmenlos|694x694px]]
Alle Anfragen an IRIS werden verschlüsselt, authentifiziert und autorisiert.

Verschlüsselt: Die Verschlüsselung ist mittels HTTPS unter Verwendung von TLSv1.2 oder TLSv1.3 (sofern vom Client unterstützt) möglich.

Authentifiziert: Jeder Benutzer erhält einen persönlichen Account im IRIS-System mit dem er sich einloggen kann.

Autorisiert: Für jeden Benutzer können Berechtigungen für Funktionen im Versandsystem vergeben werden, nach dem [https://de.wikipedia.org/wiki/Role_Based_Access_Control RBAC-System]

Zusätzlich kann das IRIS-System mehrere HVS32-Systeme gleichzeitig verwalten.

Beispiel:

Sie verwenden sowohl ein Test- als auch ein Produktivsystem. Über eine simple Kennung in der Anfrage an IRIS wird die Anfrage an das jeweilige System weitergeleitet.

Sie verwenden bei mehreren Standorten unterschiedliche HVS32-Installationen. Allerdings: Alle HVS32-Installationen müssen sich dann im gleichen internen Firmennetzwerk befinden.

== Herausforderungen ==
Jede neue Software kommt natürlich auch mit neuen Herausforderungen und Anforderungen an das System.

Wir möchten an dieser Stelle darauf hinweisen, dass die Einführung einer Sicherheits-relevanten Anwendung wie IRIS auch diverse Herausforderungen mit sich bringen kann und auch die Sicherheit des Gesamtsystems regelmäßig von allen Seiten geprüft werden muss.

Wir haben auf unserer Seite [[IRIS Systemvoraussetzungen]] weitere Details zu den Anforderungen an eine Installation beschrieben.

Zusätzlich wird aber auch die Anbindung von ERP-Systemen durch diese Sicherheitsanforderungen komplexer. Es entstehen zusätzliche Herausforderungen für das ERP-System, welches diese Anforderungen zumindest als Client vom Versandsystem mit umsetzen muss.

Bitte planen Sie deshalb auch ein Gespräch mit Ihrem ERP-System-Hersteller, um diese Anforderungen zu besprechen. Hierzu zählen u.a.:

* Nur mit unserer neuesten [https://interface.heidler-strichcode.de/ REST-Schnittstelle] möglich
* Anfragen nur über eine HTTPS-Verbindung
* Authentifizierung mit [https://de.wikipedia.org/wiki/OAuth OAuth2] (Authorization Code / Client Credentials)

IRIS System requirements

2023-11-16T11:09:13Z

Sbaumbach: /* Option 1: Docker (recommended) */

[[de:IRIS_Systemvoraussetzungen]]
Here you can find the hardware and software requirements to run [[IRIS_cloud_system|IRIS]].

Keep in mind that the requirements are not final yet.

===Hardware requirements===

==== At least ====
*1 core
*1 GB RAM
*2 GB free memory on a SSD
*internet connection
**public / static IP-address
**assigned and public DNS-entry
**at least 5 Mbit/s Upload

==== Mediocre capacity (up to 1.000 packages per hour) ====
*2 cores
*2 GB RAM
*10 GB free memory on a SSD

=== Software- and other requirements ===

==== General ====
General requirements, regardless of the installation method.

* SMTP-Account (authentification with OAUTH2 is possible)
* public address / (Sub-)Domain
** a separate domain or subdomain must exist
** example: iris.firmenname.de or hvscloud.firmenname.de
** not possible: firmenname.de/iris
* Standard HTTP / HTTPS Ports: 80, 443
* certificate for the HTTPS Server
** from public certification body
** self-signed certificates for the public HTTPS Server are not possible

==== Option 1: Docker ====
Additional information, when IRIS is operated by a Docker-Container.

* Docker environment
* willingness, to regulary update the Container.

==== Option 2: Installation on your own operating system ====
Additional requirements, when the IRIS services are installed on an operating system.

* Reverse Proxy (for example IIS with ARR or nginx), configured with the Port and certificate from above
* willingness to update several services (at the moment 2) regularly
* own certification authority to create HTTPS certificates for our services (not to be confused with a public HTTPS Server)
* MariaDB
** Databases:
*** iris_common
*** iris_account
*** iris_shipping
*** [further Databases possible at extension of IRIS]
** database accounts
*** the User should be able to adjust the database structure and also the records.
*** for better security, every database should be provided with their own user.

IRIS Systemvoraussetzungen

2023-11-16T11:08:55Z

Sbaumbach: /* Option 1: Docker (empfohlen) */

[[en:IRIS System requirements]]
Hier finden Sie die Hardware- und Software-Voraussetzungen für den Betrieb von [[IRIS Cloudsystem|IRIS]].

Bitte beachten Sie, dass die Voraussetzungen noch nicht final sind.

===Hardwarevoraussetzungen===

==== Mindestens ====
*1 Kern
*1 GB RAM
*2 GB freier Speicherplatz auf einer SSD
*Internetverbindung
**Öffentliche / statische IP-Adresse
**Zugewiesener öffentlicher DNS-Eintrag
**mind.5 Mbit/s Upload

==== Mäßige Auslastung (bis ca. 1.000 Pakete pro Stunde) ====
*2 Kerne
*2 GB RAM
*10 GB freier Speicherplatz auf einer SSD

=== Software- und sonstige Voraussetzungen ===

==== Allgemein ====
Allgemeine Anforderungen, unabhängig von der Installationsmethode.

* SMTP-Account (Authentifizierung mit OAuth2 ist möglich)
* Öffentliche Adresse / (Sub-)Domain
** Es muss eine separate Domain oder Subdomain für iris existieren
** Beispiel: iris.firmenname.de oder hvscloud.firmenname.de
** Nicht möglich: firmenname.de/iris
* Standard HTTP / HTTPS Ports: 80, 443
* Zertifikat für den HTTPS Server
** Von öffentlicher Zertifizierungsstelle
** Selbst signierte Zertifikate sind für den öffentlichen HTTPS-Server nicht möglich

==== Option 1: Docker ====
Zusätzliche Anforderungen, wenn IRIS über einen Docker-Container betrieben wird.

* Docker Umgebung
* Bereitschaft, den Container regelmäßig zu aktualisieren

==== Option 2: Installation auf eigenem Betriebssystem ====
Zusätzliche Anforderungen, wenn die IRIS-Dienste auf selbst auf einem Betriebssystem installiert werden.

* Reverse Proxy (z.B. IIS mit ARR oder nginx), konfiguriert mit o.g. Port und Zertifikat
* Bereitschaft, mehrere Dienste (momentan 2) regelmäßig zu aktualisieren
* Eigene Zertifizierungsstelle zum Erstellen von HTTPS-Zertifikaten für interne Dienste (nicht zu verwechseln mit öffentlichem HTTPS-Server)
* MariaDB
** Datenbanken:
*** iris_common
*** iris_account
*** iris_shipping
*** [weitere Datenbanken möglich bei Erweiterung von IRIS]
** DB-Accounts
*** Der User muss die DB-Struktur und auch die Datensätze anpassen können
*** Zur besseren Sicherheit sollte jede Datenbank mit einem eigenen User versehen werden

CVE-2023-21930

2023-11-03T10:18:06Z

Sbaumbach: /* Affected Applications */

= Source =
https://nvd.nist.gov/vuln/detail/CVE-2023-21930

= Description of this CVE =
"This vulnerability applies to Java deployments, typically in clients running sandboxed Java Web Start applications or sandboxed Java applets, that load and run untrusted code (e.g., code that comes from the internet)"

= Affected Applications =
''affected version = From which version onwards there is a need for action.'' 
''fixed version = Minimum version where the security vulnerability is fixed or not affected anymore.'' 
''not affected = This application is not affected and therefore there is no need for action. 
''all versions = Every single version is affected. A need for action is required regardless of the version''

{| class="wikitable"
|-
! Application Name !! Affected Version !! Fixed Version
|-
| CarrierAPI || 2.7.0 || 3.0.64
|-
| ComManager || 1.2.10 or higher
| 1.2.14
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen''|| 3.8.14 or higher
| 3.8.24
|-
| FileConverter || - || -
|-
| FileMoveService || - || -
|-
| GLSBoxService || - || -
|-
| HFMS (Tarifwerk) || 1.7.0 || 1.8.16
|-
| HVS32AMAService || 1.3.5 or higher
| 1.3.7
|-
| HVS32DBArchivierung || 4.6.0 || 4.6.7
|-
| HVS32MonitoringService || 1.4.10 or higher
| 1.4.12
|-
| HVS32MonitoringServiceLight || 1.5.7 or higher
| 1.5.9
|-
| IRIS || 1.0.0 || 1.0.20
|-
| Leitcode || - || -
|-
| ScaleService || 2.2.0 || 2.2.5
|-
| SEM-Manager || 1.0.0 || 1.5.9
|-
| SEM-Web || 1.0.0 || 1.5.8
|-
| Verladefreigabe || 2.2.0 || 2.2.5
|-
| WatchLog || - || -
|}

Carrier API Fehlercodes

2023-10-16T08:12:46Z

Sbaumbach: /* Plugin Codes */

== Allgemeines ==
Fehlercodes in der Carrier API sind nach dem Schema <code>AAA-SSS-GG-L[Code]</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: <code>CAP-HEH-02-E00005</code>

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 <code>(Strg+F)</code> zunächst mit dem eigentlichen Code.

Falls Sie den Code nicht direkt finden können, ersetzen Sie bitte die Subgruppe z.B. "HEH" durch <code>XXX</code>. Aus dem obigen Beispiel: <code>CAP-XXX-02-E00005</code>. 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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).

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 [https://de.wikipedia.org/wiki/Man-in-the-Middle-Angriff 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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).

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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) ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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.

{| class="wikitable sortable"
|-
! 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
|-
| 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
|-
| 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)
|-
| 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
|-
| UPA || UPS Pickup (Abholung)
|-
| UPG || UPS GG (Gefahrgut PreAvis)
|-
| UPP || UPS Paperless Document
|-
| UPT || UPS Tarifierung
|-
| VNP || Venipak
|-
| WYF || Wayfair
|}

Carrier API Fehlercodes

2023-10-13T13:12:53Z

Sbaumbach: /* Plugin Codes */

== Allgemeines ==
Fehlercodes in der Carrier API sind nach dem Schema <code>AAA-SSS-GG-L[Code]</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: <code>CAP-HEH-02-E00005</code>

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 <code>(Strg+F)</code> zunächst mit dem eigentlichen Code.

Falls Sie den Code nicht direkt finden können, ersetzen Sie bitte die Subgruppe z.B. "HEH" durch <code>XXX</code>. Aus dem obigen Beispiel: <code>CAP-XXX-02-E00005</code>. 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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).

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 [https://de.wikipedia.org/wiki/Man-in-the-Middle-Angriff 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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).

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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) ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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.

{| class="wikitable sortable"
|-
! 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
|-
| 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
|-
| 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)
|-
|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)
|-
| 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
|-
| UPA || UPS Pickup (Abholung)
|-
| UPG || UPS GG (Gefahrgut PreAvis)
|-
| UPP || UPS Paperless Document
|-
| UPT || UPS Tarifierung
|-
| VNP || Venipak
|-
| WYF || Wayfair
|}

Carrier API Fehlercodes

2023-10-09T07:12:32Z

Sbaumbach: /* Plugin Codes */

== Allgemeines ==
Fehlercodes in der Carrier API sind nach dem Schema <code>AAA-SSS-GG-L[Code]</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: <code>CAP-HEH-02-E00005</code>

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 <code>(Strg+F)</code> zunächst mit dem eigentlichen Code.

Falls Sie den Code nicht direkt finden können, ersetzen Sie bitte die Subgruppe z.B. "HEH" durch <code>XXX</code>. Aus dem obigen Beispiel: <code>CAP-XXX-02-E00005</code>. 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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).

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 [https://de.wikipedia.org/wiki/Man-in-the-Middle-Angriff 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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).

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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) ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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.

{| class="wikitable sortable"
|-
! 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
|-
| 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
|-
| 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)
|-
|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)
|-
| 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
|-
| UPA || UPS Pickup (Abholung)
|-
| UPG || UPS GG (Gefahrgut PreAvis)
|-
| UPP || UPS Paperless Document
|-
| UPT || UPS Tarifierung
|-
| VNP || Venipak
|-
| WYF || Wayfair
|}

CVE-2023-21835 / CVE-2023-21843

2023-09-27T09:07:30Z

Sbaumbach: -> Englisch

= Source =
https://nvd.nist.gov/vuln/detail/CVE-2023-21835 
https://nvd.nist.gov/vuln/detail/CVE-2023-21843

= Description of this CVE =
"This vulnerability applies to Java deployments, typically in clients running sandboxed Java Web Start applications or sandboxed Java applets, that load and run untrusted code (e.g., code that comes from the internet) and rely on the Java sandbox for security. This vulnerability does not apply to Java deployments, typically in servers, that load and run only trusted code (e.g., code installed by an administrator)."

= Affected Applications =
''affected version = From which version onwards there is a need for action.'' 
''fixed version = Minimum version where the security vulnerability is fixed or not affected anymore.'' 
''not affected = This application is not affected and therefore there is no need for action. 
''all versions = Every single version is affected. A need for action is required regardless of the version''

{| class="wikitable"
|-
! Application Name !! Affected Version !! Fixed Version
|-
| CarrierAPI || 2.0 || 3.0.48
|-
| ComManager || not affected || not affected
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || 3.8.13 || 3.8.14
|-
| FileConverter || not affected || not affected
|-
| FileMoveService || not affected || not affected
|-
| GLSBoxService || not affected || not affected
|-
| HFMS (Tarifwerk) || 1.0 || 1.8.11
|-
| HVS32AMAService || 1.3.4 || 1.3.5
|-
| HVS32DBArchivierung || 1.0 || 4.6.6
|-
| HVS32MonitoringService || 1.4.9 || 1.4.10
|-
| HVS32MonitoringServiceLight || not affected || not affected
|-
| IRIS || 1.0 || 1.0.9
|-
| Leitcode || not affected || not affected
|-
| ScaleService || not affected || not affected
|-
| SEM-Manager || 1.0 || 1.5.7
|-
| SEM-Web || 1.0 || 1.5.7
|-
| Verladefreigabe || 1.0 || 2.2.3
|-
| WatchLog || not affected || not affected
|}

CVE-2022-40152

2023-09-27T08:47:17Z

Sbaumbach: -> Englisch

= Source =
https://nvd.nist.gov/vuln/detail/CVE-2022-40152

= Description of this CVE =
Through exploiting this security vulnerability a DOS (Denial of Service) attack may be possible on the system.

= Affected Applications =
''affected version = From which version onwards there is a need for action.'' 
''fixed version = Minimum version where the security vulnerability is fixed or not affected anymore.'' 
''not affected = This application is not affected and therefore there is no need for action. 
''all versions = Every single version is affected. A need for action is required regardless of the version''

{| class="wikitable"
|-
! Application Name !! Affected Version !! Fixed Version
|-
| CarrierAPI || 3.0.48 || 3.0.49
|-
| ComManager || 1.2.11 || 1.2.12
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || 3.8.15 || 3.8.16
|-
| FileConverter || not affected || not affected
|-
| FileMoveService || not affected || not affected
|-
| GLSBoxService || not affected || not affected
|-
| HFMS (Tarifwerk) || 1.8.12 || 1.8.13
|-
| HVS32AMAService || not affected || not affected
|-
| HVS32DBArchivierung || not affected || not affected
|-
| HVS32MonitoringService || not affected || not affected
|-
| HVS32MonitoringServiceLight || not affected || not affected
|-
| IRIS || 1.0.9 || 1.0.10
|-
| Leitcode || 3.3.6 || 3.3.7
|-
| ScaleService || 2.2.3 || 2.2.4
|-
| SEM-Manager || 1.5.6 || 1.5.7
|-
| SEM-Web || 1.5.6 || 1.5.7
|-
| Verladefreigabe || 2.2.3 || 2.2.4
|-
| WatchLog || 1.2.2 || 1.2.3
|}

CVE-2023-42503

2023-09-27T08:44:53Z

Sbaumbach: /* Affected Applications */

= Source =
https://nvd.nist.gov/vuln/detail/CVE-2023-42503

= Description of this CVE =
Through exploiting this security vulnerability a DOS (Denial of Service) attack may be possible on the system.

Exploiting this weakness only works if a .tar file is read. Currently none of our applications uses this functionality.

= Affected Applications =
''affected version = From which version onwards there is a need for action.'' 
''fixed version = Minimum version where the security vulnerability is fixed or not affected anymore.'' 
''not affected = This application is not affected and therefore there is no need for action. 
''all versions = Every single version is affected. A need for action is required regardless of the version''

{| class="wikitable"
|-
! Application Name !! Affected Version !! Fixed Version
|-
| CarrierAPI || not affected || not affected
|-
| ComManager || ||
|-
| DataGatewayServer V3 (DGS V3) ''all versions 2.x.x are excluded''|| 3.8.14 or higher
| 3.8.27
|-
| FileConverter || ||
|-
| FileMoveService || ||
|-
| GLSBoxService || ||
|-
| HFMS (Tarifwerk) || 1.8.9 or higher || 1.9.0
|-
| HVS32AMAService || 1.3.6 or higher
| 1.3.8
|-
| HVS32DBArchivierung || all versions || 4.6.8
|-
| HVS32MonitoringService || 1.4.11 or higher
| 1.4.13
|-
| HVS32MonitoringServiceLight || 1.5.8 or higher
| 1.5.10
|-
| IRIS || all versions || 1.1.2
|-
| Leitcode || ||
|-
| ScaleService || all versions || 2.2.6
|-
| SEM-Manager || all versions || 1.6.3
|-
| SEM-Web || all versions || 1.6.1
|-
| Verladefreigabe || all versions || 2.2.5
|-
| WatchLog || ||
|}

CVE-2023-21930

2023-09-27T08:44:41Z

Sbaumbach: /* Affected Applications */

= Source =
https://nvd.nist.gov/vuln/detail/CVE-2023-21930

= Description of this CVE =
"This vulnerability applies to Java deployments, typically in clients running sandboxed Java Web Start applications or sandboxed Java applets, that load and run untrusted code (e.g., code that comes from the internet)"

= Affected Applications =
''affected version = From which version onwards there is a need for action.'' 
''fixed version = Minimum version where the security vulnerability is fixed or not affected anymore.'' 
''not affected = This application is not affected and therefore there is no need for action. 
''all versions = Every single version is affected. A need for action is required regardless of the version''

{| class="wikitable"
|-
! Application Name !! Affected Version !! Fixed Version
|-
| CarrierAPI || - || -
|-
| ComManager || 1.2.10 or higher
| 1.2.14
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen''|| 3.8.14 or higher
| 3.8.24
|-
| FileConverter || - || -
|-
| FileMoveService || - || -
|-
| GLSBoxService || - || -
|-
| HFMS (Tarifwerk) || - || -
|-
| HVS32AMAService || 1.3.5 or higher
| 1.3.7
|-
| HVS32DBArchivierung || - || -
|-
| HVS32MonitoringService || 1.4.10 or higher
| 1.4.12
|-
| HVS32MonitoringServiceLight || 1.5.7 or higher
| 1.5.9
|-
| IRIS || - || -
|-
| Leitcode || - || -
|-
| ScaleService || - || -
|-
| SEM-Manager || - || -
|-
| SEM-Web || - || -
|-
| Verladefreigabe || - || -
|-
| WatchLog || - || -
|}

CVE-2023-21930

2023-09-27T08:44:03Z

Sbaumbach: -> Englisch

= Source =
https://nvd.nist.gov/vuln/detail/CVE-2023-21930

= Description of this CVE =
"This vulnerability applies to Java deployments, typically in clients running sandboxed Java Web Start applications or sandboxed Java applets, that load and run untrusted code (e.g., code that comes from the internet)"

= Affected Applications =
''affected version = From which version onwards there is a need for action.fixed version = Minimum version where the security vulnerability is fixed or not affected anymore.not affected = This application is not affected and therefore there is no need for action.all versions = Every single version is affected. A need for action is required regardless of the version''
{| class="wikitable"
|-
! Application Name !! Affected Version !! Fixed Version
|-
| CarrierAPI || - || -
|-
| ComManager || 1.2.10 or higher
| 1.2.14
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen''|| 3.8.14 or higher
| 3.8.24
|-
| FileConverter || - || -
|-
| FileMoveService || - || -
|-
| GLSBoxService || - || -
|-
| HFMS (Tarifwerk) || - || -
|-
| HVS32AMAService || 1.3.5 or higher
| 1.3.7
|-
| HVS32DBArchivierung || - || -
|-
| HVS32MonitoringService || 1.4.10 or higher
| 1.4.12
|-
| HVS32MonitoringServiceLight || 1.5.7 or higher
| 1.5.9
|-
| IRIS || - || -
|-
| Leitcode || - || -
|-
| ScaleService || - || -
|-
| SEM-Manager || - || -
|-
| SEM-Web || - || -
|-
| Verladefreigabe || - || -
|-
| WatchLog || - || -
|}

CVE-2023-42503

2023-09-27T08:42:28Z

Sbaumbach: /* Affected Applications */

= Source =
https://nvd.nist.gov/vuln/detail/CVE-2023-42503

= Description of this CVE =
Through exploiting this security vulnerability a DOS (Denial of Service) attack may be possible on the system.

Exploiting this weakness only works if a .tar file is read. Currently none of our applications uses this functionality.

= Affected Applications =
''affected version = From which version onwards there is a need for action.'' 
''fixed version = Minimum version where the security vulnerability is fixed or not affected anymore.'' 
''not affected = This application is not affected and therefore there is no need for action. 
all versions = Every single version is affected. A need for action is required regardless of the version''

{| class="wikitable"
|-
! Application Name !! Affected Version !! Fixed Version
|-
| CarrierAPI || not affected || not affected
|-
| ComManager || ||
|-
| DataGatewayServer V3 (DGS V3) ''all versions 2.x.x are excluded''|| 3.8.14 or higher
| 3.8.27
|-
| FileConverter || ||
|-
| FileMoveService || ||
|-
| GLSBoxService || ||
|-
| HFMS (Tarifwerk) || 1.8.9 or higher || 1.9.0
|-
| HVS32AMAService || 1.3.6 or higher
| 1.3.8
|-
| HVS32DBArchivierung || all versions || 4.6.8
|-
| HVS32MonitoringService || 1.4.11 or higher
| 1.4.13
|-
| HVS32MonitoringServiceLight || 1.5.8 or higher
| 1.5.10
|-
| IRIS || all versions || 1.1.2
|-
| Leitcode || ||
|-
| ScaleService || all versions || 2.2.6
|-
| SEM-Manager || all versions || 1.6.3
|-
| SEM-Web || all versions || 1.6.1
|-
| Verladefreigabe || all versions || 2.2.5
|-
| WatchLog || ||
|}

CVE-2023-42503

2023-09-27T08:41:54Z

Sbaumbach: -> Englisch

= Source =
https://nvd.nist.gov/vuln/detail/CVE-2023-42503

= Description of this CVE =
Through exploiting this security vulnerability a DOS (Denial of Service) attack may be possible on the system.

Exploiting this weakness only works if a .tar file is read. Currently none of our applications uses this functionality.

= Affected Applications =
''affected version = From which version onwards there is a need for action.'' 
''fixed version = Minimum version where the security vulnerability is fixed or not affected anymore.'' 
''not affected = This application is not affected and therefore there is no need for action. 
all versions = Every single version is affected. A need for action is required regardless of the version''

 
{| class="wikitable"
|-
! Application Name !! Affected Version !! Fixed Version
|-
| CarrierAPI || not affected || not affected
|-
| ComManager || ||
|-
| DataGatewayServer V3 (DGS V3) ''all versions 2.x.x are excluded''|| 3.8.14 or higher
| 3.8.27
|-
| FileConverter || ||
|-
| FileMoveService || ||
|-
| GLSBoxService || ||
|-
| HFMS (Tarifwerk) || 1.8.9 or higher || 1.9.0
|-
| HVS32AMAService || 1.3.6 or higher
| 1.3.8
|-
| HVS32DBArchivierung || all versions || 4.6.8
|-
| HVS32MonitoringService || 1.4.11 or higher
| 1.4.13
|-
| HVS32MonitoringServiceLight || 1.5.8 or higher
| 1.5.10
|-
| IRIS || all versions || 1.1.2
|-
| Leitcode || ||
|-
| ScaleService || all versions || 2.2.6
|-
| SEM-Manager || all versions || 1.6.3
|-
| SEM-Web || all versions || 1.6.1
|-
| Verladefreigabe || all versions || 2.2.5
|-
| WatchLog || ||
|}

Security Vulnerabilities / CVE

2023-09-27T08:35:28Z

Sbaumbach: + Link zur Deutschen Seite

[[de:Sicherheitslücken / CVE]]
On this page you will see an overview of all security related vulnerabilites / [https://en.wikipedia.org/wiki/Common_Vulnerabilities_and_Exposures CVEs] that occured either directly in our applications or through the use of third party libraries that are in use by our applications.

We also offer an admin newsletter (in German) where we will notifiy you new of critical securtiy vulnerabilities via email. 
You can register for our admin newsletter here: https://heidler-strichcode.de/kontakt/ 
(''The contact form for the newsletter is only visible if "Marketing" cookies are enabled.'')

= How do I update applications? =
On our page [[Aktualisierung von Erweiterungsmodulen]] you will learn everything you need to know before and during the update of the application. 
Please read this carefully. 
If you have any questions or are unsure, you can always contact our support via: [mailto:support@heidler-strichcode.de support@heidler-strichcode.de]

= Security classification =
'''high''' = The vulnerability could be exploited. We urgently recommend to update the affected applications as soon as possible. 
'''medium''' = The possiblity that this vulnerability can be exploited cannot be ruled out. The affected functionality is not directly used, however it may be in use by other third party components. We recommend to update the afftected applications as soon as it is convenient. 
'''low''' = The vulnerability cannot be exploited. We still recommend to update the application at some point.

= Overview of all security vulnerabilites / CVEs =
''ordered newest to oldest''
{| class="wikitable"
|-
! Date !! Classification !! Details
|-
| 2023-09-15 || low || [[CVE-2023-42503]]
|-
| 2023-04-18 || low || [[CVE-2023-21930]]
|-
| 2023-02-10 || medium || [[CVE-2022-40152]]
|-
| 2023-02-02 || low || [[CVE-2023-21835 / CVE-2023-21843]]
|}

Sicherheitslücken / CVE

2023-09-27T08:33:41Z

Sbaumbach: + Link zur Englischen Seite

[[en:Security Vulnerabilities / CVE]]
Hier erhalten Sie eine Übersicht der Sicherheitslücken, welche in unseren Applikationen durch Verwendung von Drittanbieterkomponenten aufgetreten sind. 
Möchten Sie per E-Mail über auftretende Sicherheitslücken benachrichtigt werden? Dann registrieren Sie sich zu unserem Admin-Newsletter unter https://heidler-strichcode.de/kontakt/ 
(''Damit das Kontaktformular für den Newsletter sichtbar ist, muss in der Datenschutzeinstellung die Checkbox "Marketing" aktiv sein.'')

= Wie aktualisiere ich die Applikationen =
Alles was Sie vor- und während der Aktualisierung unserer Applikationen beachten müssen, können Sie aus unserer Anleitung unter [[Aktualisierung von Erweiterungsmodulen]] entnehmen. Bitte lesen Sie sich diese Aufmerksam durch. 
Sollten Sie Rückfragen bezüglich der Aktualisierung haben oder sich unsicher sind, können Sie sich für weitere Unterstützung an unseren Support ([mailto:support@heidler-strichcode.de support@heidler-strichcode.de]) wenden.

= Sicherheitsstufen =
'''hoch''' = Die Sicherheitslücke könnte ausgenutzt werden. Es wird dringend empfohlen, die betroffenen Applikationen so zeitnah wie möglich zu aktualisieren, um eine Kompromittierung der Daten zu verhindern. 
'''mittel''' = Eine Ausnutzung der Sicherheitslücke kann nicht ausgeschlossen werden. Die betroffenen Funktionalitäten sind nicht direkt im Einsatz, jedoch kann nicht garantiert werden, dass diese durch die Nutzung von Drittanbieterkomponenten nicht in Verwendung sind. Die Aktualisierung sollte zu einem geeignet Zeitpunkt eingeplant werden. 
'''niedrig''' = Eine Ausnutzung der Sicherheitslücke ist ausgeschlossen. Eine Aktualisierung der Applikationen wird weiterhin empfohlen.

= Übersicht Sicherheitslücken / CVE =
''aktuellster CVE steht ganz oben''
{| class="wikitable"
|-
! Datum !! Sicherheitsstufe !! CVE
|-
| 15.09.2023 || niedrig || [[CVE-2023-42503]]
|-
| 18.04.2023 || niedrig || [[CVE-2023-21930]]
|-
| 10.02.2023 || mittel || [[CVE-2022-40152]]
|-
| 02.02.2023 || niedrig || [[CVE-2023-21835 / CVE-2023-21843]]
|}

Sicherheitslücken / CVE

2023-09-27T08:32:37Z

Sbaumbach: Änderung 5296 von Sbaumbach (Diskussion) rückgängig gemacht.

Hier erhalten Sie eine Übersicht der Sicherheitslücken, welche in unseren Applikationen durch Verwendung von Drittanbieterkomponenten aufgetreten sind. 
Möchten Sie per E-Mail über auftretende Sicherheitslücken benachrichtigt werden? Dann registrieren Sie sich zu unserem Admin-Newsletter unter https://heidler-strichcode.de/kontakt/ 
(''Damit das Kontaktformular für den Newsletter sichtbar ist, muss in der Datenschutzeinstellung die Checkbox "Marketing" aktiv sein.'')

= Wie aktualisiere ich die Applikationen =
Alles was Sie vor- und während der Aktualisierung unserer Applikationen beachten müssen, können Sie aus unserer Anleitung unter [[Aktualisierung von Erweiterungsmodulen]] entnehmen. Bitte lesen Sie sich diese Aufmerksam durch. 
Sollten Sie Rückfragen bezüglich der Aktualisierung haben oder sich unsicher sind, können Sie sich für weitere Unterstützung an unseren Support ([mailto:support@heidler-strichcode.de support@heidler-strichcode.de]) wenden.

= Sicherheitsstufen =
'''hoch''' = Die Sicherheitslücke könnte ausgenutzt werden. Es wird dringend empfohlen, die betroffenen Applikationen so zeitnah wie möglich zu aktualisieren, um eine Kompromittierung der Daten zu verhindern. 
'''mittel''' = Eine Ausnutzung der Sicherheitslücke kann nicht ausgeschlossen werden. Die betroffenen Funktionalitäten sind nicht direkt im Einsatz, jedoch kann nicht garantiert werden, dass diese durch die Nutzung von Drittanbieterkomponenten nicht in Verwendung sind. Die Aktualisierung sollte zu einem geeignet Zeitpunkt eingeplant werden. 
'''niedrig''' = Eine Ausnutzung der Sicherheitslücke ist ausgeschlossen. Eine Aktualisierung der Applikationen wird weiterhin empfohlen.

= Übersicht Sicherheitslücken / CVE =
''aktuellster CVE steht ganz oben''
{| class="wikitable"
|-
! Datum !! Sicherheitsstufe !! CVE
|-
| 15.09.2023 || niedrig || [[CVE-2023-42503]]
|-
| 18.04.2023 || niedrig || [[CVE-2023-21930]]
|-
| 10.02.2023 || mittel || [[CVE-2022-40152]]
|-
| 02.02.2023 || niedrig || [[CVE-2023-21835 / CVE-2023-21843]]
|}

Security Vulnerabilities / CVE

2023-09-27T08:31:18Z

Sbaumbach: Die Seite wurde neu angelegt: „On this page you will see an overview of all security related vulnerabilites / [https://en.wikipedia.org/wiki/Common_Vulnerabilities_and_Exposures CVEs] that o…“

On this page you will see an overview of all security related vulnerabilites / [https://en.wikipedia.org/wiki/Common_Vulnerabilities_and_Exposures CVEs] that occured either directly in our applications or through the use of third party libraries that are in use by our applications.

We also offer an admin newsletter (in German) where we will notifiy you new of critical securtiy vulnerabilities via email. 
You can register for our admin newsletter here: https://heidler-strichcode.de/kontakt/ 
(''The contact form for the newsletter is only visible if "Marketing" cookies are enabled.'')

= How do I update applications? =
On our page [[Aktualisierung von Erweiterungsmodulen]] you will learn everything you need to know before and during the update of the application. 
Please read this carefully. 
If you have any questions or are unsure, you can always contact our support via: [mailto:support@heidler-strichcode.de support@heidler-strichcode.de]

= Security classification =
'''high''' = The vulnerability could be exploited. We urgently recommend to update the affected applications as soon as possible. 
'''medium''' = The possiblity that this vulnerability can be exploited cannot be ruled out. The affected functionality is not directly used, however it may be in use by other third party components. We recommend to update the afftected applications as soon as it is convenient. 
'''low''' = The vulnerability cannot be exploited. We still recommend to update the application at some point.

= Overview of all security vulnerabilites / CVEs =
''ordered newest to oldest''
{| class="wikitable"
|-
! Date !! Classification !! Details
|-
| 2023-09-15 || low || [[CVE-2023-42503]]
|-
| 2023-04-18 || low || [[CVE-2023-21930]]
|-
| 2023-02-10 || medium || [[CVE-2022-40152]]
|-
| 2023-02-02 || low || [[CVE-2023-21835 / CVE-2023-21843]]
|}

Sicherheitslücken / CVE

2023-09-26T15:19:49Z

Sbaumbach: -> Englisch

CVE-2023-21835 / CVE-2023-21843

2023-09-26T13:45:05Z

Sbaumbach: /* Betroffene Applikationen */

= Quelle =
https://nvd.nist.gov/vuln/detail/CVE-2023-21835 
https://nvd.nist.gov/vuln/detail/CVE-2023-21843

= Beschreibung vom CVE =
"This vulnerability applies to Java deployments, typically in clients running sandboxed Java Web Start applications or sandboxed Java applets, that load and run untrusted code (e.g., code that comes from the internet) and rely on the Java sandbox for security. This vulnerability does not apply to Java deployments, typically in servers, that load and run only trusted code (e.g., code installed by an administrator)."

= Betroffene Applikationen =
''application name = Name der Applikation.'' 
''affected version = Für welche Versionssände Handlungsbedarf besteht.'' 
''fixed version = Mindestversionsstand, in welcher die Sicherheitslücke behoben / nicht betroffen ist.'' 
''not affected = Diese Applikation ist von der Sicherheitslücke nicht betroffen. Es besteht kein Handlungsbedarf.'' 
{| class="wikitable"
|-
! application name !! affected version !! fixed version
|-
| CarrierAPI || 2.0 || 3.0.48
|-
| ComManager || not affected || not affected
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || 3.8.13 || 3.8.14
|-
| FileConverter || not affected || not affected
|-
| FileMoveService || not affected || not affected
|-
| GLSBoxService || not affected || not affected
|-
| HFMS (Tarifwerk) || 1.0 || 1.8.11
|-
| HVS32AMAService || 1.3.4 || 1.3.5
|-
| HVS32DBArchivierung || 1.0 || 4.6.6
|-
| HVS32MonitoringService || 1.4.9 || 1.4.10
|-
| HVS32MonitoringServiceLight || not affected || not affected
|-
| IRIS || 1.0 || 1.0.9
|-
| Leitcode || not affected || not affected
|-
| ScaleService || not affected || not affected
|-
| SEM-Manager || 1.0 || 1.5.7
|-
| SEM-Web || 1.0 || 1.5.7
|-
| Verladefreigabe || 1.0 || 2.2.3
|-
| WatchLog || not affected || not affected
|}

CVE-2023-21835 / CVE-2023-21843

2023-09-26T11:50:40Z

Sbaumbach: /* Betroffene Applikationen */

= Quelle =
https://nvd.nist.gov/vuln/detail/CVE-2023-21835 
https://nvd.nist.gov/vuln/detail/CVE-2023-21843

= Beschreibung vom CVE =
"This vulnerability applies to Java deployments, typically in clients running sandboxed Java Web Start applications or sandboxed Java applets, that load and run untrusted code (e.g., code that comes from the internet) and rely on the Java sandbox for security. This vulnerability does not apply to Java deployments, typically in servers, that load and run only trusted code (e.g., code installed by an administrator)."

= Betroffene Applikationen =
''application name = Name der Applikation.'' 
''affected version = Für welche Versionssände Handlungsbedarf besteht.'' 
''fixed version = Mindestversionsstand, in welcher die Sicherheitslücke behoben / nicht betroffen ist.'' 
''not affected = Diese Applikation ist von der Sicherheitslücke nicht betroffen. Es besteht kein Handlungsbedarf.'' 
{| class="wikitable"
|-
! application name !! affected version !! fixed version
|-
| CarrierAPI || 2.0 || 3.0.48
|-
| ComManager || not affected || not affected
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || 3.8.13 || 3.8.14
|-
| FileConverter || not affected || not affected
|-
| FileMoveService || not affected || not affected
|-
| GLSBoxService || not affected || not affected
|-
| HFMS (Tarifwerk) || 1.0 || 1.8.11
|-
| HVS32AMAService || 1.3.4 || 1.3.5
|-
| HVS32DBArchivierung || 1.0 || 4.6.6
|-
| HVS32MonitoringService || 1.4.9 || 1.4.10
|-
| HVS32MonitoringServiceLight || not affected || not affected
|-
| IRIS || 1.0 || 1.0.9
|-
| Leitcode || not affected || not affected
|-
| ScaleService || not affected || not affected
|-
| SEM-Manager || 1.0 || 1.5.7
|-
| SEM-Web || - || 1.5.7
|-
| Verladefreigabe || 1.0 || 2.2.3
|-
| WatchLog || not affected || not affected
|}

CVE-2023-21835 / CVE-2023-21843

2023-09-26T11:49:45Z

Sbaumbach: /* Betroffene Applikationen */

= Quelle =
https://nvd.nist.gov/vuln/detail/CVE-2023-21835 
https://nvd.nist.gov/vuln/detail/CVE-2023-21843

= Beschreibung vom CVE =
"This vulnerability applies to Java deployments, typically in clients running sandboxed Java Web Start applications or sandboxed Java applets, that load and run untrusted code (e.g., code that comes from the internet) and rely on the Java sandbox for security. This vulnerability does not apply to Java deployments, typically in servers, that load and run only trusted code (e.g., code installed by an administrator)."

= Betroffene Applikationen =
''application name = Name der Applikation.'' 
''affected version = Für welche Versionssände Handlungsbedarf besteht.'' 
''fixed version = Mindestversionsstand, in welcher die Sicherheitslücke behoben / nicht betroffen ist.'' 
''not affected = Diese Applikation ist von der Sicherheitslücke nicht betroffen. Es besteht kein Handlungsbedarf.'' 
{| class="wikitable"
|-
! application name !! affected version !! fixed version
|-
| CarrierAPI || - || 3.0.48
|-
| ComManager || not affected || not affected
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || 3.8.13 || 3.8.14
|-
| FileConverter || not affected || not affected
|-
| FileMoveService || not affected || not affected
|-
| GLSBoxService || not affected || not affected
|-
| HFMS (Tarifwerk) || - || 1.8.11
|-
| HVS32AMAService || 1.3.4 || 1.3.5
|-
| HVS32DBArchivierung || - || 4.6.6
|-
| HVS32MonitoringService || 1.4.9 || 1.4.10
|-
| HVS32MonitoringServiceLight || not affected || not affected
|-
| IRIS || - || 1.0.9
|-
| Leitcode || not affected || not affected
|-
| ScaleService || not affected || not affected
|-
| SEM-Manager || - || 1.5.7
|-
| SEM-Web || - || 1.5.7
|-
| Verladefreigabe || - || 2.2.3
|-
| WatchLog || not affected || not affected
|}

CVE-2023-42503

2023-09-26T11:34:58Z

Sbaumbach: /* Betroffene Applikationen */

= Quelle =
https://nvd.nist.gov/vuln/detail/CVE-2023-42503

= Beschreibung vom CVE =
Durch die Ausnutzung der Sicherheitslücke wäre eine DOS (Denial of Service) Attacke auf das System möglich.

Das Ausnutzen der Sicherheitslücke geht nur über das Lesen einer .tar Datei. Keine unserer Applikationen nutzt momentan diese Funktion.

= Betroffene Applikationen =
''application name = Name der Applikation.'' 
''affected version = Für welche Versionssände Handlungsbedarf besteht.'' 
''fixed version = Mindestversionsstand, in welcher die Sicherheitslücke behoben / nicht betroffen ist.'' 
''not affected = Diese Applikation ist von der Sicherheitslücke nicht betroffen. Es besteht kein Handlungsbedarf.'' 
{| class="wikitable"
|-
! application name !! affected version !! fixed version
|-
| CarrierAPI || not affected || not affected
|-
| ComManager || ||
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || 3.8.14 || 3.8.27
|-
| FileConverter || ||
|-
| FileMoveService || ||
|-
| GLSBoxService || ||
|-
| HFMS (Tarifwerk) || >= 1.8.9 || 1.9.0
|-
| HVS32AMAService || ||
|-
| HVS32DBArchivierung || all versions || 4.6.8
|-
| HVS32MonitoringService || ||
|-
| HVS32MonitoringServiceLight || ||
|-
| IRIS || all versions || 1.1.2
|-
| Leitcode || ||
|-
| ScaleService || all versions || 2.2.6
|-
| SEM-Manager || all versions || 1.6.3
|-
| SEM-Web || all versions || 1.6.1
|-
| Verladefreigabe || all versions || 2.2.5
|-
| WatchLog || ||
|}

HFMS

2023-09-26T07:21:33Z

Sbaumbach: + Update des HFMS

{| style="width: 100%"
|-
| rowspan="2" style="vertical-align:top" | [[File:tw_logo.png|Tarifwerk-Konfigurator|link=Tarifwerk-Konfigurator]]
| style="width: 40%" |
[[Tarifwerk-Konfigurator]]

| style="width: 10%" |  
| rowspan="2" style="vertical-align:top" | [[File:rp_logo.png|Tarifwerk-Konfigurator|link=Rechnungsprüfung]]
| style="width: 40%" |
[[Rechnungsprüfung]]

|- style="vertical-align:top"
| style="padding-left: 10px" | Verwaltung von Tarifen und Plugins
|  
| style="padding-left: 10px" | Vergleich von Frachtführer-Rechnungen mit hinterlegten Tarifen

|-
|  
|-
| rowspan="2" style="vertical-align:top" | [[File:spm_logo_spm.png|SPM|link=Shipment Policy Manager (Tarifwerk)]]
|
[[Shipment Policy Manager (Tarifwerk)|SPM]]

|  
| rowspan="2" style="vertical-align:top" | [[File:mars_logo.png|Statisitk|link=]]
|
MARS

|- style="vertical-align:top"
| style="padding-left: 10px" | "Shipment Policy Manager" Ermitteln der besten Versandart
|  
| style="padding-left: 10px" | "Multifunktionale Auswertungen und relationale Statistiken" Frei konfigurierbare Auswertungen und Statistiken von Rechnungen

|-
|  
|-
| rowspan="2" style="vertical-align:top" | [[File:igel_logo.png|IGEL|link=IGEL]]
|
[[IGEL]]

|  
| rowspan="2" style="vertical-align:top" | [[File:fence_logo.png|link=FENCE]]
|
[[FENCE]]

|- style="vertical-align:top"
| style="padding-left: 10px" | "Import Generischer Excel Layouts" Einfacher Import von Tariftabellen aus Excel Vorlagen
|  
| style="padding-left: 10px" | "Frachtkosten Einschätzung für Neue Carrier Einsätze" Simulation von bereits berechneten Sendungen mit neuen Frachtführern.
|}
 
 
==HFMS Integrations-Guide==
 
{| style="width: 100%"
|-
| rowspan="2" style="vertical-align:top" |[[Datei:Systemvoraussetzungen.jpg|links|rahmenlos|142x142px|link=HFMS Systemvoraussetzungen]]
| style="width: 40%" |
[[HFMS Systemvoraussetzungen|Systemvoraussetzungen]]

| style="width: 10%" |  
| rowspan="2" style="vertical-align:top" | [[File:Update.jpg|Tarifwerk-Konfigurator|link=Aktualisierung HFMS (Tarifwerk)]]
| style="width: 40%" |
[[Aktualisierung HFMS (Tarifwerk)|Updateanleitung]]

|- style="vertical-align:top"
| style="padding-left: 10px" |Vorraussetzungen der Hardware / Software damit das HFMS reibungslos betrieben werden kann.
|  
| style="padding-left: 10px" |Anleitung zum Aktualisieren des HFMS / Tarifwerk

|}

Datei:Update.jpg

2023-09-26T07:13:18Z

Sbaumbach:

CVE-2023-42503

2023-09-21T14:32:33Z

Sbaumbach: /* Betroffene Applikationen */

= Quelle =
https://nvd.nist.gov/vuln/detail/CVE-2023-42503

= Beschreibung vom CVE =
Durch die Ausnutzung der Sicherheitslücke wäre eine DOS (Denial of Service) Attacke auf das System möglich.

Das Ausnutzen der Sicherheitslücke geht nur über das Lesen einer .tar Datei. Keine unserer Applikationen nutzt momentan diese Funktion.

= Betroffene Applikationen =
''application name = Name der Applikation.'' 
''affected version = Für welche Versionssände Handlungsbedarf besteht.'' 
''fixed version = Mindestversionsstand, in welcher die Sicherheitslücke behoben / nicht betroffen ist.'' 
''not affected = Diese Applikation ist von der Sicherheitslücke nicht betroffen. Es besteht kein Handlungsbedarf.'' 
{| class="wikitable"
|-
! application name !! affected version !! fixed version
|-
| CarrierAPI || not affected || not affected
|-
| ComManager || ||
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || 3.8.14 || 3.8.27
|-
| FileConverter || ||
|-
| FileMoveService || ||
|-
| GLSBoxService || ||
|-
| HFMS (Tarifwerk) || >= 1.8.9 || -
|-
| HVS32AMAService || ||
|-
| HVS32DBArchivierung || all versions || 4.6.8
|-
| HVS32MonitoringService || ||
|-
| HVS32MonitoringServiceLight || ||
|-
| IRIS || all versions || 1.1.2
|-
| Leitcode || ||
|-
| ScaleService || all versions || 2.2.6
|-
| SEM-Manager || all versions || 1.6.3
|-
| SEM-Web || all versions || 1.6.1
|-
| Verladefreigabe || all versions || 2.2.5
|-
| WatchLog || ||
|}

CVE-2023-42503

2023-09-19T07:40:40Z

Sbaumbach: /* Betroffene Applikationen */

= Quelle =
https://nvd.nist.gov/vuln/detail/CVE-2023-42503

= Beschreibung vom CVE =
Durch die Ausnutzung der Sicherheitslücke wäre eine DOS (Denial of Service) Attacke auf das System möglich.

Das Ausnutzen der Sicherheitslücke geht nur über das Lesen einer .tar Datei. Keine unserer Applikationen nutzt momentan diese Funktion.

= Betroffene Applikationen =
''application name = Name der Applikation.'' 
''affected version = Für welche Versionssände Handlungsbedarf besteht.'' 
''fixed version = Mindestversionsstand, in welcher die Sicherheitslücke behoben / nicht betroffen ist.'' 
''not affected = Diese Applikation ist von der Sicherheitslücke nicht betroffen. Es besteht kein Handlungsbedarf.'' 
{| class="wikitable"
|-
! application name !! affected version !! fixed version
|-
| CarrierAPI || not affected || not affected
|-
| ComManager || ||
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || 3.8.14 || 3.8.27
|-
| FileConverter || ||
|-
| FileMoveService || ||
|-
| GLSBoxService || ||
|-
| HFMS (Tarifwerk) || >= 1.8.9 || -
|-
| HVS32AMAService || ||
|-
| HVS32DBArchivierung || all versions || 4.6.8
|-
| HVS32MonitoringService || ||
|-
| HVS32MonitoringServiceLight || ||
|-
| IRIS || all versions || -
|-
| Leitcode || ||
|-
| ScaleService || all versions || 2.2.6
|-
| SEM-Manager || all versions || 1.6.3
|-
| SEM-Web || all versions || 1.6.1
|-
| Verladefreigabe || all versions || 2.2.5
|-
| WatchLog || ||
|}

CVE-2023-42503

2023-09-18T10:17:53Z

Sbaumbach: /* Betroffene Applikationen */

= Quelle =
https://nvd.nist.gov/vuln/detail/CVE-2023-42503

= Beschreibung vom CVE =
Durch die Ausnutzung der Sicherheitslücke wäre eine DOS (Denial of Service) Attacke auf das System möglich.

Das Ausnutzen der Sicherheitslücke geht nur über das Lesen einer .tar Datei. Keine unserer Applikationen nutzt momentan diese Funktion.

= Betroffene Applikationen =
''application name = Name der Applikation.'' 
''affected version = Für welche Versionssände Handlungsbedarf besteht.'' 
''fixed version = Mindestversionsstand, in welcher die Sicherheitslücke behoben / nicht betroffen ist.'' 
''not affected = Diese Applikation ist von der Sicherheitslücke nicht betroffen. Es besteht kein Handlungsbedarf.'' 
{| class="wikitable"
|-
! application name !! affected version !! fixed version
|-
| CarrierAPI || not affected || not affected
|-
| ComManager || ||
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || ||
|-
| FileConverter || ||
|-
| FileMoveService || ||
|-
| GLSBoxService || ||
|-
| HFMS (Tarifwerk) || >= 1.8.9 || -
|-
| HVS32AMAService || ||
|-
| HVS32DBArchivierung || all versions || 4.6.8
|-
| HVS32MonitoringService || ||
|-
| HVS32MonitoringServiceLight || ||
|-
| IRIS || all versions || -
|-
| Leitcode || ||
|-
| ScaleService || all versions || 2.2.6
|-
| SEM-Manager || all versions || -
|-
| SEM-Web || all versions || -
|-
| Verladefreigabe || all versions || 2.2.5
|-
| WatchLog || ||
|}

CVE-2023-42503

2023-09-18T09:14:12Z

Sbaumbach: /* Betroffene Applikationen */

= Quelle =
https://nvd.nist.gov/vuln/detail/CVE-2023-42503

= Beschreibung vom CVE =
Durch die Ausnutzung der Sicherheitslücke wäre eine DOS (Denial of Service) Attacke auf das System möglich.

Das Ausnutzen der Sicherheitslücke geht nur über das Lesen einer .tar Datei. Keine unserer Applikationen nutzt momentan diese Funktion.

= Betroffene Applikationen =
''application name = Name der Applikation.'' 
''affected version = Für welche Versionssände Handlungsbedarf besteht.'' 
''fixed version = Mindestversionsstand, in welcher die Sicherheitslücke behoben / nicht betroffen ist.'' 
''not affected = Diese Applikation ist von der Sicherheitslücke nicht betroffen. Es besteht kein Handlungsbedarf.'' 
{| class="wikitable"
|-
! application name !! affected version !! fixed version
|-
| CarrierAPI || not affected || not affected
|-
| ComManager || ||
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || ||
|-
| FileConverter || ||
|-
| FileMoveService || ||
|-
| GLSBoxService || ||
|-
| HFMS (Tarifwerk) || >= 1.8.9 || -
|-
| HVS32AMAService || ||
|-
| HVS32DBArchivierung || all versions || 4.6.8
|-
| HVS32MonitoringService || ||
|-
| HVS32MonitoringServiceLight || ||
|-
| IRIS || all versions || -
|-
| Leitcode || ||
|-
| ScaleService || all versions || 2.2.6
|-
| SEM-Manager || all versions || -
|-
| SEM-Web || all versions || -
|-
| Verladefreigabe || all versions || -
|-
| WatchLog || ||
|}

CVE-2023-42503

2023-09-18T06:21:54Z

Sbaumbach:

= Quelle =
https://nvd.nist.gov/vuln/detail/CVE-2023-42503

= Beschreibung vom CVE =
Durch die Ausnutzung der Sicherheitslücke wäre eine DOS (Denial of Service) Attacke auf das System möglich.

Das Ausnutzen der Sicherheitslücke geht nur über das Lesen einer .tar Datei. Keine unserer Applikationen nutzt momentan diese Funktion.

= Betroffene Applikationen =
''application name = Name der Applikation.'' 
''affected version = Für welche Versionssände Handlungsbedarf besteht.'' 
''fixed version = Mindestversionsstand, in welcher die Sicherheitslücke behoben / nicht betroffen ist.'' 
''not affected = Diese Applikation ist von der Sicherheitslücke nicht betroffen. Es besteht kein Handlungsbedarf.'' 
{| class="wikitable"
|-
! application name !! affected version !! fixed version
|-
| CarrierAPI || not affected || not affected
|-
| ComManager || ||
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || ||
|-
| FileConverter || ||
|-
| FileMoveService || ||
|-
| GLSBoxService || ||
|-
| HFMS (Tarifwerk) || >= 1.8.9 || -
|-
| HVS32AMAService || ||
|-
| HVS32DBArchivierung || all versions || -
|-
| HVS32MonitoringService || ||
|-
| HVS32MonitoringServiceLight || ||
|-
| IRIS || all versions || -
|-
| Leitcode || ||
|-
| ScaleService || all versions || 2.2.6
|-
| SEM-Manager || all versions || -
|-
| SEM-Web || all versions || -
|-
| Verladefreigabe || all versions || -
|-
| WatchLog || ||
|}

Sicherheitslücken / CVE

2023-09-15T13:38:41Z

Sbaumbach: /* Übersicht Sicherheitslücken / CVE */

CVE-2023-42503

2023-09-15T13:38:12Z

Sbaumbach:

= Quelle =
https://nvd.nist.gov/vuln/detail/CVE-2023-42503

= Beschreibung vom CVE =
Durch die Ausnutzung der Sicherheitslücke wäre eine DOS (Denial of Service) Attacke auf das System möglich.
Allerdings nutzt keine unserer Applikation diese spezielle Funktion.

= Betroffene Applikationen =
''application name = Name der Applikation.'' 
''affected version = Für welche Versionssände Handlungsbedarf besteht.'' 
''fixed version = Mindestversionsstand, in welcher die Sicherheitslücke behoben / nicht betroffen ist.'' 
''not affected = Diese Applikation ist von der Sicherheitslücke nicht betroffen. Es besteht kein Handlungsbedarf.'' 
{| class="wikitable"
|-
! application name !! affected version !! fixed version
|-
| CarrierAPI || not affected || not affected
|-
| ComManager || ||
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || ||
|-
| FileConverter || ||
|-
| FileMoveService || ||
|-
| GLSBoxService || ||
|-
| HFMS (Tarifwerk) || >= 1.8.9 || -
|-
| HVS32AMAService || ||
|-
| HVS32DBArchivierung || all versions || -
|-
| HVS32MonitoringService || ||
|-
| HVS32MonitoringServiceLight || ||
|-
| IRIS || all versions || -
|-
| Leitcode || ||
|-
| ScaleService || all versions || 2.2.6
|-
| SEM-Manager || all versions || -
|-
| SEM-Web || all versions || -
|-
| Verladefreigabe || all versions || -
|-
| WatchLog || ||
|}

CVE-2023-42503

2023-09-15T12:39:18Z

Sbaumbach: Die Seite wurde neu angelegt: „= Quelle = https://nvd.nist.gov/vuln/detail/CVE-2023-42503 = Beschreibung vom CVE = Durch die Ausnutzung der Sicherheitslücke wäre eine DOS (Denial of Servi…“

= Quelle =
https://nvd.nist.gov/vuln/detail/CVE-2023-42503

= Beschreibung vom CVE =
Durch die Ausnutzung der Sicherheitslücke wäre eine DOS (Denial of Service) Attacke auf das System möglich.
Allerdings nutzt keine unserer Applikation diese spezielle Funktion.

= Betroffene Applikationen =
''application name = Name der Applikation.'' 
''affected version = Für welche Versionssände Handlungsbedarf besteht.'' 
''fixed version = Mindestversionsstand, in welcher die Sicherheitslücke behoben / nicht betroffen ist.'' 
''not affected = Diese Applikation ist von der Sicherheitslücke nicht betroffen. Es besteht kein Handlungsbedarf.'' 
{| class="wikitable"
|-
! application name !! affected version !! fixed version
|-
| CarrierAPI || not affected || not affected
|-
| ComManager || 1.2.11 or lower || 1.2.12
|-
| DataGatewayServer V3 (DGS V3) ''alle Versionen 2.x.x sind ausgeschlossen'' || 3.8.15 or lower || 3.8.16
|-
| FileConverter || not affected || not affected
|-
| FileMoveService || not affected || not affected
|-
| GLSBoxService || not affected || not affected
|-
| HFMS (Tarifwerk) || 1.8.12 or lower || 1.8.13
|-
| HVS32AMAService || not affected || not affected
|-
| HVS32DBArchivierung || not affected || not affected
|-
| HVS32MonitoringService || not affected || not affected
|-
| HVS32MonitoringServiceLight || not affected || not affected
|-
| IRIS || 1.0.9 or lower || 1.0.10
|-
| Leitcode || 3.3.6 or lower || 3.3.7
|-
| ScaleService || 2.2.3 or lower || 2.2.4
|-
| SEM-Manager || 1.5.6 or lower || 1.5.7
|-
| SEM-Web || 1.5.6 or lower || 1.5.7
|-
| Verladefreigabe || 2.2.3 or lower || 2.2.4
|-
| WatchLog || 1.2.2 or lower || 1.2.3
|}

Sicherheitslücken / CVE

2023-09-15T12:24:43Z

Sbaumbach: CVE-2023-42503

Hier erhalten Sie eine Übersicht der Sicherheitslücken, welche in unseren Applikationen durch Verwendung von Drittanbieterkomponenten aufgetreten sind. 
Möchten Sie per E-Mail über auftretende Sicherheitslücken benachrichtigt werden? Dann registrieren Sie sich zu unserem Admin-Newsletter unter https://heidler-strichcode.de/kontakt/ 
(''Damit das Kontaktformular für den Newsletter sichtbar ist, muss in der Datenschutzeinstellung die Checkbox "Marketing" aktiv sein.'')

= Wie aktualisiere ich die Applikationen =
Alles was Sie vor- und während der Aktualisierung unserer Applikationen beachten müssen, können Sie aus unserer Anleitung unter [[Aktualisierung von Erweiterungsmodulen]] entnehmen. Bitte lesen Sie sich diese Aufmerksam durch. 
Sollten Sie Rückfragen bezüglich der Aktualisierung haben oder sich unsicher sind, können Sie sich für weitere Unterstützung an unseren Support ([mailto:support@heidler-strichcode.de support@heidler-strichcode.de]) wenden.

= Sicherheitsstufen =
'''hoch''' = Die Sicherheitslücke könnte ausgenutzt werden. Es wird dringend empfohlen, die betroffenen Applikationen so zeitnah wie möglich zu aktualisieren, um eine Kompromittierung der Daten zu verhindern. 
'''mittel''' = Eine Ausnutzung der Sicherheitslücke kann nicht ausgeschlossen werden. Die betroffenen Funktionalitäten sind nicht direkt im Einsatz, jedoch kann nicht garantiert werden, dass diese durch die Nutzung von Drittanbieterkomponenten nicht in Verwendung sind. Die Aktualisierung sollte zu einem geeignet Zeitpunkt eingeplant werden. 
'''niedrig''' = Eine Ausnutzung der Sicherheitslücke ist ausgeschlossen. Eine Aktualisierung der Applikationen wird weiterhin empfohlen.

= Übersicht Sicherheitslücken / CVE =
''aktuellster CVE steht ganz oben''
{| class="wikitable"
|-
! Datum !! Sicherheitsstufe !! CVE
|-
| 18.04.2023 || niedrig || [[CVE-2023-21930]]
|-
| 10.02.2023 || mittel || [[CVE-2022-40152]]
|-
| 02.02.2023 || niedrig || [[CVE-2023-21835 / CVE-2023-21843]]
|-
| 15.09.2023 || niedrig || [[CVE-2023-42503]]
|}

IRIS Installation (Windows)

2023-08-02T07:11:49Z

Sbaumbach: /* Reverse Proxy + Web Server */

== Hinweis zur Installation auf Windows ==
Die hier formulierte Installationsanleitung beschreibt die Installation von [[IRIS Cloudsystem|IRIS]] auf einem Windows System.

Allerdings möchten wir an dieser Stelle darauf hinweisen, dass die [[IRIS Installation (Docker)|Installation unter Docker]] die simplere Methode zur Installation von IRIS ist.

Im Docker-Container sind diverse Dienste schon vorbereitet, welche hier manuell installiert und konfiguriert werden müssen, dazu zählen u.a.:

* MariaDB
* Interne Zertifizierungsstelle (interne Root CA)
* Reverse Proxy / Webserver

Eine Installation unter Windows ist nur zu empfehlen, wenn man sich mit den o.g. Diensten / Tools bereits sehr gut auskennt.

== MariaDB ==
Für die Installation von IRIS wird eine installierte MariaDB vorausgesetzt:

https://mariadb.org/

Wir testen IRIS hierbei immer gegen die letzte LTS-Version von MariaDB. Zum jetzigen Zeitpunkt (08.02.2023) ist das die Version 10.6.

Zur Administration der Datenbank können Sie ein Tool Ihrer Wahl nehmen, z.B. [https://dbeaver.io/ DBeaver], [https://www.heidisql.com/ HeidiSQL] oder das bei der Installation mitgelieferte Kommandozeilentool mysql.

=== Datenbanken ===
Zum Anlegen der Datenbanken können Sie folgendes Script als root User ausführen:<syntaxhighlight lang="sql" line="1" start="1">
create database iris_common character set = 'utf8mb4' collate 'utf8mb4_general_ci';
create database iris_account character set = 'utf8mb4' collate 'utf8mb4_general_ci';
create database iris_shipping character set = 'utf8mb4' collate 'utf8mb4_general_ci';
</syntaxhighlight>

=== User ===
Zur besseren Sicherheit sollten jede Datenbank mit einem eigenen User versehen werden, wobei jeder User nur auf diese eine Datenbank Zugriff hat.

Bitte verwenden Sie ein sicheres Passwort, sowie für jeden Benutzer ein anderes Passwort, und ersetzen Sie es in den Befehlen unten.

Falls Sie die MariaDB und IRIS auf unterschiedlichen Servern installieren, dann ersetzen Sie bitte den Teil @'localhost' durch die IP Adresse, wo IRIS installiert wird oder eine geeignete Wildcard, z.B. @'10.0.0.15' oder @'10.0.0.%'<syntaxhighlight lang="sql" line="1" start="1">
-- User for iris_common. Please replace the password with a secure random password
create user 'iris_common'@'localhost' identified by 'secure_password_for_iris_common_to_be_replaced';
grant all on iris_common.* to 'iris_common'@'localhost';

-- User for iris_account. Please replace the password with a secure random password
create user 'iris_account'@'localhost' identified by 'secure_password_for_iris_account_to_be_replaced';
grant all on iris_account.* to 'iris_account'@'localhost';

-- User for iris_shipping. Please replace the password with a secure random password
create user 'iris_shipping'@'localhost' identified by 'secure_password_for_iris_shipping_to_be_replaced';
grant all on iris_shipping.* to 'iris_shipping'@'localhost';

flush privileges;
</syntaxhighlight>

=== Verschlüsselung der Verbindung ===
Die Verbindung zur MariaDB muss mit TLS/SSL abgesichert werden.

Hierzu können Sie nach offizieller Anleitung vorgehen:

https://mariadb.com/kb/en/securing-connections-for-client-and-server/

Zum Erstellen des Zertifikats verwenden Sie bitte Ihre interne Zertifizierungs-Stelle (interne Root CA).

Bitte prüfen Sie die verschlüsselte Verbindung bevor Sie fortfahren.

== Installation iris-account ==
Sie erhalten das Setup von iris-account von unserem Support.

=== Installation ===
Für die Erstinstallation folgen Sie bitte dem Installer. Im Folgenden nehmen wir eine Installation auf C:\Heidler\iris\account an. Sollte Ihre Installation abweichen, ersetzen Sie bitte die Pfade entsprechend.

=== Datenbank-Verbindung ===
Zunächst muss die Verbindung zur Datenbank konfiguriert werden. iris-account benötigt eine Verbindung zu den Datenbanken iris_account und iris_common.

Sie finden die vorbereiteten Konfigurationsdateien unter: C:\Heidler\iris\account\config\database

Hier bitte die zwei Dateien kopieren und die Endung .example entfernen.

Danach bitte die Konfigurationsdateien anpassen. Die Dateien selbst enthalten eine Dokumentation und Erklärung zu jedem Parameter.

Wichtig: .properties Dateien können Sonderzeichen beinhalten, diese werden mit einem \ escaped. Sollten Sie einen Backslash benötigen (z.B. als Teil der Pfadangabe des Zertifikates), dann müssen Sie dies auch mit einem \ escapen. Beispiel:

serverCertificate=C:\\Heidler\\iris\\ssl\\ca.crt

=== Port ===
Standardmäßig starten iris-account einen HTTP-Webservice auf Port 9710.

Zum Ändern des Ports editieren Sie bitte die Datei: C:\Heidler\iris\account\config\service.properties

=== Erster Start ===
Sie können nun iris-account testweise starten.

Nach dem Start erhalten Sie eine Log-Datei unter: C:\Heidler\iris\account\logs\service.log

Wenn alles erfolgreich gestartet wurde, dann erhalten Sie einen Eintrag, der so ähnlich lautet:<syntaxhighlight lang="text" line="1" start="1">
2023-02-08 17:22:38.926 -08 WARN [main] (init.ServiceInitializer:166) - A new user has been created.:
Username: root@localhost
Password: P6oV-GK3GYsdnn_5usDg1tBmn00
Please login with this user and change your password immediately!
</syntaxhighlight>Bitte notieren Sie sich diesen Benutzer + Passwort umgehend.

=== HTTPS ===
Um HTTPS für iris-account zu aktivieren, hinterlegen Sie bitte das Server-Zertifikat im X.509 Format und den Private-Key im PKCS#8 Format unter folgenden Dateinamen:

C:\Heidler\iris\account\config\server-cert.pem

C:\Heidler\iris\account\config\server-privatekey-pkcs8.pem

Die Zertifikate müssen Sie mit Ihrer internen Zertifizierungsstelle erstellen (interne Root CA).

Nach dem Hinterlegen starten Sie bitte den Dienst neu.

Im Log sollten Sie dann nach dem Neustart diesen Log-Eintrag finden:<syntaxhighlight lang="text" line="1" start="1">
2023-02-08 17:27:44.367 -08 INFO [main] (rest.WebServer:88) - Starting https server on port 9710
</syntaxhighlight>

== Installation iris-shipping ==
Sie erhalten das Setup von iris-shipping von unserem Support.

=== Installation ===
Für die Erstinstallation folgen Sie bitte dem Installer. Im Folgenden nehmen wir eine Installation auf C:\Heidler\iris\shipping an. Sollte Ihre Installation abweichen, ersetzen Sie bitte die Pfade entsprechend.

=== Datenbank-Verbindung ===
Zunächst muss die Verbindung zur Datenbank konfiguriert werden. iris-account benötigt eine Verbindung zu den Datenbanken iris_shipping und iris_common.

Sie finden die vorbereiteten Konfigurationsdateien unter: C:\Heidler\iris\shipping\config\database

Hier bitte die zwei Dateien kopieren und die Endung .example entfernen.

Danach bitte die Konfigurationsdateien anpassen. Die Dateien selbst enthalten eine Dokumentation und Erklärung zu jedem Parameter.

Wichtig: .properties Dateien können Sonderzeichen beinhalten, diese werden mit einem \ escaped. Sollten Sie einen Backslash benötigen (z.B. als Teil der Pfadangabe des Zertifikates), dann müssen Sie dies auch mit einem \ escapen. Beispiel:

serverCertificate=C:\\Heidler\\iris\\ssl\\ca.crt

=== Port ===
Standardmäßig starten iris-shipping einen HTTP-Webservice auf Port 9720.

Zum Ändern des Ports editieren Sie bitte die Datei: C:\Heidler\iris\shipping\config\service.properties

=== Erster Start ===
Sie können nun iris-shipping testweise starten.

Nach dem Start erhalten Sie eine Log-Datei unter: C:\Heidler\iris\account\logs\service.log

=== HTTPS ===
Um HTTPS für iris-account zu aktivieren, hinterlegen Sie bitte das Server-Zertifikat im X.509 Format und den Private-Key im PKCS#8 Format unter folgenden Dateinamen:

C:\Heidler\iris\shipping\config\server-cert.pem

C:\Heidler\iris\shipping\config\server-privatekey-pkcs8.pem

Die Zertifikate müssen Sie mit Ihrer internen Zertifizierungsstelle erstellen (interne Root CA).

Nach dem Hinterlegen starten Sie bitte den Dienst neu.

Im Log sollten Sie dann nach dem Neustart diesen Log-Eintrag finden:<syntaxhighlight lang="text" line="1" start="1">
2023-02-08 17:33:47.257 -08 INFO [main] (rest.WebServer:88) - Starting https server on port 9720
</syntaxhighlight>

== Installation Frontend ==
Sie erhalten die Frontend-Dateien für IRIS von unserem Support.

Bitte entpacken Sie diese Dateien an einem Ort, wo Ihr Webserver / Reverse-Proxy Zugriff hat und diese veröffentlichen kann (z.B. C:\Heidler\iris\frontend).

== Reverse Proxy + Web Server ==

Bitte installieren Sie einen geeigneten Reverse Proxy und Webserver, welcher die Anfragen aus dem Internet entgegennimmt und sowohl das Frontend ausliefern, als auch Anfragen an IRIS weiterleiten kann.

Der Reverse Proxy muss folgende Aufgaben übernehmen:

* Öffentlicher HTTPS-Server mit gültigem und anerkanntem HTTPS-Zertifikat
* Automatische Weiterleitung von HTTP-Anfragen auf HTTPS
* Auslieferung der statischen Frontend-Dateien (Inhalt vom Frontend-Vereichnis entspricht dem URL-Pfad)
** z.B. https://<domain>/ zu [frontend]\index.html
** z.B. https://<domain>/js/site.js zu [frontend]\js\site.js
* Umleitung aller Anfragen auf /account an iris-account, inkl. des URL-Teils /account
** z.B. https://<domain>/account/validate zu https://<servername>:9710/account/validate
* Umleitung aller Anfragen auf /v2/hsc/shipping an iris-shipping, inkl. des URL-Teils /v2/hsc/shipping
** z.B. https://<domain>/v2/hsc/shipping/echo/test zu https://<servername>:9720/v2/hsc/shipping/echo/test

Intern haben wir diese Konfiguration bereits mit nginx und auch IIS testen können.

Bitte beachten Sie allerdings, dass wir Ihnen keine Unterstützung bei der Konfiguration von externen Diensten geben können.

Statusdaten Frachtführer

2023-07-18T13:33:22Z

Sbaumbach: /* TNT */

[[en:Statusdata Carrier]]
= Allgemeiner Ablauf =
Statusdaten dienen zur Nachverfolgung des Auslieferstatus einer Sendung. Diese werden von den Frachtführern in vielen verschiedenen Formaten bereitgestellt.

Im Allgemeinen läuft die Abholung nach folgendem Schema ab:

[[File:SEM_Ablauf.png|Ablauf des StatusdatenManger|750px]]

==Begriffdefinitionen==
===Statusdaten===
Unter Statusdaten verstehen wir die Trackingdaten mit den einzelenen Updates des Sendung.

===POD===
Hierunter verstehen wir die Abliefernachweise / Gelangensbestätigungen. Also die Dokumente (meist PDF) welche vom Frachtführer bereitgestellt werden.
Im Optimalfall benennt der Frachtführer die Daten so, dass eine Referenz (wie TrackingNr, LieferscheinNr, etc.) im Dateinamen vorhanden ist, da eine Zuordnung ansonsten nur noch über eine separat bereitgestellte Datei mit Zuordnung von Datei zu Referenz erfolgen kann.

==Key Points==
*Bei der Aktualität der Daten sind wir daher auch von der Häufigkeit der Bereitstellung des Frachtführers abhängig. Die Daten sind also immer nur so aktuell, wie sie der Frachtführer bereitstellt. Sollte dieser nur einmal am Tag neue Daten bereitstellen, werden die Daten im HVS und für Auswertungen auch nur einmal am Tag aktualisiert.
*Wichtig ist auch, dass die Kommunikation mit den Frachtführern von Ihnen durchgeführt werden muss, da bei einigen ein zusätzlicher Vertrag für die Bereitstellung der Statusdaten geschlossen werden muss.
* Unsere Standardschnittstelle für den Export der Dateien finden Sie hier: [[Statusdaten_Export_Standard_Schnitstelle|Statusdaten Export Standard Schnittstelle]]

=Export=
[[Statusdaten_Export_Standard_Schnitstelle|Standardschnittstelle]]

=Frachtführer=
Hier finden Sie für alle aufgelisteten Frachtführer die Informationen, welche Sie bei dem jeweiligen Frachtführer anfragen / beauftragen müssen und welche Informationen wir dann für die spätere Einrichtung benötigen.

'''Wir benötigen im Normalfall nur die Zugangsdaten zu dem Server, auf welchen der Frachtführer die Statusdaten bereitstellt.'''

===Neue Frachtführer===
Für einen neuen Frachtführer, welcher unterhalb noch nicht aufgelistet ist, benötigen wir folgende Daten:
*Spezifikation mit Beispiel-Datei
*Code-Tabelle der verschiedenen Status-Codes (z. B. der Code "del" bedeutet Delivered / Zugestellt)
* Art der Bereitstellung sowie die entsprechenden Zugangsdaten (SFTP, ...)

-> Webservice anfragen beim Frachtführer zum aktuellen Status der Sendung ist für uns nicht möglich.

==24Plus==
:'''Allgemein'''

:Hier kann jeder "Unter-Spediteur" die Daten ein wenig anders bereitstellen. Daher benötigen wir immer eine Beispiel-Datei mit zugehöriger Spezifikation.
:Aktuell haben wir folgenden Varianten umgesetzt:

:{| class="wikitable sortable"
|+Format
|-
!Frachtführer
!Format
!Version
|-
|Hoevelmann
|
|QM-LR Stand 12/05
|-
|Kunzendorf
|Fortras Release 100
|01.04.2020 1.14 QM-LR
|}

==Bartolini==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:* Flatfile
:Mehr Informationen zur Spezifikation liegen uns zum aktuellen Zeitpunkt nicht vor!

==Boll==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:* Fortras - Release 100 - Version: 2004/07 - al/HF
:Mehr Informationen zur Spezifikation liegen uns zum aktuellen Zeitpunkt nicht vor!

==BTG Logistik==
Finden Sie unter [[Statusdaten_Frachtführer#CargoLine|CargoLine]]

==CargoLine==
:'''Allgemein'''

:Hier kann jeder "Unter-Spediteur" die Daten ein wenig anders bereitstellen. Daher benötigen wir immer eine Beispiel-Datei mit zugehöriger Spezifikation.
:Aktuell haben wir folgenden Varianten umgesetzt:

:{| class="wikitable sortable"
|+Format
|-
!Frachtführer
!Format
!Version
|-
|AMM Spedition
|Fortras Release 100
|2019/12
|-
|Koch Spedition
|Fortras Release 100
|2019/03
|-
|BTG Logistik
|CSV
|
|-
|Rhenus
|Fortras Release 100
|2019/12
|}

==Dachser==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:* EDIFACT IFTSTA D 01C

== DHL==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*FFSTAT Shipment Status Message v4.0.0

'''[[Statusdaten_Frachtführer#POD|POD]]'''

#Prüfung auf vertragliche Zugangsberechtigung zur Aufschaltung T&T Proactive und Genehmigung für IT (DHL Accounting)
# Kundenseitige Prüfung und Mitteilung an DHL Accounting und DHL IT, welcher GKP User (ID) verantwortlich ist für künftige Reportkonfigurationen (Kunde)
#Abstimmung über für Reporting zulässige/berechtigte Abrechnungsnummern (Kunde/DHL Accounting)
#Systemische Beauftragung zur Aufschaltung des Reports (hier: POD) für den genannten GKP-User und berechtigte Abrechnungsnummern (DHL Accounting)
#Abstimmung über den Verantwortlichen für den SFTP-Account (Owner) (Name & Mail) (Kunde/DHL IT)
#Anlage eines sftp-Users auf dem DHL Server (Account: peTTPRO…) (DHL IT)
#Vergabe eines Passwortes für den sftp-Account nach Eingang Initialmail beim Verantwortlichen sftp-Account Owner über unser Self-Service-Portal (Kunde)
#Verknüpfen des GKP-Users mit dem sftp-Account (DHL IT)
#Konfigurieren (Zuweisung gewünschter Abrechnungsnummer(n)) und Aktivieren des für den GKP User freigeschalteten Reports (bspw. als pdf) im GKP (Kunde)
#Bereitstellung des/der kundenseitig eingerichteten und aktivierten Reports auf dem sftp-Server (DHL IT)
#Hinterlegen der Zugangsdaten (sftp-Account & Passwort) im Heidler T&T Modul (Kunde)
#Abgreifen (automatisiertes Abholen & Löschen) und interne Weiterverarbeitung der auf dem DHL sftp-Server bereitgestellten Reports (Heidler)

Punkt 9 muss nach vorbereiteter Freischaltung kundenseitig im GKP/Rechnungen&Reports eingerichtet werden:
[[File:DHL POD DESC.png|POD]]

==DHL Global Forwarding (DGF)==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:* Status message IFTSTA – for customers (IFTSTA D.01B) Version 1.1 - Stand 05.06.2018

==DHL Freight==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:* Active Tracing (ACT) - Version 3.0 - Stand 2019.05.22

==DHL Paket (Post)==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:* CSV - EREIGNIS-REPORT (REPSRD)
:Hier ist zu beachten, dass die Bereitstellung auf dem Nummernkreis erfolgen muss, nicht anhand der Kundennummer

==DPD==
[[Datei:DPD_Statusdatenformular.png|alternativtext=|rand|rechts|450px]]
:Von DPD werden sie wahrscheinlich ein Formular (siehe Bild rechts) zum ausfüllen bekommen. Den oberen Teil anhand der folgenden Beschreibung ausfüllen:
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]] (1)'''
:*SCANINFO
:Hier handelt es sich um die normalen Statusdaten.

'''[[Statusdaten_Frachtführer#POD|POD]] (2/3)'''
:Je nachdem was bei Ihnen benötigt wird angeben.

==DSV==
Finden Sie unter [[Statusdaten_Frachtführer#IDS|IDS]]

== Gebr Weiss ==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''

* IFTSTA D.96A

==Geis==
Finden Sie unter [[Statusdaten_Frachtführer#IDS|IDS]]

==GLS==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*Pakstat DE

Hinweis zu Webservice: GLS bietet alternativ auch den Webservice "Track and Trace Parcel" statt der Pakstat DE Lösung an.

Allerdings ist diese Webservice-Lösung nicht geeignet, um massenhaft Statusdaten für alle Sendungen zu importieren, da bei diesem Webservice jede Sendung einzeln abgefragt werden muss.

Wir sind hierzu bereits mit GLS in Kontakt und suchen nach alternativen Webservice-Lösungen.

Die Pakstat DE Lösung kann deshalb weiterhin verwendet werden. Es gibt bis auf weiteres von GLS kein End-Datum für die Pakstat DE Lösung.

==GLS FR==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*RETALPPT
:Die Daten müssen auf dem von GLS FR bereitgestellten SFTP Server abgelegt werden.

==GLS NL==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*CSV

==GO!==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*GO! Statusdaten Schnittstelle V2.1

==Hellmann==
Finden Sie unter [[Statusdaten_Frachtführer#Nightstar|Nightstar]]

==Heppner==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*Heppner Standard Flat File Report

==Hermes HSE==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*Statusdaten Übermittlung an Auftraggeber (29.11.2017)
:HSE gibt zu jedem Status noch eine Avis Meldung mit an, wie: "Wird wie telefonisch besprochen am 01.01 um 19:00 Uhr geliefert"
:Dieser Text wird Standardmäßig in ffzusatzklartext geschrieben.

==Hövelmann==
Finden Sie unter [[Statusdaten_Frachtführer#24Plus|24Plus]]

==IDS==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:'''Allgemein'''

:Hier kann jeder "Unter-Spediteur" die Daten ein wenig anders bereitstellen. Daher benötigen wir immer eine Beispiel-Datei mit zugehöriger Spezifikation.
:Aktuell haben wir folgenden Varianten umgesetzt:

:{| class="wikitable sortable"
|+Format
|-
!Frachtführer
!Format
!Version
|-
|<del>DSV (old)</del>
|<del>STAT512 Release 100</del>
|<del>2005/06 - al/HF</del>
|-
|DSV
|DSV_TR_E2E_STD_IFTSTA_D10B_IFTSTA_D10B_OUT_mp
|4-PROD EDIC - UN D.10B S4
|-
|Geis
|elix/IDS Flatfile
|15.03.2004
|-
|Nörpel
|CSV
|
|}

==JCL==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*Statusmeldung - ;(Semikolon) getrennt

==Kühne & Nagel==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*STAT512 (System Alliance-Datensatz für Statusberichte – Release 100)
:Version: 2005/06 - al/HF

==Kunzendorf==
Finden Sie unter [[Statusdaten_Frachtführer#24Plus|24Plus]]

==LPR==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*Statusrückmeldung - |(Pipe) getrennt

==Nightstar==
:'''Allgemein'''

:Hier kann jeder "Unter-Spediteur" die Daten ein wenig anders bereitstellen. Daher benötigen wir immer eine Beispiel-Datei mit zugehöriger Spezifikation.
:Aktuell haben wir folgenden Varianten umgesetzt:

:{| class="wikitable sortable"
|+Format
|-
!Frachtführer
!Format
!Version
|-
|Hellmann
|EDIFACT/D96A/IFTSTA
|0.1.5 Draft
|}

==Nörpel==
Finden Sie unter [[Statusdaten_Frachtführer#IDS|IDS Spedition]]

==PostCH==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*Report11 (Eine Art CSV mit 2 führenden Zeilen Sender & Provider)
'''Möglicherweise veraltet'''

==Rhenus==
Finden Sie unter [[Statusdaten_Frachtführer#CargoLine|CargoLine]]

==Schenker==
'''Besonderheiten'''

Für den SFTP-Server verwendet UPS den Port '''4022'''. Dieser muss in der Firewall freigegeben sein.

'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*EDIFACT - IFTSTA D.96A (04.09.18)

==TNT==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*CIT_CSV_POD_V1_SEMI
:*T-T-CDF CSV Full

:Folgende Angaben werden für die Beantragung benötigt:
:*Das Beantragungsdatum und das zuständige Depot.
:*Kundendaten: TNT-Kundennummer, Firmenname, Straße, Postleitzahl, Ort sowie Ansprechpartner, Telefonnummer (inkl. Durchwahl) und die E-Mail-Adresse.
:*Status Meldungen: positive (Zustellung), negative (Hindernisse) oder beide.
:*Report Variante: CIT_CSV_POD_V1_SEMI
:*Versandart: Datei (File).
:*Report Zeiten:
: Wählbar sind eine, mehrere oder alle Zeiten. Bitte die Bearbeitungszeit und GMT/CET beachten.
:{| class="wikitable"
|-
!Verfügbare Zeiten (GMT)
|-
|02:00
|-
|06:00
|-
|10:00
|-
|14:00
|-
|18:00
|-
|22:00
|}

==Trans-O-Flex==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*Sendungsdaten Rückmeldung (Version 1.0 - 01.09.2018)

'''[[Statusdaten_Frachtführer#POD|POD]]'''
:*TIF Format

==UPS ==
'''Besonderheiten'''

Für den SFTP-Server verwendet UPS den Port '''10022'''. Dieser muss in der Firewall freigegeben sein.

'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
: Für die Statusdaten benötigen wir bei UPS das nachfolgende Format, es kann nicht die QVD (Quantum View®) Variante verwendet werden, da dafür ein Webservice nötig wäre! Das Format muss bei UPS speziell angefragt werden.
:*EDIFACT IFTSTA, Version D07B
'''[[Statusdaten_Frachtführer#POD|POD]]'''
:*Offline Delivery Confirmation System

==Winner==
'''[[Statusdaten_Frachtführer#Statusdaten|Statusdaten]]'''
:*Winner STAT128

HFMS Systemvoraussetzungen

2023-05-04T14:03:12Z

Sbaumbach: /* Rechnungsprüfung */

Nachfolgend finden Sie die Systemvoraussetzungen für den Betrieb des HFMS.
Bitte beachten Sie auch die allgemeinen Informationen unter [[Systemvoraussetzungen]]

== Betriebssysteme ==

Hinweis: Es wird in jedem Fall ein 64-bit Betriebssystem benötigt

* Windows Server 2019
* Windows Server 2022
* Windows 10 / 21H1
* Windows 11 
== Mindestanforderungen Hardware Allgemein ==

* CPU: 2 GHz Dual-Core CPU (Mindestens ein freier Kern für das HFMS)
* RAM: 2 GB verfügbar für das HFMS
* HDD: 4 GB verfügbar für das HFMS und Datenbank
* NET: 100 Mbit/s für internes Netzwerk

== Empfohlene Hardware Allgemein ==

* CPU: 2 Ghz Quad-Core CPU mit SMT
* RAM: 4 GB verfügbar für das HFMS
* SSD: 10 GB verfügbar für das HFMS und Datenbank
* NET: 1 Gbit/s für internes Netwerk / Internet-Verbindung empfohlen für Updates und Support

== Anforderungen Plugins ==

=== Rechnungsprüfung ===
Die Rechnungsprüfung ist über ein Web-Interface zu erreichen.

Das Web-Interface benötigt einen aktuellen HTML5 fähigen Browser mit Unterstützung für Javascript und Cookies.

Folgende Browser werden aktiv unterstützt und getestet:
* Firefox (Gecko): ESR 102 oder akutellste Version
* Chrome (Blink): Aktuellste Version
* Edge (Blink): Aktuellste Version
Internet Explorer wird nicht unterstützt.

=== SPM ===
Die automatische Versandart-Ermittlung führt die Ermittlung von Kombinationen sowie die Tarif-Berechnung gleichzeitig in separaten Threads aus.
Je nach Anzahl gleichzeitiger Anfragen, Anzahl Kombinationen und Anzahl möglicher Versandarten können in Einzelfällen mehr als 100 Threads gleichzeitig ausgeführt werden.

Dies soll nicht heißen, dass auch so viele Kerne bereitgestellt werden müssen. Vielmehr sollte vorab genügend Puffer je nach Versand-Aufkommen und Komplexität der Konfiguration eingeplant werden.

== Portfreigabe ==
Die hier aufgeführten Freigaben sind nur für das Intranet und sollten nicht nach außen freigegeben werden.
Alle Ports können auch konfiguriert werden.

* Port 9500: HTTP Server für Web-Interface und Kommunikation HVS32 -> HFMS
* Port 9092: Datenbank für Verwendung des Konfigurators von einem Client-PC
* Port 8443: HTTPS Server (optional - benötigt Zertifikat)

HFMS Systemvoraussetzungen

2023-05-04T14:02:08Z

Sbaumbach: /* Betriebssysteme */

Nachfolgend finden Sie die Systemvoraussetzungen für den Betrieb des HFMS.
Bitte beachten Sie auch die allgemeinen Informationen unter [[Systemvoraussetzungen]]

== Betriebssysteme ==

Hinweis: Es wird in jedem Fall ein 64-bit Betriebssystem benötigt

* Windows Server 2019
* Windows Server 2022
* Windows 10 / 21H1
* Windows 11 
== Mindestanforderungen Hardware Allgemein ==

* CPU: 2 GHz Dual-Core CPU (Mindestens ein freier Kern für das HFMS)
* RAM: 2 GB verfügbar für das HFMS
* HDD: 4 GB verfügbar für das HFMS und Datenbank
* NET: 100 Mbit/s für internes Netzwerk

== Empfohlene Hardware Allgemein ==

* CPU: 2 Ghz Quad-Core CPU mit SMT
* RAM: 4 GB verfügbar für das HFMS
* SSD: 10 GB verfügbar für das HFMS und Datenbank
* NET: 1 Gbit/s für internes Netwerk / Internet-Verbindung empfohlen für Updates und Support

== Anforderungen Plugins ==

=== Rechnungsprüfung ===
Die Rechnungsprüfung ist über ein Web-Interface zu erreichen.
Das Web-Interface benötigt einen aktuellen HTML5 fähigen Browser mit Unterstützung für Javascript und Cookies.

Folgende Browser werden aktiv unterstützt und getestet:
* Firefox (Gecko): ESR 91 oder akutellste Version
* Chrome (Blink): Aktuellste Version
* Edge (EdgeHTML): Aktuellste Version
* Edge (Blink): Aktuellste Version
Internet Explorer wird nicht unterstützt.

=== SPM ===
Die automatische Versandart-Ermittlung führt die Ermittlung von Kombinationen sowie die Tarif-Berechnung gleichzeitig in separaten Threads aus.
Je nach Anzahl gleichzeitiger Anfragen, Anzahl Kombinationen und Anzahl möglicher Versandarten können in Einzelfällen mehr als 100 Threads gleichzeitig ausgeführt werden.

Dies soll nicht heißen, dass auch so viele Kerne bereitgestellt werden müssen. Vielmehr sollte vorab genügend Puffer je nach Versand-Aufkommen und Komplexität der Konfiguration eingeplant werden.

== Portfreigabe ==
Die hier aufgeführten Freigaben sind nur für das Intranet und sollten nicht nach außen freigegeben werden.
Alle Ports können auch konfiguriert werden.

* Port 9500: HTTP Server für Web-Interface und Kommunikation HVS32 -> HFMS
* Port 9092: Datenbank für Verwendung des Konfigurators von einem Client-PC
* Port 8443: HTTPS Server (optional - benötigt Zertifikat)

Carrier API Fehlercodes

2023-05-04T07:36:35Z

Sbaumbach: /* Plugin Codes */

== Allgemeines ==
Fehlercodes in der Carrier API sind nach dem Schema <code>AAA-SSS-GG-L[Code]</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: <code>CAP-HEH-02-E00005</code>

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 <code>(Strg+F)</code> zunächst mit dem eigentlichen Code.

Falls Sie den Code nicht direkt finden können, ersetzen Sie bitte die Subgruppe z.B. "HEH" durch <code>XXX</code>. Aus dem obigen Beispiel: <code>CAP-XXX-02-E00005</code>. 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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).

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 [https://de.wikipedia.org/wiki/Man-in-the-Middle-Angriff 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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.

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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).

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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) ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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 ===

{| class="wikitable"
|-
! style="width:140px" | Code !! style="width:300px" | 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.

{| class="wikitable sortable"
|-
! 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
|-
| 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
|-
| 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)
|-
| 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)
|-
| 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 Ship IT (Deutschland)
|-
| GPP || General Purpose (konfigurierbar), auch G00 - G99
|-
| GPS || GLS Parcel Shop (GLS DE Parcelshop Suche)
|-
| HBG || Hermes Border Guru
|-
| HEH || Hermes Shipping Interface (HSI)
|-
| HMP || Hellmann PL (Polen)
|-
|ICS
|ICS
|-
| INP || Inpost24
|-
| IZP || Infens Zustellprofi
|-
| 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)
|-
| 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
|-
| UPA || UPS Pickup (Abholung)
|-
| UPG || UPS GG (Gefahrgut PreAvis)
|-
| UPP || UPS Paperless Document
|-
| UPT || UPS Tarifierung
|-
| VNP || Venipak
|-
| WYF || Wayfair
|}

Aktualisierung Verladefreigabe

2023-05-03T16:12:10Z

Sbaumbach:

In dieser Beschreibung finden Sie alle notwendigen Informationen, um einen Verladefreigabe (Service + Desktop) zu aktualisieren. Bitte lesen Sie sich diese Aufmerksam durch. Bei Rückfragen wenden Sie sich bitte direkt an den Support ([mailto:support@heidler-strichcode.de support@heidler-strichcode.de])

= Verzeichnisname / Dienstname =
Die Verladefreigabe wird in der Regel im Heidler Verzeichnis als VerladefreigabeService und VerladefreigabeDesktop installiert.

Die Benamung des Windowsdiensts entspricht dabei der Benamung des Installationsverzeichnisses. Der Windowsdienst existiert nur für VerladefreigabeService.

= Kompatibilität =

* Grundsätzlich sind alle Versionen ab Verladefreigabe Version 2.1.0 auf die neueste Version automatisch aktualisierbar
** Für ältere Versionen kontaktieren Sie bitte unseren Support
* Bitte beachten Sie, dass Sie immer die neueste Version von VerladefreigabeService und VerladefreigabeDesktop benötigen
** Wir können keine Funktions-Garantie bei Versionsunterschieden zwischen diesen beiden Applikationen geben

= Update Dauer / Downtime =
Während des Updates sind keine Verladungen möglich.

Für das Update beider Applikationen planen Sie bitte ca. 10 Minuten ein.

= Abhängigkeit zu anderen Heidler Applikationen =
Es bestehen keine bei Updates zu beachtenden Abhängigkeiten zu anderen Heidler Applikationen.

= Was muss nach dem Update gemacht werden? =
Während der Aktualisierung wird automatisch der Windowsdienst beendet. Dieser wird nach dem ausführen des Setups nicht automatisch gestartet. Dies muss manuell erfolgen.

== Wie prüfe ich, ob die Applikation nach dem Update ordnungsgemäß funktioniert? ==
Nachdem der Windowsdienst wieder gestartet worden ist, sollten zum einen die Logs der Verladefreigabe geprüft werden. Diese befinden sich im Hauptverzeichnis der jeweiligen Applikation im Unterordner Logs.

==== VerladeFreigabeService ====
'''service\root.log''': In diesem Log kann der Start / Stopp vom Windowsdienst, sowie der einzelnen Verladevorgänge nachvollzogen werden.

'''service\error.log''': In diesem Log findet man alle aufgetretenen Applikationsfehler

==== VerladefreigabeDesktop ====
'''root.log''': In diesem Log kann der Start / Stopp der Applikation, sowie der einzelnen Verladevorgänge nachvollzogen werden.

== Welche Tests sollte ich nach dem Update durchführen? ==
Nachdem der Dienst gestartet und die Logs geprüft worden sind, sollte man eine Sendung testweise verladen und wieder sperren.

= Sonstige Besonderheiten =
Es gibt keine weitere Besonderheit.

Aktualisierung Verladefreigabe

2023-05-03T16:11:48Z

Sbaumbach: Die Seite wurde neu angelegt: „In dieser Beschreibung finden Sie alle notwendigen Informationen, um einen Verladefreigabe (Service + Desktop) zu aktualisieren. Bitte lesen Sie sich diese Auf…“

In dieser Beschreibung finden Sie alle notwendigen Informationen, um einen Verladefreigabe (Service + Desktop) zu aktualisieren. Bitte lesen Sie sich diese Aufmerksam durch. Bei Rückfragen wenden Sie sich bitte direkt an den Support ([mailto:upport@heidler-strichcode.de support@heidler-strichcode.de])

= Verzeichnisname / Dienstname =
Die Verladefreigabe wird in der Regel im Heidler Verzeichnis als VerladefreigabeService und VerladefreigabeDesktop installiert.

Die Benamung des Windowsdiensts entspricht dabei der Benamung des Installationsverzeichnisses. Der Windowsdienst existiert nur für VerladefreigabeService.

= Kompatibilität =

* Grundsätzlich sind alle Versionen ab Verladefreigabe Version 2.1.0 auf die neueste Version automatisch aktualisierbar
** Für ältere Versionen kontaktieren Sie bitte unseren Support
* Bitte beachten Sie, dass Sie immer die neueste Version von VerladefreigabeService und VerladefreigabeDesktop benötigen
** Wir können keine Funktions-Garantie bei Versionsunterschieden zwischen diesen beiden Applikationen geben

= Update Dauer / Downtime =
Während des Updates sind keine Verladungen möglich.

Für das Update beider Applikationen planen Sie bitte ca. 10 Minuten ein.

= Abhängigkeit zu anderen Heidler Applikationen =
Es bestehen keine bei Updates zu beachtenden Abhängigkeiten zu anderen Heidler Applikationen.

= Was muss nach dem Update gemacht werden? =
Während der Aktualisierung wird automatisch der Windowsdienst beendet. Dieser wird nach dem ausführen des Setups nicht automatisch gestartet. Dies muss manuell erfolgen.

== Wie prüfe ich, ob die Applikation nach dem Update ordnungsgemäß funktioniert? ==
Nachdem der Windowsdienst wieder gestartet worden ist, sollten zum einen die Logs der Verladefreigabe geprüft werden. Diese befinden sich im Hauptverzeichnis der jeweiligen Applikation im Unterordner Logs.

==== VerladeFreigabeService ====
'''service\root.log''': In diesem Log kann der Start / Stopp vom Windowsdienst, sowie der einzelnen Verladevorgänge nachvollzogen werden.

'''service\error.log''': In diesem Log findet man alle aufgetretenen Applikationsfehler

==== VerladefreigabeDesktop ====
'''root.log''': In diesem Log kann der Start / Stopp der Applikation, sowie der einzelnen Verladevorgänge nachvollzogen werden.

== Welche Tests sollte ich nach dem Update durchführen? ==
Nachdem der Dienst gestartet und die Logs geprüft worden sind, sollte man eine Sendung testweise verladen und wieder sperren.

= Sonstige Besonderheiten =
Es gibt keine weitere Besonderheit.

Aktualisierung HFMS (Tarifwerk)

2023-05-03T15:56:55Z

Sbaumbach:

In dieser Beschreibung finden Sie alle notwendigen Informationen, um das HFMS zu aktualisieren. Bitte lesen Sie sich diese Aufmerksam durch. Bei Rückfragen wenden Sie sich bitte direkt an den Support ([mailto:support@heidler-strichcode.de support@heidler-strichcode.de])

= Verzeichnisname / Dienstname =
Das HFMS wird in der Regel im Heidler Verzeichnis als "TarifWerk" installiert.

Die Benamung des Windowsdiensts entspricht dabei der Benamung des Installationsverzeichnisses.

Hinweis: Das Tarifwerk ist die Basis, welche mit diversen Plugins erweitert werden kann

= Kompatibilität =

* Grundsätzlich sind alle Versionen ab Tarifwerk Version 1.3.0 auf die neueste Version automatisch aktualisierbar
* Für Updates von Version < 1.8.0 ist eine Konvertierung der H2 Datenbank erforderlich.
** Der Installer erkennt dies automatisch
** Bitte folgen Sie hierzu den Anweisungen des Installers.
** Bitte planen Sie für dieses Update mehr Zeit als üblich ein (bis zu einer Stunde)
* Für Updates von Version < 1.3.0 muss zunächst auf die letzte Version von Tarifwerk 1.7.X aktualisiert werden
** Bitte erfragen Sie den Link zu dieser Version bei unserem Support
* Bitte beachten Sie, dass mit einem Update des Tarifwerks auch Updates aller Plugins erforderlich sein können.
** Bitte erfragen Sie deshalb auch immer nach aktuellsten Versionen von Ihren momentan installierten Plugins bei unserem Support

= Update Dauer / Downtime =
Eine Downtime ist erforderlich.

Bitte planen Sie für das Update mindestens 20 Minuten ein.

= Abhängigkeit zu anderen Heidler Applikationen =
Je nach Verwendetem Plugin kann eine relevante Abhängigkeit zu anderen Heidler-Applikationen vorliegen.

Beispielsweise wird das Plugin "SPM" zur Ermittlung des besten Versandart verwendet. Sollte das Update nicht erfolgreich sein, ist dies nicht mehr möglich und u.U. ist damit dann auch kein Versand mehr möglich.

= Was muss nach dem Update gemacht werden? =
Während der Aktualisierung wird automatisch der Windowsdienst beendet. Dieser wird nach dem ausführen des Setups nicht automatisch gestartet. Dies muss manuell erfolgen.

== Aktualisierungen von Plugins ==
Plugins aktualisieren Sie innerhalb des Tarifwerk-Konfigurators über den Menüpunkt Einstellungen -> Plugins.

Danach klicken Sie auf den Button "Plugin installieren".

Bitte wählen Sie dann die jeweilige Plugin Datei und klicken dann auf "Laden".

Daraufhin wird die Plugin-Datei auf Gültigkeit geprüft. Sollte alles OK sein, können Sie nun den Button "Installieren" drücken.

Nachdem Sie alle Plugins aktualisiert haben, beenden Sie bitte den Konfigurator und starten den Windows-Dienst neu.

== Wie prüfe ich, ob die Applikation nach dem Update ordnungsgemäß funktioniert? ==
Nachdem der Windowsdienst wieder gestartet worden ist, sollten zum einen die Logs vom Tarifwerk geprüft werden. Diese befinden sich im Hauptverzeichnis im Unterordner Logs.

'''tarifwerk.log''': In diesem Log kann der Start / Stopp vom Windowsdienst, Änderungen an der Datenbank, generelle Initialisierungs-Vorgänge, sowie Tarifanfragen nachvollzogen werden.

'''error.log''': In diesem Log findet man alle aufgetretenen Applikationsfehler

'''config.log''': In diesem Log findet man alle Vorgänge, welche über den Tarifwerk-Konfigurator ausgeführt wurden.

'''config_error.log''': In diesem Log findet man alle aufgetretenen Applikationsfehler des Tarifwerk-Konfigurators.

'''plugins.log''': In diesem Log findet man die Initialisierung der Plugins

Prüfen Sie im tarifwerk.log und im plugins.log, ob das Tarifwerk und die Plugins erfolgreich initialisiert werden konnten und ob Fehlermeldungen auftreten.

== Welche Tests sollte ich nach dem Update durchführen? ==
Nachdem der Dienst gestartet und die Logs geprüft worden sind, sollte man einen Testdatensatz verarbeiten.

Hierzu können Sie die Web-Oberfläche des Tarifwerks verwenden und eine Test-Gebührenermittlung durchführen.

= Sonstige Besonderheiten =
Es gibt keine weitere Besonderheit.

Aktualisierung HFMS (Tarifwerk)

2023-05-03T15:56:11Z

Sbaumbach:

In dieser Beschreibung finden Sie alle notwendigen Informationen, um das HFMS zu aktualisieren. Bitte lesen Sie sich diese Aufmerksam durch. Bei Rückfragen wenden Sie sich bitte direkt an den Support ([mailto:support@heidler-strichcode.de support@heidler-strichcode.de])

= Verzeichnisname / Dienstname =
Das HFMS wird in der Regel im Heidler Verzeichnis als "TarifWerk" installiert.

Die Benamung des Windowsdiensts entspricht dabei der Benamung des Installationsverzeichnisses.

Hinweis: Das Tarifwerk ist die Basis, welche mit diversen Plugins erweitert werden kann

= Kompatibilität =

* Grundsätzlich sind alle Versionen ab Tarifwerk Version 1.3.0 auf die neueste Version automatisch aktualisierbar
* Für Updates von Version < 1.8.0 ist eine Konvertierung der H2 Datenbank erforderlich.
** Der Installer erkennt dies automatisch
** Bitte folgen Sie hierzu den Anweisungen des Installers.
** Bitte planen Sie für dieses Update mehr Zeit als üblich ein (bis zu einer Stunde)
* Für Updates von Version < 1.3.0 muss zunächst auf die letzte Version von Tarifwerk 1.7.X aktualisiert werden
** Bitte erfragen Sie den Link zu dieser Version bei unserem Support
* Bitte beachten Sie, dass mit einem Update des Tarifwerks auch Updates aller Plugins erforderlich sein können.
** Bitte erfragen Sie deshalb auch immer nach aktuellsten Versionen von Ihren momentan installierten Plugins bei unserem Support

= Update Dauer / Downtime =
Eine Downtime ist erforderlich.

Bitte planen Sie für das Update mindestens 20 Minuten ein.

= Abhängigkeit zu anderen Heidler Applikationen =
Je nach Verwendetem Plugin kann eine relevante Abhängigkeit zu anderen Heidler-Applikationen vorliegen.

Beispielsweise wird das Plugin "SPM" zur Ermittlung des besten Versandart verwendet. Sollte das Update nicht erfolgreich sein, ist dies nicht mehr möglich und u.U. ist damit dann auch kein Versand mehr möglich.

= Was muss nach dem Update gemacht werden? =
Während der Aktualisierung wird automatisch der Windowsdienst beendet. Dieser wird nach dem ausführen des Setups nicht automatisch gestartet. Dies muss manuell erfolgen.

== Wie prüfe ich, ob die Applikation nach dem Update ordnungsgemäß funktioniert? ==
Nachdem der Windowsdienst wieder gestartet worden ist, sollten zum einen die Logs vom Tarifwerk geprüft werden. Diese befinden sich im Hauptverzeichnis im Unterordner Logs.

'''tarifwerk.log''': In diesem Log kann der Start / Stopp vom Windowsdienst, Änderungen an der Datenbank, generelle Initialisierungs-Vorgänge, sowie Tarifanfragen nachvollzogen werden.

'''error.log''': In diesem Log findet man alle aufgetretenen Applikationsfehler

'''config.log''': In diesem Log findet man alle Vorgänge, welche über den Tarifwerk-Konfigurator ausgeführt wurden.

'''config_error.log''': In diesem Log findet man alle aufgetretenen Applikationsfehler des Tarifwerk-Konfigurators.

'''plugins.log''': In diesem Log findet man die Initialisierung der Plugins

Prüfen Sie im tarifwerk.log und im plugins.log, ob das Tarifwerk und die Plugins erfolgreich initialisiert werden konnten und ob Fehlermeldungen auftreten.

== Welche Tests sollte ich nach dem Update durchführen? ==
Nachdem der Dienst gestartet und die Logs geprüft worden sind, sollte man einen Testdatensatz verarbeiten.

Hierzu können Sie die Web-Oberfläche des Tarifwerks verwenden und eine Test-Gebührenermittlung durchführen.

== Aktualisierungen von Plugins ==
Plugins aktualisieren Sie innerhalb des Tarifwerk-Konfigurators über den Menüpunkt Einstellungen -> Plugins.

Danach klicken Sie auf den Button "Plugin installieren".

Bitte wählen Sie dann die jeweilige Plugin Datei und klicken dann auf "Laden".

Daraufhin wird die Plugin-Datei auf Gültigkeit geprüft. Sollte alles OK sein, können Sie nun den Button "Installieren" drücken.

Nachdem Sie alle Plugins aktualisiert haben, beenden Sie bitte den Konfigurator und starten den Windows-Dienst neu.

= Sonstige Besonderheiten =
Es gibt keine weitere Besonderheit.

Aktualisierung HFMS (Tarifwerk)

2023-05-03T15:55:39Z

Sbaumbach: Die Seite wurde neu angelegt: „In dieser Beschreibung finden Sie alle notwendigen Informationen, um das HFMS zu aktualisieren. Bitte lesen Sie sich diese Aufmerksam durch. Bei Rückfragen we…“

In dieser Beschreibung finden Sie alle notwendigen Informationen, um das HFMS zu aktualisieren. Bitte lesen Sie sich diese Aufmerksam durch. Bei Rückfragen wenden Sie sich bitte direkt an den Support ([[Mailto:support@heidler-strichcode.de|support@heidler-strichcode.de]])

= Verzeichnisname / Dienstname =
Das HFMS wird in der Regel im Heidler Verzeichnis als "TarifWerk" installiert.

Die Benamung des Windowsdiensts entspricht dabei der Benamung des Installationsverzeichnisses.

Hinweis: Das Tarifwerk ist die Basis, welche mit diversen Plugins erweitert werden kann

= Kompatibilität =

* Grundsätzlich sind alle Versionen ab Tarifwerk Version 1.3.0 auf die neueste Version automatisch aktualisierbar
* Für Updates von Version < 1.8.0 ist eine Konvertierung der H2 Datenbank erforderlich.
** Der Installer erkennt dies automatisch
** Bitte folgen Sie hierzu den Anweisungen des Installers.
** Bitte planen Sie für dieses Update mehr Zeit als üblich ein (bis zu einer Stunde)
* Für Updates von Version < 1.3.0 muss zunächst auf die letzte Version von Tarifwerk 1.7.X aktualisiert werden
** Bitte erfragen Sie den Link zu dieser Version bei unserem Support
* Bitte beachten Sie, dass mit einem Update des Tarifwerks auch Updates aller Plugins erforderlich sein können.
** Bitte erfragen Sie deshalb auch immer nach aktuellsten Versionen von Ihren momentan installierten Plugins bei unserem Support

= Update Dauer / Downtime =
Eine Downtime ist erforderlich.

Bitte planen Sie für das Update mindestens 20 Minuten ein.

= Abhängigkeit zu anderen Heidler Applikationen =
Je nach Verwendetem Plugin kann eine relevante Abhängigkeit zu anderen Heidler-Applikationen vorliegen.

Beispielsweise wird das Plugin "SPM" zur Ermittlung des besten Versandart verwendet. Sollte das Update nicht erfolgreich sein, ist dies nicht mehr möglich und u.U. ist damit dann auch kein Versand mehr möglich.

= Was muss nach dem Update gemacht werden? =
Während der Aktualisierung wird automatisch der Windowsdienst beendet. Dieser wird nach dem ausführen des Setups nicht automatisch gestartet. Dies muss manuell erfolgen.

== Wie prüfe ich, ob die Applikation nach dem Update ordnungsgemäß funktioniert? ==
Nachdem der Windowsdienst wieder gestartet worden ist, sollten zum einen die Logs vom Tarifwerk geprüft werden. Diese befinden sich im Hauptverzeichnis im Unterordner Logs.

'''tarifwerk.log''': In diesem Log kann der Start / Stopp vom Windowsdienst, Änderungen an der Datenbank, generelle Initialisierungs-Vorgänge, sowie Tarifanfragen nachvollzogen werden.

'''error.log''': In diesem Log findet man alle aufgetretenen Applikationsfehler

'''config.log''': In diesem Log findet man alle Vorgänge, welche über den Tarifwerk-Konfigurator ausgeführt wurden.

'''config_error.log''': In diesem Log findet man alle aufgetretenen Applikationsfehler des Tarifwerk-Konfigurators.

'''plugins.log''': In diesem Log findet man die Initialisierung der Plugins

Prüfen Sie im tarifwerk.log und im plugins.log, ob das Tarifwerk und die Plugins erfolgreich initialisiert werden konnten und ob Fehlermeldungen auftreten.

== Welche Tests sollte ich nach dem Update durchführen? ==
Nachdem der Dienst gestartet und die Logs geprüft worden sind, sollte man einen Testdatensatz verarbeiten.

Hierzu können Sie die Web-Oberfläche des Tarifwerks verwenden und eine Test-Gebührenermittlung durchführen.

== Aktualisierungen von Plugins ==
Plugins aktualisieren Sie innerhalb des Tarifwerk-Konfigurators über den Menüpunkt Einstellungen -> Plugins.

Danach klicken Sie auf den Button "Plugin installieren".

Bitte wählen Sie dann die jeweilige Plugin Datei und klicken dann auf "Laden".

Daraufhin wird die Plugin-Datei auf Gültigkeit geprüft. Sollte alles OK sein, können Sie nun den Button "Installieren" drücken.

Nachdem Sie alle Plugins aktualisiert haben, beenden Sie bitte den Konfigurator und starten den Windows-Dienst neu.

= Sonstige Besonderheiten =
Es gibt keine weitere Besonderheit.

Aktualisierung HVS32DBArchivierung

2023-05-03T15:28:37Z

Sbaumbach:

In dieser Beschreibung finden Sie alle notwendigen Informationen, um einen HVS32 DB Archivierung (auch DBA genannt) zu aktualisieren. Bitte lesen Sie sich diese Aufmerksam durch. Bei Rückfragen wenden Sie sich bitte direkt an den Support ([mailto:support@heidler-strichcode.de support@heidler-strichcode.de])

= Verzeichnisname / Dienstname =
Die DBA wird in der Regel im Heidler Verzeichnis als HVS32DBService installiert.

Die Benamung des Windowsdiensts entspricht dabei der Benamung des Installationsverzeichnisses.

= Kompatibilität =

* Alles Versionen der DBA ab Version 3 können auf die neueste Version aktualisiert werden
* Für ältere Versionen kontaktieren Sie bitte unseren Support

= Update Dauer / Downtime =
Es ist keine Downtime notwendig.

Das Update kann in ca. 5 Minuten eingespielt werden.

= Abhängigkeit zu anderen Heidler Applikationen =
Es gibt keine direkten Abhängigkeiten zu anderen Heidler Applikationen, welche bei einem Update beachtet werden müssen.

= Was muss nach dem Update gemacht werden? =
Während der Aktualisierung wird automatisch der Windowsdienst beendet. Dieser wird nach dem ausführen des Setups nicht automatisch gestartet. Dies muss manuell erfolgen.

== Wie prüfe ich, ob die Applikation nach dem Update ordnungsgemäß funktioniert? ==
Nachdem der Windowsdienst wieder gestartet worden ist, sollten zum einen die Logs von der DBA geprüft werden. Diese befinden sich im Hauptverzeichnis im Unterordner Logs.

'''archive.log''': In diesem Log kann der Start / Stopp vom Windowsdienst, sowie der einzelnen Archivierungsschritte nachvollzogen werden.

'''error.log''': In diesem Log findet man alle aufgetretenen Applikationsfehler

Prüfen Sie in beiden Logs, ob die Module erfolgreich geladen werden konnten und ob Fehlermeldungen auftreten.

== Welche Tests sollte ich nach dem Update durchführen? ==
Nachdem der Dienst gestartet wurde, sollte im Log auf die nächste anstehende Archivierung hingewiesen werden.

Der Eintrag im Log sieht ungefähr so aus:
Archiving will begin on Sat Nov 26 17:30:00 CET 2022
Bitte prüfen Sie dann die Logs nach diesem im Log angegebenen Zeitpunkt auf Fehler, welche bei der Archivierung aufgetreten sind.

= Sonstige Besonderheiten =
Es gibt keine weitere Besonderheit.

Aktualisierung HVS32DBArchivierung

2023-05-03T15:27:41Z

Sbaumbach: Die Seite wurde neu angelegt: „In dieser Beschreibung finden Sie alle notwendigen Informationen, um einen HVS32 DB Archivierung (auch DBA genannt) zu aktualisieren. Bitte lesen Sie sich dies…“

In dieser Beschreibung finden Sie alle notwendigen Informationen, um einen HVS32 DB Archivierung (auch DBA genannt) zu aktualisieren. Bitte lesen Sie sich diese Aufmerksam durch. Bei Rückfragen wenden Sie sich bitte direkt an den Support ([[Mailto:support@heidler-strichcode.de|support@heidler-strichcode.de]])

= Verzeichnisname / Dienstname =
Die DBA wird in der Regel im Heidler Verzeichnis als HVS32DBService installiert.

Die Benamung des Windowsdiensts entspricht dabei der Benamung des Installationsverzeichnisses.

= Kompatibilität =

* Alles Versionen der DBA ab Version 3 können auf die neueste Version aktualisiert werden
* Für ältere Versionen kontaktieren Sie bitte unseren Support

= Update Dauer / Downtime =
Es ist keine Downtime notwendig.

Das Update kann in ca. 5 Minuten eingespielt werden.

= Abhängigkeit zu anderen Heidler Applikationen =
Es gibt keine direkten Abhängigkeiten zu anderen Heidler Applikationen, welche bei einem Update beachtet werden müssen.

= Was muss nach dem Update gemacht werden? =
Während der Aktualisierung wird automatisch der Windowsdienst beendet. Dieser wird nach dem ausführen des Setups nicht automatisch gestartet. Dies muss manuell erfolgen.

== Wie prüfe ich, ob die Applikation nach dem Update ordnungsgemäß funktioniert? ==
Nachdem der Windowsdienst wieder gestartet worden ist, sollten zum einen die Logs von der DBA geprüft werden. Diese befinden sich im Hauptverzeichnis im Unterordner Logs.

'''archive.log''': In diesem Log kann der Start / Stopp vom Windowsdienst, sowie der einzelnen Archivierungsschritte nachvollzogen werden.

'''error.log''': In diesem Log findet man alle aufgetretenen Applikationsfehler

Prüfen Sie in beiden Logs, ob die Module erfolgreich geladen werden konnten und ob Fehlermeldungen auftreten.

== Welche Tests sollte ich nach dem Update durchführen? ==
Nachdem der Dienst gestartet wurde, sollte im Log auf die nächste anstehende Archivierung hingewiesen werden.

Der Eintrag im Log sieht ungefähr so aus:
Archiving will begin on Sat Nov 26 17:30:00 CET 2022
Bitte prüfen Sie dann die Logs nach diesem im Log angegebenen Zeitpunkt auf Fehler, welche bei der Archivierung aufgetreten sind.

= Sonstige Besonderheiten =
Es gibt keine weitere Besonderheit.

IRIS Installation (Docker)

2023-04-26T07:47:16Z

Sbaumbach:

[[en:IRIS installation (Docker)]]
== Hinweise ==

=== IRIS Version ===
Im folgenden Text finden Sie viele Befehle, die die aktuelle Version von [[IRIS Cloudsystem|IRIS]] enthalten.

Bitte ersetzen Sie die Version durch die jeweils verfügbare aktuellste Version von IRIS.

Beispiel:
docker load -i iris-1.X.X.tar.gz
zu
docker load -i iris-1.0.18.tar.gz
bzw. die jeweils aktuellste Version

=== Docker auf Linux ===
Diese Beschreibung nimmt eine Installation von Docker auf Linux an.

Für andere Betriebssysteme müssen die Befehle oder Schritte entsprechend abgeändert werden.

Üblicherweise sind für Docker-Installationen auf Linux Admin-Berechtigungen erforderlich.

Die meisten Befehle benötigen deshalb ein "sudo" davor oder müssen als root User ausgeführt werden.

== Erstinstallation ==

=== Herunterladen / Kopieren von IRIS ===
Sie erhalten den Downloadlink für IRIS von unserem Support

Zum Hochladen des Container-Images können Sie die Datei per scp in das Home-Verzeichnis des Docker-Hosts hochladen:
scp iris-1.X.X.tar.gz <Benutzername>@<Servername>:~/

Alternativ direkt über den Downloadlink auf der Maschine herunterladen:
wget <Downloadlink>

=== IRIS Docker Image laden ===
docker load -i iris-1.X.X.tar.gz

=== Volumes und Netzwerke vorbereiten ===
docker volume create hsc-db

docker volume create hsc-config

=== Container aus Image erstellen ===
docker create --name iris --hostname iris --network bridge --publish 80:80 --publish 443:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X

=== Container starten ===
docker start iris

=== Logs des Containers prüfen ===
docker logs iris
In den Logs sollte ein Eintrag erscheinen, der so ähnlich lautet:<syntaxhighlight lang="text" line="1" start="1">
2023-02-08 17:22:38.926 -08 WARN [main] (init.ServiceInitializer:166) - A new user has been created.:
Username: root@localhost
Password: P6oV-GK3GYsdnn_5usDg1tBmn00
Please login with this user and change your password immediately!
</syntaxhighlight>Bitte notieren Sie sich diesen Benutzer + Passwort umgehend.

Sollte dieser Eintrag nicht erscheinen, warten Sie einen Moment und führen Sie den Befehl "docker logs iris" erneut aus.

=== Option 1: Eigenes SSL Zertifikat konfigurieren ===
Im Standard wird der Docker Container einen HTTPS Server mit selbst signiertem Zertifikat veröffentlichen.

Das muss noch durch ein öffentliches, durch eine anerkannte Zertifizierungsstelle ausgestelltes, Zertifikat ersetzt werden.

Sie benötigen hierzu folgende Dateien:
{| class="wikitable"
|+
!Datei
!Format
!Encoding
!Beschreibung
|-
|ca.pem
|[[wikipedia:X.509|X.509]]
|[[wikipedia:Privacy-Enhanced_Mail|PEM]]
|Das Zertifikat der anerkannten Zertifizierungsstelle
|-
|server-cert.pem
|[[wikipedia:X.509|X.509]]
|[[wikipedia:Privacy-Enhanced_Mail|PEM]]
|Das ausgestellte Zertifikat für Ihren Server
|-
|server-privatekey-pkcs8.pem
|[[wikipedia:PKCS_8|PKCS#8]]
|[[wikipedia:Privacy-Enhanced_Mail|PEM]]
|Der Private Key für Ihren Server
|}

Die Dateien platzieren Sie bitte mit dem o.g. Dateinamen unter folgendem Ordner aus Container-Sicht:

/etc/heidler/ssl/public

Dieses Verzeichnis wird über das Docker Volume "hsc-config" bereitgestellt.

Um herauszufinden, welchem Ordner auf der Host-Maschine das entspricht, können Sie folgenden Befehl verwenden:
docker volume inspect hsc-config

Unter dem Parameter "Mountpoint" finden Sie dann den lokalen Pfad.

Beispiel:

"Mountpoint": "/var/lib/docker/volumes/hsc-config/_data"

Dann wäre in diesem Beispiel der Pfad, wo die Dateien zu hinterlegen sind:

/var/lib/docker/volumes/hsc-config/_data/ssl/public

=== Option 2: Zertifikat mit Let's Encrypt™ generieren ===
Beachten: Durch das Verwenden dieser Option stimmen Sie den Terms of Service Let's Encrypt zu. Die TOS können hier eingesehen werden: https://letsencrypt.org/repository/

Das öffentliche HTTPS Zertifikat wird mithilfe des Tools certbot angefragt: https://certbot.eff.org/

Um diesen Dienst zu nutzen, fügen Sie einfach zwei Umgebungsvariablen hinzu, wenn Sie den Docker Container erstellen:
--env LETSENCRYPT=<Ihre öffentliche Domain> --env LETSENCRYPTEMAIL=<Ihre E-Mail Adresse für Benachrichtigungen für Ihr Zertifikat>
Gesamt-Beispiel:
docker create --name iris --hostname iris --network bridge --publish 80:80 --publish 443:443 --env LETSENCRYPT=iris.yourcompany.com --env LETSENCRYPTEMAIL=it@yourcompany.com --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X
Sie müssen natürlich die Werte in diesem Beispiel mit Ihrer Domain und Ihrer E-Mail Adresse ersetzen.

== Updates ==

=== Herunterladen / Kopieren von IRIS ===
Sie erhalten den Downloadlink für IRIS von unserem Support

Zum Hochladen des Container-Images können Sie die Datei per scp in das Home-Verzeichnis des Docker-Hosts hochladen:
scp iris-1.X.X.tar.gz <Benutzername>@<Servername>:~/

Alternativ direkt über den Downloadlink auf der Maschine herunterladen:
wget <Downloadlink>

=== Docker Image laden ===
docker load -i iris-1.X.X.tar.gz

=== IRIS stoppen ===
Achtung: Ab hier ist IRIS für ca. 1 Minute nicht erreichbar
docker stop iris

=== IRIS Container löschen ===
docker rm iris

=== Neuen IRIS Container mit neuer Version erstellen ===
docker create --name iris --hostname iris --network bridge --publish 80:80 --publish 443:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X

=== Container starten ===
docker start iris

=== Altes Container-Image entfernen ===
Achtung! Im folgenden Befehl die Version 1.X.X durch die vorherige (nicht aktuelle) Version von IRIS ersetzen
docker image rm iris:1.X.X