https://wiki.heidler-strichcode.de/w/api.php?action=feedcontributions&feedformat=atom&user=Bhauser
Wiki - Heidler Strichcode GmbH - Benutzerbeiträge [de]
2026-05-02T09:21:52Z
Benutzerbeiträge
MediaWiki 1.35.2
https://wiki.heidler-strichcode.de/w/index.php?title=Schnittstellen:_Security_Levels_und_Authentifizierung&diff=6132
Schnittstellen: Security Levels und Authentifizierung
2025-07-17T13:15:52Z
<p>Bhauser: /* Authentifizierung */</p>
<hr />
<div>[[en:Interfaces:_Security_Levels_and_Authentication]]<br />
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.<br>Wenn das Versandsystem HVS32 allerdings öffentlich erreichbar sein muss - also sich das Vorsystem (ERP/WMS) und das Versandsystem HVS32 nicht im gleichen Netzwerk (LAN, vLAN, vNET, private cloud) befinden - muss die Kommunikations-Verbindung der beiden Systeme abgesichert werden.<br>Dies impliziert, dass sowohl die Verbindung verschlüsselt als auch jede eingehende Verbindung authentifiziert werden muss.<br />
<br />
=Security Levels (Infrastruktur)=<br />
Zur Absicherung der Netzwerk-Brücke gibt es keine zu 100% perfekte oder sichere Lösung. Meist muss man sich für einen Kompromiss je nach Fall entscheiden. In der Infrastruktur können jedoch bereits diverse Security Levels implementiert werden, um die Sicherheit maßgeblich zu erhöhen.<br />
==LAN / vLAN / vNET / private cloud / VPN==<br />
Befinden sich die beiden Server in einem gemeinsamen Netzwerk, bzw. liegt eine gesicherte Netzwerk-Brücke via VPN zu Grunde, bietet dies grundlegend die beste Basis für eine sichere Datenkommunikation zwischen dem Vorsystem und dem Versandsystem HVS32.<br>[[Datei:Securitylevel infrastructure vpn.png|1000px|rahmenlos|Security Level (Infrastruktur) - LAN / vLAN / vNET / private cloud / VPN]]<br><br><br />
<br />
==S2S (Server-to-Server)==<br />
Bei einer ungesicherten Netzwerk-Brücke ist unbedingt darauf zu achten, dass die Kommunikation ausschließlich verschlüsselt und authentifiziert stattfindet.<br />
[[Datei:Securitylevel infrastructure s2s.png|1000px|rahmenlos|Security Level (Infrastruktur) - S2S (Server-to-Server)]]<br />
==Dead-End-Server==<br />
Da alle Verbindungen zum DGS (DataGatewayServer - Kommunikations-/Schnittstellen-Software) eingehend sind, kann als zusätzliche Sicherheitsmaßnahme der DGS auf einem separaten Server installiert werden, bei welchem alle ausgehenden Verbindungen via Firewall blockiert werden.<br />
[[Datei:Securitylevel infrastructure des.png|1000px|rahmenlos|Security Level (Infrastruktur) - Dead-End-Server]]<br />
<br />
=Authentifizierung=<br />
Authentifizierungs-Mechanismen können nur als "sicher" bezeichnet werden, wenn diese in Kombination mit anderen Sicherheits-Mechanismen wie HTTPS/SSL genutzt werden. Die Verschlüsselung ist mittels HTTPS unter Verwendung von TLSv1.2 oder TLSv1.3 (sofern vom Client unterstützt) möglich.<br />
<br />
Für die Verschlüsselung wird jeweils ein Zertifikat mit zugehörigem Private Key benötigt. Die folgenden Zertifikatsformate werden unterstützt:<br />
<br />
* '''Zertifikate:''' *.crt, *.cer, *.pem, *.der oder *.p7b<br />
* '''Private Key:''' *.der, *.pem, oder *.ssh (OpenSSH)<br><br />
<br />
'''Alternativ kann auch ein PFX im DGS importiert werden - das Zertifikat und der Private-Key werden dabei aus dem PFX extrahiert. Bitte stellen Sie sicher, dass falls vorhanden die Zertifikatskette vollständig im Zertifikat (bzw. PFX) hinterlegt ist (wenn der Client dies erfordert)'''<br><br><br />
Die folgenden Authentifizierungs-Optionen beziehen sich '''ausschließlich''' auf die [https://interface.heidler-strichcode.de?version=v2 RESTv2 Schnittstelle]<br />
<br>Es wird '''mindestens''' die DataGatewayServer Version '''3.8.44''' benötigt.<br />
==Basic Authentication==<br />
Die Basisauthentifizierung ist ein einfaches Authentifizierungsschema, welches in das HTTP-Protokoll integriert ist. Der Client sendet in jeder HTTP-Anfrage den Authentifizierungsheader, welcher Benutzername und Passwort enthält.<br />
<br />
Der Authentifizierungsheader lautet '''Authorization''' und beinhaltet den Benutzer und das Passwort Base64 codiert im Format ''- Basic <Benutzer>:<Passwort>''.<br />
<br />
<br />
<br />
Die Benutzerverwaltung erfolgt im DataGatewayServer. Dort können neue Benutzer angelegt und gelöscht werden.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen Benutzern steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für eine Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In diesem Beispiel wird der Benutzer ''heidler'' mit dem Passwort ''Wolfschlugen'' verwendet.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Authorization: Basic aGVpZGxlcjpXb2xmc2NobHVnZW4=<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung - 401 Unauthorized</div><br />
<div class="mw-collapsible-content"><br />
Sollte die Authentifizierung aufgrund von ungültigen Benutzerdaten fehlschlagen, so wird der HTTP-Code '''401 Unauthorized''' mit der Fehlermeldung ''"Unauthorized acces"'' im Body quittiert.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Www-authenticate: Basic realm="Restricted Area"<br />
Date: Mon, 26 Feb 2024 09:00:44 GMT<br />
Content-type: application/json<br />
Content-length: 19<br />
<br />
Unauthorized access<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==Digest Access Authentication==<br />
HTTP Digest Access Authentication ist ein Authentifizierungsmechanismus, der in das HTTP-Protokoll integriert ist und dazu dient, die Sicherheit von Webanwendungen zu erhöhen. Im Gegensatz zur einfachen Basisauthentifizierung überträgt Digest Access Authentication keine Benutzernamen und Passwörter im Klartext, sondern verwendet kryptografisch sichere Methoden.<br><br />
<br />
Bei der Digest-Authentifizierung sendet der Client eine Anfrage an den Server (ohne Authentifizierung im Header), der daraufhin eine "Nonce" (eine einmalige Zufallszahl) zurückgibt. Alternativ kann diese über den Enpoint ''v2/hsc/auth/digest'' abgerufen werden. Der Client kombiniert diese Nonce mit Benutzername, Passwort, Anfrage-Methode und URI und erstellt einen "Digest" (Prüfzusammenstellung). Dieser Digest wird dann an den Server gesendet.<br>Der Server kann den Digest überprüfen, indem er denselben Algorithmus auf der Serverseite anwendet und die berechneten Werte vergleicht. Da der Digest mit Hilfe der Nonce und kryptografisch sicheren Techniken erstellt wird, schützt die Digest-Authentifizierung effektiv vor Angriffen wie Passwortdiebstahl und Mann-in-the-Middle-Angriffen (MitM).<br />
<br />
Für die Erstellung vom Digest wird aktuell nur der Algorithmus MD5 unterstützt. Weitere Algorithmusverfahren können nach Rücksprache implementiert werden.<br />
<br />
<br />
<br />
Die Benutzerverwaltung erfolgt im DataGatewayServer. Dort können neue Benutzer angelegt und gelöscht werden.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen Benutzern steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Anfrage einer nonce für die Erstellung des Digest</div><br />
<div class="mw-collapsible-content"><br />
In der initialen Anfrage wird im Header keine Authentifizierung geliefert, da vom Server zuerst die nonce abgefragt werden muss. In der Rückmeldung vom DataGatewayServer befindet sich dann die '''nonce''' zusammen mit weiteren Informationen, welche für die Erstellung eines Digest benötigt werden, im HTTP-Header '''Www-authenticate'''.<br><br />
<br />
Diese Anfrage wird mit dem HTTP-Code '''401 Unauthorized''' und der Fehlermeldung ''"Authentication required!"'' im Body quittiert.<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Www-authenticate: Digest realm="Restricted Area",qop="auth",nonce="079ae550-11c1-40bf-9ee9-7cce5f1dd70e",opaque="opaque"<br />
Date: Mon, 26 Feb 2024 10:21:41 GMT<br />
Content-type: application/json<br />
Content-length: 24<br />
<br />
Authentication required!<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Anfrage nach erhaltener nonce</div><br />
<div class="mw-collapsible-content"><br />
Nachdem der Client die '''nonce, realm, qop und die opaque''' aus der initialen Anfrage extrahiert und damit den Digest generiert hat, kann dieser für die Authentifizierung über den HTTP-Header '''Authorization''' übermittelt werden.<br />
<br />
Das Format entspricht dabei:<br>''Digest username="<BENUTZERNAME>", realm="<REALM>", nonce="<NONCE>", uri="<ENDPOINT>", algorithm="MD5", qop=<QOP>, nc=<NC>, cnonce="<CNONCE>", response="<DIGEST>", opaque="<OPAQUE>"''<br><br>Der Parameter '''nc''' = "Nonce count" und '''cnonce''' = "Client nonce" wird jeweils vom Client generiert und muss für die Erstellung vom Digest genutzt werden.<br />
<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Cache-Control: no-cache<br />
Authorization: Digest username="<BENUTZER>", realm="Restricted Area", nonce="079ae550-11c1-40bf-9ee9-7cce5f1dd70e", uri="<ENDPOINT>", algorithm="MD5", qop=auth, nc=00000001, cnonce="PoYGQC6K", response="ce3fb921e353290142e34ac886694a4c", opaque="opaque"<br />
</syntaxhighlight><br />
</div></div><br />
<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung</div><br />
<div class="mw-collapsible-content"><br />
Bei einer ungültigen Authentifizierung (Verwendung vom HTTP-Header '''Authorization''') wird der HTTP-Code '''401 Unauthorized''' mit der Fehlermeldung ''"client credentials invalid!"'' im Body zurück gemeldet.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 10:45:40 GMT<br />
Content-type: application/json<br />
Content-length: 27<br />
<br />
client credentials invalid!<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==API Keys==<br />
Die API-Key-Authentifizierung ist eine einfache Methode zur Sicherung von API-Zugriffen. Bei dieser Authentifizierungsmethode erhält der Benutzer / Client einmalig einen eindeutigen API-Schlüssel (API-Key). Dieser Schlüssel muss dann bei jeder API-Anfrage im Header mit gesendet werden.<br>Der Server überprüft den empfangenen API-Key, um sicherzustellen, dass die Anfrage von einem authentifizierten Benutzer oder Anwendung stammt.<br><br />
<br />
Der API-Key muss sicher aufbewahrt werden, um unbefugten Zugriff zu verhindern. Außerdem ist es wichtig, diesen regelmäßig zu zu aktualisieren, um die Sicherheit zu gewährleisten.<br />
<br />
<br />
<br />
Der API-Key wird im DataGatewayServer verwaltet. Dort kann ein neuer Key generiert oder bestehende gelöscht werden. Es können mehrere gültige API-Keys existieren.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen API-Keys steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für eine Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In diesem Beispiel wird der API-Key ''apikey_heidler'' verwendet.<br />
<br />
'''Hinweis:''' Aus demonstrationszwecken wird in dem Beispiel ein einfacher API-Key verwendet. Der DataGatewayServer erzeugt einen entsprechend langen und komplexen Key.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
x-api-key: apikey_heidler<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung</div><br />
<div class="mw-collapsible-content"><br />
Bei einem falschen API-Key wird der HTTP-Code '''401 Unauthorized''' mit der Fehlermeldung ''"api key invalid!"'' im Body zurück gemeldet.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 09:46:30 GMT<br />
Content-type: application/json<br />
Content-length: 16<br />
<br />
api key invalid!<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==OAuth 2.0==<br />
===Client Credentials===<br />
OAuth 2.0 Client Credentials ist eine Authentifizierungs-Methode im OAuth 2.0-Protokoll, die es einer Anwendung ermöglicht, sich beim Authorization Server (Authentifizierungsserver) zu authentifizieren. Dies ist besonders nützlich für den Zugriff von Anwendungen auf APIs ohne Benutzerbeteiligung und eignet sich gut für server-seitige Kommunikation zwischen Diensten.<br />
<br />
<br>Das ERP wird am Server registriert und erhält eine eindeutige Client-ID und ein Client-Secret.<br>Inital wird dann von dem ERP eine HTTP-POST-Anfrage an den Authorization Server gesendet, welche die Client-Anmeldeinformationen (Client-ID und Client-Secret) beinhaltet. Im Response wird ein Access-Token und ein Refresh-Token zurück gemeldet.<br>Das ERP sendet nun für die Authentifizierung bei jeder Anfrage das Access-Token im Authorization Header der HTTP-Anfragen mit. Wenn das Access-Token abgelaufen ist, kann mit dem Refresh-Token ein neuer Access-Token angefragt werden. Im Falle einer mehrfachen Nutzung eines Refresh-Tokens werden automatisch alle Refresh-Tokens und Access-Tokens gesperrt.<br>Das Client-Secret muss sicher aufbewahrt werden, um unbefugten Zugriff zu verhindern. Außerdem ist es wichtig, das Client Secret regelmäßig zu zu aktualisieren, um die Sicherheit weiter zu erhöhen.<br />
<br />
<br />
<br />
Die Client-ID und Client-Secret werden im DataGatewayServer verwaltet. Dort können neue Zugangsdaten angelegt oder bestehende gelöscht werden.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen Client-IDs steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br><br>Bei der initialen Tokenanfrage stehen verschiedene zwei Möglichkeiten zum Abrufen bereit.<br />
<br />
Zum einen kann man die Token über die Authorization Basic anfragen, bei welchem die ClientID + ClientSecret im HTTP-Header mitgegeben werden.<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispiel für die Token-Anfrage (Access- und Refreshtoken mit Client-ID + Client-Secret generieren)</div><br />
<div class="mw-collapsible-content"><br />
Bei der Token-Anfrage muss die Client-ID und das Client-Secret im HTTP-Header '''Authorization''' Base64 codiert im Format - ''Basic <ClientID>:<ClientSecret>'' übermittelt werden. Zusätzlich ist für diese Funktion der '''grant_type''' mit dem Wert ''client_credentials'' notwendig.<br />
<syntaxhighlight lang="http"><br />
POST /v2/hsc/auth/token HTTP/1.1<br />
Accept: application/json<br />
Authorization: Basic <ClientID>:<ClientSecret><br />
grant_type: client_credentials<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br>Eine weitere Variante die Token abzurufen ist über einen JWT. Bei dieser Methode wird die ClientID im Payload vom JWT übermittelt und das JWT selbst mit dem ClientSecret signiert. Diese Möglichkeit bietet eine zusätzliche Sicherheit, da dass ClientSecret selbst nie exposed wird.<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispiel für die Token-Anfrage (Access- und Refreshtoken über JWT generieren)</div><br />
<div class="mw-collapsible-content"><br />
Bei der Token-Anfrage '''JWT (jwt-bearer)''' muss die Client-ID und das Client-Secret in einem JWT übermittelt werden. Dabei wird die '''ClientID''' im JWT Payload als "sub" übermittelt und mit dem ClientSecret signiert. Das JWT wird Im HTTP-Header als ''client_assertion'' übermittelt. Die Anfrage über das JWT erfolgt über den HTTP-Header ''client_assertion_type''.<br />
<br />
Zusätzlich ist für diese Funktion der '''grant_type''' mit dem Wert ''client_credentials'' notwendig.<br />
<br />
In diesem Beispiel wurde die '''ClientID''' - ''huF3sPp5g5zUXP70bQ3O'' - verwendet.<br />
<br />
Das '''ClientSecret''' lautet - ''yX2[K2DC*CjvUI3Us!eCrM@B%5OHJ@U5JCw+)Jv1b+3@1f[?YOw]mxmc(Aes)K5N''<br />
<syntaxhighlight lang="http"><br />
POST /v2/hsc/auth/token HTTP/1.1<br />
Accept: application/json<br />
client_assertion_type: jwt-bearer<br />
client_assertion: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJodUYzc1BwNWc1elVYUDcwYlEzTyIsIm5hbWUiOiJIZWlkbGVyIFN0cmljaGNvZGUgR21iSCBURVNUIiwiaWF0IjoxODE2MjM5MDIyfQ.xKwD4wnQud55LVqvs47Sy0jKhpbxb0JVZtgMWWbjNKo<br />
grant_type: client_credentials<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung der Token-Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In der Rückmeldung der Token-Anfrage wird im Body der Accesstoken (access_token), der Refreshtoken (refresh_token), der Tokentyp (token_type) und Gültigkeit vom Accesstoken in Sekunden (expires_in) zurück gemeldet.<br />
<br />
Der Accesstoken kann nun für die Authentifizierung in den restlichen Anfragen genutzt werden.<br />
<br />
<br />
Der Accesstoken hat aus Sicherheitsgründen eine begrenzte Gültigkeit. Nach Ablauf ist der Accesstoken nicht mehr verwendbar und man erhält einen HTTP-Code '''401 Unauthorized'''. In diesem Fall muss über die Refresh-Anfrage und einem gültigen Refreshtoken ein neuer Accesstoken generiert werden (empfohlen) oder über die Token-Anfrage und der Client-ID + Client-Secret ein neues Accesstoken angefragt werden (nicht empfohlen).<br />
<br />
'''Hinweis:''' Die regelmäßige Generierung von Accesstoken über die Token-Anfrage wird nicht empfohlen, da hier die Client-ID + Client-Secret übertragen wird. Dadurch ist die Anfälligkeit gegen MitM-Angriffen höher. Das Client-Secret sollte so selten wie möglich eingesetzt werden. <br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 200 OK<br />
Date: Mon, 26 Feb 2024 12:06:32 GMT<br />
Content-type: application/json<br />
Content-length: 711<br />
Cache-control: no-cache<br />
<br />
{<br />
"access_token": "eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk3OTIsImp0aSI6ImM0ZDFkNTdiLWUzZTAtNDkwOC1hMDk4LWJiMjc2NmZmODdiMSIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.4zrctPAnBAlMj9CFUL6jQ33Gkou3V_bmcLBUrEsUKL0",<br />
"refresh_token": "eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMxOTIsImp0aSI6IjEwMGZmN2JiLTQ1MzItNDFlNi05NTZjLTBjZjE0YWIzYTljNCIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.vAPo2Zobu2BNGNrUvmxKd5RVGWIn91sT83js33n2UUA",<br />
"token_type": "Bearer",<br />
"expires_in": 600<br />
}<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für die Nutzung eines Accesstokens</div><br />
<div class="mw-collapsible-content"><br />
Der aus der Token-Anfrage erhaltene Accesstoken kann nun im HTTP-Header '''Authorization''' an den DataGatewayServer übermittelt werden, um sich zu authentifizieren. Dieser muss im Format - ''Bearer <Accesstoken>'' übertragen werden.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Authorization: Bearer eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk3OTIsImp0aSI6ImM0ZDFkNTdiLWUzZTAtNDkwOC1hMDk4LWJiMjc2NmZmODdiMSIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.4zrctPAnBAlMj9CFUL6jQ33Gkou3V_bmcLBUrEsUKL0<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für die Refresh-Anfrage (Access- und Refreshtoken mit gültigem Refreshtoken erneuern)</div><br />
<div class="mw-collapsible-content"><br />
Falls ein Accesstoken abgelaufen ist und dieser erneut werden muss, kann über die Refresh-Anfrage und einem gültigen Refreshtoken ein neuer Accesstoken + Refreshtoken generiert werden. In dieser Anfrage muss der HTTP-Header '''refresh_token''' mit dem Refreshtoken und der Header '''grant_type''' mit dem Wert ''refresh_token'' übermittelt werden.<br />
<br />
Um die Sicherheit vor MitM-Angriffen zu erhöhen, empfiehlt es sich den Accesstoken regelmäßig und im kurzen intervall zu aktualisieren.<br />
<br />
'''Hinweis:''' Ein Refreshtoken kann nur einmalig für die Refreshanfrage genutzt werden. Anschließend verliert der Token seine Gültigkeit. Falls ein ungültiger Refreshtoken für die Authentifizierung beim DataGatewayServer genutzt wird, werden aus Sicherheitsgründen alle gültigen Access- und Refreshtoken deaktiviert. Die Authentifizierung muss in diesem Fall wieder über die Token-Anfrage stattfinden.<br />
<syntaxhighlight lang="http"><br />
POST /v2/hsc/auth/refresh HTTP/1.1<br />
Accept: application/json<br />
refresh_token: eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMxOTIsImp0aSI6IjEwMGZmN2JiLTQ1MzItNDFlNi05NTZjLTBjZjE0YWIzYTljNCIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.vAPo2Zobu2BNGNrUvmxKd5RVGWIn91sT83js33n2UUA<br />
grant_type: refresh_token<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung der Refresh-Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In der Rückmeldung der Refresh-Anfrage wird im Body der Accesstoken (access_token), der Refreshtoken (refresh_token), der Tokentyp (token_type) und Gültigkeit vom Accesstoken (expires_in) in Sekunden zurück gemeldet.<br />
<br />
Der Accesstoken kann nun für die Authentifizierung in den restlichen Anfragen genutzt werden.<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 200 OK<br />
Date: Mon, 26 Feb 2024 12:06:43 GMT<br />
Content-type: application/json<br />
Content-length: 711<br />
<br />
{<br />
"access_token": "eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk4MDMsImp0aSI6ImJmYjgyZWE0LTU2NmEtNDc3ZS04NDRjLWRkM2VhYWZmZjQ1ZSIsInV1SUQiOiI0ZmY5ZThhNC01YTY2LTQ0ZDQtYjY4Zi1jNjlmMzFiOTNiYjciLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkyMDN9.vMoedyTSnfWXYXbGPZTX-nfhfNUAvp2upQJ3pTU-u_k",<br />
"refresh_token": "eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMyMDMsImp0aSI6IjI5MTc0NzBkLTNjYTUtNGZiMC1hZDliLThjNjkxYWVjNDYzOSIsInV1SUQiOiI0ZmY5ZThhNC01YTY2LTQ0ZDQtYjY4Zi1jNjlmMzFiOTNiYjciLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkyMDN9.DonI4KsNiTuG6pb705U3QIT7tNnU0pmDS7Tp6UZWHVk",<br />
"token_type": "Bearer",<br />
"expires_in": 600<br />
}<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung - 401 Unauthorized</div><br />
<div class="mw-collapsible-content"><br />
Sollte die Authentifizierung fehlschlagen, so wird der HTTP-Code 401 Unauthorized mit einer entsprechenden Fehlermeldung im Body quittiert.<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 12:38:59 GMT<br />
Content-type: application/json<br />
Content-length: <LÄNGE><br />
<br />
<FEHLERMELDUNG><br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<br />
==Client Credentials im DGS verwalten==<br />
Die Client Credentials werden im DataGatewayServer verwaltet. Dort können neue Zugangsdaten angelegt oder bestehende gelöscht werden.<br><br />
Dazu muss im Installationsverzeichnis des DataGatewayServer der Credentials-Configurator(.exe) gestartet werden.<br />
===Config===<br />
[[Datei:Authorization Credentials 001.png|mini|rechts|Credentials Configurator - config]]<br />
Hier können allgemeine Konfigurationen vorgenommen werden.<br />
* '''check invalid logins'''<br>Wenn diese Option aktiv ist, wird die Anzahl der ungültigen Authentifizierungen gezählt und nach '''max invalid logins''' innerhalb von '''timespan in seconds''' werden alle Credentials gesperrt<br />
* '''execute CODE RED for OAuth2.0 CC'''<br>Wenn diese Option bei der Nutzung von OAuth2.0 CC aktiv ist, wird bei mehrfachen verwenden eines REFRESH TOKENS ein '''CODE RED''' ausgelöst. Hierbei werden alle ACCESS und REFRESH TOKENS deaktiviert und es müssen neue Tokens via Client Credentials angefordert werden. Zusätzlich kann im DGS Konfigurator das Versenden einer E-Mail bei einem CODE RED konfiguriert werden.<br />
* '''Lock Credentials / Unlock credentials'''<br>Über diesen Button können alle Credentials gesperrt oder entsperrt werden. Wenn z.b. durch die Option '''check invalid logins''' alle Client Credentials gesperrt wurden, können diese somit wieder entsperrt werden. Diese Option greift sofort, ohne speichern.<br />
* Save<br>Mit diesem Button werden die Einstellungen und Credentials persistent gespeichert. Erst nach dem Speichern werden die Optionen und Credentials aktiv. Ein DGS Neustart ist nicht notwendig.<br />
===Credentials verwalten===<br />
[[Datei:Authorization Credentials 002.png|mini|rechts|Credentials Configurator - OAuth2.0 CC]]<br />
[[Datei:Authorization Credentials 003.png|mini|rechts|Enter Username / ClientID]]<br />
[[Datei:Authorization Credentials 004.png|mini|rechts|Show Credentials Dialog]]<br />
Um Ihre Credentials zu verwalten, wählen Sie den passenden Reiter zu Ihrer im DGS konfigurierten Authentifizierungs-Methode (z.B. OAuth2.0 CC)<br />
* '''add'''<br>Hier können Sie neue Credentials anlegen. Beachten Sie, dass das Passwort bzw. das Client-Secret nur einmalig in einem Dialog angezeigt wird. Kopieren Sie es daher in einen sicheren Platz und stellen Sie sicher, dass keine unautorisierten Personen darauf Zugriff haben.<br />
* '''change secret''' bzw. '''change password'''<br>Hier können Sie ein neues Passwort bzw. Client Secret vergeben. Wie bei der add Funktion, wird das Passwort bzw. das Client-Secret nur einmalig in einem Dialog angezeigt.<br />
* '''remove'''<br>Hier können Sie die die ausgewählten Credentials entfernen.</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager(en)&diff=6111
HVS32 Communication Manager(en)
2025-03-19T10:59:29Z
<p>Bhauser: /* SMTP */</p>
<hr />
<div>[[de:HVS32_Communication_Manager]]<br />
The Communication Manager (hereafter abbreviated as ComManager) is a service that centrally manages communication between HVS32 and customers or HVS32 and carriers. The ComManager is designed for communications via FTP, SFTP, or SMTP protocols.<br />
<br />
Similar to WinSCP, this service is controlled by HVS32 and sends data to the destination server configured in the module.<br />
<br />
It is intended to gradually take over communications from HVS32 and replace other external transmission programs such as WinSCP.<br />
<br />
=ComManager Configuration=<br />
The ComManager Configurator can be accessed either directly through the ''ComManager-Configurator.exe'' in the installation directory ''...Heidler\HVS32\ComManager\'' or from the [[Setting up Communication Manager in HVS32|HVS32 Configurator]].<br />
<br />
[[Datei:ComManager-Main Window EN.png|500px|thumb|ohne|ComManager main window]]<br />
<br />
;1 - Link to this wiki entry<br />
;2 - Selection Tabs<br />
:'''[[HVS32_Communication_Manager(en)#Modules|Modules]]''' - Modules for file transmission during daily closing, Wawi return, and route downloads<br />
:'''[[HVS32_Communication_Manager(en)#Servers|Servers]]''' - Internal communication servers such as Microsoft Exchange (SMTP) connections<br />
:'''[[HVS32_Communication_Manager(en)#Proxies|Proxy]]''' - Internal proxy servers<br />
;3 - Overview of configured modules<br />
;4 - Summary of the configuration of the selected module<br />
;5 - [[HVS32_Communication_Manager(en)#Configure_ErrorHandler|Errorhandler Configuration]]<br />
;6 - [[HVS32_Communication_Manager(en)#Service_Settings|Service Settings]]<br />
<br />
==Service Settings==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|In this section, the basic settings of the ComManager service are configured, which are necessary to establish a connection to the service. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
<span style="color:#C00000">'''Warning: The configurations you make here will be applied only after restarting the ComManager service!'''</span><br />
<br />
;HVS32 Main Directory: <br />
:Specify the path to HVS32 here<br />
;HVS32 Database File:<br />
:Specify the path to the HVS32 database file<br />
;HVS32 Database Server:<br />
:IP address or hostname of the PC where the database is located<br />
;HVS32 Database Port:<br />
:The port for the HVS32 database usually does not need adjustment. The default port is set to 3050.<br />
;REST Port<br />
:Communication port through which the ComManager service is accessible via REST. This port must be opened in the server's firewall for external communication with the clients.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Configuration Window of Service Settings]]<br />
|}<br />
<br />
==Configure ErrorHandler==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|If an ErrorHandler is configured, you will be notified by email in case of a failed transmission. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
;Mode<br />
:First of all, you have to choose wich mode you want to use to send error mails<br />
<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
To send the error mails via SMTP choose the mode "SMTP" and enter the following parameters:<br />
;SMTP Server<br />
:IP address or hostname where the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and enable authentication.<br />
;SMTP Port<br />
:Port at which the SMTP server is accessible (25, 465, 587)<br />
;SSL enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS enabled<br />
:Data sent will be encrypted via Transport Layer Security, provided the SMTP server supports it.<br />
;TLS required<br />
:The server is requested to provide TLS support.<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
<br />
<br><br />
<br><br />
<br />
===O365===<br />
To send the error mails via Microsoft Office365 choose the mode "O365" and enter the following parameters:<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure ([[#Microsoft_Azure_configuration_for_Microsoft_Office365_.28O365.29_support|see '''Azure configuration''']])<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br><br />
<br><br />
<br />
===General===<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and will be displayed as the sender address for emails sent through this module.<br />
;Subject<br />
:This text will be used as the subject when sending the emails.<br />
<br />
;Test<br />
:You can use this option to send a test message to verify the configured parameters.<br />
<br />
<br />
<br />
|}<br />
<br />
==Modules==<br />
[[File:ComManager_Modules_EN.png|360px|thumb|right|Modules]]<br />
;1 - Overview of configured modules<br />
:'''Module ID''' - Selection and assignment of the module in HVS32 is done through this ID<br />
:'''Module Type''' - Type/category of module; the abbreviation "U" / "D" in parentheses indicates whether it is a '''D'''ownload (e.g., route download) or '''U'''pload module (FFFile, Wawi return, etc.)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will cause errors in process handling.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, it will cause errors in process handling.<br />
;3 - Summary of the configuration of the selected server<br />
<br />
[[File:ComManager_AddModul.png|340px|thumb|right|Add Module]]<br />
;Add / configure module<br />
Communication between HVS32 and the specified server occurs through modules. Such a server can be either a separate [[HVS32_Communication_Manager(en)#Server|(SMTP) server]] or directly the carrier's or customer's server.<br />
<br />
After selecting the module type (FTP, SFTP, SMTP, PLD/UPS, HTTP), the configuration of the new module takes place. In the following dialog, you can adjust the corresponding parameters.<br />
<br />
;Module Type<br />
:'''Carrier Module''' - Standard choice for uploading FF files during daily closing<br />
:'''Additional Transmission''' - Customer-specific transmission of, for example, Wawi return files to a customer's server<br />
:'''Download''' - Special module type for downloading, e.g., route files<br />
;Module ID<br />
:An automatically generated ID for the selection and assignment of the module in HVS32<br />
;Carrier<br />
:Additional restriction of the module for the use of specific carrier modules in HVS32 (exclusively for FF file transmission)<br />
;Principal<br />
:Additional restriction of the module for the use of specific principals/clients in HVS32 (exclusively for FF file transmission)<br />
;Note<br />
:Optional note for better overview (displayed in the overview and in HVS32)<br />
<br />
===Configure FTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;FTP Server: <br />
:IP address or hostname of the server<br />
;FTP Port: <br />
:Port at which the server is accessible (Default port 21) <br />
;FTP User<br />
:Username for authentication on the FTP server <br />
;FTP Password<br />
:Password for authentication on the FTP server <br />
;FTP Account<br />
:FTP account for authentication on the FTP server<br />
;FTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the FTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "FTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;FTP Transfer Mode<br />
:Specify whether the data should be transferred as binary or text.<br />
;FTP Security <br />
:;FTPS <br />
::FTP over Secure Socket Layer (SSL) implicitly<br />
:;FTPES: <br />
::FTP over Secure Socket Layer (SSL) explicitly. (Here, the server can allow insecure connections as well)<br />
;FTP Connection<br />
:Choose the method for establishing the connection. PASSIVE should be chosen by default.<br />
;Proxy: <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the FTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_FTPModulConf.png|thumb|right|FTP Upload Module Configuration]]<br />
[[File:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SFTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SFTP Server <br />
:IP address or hostname of the server<br />
;SFTP Port<br />
:Port at which the server is accessible (Default port 22)<br />
;SFTP User<br />
:Username for authentication on the SFTP server <br />
;SFTP Password<br />
:Password for authentication on the SFTP server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:If you are using a private key, you can specify the path to the file here.<br />
;Passphrase<br />
:Enter your passphrase here to decrypt the file mentioned above<br />
;SFTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the SFTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "SFTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;Timeout (ms)<br />
:Time in milliseconds that the connection setup and individual communication steps can take at most (standard 30000ms).<br />
:In the configuration dialog itself, a timeout of 5000ms is used regardless of the setting to test the connection more quickly.<br />
;Proxy <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
<br />
'''If you encounter the error "Algorithm negotiation fail" during the connection test, it is usually because the SFTP server uses old security algorithms such as ssh-dss, which are no longer supported. In this case, check the box "Prefer Old Algorithms" or "prefer old algorithms" to enforce support for the old security algorithms.'''<br />
<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the SFTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Module Configuration]]<br />
[[File:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SMTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SMTP Server<br />
:Choose an SMTP server that you have configured in the "Server" tab. You can find a detailed description under '''[[#Configure SMTP Server|Configure SMTP Server]]'''.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and is used as the sender address for emails sent via this module.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Subject<br />
:This text is used as the subject when sending emails.<br />
;Email Content (PLAIN Text)<br />
:Unformatted message text for the outgoing email.<br />
;Email Content (HTML Text)<br />
:HTML-compliant formatted message text for the outgoing email.<br />
<br />
Testing is done for SMTP modules via the '''Test button''' in the configuration dialog of the corresponding '''server'''.<br />
<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_SMTPModulConf.png|thumb|super|SMTP Module Configuration]]<br />
<br />
|}<br />
<br />
===Configure PLD Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;PLD Server <br />
:HTTPS URL of the server<br />
;PLD Path <br />
:Destination path on the HTTPS server<br />
;PLD Port<br />
:Port under which the server is reachable (Default port 443)<br />
;PLD User<br />
:Username for authentication on the HTTPS server<br />
;PLD Password<br />
:Password for authentication on the HTTPS server<br />
;PLD-Report Storage Path<br />
:Here, the path to a subfolder is specified where the feedback/report files from the PLD server will be saved.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_PLDModulConf.png|thumb|super|PLD Module Configuration]]<br />
|}<br />
<br />
===Configure HTTP(S) Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;HTTP(S) URL <br />
:The HTTP or HTTPS URL with function path and, if applicable, a different port of the server.<br />
:Using the "parsable" option allows you to store the URL in the form of a script that can be edited and verified in an editing dialog "...".<br />
;HTTP User<br />
:Username for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;HTTP Password<br />
:Password for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;MIME-Type<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transfer'''.)<br />
:Content-Type of the request accepted by the server (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Directory<br />
:(This option is available only for the module type '''Download'''.)<br />
:Local default directory where downloaded files should be written. Depending on the process, the directory can be overridden by HVS32.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Module Configuration]]<br />
[[File:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Download Module Configuration]]<br />
|}<br />
<br />
==Servers==<br />
[[File:ComManager_Server.png|360px|thumb|right|Servers]]<br />
;1 - Overview of configured communication servers<br />
:'''Server ID''' - Selection and assignment of the server in the modules are done based on this ID<br />
:'''Server Type''' - Server Type/Category (SMTP)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will lead to errors in process processing.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected server<br />
Keep the original file tag please<br />
<br />
===Configure SMTP Server===<br />
----<br />
[[File:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Configuration]]<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent via the server.<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;SMTP Server<br />
:IP address or hostname under which the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and activate authentication. <br />
;SMTP Port<br />
:Port under which the SMTP server is accessible (25, 465, 587)<br />
;SSL Enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS Enabled<br />
:Data sent will be encrypted via Transport Layer Security if the SMTP server supports it. <br />
;TLS Required<br />
:The server requires TLS support.<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
<br><br />
<br><br />
===Configure O365 Server (for Microsoft Office365)===<br />
----<br />
[[Datei:o365_commanager_02_add-server-2.png|300px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;from address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;from name<br />
:This name will be displayed as the sender's name.<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure ([[#Microsoft_Azure_configuration_for_Microsoft_Office365_.28O365.29_support|see '''Azure configuration''']])<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br />
==Proxies==<br />
[[File:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Overview of configured proxies<br />
:'''Proxy ID''' - Selection and assignment of the proxy is done based on this ID in the modules<br />
:'''Proxy Type''' - Proxy Type/Category (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Server name or IP address of the proxy<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Proxy''' - Option to add a new proxy<br />
:'''Copy Proxy''' - Allows duplicating the selected proxy with a new ID.<br />
:'''Rename Proxy''' - Opens an input dialog to change the ID. Note: If the proxy is in use, this will lead to errors in process processing.<br />
:'''Edit Proxy''' - Opens the proxy configuration dialog.<br />
:'''Remove Proxy''' - Deletes the proxy entry. This change is irreversible; if the proxy is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected proxy<br />
<br />
<br />
===Add/Configure Proxy===<br />
----<br />
[[File:ComManager_ProxyConf.png|300px|thumb|right|Proxy Configuration]]<br />
After entering the unique proxy ID, the configuration of the new proxy is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;PROXY Type<br />
:Determines the type of the deployed proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP address or hostname under which the proxy server is accessible.<br />
;PROXY Port <br />
:Port under which the proxy server is accessible <br />
;PROXY User<br />
:Username for authentication on the proxy server<br />
;PROXY Password<br />
:Password for authentication on the proxy server<br />
<br />
;NOTE<br />
:The FTP proxy type '''USER <User>@<Host>''' is configured directly in the '''FTP module''' and not as a proxy.<br />
:To do this, enter the data in the FTP module as follows: '''FTP Server = <FTP Proxy Host>''' and '''FTP User = <FTP User>@<FTP Server>'''<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
<br />
=Microsoft Azure Configuration for Microsoft Office365 (O365)=<br />
To send emails from ComManager via Microsoft Office365 (O365), you must first register an app in Azure, assign the appropriate permissions, and configure security features. This is necessary to obtain a valid Client ID, Client Secret, and Tenant ID, as well as to grant ComManager permission to send emails.<br><br />
Below, we show how to perform an '''example configuration'''.<br />
<br><br />
<br />
The following steps are required:<br><br />
<br><br />
# Navigate to the "App registrations" service in Azure '''''[A1]'''''<br />
# Click on "+ New registration" in the "App registration" menu '''''[A2]'''''<br />
# Enter a name for the application (e.g., "HSC-ComManager") and select a Single Tenant account type (e.g., "Accounts in this organizational directory only")<br>Redirect URIs are not required and can be ignored '''''[A3]'''''<br />
# After registration, click on the newly registered app (e.g., "HSC-ComManager") in the "App registrations" menu '''''[A4]'''''<br />
# In this overview, you will find the Application (client) ID and Directory (tenant) ID, which are important for ComManager '''''[A5]'''''<br />
# Click on "Add a certificate or secret" in this overview to add a Client Secret to the app. This is necessary for ComManager to authenticate later. '''''[A5]'''''<br />
# Click on "New client secret" in this overview '''''[A6]'''''<br />
# Enter a description for this secret (e.g., "HSC-ComManager-Secret") and select an expiration date for the secret. '''''[A7]'''''<br>'''Note: When the secret expires on the selected date (e.g., in 30 days), you must add a new secret and update it in ComManager. Otherwise, email sending from ComManager will no longer be possible. Be sure to set up a notification to renew the secret in time!'''<br />
# Copy the value of the secret ('''not the Secret ID'''). '''''[A8]'''''<br>'''Note: The secret value is only displayed now. You will not have access to it later!'''<br />
# Next, switch to the "API permissions" tab and add a permission to the app ("+ Add a permission") '''''[A9]'''''<br />
# Under "Microsoft APIs," select "Microsoft Graph" '''''[A10]'''''<br />
# Select "Application permissions," '''not''' "Delegated permissions" '''''[A11]'''''<br />
# Search for and select "Mail.Send" and add the permission '''''[A12]'''''<br />
# Depending on your user level, you or your administrator may need to explicitly confirm adding the permission ("Grant admin consent for ...") '''''[A13]'''''<br />
<br />
<br><br />
<br />
<gallery><br />
o365_azure_01_search.png|A1: App Registration<br />
o365_azure_02_new-app-registration.png|A2: App Registration<br />
o365_azure_03_register-app.png|A3: Register App<br />
o365_azure_04_edit-app.png|A4: Edit registered App<br />
o365_azure_05_edit-app-2.png|A5: Relevant Information / Add Client Secret<br />
o365_azure_06_add-secret.png|A6: New Client Secret<br />
o365_azure_07_add-secret-2.png|A7: Add Client Secret<br />
o365_azure_08_save-secret.png|A8: Copy Client Secret<br />
o365_azure_09_add-permission.png|A9: Add Permission to registered App<br />
o365_azure_10_add-permission-2.png|A10: Request API Permission (Graph)<br />
o365_azure_11_add-permission-3.png|A11: Request API Permission (Application)<br />
o365_azure_12_add-permission-4.png|A12: Add Mail.Send Permission<br />
o365_azure_13_add-permission-5.png|A13: Grant Admin Consent<br />
</gallery><br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Error Code ||Error Description||Troubleshooting<br />
|-<br />
|COM11C00100||Unknown error occurred while processing a Send Message job! Response is NULL!||This is a general error in processing a Send Message job. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unknown error occurred while processing an Upload job! Response is NULL!||This is a general error in processing an Upload job. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Error occurred while deleting temporary file(s) during processing of a Send Message job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM11W00210||Error occurred while deleting temporary file(s) during processing of an Upload job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00020||Error converting response to XML - Response is NULL||This is a general error in processing a request. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Error parsing XML data in REST function uploadFile||The data received from HVS32 for upload is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00110||Error creating module configuration for REST function uploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Error converting response to XML for REST function uploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00130||Error reading file(s) in REST function uploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory and if sufficient permissions for reading files are set for the Windows user SYSTEM (or the Windows user specified in Heidler-ComManager). Try repeating the operation.<br />
|-<br />
|COM21C00131||Error writing temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00200||Error parsing XML data in REST function downloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00210||Error creating module configuration for REST function downloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Error converting response to XML for REST function downloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00300||Error parsing XML data in REST function sendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00320||Error converting response to XML for REST function sendMessage||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Error reading file(s) in REST function sendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00331||Error writing temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00400||Error parsing XML data in REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00410||Error creating module configuration for REST function queueUploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Error converting response to XML for REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00430||Error reading file(s) in REST function queueUploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00431||Error writing temporary file(s) in REST function queueUploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00500||Error parsing XML data in REST function queueDownloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00510||Error creating module configuration for REST function queueDownloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Error converting response to XML for REST function queueDownloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00600||Error parsing XML data in REST function queueSendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00620||Error converting response to XML for REST function queueSendMessage||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00630||Error reading file(s) in REST function queueSendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00631||Error writing temporary file(s) in REST function queueSendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00700||Error loading main configuration in REST function getModuleList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Error reading main configuration in REST function getModuleList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Error converting response to XML for REST function getModuleList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00800||Error loading main configuration in REST function getServerList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Error reading main configuration in REST function getServerList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Error converting response to XML for REST function getServerList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00132||Error deleting temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00332||Error deleting temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00100||Error initializing HVS32 Database Manager||There was an error initializing the Database Manager. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00200||Error initializing write connections to HVS32 database||There was an error initializing the write connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00210||Error initializing prepared statements for updating FF file in HVS32 database||There was an error initializing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00220||Error updating FF file||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00225||Error updating FF file - no results found||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00230||Error initializing prepared statements for updating WaWi file in HVS32 database||There was an error initializing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00240||Error updating WaWi file||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00245||Error updating WaWi file - no results found||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00300||Error initializing read connections to HVS32 database||There was an error initializing the read connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00310||Error initializing prepared statements for reading FF file in HVS32 database||There was an error initializing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00320||Error reading FF file from HVS32 database||There was an error executing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00325||FF file not found in HVS32 database||The FF file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The FF file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00330||Error initializing prepared statements for reading WaWi file in HVS32 database||There was an error initializing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00340||Error reading WaWi file from HVS32 database||There was an error executing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00345||WaWi file not found in HVS32 database||The WaWi file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The WaWi file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM50C01100||Error instantiating the upload module||The module for the selected module ID for upload cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Failed to instantiate the upload module||The module for the selected module ID for upload could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Error initializing the upload module||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Error instantiating the download module||The module for the selected module ID for download cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Failed to instantiate the download module||The module for the selected module ID for download could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Error initializing the download module||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Error instantiating the SendMessage module||The server module for the selected server module ID for SendMessage cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Failed to instantiate the SendMessage module||The server module for the selected server module ID for SendMessage could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Error initializing the SendMessage module||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Error connecting to FTP server||There was an error connecting to the FTP server. Please check the configured FTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Error logging into FTP server||There was an error logging into the FTP server. Please check the configured login credentials (username/password) in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Error changing directory on FTP server||There was an error changing the directory on the FTP server. Please check the configured FTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Error uploading file to FTP server||There was an error uploading the FF file to the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00500||Error downloading file from FTP server||There was an error downloading the file from the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00410||Error renaming file on FTP server||There was an error renaming the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C00411||Error moving file on FTP server||There was an error moving the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C99999||Invocation of an unsupported function in FTP module||The invoked function is not supported by this FTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM52C00100||Error starting session on SFTP server||There was an error starting the session to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Error starting session on jump host for SFTP transmission||There was an error starting the session to the jump host. Please check the configured jump host settings in the SFTP server module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Error opening channel to SFTP server||There was an error opening the channel to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Error connecting to SFTP server||There was an error connecting to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Error changing directory on SFTP server||There was an error changing the directory on the SFTP server. Please check the configured SFTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Error uploading file to SFTP server||There was an error uploading the FF file to the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00510||Error uploading file to SFTP server - Access denied!||There was an error uploading the FF file to the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C00520||Error renaming file on SFTP server||There was an error renaming the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00521||Error moving file on SFTP server||There was an error moving the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00600||Error downloading file from SFTP server||There was an error downloading the file from the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00610||Error downloading file from SFTP server - Access denied!||There was an error downloading the file from the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C99999||Invocation of an unsupported function in SFTP module||The invoked function is not supported by this SFTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM53C00100||SMTP configuration not found||There was an error in the configuration of the SMTP module. Please check the selected SMTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00101||Illegal parameters in SMTP configuration - recipient address is empty!||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00102||Illegal parameters in SMTP configuration - subject is empty!||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00103||Illegal parameters in SMTP configuration - mail text is empty!||There was an error in the configuration of the SMTP module. Please check the configured mail text in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00105||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00110||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00111||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00112||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00120||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00130||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00131||Error setting recipient address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00132||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00133||Error setting BCC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured BCC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00134||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00135||Error setting subject in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00200||No SMTP data found from HVS32||No SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00201||Invalid SMTP data from HVS32||Invalid SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00202||Illegal parameters in SMTP data from HVS32 - recipient address is empty!||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53C00203||Illegal parameters in SMTP data from HVS32 - subject is empty!||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00204||Illegal parameters in SMTP data from HVS32 - mail text is empty!||There was an error in the configuration of HVS32. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00205||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00210||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in HVS32 Configurator.<br />
|-<br />
|COM53C00211||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00212||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00220||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00230||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00231||Error setting recipient address in SMTP module||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53W00232||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in HVS32 Configurator.<br />
|-<br />
|COM53W00233||Error setting BCC address in SMTP module||There was an error in the configuration of HVS32. Please check the configured BCC address in HVS32 Configurator.<br />
|-<br />
|COM53W00234||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in HVS32 Configurator.<br />
|-<br />
|COM53W00235||Error setting subject in SMTP module||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00300||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00400||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C99999||Invocation of an unsupported function in SMTP module||The invoked function is not supported by this SMTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54C99999||Invocation of an unsupported function in PLD module||The invoked function is not supported by this PLD module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54W03005||3005 PLD Warning - File already transmitted!||The carrier file has already been transmitted and therefore could not be accepted by the UPS server. Please do not transmit this file again.<br />
|-<br />
|COM54W06930||6930 PLD Warning - Data uploaded with warnings. Please correct before the next upload!||The carrier file has been successfully transmitted to the UPS server and processed. The file does not need to be transmitted again. However, there are content errors in the FF file that need to be fixed before the next day's closure. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06931||6931 PLD Error - Upload failed due to errors in the PLD data.||The carrier file has been transmitted to the UPS server but was NOT processed due to errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06932||6932 Severe PLD Error - Upload failed due to errors in the input parameters.||The carrier file has been transmitted to the UPS server but was NOT processed due to SERIOUS errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06933||Unknown PLD Error - Upload failed due to unknown errors.||The carrier file has been transmitted to the UPS server but was NOT processed due to unknown errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C01000||Error in feedback - no status code found!||An error was detected in the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54C01100||Error parsing the feedback||There was an error parsing the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54W01200||Error saving the report file(s)||There was an error saving the reports from the UPS server. Please check the configured storage path in the corresponding PLD module configuration of HVS32CommunicationManager, as well as the user rights of this directory.<br />
|-<br />
|COM54C02000||HTTPS connection not ready!||There was an error connecting to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C03000||Error reading the EDI file||There was an error reading the FF file in the PLD module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C04000||Error transmitting data to the UPS server||There was an error transmitting data to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C02000||HTTP(S) connection not ready!||There was an error connecting to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C04000||Error transmitting data to the HTTP(S) server||There was an error transmitting data to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C05000||Error downloading file from the HTTP(S) server||There was an error downloading the file from the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C99999||Invocation of an unsupported function in HTTP module||The invoked function is not supported by this HTTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager(en)&diff=6110
HVS32 Communication Manager(en)
2025-03-19T10:59:08Z
<p>Bhauser: /* O365 */</p>
<hr />
<div>[[de:HVS32_Communication_Manager]]<br />
The Communication Manager (hereafter abbreviated as ComManager) is a service that centrally manages communication between HVS32 and customers or HVS32 and carriers. The ComManager is designed for communications via FTP, SFTP, or SMTP protocols.<br />
<br />
Similar to WinSCP, this service is controlled by HVS32 and sends data to the destination server configured in the module.<br />
<br />
It is intended to gradually take over communications from HVS32 and replace other external transmission programs such as WinSCP.<br />
<br />
=ComManager Configuration=<br />
The ComManager Configurator can be accessed either directly through the ''ComManager-Configurator.exe'' in the installation directory ''...Heidler\HVS32\ComManager\'' or from the [[Setting up Communication Manager in HVS32|HVS32 Configurator]].<br />
<br />
[[Datei:ComManager-Main Window EN.png|500px|thumb|ohne|ComManager main window]]<br />
<br />
;1 - Link to this wiki entry<br />
;2 - Selection Tabs<br />
:'''[[HVS32_Communication_Manager(en)#Modules|Modules]]''' - Modules for file transmission during daily closing, Wawi return, and route downloads<br />
:'''[[HVS32_Communication_Manager(en)#Servers|Servers]]''' - Internal communication servers such as Microsoft Exchange (SMTP) connections<br />
:'''[[HVS32_Communication_Manager(en)#Proxies|Proxy]]''' - Internal proxy servers<br />
;3 - Overview of configured modules<br />
;4 - Summary of the configuration of the selected module<br />
;5 - [[HVS32_Communication_Manager(en)#Configure_ErrorHandler|Errorhandler Configuration]]<br />
;6 - [[HVS32_Communication_Manager(en)#Service_Settings|Service Settings]]<br />
<br />
==Service Settings==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|In this section, the basic settings of the ComManager service are configured, which are necessary to establish a connection to the service. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
<span style="color:#C00000">'''Warning: The configurations you make here will be applied only after restarting the ComManager service!'''</span><br />
<br />
;HVS32 Main Directory: <br />
:Specify the path to HVS32 here<br />
;HVS32 Database File:<br />
:Specify the path to the HVS32 database file<br />
;HVS32 Database Server:<br />
:IP address or hostname of the PC where the database is located<br />
;HVS32 Database Port:<br />
:The port for the HVS32 database usually does not need adjustment. The default port is set to 3050.<br />
;REST Port<br />
:Communication port through which the ComManager service is accessible via REST. This port must be opened in the server's firewall for external communication with the clients.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Configuration Window of Service Settings]]<br />
|}<br />
<br />
==Configure ErrorHandler==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|If an ErrorHandler is configured, you will be notified by email in case of a failed transmission. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
;Mode<br />
:First of all, you have to choose wich mode you want to use to send error mails<br />
<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
To send the error mails via SMTP choose the mode "SMTP" and enter the following parameters:<br />
;SMTP Server<br />
:IP address or hostname where the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and enable authentication.<br />
;SMTP Port<br />
:Port at which the SMTP server is accessible (25, 465, 587)<br />
;SSL enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS enabled<br />
:Data sent will be encrypted via Transport Layer Security, provided the SMTP server supports it.<br />
;TLS required<br />
:The server is requested to provide TLS support.<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
To send the error mails via Microsoft Office365 choose the mode "O365" and enter the following parameters:<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure ([[#Microsoft_Azure_configuration_for_Microsoft_Office365_.28O365.29_support|see '''Azure configuration''']])<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br><br />
<br><br />
<br />
===General===<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and will be displayed as the sender address for emails sent through this module.<br />
;Subject<br />
:This text will be used as the subject when sending the emails.<br />
<br />
;Test<br />
:You can use this option to send a test message to verify the configured parameters.<br />
<br />
<br />
<br />
|}<br />
<br />
==Modules==<br />
[[File:ComManager_Modules_EN.png|360px|thumb|right|Modules]]<br />
;1 - Overview of configured modules<br />
:'''Module ID''' - Selection and assignment of the module in HVS32 is done through this ID<br />
:'''Module Type''' - Type/category of module; the abbreviation "U" / "D" in parentheses indicates whether it is a '''D'''ownload (e.g., route download) or '''U'''pload module (FFFile, Wawi return, etc.)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will cause errors in process handling.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, it will cause errors in process handling.<br />
;3 - Summary of the configuration of the selected server<br />
<br />
[[File:ComManager_AddModul.png|340px|thumb|right|Add Module]]<br />
;Add / configure module<br />
Communication between HVS32 and the specified server occurs through modules. Such a server can be either a separate [[HVS32_Communication_Manager(en)#Server|(SMTP) server]] or directly the carrier's or customer's server.<br />
<br />
After selecting the module type (FTP, SFTP, SMTP, PLD/UPS, HTTP), the configuration of the new module takes place. In the following dialog, you can adjust the corresponding parameters.<br />
<br />
;Module Type<br />
:'''Carrier Module''' - Standard choice for uploading FF files during daily closing<br />
:'''Additional Transmission''' - Customer-specific transmission of, for example, Wawi return files to a customer's server<br />
:'''Download''' - Special module type for downloading, e.g., route files<br />
;Module ID<br />
:An automatically generated ID for the selection and assignment of the module in HVS32<br />
;Carrier<br />
:Additional restriction of the module for the use of specific carrier modules in HVS32 (exclusively for FF file transmission)<br />
;Principal<br />
:Additional restriction of the module for the use of specific principals/clients in HVS32 (exclusively for FF file transmission)<br />
;Note<br />
:Optional note for better overview (displayed in the overview and in HVS32)<br />
<br />
===Configure FTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;FTP Server: <br />
:IP address or hostname of the server<br />
;FTP Port: <br />
:Port at which the server is accessible (Default port 21) <br />
;FTP User<br />
:Username for authentication on the FTP server <br />
;FTP Password<br />
:Password for authentication on the FTP server <br />
;FTP Account<br />
:FTP account for authentication on the FTP server<br />
;FTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the FTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "FTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;FTP Transfer Mode<br />
:Specify whether the data should be transferred as binary or text.<br />
;FTP Security <br />
:;FTPS <br />
::FTP over Secure Socket Layer (SSL) implicitly<br />
:;FTPES: <br />
::FTP over Secure Socket Layer (SSL) explicitly. (Here, the server can allow insecure connections as well)<br />
;FTP Connection<br />
:Choose the method for establishing the connection. PASSIVE should be chosen by default.<br />
;Proxy: <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the FTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_FTPModulConf.png|thumb|right|FTP Upload Module Configuration]]<br />
[[File:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SFTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SFTP Server <br />
:IP address or hostname of the server<br />
;SFTP Port<br />
:Port at which the server is accessible (Default port 22)<br />
;SFTP User<br />
:Username for authentication on the SFTP server <br />
;SFTP Password<br />
:Password for authentication on the SFTP server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:If you are using a private key, you can specify the path to the file here.<br />
;Passphrase<br />
:Enter your passphrase here to decrypt the file mentioned above<br />
;SFTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the SFTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "SFTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;Timeout (ms)<br />
:Time in milliseconds that the connection setup and individual communication steps can take at most (standard 30000ms).<br />
:In the configuration dialog itself, a timeout of 5000ms is used regardless of the setting to test the connection more quickly.<br />
;Proxy <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
<br />
'''If you encounter the error "Algorithm negotiation fail" during the connection test, it is usually because the SFTP server uses old security algorithms such as ssh-dss, which are no longer supported. In this case, check the box "Prefer Old Algorithms" or "prefer old algorithms" to enforce support for the old security algorithms.'''<br />
<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the SFTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Module Configuration]]<br />
[[File:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SMTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SMTP Server<br />
:Choose an SMTP server that you have configured in the "Server" tab. You can find a detailed description under '''[[#Configure SMTP Server|Configure SMTP Server]]'''.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and is used as the sender address for emails sent via this module.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Subject<br />
:This text is used as the subject when sending emails.<br />
;Email Content (PLAIN Text)<br />
:Unformatted message text for the outgoing email.<br />
;Email Content (HTML Text)<br />
:HTML-compliant formatted message text for the outgoing email.<br />
<br />
Testing is done for SMTP modules via the '''Test button''' in the configuration dialog of the corresponding '''server'''.<br />
<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_SMTPModulConf.png|thumb|super|SMTP Module Configuration]]<br />
<br />
|}<br />
<br />
===Configure PLD Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;PLD Server <br />
:HTTPS URL of the server<br />
;PLD Path <br />
:Destination path on the HTTPS server<br />
;PLD Port<br />
:Port under which the server is reachable (Default port 443)<br />
;PLD User<br />
:Username for authentication on the HTTPS server<br />
;PLD Password<br />
:Password for authentication on the HTTPS server<br />
;PLD-Report Storage Path<br />
:Here, the path to a subfolder is specified where the feedback/report files from the PLD server will be saved.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_PLDModulConf.png|thumb|super|PLD Module Configuration]]<br />
|}<br />
<br />
===Configure HTTP(S) Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;HTTP(S) URL <br />
:The HTTP or HTTPS URL with function path and, if applicable, a different port of the server.<br />
:Using the "parsable" option allows you to store the URL in the form of a script that can be edited and verified in an editing dialog "...".<br />
;HTTP User<br />
:Username for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;HTTP Password<br />
:Password for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;MIME-Type<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transfer'''.)<br />
:Content-Type of the request accepted by the server (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Directory<br />
:(This option is available only for the module type '''Download'''.)<br />
:Local default directory where downloaded files should be written. Depending on the process, the directory can be overridden by HVS32.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Module Configuration]]<br />
[[File:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Download Module Configuration]]<br />
|}<br />
<br />
==Servers==<br />
[[File:ComManager_Server.png|360px|thumb|right|Servers]]<br />
;1 - Overview of configured communication servers<br />
:'''Server ID''' - Selection and assignment of the server in the modules are done based on this ID<br />
:'''Server Type''' - Server Type/Category (SMTP)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will lead to errors in process processing.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected server<br />
Keep the original file tag please<br />
<br />
===Configure SMTP Server===<br />
----<br />
[[File:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Configuration]]<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent via the server.<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;SMTP Server<br />
:IP address or hostname under which the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and activate authentication. <br />
;SMTP Port<br />
:Port under which the SMTP server is accessible (25, 465, 587)<br />
;SSL Enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS Enabled<br />
:Data sent will be encrypted via Transport Layer Security if the SMTP server supports it. <br />
;TLS Required<br />
:The server requires TLS support.<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
<br><br />
<br><br />
===Configure O365 Server (for Microsoft Office365)===<br />
----<br />
[[Datei:o365_commanager_02_add-server-2.png|300px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;from address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;from name<br />
:This name will be displayed as the sender's name.<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure ([[#Microsoft_Azure_configuration_for_Microsoft_Office365_.28O365.29_support|see '''Azure configuration''']])<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br />
==Proxies==<br />
[[File:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Overview of configured proxies<br />
:'''Proxy ID''' - Selection and assignment of the proxy is done based on this ID in the modules<br />
:'''Proxy Type''' - Proxy Type/Category (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Server name or IP address of the proxy<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Proxy''' - Option to add a new proxy<br />
:'''Copy Proxy''' - Allows duplicating the selected proxy with a new ID.<br />
:'''Rename Proxy''' - Opens an input dialog to change the ID. Note: If the proxy is in use, this will lead to errors in process processing.<br />
:'''Edit Proxy''' - Opens the proxy configuration dialog.<br />
:'''Remove Proxy''' - Deletes the proxy entry. This change is irreversible; if the proxy is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected proxy<br />
<br />
<br />
===Add/Configure Proxy===<br />
----<br />
[[File:ComManager_ProxyConf.png|300px|thumb|right|Proxy Configuration]]<br />
After entering the unique proxy ID, the configuration of the new proxy is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;PROXY Type<br />
:Determines the type of the deployed proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP address or hostname under which the proxy server is accessible.<br />
;PROXY Port <br />
:Port under which the proxy server is accessible <br />
;PROXY User<br />
:Username for authentication on the proxy server<br />
;PROXY Password<br />
:Password for authentication on the proxy server<br />
<br />
;NOTE<br />
:The FTP proxy type '''USER <User>@<Host>''' is configured directly in the '''FTP module''' and not as a proxy.<br />
:To do this, enter the data in the FTP module as follows: '''FTP Server = <FTP Proxy Host>''' and '''FTP User = <FTP User>@<FTP Server>'''<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
<br />
=Microsoft Azure Configuration for Microsoft Office365 (O365)=<br />
To send emails from ComManager via Microsoft Office365 (O365), you must first register an app in Azure, assign the appropriate permissions, and configure security features. This is necessary to obtain a valid Client ID, Client Secret, and Tenant ID, as well as to grant ComManager permission to send emails.<br><br />
Below, we show how to perform an '''example configuration'''.<br />
<br><br />
<br />
The following steps are required:<br><br />
<br><br />
# Navigate to the "App registrations" service in Azure '''''[A1]'''''<br />
# Click on "+ New registration" in the "App registration" menu '''''[A2]'''''<br />
# Enter a name for the application (e.g., "HSC-ComManager") and select a Single Tenant account type (e.g., "Accounts in this organizational directory only")<br>Redirect URIs are not required and can be ignored '''''[A3]'''''<br />
# After registration, click on the newly registered app (e.g., "HSC-ComManager") in the "App registrations" menu '''''[A4]'''''<br />
# In this overview, you will find the Application (client) ID and Directory (tenant) ID, which are important for ComManager '''''[A5]'''''<br />
# Click on "Add a certificate or secret" in this overview to add a Client Secret to the app. This is necessary for ComManager to authenticate later. '''''[A5]'''''<br />
# Click on "New client secret" in this overview '''''[A6]'''''<br />
# Enter a description for this secret (e.g., "HSC-ComManager-Secret") and select an expiration date for the secret. '''''[A7]'''''<br>'''Note: When the secret expires on the selected date (e.g., in 30 days), you must add a new secret and update it in ComManager. Otherwise, email sending from ComManager will no longer be possible. Be sure to set up a notification to renew the secret in time!'''<br />
# Copy the value of the secret ('''not the Secret ID'''). '''''[A8]'''''<br>'''Note: The secret value is only displayed now. You will not have access to it later!'''<br />
# Next, switch to the "API permissions" tab and add a permission to the app ("+ Add a permission") '''''[A9]'''''<br />
# Under "Microsoft APIs," select "Microsoft Graph" '''''[A10]'''''<br />
# Select "Application permissions," '''not''' "Delegated permissions" '''''[A11]'''''<br />
# Search for and select "Mail.Send" and add the permission '''''[A12]'''''<br />
# Depending on your user level, you or your administrator may need to explicitly confirm adding the permission ("Grant admin consent for ...") '''''[A13]'''''<br />
<br />
<br><br />
<br />
<gallery><br />
o365_azure_01_search.png|A1: App Registration<br />
o365_azure_02_new-app-registration.png|A2: App Registration<br />
o365_azure_03_register-app.png|A3: Register App<br />
o365_azure_04_edit-app.png|A4: Edit registered App<br />
o365_azure_05_edit-app-2.png|A5: Relevant Information / Add Client Secret<br />
o365_azure_06_add-secret.png|A6: New Client Secret<br />
o365_azure_07_add-secret-2.png|A7: Add Client Secret<br />
o365_azure_08_save-secret.png|A8: Copy Client Secret<br />
o365_azure_09_add-permission.png|A9: Add Permission to registered App<br />
o365_azure_10_add-permission-2.png|A10: Request API Permission (Graph)<br />
o365_azure_11_add-permission-3.png|A11: Request API Permission (Application)<br />
o365_azure_12_add-permission-4.png|A12: Add Mail.Send Permission<br />
o365_azure_13_add-permission-5.png|A13: Grant Admin Consent<br />
</gallery><br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Error Code ||Error Description||Troubleshooting<br />
|-<br />
|COM11C00100||Unknown error occurred while processing a Send Message job! Response is NULL!||This is a general error in processing a Send Message job. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unknown error occurred while processing an Upload job! Response is NULL!||This is a general error in processing an Upload job. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Error occurred while deleting temporary file(s) during processing of a Send Message job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM11W00210||Error occurred while deleting temporary file(s) during processing of an Upload job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00020||Error converting response to XML - Response is NULL||This is a general error in processing a request. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Error parsing XML data in REST function uploadFile||The data received from HVS32 for upload is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00110||Error creating module configuration for REST function uploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Error converting response to XML for REST function uploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00130||Error reading file(s) in REST function uploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory and if sufficient permissions for reading files are set for the Windows user SYSTEM (or the Windows user specified in Heidler-ComManager). Try repeating the operation.<br />
|-<br />
|COM21C00131||Error writing temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00200||Error parsing XML data in REST function downloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00210||Error creating module configuration for REST function downloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Error converting response to XML for REST function downloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00300||Error parsing XML data in REST function sendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00320||Error converting response to XML for REST function sendMessage||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Error reading file(s) in REST function sendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00331||Error writing temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00400||Error parsing XML data in REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00410||Error creating module configuration for REST function queueUploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Error converting response to XML for REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00430||Error reading file(s) in REST function queueUploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00431||Error writing temporary file(s) in REST function queueUploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00500||Error parsing XML data in REST function queueDownloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00510||Error creating module configuration for REST function queueDownloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Error converting response to XML for REST function queueDownloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00600||Error parsing XML data in REST function queueSendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00620||Error converting response to XML for REST function queueSendMessage||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00630||Error reading file(s) in REST function queueSendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00631||Error writing temporary file(s) in REST function queueSendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00700||Error loading main configuration in REST function getModuleList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Error reading main configuration in REST function getModuleList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Error converting response to XML for REST function getModuleList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00800||Error loading main configuration in REST function getServerList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Error reading main configuration in REST function getServerList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Error converting response to XML for REST function getServerList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00132||Error deleting temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00332||Error deleting temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00100||Error initializing HVS32 Database Manager||There was an error initializing the Database Manager. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00200||Error initializing write connections to HVS32 database||There was an error initializing the write connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00210||Error initializing prepared statements for updating FF file in HVS32 database||There was an error initializing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00220||Error updating FF file||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00225||Error updating FF file - no results found||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00230||Error initializing prepared statements for updating WaWi file in HVS32 database||There was an error initializing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00240||Error updating WaWi file||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00245||Error updating WaWi file - no results found||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00300||Error initializing read connections to HVS32 database||There was an error initializing the read connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00310||Error initializing prepared statements for reading FF file in HVS32 database||There was an error initializing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00320||Error reading FF file from HVS32 database||There was an error executing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00325||FF file not found in HVS32 database||The FF file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The FF file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00330||Error initializing prepared statements for reading WaWi file in HVS32 database||There was an error initializing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00340||Error reading WaWi file from HVS32 database||There was an error executing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00345||WaWi file not found in HVS32 database||The WaWi file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The WaWi file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM50C01100||Error instantiating the upload module||The module for the selected module ID for upload cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Failed to instantiate the upload module||The module for the selected module ID for upload could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Error initializing the upload module||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Error instantiating the download module||The module for the selected module ID for download cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Failed to instantiate the download module||The module for the selected module ID for download could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Error initializing the download module||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Error instantiating the SendMessage module||The server module for the selected server module ID for SendMessage cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Failed to instantiate the SendMessage module||The server module for the selected server module ID for SendMessage could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Error initializing the SendMessage module||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Error connecting to FTP server||There was an error connecting to the FTP server. Please check the configured FTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Error logging into FTP server||There was an error logging into the FTP server. Please check the configured login credentials (username/password) in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Error changing directory on FTP server||There was an error changing the directory on the FTP server. Please check the configured FTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Error uploading file to FTP server||There was an error uploading the FF file to the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00500||Error downloading file from FTP server||There was an error downloading the file from the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00410||Error renaming file on FTP server||There was an error renaming the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C00411||Error moving file on FTP server||There was an error moving the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C99999||Invocation of an unsupported function in FTP module||The invoked function is not supported by this FTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM52C00100||Error starting session on SFTP server||There was an error starting the session to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Error starting session on jump host for SFTP transmission||There was an error starting the session to the jump host. Please check the configured jump host settings in the SFTP server module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Error opening channel to SFTP server||There was an error opening the channel to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Error connecting to SFTP server||There was an error connecting to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Error changing directory on SFTP server||There was an error changing the directory on the SFTP server. Please check the configured SFTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Error uploading file to SFTP server||There was an error uploading the FF file to the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00510||Error uploading file to SFTP server - Access denied!||There was an error uploading the FF file to the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C00520||Error renaming file on SFTP server||There was an error renaming the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00521||Error moving file on SFTP server||There was an error moving the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00600||Error downloading file from SFTP server||There was an error downloading the file from the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00610||Error downloading file from SFTP server - Access denied!||There was an error downloading the file from the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C99999||Invocation of an unsupported function in SFTP module||The invoked function is not supported by this SFTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM53C00100||SMTP configuration not found||There was an error in the configuration of the SMTP module. Please check the selected SMTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00101||Illegal parameters in SMTP configuration - recipient address is empty!||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00102||Illegal parameters in SMTP configuration - subject is empty!||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00103||Illegal parameters in SMTP configuration - mail text is empty!||There was an error in the configuration of the SMTP module. Please check the configured mail text in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00105||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00110||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00111||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00112||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00120||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00130||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00131||Error setting recipient address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00132||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00133||Error setting BCC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured BCC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00134||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00135||Error setting subject in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00200||No SMTP data found from HVS32||No SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00201||Invalid SMTP data from HVS32||Invalid SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00202||Illegal parameters in SMTP data from HVS32 - recipient address is empty!||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53C00203||Illegal parameters in SMTP data from HVS32 - subject is empty!||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00204||Illegal parameters in SMTP data from HVS32 - mail text is empty!||There was an error in the configuration of HVS32. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00205||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00210||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in HVS32 Configurator.<br />
|-<br />
|COM53C00211||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00212||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00220||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00230||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00231||Error setting recipient address in SMTP module||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53W00232||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in HVS32 Configurator.<br />
|-<br />
|COM53W00233||Error setting BCC address in SMTP module||There was an error in the configuration of HVS32. Please check the configured BCC address in HVS32 Configurator.<br />
|-<br />
|COM53W00234||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in HVS32 Configurator.<br />
|-<br />
|COM53W00235||Error setting subject in SMTP module||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00300||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00400||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C99999||Invocation of an unsupported function in SMTP module||The invoked function is not supported by this SMTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54C99999||Invocation of an unsupported function in PLD module||The invoked function is not supported by this PLD module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54W03005||3005 PLD Warning - File already transmitted!||The carrier file has already been transmitted and therefore could not be accepted by the UPS server. Please do not transmit this file again.<br />
|-<br />
|COM54W06930||6930 PLD Warning - Data uploaded with warnings. Please correct before the next upload!||The carrier file has been successfully transmitted to the UPS server and processed. The file does not need to be transmitted again. However, there are content errors in the FF file that need to be fixed before the next day's closure. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06931||6931 PLD Error - Upload failed due to errors in the PLD data.||The carrier file has been transmitted to the UPS server but was NOT processed due to errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06932||6932 Severe PLD Error - Upload failed due to errors in the input parameters.||The carrier file has been transmitted to the UPS server but was NOT processed due to SERIOUS errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06933||Unknown PLD Error - Upload failed due to unknown errors.||The carrier file has been transmitted to the UPS server but was NOT processed due to unknown errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C01000||Error in feedback - no status code found!||An error was detected in the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54C01100||Error parsing the feedback||There was an error parsing the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54W01200||Error saving the report file(s)||There was an error saving the reports from the UPS server. Please check the configured storage path in the corresponding PLD module configuration of HVS32CommunicationManager, as well as the user rights of this directory.<br />
|-<br />
|COM54C02000||HTTPS connection not ready!||There was an error connecting to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C03000||Error reading the EDI file||There was an error reading the FF file in the PLD module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C04000||Error transmitting data to the UPS server||There was an error transmitting data to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C02000||HTTP(S) connection not ready!||There was an error connecting to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C04000||Error transmitting data to the HTTP(S) server||There was an error transmitting data to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C05000||Error downloading file from the HTTP(S) server||There was an error downloading the file from the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C99999||Invocation of an unsupported function in HTTP module||The invoked function is not supported by this HTTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager(en)&diff=6109
HVS32 Communication Manager(en)
2025-03-19T10:58:47Z
<p>Bhauser: /* O365 Server (für Microsoft Office365) konfigurieren */</p>
<hr />
<div>[[de:HVS32_Communication_Manager]]<br />
The Communication Manager (hereafter abbreviated as ComManager) is a service that centrally manages communication between HVS32 and customers or HVS32 and carriers. The ComManager is designed for communications via FTP, SFTP, or SMTP protocols.<br />
<br />
Similar to WinSCP, this service is controlled by HVS32 and sends data to the destination server configured in the module.<br />
<br />
It is intended to gradually take over communications from HVS32 and replace other external transmission programs such as WinSCP.<br />
<br />
=ComManager Configuration=<br />
The ComManager Configurator can be accessed either directly through the ''ComManager-Configurator.exe'' in the installation directory ''...Heidler\HVS32\ComManager\'' or from the [[Setting up Communication Manager in HVS32|HVS32 Configurator]].<br />
<br />
[[Datei:ComManager-Main Window EN.png|500px|thumb|ohne|ComManager main window]]<br />
<br />
;1 - Link to this wiki entry<br />
;2 - Selection Tabs<br />
:'''[[HVS32_Communication_Manager(en)#Modules|Modules]]''' - Modules for file transmission during daily closing, Wawi return, and route downloads<br />
:'''[[HVS32_Communication_Manager(en)#Servers|Servers]]''' - Internal communication servers such as Microsoft Exchange (SMTP) connections<br />
:'''[[HVS32_Communication_Manager(en)#Proxies|Proxy]]''' - Internal proxy servers<br />
;3 - Overview of configured modules<br />
;4 - Summary of the configuration of the selected module<br />
;5 - [[HVS32_Communication_Manager(en)#Configure_ErrorHandler|Errorhandler Configuration]]<br />
;6 - [[HVS32_Communication_Manager(en)#Service_Settings|Service Settings]]<br />
<br />
==Service Settings==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|In this section, the basic settings of the ComManager service are configured, which are necessary to establish a connection to the service. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
<span style="color:#C00000">'''Warning: The configurations you make here will be applied only after restarting the ComManager service!'''</span><br />
<br />
;HVS32 Main Directory: <br />
:Specify the path to HVS32 here<br />
;HVS32 Database File:<br />
:Specify the path to the HVS32 database file<br />
;HVS32 Database Server:<br />
:IP address or hostname of the PC where the database is located<br />
;HVS32 Database Port:<br />
:The port for the HVS32 database usually does not need adjustment. The default port is set to 3050.<br />
;REST Port<br />
:Communication port through which the ComManager service is accessible via REST. This port must be opened in the server's firewall for external communication with the clients.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Configuration Window of Service Settings]]<br />
|}<br />
<br />
==Configure ErrorHandler==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|If an ErrorHandler is configured, you will be notified by email in case of a failed transmission. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
;Mode<br />
:First of all, you have to choose wich mode you want to use to send error mails<br />
<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
To send the error mails via SMTP choose the mode "SMTP" and enter the following parameters:<br />
;SMTP Server<br />
:IP address or hostname where the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and enable authentication.<br />
;SMTP Port<br />
:Port at which the SMTP server is accessible (25, 465, 587)<br />
;SSL enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS enabled<br />
:Data sent will be encrypted via Transport Layer Security, provided the SMTP server supports it.<br />
;TLS required<br />
:The server is requested to provide TLS support.<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
To send the error mails via Microsoft Office365 choose the mode "O365" and enter the following parameters:<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure ([[#Microsoft_Azure_configuration_for_Microsoft_Office365_.28O365.29_support|see '''Azure configuration''']])<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:Dies This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br />
===General===<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and will be displayed as the sender address for emails sent through this module.<br />
;Subject<br />
:This text will be used as the subject when sending the emails.<br />
<br />
;Test<br />
:You can use this option to send a test message to verify the configured parameters.<br />
<br />
<br />
<br />
|}<br />
<br />
==Modules==<br />
[[File:ComManager_Modules_EN.png|360px|thumb|right|Modules]]<br />
;1 - Overview of configured modules<br />
:'''Module ID''' - Selection and assignment of the module in HVS32 is done through this ID<br />
:'''Module Type''' - Type/category of module; the abbreviation "U" / "D" in parentheses indicates whether it is a '''D'''ownload (e.g., route download) or '''U'''pload module (FFFile, Wawi return, etc.)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will cause errors in process handling.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, it will cause errors in process handling.<br />
;3 - Summary of the configuration of the selected server<br />
<br />
[[File:ComManager_AddModul.png|340px|thumb|right|Add Module]]<br />
;Add / configure module<br />
Communication between HVS32 and the specified server occurs through modules. Such a server can be either a separate [[HVS32_Communication_Manager(en)#Server|(SMTP) server]] or directly the carrier's or customer's server.<br />
<br />
After selecting the module type (FTP, SFTP, SMTP, PLD/UPS, HTTP), the configuration of the new module takes place. In the following dialog, you can adjust the corresponding parameters.<br />
<br />
;Module Type<br />
:'''Carrier Module''' - Standard choice for uploading FF files during daily closing<br />
:'''Additional Transmission''' - Customer-specific transmission of, for example, Wawi return files to a customer's server<br />
:'''Download''' - Special module type for downloading, e.g., route files<br />
;Module ID<br />
:An automatically generated ID for the selection and assignment of the module in HVS32<br />
;Carrier<br />
:Additional restriction of the module for the use of specific carrier modules in HVS32 (exclusively for FF file transmission)<br />
;Principal<br />
:Additional restriction of the module for the use of specific principals/clients in HVS32 (exclusively for FF file transmission)<br />
;Note<br />
:Optional note for better overview (displayed in the overview and in HVS32)<br />
<br />
===Configure FTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;FTP Server: <br />
:IP address or hostname of the server<br />
;FTP Port: <br />
:Port at which the server is accessible (Default port 21) <br />
;FTP User<br />
:Username for authentication on the FTP server <br />
;FTP Password<br />
:Password for authentication on the FTP server <br />
;FTP Account<br />
:FTP account for authentication on the FTP server<br />
;FTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the FTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "FTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;FTP Transfer Mode<br />
:Specify whether the data should be transferred as binary or text.<br />
;FTP Security <br />
:;FTPS <br />
::FTP over Secure Socket Layer (SSL) implicitly<br />
:;FTPES: <br />
::FTP over Secure Socket Layer (SSL) explicitly. (Here, the server can allow insecure connections as well)<br />
;FTP Connection<br />
:Choose the method for establishing the connection. PASSIVE should be chosen by default.<br />
;Proxy: <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the FTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_FTPModulConf.png|thumb|right|FTP Upload Module Configuration]]<br />
[[File:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SFTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SFTP Server <br />
:IP address or hostname of the server<br />
;SFTP Port<br />
:Port at which the server is accessible (Default port 22)<br />
;SFTP User<br />
:Username for authentication on the SFTP server <br />
;SFTP Password<br />
:Password for authentication on the SFTP server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:If you are using a private key, you can specify the path to the file here.<br />
;Passphrase<br />
:Enter your passphrase here to decrypt the file mentioned above<br />
;SFTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the SFTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "SFTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;Timeout (ms)<br />
:Time in milliseconds that the connection setup and individual communication steps can take at most (standard 30000ms).<br />
:In the configuration dialog itself, a timeout of 5000ms is used regardless of the setting to test the connection more quickly.<br />
;Proxy <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
<br />
'''If you encounter the error "Algorithm negotiation fail" during the connection test, it is usually because the SFTP server uses old security algorithms such as ssh-dss, which are no longer supported. In this case, check the box "Prefer Old Algorithms" or "prefer old algorithms" to enforce support for the old security algorithms.'''<br />
<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the SFTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Module Configuration]]<br />
[[File:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SMTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SMTP Server<br />
:Choose an SMTP server that you have configured in the "Server" tab. You can find a detailed description under '''[[#Configure SMTP Server|Configure SMTP Server]]'''.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and is used as the sender address for emails sent via this module.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Subject<br />
:This text is used as the subject when sending emails.<br />
;Email Content (PLAIN Text)<br />
:Unformatted message text for the outgoing email.<br />
;Email Content (HTML Text)<br />
:HTML-compliant formatted message text for the outgoing email.<br />
<br />
Testing is done for SMTP modules via the '''Test button''' in the configuration dialog of the corresponding '''server'''.<br />
<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_SMTPModulConf.png|thumb|super|SMTP Module Configuration]]<br />
<br />
|}<br />
<br />
===Configure PLD Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;PLD Server <br />
:HTTPS URL of the server<br />
;PLD Path <br />
:Destination path on the HTTPS server<br />
;PLD Port<br />
:Port under which the server is reachable (Default port 443)<br />
;PLD User<br />
:Username for authentication on the HTTPS server<br />
;PLD Password<br />
:Password for authentication on the HTTPS server<br />
;PLD-Report Storage Path<br />
:Here, the path to a subfolder is specified where the feedback/report files from the PLD server will be saved.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_PLDModulConf.png|thumb|super|PLD Module Configuration]]<br />
|}<br />
<br />
===Configure HTTP(S) Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;HTTP(S) URL <br />
:The HTTP or HTTPS URL with function path and, if applicable, a different port of the server.<br />
:Using the "parsable" option allows you to store the URL in the form of a script that can be edited and verified in an editing dialog "...".<br />
;HTTP User<br />
:Username for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;HTTP Password<br />
:Password for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;MIME-Type<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transfer'''.)<br />
:Content-Type of the request accepted by the server (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Directory<br />
:(This option is available only for the module type '''Download'''.)<br />
:Local default directory where downloaded files should be written. Depending on the process, the directory can be overridden by HVS32.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Module Configuration]]<br />
[[File:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Download Module Configuration]]<br />
|}<br />
<br />
==Servers==<br />
[[File:ComManager_Server.png|360px|thumb|right|Servers]]<br />
;1 - Overview of configured communication servers<br />
:'''Server ID''' - Selection and assignment of the server in the modules are done based on this ID<br />
:'''Server Type''' - Server Type/Category (SMTP)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will lead to errors in process processing.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected server<br />
Keep the original file tag please<br />
<br />
===Configure SMTP Server===<br />
----<br />
[[File:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Configuration]]<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent via the server.<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;SMTP Server<br />
:IP address or hostname under which the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and activate authentication. <br />
;SMTP Port<br />
:Port under which the SMTP server is accessible (25, 465, 587)<br />
;SSL Enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS Enabled<br />
:Data sent will be encrypted via Transport Layer Security if the SMTP server supports it. <br />
;TLS Required<br />
:The server requires TLS support.<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
<br><br />
<br><br />
===Configure O365 Server (for Microsoft Office365)===<br />
----<br />
[[Datei:o365_commanager_02_add-server-2.png|300px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;from address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;from name<br />
:This name will be displayed as the sender's name.<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure ([[#Microsoft_Azure_configuration_for_Microsoft_Office365_.28O365.29_support|see '''Azure configuration''']])<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br />
==Proxies==<br />
[[File:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Overview of configured proxies<br />
:'''Proxy ID''' - Selection and assignment of the proxy is done based on this ID in the modules<br />
:'''Proxy Type''' - Proxy Type/Category (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Server name or IP address of the proxy<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Proxy''' - Option to add a new proxy<br />
:'''Copy Proxy''' - Allows duplicating the selected proxy with a new ID.<br />
:'''Rename Proxy''' - Opens an input dialog to change the ID. Note: If the proxy is in use, this will lead to errors in process processing.<br />
:'''Edit Proxy''' - Opens the proxy configuration dialog.<br />
:'''Remove Proxy''' - Deletes the proxy entry. This change is irreversible; if the proxy is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected proxy<br />
<br />
<br />
===Add/Configure Proxy===<br />
----<br />
[[File:ComManager_ProxyConf.png|300px|thumb|right|Proxy Configuration]]<br />
After entering the unique proxy ID, the configuration of the new proxy is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;PROXY Type<br />
:Determines the type of the deployed proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP address or hostname under which the proxy server is accessible.<br />
;PROXY Port <br />
:Port under which the proxy server is accessible <br />
;PROXY User<br />
:Username for authentication on the proxy server<br />
;PROXY Password<br />
:Password for authentication on the proxy server<br />
<br />
;NOTE<br />
:The FTP proxy type '''USER <User>@<Host>''' is configured directly in the '''FTP module''' and not as a proxy.<br />
:To do this, enter the data in the FTP module as follows: '''FTP Server = <FTP Proxy Host>''' and '''FTP User = <FTP User>@<FTP Server>'''<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
<br />
=Microsoft Azure Configuration for Microsoft Office365 (O365)=<br />
To send emails from ComManager via Microsoft Office365 (O365), you must first register an app in Azure, assign the appropriate permissions, and configure security features. This is necessary to obtain a valid Client ID, Client Secret, and Tenant ID, as well as to grant ComManager permission to send emails.<br><br />
Below, we show how to perform an '''example configuration'''.<br />
<br><br />
<br />
The following steps are required:<br><br />
<br><br />
# Navigate to the "App registrations" service in Azure '''''[A1]'''''<br />
# Click on "+ New registration" in the "App registration" menu '''''[A2]'''''<br />
# Enter a name for the application (e.g., "HSC-ComManager") and select a Single Tenant account type (e.g., "Accounts in this organizational directory only")<br>Redirect URIs are not required and can be ignored '''''[A3]'''''<br />
# After registration, click on the newly registered app (e.g., "HSC-ComManager") in the "App registrations" menu '''''[A4]'''''<br />
# In this overview, you will find the Application (client) ID and Directory (tenant) ID, which are important for ComManager '''''[A5]'''''<br />
# Click on "Add a certificate or secret" in this overview to add a Client Secret to the app. This is necessary for ComManager to authenticate later. '''''[A5]'''''<br />
# Click on "New client secret" in this overview '''''[A6]'''''<br />
# Enter a description for this secret (e.g., "HSC-ComManager-Secret") and select an expiration date for the secret. '''''[A7]'''''<br>'''Note: When the secret expires on the selected date (e.g., in 30 days), you must add a new secret and update it in ComManager. Otherwise, email sending from ComManager will no longer be possible. Be sure to set up a notification to renew the secret in time!'''<br />
# Copy the value of the secret ('''not the Secret ID'''). '''''[A8]'''''<br>'''Note: The secret value is only displayed now. You will not have access to it later!'''<br />
# Next, switch to the "API permissions" tab and add a permission to the app ("+ Add a permission") '''''[A9]'''''<br />
# Under "Microsoft APIs," select "Microsoft Graph" '''''[A10]'''''<br />
# Select "Application permissions," '''not''' "Delegated permissions" '''''[A11]'''''<br />
# Search for and select "Mail.Send" and add the permission '''''[A12]'''''<br />
# Depending on your user level, you or your administrator may need to explicitly confirm adding the permission ("Grant admin consent for ...") '''''[A13]'''''<br />
<br />
<br><br />
<br />
<gallery><br />
o365_azure_01_search.png|A1: App Registration<br />
o365_azure_02_new-app-registration.png|A2: App Registration<br />
o365_azure_03_register-app.png|A3: Register App<br />
o365_azure_04_edit-app.png|A4: Edit registered App<br />
o365_azure_05_edit-app-2.png|A5: Relevant Information / Add Client Secret<br />
o365_azure_06_add-secret.png|A6: New Client Secret<br />
o365_azure_07_add-secret-2.png|A7: Add Client Secret<br />
o365_azure_08_save-secret.png|A8: Copy Client Secret<br />
o365_azure_09_add-permission.png|A9: Add Permission to registered App<br />
o365_azure_10_add-permission-2.png|A10: Request API Permission (Graph)<br />
o365_azure_11_add-permission-3.png|A11: Request API Permission (Application)<br />
o365_azure_12_add-permission-4.png|A12: Add Mail.Send Permission<br />
o365_azure_13_add-permission-5.png|A13: Grant Admin Consent<br />
</gallery><br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Error Code ||Error Description||Troubleshooting<br />
|-<br />
|COM11C00100||Unknown error occurred while processing a Send Message job! Response is NULL!||This is a general error in processing a Send Message job. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unknown error occurred while processing an Upload job! Response is NULL!||This is a general error in processing an Upload job. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Error occurred while deleting temporary file(s) during processing of a Send Message job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM11W00210||Error occurred while deleting temporary file(s) during processing of an Upload job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00020||Error converting response to XML - Response is NULL||This is a general error in processing a request. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Error parsing XML data in REST function uploadFile||The data received from HVS32 for upload is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00110||Error creating module configuration for REST function uploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Error converting response to XML for REST function uploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00130||Error reading file(s) in REST function uploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory and if sufficient permissions for reading files are set for the Windows user SYSTEM (or the Windows user specified in Heidler-ComManager). Try repeating the operation.<br />
|-<br />
|COM21C00131||Error writing temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00200||Error parsing XML data in REST function downloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00210||Error creating module configuration for REST function downloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Error converting response to XML for REST function downloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00300||Error parsing XML data in REST function sendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00320||Error converting response to XML for REST function sendMessage||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Error reading file(s) in REST function sendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00331||Error writing temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00400||Error parsing XML data in REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00410||Error creating module configuration for REST function queueUploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Error converting response to XML for REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00430||Error reading file(s) in REST function queueUploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00431||Error writing temporary file(s) in REST function queueUploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00500||Error parsing XML data in REST function queueDownloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00510||Error creating module configuration for REST function queueDownloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Error converting response to XML for REST function queueDownloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00600||Error parsing XML data in REST function queueSendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00620||Error converting response to XML for REST function queueSendMessage||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00630||Error reading file(s) in REST function queueSendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00631||Error writing temporary file(s) in REST function queueSendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00700||Error loading main configuration in REST function getModuleList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Error reading main configuration in REST function getModuleList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Error converting response to XML for REST function getModuleList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00800||Error loading main configuration in REST function getServerList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Error reading main configuration in REST function getServerList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Error converting response to XML for REST function getServerList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00132||Error deleting temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00332||Error deleting temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00100||Error initializing HVS32 Database Manager||There was an error initializing the Database Manager. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00200||Error initializing write connections to HVS32 database||There was an error initializing the write connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00210||Error initializing prepared statements for updating FF file in HVS32 database||There was an error initializing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00220||Error updating FF file||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00225||Error updating FF file - no results found||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00230||Error initializing prepared statements for updating WaWi file in HVS32 database||There was an error initializing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00240||Error updating WaWi file||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00245||Error updating WaWi file - no results found||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00300||Error initializing read connections to HVS32 database||There was an error initializing the read connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00310||Error initializing prepared statements for reading FF file in HVS32 database||There was an error initializing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00320||Error reading FF file from HVS32 database||There was an error executing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00325||FF file not found in HVS32 database||The FF file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The FF file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00330||Error initializing prepared statements for reading WaWi file in HVS32 database||There was an error initializing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00340||Error reading WaWi file from HVS32 database||There was an error executing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00345||WaWi file not found in HVS32 database||The WaWi file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The WaWi file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM50C01100||Error instantiating the upload module||The module for the selected module ID for upload cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Failed to instantiate the upload module||The module for the selected module ID for upload could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Error initializing the upload module||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Error instantiating the download module||The module for the selected module ID for download cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Failed to instantiate the download module||The module for the selected module ID for download could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Error initializing the download module||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Error instantiating the SendMessage module||The server module for the selected server module ID for SendMessage cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Failed to instantiate the SendMessage module||The server module for the selected server module ID for SendMessage could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Error initializing the SendMessage module||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Error connecting to FTP server||There was an error connecting to the FTP server. Please check the configured FTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Error logging into FTP server||There was an error logging into the FTP server. Please check the configured login credentials (username/password) in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Error changing directory on FTP server||There was an error changing the directory on the FTP server. Please check the configured FTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Error uploading file to FTP server||There was an error uploading the FF file to the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00500||Error downloading file from FTP server||There was an error downloading the file from the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00410||Error renaming file on FTP server||There was an error renaming the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C00411||Error moving file on FTP server||There was an error moving the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C99999||Invocation of an unsupported function in FTP module||The invoked function is not supported by this FTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM52C00100||Error starting session on SFTP server||There was an error starting the session to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Error starting session on jump host for SFTP transmission||There was an error starting the session to the jump host. Please check the configured jump host settings in the SFTP server module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Error opening channel to SFTP server||There was an error opening the channel to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Error connecting to SFTP server||There was an error connecting to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Error changing directory on SFTP server||There was an error changing the directory on the SFTP server. Please check the configured SFTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Error uploading file to SFTP server||There was an error uploading the FF file to the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00510||Error uploading file to SFTP server - Access denied!||There was an error uploading the FF file to the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C00520||Error renaming file on SFTP server||There was an error renaming the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00521||Error moving file on SFTP server||There was an error moving the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00600||Error downloading file from SFTP server||There was an error downloading the file from the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00610||Error downloading file from SFTP server - Access denied!||There was an error downloading the file from the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C99999||Invocation of an unsupported function in SFTP module||The invoked function is not supported by this SFTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM53C00100||SMTP configuration not found||There was an error in the configuration of the SMTP module. Please check the selected SMTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00101||Illegal parameters in SMTP configuration - recipient address is empty!||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00102||Illegal parameters in SMTP configuration - subject is empty!||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00103||Illegal parameters in SMTP configuration - mail text is empty!||There was an error in the configuration of the SMTP module. Please check the configured mail text in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00105||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00110||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00111||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00112||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00120||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00130||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00131||Error setting recipient address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00132||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00133||Error setting BCC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured BCC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00134||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00135||Error setting subject in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00200||No SMTP data found from HVS32||No SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00201||Invalid SMTP data from HVS32||Invalid SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00202||Illegal parameters in SMTP data from HVS32 - recipient address is empty!||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53C00203||Illegal parameters in SMTP data from HVS32 - subject is empty!||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00204||Illegal parameters in SMTP data from HVS32 - mail text is empty!||There was an error in the configuration of HVS32. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00205||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00210||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in HVS32 Configurator.<br />
|-<br />
|COM53C00211||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00212||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00220||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00230||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00231||Error setting recipient address in SMTP module||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53W00232||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in HVS32 Configurator.<br />
|-<br />
|COM53W00233||Error setting BCC address in SMTP module||There was an error in the configuration of HVS32. Please check the configured BCC address in HVS32 Configurator.<br />
|-<br />
|COM53W00234||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in HVS32 Configurator.<br />
|-<br />
|COM53W00235||Error setting subject in SMTP module||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00300||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00400||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C99999||Invocation of an unsupported function in SMTP module||The invoked function is not supported by this SMTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54C99999||Invocation of an unsupported function in PLD module||The invoked function is not supported by this PLD module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54W03005||3005 PLD Warning - File already transmitted!||The carrier file has already been transmitted and therefore could not be accepted by the UPS server. Please do not transmit this file again.<br />
|-<br />
|COM54W06930||6930 PLD Warning - Data uploaded with warnings. Please correct before the next upload!||The carrier file has been successfully transmitted to the UPS server and processed. The file does not need to be transmitted again. However, there are content errors in the FF file that need to be fixed before the next day's closure. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06931||6931 PLD Error - Upload failed due to errors in the PLD data.||The carrier file has been transmitted to the UPS server but was NOT processed due to errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06932||6932 Severe PLD Error - Upload failed due to errors in the input parameters.||The carrier file has been transmitted to the UPS server but was NOT processed due to SERIOUS errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06933||Unknown PLD Error - Upload failed due to unknown errors.||The carrier file has been transmitted to the UPS server but was NOT processed due to unknown errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C01000||Error in feedback - no status code found!||An error was detected in the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54C01100||Error parsing the feedback||There was an error parsing the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54W01200||Error saving the report file(s)||There was an error saving the reports from the UPS server. Please check the configured storage path in the corresponding PLD module configuration of HVS32CommunicationManager, as well as the user rights of this directory.<br />
|-<br />
|COM54C02000||HTTPS connection not ready!||There was an error connecting to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C03000||Error reading the EDI file||There was an error reading the FF file in the PLD module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C04000||Error transmitting data to the UPS server||There was an error transmitting data to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C02000||HTTP(S) connection not ready!||There was an error connecting to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C04000||Error transmitting data to the HTTP(S) server||There was an error transmitting data to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C05000||Error downloading file from the HTTP(S) server||There was an error downloading the file from the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C99999||Invocation of an unsupported function in HTTP module||The invoked function is not supported by this HTTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager(en)&diff=6108
HVS32 Communication Manager(en)
2025-03-19T10:57:52Z
<p>Bhauser: </p>
<hr />
<div>[[de:HVS32_Communication_Manager]]<br />
The Communication Manager (hereafter abbreviated as ComManager) is a service that centrally manages communication between HVS32 and customers or HVS32 and carriers. The ComManager is designed for communications via FTP, SFTP, or SMTP protocols.<br />
<br />
Similar to WinSCP, this service is controlled by HVS32 and sends data to the destination server configured in the module.<br />
<br />
It is intended to gradually take over communications from HVS32 and replace other external transmission programs such as WinSCP.<br />
<br />
=ComManager Configuration=<br />
The ComManager Configurator can be accessed either directly through the ''ComManager-Configurator.exe'' in the installation directory ''...Heidler\HVS32\ComManager\'' or from the [[Setting up Communication Manager in HVS32|HVS32 Configurator]].<br />
<br />
[[Datei:ComManager-Main Window EN.png|500px|thumb|ohne|ComManager main window]]<br />
<br />
;1 - Link to this wiki entry<br />
;2 - Selection Tabs<br />
:'''[[HVS32_Communication_Manager(en)#Modules|Modules]]''' - Modules for file transmission during daily closing, Wawi return, and route downloads<br />
:'''[[HVS32_Communication_Manager(en)#Servers|Servers]]''' - Internal communication servers such as Microsoft Exchange (SMTP) connections<br />
:'''[[HVS32_Communication_Manager(en)#Proxies|Proxy]]''' - Internal proxy servers<br />
;3 - Overview of configured modules<br />
;4 - Summary of the configuration of the selected module<br />
;5 - [[HVS32_Communication_Manager(en)#Configure_ErrorHandler|Errorhandler Configuration]]<br />
;6 - [[HVS32_Communication_Manager(en)#Service_Settings|Service Settings]]<br />
<br />
==Service Settings==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|In this section, the basic settings of the ComManager service are configured, which are necessary to establish a connection to the service. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
<span style="color:#C00000">'''Warning: The configurations you make here will be applied only after restarting the ComManager service!'''</span><br />
<br />
;HVS32 Main Directory: <br />
:Specify the path to HVS32 here<br />
;HVS32 Database File:<br />
:Specify the path to the HVS32 database file<br />
;HVS32 Database Server:<br />
:IP address or hostname of the PC where the database is located<br />
;HVS32 Database Port:<br />
:The port for the HVS32 database usually does not need adjustment. The default port is set to 3050.<br />
;REST Port<br />
:Communication port through which the ComManager service is accessible via REST. This port must be opened in the server's firewall for external communication with the clients.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Configuration Window of Service Settings]]<br />
|}<br />
<br />
==Configure ErrorHandler==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|If an ErrorHandler is configured, you will be notified by email in case of a failed transmission. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
;Mode<br />
:First of all, you have to choose wich mode you want to use to send error mails<br />
<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
To send the error mails via SMTP choose the mode "SMTP" and enter the following parameters:<br />
;SMTP Server<br />
:IP address or hostname where the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and enable authentication.<br />
;SMTP Port<br />
:Port at which the SMTP server is accessible (25, 465, 587)<br />
;SSL enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS enabled<br />
:Data sent will be encrypted via Transport Layer Security, provided the SMTP server supports it.<br />
;TLS required<br />
:The server is requested to provide TLS support.<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
To send the error mails via Microsoft Office365 choose the mode "O365" and enter the following parameters:<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure ([[#Microsoft_Azure_configuration_for_Microsoft_Office365_.28O365.29_support|see '''Azure configuration''']])<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:Dies This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br />
===General===<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and will be displayed as the sender address for emails sent through this module.<br />
;Subject<br />
:This text will be used as the subject when sending the emails.<br />
<br />
;Test<br />
:You can use this option to send a test message to verify the configured parameters.<br />
<br />
<br />
<br />
|}<br />
<br />
==Modules==<br />
[[File:ComManager_Modules_EN.png|360px|thumb|right|Modules]]<br />
;1 - Overview of configured modules<br />
:'''Module ID''' - Selection and assignment of the module in HVS32 is done through this ID<br />
:'''Module Type''' - Type/category of module; the abbreviation "U" / "D" in parentheses indicates whether it is a '''D'''ownload (e.g., route download) or '''U'''pload module (FFFile, Wawi return, etc.)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will cause errors in process handling.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, it will cause errors in process handling.<br />
;3 - Summary of the configuration of the selected server<br />
<br />
[[File:ComManager_AddModul.png|340px|thumb|right|Add Module]]<br />
;Add / configure module<br />
Communication between HVS32 and the specified server occurs through modules. Such a server can be either a separate [[HVS32_Communication_Manager(en)#Server|(SMTP) server]] or directly the carrier's or customer's server.<br />
<br />
After selecting the module type (FTP, SFTP, SMTP, PLD/UPS, HTTP), the configuration of the new module takes place. In the following dialog, you can adjust the corresponding parameters.<br />
<br />
;Module Type<br />
:'''Carrier Module''' - Standard choice for uploading FF files during daily closing<br />
:'''Additional Transmission''' - Customer-specific transmission of, for example, Wawi return files to a customer's server<br />
:'''Download''' - Special module type for downloading, e.g., route files<br />
;Module ID<br />
:An automatically generated ID for the selection and assignment of the module in HVS32<br />
;Carrier<br />
:Additional restriction of the module for the use of specific carrier modules in HVS32 (exclusively for FF file transmission)<br />
;Principal<br />
:Additional restriction of the module for the use of specific principals/clients in HVS32 (exclusively for FF file transmission)<br />
;Note<br />
:Optional note for better overview (displayed in the overview and in HVS32)<br />
<br />
===Configure FTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;FTP Server: <br />
:IP address or hostname of the server<br />
;FTP Port: <br />
:Port at which the server is accessible (Default port 21) <br />
;FTP User<br />
:Username for authentication on the FTP server <br />
;FTP Password<br />
:Password for authentication on the FTP server <br />
;FTP Account<br />
:FTP account for authentication on the FTP server<br />
;FTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the FTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "FTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;FTP Transfer Mode<br />
:Specify whether the data should be transferred as binary or text.<br />
;FTP Security <br />
:;FTPS <br />
::FTP over Secure Socket Layer (SSL) implicitly<br />
:;FTPES: <br />
::FTP over Secure Socket Layer (SSL) explicitly. (Here, the server can allow insecure connections as well)<br />
;FTP Connection<br />
:Choose the method for establishing the connection. PASSIVE should be chosen by default.<br />
;Proxy: <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the FTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_FTPModulConf.png|thumb|right|FTP Upload Module Configuration]]<br />
[[File:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SFTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SFTP Server <br />
:IP address or hostname of the server<br />
;SFTP Port<br />
:Port at which the server is accessible (Default port 22)<br />
;SFTP User<br />
:Username for authentication on the SFTP server <br />
;SFTP Password<br />
:Password for authentication on the SFTP server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:If you are using a private key, you can specify the path to the file here.<br />
;Passphrase<br />
:Enter your passphrase here to decrypt the file mentioned above<br />
;SFTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the SFTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "SFTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;Timeout (ms)<br />
:Time in milliseconds that the connection setup and individual communication steps can take at most (standard 30000ms).<br />
:In the configuration dialog itself, a timeout of 5000ms is used regardless of the setting to test the connection more quickly.<br />
;Proxy <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
<br />
'''If you encounter the error "Algorithm negotiation fail" during the connection test, it is usually because the SFTP server uses old security algorithms such as ssh-dss, which are no longer supported. In this case, check the box "Prefer Old Algorithms" or "prefer old algorithms" to enforce support for the old security algorithms.'''<br />
<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the SFTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Module Configuration]]<br />
[[File:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SMTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SMTP Server<br />
:Choose an SMTP server that you have configured in the "Server" tab. You can find a detailed description under '''[[#Configure SMTP Server|Configure SMTP Server]]'''.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and is used as the sender address for emails sent via this module.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Subject<br />
:This text is used as the subject when sending emails.<br />
;Email Content (PLAIN Text)<br />
:Unformatted message text for the outgoing email.<br />
;Email Content (HTML Text)<br />
:HTML-compliant formatted message text for the outgoing email.<br />
<br />
Testing is done for SMTP modules via the '''Test button''' in the configuration dialog of the corresponding '''server'''.<br />
<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_SMTPModulConf.png|thumb|super|SMTP Module Configuration]]<br />
<br />
|}<br />
<br />
===Configure PLD Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;PLD Server <br />
:HTTPS URL of the server<br />
;PLD Path <br />
:Destination path on the HTTPS server<br />
;PLD Port<br />
:Port under which the server is reachable (Default port 443)<br />
;PLD User<br />
:Username for authentication on the HTTPS server<br />
;PLD Password<br />
:Password for authentication on the HTTPS server<br />
;PLD-Report Storage Path<br />
:Here, the path to a subfolder is specified where the feedback/report files from the PLD server will be saved.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_PLDModulConf.png|thumb|super|PLD Module Configuration]]<br />
|}<br />
<br />
===Configure HTTP(S) Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;HTTP(S) URL <br />
:The HTTP or HTTPS URL with function path and, if applicable, a different port of the server.<br />
:Using the "parsable" option allows you to store the URL in the form of a script that can be edited and verified in an editing dialog "...".<br />
;HTTP User<br />
:Username for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;HTTP Password<br />
:Password for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;MIME-Type<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transfer'''.)<br />
:Content-Type of the request accepted by the server (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Directory<br />
:(This option is available only for the module type '''Download'''.)<br />
:Local default directory where downloaded files should be written. Depending on the process, the directory can be overridden by HVS32.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Module Configuration]]<br />
[[File:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Download Module Configuration]]<br />
|}<br />
<br />
==Servers==<br />
[[File:ComManager_Server.png|360px|thumb|right|Servers]]<br />
;1 - Overview of configured communication servers<br />
:'''Server ID''' - Selection and assignment of the server in the modules are done based on this ID<br />
:'''Server Type''' - Server Type/Category (SMTP)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will lead to errors in process processing.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected server<br />
Keep the original file tag please<br />
<br />
===Configure SMTP Server===<br />
----<br />
[[File:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Configuration]]<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent via the server.<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;SMTP Server<br />
:IP address or hostname under which the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and activate authentication. <br />
;SMTP Port<br />
:Port under which the SMTP server is accessible (25, 465, 587)<br />
;SSL Enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS Enabled<br />
:Data sent will be encrypted via Transport Layer Security if the SMTP server supports it. <br />
;TLS Required<br />
:The server requires TLS support.<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
<br><br />
<br><br />
===O365 Server (für Microsoft Office365) konfigurieren===<br />
----<br />
[[Datei:o365_commanager_02_add-server-2.png|300px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;from address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;from name<br />
:This name will be displayed as the sender's name.<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure ([[#Microsoft_Azure_configuration_for_Microsoft_Office365_.28O365.29_support|see '''Azure configuration''']])<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
==Proxies==<br />
[[File:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Overview of configured proxies<br />
:'''Proxy ID''' - Selection and assignment of the proxy is done based on this ID in the modules<br />
:'''Proxy Type''' - Proxy Type/Category (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Server name or IP address of the proxy<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Proxy''' - Option to add a new proxy<br />
:'''Copy Proxy''' - Allows duplicating the selected proxy with a new ID.<br />
:'''Rename Proxy''' - Opens an input dialog to change the ID. Note: If the proxy is in use, this will lead to errors in process processing.<br />
:'''Edit Proxy''' - Opens the proxy configuration dialog.<br />
:'''Remove Proxy''' - Deletes the proxy entry. This change is irreversible; if the proxy is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected proxy<br />
<br />
<br />
===Add/Configure Proxy===<br />
----<br />
[[File:ComManager_ProxyConf.png|300px|thumb|right|Proxy Configuration]]<br />
After entering the unique proxy ID, the configuration of the new proxy is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;PROXY Type<br />
:Determines the type of the deployed proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP address or hostname under which the proxy server is accessible.<br />
;PROXY Port <br />
:Port under which the proxy server is accessible <br />
;PROXY User<br />
:Username for authentication on the proxy server<br />
;PROXY Password<br />
:Password for authentication on the proxy server<br />
<br />
;NOTE<br />
:The FTP proxy type '''USER <User>@<Host>''' is configured directly in the '''FTP module''' and not as a proxy.<br />
:To do this, enter the data in the FTP module as follows: '''FTP Server = <FTP Proxy Host>''' and '''FTP User = <FTP User>@<FTP Server>'''<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
<br />
=Microsoft Azure Configuration for Microsoft Office365 (O365)=<br />
To send emails from ComManager via Microsoft Office365 (O365), you must first register an app in Azure, assign the appropriate permissions, and configure security features. This is necessary to obtain a valid Client ID, Client Secret, and Tenant ID, as well as to grant ComManager permission to send emails.<br><br />
Below, we show how to perform an '''example configuration'''.<br />
<br><br />
<br />
The following steps are required:<br><br />
<br><br />
# Navigate to the "App registrations" service in Azure '''''[A1]'''''<br />
# Click on "+ New registration" in the "App registration" menu '''''[A2]'''''<br />
# Enter a name for the application (e.g., "HSC-ComManager") and select a Single Tenant account type (e.g., "Accounts in this organizational directory only")<br>Redirect URIs are not required and can be ignored '''''[A3]'''''<br />
# After registration, click on the newly registered app (e.g., "HSC-ComManager") in the "App registrations" menu '''''[A4]'''''<br />
# In this overview, you will find the Application (client) ID and Directory (tenant) ID, which are important for ComManager '''''[A5]'''''<br />
# Click on "Add a certificate or secret" in this overview to add a Client Secret to the app. This is necessary for ComManager to authenticate later. '''''[A5]'''''<br />
# Click on "New client secret" in this overview '''''[A6]'''''<br />
# Enter a description for this secret (e.g., "HSC-ComManager-Secret") and select an expiration date for the secret. '''''[A7]'''''<br>'''Note: When the secret expires on the selected date (e.g., in 30 days), you must add a new secret and update it in ComManager. Otherwise, email sending from ComManager will no longer be possible. Be sure to set up a notification to renew the secret in time!'''<br />
# Copy the value of the secret ('''not the Secret ID'''). '''''[A8]'''''<br>'''Note: The secret value is only displayed now. You will not have access to it later!'''<br />
# Next, switch to the "API permissions" tab and add a permission to the app ("+ Add a permission") '''''[A9]'''''<br />
# Under "Microsoft APIs," select "Microsoft Graph" '''''[A10]'''''<br />
# Select "Application permissions," '''not''' "Delegated permissions" '''''[A11]'''''<br />
# Search for and select "Mail.Send" and add the permission '''''[A12]'''''<br />
# Depending on your user level, you or your administrator may need to explicitly confirm adding the permission ("Grant admin consent for ...") '''''[A13]'''''<br />
<br />
<br><br />
<br />
<gallery><br />
o365_azure_01_search.png|A1: App Registration<br />
o365_azure_02_new-app-registration.png|A2: App Registration<br />
o365_azure_03_register-app.png|A3: Register App<br />
o365_azure_04_edit-app.png|A4: Edit registered App<br />
o365_azure_05_edit-app-2.png|A5: Relevant Information / Add Client Secret<br />
o365_azure_06_add-secret.png|A6: New Client Secret<br />
o365_azure_07_add-secret-2.png|A7: Add Client Secret<br />
o365_azure_08_save-secret.png|A8: Copy Client Secret<br />
o365_azure_09_add-permission.png|A9: Add Permission to registered App<br />
o365_azure_10_add-permission-2.png|A10: Request API Permission (Graph)<br />
o365_azure_11_add-permission-3.png|A11: Request API Permission (Application)<br />
o365_azure_12_add-permission-4.png|A12: Add Mail.Send Permission<br />
o365_azure_13_add-permission-5.png|A13: Grant Admin Consent<br />
</gallery><br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Error Code ||Error Description||Troubleshooting<br />
|-<br />
|COM11C00100||Unknown error occurred while processing a Send Message job! Response is NULL!||This is a general error in processing a Send Message job. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unknown error occurred while processing an Upload job! Response is NULL!||This is a general error in processing an Upload job. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Error occurred while deleting temporary file(s) during processing of a Send Message job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM11W00210||Error occurred while deleting temporary file(s) during processing of an Upload job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00020||Error converting response to XML - Response is NULL||This is a general error in processing a request. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Error parsing XML data in REST function uploadFile||The data received from HVS32 for upload is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00110||Error creating module configuration for REST function uploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Error converting response to XML for REST function uploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00130||Error reading file(s) in REST function uploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory and if sufficient permissions for reading files are set for the Windows user SYSTEM (or the Windows user specified in Heidler-ComManager). Try repeating the operation.<br />
|-<br />
|COM21C00131||Error writing temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00200||Error parsing XML data in REST function downloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00210||Error creating module configuration for REST function downloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Error converting response to XML for REST function downloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00300||Error parsing XML data in REST function sendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00320||Error converting response to XML for REST function sendMessage||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Error reading file(s) in REST function sendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00331||Error writing temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00400||Error parsing XML data in REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00410||Error creating module configuration for REST function queueUploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Error converting response to XML for REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00430||Error reading file(s) in REST function queueUploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00431||Error writing temporary file(s) in REST function queueUploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00500||Error parsing XML data in REST function queueDownloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00510||Error creating module configuration for REST function queueDownloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Error converting response to XML for REST function queueDownloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00600||Error parsing XML data in REST function queueSendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00620||Error converting response to XML for REST function queueSendMessage||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00630||Error reading file(s) in REST function queueSendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00631||Error writing temporary file(s) in REST function queueSendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00700||Error loading main configuration in REST function getModuleList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Error reading main configuration in REST function getModuleList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Error converting response to XML for REST function getModuleList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00800||Error loading main configuration in REST function getServerList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Error reading main configuration in REST function getServerList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Error converting response to XML for REST function getServerList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00132||Error deleting temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00332||Error deleting temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00100||Error initializing HVS32 Database Manager||There was an error initializing the Database Manager. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00200||Error initializing write connections to HVS32 database||There was an error initializing the write connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00210||Error initializing prepared statements for updating FF file in HVS32 database||There was an error initializing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00220||Error updating FF file||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00225||Error updating FF file - no results found||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00230||Error initializing prepared statements for updating WaWi file in HVS32 database||There was an error initializing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00240||Error updating WaWi file||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00245||Error updating WaWi file - no results found||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00300||Error initializing read connections to HVS32 database||There was an error initializing the read connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00310||Error initializing prepared statements for reading FF file in HVS32 database||There was an error initializing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00320||Error reading FF file from HVS32 database||There was an error executing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00325||FF file not found in HVS32 database||The FF file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The FF file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00330||Error initializing prepared statements for reading WaWi file in HVS32 database||There was an error initializing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00340||Error reading WaWi file from HVS32 database||There was an error executing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00345||WaWi file not found in HVS32 database||The WaWi file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The WaWi file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM50C01100||Error instantiating the upload module||The module for the selected module ID for upload cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Failed to instantiate the upload module||The module for the selected module ID for upload could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Error initializing the upload module||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Error instantiating the download module||The module for the selected module ID for download cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Failed to instantiate the download module||The module for the selected module ID for download could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Error initializing the download module||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Error instantiating the SendMessage module||The server module for the selected server module ID for SendMessage cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Failed to instantiate the SendMessage module||The server module for the selected server module ID for SendMessage could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Error initializing the SendMessage module||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Error connecting to FTP server||There was an error connecting to the FTP server. Please check the configured FTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Error logging into FTP server||There was an error logging into the FTP server. Please check the configured login credentials (username/password) in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Error changing directory on FTP server||There was an error changing the directory on the FTP server. Please check the configured FTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Error uploading file to FTP server||There was an error uploading the FF file to the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00500||Error downloading file from FTP server||There was an error downloading the file from the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00410||Error renaming file on FTP server||There was an error renaming the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C00411||Error moving file on FTP server||There was an error moving the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C99999||Invocation of an unsupported function in FTP module||The invoked function is not supported by this FTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM52C00100||Error starting session on SFTP server||There was an error starting the session to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Error starting session on jump host for SFTP transmission||There was an error starting the session to the jump host. Please check the configured jump host settings in the SFTP server module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Error opening channel to SFTP server||There was an error opening the channel to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Error connecting to SFTP server||There was an error connecting to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Error changing directory on SFTP server||There was an error changing the directory on the SFTP server. Please check the configured SFTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Error uploading file to SFTP server||There was an error uploading the FF file to the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00510||Error uploading file to SFTP server - Access denied!||There was an error uploading the FF file to the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C00520||Error renaming file on SFTP server||There was an error renaming the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00521||Error moving file on SFTP server||There was an error moving the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00600||Error downloading file from SFTP server||There was an error downloading the file from the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00610||Error downloading file from SFTP server - Access denied!||There was an error downloading the file from the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C99999||Invocation of an unsupported function in SFTP module||The invoked function is not supported by this SFTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM53C00100||SMTP configuration not found||There was an error in the configuration of the SMTP module. Please check the selected SMTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00101||Illegal parameters in SMTP configuration - recipient address is empty!||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00102||Illegal parameters in SMTP configuration - subject is empty!||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00103||Illegal parameters in SMTP configuration - mail text is empty!||There was an error in the configuration of the SMTP module. Please check the configured mail text in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00105||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00110||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00111||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00112||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00120||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00130||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00131||Error setting recipient address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00132||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00133||Error setting BCC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured BCC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00134||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00135||Error setting subject in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00200||No SMTP data found from HVS32||No SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00201||Invalid SMTP data from HVS32||Invalid SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00202||Illegal parameters in SMTP data from HVS32 - recipient address is empty!||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53C00203||Illegal parameters in SMTP data from HVS32 - subject is empty!||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00204||Illegal parameters in SMTP data from HVS32 - mail text is empty!||There was an error in the configuration of HVS32. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00205||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00210||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in HVS32 Configurator.<br />
|-<br />
|COM53C00211||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00212||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00220||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00230||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00231||Error setting recipient address in SMTP module||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53W00232||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in HVS32 Configurator.<br />
|-<br />
|COM53W00233||Error setting BCC address in SMTP module||There was an error in the configuration of HVS32. Please check the configured BCC address in HVS32 Configurator.<br />
|-<br />
|COM53W00234||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in HVS32 Configurator.<br />
|-<br />
|COM53W00235||Error setting subject in SMTP module||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00300||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00400||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C99999||Invocation of an unsupported function in SMTP module||The invoked function is not supported by this SMTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54C99999||Invocation of an unsupported function in PLD module||The invoked function is not supported by this PLD module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54W03005||3005 PLD Warning - File already transmitted!||The carrier file has already been transmitted and therefore could not be accepted by the UPS server. Please do not transmit this file again.<br />
|-<br />
|COM54W06930||6930 PLD Warning - Data uploaded with warnings. Please correct before the next upload!||The carrier file has been successfully transmitted to the UPS server and processed. The file does not need to be transmitted again. However, there are content errors in the FF file that need to be fixed before the next day's closure. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06931||6931 PLD Error - Upload failed due to errors in the PLD data.||The carrier file has been transmitted to the UPS server but was NOT processed due to errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06932||6932 Severe PLD Error - Upload failed due to errors in the input parameters.||The carrier file has been transmitted to the UPS server but was NOT processed due to SERIOUS errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06933||Unknown PLD Error - Upload failed due to unknown errors.||The carrier file has been transmitted to the UPS server but was NOT processed due to unknown errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C01000||Error in feedback - no status code found!||An error was detected in the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54C01100||Error parsing the feedback||There was an error parsing the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54W01200||Error saving the report file(s)||There was an error saving the reports from the UPS server. Please check the configured storage path in the corresponding PLD module configuration of HVS32CommunicationManager, as well as the user rights of this directory.<br />
|-<br />
|COM54C02000||HTTPS connection not ready!||There was an error connecting to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C03000||Error reading the EDI file||There was an error reading the FF file in the PLD module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C04000||Error transmitting data to the UPS server||There was an error transmitting data to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C02000||HTTP(S) connection not ready!||There was an error connecting to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C04000||Error transmitting data to the HTTP(S) server||There was an error transmitting data to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C05000||Error downloading file from the HTTP(S) server||There was an error downloading the file from the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C99999||Invocation of an unsupported function in HTTP module||The invoked function is not supported by this HTTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager(en)&diff=6107
HVS32 Communication Manager(en)
2025-03-19T10:42:11Z
<p>Bhauser: /* O365 */</p>
<hr />
<div>[[de:HVS32_Communication_Manager]]<br />
The Communication Manager (hereafter abbreviated as ComManager) is a service that centrally manages communication between HVS32 and customers or HVS32 and carriers. The ComManager is designed for communications via FTP, SFTP, or SMTP protocols.<br />
<br />
Similar to WinSCP, this service is controlled by HVS32 and sends data to the destination server configured in the module.<br />
<br />
It is intended to gradually take over communications from HVS32 and replace other external transmission programs such as WinSCP.<br />
<br />
=ComManager Configuration=<br />
The ComManager Configurator can be accessed either directly through the ''ComManager-Configurator.exe'' in the installation directory ''...Heidler\HVS32\ComManager\'' or from the [[Setting up Communication Manager in HVS32|HVS32 Configurator]].<br />
<br />
[[Datei:ComManager-Main Window EN.png|500px|thumb|ohne|ComManager main window]]<br />
<br />
;1 - Link to this wiki entry<br />
;2 - Selection Tabs<br />
:'''[[HVS32_Communication_Manager(en)#Modules|Modules]]''' - Modules for file transmission during daily closing, Wawi return, and route downloads<br />
:'''[[HVS32_Communication_Manager(en)#Servers|Servers]]''' - Internal communication servers such as Microsoft Exchange (SMTP) connections<br />
:'''[[HVS32_Communication_Manager(en)#Proxies|Proxy]]''' - Internal proxy servers<br />
;3 - Overview of configured modules<br />
;4 - Summary of the configuration of the selected module<br />
;5 - [[HVS32_Communication_Manager(en)#Configure_ErrorHandler|Errorhandler Configuration]]<br />
;6 - [[HVS32_Communication_Manager(en)#Service_Settings|Service Settings]]<br />
<br />
==Service Settings==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|In this section, the basic settings of the ComManager service are configured, which are necessary to establish a connection to the service. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
<span style="color:#C00000">'''Warning: The configurations you make here will be applied only after restarting the ComManager service!'''</span><br />
<br />
;HVS32 Main Directory: <br />
:Specify the path to HVS32 here<br />
;HVS32 Database File:<br />
:Specify the path to the HVS32 database file<br />
;HVS32 Database Server:<br />
:IP address or hostname of the PC where the database is located<br />
;HVS32 Database Port:<br />
:The port for the HVS32 database usually does not need adjustment. The default port is set to 3050.<br />
;REST Port<br />
:Communication port through which the ComManager service is accessible via REST. This port must be opened in the server's firewall for external communication with the clients.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Configuration Window of Service Settings]]<br />
|}<br />
<br />
==Configure ErrorHandler==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|If an ErrorHandler is configured, you will be notified by email in case of a failed transmission. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
;Mode<br />
:First of all, you have to choose wich mode you want to use to send error mails<br />
<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
To send the error mails via SMTP choose the mode "SMTP" and enter the following parameters:<br />
;SMTP Server<br />
:IP address or hostname where the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and enable authentication.<br />
;SMTP Port<br />
:Port at which the SMTP server is accessible (25, 465, 587)<br />
;SSL enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS enabled<br />
:Data sent will be encrypted via Transport Layer Security, provided the SMTP server supports it.<br />
;TLS required<br />
:The server is requested to provide TLS support.<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
To send the error mails via Microsoft Office365 choose the mode "O365" and enter the following parameters:<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure ([[#Microsoft_Azure_configuration_for_Microsoft_Office365_.28O365.29_support|see '''Azure configuration''']])<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br />
===General===<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and will be displayed as the sender address for emails sent through this module.<br />
;Subject<br />
:This text will be used as the subject when sending the emails.<br />
<br />
;Test<br />
:You can use this option to send a test message to verify the configured parameters.<br />
<br />
<br />
<br />
|}<br />
<br />
==Modules==<br />
[[File:ComManager_Modules_EN.png|360px|thumb|right|Modules]]<br />
;1 - Overview of configured modules<br />
:'''Module ID''' - Selection and assignment of the module in HVS32 is done through this ID<br />
:'''Module Type''' - Type/category of module; the abbreviation "U" / "D" in parentheses indicates whether it is a '''D'''ownload (e.g., route download) or '''U'''pload module (FFFile, Wawi return, etc.)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will cause errors in process handling.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, it will cause errors in process handling.<br />
;3 - Summary of the configuration of the selected server<br />
<br />
[[File:ComManager_AddModul.png|340px|thumb|right|Add Module]]<br />
;Add / configure module<br />
Communication between HVS32 and the specified server occurs through modules. Such a server can be either a separate [[HVS32_Communication_Manager(en)#Server|(SMTP) server]] or directly the carrier's or customer's server.<br />
<br />
After selecting the module type (FTP, SFTP, SMTP, PLD/UPS, HTTP), the configuration of the new module takes place. In the following dialog, you can adjust the corresponding parameters.<br />
<br />
;Module Type<br />
:'''Carrier Module''' - Standard choice for uploading FF files during daily closing<br />
:'''Additional Transmission''' - Customer-specific transmission of, for example, Wawi return files to a customer's server<br />
:'''Download''' - Special module type for downloading, e.g., route files<br />
;Module ID<br />
:An automatically generated ID for the selection and assignment of the module in HVS32<br />
;Carrier<br />
:Additional restriction of the module for the use of specific carrier modules in HVS32 (exclusively for FF file transmission)<br />
;Principal<br />
:Additional restriction of the module for the use of specific principals/clients in HVS32 (exclusively for FF file transmission)<br />
;Note<br />
:Optional note for better overview (displayed in the overview and in HVS32)<br />
<br />
===Configure FTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;FTP Server: <br />
:IP address or hostname of the server<br />
;FTP Port: <br />
:Port at which the server is accessible (Default port 21) <br />
;FTP User<br />
:Username for authentication on the FTP server <br />
;FTP Password<br />
:Password for authentication on the FTP server <br />
;FTP Account<br />
:FTP account for authentication on the FTP server<br />
;FTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the FTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "FTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;FTP Transfer Mode<br />
:Specify whether the data should be transferred as binary or text.<br />
;FTP Security <br />
:;FTPS <br />
::FTP over Secure Socket Layer (SSL) implicitly<br />
:;FTPES: <br />
::FTP over Secure Socket Layer (SSL) explicitly. (Here, the server can allow insecure connections as well)<br />
;FTP Connection<br />
:Choose the method for establishing the connection. PASSIVE should be chosen by default.<br />
;Proxy: <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the FTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_FTPModulConf.png|thumb|right|FTP Upload Module Configuration]]<br />
[[File:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SFTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SFTP Server <br />
:IP address or hostname of the server<br />
;SFTP Port<br />
:Port at which the server is accessible (Default port 22)<br />
;SFTP User<br />
:Username for authentication on the SFTP server <br />
;SFTP Password<br />
:Password for authentication on the SFTP server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:If you are using a private key, you can specify the path to the file here.<br />
;Passphrase<br />
:Enter your passphrase here to decrypt the file mentioned above<br />
;SFTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the SFTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "SFTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;Timeout (ms)<br />
:Time in milliseconds that the connection setup and individual communication steps can take at most (standard 30000ms).<br />
:In the configuration dialog itself, a timeout of 5000ms is used regardless of the setting to test the connection more quickly.<br />
;Proxy <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
<br />
'''If you encounter the error "Algorithm negotiation fail" during the connection test, it is usually because the SFTP server uses old security algorithms such as ssh-dss, which are no longer supported. In this case, check the box "Prefer Old Algorithms" or "prefer old algorithms" to enforce support for the old security algorithms.'''<br />
<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the SFTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Module Configuration]]<br />
[[File:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SMTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SMTP Server<br />
:Choose an SMTP server that you have configured in the "Server" tab. You can find a detailed description under '''[[#Configure SMTP Server|Configure SMTP Server]]'''.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and is used as the sender address for emails sent via this module.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Subject<br />
:This text is used as the subject when sending emails.<br />
;Email Content (PLAIN Text)<br />
:Unformatted message text for the outgoing email.<br />
;Email Content (HTML Text)<br />
:HTML-compliant formatted message text for the outgoing email.<br />
<br />
Testing is done for SMTP modules via the '''Test button''' in the configuration dialog of the corresponding '''server'''.<br />
<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_SMTPModulConf.png|thumb|super|SMTP Module Configuration]]<br />
<br />
|}<br />
<br />
===Configure PLD Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;PLD Server <br />
:HTTPS URL of the server<br />
;PLD Path <br />
:Destination path on the HTTPS server<br />
;PLD Port<br />
:Port under which the server is reachable (Default port 443)<br />
;PLD User<br />
:Username for authentication on the HTTPS server<br />
;PLD Password<br />
:Password for authentication on the HTTPS server<br />
;PLD-Report Storage Path<br />
:Here, the path to a subfolder is specified where the feedback/report files from the PLD server will be saved.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_PLDModulConf.png|thumb|super|PLD Module Configuration]]<br />
|}<br />
<br />
===Configure HTTP(S) Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;HTTP(S) URL <br />
:The HTTP or HTTPS URL with function path and, if applicable, a different port of the server.<br />
:Using the "parsable" option allows you to store the URL in the form of a script that can be edited and verified in an editing dialog "...".<br />
;HTTP User<br />
:Username for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;HTTP Password<br />
:Password for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;MIME-Type<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transfer'''.)<br />
:Content-Type of the request accepted by the server (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Directory<br />
:(This option is available only for the module type '''Download'''.)<br />
:Local default directory where downloaded files should be written. Depending on the process, the directory can be overridden by HVS32.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Module Configuration]]<br />
[[File:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Download Module Configuration]]<br />
|}<br />
<br />
==Servers==<br />
[[File:ComManager_Server.png|360px|thumb|right|Servers]]<br />
;1 - Overview of configured communication servers<br />
:'''Server ID''' - Selection and assignment of the server in the modules are done based on this ID<br />
:'''Server Type''' - Server Type/Category (SMTP)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will lead to errors in process processing.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected server<br />
Keep the original file tag please<br />
<br />
===Configure SMTP Server===<br />
----<br />
[[File:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Configuration]]<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent via the server.<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;SMTP Server<br />
:IP address or hostname under which the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and activate authentication. <br />
;SMTP Port<br />
:Port under which the SMTP server is accessible (25, 465, 587)<br />
;SSL Enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS Enabled<br />
:Data sent will be encrypted via Transport Layer Security if the SMTP server supports it. <br />
;TLS Required<br />
:The server requires TLS support.<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
<br />
==Proxies==<br />
[[File:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Overview of configured proxies<br />
:'''Proxy ID''' - Selection and assignment of the proxy is done based on this ID in the modules<br />
:'''Proxy Type''' - Proxy Type/Category (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Server name or IP address of the proxy<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Proxy''' - Option to add a new proxy<br />
:'''Copy Proxy''' - Allows duplicating the selected proxy with a new ID.<br />
:'''Rename Proxy''' - Opens an input dialog to change the ID. Note: If the proxy is in use, this will lead to errors in process processing.<br />
:'''Edit Proxy''' - Opens the proxy configuration dialog.<br />
:'''Remove Proxy''' - Deletes the proxy entry. This change is irreversible; if the proxy is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected proxy<br />
<br />
<br />
===Add/Configure Proxy===<br />
----<br />
[[File:ComManager_ProxyConf.png|300px|thumb|right|Proxy Configuration]]<br />
After entering the unique proxy ID, the configuration of the new proxy is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;PROXY Type<br />
:Determines the type of the deployed proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP address or hostname under which the proxy server is accessible.<br />
;PROXY Port <br />
:Port under which the proxy server is accessible <br />
;PROXY User<br />
:Username for authentication on the proxy server<br />
;PROXY Password<br />
:Password for authentication on the proxy server<br />
<br />
;NOTE<br />
:The FTP proxy type '''USER <User>@<Host>''' is configured directly in the '''FTP module''' and not as a proxy.<br />
:To do this, enter the data in the FTP module as follows: '''FTP Server = <FTP Proxy Host>''' and '''FTP User = <FTP User>@<FTP Server>'''<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
<br />
=Microsoft Azure Configuration for Microsoft Office365 (O365)=<br />
To send emails from ComManager via Microsoft Office365 (O365), you must first register an app in Azure, assign the appropriate permissions, and configure security features. This is necessary to obtain a valid Client ID, Client Secret, and Tenant ID, as well as to grant ComManager permission to send emails.<br><br />
Below, we show how to perform an '''example configuration'''.<br />
<br><br />
<br />
The following steps are required:<br><br />
<br><br />
# Navigate to the "App registrations" service in Azure '''''[A1]'''''<br />
# Click on "+ New registration" in the "App registration" menu '''''[A2]'''''<br />
# Enter a name for the application (e.g., "HSC-ComManager") and select a Single Tenant account type (e.g., "Accounts in this organizational directory only")<br>Redirect URIs are not required and can be ignored '''''[A3]'''''<br />
# After registration, click on the newly registered app (e.g., "HSC-ComManager") in the "App registrations" menu '''''[A4]'''''<br />
# In this overview, you will find the Application (client) ID and Directory (tenant) ID, which are important for ComManager '''''[A5]'''''<br />
# Click on "Add a certificate or secret" in this overview to add a Client Secret to the app. This is necessary for ComManager to authenticate later. '''''[A5]'''''<br />
# Click on "New client secret" in this overview '''''[A6]'''''<br />
# Enter a description for this secret (e.g., "HSC-ComManager-Secret") and select an expiration date for the secret. '''''[A7]'''''<br>'''Note: When the secret expires on the selected date (e.g., in 30 days), you must add a new secret and update it in ComManager. Otherwise, email sending from ComManager will no longer be possible. Be sure to set up a notification to renew the secret in time!'''<br />
# Copy the value of the secret ('''not the Secret ID'''). '''''[A8]'''''<br>'''Note: The secret value is only displayed now. You will not have access to it later!'''<br />
# Next, switch to the "API permissions" tab and add a permission to the app ("+ Add a permission") '''''[A9]'''''<br />
# Under "Microsoft APIs," select "Microsoft Graph" '''''[A10]'''''<br />
# Select "Application permissions," '''not''' "Delegated permissions" '''''[A11]'''''<br />
# Search for and select "Mail.Send" and add the permission '''''[A12]'''''<br />
# Depending on your user level, you or your administrator may need to explicitly confirm adding the permission ("Grant admin consent for ...") '''''[A13]'''''<br />
<br />
<br><br />
<br />
<gallery><br />
o365_azure_01_search.png|A1: App Registration<br />
o365_azure_02_new-app-registration.png|A2: App Registration<br />
o365_azure_03_register-app.png|A3: Register App<br />
o365_azure_04_edit-app.png|A4: Edit registered App<br />
o365_azure_05_edit-app-2.png|A5: Relevant Information / Add Client Secret<br />
o365_azure_06_add-secret.png|A6: New Client Secret<br />
o365_azure_07_add-secret-2.png|A7: Add Client Secret<br />
o365_azure_08_save-secret.png|A8: Copy Client Secret<br />
o365_azure_09_add-permission.png|A9: Add Permission to registered App<br />
o365_azure_10_add-permission-2.png|A10: Request API Permission (Graph)<br />
o365_azure_11_add-permission-3.png|A11: Request API Permission (Application)<br />
o365_azure_12_add-permission-4.png|A12: Add Mail.Send Permission<br />
o365_azure_13_add-permission-5.png|A13: Grant Admin Consent<br />
</gallery><br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Error Code ||Error Description||Troubleshooting<br />
|-<br />
|COM11C00100||Unknown error occurred while processing a Send Message job! Response is NULL!||This is a general error in processing a Send Message job. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unknown error occurred while processing an Upload job! Response is NULL!||This is a general error in processing an Upload job. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Error occurred while deleting temporary file(s) during processing of a Send Message job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM11W00210||Error occurred while deleting temporary file(s) during processing of an Upload job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00020||Error converting response to XML - Response is NULL||This is a general error in processing a request. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Error parsing XML data in REST function uploadFile||The data received from HVS32 for upload is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00110||Error creating module configuration for REST function uploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Error converting response to XML for REST function uploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00130||Error reading file(s) in REST function uploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory and if sufficient permissions for reading files are set for the Windows user SYSTEM (or the Windows user specified in Heidler-ComManager). Try repeating the operation.<br />
|-<br />
|COM21C00131||Error writing temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00200||Error parsing XML data in REST function downloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00210||Error creating module configuration for REST function downloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Error converting response to XML for REST function downloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00300||Error parsing XML data in REST function sendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00320||Error converting response to XML for REST function sendMessage||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Error reading file(s) in REST function sendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00331||Error writing temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00400||Error parsing XML data in REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00410||Error creating module configuration for REST function queueUploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Error converting response to XML for REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00430||Error reading file(s) in REST function queueUploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00431||Error writing temporary file(s) in REST function queueUploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00500||Error parsing XML data in REST function queueDownloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00510||Error creating module configuration for REST function queueDownloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Error converting response to XML for REST function queueDownloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00600||Error parsing XML data in REST function queueSendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00620||Error converting response to XML for REST function queueSendMessage||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00630||Error reading file(s) in REST function queueSendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00631||Error writing temporary file(s) in REST function queueSendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00700||Error loading main configuration in REST function getModuleList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Error reading main configuration in REST function getModuleList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Error converting response to XML for REST function getModuleList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00800||Error loading main configuration in REST function getServerList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Error reading main configuration in REST function getServerList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Error converting response to XML for REST function getServerList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00132||Error deleting temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00332||Error deleting temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00100||Error initializing HVS32 Database Manager||There was an error initializing the Database Manager. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00200||Error initializing write connections to HVS32 database||There was an error initializing the write connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00210||Error initializing prepared statements for updating FF file in HVS32 database||There was an error initializing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00220||Error updating FF file||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00225||Error updating FF file - no results found||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00230||Error initializing prepared statements for updating WaWi file in HVS32 database||There was an error initializing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00240||Error updating WaWi file||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00245||Error updating WaWi file - no results found||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00300||Error initializing read connections to HVS32 database||There was an error initializing the read connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00310||Error initializing prepared statements for reading FF file in HVS32 database||There was an error initializing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00320||Error reading FF file from HVS32 database||There was an error executing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00325||FF file not found in HVS32 database||The FF file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The FF file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00330||Error initializing prepared statements for reading WaWi file in HVS32 database||There was an error initializing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00340||Error reading WaWi file from HVS32 database||There was an error executing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00345||WaWi file not found in HVS32 database||The WaWi file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The WaWi file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM50C01100||Error instantiating the upload module||The module for the selected module ID for upload cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Failed to instantiate the upload module||The module for the selected module ID for upload could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Error initializing the upload module||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Error instantiating the download module||The module for the selected module ID for download cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Failed to instantiate the download module||The module for the selected module ID for download could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Error initializing the download module||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Error instantiating the SendMessage module||The server module for the selected server module ID for SendMessage cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Failed to instantiate the SendMessage module||The server module for the selected server module ID for SendMessage could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Error initializing the SendMessage module||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Error connecting to FTP server||There was an error connecting to the FTP server. Please check the configured FTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Error logging into FTP server||There was an error logging into the FTP server. Please check the configured login credentials (username/password) in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Error changing directory on FTP server||There was an error changing the directory on the FTP server. Please check the configured FTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Error uploading file to FTP server||There was an error uploading the FF file to the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00500||Error downloading file from FTP server||There was an error downloading the file from the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00410||Error renaming file on FTP server||There was an error renaming the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C00411||Error moving file on FTP server||There was an error moving the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C99999||Invocation of an unsupported function in FTP module||The invoked function is not supported by this FTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM52C00100||Error starting session on SFTP server||There was an error starting the session to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Error starting session on jump host for SFTP transmission||There was an error starting the session to the jump host. Please check the configured jump host settings in the SFTP server module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Error opening channel to SFTP server||There was an error opening the channel to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Error connecting to SFTP server||There was an error connecting to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Error changing directory on SFTP server||There was an error changing the directory on the SFTP server. Please check the configured SFTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Error uploading file to SFTP server||There was an error uploading the FF file to the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00510||Error uploading file to SFTP server - Access denied!||There was an error uploading the FF file to the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C00520||Error renaming file on SFTP server||There was an error renaming the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00521||Error moving file on SFTP server||There was an error moving the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00600||Error downloading file from SFTP server||There was an error downloading the file from the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00610||Error downloading file from SFTP server - Access denied!||There was an error downloading the file from the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C99999||Invocation of an unsupported function in SFTP module||The invoked function is not supported by this SFTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM53C00100||SMTP configuration not found||There was an error in the configuration of the SMTP module. Please check the selected SMTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00101||Illegal parameters in SMTP configuration - recipient address is empty!||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00102||Illegal parameters in SMTP configuration - subject is empty!||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00103||Illegal parameters in SMTP configuration - mail text is empty!||There was an error in the configuration of the SMTP module. Please check the configured mail text in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00105||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00110||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00111||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00112||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00120||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00130||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00131||Error setting recipient address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00132||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00133||Error setting BCC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured BCC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00134||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00135||Error setting subject in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00200||No SMTP data found from HVS32||No SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00201||Invalid SMTP data from HVS32||Invalid SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00202||Illegal parameters in SMTP data from HVS32 - recipient address is empty!||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53C00203||Illegal parameters in SMTP data from HVS32 - subject is empty!||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00204||Illegal parameters in SMTP data from HVS32 - mail text is empty!||There was an error in the configuration of HVS32. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00205||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00210||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in HVS32 Configurator.<br />
|-<br />
|COM53C00211||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00212||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00220||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00230||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00231||Error setting recipient address in SMTP module||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53W00232||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in HVS32 Configurator.<br />
|-<br />
|COM53W00233||Error setting BCC address in SMTP module||There was an error in the configuration of HVS32. Please check the configured BCC address in HVS32 Configurator.<br />
|-<br />
|COM53W00234||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in HVS32 Configurator.<br />
|-<br />
|COM53W00235||Error setting subject in SMTP module||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00300||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00400||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C99999||Invocation of an unsupported function in SMTP module||The invoked function is not supported by this SMTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54C99999||Invocation of an unsupported function in PLD module||The invoked function is not supported by this PLD module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54W03005||3005 PLD Warning - File already transmitted!||The carrier file has already been transmitted and therefore could not be accepted by the UPS server. Please do not transmit this file again.<br />
|-<br />
|COM54W06930||6930 PLD Warning - Data uploaded with warnings. Please correct before the next upload!||The carrier file has been successfully transmitted to the UPS server and processed. The file does not need to be transmitted again. However, there are content errors in the FF file that need to be fixed before the next day's closure. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06931||6931 PLD Error - Upload failed due to errors in the PLD data.||The carrier file has been transmitted to the UPS server but was NOT processed due to errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06932||6932 Severe PLD Error - Upload failed due to errors in the input parameters.||The carrier file has been transmitted to the UPS server but was NOT processed due to SERIOUS errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06933||Unknown PLD Error - Upload failed due to unknown errors.||The carrier file has been transmitted to the UPS server but was NOT processed due to unknown errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C01000||Error in feedback - no status code found!||An error was detected in the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54C01100||Error parsing the feedback||There was an error parsing the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54W01200||Error saving the report file(s)||There was an error saving the reports from the UPS server. Please check the configured storage path in the corresponding PLD module configuration of HVS32CommunicationManager, as well as the user rights of this directory.<br />
|-<br />
|COM54C02000||HTTPS connection not ready!||There was an error connecting to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C03000||Error reading the EDI file||There was an error reading the FF file in the PLD module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C04000||Error transmitting data to the UPS server||There was an error transmitting data to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C02000||HTTP(S) connection not ready!||There was an error connecting to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C04000||Error transmitting data to the HTTP(S) server||There was an error transmitting data to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C05000||Error downloading file from the HTTP(S) server||There was an error downloading the file from the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C99999||Invocation of an unsupported function in HTTP module||The invoked function is not supported by this HTTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager&diff=6106
HVS32 Communication Manager
2025-03-19T10:39:19Z
<p>Bhauser: /* O365 Server (für Microsoft Office365) konfigurieren */</p>
<hr />
<div>[[en:HVS32_Communication_Manager(en)]]<br />
Der Communication Manager (fortan ComManager abgekürzt) ist ein Dienst der die Kommunikation zwischen HVS32 und Kunde oder <br><br />
HVS32 und Frachtführer zentral Verwaltet und übernimmt. Gedacht ist der ComManager für Kommunikationen via FTP, SFTP oder SMTP.<br />
<br />
Genau wie bei WinSCP wird dieser Dienst vom HVS32 angesteuert und versendet die Daten an den im Modul konfigurierten Zielserver.<br />
<br />
Er soll nach und nach die Kommunikationen des HVS32 übernehmen und andere externe Übermittlungsprogramme wie zum Beispiel WinSCP ablösen.<br />
<br />
=ComManager Konfiguration=<br />
Der ComManager-Konfigurator wird entweder direkt über die ''ComManager-Configurator.exe'' im Installationsverzeichnis ''...Heidler\HVS32\ComManager\'' oder aus dem [[HVS32_Communication_Manager_in_HVS32_einrichten|HVS32 Konfigurator]] gestartet. <br />
<br />
[[Datei:Commanager-startmaske.png|500px|thumb|ohne|Commanager-startmaske]]<br />
<br />
;1 - Link zu diesem Wiki Eintrag<br />
;2 - Auswahl Tabs<br />
:'''[[HVS32_Communication_Manager#Module|Module]]''' - Module zur Übertragung von Dateien beim Tagesabschluss, Wawi-Rück und Routendownloads<br />
:'''[[HVS32_Communication_Manager#Server|Server]]''' - Interne Kommunikationsserver wie z.B. Microsoft Exchange (SMTP) Verbindungen<br />
:'''[[HVS32_Communication_Manager#Proxys|Proxy]]''' - Interne Proxyserver<br />
;3 - Übersicht der eingerichteten Module<br />
;4 - Zusammenfassung der Konfiguration vom ausgewählten Modul<br />
;5 - [[HVS32_Communication_Manager#ErrorHandler_konfigurieren|Errorhandler Konfiguration]]<br />
;6 - [[HVS32_Communication_Manager#Dienst_Einstellungen|Dienst Einstellungen]]<br />
<br />
==Dienst Einstellungen==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Hier werden die grundlegenden Einstellungen des ComManager Dienstes vorgenommen, die erforderlich sind um eine Verbindung zum Dienst aufzubauen. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
<span style="color:#C00000">'''Warnung: Die Konfigurationen, die Sie hier vornehmen werden erst nach einem Neustart des ComManager Dienstes übernommen!'''</span><br />
<br />
;HVS32 Hauptverzeichnis: <br />
:Hier den Pfad zum HVS32 angeben<br />
;HVS32 Datenbank-Datei:<br />
:Pfad zur HVS32 Datenbank angeben. <br />
;HVS32 Datenbank Server:<br />
:IP Adresse oder Hostnamen des PCs auf dem die Datenbank liegt.<br />
;HVS32 Datenbanken Port:<br />
:Der Port zu der HVS32 Datenbank muss nur in den seltensten Fällen angepasst werden. Im Standard ist der Port auf 3050 gestellt.<br />
;REST Port<br />
:Kommunikations-Port unter welchem der ComManager-Dienst via REST erreichbar ist. Dieser muss zur externen Kommunikation mit den Clients auf dem Server in der Firewall freigegeben werden.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Konfigurationsfenster der Diensteinstellungen]]<br />
|}<br />
<br />
==ErrorHandler konfigurieren==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|Ist ein ErrorHandler konfiguriert, werden Sie im Falle einer erfolglosen Übertragung per Mail benachrichtig. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
;Mode<br />
:Wählen Sie zunächst den Modus über welchen Sie die Error-Mails versenden möchten<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
Für den Versand der E-Mails über einen SMTP, wählen Sie "SMTP" und konfigurieren Sie die folgenden Parameter:<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren.<br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt.<br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
Für den Versand der E-Mails via Microsoft Office365, wählen Sie "O365" und konfigurieren Sie die folgenden Parameter:<br />
;Graph URL<br />
:Dies ist die offizielle URL für die Microsoft Graph API. Diese ist im Standard bereits vorbelegt<br />
;Client-ID<br />
:Applikation (Client) ID der registrierten Applikation ([[#Microsoft_Azure_Konfiguration_f.C3.BCr_Microsoft_Office365_.28O365.29|Siehe '''Azure Konfiguration''']])<br />
;Client-Secret<br />
:in Azure hinterlegtes Secret der Applikation (nicht die ID des Secrets)<br />
;Tenant-ID<br />
:Tenant-ID der in Azure registrierten Applikation<br />
;Scope<br />
:Dies ist der Standard-Scope welcher für das Versenden von Mails via Microsoft Graph benötigt wird. Dieser Parameter ist vorbelegt.<br />
<br />
===Allgemein===<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
<br />
;Testen<br />
:Sie können mit dieser Option eine Testnachricht zur Prüfung der eingestellten Parameter verschicken.<br />
<br />
<br />
<br />
|}<br />
<br />
==Module==<br />
[[Datei:ComManager_Modul.png|360px|thumb|right|Module]]<br />
;1 - Übersicht der eingerichteten Module<br />
:'''Modul ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Moduls in HVS32<br />
:'''Modul Typ''' - Modul Typ/Art; das in der Klammer dargestellte Kürzel "U" / "D" gibt Auskunft darüber ob es ein '''D'''ownload (z.B. Routendownload) oder '''U'''pload Modul (FFDatei, WaWi-Rück., etc.) ist<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
[[Datei:ComManager_AddModul.png|340px|thumb|right|Modul hinzufügen]]<br />
;Modul hinzufügen / konfigurieren<br />
Über die Module findet die Kommunikation zwischen HVS32 und dem angegebenen Server statt. Ein solcher Server kann entweder ein eigener [[HVS32_Communication_Manager#Server|(SMTP) Server]] oder direkt der Server vom Frachtführer oder Kunden sein.<br />
<br />
Nach der Auswahl des Modul-Typs (FTP, SFTP, SMTP, PLD/UPS, HTTP) erfolgt die vor Konfiguration vom neuen Modul. In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen.<br />
<br />
;Modul Art<br />
:'''Frachtführer-Modul''' - Standard Auswahl für den Upload von FF-Dateien beim Tagesabschluss<br />
:'''Zusatzübertragung''' - Kundenindividuelle Übertragung von z.B. WaWi-Rück-Dateien an einen Kundeneigenen Server<br />
:'''Download''' - Spezielle Modul Art für den Download von z.B. Routendateien<br />
;ModulID<br />
:Eine automatisch generierte ID für die Auswahl und Zuweisung des Moduls im HVS32<br />
;Frachtführer<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Frachtführer-Modulen im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Auftraggeber<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Auftraggebern/Mandanten im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Notiz<br />
:Optionale Notiz, zur besseren Übersicht (wird in der Übersicht und im HVS32 dargestellt)<br />
<br />
<br />
===FTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;FTP Server: <br />
:IP Adresse des Servers oder Servername<br />
;FTP Port: <br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 21) <br />
;FTP Benutzer<br />
:Benutzername zur Authentifizierung am FTP-Server <br />
;FTP Password<br />
:Password zur Authentifizierung am FTP-Server <br />
;FTP Account<br />
:FTP-Account zur Authentifizierung am FTP-Server<br />
;FTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem FTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "FTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt.<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;FTP Transfer-Modus<br />
:Geben Sie an ob die Daten binär oder als Text übertragen werden sollen.<br />
;FTP Sicherheit <br />
:;FTPS <br />
::FTP über Secure Socket Layer (SSL) implizit<br />
:;FTPES: <br />
::FTP über Secure Socket Layer (SSL) explizit. (Hier kann der Server auch unsichere Verbindungen zulassen)<br />
;FTP Verbindung<br />
:Hier können Sie die Methode zum Verbindungsaufbau wählen. Es sollte standardmäßig PASSIVE gewählt werden.<br />
;Proxy: <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_FTPModulConf.png|thumb|right|FTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SFTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SFTP Server <br />
:IP Adresse des Servers oder Servername<br />
;SFTP Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 22)<br />
;SFTP Benutzer<br />
:Benutzername zur Authentifizierung am SFTP-Server <br />
;SFTP Password<br />
:Password zur Authentifizierung am SFTP-Server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:Falls Sie einen private Key verwenden, können Sie hier den Pfad zur Datei angeben.<br />
;Passphrase<br />
:Hier geben Sie bitte Ihre Passphrase an um die oben genannte Datei zu entschlüsseln<br />
;SFTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem SFTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "SFTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt..<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Timeout (ms)<br />
:Zeit in Millisekunden, die der Verbindungsaufbau und einzelne Kommunikationsschritte maximal in Anspruch nehmen können (im Standard 30000ms).<br />
:Im Konfigurationsdialog selbst wird unabhängig von der Einstellung ein Timeout von 5000ms verwendet, um die Verbindung schneller Testen zu können.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
<br />
'''Sollte beim Verbindungstest der Fehler "Algorithm negotiation fail" auftreten, liegt es i.d.R. daran, dass der SFTP Server alte Sicherheits Algorithmen wie z.B. ssh-dss nutzt, welche nicht mehr unterstützt werden. In diesem Fall setzen Sie den Haken "Alte Algorithmen bevorzugen" bzw. "prefer old algorithms" um eine Unterstützung der alten Sicherheits Algorithmen zu erzwingen.'''<br />
<br />
<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SMTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SMTP Server<br />
:Hier können Sie einen SMPT Server wählen, den Sie zuvor im Reiter „Server“ konfiguriert haben. Eine genaue Beschreibung finden Sie unter '''[[#SMTP Server konfigurieren|SMTP Server konfigurieren]]'''.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
;Mail Inhalt (PLAIN Text)<br />
:Unformatierter Nachrichtentext für die zu versendenden E-Mail.<br />
;Mail Inhalt (HTML Text)<br />
:HTML konform formatierter Nachrichtentext für die zu versendenden E-Mail.<br />
<br />
Der Test erfolgt bei SMTP Modulen über '''Testbutton''' im Konfigurationsdialog des entsprechenden '''Servers'''.<br />
<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
|[[Datei:ComManager_SMTPModulConf.png|thumb|super|SMTP Modul Konfiguration]]<br />
<br />
|}<br />
<br />
===PLD Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;PLD Server <br />
:HTTPS URL des Servers<br />
;PLD Pfad <br />
:Zielpfad vom HTTPS-Server<br />
;PLD Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 443)<br />
;PLD Benutzer<br />
:Benutzername zur Authentifizierung am HTTPS-Server<br />
;PLD Password<br />
:Password zur Authentifizierung am HTTPS-Server<br />
;PLD-Report Speicherpfad<br />
:Hier wird der Pfad zu einem Unterordner angegeben, in welchen die Rückmelde-/Reportdateien vom PLD-Server gespeichert werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_PLDModulConf.png|thumb|super|PLD Modul Konfiguration]]<br />
|}<br />
<br />
===HTTP(S) Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;HTTP(S) URL <br />
:Die HTTP oder HTTPS URL mit Funktionspfad und ggf. abweichendem Port des Servers<br />
:Über die Auswahl "parsbar" lässt sich die URL in Form eines Scripts hinterlegen, den man in einem Bearbeitungsdialog "..." editieren und prüfen kann.<br />
;HTTP Benutzer<br />
:Benutzername zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;HTTP Password<br />
:Password zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;MIME-Type<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Content-Type vom Request, welcher vom Server akzeptiert wird (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Downlaod Modul Konfiguration]]<br />
|}<br />
<br />
==Server==<br />
[[Datei:ComManager_Server.png|360px|thumb|right|Server]]<br />
;1 - Übersicht der eingerichteten Kommunikationsservern<br />
:'''Server ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Servers in den Modulen<br />
:'''Server Typ''' - Server Typ/Art (SMTP)<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
===SMTP Server konfigurieren===<br />
----<br />
[[Datei:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Konfiguration]]<br />
Nach der Eingabe der eindeutigen Server-ID erfolgt die Konfiguration vom neuen Kommunikationsserver.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren. <br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt. <br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert <br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
<br />
<br><br />
<br><br />
===O365 Server (für Microsoft Office365) konfigurieren===<br />
----<br />
[[Datei:o365_commanager_02_add-server-2.png|300px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
<br />
Für den Versand der E-Mails via Microsoft Office365, wählen Sie "O365" und konfigurieren Sie die folgenden Parameter:<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails genutzt, welche über den Server versendet werden.<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;Graph URL<br />
:Dies ist die offizielle URL für die Microsoft Graph API. Diese ist im Standard bereits vorbelegt<br />
;Client-ID<br />
:Applikation (Client) ID der registrierten Applikation ([[#Microsoft_Azure_Konfiguration_f.C3.BCr_Microsoft_Office365_.28O365.29|Siehe '''Azure Konfiguration''']])<br />
;Client-Secret<br />
:in Azure hinterlegtes Secret der Applikation (nicht die ID des Secrets)<br />
;Tenant-ID<br />
:Tenant-ID der in Azure registrierten Applikation<br />
;Scope<br />
:Dies ist der Standard-Scope welcher für das Versenden von Mails via Microsoft Graph benötigt wird. Dieser Parameter ist vorbelegt.<br />
<br />
==Proxys==<br />
[[Datei:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Übersicht der eingerichteten Proxys<br />
:'''Proxy ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Proxys in den Modulen<br />
:'''Proxy Typ''' - Proxy Typ/Art (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Servername oder IP-Adresse vom Proxy<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Proxy hinzufügen''' - Option zum hinzufügen eines neuen Proxys<br />
:'''Proxy kopieren''' - Ermöglicht es den ausgewählten Proxy als Duplikat mit einer neuen ID anzulegen.<br />
:'''Proxy umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Proxy bearbeiten''' - Öffnet den Proxy-Konfigurationsdialog.<br />
:'''Proxy entfernen''' - Löscht den Proxy Eintrag. Diese Änderung ist unwiderruflich, sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Proxy<br />
<br />
<br />
===Proxy hinzufügen / konfigurieren===<br />
----<br />
[[Datei:ComManager_ProxyConf.png|300px|thumb|right|Proxy Konfiguration]]<br />
Nach der Eingabe der eindeutigen Proxy-ID erfolgt die Konfiguration vom neuen Proxy.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
;PROXY Typ<br />
:Bestimmt die Art vom eingesetzten Proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP Adresse oder Hostname unter dem der Proxy Server erreichbar ist.<br />
;PROXY Port <br />
:Port unter dem der Proxy Server erreichbar ist <br />
;PROXY Benutzer<br />
:Benutzername zur Authentifizierung am Proxy Server<br />
;PROXY Passwort<br />
:Passwort zur Authentifizierung am Proxy Server<br />
<br />
;HINWEIS<br />
:Der FTP Proxy-Typ '''USER <Benutzer>@<Host>''' wird direkt im '''FTP-Modul''' konfiguriert und nicht als Proxy.<br />
:Tragen Sie dazu die Daten im FTP-Modul wie folgt ein: '''FTP Server = <FTP-Proxy-Host>''' und '''FTP Benutzer = <FTP-Benutzer>@<FTP-Server>'''<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
=Microsoft Azure Konfiguration für Microsoft Office365 (O365)=<br />
Um E-Mails vom ComManager via Microsoft Office365 (O365) zu versenden, müssen Sie zuvor in Azure eine App registrieren dieser entsprechende Berechtigungen und Sicherheits-Features zuweisen. Dies ist notwendig um eine gültige Client-ID, Client-Secret und Tenant-ID zu bekommen und dem ComManager die Berechtigung zu erteilen Mails zu versenden.<br><br />
Wir zeigen unten wie eine '''beispielhafte Konfiguration''' vorgenommen werden kann.<br />
<br><br />
<br />
Folgende Schritte sind hierzu notwendig:<br><br />
<br><br />
# Navigieren Sie in Azure zu dem Service "App registrations" '''''[A1]'''''<br />
# Klicken Sie im Menü "App registration" auf "+ New registration" '''''[A2]'''''<br />
# Tragen Sie einen Namen für die Applikation ein (z.B. "HSC-ComManager") und wählen Sie einen Single Tenant Account Type (z.B. "Accounts in this organizational directory only")<br>Redirect URI sind nicht notwendig und können ignoriert werden '''''[A3]'''''<br />
# Klicken Sie nach der Registrierung im Menü "App registrations" auf die soeben registrierte App (z.B. "HSC-ComManager") '''''[A4]'''''<br />
# In dieser Übersicht (Overview) finden Sie die Application (client) ID und die Directory (tenant) ID, welche für den ComManager wichtig sind '''''[A5]'''''<br />
# Klicken Sie in dieser Übersicht auf "Add a certificate or secret" um dieser App ein Client-Secret hinzuzufügen. Dies ist wichtig, damit der ComManager sich später Authentifizieren kann. '''''[A5]'''''<br />
# Klicken Sie in dieser Übersicht auf "New client secret" '''''[A6]'''''<br />
# Tragen Sie eine Beschreibung für dieses Secret ein (z.B. "HSC-ComManager-Secret") und wählen Sie ein Datum, wann dieses Secret abläuft. '''''[A7]'''''<br>'''Achtung: Wenn das Secret dann zum gewählten Datum abgelaufen ist (z.B. in 30 Tagen), müssen Sie ein neues Secret hinzufügen und dies wieder im ComManager hinterlegen. Sonst ist ein Mail-Versand im ComManager mehr möglich. Hinterlegen sie sich daher unbedingt noch eine Notification, damit Sie rechtzeitig das Secret erneuern können!'''<br />
# Kopieren Sie den Wert (Value) des Secrets ('''nicht die Secret ID'''). '''''[A8]'''''<br>'''Achtung: Der Wert des Secrets wird nur jetzt angezeigt. Danach haben Sie darauf keinen Zugriff mehr!'''<br />
# Wechseln Sie danach zum Reiter "API permissions" und fügen Sie der App eine Berechtigung hinzu ("+ Add a permission") '''''[A9]'''''<br />
# Wählen Sie unter "Microsoft APIs" den Eintrag "Microsoft Graph" '''''[A10]'''''<br />
# Selektieren Sie "Application permissions", '''nicht''' "Delegated permissions" '''''[A11]'''''<br />
# Suchen und selektieren Sie "Mail.Send" und fügen Sie die Berechtigungen hinzu '''''[A12]'''''<br />
# Abhängig davon, welches Benutzer-Leven Sie haben, müssen Sie oder Ihr Administrator das Hinzufügen der Berechtigung noch explizit Bestätigen ("Grant admin consent for ...") '''''[A13]'''''<br />
<br />
<br><br />
<br />
<gallery><br />
o365_azure_01_search.png|A1: App Registration<br />
o365_azure_02_new-app-registration.png|A2: App Registration<br />
o365_azure_03_register-app.png|A3: Register App<br />
o365_azure_04_edit-app.png|A4: Edit registered App<br />
o365_azure_05_edit-app-2.png|A5: Relevant Informations / Add Client Secret<br />
o365_azure_06_add-secret.png|A6: New Client Secret<br />
o365_azure_07_add-secret-2.png|A7: Add Client Secret<br />
o365_azure_08_save-secret.png|A8: Copy Client Secret<br />
o365_azure_09_add-permission.png|A9: Add Permission to registered App<br />
o365_azure_10_add-permission-2.png|A10: Request API Permission (Graph)<br />
o365_azure_11_add-permission-3.png|A11: Request API Permission (Application)<br />
o365_azure_12_add-permission-4.png|A12: Add Mail.Send Permission<br />
o365_azure_13_add-permission-5.png|A13: Grant Admin Consent<br />
</gallery><br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Fehlercode ||Fehlerbeschreibung||Fehlerbehebung<br />
|-<br />
|COM11C00100||Unbekannter Fehler bei der Verarbeitung eines Send Message Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Send Message Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unbekannter Fehler bei der Verarbeitung eines Upload Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Upload Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Send Message Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM11W00210||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Upload Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00020||Fehler beim Konvertieren der Antwort in XML - Response ist NULL||Dies ist ein allgemeiner Fehler bei der Verarbeitung eienr Anfrage. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Fehler beim Parsen der XML Daten in REST Funktion uploadFile||Die Übergabe-Daten aus dem HVS32 für den Upload sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00110||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion uploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Fehler beim Konvertieren der Antwort in XML für REST Funktion uploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00130||Fehler beim Einlesen der Datei(en) in REST Funktion uploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob in dem entsprechenden Verzeichnis die zu übertragende Datei existiert und ausreichende Berechtigungen zum Lesen von Dateien für den Windows-Benutzer SYSTEM (oder der im Heidler-ComManager hinterlegten Windows-Benutzer) gesetzt sind. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00131||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00200||Fehler beim Parsen der XML Daten in REST Funktion downloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00210||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion downloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Fehler beim Konvertieren der Antwort in XML für REST Funktion downloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00300||Fehler beim Parsen der XML Daten in REST Funktion sendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00320||Fehler beim Konvertieren der Antwort in XML für REST Funktion sendMessage||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Fehler beim Einlesen der Datei(en) in REST Funktion sendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00331||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00400||Fehler beim Parsen der XML Daten in REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00410||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueUploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00430||Fehler beim Einlesen der Datei(en) in REST Funktion queueUploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00431||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueUploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00500||Fehler beim Parsen der XML Daten in REST Funktion queueDownloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00510||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueDownloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueDownloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00600||Fehler beim Parsen der XML Daten in REST Funktion queueSendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00620||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueSendMessage||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00630||Fehler beim Einlesen der Datei(en) in REST Funktion queueSendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00631||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueSendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00700||Fehler beim Laden der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Fehler beim Lesen der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Fehler beim Konvertieren der Antwort in XML für REST Funktion getModuleList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00800||Fehler beim Laden der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Fehler beim Lesen der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Fehler beim Konvertieren der Antwort in XML für REST Funktion getServerList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00132||Fehler beim Löschen der temporären Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00332||Fehler beim Löschen der temporären Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00100||Fehler bei Initialisierung des HVS32 Datenbank Managers||Es ist ein Fehler beim Initialisieren des DatenbankManagers aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00200||Fehler bei Initialisierung der Schreib-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Schreib-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00210||Fehler bei Initialisierung des Prepared Statements zum Updaten der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00220||Fehler beim Updaten der FF Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00225||Fehler bei Update von FF-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00230||Fehler bei Initialisierung des Prepared Statements zum Updaten der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00240||Fehler beim Updaten der WaWi-Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00245||Fehler bei Update von WaWi-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00300||Fehler bei Initialisierung der Lese-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Lese-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00310||Fehler bei Initialisierung des Prepared Statements zum Lesen der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00320||Fehler beim Lesen der FF-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00325||FF Datei in HVS32 Datenbank nicht gefunden||Die vom HVS32 übermittelte FF-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die FF-Datei wurde bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00330||Fehler bei Initialisierung des Prepared Statements zum Lesen der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00340||Fehler beim Lesen der WaWi-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00345||WaWi-Datei nicht in HVS32 Datenbank gefunden||Die vom HVS32 übermittelte WaWi-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM50C01100||Fehler beim Instanziieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Instanziieren des Upload-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Fehler beim Initialisieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Fehler beim Instanziieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Instanziieren des Download-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Fehler beim Initialisieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Fehler beim Instanziieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Instanziieren des SendMessage-Moduls fehlgeschlagen||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Fehler beim Initialisieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Fehler bei der Verbindung zum FTP Server||Es ist ein Fehler bei der Verbindung zum FTP-Server aufgetreten. Prüfen Sie den hinterlegten FTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Fehler beim Login auf FTP Server ||Es ist ein Fehler beim Login zum FTP-Server aufgetreten. Prüfen Sie die hinterlegten Login-Daten (Benutzername/Passwort) in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Fehler beim Wechseln des Verzeichnisses auf dem FTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem FTP-Server aufgetreten. Prüfen Sie das hinterlegte FTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Fehler beim Hochladen der Datei auf FTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00500||Fehler beim Herunterladen der Datei vom FTP Server||Es ist ein Fehler beim Herunterladen der Datei vom FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00410||Fehler beim Umbenennen der Datei auf FTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C00411||Fehler beim Verschieben der Datei auf FTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C99999||Aufruf einer nicht unterstützten Funktion im FTP Modul||Die Aufgerufene Funktion wird von diesem FTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM52C00100||Fehler beim Starten der Session auf dem STFP Server||Es ist ein Fehler beim Starten der Session zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Fehler beim Starten der Session auf dem Jump Host für die SFTP Übertragung||Es ist ein Fehler beim Starten der Session zum Jump Host aufgetreten. Prüfen Sie den hinterlegten Jump Host Einstellungen in der SFTP-Server Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Fehler beim Öffnen des Kanals zum SFTP Server||Es ist ein Fehler beim Öffnen des Kanals zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Fehler bei der Verbindung zum SFTP Server||Es ist ein Fehler bei der Verbindung zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Fehler beim Wechseln des Verzeichnisses auf dem SFTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem SFTP-Server aufgetreten. Prüfen Sie das hinterlegte SFTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Fehler beim Hochladen der Datei auf SFTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00510||Fehler beim Hochladen der Datei auf SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen. <br />
|-<br />
|COM52C00520||Fehler beim Umbenennen der Datei auf SFTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00521||Fehler beim Verschieben der Datei auf SFTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00600||Fehler beim Herunterladen der Datei vom SFTP Server||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00610||Fehler beim Herunterladen der Datei vom SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen.<br />
|-<br />
|COM52C99999||Aufruf einer nicht unterstützten Funktion im SFTP Modul||Die Aufgerufene Funktion wird von diesem SFTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM53C00100||SMTP Konfiguration nicht gefunden||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den ausgewählten SMTP-Server in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00101||Illegale Parameter in SMTP Konfiguration - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00102||Illegale Parameter in SMTP Konfiguration - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00103||Illegale Parameter in SMTP Konfiguration - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Mail-Text in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00105||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00110||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00111||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00112||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00120||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00130||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00131||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00132||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte CC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00133||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte BCC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00134||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00135||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00200||Keine SMTP Daten von HVS32 gefunden||Es wurden keine SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00201||SMTP Daten von HVS32 sind ungültig||Es wurden fehlerhafte SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00202||Illegale Parameter in SMTP Daten vom HVS32 - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator.<br />
|-<br />
|COM53C00203||Illegale Parameter in SMTP Daten vom HVS32 - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator.<br />
|-<br />
|COM53C00204||Illegale Parameter in SMTP Daten vom HVS32 - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00205||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00210||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00211||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00212||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00220||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00230||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00231||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00232||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte CC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00233||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte BCC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00234||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00235||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator<br />
|-<br />
|COM53C00300||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00400||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C99999||Aufruf einer nicht unterstützten Funktion im SMTP Modul||Die Aufgerufene Funktion wird von diesem SMTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54C99999||Aufruf einer nicht unterstützten Funktion im PLD Modul||Die Aufgerufene Funktion wird von diesem PLD-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54W03005||3005 PLD Warnung - Datei bereits übertragen!||Die Frachtführer-Datei wurde bereits übertragen und konnte somit vom UPS-Server nicht akzeptiert werden. Bitte übertragen Sie diese Datei nicht erneut.<br />
|-<br />
|COM54W06930||6930 PLD Warnung - Daten wurden mit Warnungen hochgeladen. Bitte korrigieren Sie diese vor dem nächsten Upload!||Die Frachtführer-Datei wurde erfolgreich an den UPS-Server übermittelt und von diesem verarbeitet. Die Datei muss nicht erneut übermittelt werden. Allerdings gibt es inhaltliche Fehler in der FF-Datei, welche vor dem nächsten Tagesabschluss behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06931||6931 PLD Fehler - Upload aufgrund von Fehlern in den PLD Daten fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06932||6932 Schwerer PLD Fehler - Upload aufgrund von Fehlern in den Input Parametern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von SCHWEREN Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06933||Unbekannter PLD Fehler - Upload aufgrund von unbekannten Fehlern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von unbekannten Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01000||Fehler in Rückmeldung - kein Statuscode gefunden!||Es wurde ein Fehler in der Rückmeldung vom UPS-Server festgestellt. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01100||Fehler beim Parsen der Rückmeldung||Es ist ein Fehler beim Parsen der Rückmeldung vom UPS-Server aufgetreten. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54W01200||Fehler beim Speichern der Reportdatei(en)||Es ist ein Fehler beim Speichern der Reports vom UPS-Server aufgetreten. Bitte prüfen Sie den konfigurierten Speicher-Pfad in der entsprechenden PLD-Modulkonfiguration des HVS32CommuniationManagers, sowie ggf. die Benutzerrechte dieses Verzeichnisses.<br />
|-<br />
|COM54C02000||HTTPS Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C03000||Fehler beim Lesen der EDI Datei||Es ist ein Fehler beim Lesen der FF-Datei im PLD Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C04000||Fehler beim Übertragen der Daten an den UPS Server||Es ist ein Fehler beim Übertragen der Daten an den UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C02000||HTTP(S) Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C04000||Fehler beim Übertragen der Daten an den HTTP(S) Server||Es ist ein Fehler beim Übertragen der Daten an den HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C05000||Fehler beim Herunterladen der Datei vom HTTP(S) Server||Es ist ein Fehler beim Herunterladen der Datei vom HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM55C99999||Aufruf einer nicht unterstützten Funktion im HTTP-Modul||Die Aufgerufene Funktion wird von diesem HTTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager&diff=6105
HVS32 Communication Manager
2025-03-19T10:38:14Z
<p>Bhauser: </p>
<hr />
<div>[[en:HVS32_Communication_Manager(en)]]<br />
Der Communication Manager (fortan ComManager abgekürzt) ist ein Dienst der die Kommunikation zwischen HVS32 und Kunde oder <br><br />
HVS32 und Frachtführer zentral Verwaltet und übernimmt. Gedacht ist der ComManager für Kommunikationen via FTP, SFTP oder SMTP.<br />
<br />
Genau wie bei WinSCP wird dieser Dienst vom HVS32 angesteuert und versendet die Daten an den im Modul konfigurierten Zielserver.<br />
<br />
Er soll nach und nach die Kommunikationen des HVS32 übernehmen und andere externe Übermittlungsprogramme wie zum Beispiel WinSCP ablösen.<br />
<br />
=ComManager Konfiguration=<br />
Der ComManager-Konfigurator wird entweder direkt über die ''ComManager-Configurator.exe'' im Installationsverzeichnis ''...Heidler\HVS32\ComManager\'' oder aus dem [[HVS32_Communication_Manager_in_HVS32_einrichten|HVS32 Konfigurator]] gestartet. <br />
<br />
[[Datei:Commanager-startmaske.png|500px|thumb|ohne|Commanager-startmaske]]<br />
<br />
;1 - Link zu diesem Wiki Eintrag<br />
;2 - Auswahl Tabs<br />
:'''[[HVS32_Communication_Manager#Module|Module]]''' - Module zur Übertragung von Dateien beim Tagesabschluss, Wawi-Rück und Routendownloads<br />
:'''[[HVS32_Communication_Manager#Server|Server]]''' - Interne Kommunikationsserver wie z.B. Microsoft Exchange (SMTP) Verbindungen<br />
:'''[[HVS32_Communication_Manager#Proxys|Proxy]]''' - Interne Proxyserver<br />
;3 - Übersicht der eingerichteten Module<br />
;4 - Zusammenfassung der Konfiguration vom ausgewählten Modul<br />
;5 - [[HVS32_Communication_Manager#ErrorHandler_konfigurieren|Errorhandler Konfiguration]]<br />
;6 - [[HVS32_Communication_Manager#Dienst_Einstellungen|Dienst Einstellungen]]<br />
<br />
==Dienst Einstellungen==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Hier werden die grundlegenden Einstellungen des ComManager Dienstes vorgenommen, die erforderlich sind um eine Verbindung zum Dienst aufzubauen. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
<span style="color:#C00000">'''Warnung: Die Konfigurationen, die Sie hier vornehmen werden erst nach einem Neustart des ComManager Dienstes übernommen!'''</span><br />
<br />
;HVS32 Hauptverzeichnis: <br />
:Hier den Pfad zum HVS32 angeben<br />
;HVS32 Datenbank-Datei:<br />
:Pfad zur HVS32 Datenbank angeben. <br />
;HVS32 Datenbank Server:<br />
:IP Adresse oder Hostnamen des PCs auf dem die Datenbank liegt.<br />
;HVS32 Datenbanken Port:<br />
:Der Port zu der HVS32 Datenbank muss nur in den seltensten Fällen angepasst werden. Im Standard ist der Port auf 3050 gestellt.<br />
;REST Port<br />
:Kommunikations-Port unter welchem der ComManager-Dienst via REST erreichbar ist. Dieser muss zur externen Kommunikation mit den Clients auf dem Server in der Firewall freigegeben werden.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Konfigurationsfenster der Diensteinstellungen]]<br />
|}<br />
<br />
==ErrorHandler konfigurieren==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|Ist ein ErrorHandler konfiguriert, werden Sie im Falle einer erfolglosen Übertragung per Mail benachrichtig. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
;Mode<br />
:Wählen Sie zunächst den Modus über welchen Sie die Error-Mails versenden möchten<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
Für den Versand der E-Mails über einen SMTP, wählen Sie "SMTP" und konfigurieren Sie die folgenden Parameter:<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren.<br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt.<br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
Für den Versand der E-Mails via Microsoft Office365, wählen Sie "O365" und konfigurieren Sie die folgenden Parameter:<br />
;Graph URL<br />
:Dies ist die offizielle URL für die Microsoft Graph API. Diese ist im Standard bereits vorbelegt<br />
;Client-ID<br />
:Applikation (Client) ID der registrierten Applikation ([[#Microsoft_Azure_Konfiguration_f.C3.BCr_Microsoft_Office365_.28O365.29|Siehe '''Azure Konfiguration''']])<br />
;Client-Secret<br />
:in Azure hinterlegtes Secret der Applikation (nicht die ID des Secrets)<br />
;Tenant-ID<br />
:Tenant-ID der in Azure registrierten Applikation<br />
;Scope<br />
:Dies ist der Standard-Scope welcher für das Versenden von Mails via Microsoft Graph benötigt wird. Dieser Parameter ist vorbelegt.<br />
<br />
===Allgemein===<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
<br />
;Testen<br />
:Sie können mit dieser Option eine Testnachricht zur Prüfung der eingestellten Parameter verschicken.<br />
<br />
<br />
<br />
|}<br />
<br />
==Module==<br />
[[Datei:ComManager_Modul.png|360px|thumb|right|Module]]<br />
;1 - Übersicht der eingerichteten Module<br />
:'''Modul ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Moduls in HVS32<br />
:'''Modul Typ''' - Modul Typ/Art; das in der Klammer dargestellte Kürzel "U" / "D" gibt Auskunft darüber ob es ein '''D'''ownload (z.B. Routendownload) oder '''U'''pload Modul (FFDatei, WaWi-Rück., etc.) ist<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
[[Datei:ComManager_AddModul.png|340px|thumb|right|Modul hinzufügen]]<br />
;Modul hinzufügen / konfigurieren<br />
Über die Module findet die Kommunikation zwischen HVS32 und dem angegebenen Server statt. Ein solcher Server kann entweder ein eigener [[HVS32_Communication_Manager#Server|(SMTP) Server]] oder direkt der Server vom Frachtführer oder Kunden sein.<br />
<br />
Nach der Auswahl des Modul-Typs (FTP, SFTP, SMTP, PLD/UPS, HTTP) erfolgt die vor Konfiguration vom neuen Modul. In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen.<br />
<br />
;Modul Art<br />
:'''Frachtführer-Modul''' - Standard Auswahl für den Upload von FF-Dateien beim Tagesabschluss<br />
:'''Zusatzübertragung''' - Kundenindividuelle Übertragung von z.B. WaWi-Rück-Dateien an einen Kundeneigenen Server<br />
:'''Download''' - Spezielle Modul Art für den Download von z.B. Routendateien<br />
;ModulID<br />
:Eine automatisch generierte ID für die Auswahl und Zuweisung des Moduls im HVS32<br />
;Frachtführer<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Frachtführer-Modulen im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Auftraggeber<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Auftraggebern/Mandanten im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Notiz<br />
:Optionale Notiz, zur besseren Übersicht (wird in der Übersicht und im HVS32 dargestellt)<br />
<br />
<br />
===FTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;FTP Server: <br />
:IP Adresse des Servers oder Servername<br />
;FTP Port: <br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 21) <br />
;FTP Benutzer<br />
:Benutzername zur Authentifizierung am FTP-Server <br />
;FTP Password<br />
:Password zur Authentifizierung am FTP-Server <br />
;FTP Account<br />
:FTP-Account zur Authentifizierung am FTP-Server<br />
;FTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem FTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "FTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt.<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;FTP Transfer-Modus<br />
:Geben Sie an ob die Daten binär oder als Text übertragen werden sollen.<br />
;FTP Sicherheit <br />
:;FTPS <br />
::FTP über Secure Socket Layer (SSL) implizit<br />
:;FTPES: <br />
::FTP über Secure Socket Layer (SSL) explizit. (Hier kann der Server auch unsichere Verbindungen zulassen)<br />
;FTP Verbindung<br />
:Hier können Sie die Methode zum Verbindungsaufbau wählen. Es sollte standardmäßig PASSIVE gewählt werden.<br />
;Proxy: <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_FTPModulConf.png|thumb|right|FTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SFTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SFTP Server <br />
:IP Adresse des Servers oder Servername<br />
;SFTP Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 22)<br />
;SFTP Benutzer<br />
:Benutzername zur Authentifizierung am SFTP-Server <br />
;SFTP Password<br />
:Password zur Authentifizierung am SFTP-Server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:Falls Sie einen private Key verwenden, können Sie hier den Pfad zur Datei angeben.<br />
;Passphrase<br />
:Hier geben Sie bitte Ihre Passphrase an um die oben genannte Datei zu entschlüsseln<br />
;SFTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem SFTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "SFTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt..<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Timeout (ms)<br />
:Zeit in Millisekunden, die der Verbindungsaufbau und einzelne Kommunikationsschritte maximal in Anspruch nehmen können (im Standard 30000ms).<br />
:Im Konfigurationsdialog selbst wird unabhängig von der Einstellung ein Timeout von 5000ms verwendet, um die Verbindung schneller Testen zu können.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
<br />
'''Sollte beim Verbindungstest der Fehler "Algorithm negotiation fail" auftreten, liegt es i.d.R. daran, dass der SFTP Server alte Sicherheits Algorithmen wie z.B. ssh-dss nutzt, welche nicht mehr unterstützt werden. In diesem Fall setzen Sie den Haken "Alte Algorithmen bevorzugen" bzw. "prefer old algorithms" um eine Unterstützung der alten Sicherheits Algorithmen zu erzwingen.'''<br />
<br />
<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SMTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SMTP Server<br />
:Hier können Sie einen SMPT Server wählen, den Sie zuvor im Reiter „Server“ konfiguriert haben. Eine genaue Beschreibung finden Sie unter '''[[#SMTP Server konfigurieren|SMTP Server konfigurieren]]'''.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
;Mail Inhalt (PLAIN Text)<br />
:Unformatierter Nachrichtentext für die zu versendenden E-Mail.<br />
;Mail Inhalt (HTML Text)<br />
:HTML konform formatierter Nachrichtentext für die zu versendenden E-Mail.<br />
<br />
Der Test erfolgt bei SMTP Modulen über '''Testbutton''' im Konfigurationsdialog des entsprechenden '''Servers'''.<br />
<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
|[[Datei:ComManager_SMTPModulConf.png|thumb|super|SMTP Modul Konfiguration]]<br />
<br />
|}<br />
<br />
===PLD Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;PLD Server <br />
:HTTPS URL des Servers<br />
;PLD Pfad <br />
:Zielpfad vom HTTPS-Server<br />
;PLD Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 443)<br />
;PLD Benutzer<br />
:Benutzername zur Authentifizierung am HTTPS-Server<br />
;PLD Password<br />
:Password zur Authentifizierung am HTTPS-Server<br />
;PLD-Report Speicherpfad<br />
:Hier wird der Pfad zu einem Unterordner angegeben, in welchen die Rückmelde-/Reportdateien vom PLD-Server gespeichert werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_PLDModulConf.png|thumb|super|PLD Modul Konfiguration]]<br />
|}<br />
<br />
===HTTP(S) Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;HTTP(S) URL <br />
:Die HTTP oder HTTPS URL mit Funktionspfad und ggf. abweichendem Port des Servers<br />
:Über die Auswahl "parsbar" lässt sich die URL in Form eines Scripts hinterlegen, den man in einem Bearbeitungsdialog "..." editieren und prüfen kann.<br />
;HTTP Benutzer<br />
:Benutzername zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;HTTP Password<br />
:Password zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;MIME-Type<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Content-Type vom Request, welcher vom Server akzeptiert wird (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Downlaod Modul Konfiguration]]<br />
|}<br />
<br />
==Server==<br />
[[Datei:ComManager_Server.png|360px|thumb|right|Server]]<br />
;1 - Übersicht der eingerichteten Kommunikationsservern<br />
:'''Server ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Servers in den Modulen<br />
:'''Server Typ''' - Server Typ/Art (SMTP)<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
===SMTP Server konfigurieren===<br />
----<br />
[[Datei:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Konfiguration]]<br />
Nach der Eingabe der eindeutigen Server-ID erfolgt die Konfiguration vom neuen Kommunikationsserver.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren. <br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt. <br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert <br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
<br />
===O365 Server (für Microsoft Office365) konfigurieren===<br />
[[Datei:o365_commanager_02_add-server-2.png|300px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
<br />
Für den Versand der E-Mails via Microsoft Office365, wählen Sie "O365" und konfigurieren Sie die folgenden Parameter:<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails genutzt, welche über den Server versendet werden.<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;Graph URL<br />
:Dies ist die offizielle URL für die Microsoft Graph API. Diese ist im Standard bereits vorbelegt<br />
;Client-ID<br />
:Applikation (Client) ID der registrierten Applikation ([[#Microsoft_Azure_Konfiguration_f.C3.BCr_Microsoft_Office365_.28O365.29|Siehe '''Azure Konfiguration''']])<br />
;Client-Secret<br />
:in Azure hinterlegtes Secret der Applikation (nicht die ID des Secrets)<br />
;Tenant-ID<br />
:Tenant-ID der in Azure registrierten Applikation<br />
;Scope<br />
:Dies ist der Standard-Scope welcher für das Versenden von Mails via Microsoft Graph benötigt wird. Dieser Parameter ist vorbelegt.<br />
<br />
<br />
==Proxys==<br />
[[Datei:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Übersicht der eingerichteten Proxys<br />
:'''Proxy ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Proxys in den Modulen<br />
:'''Proxy Typ''' - Proxy Typ/Art (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Servername oder IP-Adresse vom Proxy<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Proxy hinzufügen''' - Option zum hinzufügen eines neuen Proxys<br />
:'''Proxy kopieren''' - Ermöglicht es den ausgewählten Proxy als Duplikat mit einer neuen ID anzulegen.<br />
:'''Proxy umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Proxy bearbeiten''' - Öffnet den Proxy-Konfigurationsdialog.<br />
:'''Proxy entfernen''' - Löscht den Proxy Eintrag. Diese Änderung ist unwiderruflich, sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Proxy<br />
<br />
<br />
===Proxy hinzufügen / konfigurieren===<br />
----<br />
[[Datei:ComManager_ProxyConf.png|300px|thumb|right|Proxy Konfiguration]]<br />
Nach der Eingabe der eindeutigen Proxy-ID erfolgt die Konfiguration vom neuen Proxy.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
;PROXY Typ<br />
:Bestimmt die Art vom eingesetzten Proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP Adresse oder Hostname unter dem der Proxy Server erreichbar ist.<br />
;PROXY Port <br />
:Port unter dem der Proxy Server erreichbar ist <br />
;PROXY Benutzer<br />
:Benutzername zur Authentifizierung am Proxy Server<br />
;PROXY Passwort<br />
:Passwort zur Authentifizierung am Proxy Server<br />
<br />
;HINWEIS<br />
:Der FTP Proxy-Typ '''USER <Benutzer>@<Host>''' wird direkt im '''FTP-Modul''' konfiguriert und nicht als Proxy.<br />
:Tragen Sie dazu die Daten im FTP-Modul wie folgt ein: '''FTP Server = <FTP-Proxy-Host>''' und '''FTP Benutzer = <FTP-Benutzer>@<FTP-Server>'''<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
=Microsoft Azure Konfiguration für Microsoft Office365 (O365)=<br />
Um E-Mails vom ComManager via Microsoft Office365 (O365) zu versenden, müssen Sie zuvor in Azure eine App registrieren dieser entsprechende Berechtigungen und Sicherheits-Features zuweisen. Dies ist notwendig um eine gültige Client-ID, Client-Secret und Tenant-ID zu bekommen und dem ComManager die Berechtigung zu erteilen Mails zu versenden.<br><br />
Wir zeigen unten wie eine '''beispielhafte Konfiguration''' vorgenommen werden kann.<br />
<br><br />
<br />
Folgende Schritte sind hierzu notwendig:<br><br />
<br><br />
# Navigieren Sie in Azure zu dem Service "App registrations" '''''[A1]'''''<br />
# Klicken Sie im Menü "App registration" auf "+ New registration" '''''[A2]'''''<br />
# Tragen Sie einen Namen für die Applikation ein (z.B. "HSC-ComManager") und wählen Sie einen Single Tenant Account Type (z.B. "Accounts in this organizational directory only")<br>Redirect URI sind nicht notwendig und können ignoriert werden '''''[A3]'''''<br />
# Klicken Sie nach der Registrierung im Menü "App registrations" auf die soeben registrierte App (z.B. "HSC-ComManager") '''''[A4]'''''<br />
# In dieser Übersicht (Overview) finden Sie die Application (client) ID und die Directory (tenant) ID, welche für den ComManager wichtig sind '''''[A5]'''''<br />
# Klicken Sie in dieser Übersicht auf "Add a certificate or secret" um dieser App ein Client-Secret hinzuzufügen. Dies ist wichtig, damit der ComManager sich später Authentifizieren kann. '''''[A5]'''''<br />
# Klicken Sie in dieser Übersicht auf "New client secret" '''''[A6]'''''<br />
# Tragen Sie eine Beschreibung für dieses Secret ein (z.B. "HSC-ComManager-Secret") und wählen Sie ein Datum, wann dieses Secret abläuft. '''''[A7]'''''<br>'''Achtung: Wenn das Secret dann zum gewählten Datum abgelaufen ist (z.B. in 30 Tagen), müssen Sie ein neues Secret hinzufügen und dies wieder im ComManager hinterlegen. Sonst ist ein Mail-Versand im ComManager mehr möglich. Hinterlegen sie sich daher unbedingt noch eine Notification, damit Sie rechtzeitig das Secret erneuern können!'''<br />
# Kopieren Sie den Wert (Value) des Secrets ('''nicht die Secret ID'''). '''''[A8]'''''<br>'''Achtung: Der Wert des Secrets wird nur jetzt angezeigt. Danach haben Sie darauf keinen Zugriff mehr!'''<br />
# Wechseln Sie danach zum Reiter "API permissions" und fügen Sie der App eine Berechtigung hinzu ("+ Add a permission") '''''[A9]'''''<br />
# Wählen Sie unter "Microsoft APIs" den Eintrag "Microsoft Graph" '''''[A10]'''''<br />
# Selektieren Sie "Application permissions", '''nicht''' "Delegated permissions" '''''[A11]'''''<br />
# Suchen und selektieren Sie "Mail.Send" und fügen Sie die Berechtigungen hinzu '''''[A12]'''''<br />
# Abhängig davon, welches Benutzer-Leven Sie haben, müssen Sie oder Ihr Administrator das Hinzufügen der Berechtigung noch explizit Bestätigen ("Grant admin consent for ...") '''''[A13]'''''<br />
<br />
<br><br />
<br />
<gallery><br />
o365_azure_01_search.png|A1: App Registration<br />
o365_azure_02_new-app-registration.png|A2: App Registration<br />
o365_azure_03_register-app.png|A3: Register App<br />
o365_azure_04_edit-app.png|A4: Edit registered App<br />
o365_azure_05_edit-app-2.png|A5: Relevant Informations / Add Client Secret<br />
o365_azure_06_add-secret.png|A6: New Client Secret<br />
o365_azure_07_add-secret-2.png|A7: Add Client Secret<br />
o365_azure_08_save-secret.png|A8: Copy Client Secret<br />
o365_azure_09_add-permission.png|A9: Add Permission to registered App<br />
o365_azure_10_add-permission-2.png|A10: Request API Permission (Graph)<br />
o365_azure_11_add-permission-3.png|A11: Request API Permission (Application)<br />
o365_azure_12_add-permission-4.png|A12: Add Mail.Send Permission<br />
o365_azure_13_add-permission-5.png|A13: Grant Admin Consent<br />
</gallery><br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Fehlercode ||Fehlerbeschreibung||Fehlerbehebung<br />
|-<br />
|COM11C00100||Unbekannter Fehler bei der Verarbeitung eines Send Message Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Send Message Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unbekannter Fehler bei der Verarbeitung eines Upload Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Upload Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Send Message Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM11W00210||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Upload Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00020||Fehler beim Konvertieren der Antwort in XML - Response ist NULL||Dies ist ein allgemeiner Fehler bei der Verarbeitung eienr Anfrage. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Fehler beim Parsen der XML Daten in REST Funktion uploadFile||Die Übergabe-Daten aus dem HVS32 für den Upload sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00110||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion uploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Fehler beim Konvertieren der Antwort in XML für REST Funktion uploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00130||Fehler beim Einlesen der Datei(en) in REST Funktion uploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob in dem entsprechenden Verzeichnis die zu übertragende Datei existiert und ausreichende Berechtigungen zum Lesen von Dateien für den Windows-Benutzer SYSTEM (oder der im Heidler-ComManager hinterlegten Windows-Benutzer) gesetzt sind. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00131||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00200||Fehler beim Parsen der XML Daten in REST Funktion downloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00210||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion downloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Fehler beim Konvertieren der Antwort in XML für REST Funktion downloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00300||Fehler beim Parsen der XML Daten in REST Funktion sendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00320||Fehler beim Konvertieren der Antwort in XML für REST Funktion sendMessage||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Fehler beim Einlesen der Datei(en) in REST Funktion sendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00331||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00400||Fehler beim Parsen der XML Daten in REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00410||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueUploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00430||Fehler beim Einlesen der Datei(en) in REST Funktion queueUploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00431||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueUploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00500||Fehler beim Parsen der XML Daten in REST Funktion queueDownloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00510||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueDownloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueDownloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00600||Fehler beim Parsen der XML Daten in REST Funktion queueSendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00620||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueSendMessage||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00630||Fehler beim Einlesen der Datei(en) in REST Funktion queueSendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00631||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueSendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00700||Fehler beim Laden der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Fehler beim Lesen der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Fehler beim Konvertieren der Antwort in XML für REST Funktion getModuleList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00800||Fehler beim Laden der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Fehler beim Lesen der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Fehler beim Konvertieren der Antwort in XML für REST Funktion getServerList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00132||Fehler beim Löschen der temporären Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00332||Fehler beim Löschen der temporären Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00100||Fehler bei Initialisierung des HVS32 Datenbank Managers||Es ist ein Fehler beim Initialisieren des DatenbankManagers aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00200||Fehler bei Initialisierung der Schreib-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Schreib-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00210||Fehler bei Initialisierung des Prepared Statements zum Updaten der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00220||Fehler beim Updaten der FF Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00225||Fehler bei Update von FF-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00230||Fehler bei Initialisierung des Prepared Statements zum Updaten der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00240||Fehler beim Updaten der WaWi-Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00245||Fehler bei Update von WaWi-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00300||Fehler bei Initialisierung der Lese-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Lese-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00310||Fehler bei Initialisierung des Prepared Statements zum Lesen der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00320||Fehler beim Lesen der FF-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00325||FF Datei in HVS32 Datenbank nicht gefunden||Die vom HVS32 übermittelte FF-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die FF-Datei wurde bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00330||Fehler bei Initialisierung des Prepared Statements zum Lesen der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00340||Fehler beim Lesen der WaWi-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00345||WaWi-Datei nicht in HVS32 Datenbank gefunden||Die vom HVS32 übermittelte WaWi-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM50C01100||Fehler beim Instanziieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Instanziieren des Upload-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Fehler beim Initialisieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Fehler beim Instanziieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Instanziieren des Download-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Fehler beim Initialisieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Fehler beim Instanziieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Instanziieren des SendMessage-Moduls fehlgeschlagen||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Fehler beim Initialisieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Fehler bei der Verbindung zum FTP Server||Es ist ein Fehler bei der Verbindung zum FTP-Server aufgetreten. Prüfen Sie den hinterlegten FTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Fehler beim Login auf FTP Server ||Es ist ein Fehler beim Login zum FTP-Server aufgetreten. Prüfen Sie die hinterlegten Login-Daten (Benutzername/Passwort) in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Fehler beim Wechseln des Verzeichnisses auf dem FTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem FTP-Server aufgetreten. Prüfen Sie das hinterlegte FTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Fehler beim Hochladen der Datei auf FTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00500||Fehler beim Herunterladen der Datei vom FTP Server||Es ist ein Fehler beim Herunterladen der Datei vom FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00410||Fehler beim Umbenennen der Datei auf FTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C00411||Fehler beim Verschieben der Datei auf FTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C99999||Aufruf einer nicht unterstützten Funktion im FTP Modul||Die Aufgerufene Funktion wird von diesem FTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM52C00100||Fehler beim Starten der Session auf dem STFP Server||Es ist ein Fehler beim Starten der Session zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Fehler beim Starten der Session auf dem Jump Host für die SFTP Übertragung||Es ist ein Fehler beim Starten der Session zum Jump Host aufgetreten. Prüfen Sie den hinterlegten Jump Host Einstellungen in der SFTP-Server Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Fehler beim Öffnen des Kanals zum SFTP Server||Es ist ein Fehler beim Öffnen des Kanals zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Fehler bei der Verbindung zum SFTP Server||Es ist ein Fehler bei der Verbindung zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Fehler beim Wechseln des Verzeichnisses auf dem SFTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem SFTP-Server aufgetreten. Prüfen Sie das hinterlegte SFTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Fehler beim Hochladen der Datei auf SFTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00510||Fehler beim Hochladen der Datei auf SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen. <br />
|-<br />
|COM52C00520||Fehler beim Umbenennen der Datei auf SFTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00521||Fehler beim Verschieben der Datei auf SFTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00600||Fehler beim Herunterladen der Datei vom SFTP Server||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00610||Fehler beim Herunterladen der Datei vom SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen.<br />
|-<br />
|COM52C99999||Aufruf einer nicht unterstützten Funktion im SFTP Modul||Die Aufgerufene Funktion wird von diesem SFTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM53C00100||SMTP Konfiguration nicht gefunden||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den ausgewählten SMTP-Server in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00101||Illegale Parameter in SMTP Konfiguration - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00102||Illegale Parameter in SMTP Konfiguration - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00103||Illegale Parameter in SMTP Konfiguration - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Mail-Text in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00105||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00110||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00111||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00112||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00120||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00130||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00131||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00132||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte CC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00133||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte BCC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00134||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00135||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00200||Keine SMTP Daten von HVS32 gefunden||Es wurden keine SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00201||SMTP Daten von HVS32 sind ungültig||Es wurden fehlerhafte SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00202||Illegale Parameter in SMTP Daten vom HVS32 - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator.<br />
|-<br />
|COM53C00203||Illegale Parameter in SMTP Daten vom HVS32 - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator.<br />
|-<br />
|COM53C00204||Illegale Parameter in SMTP Daten vom HVS32 - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00205||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00210||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00211||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00212||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00220||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00230||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00231||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00232||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte CC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00233||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte BCC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00234||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00235||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator<br />
|-<br />
|COM53C00300||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00400||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C99999||Aufruf einer nicht unterstützten Funktion im SMTP Modul||Die Aufgerufene Funktion wird von diesem SMTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54C99999||Aufruf einer nicht unterstützten Funktion im PLD Modul||Die Aufgerufene Funktion wird von diesem PLD-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54W03005||3005 PLD Warnung - Datei bereits übertragen!||Die Frachtführer-Datei wurde bereits übertragen und konnte somit vom UPS-Server nicht akzeptiert werden. Bitte übertragen Sie diese Datei nicht erneut.<br />
|-<br />
|COM54W06930||6930 PLD Warnung - Daten wurden mit Warnungen hochgeladen. Bitte korrigieren Sie diese vor dem nächsten Upload!||Die Frachtführer-Datei wurde erfolgreich an den UPS-Server übermittelt und von diesem verarbeitet. Die Datei muss nicht erneut übermittelt werden. Allerdings gibt es inhaltliche Fehler in der FF-Datei, welche vor dem nächsten Tagesabschluss behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06931||6931 PLD Fehler - Upload aufgrund von Fehlern in den PLD Daten fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06932||6932 Schwerer PLD Fehler - Upload aufgrund von Fehlern in den Input Parametern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von SCHWEREN Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06933||Unbekannter PLD Fehler - Upload aufgrund von unbekannten Fehlern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von unbekannten Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01000||Fehler in Rückmeldung - kein Statuscode gefunden!||Es wurde ein Fehler in der Rückmeldung vom UPS-Server festgestellt. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01100||Fehler beim Parsen der Rückmeldung||Es ist ein Fehler beim Parsen der Rückmeldung vom UPS-Server aufgetreten. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54W01200||Fehler beim Speichern der Reportdatei(en)||Es ist ein Fehler beim Speichern der Reports vom UPS-Server aufgetreten. Bitte prüfen Sie den konfigurierten Speicher-Pfad in der entsprechenden PLD-Modulkonfiguration des HVS32CommuniationManagers, sowie ggf. die Benutzerrechte dieses Verzeichnisses.<br />
|-<br />
|COM54C02000||HTTPS Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C03000||Fehler beim Lesen der EDI Datei||Es ist ein Fehler beim Lesen der FF-Datei im PLD Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C04000||Fehler beim Übertragen der Daten an den UPS Server||Es ist ein Fehler beim Übertragen der Daten an den UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C02000||HTTP(S) Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C04000||Fehler beim Übertragen der Daten an den HTTP(S) Server||Es ist ein Fehler beim Übertragen der Daten an den HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C05000||Fehler beim Herunterladen der Datei vom HTTP(S) Server||Es ist ein Fehler beim Herunterladen der Datei vom HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM55C99999||Aufruf einer nicht unterstützten Funktion im HTTP-Modul||Die Aufgerufene Funktion wird von diesem HTTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager&diff=6104
HVS32 Communication Manager
2025-03-19T10:33:42Z
<p>Bhauser: /* O365 */</p>
<hr />
<div>[[en:HVS32_Communication_Manager(en)]]<br />
Der Communication Manager (fortan ComManager abgekürzt) ist ein Dienst der die Kommunikation zwischen HVS32 und Kunde oder <br><br />
HVS32 und Frachtführer zentral Verwaltet und übernimmt. Gedacht ist der ComManager für Kommunikationen via FTP, SFTP oder SMTP.<br />
<br />
Genau wie bei WinSCP wird dieser Dienst vom HVS32 angesteuert und versendet die Daten an den im Modul konfigurierten Zielserver.<br />
<br />
Er soll nach und nach die Kommunikationen des HVS32 übernehmen und andere externe Übermittlungsprogramme wie zum Beispiel WinSCP ablösen.<br />
<br />
=ComManager Konfiguration=<br />
Der ComManager-Konfigurator wird entweder direkt über die ''ComManager-Configurator.exe'' im Installationsverzeichnis ''...Heidler\HVS32\ComManager\'' oder aus dem [[HVS32_Communication_Manager_in_HVS32_einrichten|HVS32 Konfigurator]] gestartet. <br />
<br />
[[Datei:Commanager-startmaske.png|500px|thumb|ohne|Commanager-startmaske]]<br />
<br />
;1 - Link zu diesem Wiki Eintrag<br />
;2 - Auswahl Tabs<br />
:'''[[HVS32_Communication_Manager#Module|Module]]''' - Module zur Übertragung von Dateien beim Tagesabschluss, Wawi-Rück und Routendownloads<br />
:'''[[HVS32_Communication_Manager#Server|Server]]''' - Interne Kommunikationsserver wie z.B. Microsoft Exchange (SMTP) Verbindungen<br />
:'''[[HVS32_Communication_Manager#Proxys|Proxy]]''' - Interne Proxyserver<br />
;3 - Übersicht der eingerichteten Module<br />
;4 - Zusammenfassung der Konfiguration vom ausgewählten Modul<br />
;5 - [[HVS32_Communication_Manager#ErrorHandler_konfigurieren|Errorhandler Konfiguration]]<br />
;6 - [[HVS32_Communication_Manager#Dienst_Einstellungen|Dienst Einstellungen]]<br />
<br />
==Dienst Einstellungen==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Hier werden die grundlegenden Einstellungen des ComManager Dienstes vorgenommen, die erforderlich sind um eine Verbindung zum Dienst aufzubauen. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
<span style="color:#C00000">'''Warnung: Die Konfigurationen, die Sie hier vornehmen werden erst nach einem Neustart des ComManager Dienstes übernommen!'''</span><br />
<br />
;HVS32 Hauptverzeichnis: <br />
:Hier den Pfad zum HVS32 angeben<br />
;HVS32 Datenbank-Datei:<br />
:Pfad zur HVS32 Datenbank angeben. <br />
;HVS32 Datenbank Server:<br />
:IP Adresse oder Hostnamen des PCs auf dem die Datenbank liegt.<br />
;HVS32 Datenbanken Port:<br />
:Der Port zu der HVS32 Datenbank muss nur in den seltensten Fällen angepasst werden. Im Standard ist der Port auf 3050 gestellt.<br />
;REST Port<br />
:Kommunikations-Port unter welchem der ComManager-Dienst via REST erreichbar ist. Dieser muss zur externen Kommunikation mit den Clients auf dem Server in der Firewall freigegeben werden.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Konfigurationsfenster der Diensteinstellungen]]<br />
|}<br />
<br />
==ErrorHandler konfigurieren==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|Ist ein ErrorHandler konfiguriert, werden Sie im Falle einer erfolglosen Übertragung per Mail benachrichtig. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
;Mode<br />
:Wählen Sie zunächst den Modus über welchen Sie die Error-Mails versenden möchten<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
Für den Versand der E-Mails über einen SMTP, wählen Sie "SMTP" und konfigurieren Sie die folgenden Parameter:<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren.<br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt.<br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
Für den Versand der E-Mails via Microsoft Office365, wählen Sie "O365" und konfigurieren Sie die folgenden Parameter:<br />
;Graph URL<br />
:Dies ist die offizielle URL für die Microsoft Graph API. Diese ist im Standard bereits vorbelegt<br />
;Client-ID<br />
:Applikation (Client) ID der registrierten Applikation ([[#Microsoft_Azure_Konfiguration_f.C3.BCr_Microsoft_Office365_.28O365.29|Siehe '''Azure Konfiguration''']])<br />
;Client-Secret<br />
:in Azure hinterlegtes Secret der Applikation (nicht die ID des Secrets)<br />
;Tenant-ID<br />
:Tenant-ID der in Azure registrierten Applikation<br />
;Scope<br />
:Dies ist der Standard-Scope welcher für das Versenden von Mails via Microsoft Graph benötigt wird. Dieser Parameter ist vorbelegt.<br />
<br />
===Allgemein===<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
<br />
;Testen<br />
:Sie können mit dieser Option eine Testnachricht zur Prüfung der eingestellten Parameter verschicken.<br />
<br />
<br />
<br />
|}<br />
<br />
==Module==<br />
[[Datei:ComManager_Modul.png|360px|thumb|right|Module]]<br />
;1 - Übersicht der eingerichteten Module<br />
:'''Modul ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Moduls in HVS32<br />
:'''Modul Typ''' - Modul Typ/Art; das in der Klammer dargestellte Kürzel "U" / "D" gibt Auskunft darüber ob es ein '''D'''ownload (z.B. Routendownload) oder '''U'''pload Modul (FFDatei, WaWi-Rück., etc.) ist<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
[[Datei:ComManager_AddModul.png|340px|thumb|right|Modul hinzufügen]]<br />
;Modul hinzufügen / konfigurieren<br />
Über die Module findet die Kommunikation zwischen HVS32 und dem angegebenen Server statt. Ein solcher Server kann entweder ein eigener [[HVS32_Communication_Manager#Server|(SMTP) Server]] oder direkt der Server vom Frachtführer oder Kunden sein.<br />
<br />
Nach der Auswahl des Modul-Typs (FTP, SFTP, SMTP, PLD/UPS, HTTP) erfolgt die vor Konfiguration vom neuen Modul. In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen.<br />
<br />
;Modul Art<br />
:'''Frachtführer-Modul''' - Standard Auswahl für den Upload von FF-Dateien beim Tagesabschluss<br />
:'''Zusatzübertragung''' - Kundenindividuelle Übertragung von z.B. WaWi-Rück-Dateien an einen Kundeneigenen Server<br />
:'''Download''' - Spezielle Modul Art für den Download von z.B. Routendateien<br />
;ModulID<br />
:Eine automatisch generierte ID für die Auswahl und Zuweisung des Moduls im HVS32<br />
;Frachtführer<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Frachtführer-Modulen im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Auftraggeber<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Auftraggebern/Mandanten im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Notiz<br />
:Optionale Notiz, zur besseren Übersicht (wird in der Übersicht und im HVS32 dargestellt)<br />
<br />
<br />
===FTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;FTP Server: <br />
:IP Adresse des Servers oder Servername<br />
;FTP Port: <br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 21) <br />
;FTP Benutzer<br />
:Benutzername zur Authentifizierung am FTP-Server <br />
;FTP Password<br />
:Password zur Authentifizierung am FTP-Server <br />
;FTP Account<br />
:FTP-Account zur Authentifizierung am FTP-Server<br />
;FTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem FTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "FTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt.<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;FTP Transfer-Modus<br />
:Geben Sie an ob die Daten binär oder als Text übertragen werden sollen.<br />
;FTP Sicherheit <br />
:;FTPS <br />
::FTP über Secure Socket Layer (SSL) implizit<br />
:;FTPES: <br />
::FTP über Secure Socket Layer (SSL) explizit. (Hier kann der Server auch unsichere Verbindungen zulassen)<br />
;FTP Verbindung<br />
:Hier können Sie die Methode zum Verbindungsaufbau wählen. Es sollte standardmäßig PASSIVE gewählt werden.<br />
;Proxy: <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_FTPModulConf.png|thumb|right|FTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SFTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SFTP Server <br />
:IP Adresse des Servers oder Servername<br />
;SFTP Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 22)<br />
;SFTP Benutzer<br />
:Benutzername zur Authentifizierung am SFTP-Server <br />
;SFTP Password<br />
:Password zur Authentifizierung am SFTP-Server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:Falls Sie einen private Key verwenden, können Sie hier den Pfad zur Datei angeben.<br />
;Passphrase<br />
:Hier geben Sie bitte Ihre Passphrase an um die oben genannte Datei zu entschlüsseln<br />
;SFTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem SFTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "SFTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt..<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Timeout (ms)<br />
:Zeit in Millisekunden, die der Verbindungsaufbau und einzelne Kommunikationsschritte maximal in Anspruch nehmen können (im Standard 30000ms).<br />
:Im Konfigurationsdialog selbst wird unabhängig von der Einstellung ein Timeout von 5000ms verwendet, um die Verbindung schneller Testen zu können.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
<br />
'''Sollte beim Verbindungstest der Fehler "Algorithm negotiation fail" auftreten, liegt es i.d.R. daran, dass der SFTP Server alte Sicherheits Algorithmen wie z.B. ssh-dss nutzt, welche nicht mehr unterstützt werden. In diesem Fall setzen Sie den Haken "Alte Algorithmen bevorzugen" bzw. "prefer old algorithms" um eine Unterstützung der alten Sicherheits Algorithmen zu erzwingen.'''<br />
<br />
<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SMTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SMTP Server<br />
:Hier können Sie einen SMPT Server wählen, den Sie zuvor im Reiter „Server“ konfiguriert haben. Eine genaue Beschreibung finden Sie unter '''[[#SMTP Server konfigurieren|SMTP Server konfigurieren]]'''.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
;Mail Inhalt (PLAIN Text)<br />
:Unformatierter Nachrichtentext für die zu versendenden E-Mail.<br />
;Mail Inhalt (HTML Text)<br />
:HTML konform formatierter Nachrichtentext für die zu versendenden E-Mail.<br />
<br />
Der Test erfolgt bei SMTP Modulen über '''Testbutton''' im Konfigurationsdialog des entsprechenden '''Servers'''.<br />
<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
|[[Datei:ComManager_SMTPModulConf.png|thumb|super|SMTP Modul Konfiguration]]<br />
<br />
|}<br />
<br />
===PLD Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;PLD Server <br />
:HTTPS URL des Servers<br />
;PLD Pfad <br />
:Zielpfad vom HTTPS-Server<br />
;PLD Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 443)<br />
;PLD Benutzer<br />
:Benutzername zur Authentifizierung am HTTPS-Server<br />
;PLD Password<br />
:Password zur Authentifizierung am HTTPS-Server<br />
;PLD-Report Speicherpfad<br />
:Hier wird der Pfad zu einem Unterordner angegeben, in welchen die Rückmelde-/Reportdateien vom PLD-Server gespeichert werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_PLDModulConf.png|thumb|super|PLD Modul Konfiguration]]<br />
|}<br />
<br />
===HTTP(S) Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;HTTP(S) URL <br />
:Die HTTP oder HTTPS URL mit Funktionspfad und ggf. abweichendem Port des Servers<br />
:Über die Auswahl "parsbar" lässt sich die URL in Form eines Scripts hinterlegen, den man in einem Bearbeitungsdialog "..." editieren und prüfen kann.<br />
;HTTP Benutzer<br />
:Benutzername zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;HTTP Password<br />
:Password zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;MIME-Type<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Content-Type vom Request, welcher vom Server akzeptiert wird (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Downlaod Modul Konfiguration]]<br />
|}<br />
<br />
==Server==<br />
[[Datei:ComManager_Server.png|360px|thumb|right|Server]]<br />
;1 - Übersicht der eingerichteten Kommunikationsservern<br />
:'''Server ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Servers in den Modulen<br />
:'''Server Typ''' - Server Typ/Art (SMTP)<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
===SMTP Server konfigurieren===<br />
----<br />
[[Datei:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Konfiguration]]<br />
Nach der Eingabe der eindeutigen Server-ID erfolgt die Konfiguration vom neuen Kommunikationsserver.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren. <br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt. <br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert <br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
<br />
==Proxys==<br />
[[Datei:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Übersicht der eingerichteten Proxys<br />
:'''Proxy ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Proxys in den Modulen<br />
:'''Proxy Typ''' - Proxy Typ/Art (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Servername oder IP-Adresse vom Proxy<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Proxy hinzufügen''' - Option zum hinzufügen eines neuen Proxys<br />
:'''Proxy kopieren''' - Ermöglicht es den ausgewählten Proxy als Duplikat mit einer neuen ID anzulegen.<br />
:'''Proxy umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Proxy bearbeiten''' - Öffnet den Proxy-Konfigurationsdialog.<br />
:'''Proxy entfernen''' - Löscht den Proxy Eintrag. Diese Änderung ist unwiderruflich, sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Proxy<br />
<br />
<br />
===Proxy hinzufügen / konfigurieren===<br />
----<br />
[[Datei:ComManager_ProxyConf.png|300px|thumb|right|Proxy Konfiguration]]<br />
Nach der Eingabe der eindeutigen Proxy-ID erfolgt die Konfiguration vom neuen Proxy.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
;PROXY Typ<br />
:Bestimmt die Art vom eingesetzten Proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP Adresse oder Hostname unter dem der Proxy Server erreichbar ist.<br />
;PROXY Port <br />
:Port unter dem der Proxy Server erreichbar ist <br />
;PROXY Benutzer<br />
:Benutzername zur Authentifizierung am Proxy Server<br />
;PROXY Passwort<br />
:Passwort zur Authentifizierung am Proxy Server<br />
<br />
;HINWEIS<br />
:Der FTP Proxy-Typ '''USER <Benutzer>@<Host>''' wird direkt im '''FTP-Modul''' konfiguriert und nicht als Proxy.<br />
:Tragen Sie dazu die Daten im FTP-Modul wie folgt ein: '''FTP Server = <FTP-Proxy-Host>''' und '''FTP Benutzer = <FTP-Benutzer>@<FTP-Server>'''<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
=Microsoft Azure Konfiguration für Microsoft Office365 (O365)=<br />
Um E-Mails vom ComManager via Microsoft Office365 (O365) zu versenden, müssen Sie zuvor in Azure eine App registrieren dieser entsprechende Berechtigungen und Sicherheits-Features zuweisen. Dies ist notwendig um eine gültige Client-ID, Client-Secret und Tenant-ID zu bekommen und dem ComManager die Berechtigung zu erteilen Mails zu versenden.<br><br />
Wir zeigen unten wie eine '''beispielhafte Konfiguration''' vorgenommen werden kann.<br />
<br><br />
<br />
Folgende Schritte sind hierzu notwendig:<br><br />
<br><br />
# Navigieren Sie in Azure zu dem Service "App registrations" '''''[A1]'''''<br />
# Klicken Sie im Menü "App registration" auf "+ New registration" '''''[A2]'''''<br />
# Tragen Sie einen Namen für die Applikation ein (z.B. "HSC-ComManager") und wählen Sie einen Single Tenant Account Type (z.B. "Accounts in this organizational directory only")<br>Redirect URI sind nicht notwendig und können ignoriert werden '''''[A3]'''''<br />
# Klicken Sie nach der Registrierung im Menü "App registrations" auf die soeben registrierte App (z.B. "HSC-ComManager") '''''[A4]'''''<br />
# In dieser Übersicht (Overview) finden Sie die Application (client) ID und die Directory (tenant) ID, welche für den ComManager wichtig sind '''''[A5]'''''<br />
# Klicken Sie in dieser Übersicht auf "Add a certificate or secret" um dieser App ein Client-Secret hinzuzufügen. Dies ist wichtig, damit der ComManager sich später Authentifizieren kann. '''''[A5]'''''<br />
# Klicken Sie in dieser Übersicht auf "New client secret" '''''[A6]'''''<br />
# Tragen Sie eine Beschreibung für dieses Secret ein (z.B. "HSC-ComManager-Secret") und wählen Sie ein Datum, wann dieses Secret abläuft. '''''[A7]'''''<br>'''Achtung: Wenn das Secret dann zum gewählten Datum abgelaufen ist (z.B. in 30 Tagen), müssen Sie ein neues Secret hinzufügen und dies wieder im ComManager hinterlegen. Sonst ist ein Mail-Versand im ComManager mehr möglich. Hinterlegen sie sich daher unbedingt noch eine Notification, damit Sie rechtzeitig das Secret erneuern können!'''<br />
# Kopieren Sie den Wert (Value) des Secrets ('''nicht die Secret ID'''). '''''[A8]'''''<br>'''Achtung: Der Wert des Secrets wird nur jetzt angezeigt. Danach haben Sie darauf keinen Zugriff mehr!'''<br />
# Wechseln Sie danach zum Reiter "API permissions" und fügen Sie der App eine Berechtigung hinzu ("+ Add a permission") '''''[A9]'''''<br />
# Wählen Sie unter "Microsoft APIs" den Eintrag "Microsoft Graph" '''''[A10]'''''<br />
# Selektieren Sie "Application permissions", '''nicht''' "Delegated permissions" '''''[A11]'''''<br />
# Suchen und selektieren Sie "Mail.Send" und fügen Sie die Berechtigungen hinzu '''''[A12]'''''<br />
# Abhängig davon, welches Benutzer-Leven Sie haben, müssen Sie oder Ihr Administrator das Hinzufügen der Berechtigung noch explizit Bestätigen ("Grant admin consent for ...") '''''[A13]'''''<br />
<br />
<br><br />
<br />
<gallery><br />
o365_azure_01_search.png|A1: App Registration<br />
o365_azure_02_new-app-registration.png|A2: App Registration<br />
o365_azure_03_register-app.png|A3: Register App<br />
o365_azure_04_edit-app.png|A4: Edit registered App<br />
o365_azure_05_edit-app-2.png|A5: Relevant Informations / Add Client Secret<br />
o365_azure_06_add-secret.png|A6: New Client Secret<br />
o365_azure_07_add-secret-2.png|A7: Add Client Secret<br />
o365_azure_08_save-secret.png|A8: Copy Client Secret<br />
o365_azure_09_add-permission.png|A9: Add Permission to registered App<br />
o365_azure_10_add-permission-2.png|A10: Request API Permission (Graph)<br />
o365_azure_11_add-permission-3.png|A11: Request API Permission (Application)<br />
o365_azure_12_add-permission-4.png|A12: Add Mail.Send Permission<br />
o365_azure_13_add-permission-5.png|A13: Grant Admin Consent<br />
</gallery><br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Fehlercode ||Fehlerbeschreibung||Fehlerbehebung<br />
|-<br />
|COM11C00100||Unbekannter Fehler bei der Verarbeitung eines Send Message Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Send Message Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unbekannter Fehler bei der Verarbeitung eines Upload Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Upload Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Send Message Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM11W00210||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Upload Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00020||Fehler beim Konvertieren der Antwort in XML - Response ist NULL||Dies ist ein allgemeiner Fehler bei der Verarbeitung eienr Anfrage. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Fehler beim Parsen der XML Daten in REST Funktion uploadFile||Die Übergabe-Daten aus dem HVS32 für den Upload sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00110||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion uploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Fehler beim Konvertieren der Antwort in XML für REST Funktion uploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00130||Fehler beim Einlesen der Datei(en) in REST Funktion uploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob in dem entsprechenden Verzeichnis die zu übertragende Datei existiert und ausreichende Berechtigungen zum Lesen von Dateien für den Windows-Benutzer SYSTEM (oder der im Heidler-ComManager hinterlegten Windows-Benutzer) gesetzt sind. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00131||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00200||Fehler beim Parsen der XML Daten in REST Funktion downloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00210||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion downloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Fehler beim Konvertieren der Antwort in XML für REST Funktion downloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00300||Fehler beim Parsen der XML Daten in REST Funktion sendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00320||Fehler beim Konvertieren der Antwort in XML für REST Funktion sendMessage||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Fehler beim Einlesen der Datei(en) in REST Funktion sendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00331||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00400||Fehler beim Parsen der XML Daten in REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00410||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueUploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00430||Fehler beim Einlesen der Datei(en) in REST Funktion queueUploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00431||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueUploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00500||Fehler beim Parsen der XML Daten in REST Funktion queueDownloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00510||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueDownloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueDownloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00600||Fehler beim Parsen der XML Daten in REST Funktion queueSendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00620||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueSendMessage||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00630||Fehler beim Einlesen der Datei(en) in REST Funktion queueSendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00631||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueSendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00700||Fehler beim Laden der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Fehler beim Lesen der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Fehler beim Konvertieren der Antwort in XML für REST Funktion getModuleList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00800||Fehler beim Laden der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Fehler beim Lesen der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Fehler beim Konvertieren der Antwort in XML für REST Funktion getServerList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00132||Fehler beim Löschen der temporären Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00332||Fehler beim Löschen der temporären Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00100||Fehler bei Initialisierung des HVS32 Datenbank Managers||Es ist ein Fehler beim Initialisieren des DatenbankManagers aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00200||Fehler bei Initialisierung der Schreib-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Schreib-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00210||Fehler bei Initialisierung des Prepared Statements zum Updaten der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00220||Fehler beim Updaten der FF Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00225||Fehler bei Update von FF-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00230||Fehler bei Initialisierung des Prepared Statements zum Updaten der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00240||Fehler beim Updaten der WaWi-Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00245||Fehler bei Update von WaWi-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00300||Fehler bei Initialisierung der Lese-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Lese-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00310||Fehler bei Initialisierung des Prepared Statements zum Lesen der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00320||Fehler beim Lesen der FF-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00325||FF Datei in HVS32 Datenbank nicht gefunden||Die vom HVS32 übermittelte FF-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die FF-Datei wurde bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00330||Fehler bei Initialisierung des Prepared Statements zum Lesen der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00340||Fehler beim Lesen der WaWi-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00345||WaWi-Datei nicht in HVS32 Datenbank gefunden||Die vom HVS32 übermittelte WaWi-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM50C01100||Fehler beim Instanziieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Instanziieren des Upload-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Fehler beim Initialisieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Fehler beim Instanziieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Instanziieren des Download-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Fehler beim Initialisieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Fehler beim Instanziieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Instanziieren des SendMessage-Moduls fehlgeschlagen||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Fehler beim Initialisieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Fehler bei der Verbindung zum FTP Server||Es ist ein Fehler bei der Verbindung zum FTP-Server aufgetreten. Prüfen Sie den hinterlegten FTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Fehler beim Login auf FTP Server ||Es ist ein Fehler beim Login zum FTP-Server aufgetreten. Prüfen Sie die hinterlegten Login-Daten (Benutzername/Passwort) in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Fehler beim Wechseln des Verzeichnisses auf dem FTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem FTP-Server aufgetreten. Prüfen Sie das hinterlegte FTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Fehler beim Hochladen der Datei auf FTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00500||Fehler beim Herunterladen der Datei vom FTP Server||Es ist ein Fehler beim Herunterladen der Datei vom FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00410||Fehler beim Umbenennen der Datei auf FTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C00411||Fehler beim Verschieben der Datei auf FTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C99999||Aufruf einer nicht unterstützten Funktion im FTP Modul||Die Aufgerufene Funktion wird von diesem FTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM52C00100||Fehler beim Starten der Session auf dem STFP Server||Es ist ein Fehler beim Starten der Session zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Fehler beim Starten der Session auf dem Jump Host für die SFTP Übertragung||Es ist ein Fehler beim Starten der Session zum Jump Host aufgetreten. Prüfen Sie den hinterlegten Jump Host Einstellungen in der SFTP-Server Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Fehler beim Öffnen des Kanals zum SFTP Server||Es ist ein Fehler beim Öffnen des Kanals zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Fehler bei der Verbindung zum SFTP Server||Es ist ein Fehler bei der Verbindung zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Fehler beim Wechseln des Verzeichnisses auf dem SFTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem SFTP-Server aufgetreten. Prüfen Sie das hinterlegte SFTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Fehler beim Hochladen der Datei auf SFTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00510||Fehler beim Hochladen der Datei auf SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen. <br />
|-<br />
|COM52C00520||Fehler beim Umbenennen der Datei auf SFTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00521||Fehler beim Verschieben der Datei auf SFTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00600||Fehler beim Herunterladen der Datei vom SFTP Server||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00610||Fehler beim Herunterladen der Datei vom SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen.<br />
|-<br />
|COM52C99999||Aufruf einer nicht unterstützten Funktion im SFTP Modul||Die Aufgerufene Funktion wird von diesem SFTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM53C00100||SMTP Konfiguration nicht gefunden||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den ausgewählten SMTP-Server in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00101||Illegale Parameter in SMTP Konfiguration - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00102||Illegale Parameter in SMTP Konfiguration - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00103||Illegale Parameter in SMTP Konfiguration - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Mail-Text in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00105||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00110||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00111||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00112||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00120||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00130||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00131||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00132||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte CC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00133||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte BCC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00134||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00135||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00200||Keine SMTP Daten von HVS32 gefunden||Es wurden keine SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00201||SMTP Daten von HVS32 sind ungültig||Es wurden fehlerhafte SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00202||Illegale Parameter in SMTP Daten vom HVS32 - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator.<br />
|-<br />
|COM53C00203||Illegale Parameter in SMTP Daten vom HVS32 - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator.<br />
|-<br />
|COM53C00204||Illegale Parameter in SMTP Daten vom HVS32 - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00205||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00210||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00211||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00212||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00220||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00230||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00231||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00232||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte CC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00233||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte BCC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00234||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00235||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator<br />
|-<br />
|COM53C00300||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00400||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C99999||Aufruf einer nicht unterstützten Funktion im SMTP Modul||Die Aufgerufene Funktion wird von diesem SMTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54C99999||Aufruf einer nicht unterstützten Funktion im PLD Modul||Die Aufgerufene Funktion wird von diesem PLD-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54W03005||3005 PLD Warnung - Datei bereits übertragen!||Die Frachtführer-Datei wurde bereits übertragen und konnte somit vom UPS-Server nicht akzeptiert werden. Bitte übertragen Sie diese Datei nicht erneut.<br />
|-<br />
|COM54W06930||6930 PLD Warnung - Daten wurden mit Warnungen hochgeladen. Bitte korrigieren Sie diese vor dem nächsten Upload!||Die Frachtführer-Datei wurde erfolgreich an den UPS-Server übermittelt und von diesem verarbeitet. Die Datei muss nicht erneut übermittelt werden. Allerdings gibt es inhaltliche Fehler in der FF-Datei, welche vor dem nächsten Tagesabschluss behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06931||6931 PLD Fehler - Upload aufgrund von Fehlern in den PLD Daten fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06932||6932 Schwerer PLD Fehler - Upload aufgrund von Fehlern in den Input Parametern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von SCHWEREN Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06933||Unbekannter PLD Fehler - Upload aufgrund von unbekannten Fehlern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von unbekannten Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01000||Fehler in Rückmeldung - kein Statuscode gefunden!||Es wurde ein Fehler in der Rückmeldung vom UPS-Server festgestellt. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01100||Fehler beim Parsen der Rückmeldung||Es ist ein Fehler beim Parsen der Rückmeldung vom UPS-Server aufgetreten. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54W01200||Fehler beim Speichern der Reportdatei(en)||Es ist ein Fehler beim Speichern der Reports vom UPS-Server aufgetreten. Bitte prüfen Sie den konfigurierten Speicher-Pfad in der entsprechenden PLD-Modulkonfiguration des HVS32CommuniationManagers, sowie ggf. die Benutzerrechte dieses Verzeichnisses.<br />
|-<br />
|COM54C02000||HTTPS Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C03000||Fehler beim Lesen der EDI Datei||Es ist ein Fehler beim Lesen der FF-Datei im PLD Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C04000||Fehler beim Übertragen der Daten an den UPS Server||Es ist ein Fehler beim Übertragen der Daten an den UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C02000||HTTP(S) Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C04000||Fehler beim Übertragen der Daten an den HTTP(S) Server||Es ist ein Fehler beim Übertragen der Daten an den HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C05000||Fehler beim Herunterladen der Datei vom HTTP(S) Server||Es ist ein Fehler beim Herunterladen der Datei vom HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM55C99999||Aufruf einer nicht unterstützten Funktion im HTTP-Modul||Die Aufgerufene Funktion wird von diesem HTTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager(en)&diff=6103
HVS32 Communication Manager(en)
2025-03-19T10:33:02Z
<p>Bhauser: /* Microsoft Azure configuration for Microsoft Office365 (O365) support */</p>
<hr />
<div>[[de:HVS32_Communication_Manager]]<br />
The Communication Manager (hereafter abbreviated as ComManager) is a service that centrally manages communication between HVS32 and customers or HVS32 and carriers. The ComManager is designed for communications via FTP, SFTP, or SMTP protocols.<br />
<br />
Similar to WinSCP, this service is controlled by HVS32 and sends data to the destination server configured in the module.<br />
<br />
It is intended to gradually take over communications from HVS32 and replace other external transmission programs such as WinSCP.<br />
<br />
=ComManager Configuration=<br />
The ComManager Configurator can be accessed either directly through the ''ComManager-Configurator.exe'' in the installation directory ''...Heidler\HVS32\ComManager\'' or from the [[Setting up Communication Manager in HVS32|HVS32 Configurator]].<br />
<br />
[[Datei:ComManager-Main Window EN.png|500px|thumb|ohne|ComManager main window]]<br />
<br />
;1 - Link to this wiki entry<br />
;2 - Selection Tabs<br />
:'''[[HVS32_Communication_Manager(en)#Modules|Modules]]''' - Modules for file transmission during daily closing, Wawi return, and route downloads<br />
:'''[[HVS32_Communication_Manager(en)#Servers|Servers]]''' - Internal communication servers such as Microsoft Exchange (SMTP) connections<br />
:'''[[HVS32_Communication_Manager(en)#Proxies|Proxy]]''' - Internal proxy servers<br />
;3 - Overview of configured modules<br />
;4 - Summary of the configuration of the selected module<br />
;5 - [[HVS32_Communication_Manager(en)#Configure_ErrorHandler|Errorhandler Configuration]]<br />
;6 - [[HVS32_Communication_Manager(en)#Service_Settings|Service Settings]]<br />
<br />
==Service Settings==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|In this section, the basic settings of the ComManager service are configured, which are necessary to establish a connection to the service. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
<span style="color:#C00000">'''Warning: The configurations you make here will be applied only after restarting the ComManager service!'''</span><br />
<br />
;HVS32 Main Directory: <br />
:Specify the path to HVS32 here<br />
;HVS32 Database File:<br />
:Specify the path to the HVS32 database file<br />
;HVS32 Database Server:<br />
:IP address or hostname of the PC where the database is located<br />
;HVS32 Database Port:<br />
:The port for the HVS32 database usually does not need adjustment. The default port is set to 3050.<br />
;REST Port<br />
:Communication port through which the ComManager service is accessible via REST. This port must be opened in the server's firewall for external communication with the clients.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Configuration Window of Service Settings]]<br />
|}<br />
<br />
==Configure ErrorHandler==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|If an ErrorHandler is configured, you will be notified by email in case of a failed transmission. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
;Mode<br />
:First of all, you have to choose wich mode you want to use to send error mails<br />
<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
To send the error mails via SMTP choose the mode "SMTP" and enter the following parameters:<br />
;SMTP Server<br />
:IP address or hostname where the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and enable authentication.<br />
;SMTP Port<br />
:Port at which the SMTP server is accessible (25, 465, 587)<br />
;SSL enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS enabled<br />
:Data sent will be encrypted via Transport Layer Security, provided the SMTP server supports it.<br />
;TLS required<br />
:The server is requested to provide TLS support.<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
To send the error mails via Microsoft Office365 choose the mode "O365" and enter the following parameters:<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure ([[#Microsoft_Azure_configuration_for_Microsoft_Office365_.28O365.29_support|see '''Azure configuration''']])<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:Dies This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br />
===General===<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and will be displayed as the sender address for emails sent through this module.<br />
;Subject<br />
:This text will be used as the subject when sending the emails.<br />
<br />
;Test<br />
:You can use this option to send a test message to verify the configured parameters.<br />
<br />
<br />
<br />
|}<br />
<br />
==Modules==<br />
[[File:ComManager_Modules_EN.png|360px|thumb|right|Modules]]<br />
;1 - Overview of configured modules<br />
:'''Module ID''' - Selection and assignment of the module in HVS32 is done through this ID<br />
:'''Module Type''' - Type/category of module; the abbreviation "U" / "D" in parentheses indicates whether it is a '''D'''ownload (e.g., route download) or '''U'''pload module (FFFile, Wawi return, etc.)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will cause errors in process handling.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, it will cause errors in process handling.<br />
;3 - Summary of the configuration of the selected server<br />
<br />
[[File:ComManager_AddModul.png|340px|thumb|right|Add Module]]<br />
;Add / configure module<br />
Communication between HVS32 and the specified server occurs through modules. Such a server can be either a separate [[HVS32_Communication_Manager(en)#Server|(SMTP) server]] or directly the carrier's or customer's server.<br />
<br />
After selecting the module type (FTP, SFTP, SMTP, PLD/UPS, HTTP), the configuration of the new module takes place. In the following dialog, you can adjust the corresponding parameters.<br />
<br />
;Module Type<br />
:'''Carrier Module''' - Standard choice for uploading FF files during daily closing<br />
:'''Additional Transmission''' - Customer-specific transmission of, for example, Wawi return files to a customer's server<br />
:'''Download''' - Special module type for downloading, e.g., route files<br />
;Module ID<br />
:An automatically generated ID for the selection and assignment of the module in HVS32<br />
;Carrier<br />
:Additional restriction of the module for the use of specific carrier modules in HVS32 (exclusively for FF file transmission)<br />
;Principal<br />
:Additional restriction of the module for the use of specific principals/clients in HVS32 (exclusively for FF file transmission)<br />
;Note<br />
:Optional note for better overview (displayed in the overview and in HVS32)<br />
<br />
===Configure FTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;FTP Server: <br />
:IP address or hostname of the server<br />
;FTP Port: <br />
:Port at which the server is accessible (Default port 21) <br />
;FTP User<br />
:Username for authentication on the FTP server <br />
;FTP Password<br />
:Password for authentication on the FTP server <br />
;FTP Account<br />
:FTP account for authentication on the FTP server<br />
;FTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the FTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "FTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;FTP Transfer Mode<br />
:Specify whether the data should be transferred as binary or text.<br />
;FTP Security <br />
:;FTPS <br />
::FTP over Secure Socket Layer (SSL) implicitly<br />
:;FTPES: <br />
::FTP over Secure Socket Layer (SSL) explicitly. (Here, the server can allow insecure connections as well)<br />
;FTP Connection<br />
:Choose the method for establishing the connection. PASSIVE should be chosen by default.<br />
;Proxy: <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the FTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_FTPModulConf.png|thumb|right|FTP Upload Module Configuration]]<br />
[[File:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SFTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SFTP Server <br />
:IP address or hostname of the server<br />
;SFTP Port<br />
:Port at which the server is accessible (Default port 22)<br />
;SFTP User<br />
:Username for authentication on the SFTP server <br />
;SFTP Password<br />
:Password for authentication on the SFTP server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:If you are using a private key, you can specify the path to the file here.<br />
;Passphrase<br />
:Enter your passphrase here to decrypt the file mentioned above<br />
;SFTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the SFTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "SFTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;Timeout (ms)<br />
:Time in milliseconds that the connection setup and individual communication steps can take at most (standard 30000ms).<br />
:In the configuration dialog itself, a timeout of 5000ms is used regardless of the setting to test the connection more quickly.<br />
;Proxy <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
<br />
'''If you encounter the error "Algorithm negotiation fail" during the connection test, it is usually because the SFTP server uses old security algorithms such as ssh-dss, which are no longer supported. In this case, check the box "Prefer Old Algorithms" or "prefer old algorithms" to enforce support for the old security algorithms.'''<br />
<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the SFTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Module Configuration]]<br />
[[File:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SMTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SMTP Server<br />
:Choose an SMTP server that you have configured in the "Server" tab. You can find a detailed description under '''[[#Configure SMTP Server|Configure SMTP Server]]'''.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and is used as the sender address for emails sent via this module.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Subject<br />
:This text is used as the subject when sending emails.<br />
;Email Content (PLAIN Text)<br />
:Unformatted message text for the outgoing email.<br />
;Email Content (HTML Text)<br />
:HTML-compliant formatted message text for the outgoing email.<br />
<br />
Testing is done for SMTP modules via the '''Test button''' in the configuration dialog of the corresponding '''server'''.<br />
<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_SMTPModulConf.png|thumb|super|SMTP Module Configuration]]<br />
<br />
|}<br />
<br />
===Configure PLD Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;PLD Server <br />
:HTTPS URL of the server<br />
;PLD Path <br />
:Destination path on the HTTPS server<br />
;PLD Port<br />
:Port under which the server is reachable (Default port 443)<br />
;PLD User<br />
:Username for authentication on the HTTPS server<br />
;PLD Password<br />
:Password for authentication on the HTTPS server<br />
;PLD-Report Storage Path<br />
:Here, the path to a subfolder is specified where the feedback/report files from the PLD server will be saved.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_PLDModulConf.png|thumb|super|PLD Module Configuration]]<br />
|}<br />
<br />
===Configure HTTP(S) Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;HTTP(S) URL <br />
:The HTTP or HTTPS URL with function path and, if applicable, a different port of the server.<br />
:Using the "parsable" option allows you to store the URL in the form of a script that can be edited and verified in an editing dialog "...".<br />
;HTTP User<br />
:Username for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;HTTP Password<br />
:Password for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;MIME-Type<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transfer'''.)<br />
:Content-Type of the request accepted by the server (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Directory<br />
:(This option is available only for the module type '''Download'''.)<br />
:Local default directory where downloaded files should be written. Depending on the process, the directory can be overridden by HVS32.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Module Configuration]]<br />
[[File:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Download Module Configuration]]<br />
|}<br />
<br />
==Servers==<br />
[[File:ComManager_Server.png|360px|thumb|right|Servers]]<br />
;1 - Overview of configured communication servers<br />
:'''Server ID''' - Selection and assignment of the server in the modules are done based on this ID<br />
:'''Server Type''' - Server Type/Category (SMTP)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will lead to errors in process processing.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected server<br />
Keep the original file tag please<br />
<br />
===Configure SMTP Server===<br />
----<br />
[[File:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Configuration]]<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent via the server.<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;SMTP Server<br />
:IP address or hostname under which the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and activate authentication. <br />
;SMTP Port<br />
:Port under which the SMTP server is accessible (25, 465, 587)<br />
;SSL Enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS Enabled<br />
:Data sent will be encrypted via Transport Layer Security if the SMTP server supports it. <br />
;TLS Required<br />
:The server requires TLS support.<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
<br />
==Proxies==<br />
[[File:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Overview of configured proxies<br />
:'''Proxy ID''' - Selection and assignment of the proxy is done based on this ID in the modules<br />
:'''Proxy Type''' - Proxy Type/Category (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Server name or IP address of the proxy<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Proxy''' - Option to add a new proxy<br />
:'''Copy Proxy''' - Allows duplicating the selected proxy with a new ID.<br />
:'''Rename Proxy''' - Opens an input dialog to change the ID. Note: If the proxy is in use, this will lead to errors in process processing.<br />
:'''Edit Proxy''' - Opens the proxy configuration dialog.<br />
:'''Remove Proxy''' - Deletes the proxy entry. This change is irreversible; if the proxy is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected proxy<br />
<br />
<br />
===Add/Configure Proxy===<br />
----<br />
[[File:ComManager_ProxyConf.png|300px|thumb|right|Proxy Configuration]]<br />
After entering the unique proxy ID, the configuration of the new proxy is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;PROXY Type<br />
:Determines the type of the deployed proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP address or hostname under which the proxy server is accessible.<br />
;PROXY Port <br />
:Port under which the proxy server is accessible <br />
;PROXY User<br />
:Username for authentication on the proxy server<br />
;PROXY Password<br />
:Password for authentication on the proxy server<br />
<br />
;NOTE<br />
:The FTP proxy type '''USER <User>@<Host>''' is configured directly in the '''FTP module''' and not as a proxy.<br />
:To do this, enter the data in the FTP module as follows: '''FTP Server = <FTP Proxy Host>''' and '''FTP User = <FTP User>@<FTP Server>'''<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
<br />
=Microsoft Azure Configuration for Microsoft Office365 (O365)=<br />
To send emails from ComManager via Microsoft Office365 (O365), you must first register an app in Azure, assign the appropriate permissions, and configure security features. This is necessary to obtain a valid Client ID, Client Secret, and Tenant ID, as well as to grant ComManager permission to send emails.<br><br />
Below, we show how to perform an '''example configuration'''.<br />
<br><br />
<br />
The following steps are required:<br><br />
<br><br />
# Navigate to the "App registrations" service in Azure '''''[A1]'''''<br />
# Click on "+ New registration" in the "App registration" menu '''''[A2]'''''<br />
# Enter a name for the application (e.g., "HSC-ComManager") and select a Single Tenant account type (e.g., "Accounts in this organizational directory only")<br>Redirect URIs are not required and can be ignored '''''[A3]'''''<br />
# After registration, click on the newly registered app (e.g., "HSC-ComManager") in the "App registrations" menu '''''[A4]'''''<br />
# In this overview, you will find the Application (client) ID and Directory (tenant) ID, which are important for ComManager '''''[A5]'''''<br />
# Click on "Add a certificate or secret" in this overview to add a Client Secret to the app. This is necessary for ComManager to authenticate later. '''''[A5]'''''<br />
# Click on "New client secret" in this overview '''''[A6]'''''<br />
# Enter a description for this secret (e.g., "HSC-ComManager-Secret") and select an expiration date for the secret. '''''[A7]'''''<br>'''Note: When the secret expires on the selected date (e.g., in 30 days), you must add a new secret and update it in ComManager. Otherwise, email sending from ComManager will no longer be possible. Be sure to set up a notification to renew the secret in time!'''<br />
# Copy the value of the secret ('''not the Secret ID'''). '''''[A8]'''''<br>'''Note: The secret value is only displayed now. You will not have access to it later!'''<br />
# Next, switch to the "API permissions" tab and add a permission to the app ("+ Add a permission") '''''[A9]'''''<br />
# Under "Microsoft APIs," select "Microsoft Graph" '''''[A10]'''''<br />
# Select "Application permissions," '''not''' "Delegated permissions" '''''[A11]'''''<br />
# Search for and select "Mail.Send" and add the permission '''''[A12]'''''<br />
# Depending on your user level, you or your administrator may need to explicitly confirm adding the permission ("Grant admin consent for ...") '''''[A13]'''''<br />
<br />
<br><br />
<br />
<gallery><br />
o365_azure_01_search.png|A1: App Registration<br />
o365_azure_02_new-app-registration.png|A2: App Registration<br />
o365_azure_03_register-app.png|A3: Register App<br />
o365_azure_04_edit-app.png|A4: Edit registered App<br />
o365_azure_05_edit-app-2.png|A5: Relevant Information / Add Client Secret<br />
o365_azure_06_add-secret.png|A6: New Client Secret<br />
o365_azure_07_add-secret-2.png|A7: Add Client Secret<br />
o365_azure_08_save-secret.png|A8: Copy Client Secret<br />
o365_azure_09_add-permission.png|A9: Add Permission to registered App<br />
o365_azure_10_add-permission-2.png|A10: Request API Permission (Graph)<br />
o365_azure_11_add-permission-3.png|A11: Request API Permission (Application)<br />
o365_azure_12_add-permission-4.png|A12: Add Mail.Send Permission<br />
o365_azure_13_add-permission-5.png|A13: Grant Admin Consent<br />
</gallery><br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Error Code ||Error Description||Troubleshooting<br />
|-<br />
|COM11C00100||Unknown error occurred while processing a Send Message job! Response is NULL!||This is a general error in processing a Send Message job. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unknown error occurred while processing an Upload job! Response is NULL!||This is a general error in processing an Upload job. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Error occurred while deleting temporary file(s) during processing of a Send Message job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM11W00210||Error occurred while deleting temporary file(s) during processing of an Upload job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00020||Error converting response to XML - Response is NULL||This is a general error in processing a request. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Error parsing XML data in REST function uploadFile||The data received from HVS32 for upload is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00110||Error creating module configuration for REST function uploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Error converting response to XML for REST function uploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00130||Error reading file(s) in REST function uploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory and if sufficient permissions for reading files are set for the Windows user SYSTEM (or the Windows user specified in Heidler-ComManager). Try repeating the operation.<br />
|-<br />
|COM21C00131||Error writing temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00200||Error parsing XML data in REST function downloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00210||Error creating module configuration for REST function downloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Error converting response to XML for REST function downloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00300||Error parsing XML data in REST function sendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00320||Error converting response to XML for REST function sendMessage||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Error reading file(s) in REST function sendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00331||Error writing temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00400||Error parsing XML data in REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00410||Error creating module configuration for REST function queueUploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Error converting response to XML for REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00430||Error reading file(s) in REST function queueUploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00431||Error writing temporary file(s) in REST function queueUploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00500||Error parsing XML data in REST function queueDownloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00510||Error creating module configuration for REST function queueDownloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Error converting response to XML for REST function queueDownloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00600||Error parsing XML data in REST function queueSendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00620||Error converting response to XML for REST function queueSendMessage||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00630||Error reading file(s) in REST function queueSendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00631||Error writing temporary file(s) in REST function queueSendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00700||Error loading main configuration in REST function getModuleList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Error reading main configuration in REST function getModuleList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Error converting response to XML for REST function getModuleList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00800||Error loading main configuration in REST function getServerList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Error reading main configuration in REST function getServerList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Error converting response to XML for REST function getServerList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00132||Error deleting temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00332||Error deleting temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00100||Error initializing HVS32 Database Manager||There was an error initializing the Database Manager. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00200||Error initializing write connections to HVS32 database||There was an error initializing the write connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00210||Error initializing prepared statements for updating FF file in HVS32 database||There was an error initializing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00220||Error updating FF file||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00225||Error updating FF file - no results found||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00230||Error initializing prepared statements for updating WaWi file in HVS32 database||There was an error initializing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00240||Error updating WaWi file||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00245||Error updating WaWi file - no results found||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00300||Error initializing read connections to HVS32 database||There was an error initializing the read connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00310||Error initializing prepared statements for reading FF file in HVS32 database||There was an error initializing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00320||Error reading FF file from HVS32 database||There was an error executing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00325||FF file not found in HVS32 database||The FF file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The FF file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00330||Error initializing prepared statements for reading WaWi file in HVS32 database||There was an error initializing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00340||Error reading WaWi file from HVS32 database||There was an error executing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00345||WaWi file not found in HVS32 database||The WaWi file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The WaWi file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM50C01100||Error instantiating the upload module||The module for the selected module ID for upload cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Failed to instantiate the upload module||The module for the selected module ID for upload could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Error initializing the upload module||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Error instantiating the download module||The module for the selected module ID for download cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Failed to instantiate the download module||The module for the selected module ID for download could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Error initializing the download module||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Error instantiating the SendMessage module||The server module for the selected server module ID for SendMessage cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Failed to instantiate the SendMessage module||The server module for the selected server module ID for SendMessage could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Error initializing the SendMessage module||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Error connecting to FTP server||There was an error connecting to the FTP server. Please check the configured FTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Error logging into FTP server||There was an error logging into the FTP server. Please check the configured login credentials (username/password) in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Error changing directory on FTP server||There was an error changing the directory on the FTP server. Please check the configured FTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Error uploading file to FTP server||There was an error uploading the FF file to the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00500||Error downloading file from FTP server||There was an error downloading the file from the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00410||Error renaming file on FTP server||There was an error renaming the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C00411||Error moving file on FTP server||There was an error moving the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C99999||Invocation of an unsupported function in FTP module||The invoked function is not supported by this FTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM52C00100||Error starting session on SFTP server||There was an error starting the session to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Error starting session on jump host for SFTP transmission||There was an error starting the session to the jump host. Please check the configured jump host settings in the SFTP server module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Error opening channel to SFTP server||There was an error opening the channel to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Error connecting to SFTP server||There was an error connecting to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Error changing directory on SFTP server||There was an error changing the directory on the SFTP server. Please check the configured SFTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Error uploading file to SFTP server||There was an error uploading the FF file to the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00510||Error uploading file to SFTP server - Access denied!||There was an error uploading the FF file to the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C00520||Error renaming file on SFTP server||There was an error renaming the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00521||Error moving file on SFTP server||There was an error moving the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00600||Error downloading file from SFTP server||There was an error downloading the file from the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00610||Error downloading file from SFTP server - Access denied!||There was an error downloading the file from the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C99999||Invocation of an unsupported function in SFTP module||The invoked function is not supported by this SFTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM53C00100||SMTP configuration not found||There was an error in the configuration of the SMTP module. Please check the selected SMTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00101||Illegal parameters in SMTP configuration - recipient address is empty!||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00102||Illegal parameters in SMTP configuration - subject is empty!||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00103||Illegal parameters in SMTP configuration - mail text is empty!||There was an error in the configuration of the SMTP module. Please check the configured mail text in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00105||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00110||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00111||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00112||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00120||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00130||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00131||Error setting recipient address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00132||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00133||Error setting BCC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured BCC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00134||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00135||Error setting subject in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00200||No SMTP data found from HVS32||No SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00201||Invalid SMTP data from HVS32||Invalid SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00202||Illegal parameters in SMTP data from HVS32 - recipient address is empty!||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53C00203||Illegal parameters in SMTP data from HVS32 - subject is empty!||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00204||Illegal parameters in SMTP data from HVS32 - mail text is empty!||There was an error in the configuration of HVS32. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00205||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00210||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in HVS32 Configurator.<br />
|-<br />
|COM53C00211||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00212||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00220||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00230||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00231||Error setting recipient address in SMTP module||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53W00232||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in HVS32 Configurator.<br />
|-<br />
|COM53W00233||Error setting BCC address in SMTP module||There was an error in the configuration of HVS32. Please check the configured BCC address in HVS32 Configurator.<br />
|-<br />
|COM53W00234||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in HVS32 Configurator.<br />
|-<br />
|COM53W00235||Error setting subject in SMTP module||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00300||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00400||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C99999||Invocation of an unsupported function in SMTP module||The invoked function is not supported by this SMTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54C99999||Invocation of an unsupported function in PLD module||The invoked function is not supported by this PLD module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54W03005||3005 PLD Warning - File already transmitted!||The carrier file has already been transmitted and therefore could not be accepted by the UPS server. Please do not transmit this file again.<br />
|-<br />
|COM54W06930||6930 PLD Warning - Data uploaded with warnings. Please correct before the next upload!||The carrier file has been successfully transmitted to the UPS server and processed. The file does not need to be transmitted again. However, there are content errors in the FF file that need to be fixed before the next day's closure. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06931||6931 PLD Error - Upload failed due to errors in the PLD data.||The carrier file has been transmitted to the UPS server but was NOT processed due to errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06932||6932 Severe PLD Error - Upload failed due to errors in the input parameters.||The carrier file has been transmitted to the UPS server but was NOT processed due to SERIOUS errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06933||Unknown PLD Error - Upload failed due to unknown errors.||The carrier file has been transmitted to the UPS server but was NOT processed due to unknown errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C01000||Error in feedback - no status code found!||An error was detected in the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54C01100||Error parsing the feedback||There was an error parsing the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54W01200||Error saving the report file(s)||There was an error saving the reports from the UPS server. Please check the configured storage path in the corresponding PLD module configuration of HVS32CommunicationManager, as well as the user rights of this directory.<br />
|-<br />
|COM54C02000||HTTPS connection not ready!||There was an error connecting to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C03000||Error reading the EDI file||There was an error reading the FF file in the PLD module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C04000||Error transmitting data to the UPS server||There was an error transmitting data to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C02000||HTTP(S) connection not ready!||There was an error connecting to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C04000||Error transmitting data to the HTTP(S) server||There was an error transmitting data to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C05000||Error downloading file from the HTTP(S) server||There was an error downloading the file from the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C99999||Invocation of an unsupported function in HTTP module||The invoked function is not supported by this HTTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager(en)&diff=6102
HVS32 Communication Manager(en)
2025-03-19T10:29:59Z
<p>Bhauser: /* O365 */</p>
<hr />
<div>[[de:HVS32_Communication_Manager]]<br />
The Communication Manager (hereafter abbreviated as ComManager) is a service that centrally manages communication between HVS32 and customers or HVS32 and carriers. The ComManager is designed for communications via FTP, SFTP, or SMTP protocols.<br />
<br />
Similar to WinSCP, this service is controlled by HVS32 and sends data to the destination server configured in the module.<br />
<br />
It is intended to gradually take over communications from HVS32 and replace other external transmission programs such as WinSCP.<br />
<br />
=ComManager Configuration=<br />
The ComManager Configurator can be accessed either directly through the ''ComManager-Configurator.exe'' in the installation directory ''...Heidler\HVS32\ComManager\'' or from the [[Setting up Communication Manager in HVS32|HVS32 Configurator]].<br />
<br />
[[Datei:ComManager-Main Window EN.png|500px|thumb|ohne|ComManager main window]]<br />
<br />
;1 - Link to this wiki entry<br />
;2 - Selection Tabs<br />
:'''[[HVS32_Communication_Manager(en)#Modules|Modules]]''' - Modules for file transmission during daily closing, Wawi return, and route downloads<br />
:'''[[HVS32_Communication_Manager(en)#Servers|Servers]]''' - Internal communication servers such as Microsoft Exchange (SMTP) connections<br />
:'''[[HVS32_Communication_Manager(en)#Proxies|Proxy]]''' - Internal proxy servers<br />
;3 - Overview of configured modules<br />
;4 - Summary of the configuration of the selected module<br />
;5 - [[HVS32_Communication_Manager(en)#Configure_ErrorHandler|Errorhandler Configuration]]<br />
;6 - [[HVS32_Communication_Manager(en)#Service_Settings|Service Settings]]<br />
<br />
==Service Settings==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|In this section, the basic settings of the ComManager service are configured, which are necessary to establish a connection to the service. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
<span style="color:#C00000">'''Warning: The configurations you make here will be applied only after restarting the ComManager service!'''</span><br />
<br />
;HVS32 Main Directory: <br />
:Specify the path to HVS32 here<br />
;HVS32 Database File:<br />
:Specify the path to the HVS32 database file<br />
;HVS32 Database Server:<br />
:IP address or hostname of the PC where the database is located<br />
;HVS32 Database Port:<br />
:The port for the HVS32 database usually does not need adjustment. The default port is set to 3050.<br />
;REST Port<br />
:Communication port through which the ComManager service is accessible via REST. This port must be opened in the server's firewall for external communication with the clients.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Configuration Window of Service Settings]]<br />
|}<br />
<br />
==Configure ErrorHandler==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|If an ErrorHandler is configured, you will be notified by email in case of a failed transmission. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
;Mode<br />
:First of all, you have to choose wich mode you want to use to send error mails<br />
<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
To send the error mails via SMTP choose the mode "SMTP" and enter the following parameters:<br />
;SMTP Server<br />
:IP address or hostname where the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and enable authentication.<br />
;SMTP Port<br />
:Port at which the SMTP server is accessible (25, 465, 587)<br />
;SSL enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS enabled<br />
:Data sent will be encrypted via Transport Layer Security, provided the SMTP server supports it.<br />
;TLS required<br />
:The server is requested to provide TLS support.<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
To send the error mails via Microsoft Office365 choose the mode "O365" and enter the following parameters:<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure ([[#Microsoft_Azure_configuration_for_Microsoft_Office365_.28O365.29_support|see '''Azure configuration''']])<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:Dies This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br />
===General===<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and will be displayed as the sender address for emails sent through this module.<br />
;Subject<br />
:This text will be used as the subject when sending the emails.<br />
<br />
;Test<br />
:You can use this option to send a test message to verify the configured parameters.<br />
<br />
<br />
<br />
|}<br />
<br />
==Modules==<br />
[[File:ComManager_Modules_EN.png|360px|thumb|right|Modules]]<br />
;1 - Overview of configured modules<br />
:'''Module ID''' - Selection and assignment of the module in HVS32 is done through this ID<br />
:'''Module Type''' - Type/category of module; the abbreviation "U" / "D" in parentheses indicates whether it is a '''D'''ownload (e.g., route download) or '''U'''pload module (FFFile, Wawi return, etc.)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will cause errors in process handling.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, it will cause errors in process handling.<br />
;3 - Summary of the configuration of the selected server<br />
<br />
[[File:ComManager_AddModul.png|340px|thumb|right|Add Module]]<br />
;Add / configure module<br />
Communication between HVS32 and the specified server occurs through modules. Such a server can be either a separate [[HVS32_Communication_Manager(en)#Server|(SMTP) server]] or directly the carrier's or customer's server.<br />
<br />
After selecting the module type (FTP, SFTP, SMTP, PLD/UPS, HTTP), the configuration of the new module takes place. In the following dialog, you can adjust the corresponding parameters.<br />
<br />
;Module Type<br />
:'''Carrier Module''' - Standard choice for uploading FF files during daily closing<br />
:'''Additional Transmission''' - Customer-specific transmission of, for example, Wawi return files to a customer's server<br />
:'''Download''' - Special module type for downloading, e.g., route files<br />
;Module ID<br />
:An automatically generated ID for the selection and assignment of the module in HVS32<br />
;Carrier<br />
:Additional restriction of the module for the use of specific carrier modules in HVS32 (exclusively for FF file transmission)<br />
;Principal<br />
:Additional restriction of the module for the use of specific principals/clients in HVS32 (exclusively for FF file transmission)<br />
;Note<br />
:Optional note for better overview (displayed in the overview and in HVS32)<br />
<br />
===Configure FTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;FTP Server: <br />
:IP address or hostname of the server<br />
;FTP Port: <br />
:Port at which the server is accessible (Default port 21) <br />
;FTP User<br />
:Username for authentication on the FTP server <br />
;FTP Password<br />
:Password for authentication on the FTP server <br />
;FTP Account<br />
:FTP account for authentication on the FTP server<br />
;FTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the FTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "FTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;FTP Transfer Mode<br />
:Specify whether the data should be transferred as binary or text.<br />
;FTP Security <br />
:;FTPS <br />
::FTP over Secure Socket Layer (SSL) implicitly<br />
:;FTPES: <br />
::FTP over Secure Socket Layer (SSL) explicitly. (Here, the server can allow insecure connections as well)<br />
;FTP Connection<br />
:Choose the method for establishing the connection. PASSIVE should be chosen by default.<br />
;Proxy: <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the FTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_FTPModulConf.png|thumb|right|FTP Upload Module Configuration]]<br />
[[File:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SFTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SFTP Server <br />
:IP address or hostname of the server<br />
;SFTP Port<br />
:Port at which the server is accessible (Default port 22)<br />
;SFTP User<br />
:Username for authentication on the SFTP server <br />
;SFTP Password<br />
:Password for authentication on the SFTP server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:If you are using a private key, you can specify the path to the file here.<br />
;Passphrase<br />
:Enter your passphrase here to decrypt the file mentioned above<br />
;SFTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the SFTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "SFTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;Timeout (ms)<br />
:Time in milliseconds that the connection setup and individual communication steps can take at most (standard 30000ms).<br />
:In the configuration dialog itself, a timeout of 5000ms is used regardless of the setting to test the connection more quickly.<br />
;Proxy <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
<br />
'''If you encounter the error "Algorithm negotiation fail" during the connection test, it is usually because the SFTP server uses old security algorithms such as ssh-dss, which are no longer supported. In this case, check the box "Prefer Old Algorithms" or "prefer old algorithms" to enforce support for the old security algorithms.'''<br />
<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the SFTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Module Configuration]]<br />
[[File:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SMTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SMTP Server<br />
:Choose an SMTP server that you have configured in the "Server" tab. You can find a detailed description under '''[[#Configure SMTP Server|Configure SMTP Server]]'''.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and is used as the sender address for emails sent via this module.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Subject<br />
:This text is used as the subject when sending emails.<br />
;Email Content (PLAIN Text)<br />
:Unformatted message text for the outgoing email.<br />
;Email Content (HTML Text)<br />
:HTML-compliant formatted message text for the outgoing email.<br />
<br />
Testing is done for SMTP modules via the '''Test button''' in the configuration dialog of the corresponding '''server'''.<br />
<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_SMTPModulConf.png|thumb|super|SMTP Module Configuration]]<br />
<br />
|}<br />
<br />
===Configure PLD Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;PLD Server <br />
:HTTPS URL of the server<br />
;PLD Path <br />
:Destination path on the HTTPS server<br />
;PLD Port<br />
:Port under which the server is reachable (Default port 443)<br />
;PLD User<br />
:Username for authentication on the HTTPS server<br />
;PLD Password<br />
:Password for authentication on the HTTPS server<br />
;PLD-Report Storage Path<br />
:Here, the path to a subfolder is specified where the feedback/report files from the PLD server will be saved.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_PLDModulConf.png|thumb|super|PLD Module Configuration]]<br />
|}<br />
<br />
===Configure HTTP(S) Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;HTTP(S) URL <br />
:The HTTP or HTTPS URL with function path and, if applicable, a different port of the server.<br />
:Using the "parsable" option allows you to store the URL in the form of a script that can be edited and verified in an editing dialog "...".<br />
;HTTP User<br />
:Username for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;HTTP Password<br />
:Password for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;MIME-Type<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transfer'''.)<br />
:Content-Type of the request accepted by the server (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Directory<br />
:(This option is available only for the module type '''Download'''.)<br />
:Local default directory where downloaded files should be written. Depending on the process, the directory can be overridden by HVS32.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Module Configuration]]<br />
[[File:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Download Module Configuration]]<br />
|}<br />
<br />
==Servers==<br />
[[File:ComManager_Server.png|360px|thumb|right|Servers]]<br />
;1 - Overview of configured communication servers<br />
:'''Server ID''' - Selection and assignment of the server in the modules are done based on this ID<br />
:'''Server Type''' - Server Type/Category (SMTP)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will lead to errors in process processing.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected server<br />
Keep the original file tag please<br />
<br />
===Configure SMTP Server===<br />
----<br />
[[File:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Configuration]]<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent via the server.<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;SMTP Server<br />
:IP address or hostname under which the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and activate authentication. <br />
;SMTP Port<br />
:Port under which the SMTP server is accessible (25, 465, 587)<br />
;SSL Enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS Enabled<br />
:Data sent will be encrypted via Transport Layer Security if the SMTP server supports it. <br />
;TLS Required<br />
:The server requires TLS support.<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
<br />
==Proxies==<br />
[[File:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Overview of configured proxies<br />
:'''Proxy ID''' - Selection and assignment of the proxy is done based on this ID in the modules<br />
:'''Proxy Type''' - Proxy Type/Category (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Server name or IP address of the proxy<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Proxy''' - Option to add a new proxy<br />
:'''Copy Proxy''' - Allows duplicating the selected proxy with a new ID.<br />
:'''Rename Proxy''' - Opens an input dialog to change the ID. Note: If the proxy is in use, this will lead to errors in process processing.<br />
:'''Edit Proxy''' - Opens the proxy configuration dialog.<br />
:'''Remove Proxy''' - Deletes the proxy entry. This change is irreversible; if the proxy is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected proxy<br />
<br />
<br />
===Add/Configure Proxy===<br />
----<br />
[[File:ComManager_ProxyConf.png|300px|thumb|right|Proxy Configuration]]<br />
After entering the unique proxy ID, the configuration of the new proxy is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;PROXY Type<br />
:Determines the type of the deployed proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP address or hostname under which the proxy server is accessible.<br />
;PROXY Port <br />
:Port under which the proxy server is accessible <br />
;PROXY User<br />
:Username for authentication on the proxy server<br />
;PROXY Password<br />
:Password for authentication on the proxy server<br />
<br />
;NOTE<br />
:The FTP proxy type '''USER <User>@<Host>''' is configured directly in the '''FTP module''' and not as a proxy.<br />
:To do this, enter the data in the FTP module as follows: '''FTP Server = <FTP Proxy Host>''' and '''FTP User = <FTP User>@<FTP Server>'''<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
<br />
=Microsoft Azure configuration for Microsoft Office365 (O365) support=<br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Error Code ||Error Description||Troubleshooting<br />
|-<br />
|COM11C00100||Unknown error occurred while processing a Send Message job! Response is NULL!||This is a general error in processing a Send Message job. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unknown error occurred while processing an Upload job! Response is NULL!||This is a general error in processing an Upload job. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Error occurred while deleting temporary file(s) during processing of a Send Message job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM11W00210||Error occurred while deleting temporary file(s) during processing of an Upload job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00020||Error converting response to XML - Response is NULL||This is a general error in processing a request. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Error parsing XML data in REST function uploadFile||The data received from HVS32 for upload is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00110||Error creating module configuration for REST function uploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Error converting response to XML for REST function uploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00130||Error reading file(s) in REST function uploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory and if sufficient permissions for reading files are set for the Windows user SYSTEM (or the Windows user specified in Heidler-ComManager). Try repeating the operation.<br />
|-<br />
|COM21C00131||Error writing temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00200||Error parsing XML data in REST function downloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00210||Error creating module configuration for REST function downloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Error converting response to XML for REST function downloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00300||Error parsing XML data in REST function sendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00320||Error converting response to XML for REST function sendMessage||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Error reading file(s) in REST function sendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00331||Error writing temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00400||Error parsing XML data in REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00410||Error creating module configuration for REST function queueUploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Error converting response to XML for REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00430||Error reading file(s) in REST function queueUploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00431||Error writing temporary file(s) in REST function queueUploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00500||Error parsing XML data in REST function queueDownloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00510||Error creating module configuration for REST function queueDownloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Error converting response to XML for REST function queueDownloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00600||Error parsing XML data in REST function queueSendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00620||Error converting response to XML for REST function queueSendMessage||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00630||Error reading file(s) in REST function queueSendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00631||Error writing temporary file(s) in REST function queueSendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00700||Error loading main configuration in REST function getModuleList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Error reading main configuration in REST function getModuleList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Error converting response to XML for REST function getModuleList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00800||Error loading main configuration in REST function getServerList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Error reading main configuration in REST function getServerList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Error converting response to XML for REST function getServerList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00132||Error deleting temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00332||Error deleting temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00100||Error initializing HVS32 Database Manager||There was an error initializing the Database Manager. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00200||Error initializing write connections to HVS32 database||There was an error initializing the write connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00210||Error initializing prepared statements for updating FF file in HVS32 database||There was an error initializing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00220||Error updating FF file||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00225||Error updating FF file - no results found||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00230||Error initializing prepared statements for updating WaWi file in HVS32 database||There was an error initializing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00240||Error updating WaWi file||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00245||Error updating WaWi file - no results found||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00300||Error initializing read connections to HVS32 database||There was an error initializing the read connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00310||Error initializing prepared statements for reading FF file in HVS32 database||There was an error initializing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00320||Error reading FF file from HVS32 database||There was an error executing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00325||FF file not found in HVS32 database||The FF file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The FF file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00330||Error initializing prepared statements for reading WaWi file in HVS32 database||There was an error initializing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00340||Error reading WaWi file from HVS32 database||There was an error executing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00345||WaWi file not found in HVS32 database||The WaWi file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The WaWi file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM50C01100||Error instantiating the upload module||The module for the selected module ID for upload cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Failed to instantiate the upload module||The module for the selected module ID for upload could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Error initializing the upload module||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Error instantiating the download module||The module for the selected module ID for download cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Failed to instantiate the download module||The module for the selected module ID for download could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Error initializing the download module||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Error instantiating the SendMessage module||The server module for the selected server module ID for SendMessage cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Failed to instantiate the SendMessage module||The server module for the selected server module ID for SendMessage could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Error initializing the SendMessage module||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Error connecting to FTP server||There was an error connecting to the FTP server. Please check the configured FTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Error logging into FTP server||There was an error logging into the FTP server. Please check the configured login credentials (username/password) in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Error changing directory on FTP server||There was an error changing the directory on the FTP server. Please check the configured FTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Error uploading file to FTP server||There was an error uploading the FF file to the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00500||Error downloading file from FTP server||There was an error downloading the file from the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00410||Error renaming file on FTP server||There was an error renaming the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C00411||Error moving file on FTP server||There was an error moving the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C99999||Invocation of an unsupported function in FTP module||The invoked function is not supported by this FTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM52C00100||Error starting session on SFTP server||There was an error starting the session to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Error starting session on jump host for SFTP transmission||There was an error starting the session to the jump host. Please check the configured jump host settings in the SFTP server module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Error opening channel to SFTP server||There was an error opening the channel to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Error connecting to SFTP server||There was an error connecting to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Error changing directory on SFTP server||There was an error changing the directory on the SFTP server. Please check the configured SFTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Error uploading file to SFTP server||There was an error uploading the FF file to the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00510||Error uploading file to SFTP server - Access denied!||There was an error uploading the FF file to the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C00520||Error renaming file on SFTP server||There was an error renaming the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00521||Error moving file on SFTP server||There was an error moving the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00600||Error downloading file from SFTP server||There was an error downloading the file from the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00610||Error downloading file from SFTP server - Access denied!||There was an error downloading the file from the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C99999||Invocation of an unsupported function in SFTP module||The invoked function is not supported by this SFTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM53C00100||SMTP configuration not found||There was an error in the configuration of the SMTP module. Please check the selected SMTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00101||Illegal parameters in SMTP configuration - recipient address is empty!||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00102||Illegal parameters in SMTP configuration - subject is empty!||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00103||Illegal parameters in SMTP configuration - mail text is empty!||There was an error in the configuration of the SMTP module. Please check the configured mail text in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00105||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00110||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00111||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00112||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00120||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00130||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00131||Error setting recipient address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00132||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00133||Error setting BCC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured BCC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00134||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00135||Error setting subject in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00200||No SMTP data found from HVS32||No SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00201||Invalid SMTP data from HVS32||Invalid SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00202||Illegal parameters in SMTP data from HVS32 - recipient address is empty!||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53C00203||Illegal parameters in SMTP data from HVS32 - subject is empty!||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00204||Illegal parameters in SMTP data from HVS32 - mail text is empty!||There was an error in the configuration of HVS32. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00205||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00210||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in HVS32 Configurator.<br />
|-<br />
|COM53C00211||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00212||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00220||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00230||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00231||Error setting recipient address in SMTP module||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53W00232||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in HVS32 Configurator.<br />
|-<br />
|COM53W00233||Error setting BCC address in SMTP module||There was an error in the configuration of HVS32. Please check the configured BCC address in HVS32 Configurator.<br />
|-<br />
|COM53W00234||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in HVS32 Configurator.<br />
|-<br />
|COM53W00235||Error setting subject in SMTP module||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00300||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00400||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C99999||Invocation of an unsupported function in SMTP module||The invoked function is not supported by this SMTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54C99999||Invocation of an unsupported function in PLD module||The invoked function is not supported by this PLD module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54W03005||3005 PLD Warning - File already transmitted!||The carrier file has already been transmitted and therefore could not be accepted by the UPS server. Please do not transmit this file again.<br />
|-<br />
|COM54W06930||6930 PLD Warning - Data uploaded with warnings. Please correct before the next upload!||The carrier file has been successfully transmitted to the UPS server and processed. The file does not need to be transmitted again. However, there are content errors in the FF file that need to be fixed before the next day's closure. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06931||6931 PLD Error - Upload failed due to errors in the PLD data.||The carrier file has been transmitted to the UPS server but was NOT processed due to errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06932||6932 Severe PLD Error - Upload failed due to errors in the input parameters.||The carrier file has been transmitted to the UPS server but was NOT processed due to SERIOUS errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06933||Unknown PLD Error - Upload failed due to unknown errors.||The carrier file has been transmitted to the UPS server but was NOT processed due to unknown errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C01000||Error in feedback - no status code found!||An error was detected in the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54C01100||Error parsing the feedback||There was an error parsing the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54W01200||Error saving the report file(s)||There was an error saving the reports from the UPS server. Please check the configured storage path in the corresponding PLD module configuration of HVS32CommunicationManager, as well as the user rights of this directory.<br />
|-<br />
|COM54C02000||HTTPS connection not ready!||There was an error connecting to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C03000||Error reading the EDI file||There was an error reading the FF file in the PLD module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C04000||Error transmitting data to the UPS server||There was an error transmitting data to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C02000||HTTP(S) connection not ready!||There was an error connecting to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C04000||Error transmitting data to the HTTP(S) server||There was an error transmitting data to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C05000||Error downloading file from the HTTP(S) server||There was an error downloading the file from the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C99999||Invocation of an unsupported function in HTTP module||The invoked function is not supported by this HTTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager&diff=6101
HVS32 Communication Manager
2025-03-19T10:28:14Z
<p>Bhauser: /* O365 */</p>
<hr />
<div>[[en:HVS32_Communication_Manager(en)]]<br />
Der Communication Manager (fortan ComManager abgekürzt) ist ein Dienst der die Kommunikation zwischen HVS32 und Kunde oder <br><br />
HVS32 und Frachtführer zentral Verwaltet und übernimmt. Gedacht ist der ComManager für Kommunikationen via FTP, SFTP oder SMTP.<br />
<br />
Genau wie bei WinSCP wird dieser Dienst vom HVS32 angesteuert und versendet die Daten an den im Modul konfigurierten Zielserver.<br />
<br />
Er soll nach und nach die Kommunikationen des HVS32 übernehmen und andere externe Übermittlungsprogramme wie zum Beispiel WinSCP ablösen.<br />
<br />
=ComManager Konfiguration=<br />
Der ComManager-Konfigurator wird entweder direkt über die ''ComManager-Configurator.exe'' im Installationsverzeichnis ''...Heidler\HVS32\ComManager\'' oder aus dem [[HVS32_Communication_Manager_in_HVS32_einrichten|HVS32 Konfigurator]] gestartet. <br />
<br />
[[Datei:Commanager-startmaske.png|500px|thumb|ohne|Commanager-startmaske]]<br />
<br />
;1 - Link zu diesem Wiki Eintrag<br />
;2 - Auswahl Tabs<br />
:'''[[HVS32_Communication_Manager#Module|Module]]''' - Module zur Übertragung von Dateien beim Tagesabschluss, Wawi-Rück und Routendownloads<br />
:'''[[HVS32_Communication_Manager#Server|Server]]''' - Interne Kommunikationsserver wie z.B. Microsoft Exchange (SMTP) Verbindungen<br />
:'''[[HVS32_Communication_Manager#Proxys|Proxy]]''' - Interne Proxyserver<br />
;3 - Übersicht der eingerichteten Module<br />
;4 - Zusammenfassung der Konfiguration vom ausgewählten Modul<br />
;5 - [[HVS32_Communication_Manager#ErrorHandler_konfigurieren|Errorhandler Konfiguration]]<br />
;6 - [[HVS32_Communication_Manager#Dienst_Einstellungen|Dienst Einstellungen]]<br />
<br />
==Dienst Einstellungen==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Hier werden die grundlegenden Einstellungen des ComManager Dienstes vorgenommen, die erforderlich sind um eine Verbindung zum Dienst aufzubauen. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
<span style="color:#C00000">'''Warnung: Die Konfigurationen, die Sie hier vornehmen werden erst nach einem Neustart des ComManager Dienstes übernommen!'''</span><br />
<br />
;HVS32 Hauptverzeichnis: <br />
:Hier den Pfad zum HVS32 angeben<br />
;HVS32 Datenbank-Datei:<br />
:Pfad zur HVS32 Datenbank angeben. <br />
;HVS32 Datenbank Server:<br />
:IP Adresse oder Hostnamen des PCs auf dem die Datenbank liegt.<br />
;HVS32 Datenbanken Port:<br />
:Der Port zu der HVS32 Datenbank muss nur in den seltensten Fällen angepasst werden. Im Standard ist der Port auf 3050 gestellt.<br />
;REST Port<br />
:Kommunikations-Port unter welchem der ComManager-Dienst via REST erreichbar ist. Dieser muss zur externen Kommunikation mit den Clients auf dem Server in der Firewall freigegeben werden.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Konfigurationsfenster der Diensteinstellungen]]<br />
|}<br />
<br />
==ErrorHandler konfigurieren==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|Ist ein ErrorHandler konfiguriert, werden Sie im Falle einer erfolglosen Übertragung per Mail benachrichtig. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
;Mode<br />
:Wählen Sie zunächst den Modus über welchen Sie die Error-Mails versenden möchten<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
Für den Versand der E-Mails über einen SMTP, wählen Sie "SMTP" und konfigurieren Sie die folgenden Parameter:<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren.<br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt.<br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
Für den Versand der E-Mails via Microsoft Office365, wählen Sie "O365" und konfigurieren Sie die folgenden Parameter:<br />
;Graph URL<br />
:Dies ist die offizielle URL für die Microsoft Graph API. Diese ist im Standard bereits vorbelegt<br />
;Client-ID<br />
:Applikation (Client) ID der registrierten Applikation ( [[#Microsoft_Azure_Konfiguration_f.C3.BCr_Microsoft_Office365_.28O365.29|Siehe '''Azure Konfiguration''']] )<br />
;Client-Secret<br />
:in Azure hinterlegtes Secret der Applikation (nicht die ID des Secrets)<br />
;Tenant-ID<br />
:Tenant-ID der in Azure registrierten Applikation<br />
;Scope<br />
:Dies ist der Standard-Scope welcher für das Versenden von Mails via Microsoft Graph benötigt wird. Dieser Parameter ist vorbelegt.<br />
<br />
===Allgemein===<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
<br />
;Testen<br />
:Sie können mit dieser Option eine Testnachricht zur Prüfung der eingestellten Parameter verschicken.<br />
<br />
<br />
<br />
|}<br />
<br />
==Module==<br />
[[Datei:ComManager_Modul.png|360px|thumb|right|Module]]<br />
;1 - Übersicht der eingerichteten Module<br />
:'''Modul ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Moduls in HVS32<br />
:'''Modul Typ''' - Modul Typ/Art; das in der Klammer dargestellte Kürzel "U" / "D" gibt Auskunft darüber ob es ein '''D'''ownload (z.B. Routendownload) oder '''U'''pload Modul (FFDatei, WaWi-Rück., etc.) ist<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
[[Datei:ComManager_AddModul.png|340px|thumb|right|Modul hinzufügen]]<br />
;Modul hinzufügen / konfigurieren<br />
Über die Module findet die Kommunikation zwischen HVS32 und dem angegebenen Server statt. Ein solcher Server kann entweder ein eigener [[HVS32_Communication_Manager#Server|(SMTP) Server]] oder direkt der Server vom Frachtführer oder Kunden sein.<br />
<br />
Nach der Auswahl des Modul-Typs (FTP, SFTP, SMTP, PLD/UPS, HTTP) erfolgt die vor Konfiguration vom neuen Modul. In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen.<br />
<br />
;Modul Art<br />
:'''Frachtführer-Modul''' - Standard Auswahl für den Upload von FF-Dateien beim Tagesabschluss<br />
:'''Zusatzübertragung''' - Kundenindividuelle Übertragung von z.B. WaWi-Rück-Dateien an einen Kundeneigenen Server<br />
:'''Download''' - Spezielle Modul Art für den Download von z.B. Routendateien<br />
;ModulID<br />
:Eine automatisch generierte ID für die Auswahl und Zuweisung des Moduls im HVS32<br />
;Frachtführer<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Frachtführer-Modulen im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Auftraggeber<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Auftraggebern/Mandanten im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Notiz<br />
:Optionale Notiz, zur besseren Übersicht (wird in der Übersicht und im HVS32 dargestellt)<br />
<br />
<br />
===FTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;FTP Server: <br />
:IP Adresse des Servers oder Servername<br />
;FTP Port: <br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 21) <br />
;FTP Benutzer<br />
:Benutzername zur Authentifizierung am FTP-Server <br />
;FTP Password<br />
:Password zur Authentifizierung am FTP-Server <br />
;FTP Account<br />
:FTP-Account zur Authentifizierung am FTP-Server<br />
;FTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem FTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "FTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt.<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;FTP Transfer-Modus<br />
:Geben Sie an ob die Daten binär oder als Text übertragen werden sollen.<br />
;FTP Sicherheit <br />
:;FTPS <br />
::FTP über Secure Socket Layer (SSL) implizit<br />
:;FTPES: <br />
::FTP über Secure Socket Layer (SSL) explizit. (Hier kann der Server auch unsichere Verbindungen zulassen)<br />
;FTP Verbindung<br />
:Hier können Sie die Methode zum Verbindungsaufbau wählen. Es sollte standardmäßig PASSIVE gewählt werden.<br />
;Proxy: <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_FTPModulConf.png|thumb|right|FTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SFTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SFTP Server <br />
:IP Adresse des Servers oder Servername<br />
;SFTP Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 22)<br />
;SFTP Benutzer<br />
:Benutzername zur Authentifizierung am SFTP-Server <br />
;SFTP Password<br />
:Password zur Authentifizierung am SFTP-Server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:Falls Sie einen private Key verwenden, können Sie hier den Pfad zur Datei angeben.<br />
;Passphrase<br />
:Hier geben Sie bitte Ihre Passphrase an um die oben genannte Datei zu entschlüsseln<br />
;SFTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem SFTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "SFTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt..<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Timeout (ms)<br />
:Zeit in Millisekunden, die der Verbindungsaufbau und einzelne Kommunikationsschritte maximal in Anspruch nehmen können (im Standard 30000ms).<br />
:Im Konfigurationsdialog selbst wird unabhängig von der Einstellung ein Timeout von 5000ms verwendet, um die Verbindung schneller Testen zu können.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
<br />
'''Sollte beim Verbindungstest der Fehler "Algorithm negotiation fail" auftreten, liegt es i.d.R. daran, dass der SFTP Server alte Sicherheits Algorithmen wie z.B. ssh-dss nutzt, welche nicht mehr unterstützt werden. In diesem Fall setzen Sie den Haken "Alte Algorithmen bevorzugen" bzw. "prefer old algorithms" um eine Unterstützung der alten Sicherheits Algorithmen zu erzwingen.'''<br />
<br />
<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SMTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SMTP Server<br />
:Hier können Sie einen SMPT Server wählen, den Sie zuvor im Reiter „Server“ konfiguriert haben. Eine genaue Beschreibung finden Sie unter '''[[#SMTP Server konfigurieren|SMTP Server konfigurieren]]'''.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
;Mail Inhalt (PLAIN Text)<br />
:Unformatierter Nachrichtentext für die zu versendenden E-Mail.<br />
;Mail Inhalt (HTML Text)<br />
:HTML konform formatierter Nachrichtentext für die zu versendenden E-Mail.<br />
<br />
Der Test erfolgt bei SMTP Modulen über '''Testbutton''' im Konfigurationsdialog des entsprechenden '''Servers'''.<br />
<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
|[[Datei:ComManager_SMTPModulConf.png|thumb|super|SMTP Modul Konfiguration]]<br />
<br />
|}<br />
<br />
===PLD Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;PLD Server <br />
:HTTPS URL des Servers<br />
;PLD Pfad <br />
:Zielpfad vom HTTPS-Server<br />
;PLD Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 443)<br />
;PLD Benutzer<br />
:Benutzername zur Authentifizierung am HTTPS-Server<br />
;PLD Password<br />
:Password zur Authentifizierung am HTTPS-Server<br />
;PLD-Report Speicherpfad<br />
:Hier wird der Pfad zu einem Unterordner angegeben, in welchen die Rückmelde-/Reportdateien vom PLD-Server gespeichert werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_PLDModulConf.png|thumb|super|PLD Modul Konfiguration]]<br />
|}<br />
<br />
===HTTP(S) Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;HTTP(S) URL <br />
:Die HTTP oder HTTPS URL mit Funktionspfad und ggf. abweichendem Port des Servers<br />
:Über die Auswahl "parsbar" lässt sich die URL in Form eines Scripts hinterlegen, den man in einem Bearbeitungsdialog "..." editieren und prüfen kann.<br />
;HTTP Benutzer<br />
:Benutzername zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;HTTP Password<br />
:Password zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;MIME-Type<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Content-Type vom Request, welcher vom Server akzeptiert wird (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Downlaod Modul Konfiguration]]<br />
|}<br />
<br />
==Server==<br />
[[Datei:ComManager_Server.png|360px|thumb|right|Server]]<br />
;1 - Übersicht der eingerichteten Kommunikationsservern<br />
:'''Server ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Servers in den Modulen<br />
:'''Server Typ''' - Server Typ/Art (SMTP)<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
===SMTP Server konfigurieren===<br />
----<br />
[[Datei:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Konfiguration]]<br />
Nach der Eingabe der eindeutigen Server-ID erfolgt die Konfiguration vom neuen Kommunikationsserver.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren. <br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt. <br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert <br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
<br />
==Proxys==<br />
[[Datei:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Übersicht der eingerichteten Proxys<br />
:'''Proxy ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Proxys in den Modulen<br />
:'''Proxy Typ''' - Proxy Typ/Art (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Servername oder IP-Adresse vom Proxy<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Proxy hinzufügen''' - Option zum hinzufügen eines neuen Proxys<br />
:'''Proxy kopieren''' - Ermöglicht es den ausgewählten Proxy als Duplikat mit einer neuen ID anzulegen.<br />
:'''Proxy umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Proxy bearbeiten''' - Öffnet den Proxy-Konfigurationsdialog.<br />
:'''Proxy entfernen''' - Löscht den Proxy Eintrag. Diese Änderung ist unwiderruflich, sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Proxy<br />
<br />
<br />
===Proxy hinzufügen / konfigurieren===<br />
----<br />
[[Datei:ComManager_ProxyConf.png|300px|thumb|right|Proxy Konfiguration]]<br />
Nach der Eingabe der eindeutigen Proxy-ID erfolgt die Konfiguration vom neuen Proxy.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
;PROXY Typ<br />
:Bestimmt die Art vom eingesetzten Proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP Adresse oder Hostname unter dem der Proxy Server erreichbar ist.<br />
;PROXY Port <br />
:Port unter dem der Proxy Server erreichbar ist <br />
;PROXY Benutzer<br />
:Benutzername zur Authentifizierung am Proxy Server<br />
;PROXY Passwort<br />
:Passwort zur Authentifizierung am Proxy Server<br />
<br />
;HINWEIS<br />
:Der FTP Proxy-Typ '''USER <Benutzer>@<Host>''' wird direkt im '''FTP-Modul''' konfiguriert und nicht als Proxy.<br />
:Tragen Sie dazu die Daten im FTP-Modul wie folgt ein: '''FTP Server = <FTP-Proxy-Host>''' und '''FTP Benutzer = <FTP-Benutzer>@<FTP-Server>'''<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
=Microsoft Azure Konfiguration für Microsoft Office365 (O365)=<br />
Um E-Mails vom ComManager via Microsoft Office365 (O365) zu versenden, müssen Sie zuvor in Azure eine App registrieren dieser entsprechende Berechtigungen und Sicherheits-Features zuweisen. Dies ist notwendig um eine gültige Client-ID, Client-Secret und Tenant-ID zu bekommen und dem ComManager die Berechtigung zu erteilen Mails zu versenden.<br><br />
Wir zeigen unten wie eine '''beispielhafte Konfiguration''' vorgenommen werden kann.<br />
<br><br />
<br />
Folgende Schritte sind hierzu notwendig:<br><br />
<br><br />
# Navigieren Sie in Azure zu dem Service "App registrations" '''''[A1]'''''<br />
# Klicken Sie im Menü "App registration" auf "+ New registration" '''''[A2]'''''<br />
# Tragen Sie einen Namen für die Applikation ein (z.B. "HSC-ComManager") und wählen Sie einen Single Tenant Account Type (z.B. "Accounts in this organizational directory only")<br>Redirect URI sind nicht notwendig und können ignoriert werden '''''[A3]'''''<br />
# Klicken Sie nach der Registrierung im Menü "App registrations" auf die soeben registrierte App (z.B. "HSC-ComManager") '''''[A4]'''''<br />
# In dieser Übersicht (Overview) finden Sie die Application (client) ID und die Directory (tenant) ID, welche für den ComManager wichtig sind '''''[A5]'''''<br />
# Klicken Sie in dieser Übersicht auf "Add a certificate or secret" um dieser App ein Client-Secret hinzuzufügen. Dies ist wichtig, damit der ComManager sich später Authentifizieren kann. '''''[A5]'''''<br />
# Klicken Sie in dieser Übersicht auf "New client secret" '''''[A6]'''''<br />
# Tragen Sie eine Beschreibung für dieses Secret ein (z.B. "HSC-ComManager-Secret") und wählen Sie ein Datum, wann dieses Secret abläuft. '''''[A7]'''''<br>'''Achtung: Wenn das Secret dann zum gewählten Datum abgelaufen ist (z.B. in 30 Tagen), müssen Sie ein neues Secret hinzufügen und dies wieder im ComManager hinterlegen. Sonst ist ein Mail-Versand im ComManager mehr möglich. Hinterlegen sie sich daher unbedingt noch eine Notification, damit Sie rechtzeitig das Secret erneuern können!'''<br />
# Kopieren Sie den Wert (Value) des Secrets ('''nicht die Secret ID'''). '''''[A8]'''''<br>'''Achtung: Der Wert des Secrets wird nur jetzt angezeigt. Danach haben Sie darauf keinen Zugriff mehr!'''<br />
# Wechseln Sie danach zum Reiter "API permissions" und fügen Sie der App eine Berechtigung hinzu ("+ Add a permission") '''''[A9]'''''<br />
# Wählen Sie unter "Microsoft APIs" den Eintrag "Microsoft Graph" '''''[A10]'''''<br />
# Selektieren Sie "Application permissions", '''nicht''' "Delegated permissions" '''''[A11]'''''<br />
# Suchen und selektieren Sie "Mail.Send" und fügen Sie die Berechtigungen hinzu '''''[A12]'''''<br />
# Abhängig davon, welches Benutzer-Leven Sie haben, müssen Sie oder Ihr Administrator das Hinzufügen der Berechtigung noch explizit Bestätigen ("Grant admin consent for ...") '''''[A13]'''''<br />
<br />
<br><br />
<br />
<gallery><br />
o365_azure_01_search.png|A1: App Registration<br />
o365_azure_02_new-app-registration.png|A2: App Registration<br />
o365_azure_03_register-app.png|A3: Register App<br />
o365_azure_04_edit-app.png|A4: Edit registered App<br />
o365_azure_05_edit-app-2.png|A5: Relevant Informations / Add Client Secret<br />
o365_azure_06_add-secret.png|A6: New Client Secret<br />
o365_azure_07_add-secret-2.png|A7: Add Client Secret<br />
o365_azure_08_save-secret.png|A8: Copy Client Secret<br />
o365_azure_09_add-permission.png|A9: Add Permission to registered App<br />
o365_azure_10_add-permission-2.png|A10: Request API Permission (Graph)<br />
o365_azure_11_add-permission-3.png|A11: Request API Permission (Application)<br />
o365_azure_12_add-permission-4.png|A12: Add Mail.Send Permission<br />
o365_azure_13_add-permission-5.png|A13: Grant Admin Consent<br />
</gallery><br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Fehlercode ||Fehlerbeschreibung||Fehlerbehebung<br />
|-<br />
|COM11C00100||Unbekannter Fehler bei der Verarbeitung eines Send Message Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Send Message Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unbekannter Fehler bei der Verarbeitung eines Upload Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Upload Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Send Message Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM11W00210||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Upload Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00020||Fehler beim Konvertieren der Antwort in XML - Response ist NULL||Dies ist ein allgemeiner Fehler bei der Verarbeitung eienr Anfrage. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Fehler beim Parsen der XML Daten in REST Funktion uploadFile||Die Übergabe-Daten aus dem HVS32 für den Upload sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00110||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion uploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Fehler beim Konvertieren der Antwort in XML für REST Funktion uploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00130||Fehler beim Einlesen der Datei(en) in REST Funktion uploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob in dem entsprechenden Verzeichnis die zu übertragende Datei existiert und ausreichende Berechtigungen zum Lesen von Dateien für den Windows-Benutzer SYSTEM (oder der im Heidler-ComManager hinterlegten Windows-Benutzer) gesetzt sind. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00131||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00200||Fehler beim Parsen der XML Daten in REST Funktion downloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00210||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion downloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Fehler beim Konvertieren der Antwort in XML für REST Funktion downloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00300||Fehler beim Parsen der XML Daten in REST Funktion sendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00320||Fehler beim Konvertieren der Antwort in XML für REST Funktion sendMessage||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Fehler beim Einlesen der Datei(en) in REST Funktion sendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00331||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00400||Fehler beim Parsen der XML Daten in REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00410||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueUploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00430||Fehler beim Einlesen der Datei(en) in REST Funktion queueUploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00431||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueUploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00500||Fehler beim Parsen der XML Daten in REST Funktion queueDownloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00510||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueDownloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueDownloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00600||Fehler beim Parsen der XML Daten in REST Funktion queueSendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00620||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueSendMessage||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00630||Fehler beim Einlesen der Datei(en) in REST Funktion queueSendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00631||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueSendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00700||Fehler beim Laden der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Fehler beim Lesen der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Fehler beim Konvertieren der Antwort in XML für REST Funktion getModuleList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00800||Fehler beim Laden der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Fehler beim Lesen der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Fehler beim Konvertieren der Antwort in XML für REST Funktion getServerList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00132||Fehler beim Löschen der temporären Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00332||Fehler beim Löschen der temporären Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00100||Fehler bei Initialisierung des HVS32 Datenbank Managers||Es ist ein Fehler beim Initialisieren des DatenbankManagers aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00200||Fehler bei Initialisierung der Schreib-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Schreib-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00210||Fehler bei Initialisierung des Prepared Statements zum Updaten der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00220||Fehler beim Updaten der FF Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00225||Fehler bei Update von FF-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00230||Fehler bei Initialisierung des Prepared Statements zum Updaten der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00240||Fehler beim Updaten der WaWi-Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00245||Fehler bei Update von WaWi-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00300||Fehler bei Initialisierung der Lese-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Lese-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00310||Fehler bei Initialisierung des Prepared Statements zum Lesen der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00320||Fehler beim Lesen der FF-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00325||FF Datei in HVS32 Datenbank nicht gefunden||Die vom HVS32 übermittelte FF-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die FF-Datei wurde bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00330||Fehler bei Initialisierung des Prepared Statements zum Lesen der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00340||Fehler beim Lesen der WaWi-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00345||WaWi-Datei nicht in HVS32 Datenbank gefunden||Die vom HVS32 übermittelte WaWi-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM50C01100||Fehler beim Instanziieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Instanziieren des Upload-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Fehler beim Initialisieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Fehler beim Instanziieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Instanziieren des Download-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Fehler beim Initialisieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Fehler beim Instanziieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Instanziieren des SendMessage-Moduls fehlgeschlagen||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Fehler beim Initialisieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Fehler bei der Verbindung zum FTP Server||Es ist ein Fehler bei der Verbindung zum FTP-Server aufgetreten. Prüfen Sie den hinterlegten FTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Fehler beim Login auf FTP Server ||Es ist ein Fehler beim Login zum FTP-Server aufgetreten. Prüfen Sie die hinterlegten Login-Daten (Benutzername/Passwort) in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Fehler beim Wechseln des Verzeichnisses auf dem FTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem FTP-Server aufgetreten. Prüfen Sie das hinterlegte FTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Fehler beim Hochladen der Datei auf FTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00500||Fehler beim Herunterladen der Datei vom FTP Server||Es ist ein Fehler beim Herunterladen der Datei vom FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00410||Fehler beim Umbenennen der Datei auf FTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C00411||Fehler beim Verschieben der Datei auf FTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C99999||Aufruf einer nicht unterstützten Funktion im FTP Modul||Die Aufgerufene Funktion wird von diesem FTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM52C00100||Fehler beim Starten der Session auf dem STFP Server||Es ist ein Fehler beim Starten der Session zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Fehler beim Starten der Session auf dem Jump Host für die SFTP Übertragung||Es ist ein Fehler beim Starten der Session zum Jump Host aufgetreten. Prüfen Sie den hinterlegten Jump Host Einstellungen in der SFTP-Server Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Fehler beim Öffnen des Kanals zum SFTP Server||Es ist ein Fehler beim Öffnen des Kanals zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Fehler bei der Verbindung zum SFTP Server||Es ist ein Fehler bei der Verbindung zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Fehler beim Wechseln des Verzeichnisses auf dem SFTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem SFTP-Server aufgetreten. Prüfen Sie das hinterlegte SFTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Fehler beim Hochladen der Datei auf SFTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00510||Fehler beim Hochladen der Datei auf SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen. <br />
|-<br />
|COM52C00520||Fehler beim Umbenennen der Datei auf SFTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00521||Fehler beim Verschieben der Datei auf SFTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00600||Fehler beim Herunterladen der Datei vom SFTP Server||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00610||Fehler beim Herunterladen der Datei vom SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen.<br />
|-<br />
|COM52C99999||Aufruf einer nicht unterstützten Funktion im SFTP Modul||Die Aufgerufene Funktion wird von diesem SFTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM53C00100||SMTP Konfiguration nicht gefunden||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den ausgewählten SMTP-Server in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00101||Illegale Parameter in SMTP Konfiguration - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00102||Illegale Parameter in SMTP Konfiguration - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00103||Illegale Parameter in SMTP Konfiguration - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Mail-Text in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00105||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00110||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00111||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00112||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00120||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00130||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00131||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00132||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte CC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00133||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte BCC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00134||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00135||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00200||Keine SMTP Daten von HVS32 gefunden||Es wurden keine SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00201||SMTP Daten von HVS32 sind ungültig||Es wurden fehlerhafte SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00202||Illegale Parameter in SMTP Daten vom HVS32 - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator.<br />
|-<br />
|COM53C00203||Illegale Parameter in SMTP Daten vom HVS32 - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator.<br />
|-<br />
|COM53C00204||Illegale Parameter in SMTP Daten vom HVS32 - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00205||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00210||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00211||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00212||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00220||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00230||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00231||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00232||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte CC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00233||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte BCC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00234||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00235||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator<br />
|-<br />
|COM53C00300||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00400||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C99999||Aufruf einer nicht unterstützten Funktion im SMTP Modul||Die Aufgerufene Funktion wird von diesem SMTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54C99999||Aufruf einer nicht unterstützten Funktion im PLD Modul||Die Aufgerufene Funktion wird von diesem PLD-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54W03005||3005 PLD Warnung - Datei bereits übertragen!||Die Frachtführer-Datei wurde bereits übertragen und konnte somit vom UPS-Server nicht akzeptiert werden. Bitte übertragen Sie diese Datei nicht erneut.<br />
|-<br />
|COM54W06930||6930 PLD Warnung - Daten wurden mit Warnungen hochgeladen. Bitte korrigieren Sie diese vor dem nächsten Upload!||Die Frachtführer-Datei wurde erfolgreich an den UPS-Server übermittelt und von diesem verarbeitet. Die Datei muss nicht erneut übermittelt werden. Allerdings gibt es inhaltliche Fehler in der FF-Datei, welche vor dem nächsten Tagesabschluss behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06931||6931 PLD Fehler - Upload aufgrund von Fehlern in den PLD Daten fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06932||6932 Schwerer PLD Fehler - Upload aufgrund von Fehlern in den Input Parametern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von SCHWEREN Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06933||Unbekannter PLD Fehler - Upload aufgrund von unbekannten Fehlern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von unbekannten Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01000||Fehler in Rückmeldung - kein Statuscode gefunden!||Es wurde ein Fehler in der Rückmeldung vom UPS-Server festgestellt. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01100||Fehler beim Parsen der Rückmeldung||Es ist ein Fehler beim Parsen der Rückmeldung vom UPS-Server aufgetreten. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54W01200||Fehler beim Speichern der Reportdatei(en)||Es ist ein Fehler beim Speichern der Reports vom UPS-Server aufgetreten. Bitte prüfen Sie den konfigurierten Speicher-Pfad in der entsprechenden PLD-Modulkonfiguration des HVS32CommuniationManagers, sowie ggf. die Benutzerrechte dieses Verzeichnisses.<br />
|-<br />
|COM54C02000||HTTPS Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C03000||Fehler beim Lesen der EDI Datei||Es ist ein Fehler beim Lesen der FF-Datei im PLD Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C04000||Fehler beim Übertragen der Daten an den UPS Server||Es ist ein Fehler beim Übertragen der Daten an den UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C02000||HTTP(S) Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C04000||Fehler beim Übertragen der Daten an den HTTP(S) Server||Es ist ein Fehler beim Übertragen der Daten an den HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C05000||Fehler beim Herunterladen der Datei vom HTTP(S) Server||Es ist ein Fehler beim Herunterladen der Datei vom HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM55C99999||Aufruf einer nicht unterstützten Funktion im HTTP-Modul||Die Aufgerufene Funktion wird von diesem HTTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager&diff=6100
HVS32 Communication Manager
2025-03-19T10:25:18Z
<p>Bhauser: /* Microsoft Azure Konfiguration für Microsoft Office365 (O365) */</p>
<hr />
<div>[[en:HVS32_Communication_Manager(en)]]<br />
Der Communication Manager (fortan ComManager abgekürzt) ist ein Dienst der die Kommunikation zwischen HVS32 und Kunde oder <br><br />
HVS32 und Frachtführer zentral Verwaltet und übernimmt. Gedacht ist der ComManager für Kommunikationen via FTP, SFTP oder SMTP.<br />
<br />
Genau wie bei WinSCP wird dieser Dienst vom HVS32 angesteuert und versendet die Daten an den im Modul konfigurierten Zielserver.<br />
<br />
Er soll nach und nach die Kommunikationen des HVS32 übernehmen und andere externe Übermittlungsprogramme wie zum Beispiel WinSCP ablösen.<br />
<br />
=ComManager Konfiguration=<br />
Der ComManager-Konfigurator wird entweder direkt über die ''ComManager-Configurator.exe'' im Installationsverzeichnis ''...Heidler\HVS32\ComManager\'' oder aus dem [[HVS32_Communication_Manager_in_HVS32_einrichten|HVS32 Konfigurator]] gestartet. <br />
<br />
[[Datei:Commanager-startmaske.png|500px|thumb|ohne|Commanager-startmaske]]<br />
<br />
;1 - Link zu diesem Wiki Eintrag<br />
;2 - Auswahl Tabs<br />
:'''[[HVS32_Communication_Manager#Module|Module]]''' - Module zur Übertragung von Dateien beim Tagesabschluss, Wawi-Rück und Routendownloads<br />
:'''[[HVS32_Communication_Manager#Server|Server]]''' - Interne Kommunikationsserver wie z.B. Microsoft Exchange (SMTP) Verbindungen<br />
:'''[[HVS32_Communication_Manager#Proxys|Proxy]]''' - Interne Proxyserver<br />
;3 - Übersicht der eingerichteten Module<br />
;4 - Zusammenfassung der Konfiguration vom ausgewählten Modul<br />
;5 - [[HVS32_Communication_Manager#ErrorHandler_konfigurieren|Errorhandler Konfiguration]]<br />
;6 - [[HVS32_Communication_Manager#Dienst_Einstellungen|Dienst Einstellungen]]<br />
<br />
==Dienst Einstellungen==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Hier werden die grundlegenden Einstellungen des ComManager Dienstes vorgenommen, die erforderlich sind um eine Verbindung zum Dienst aufzubauen. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
<span style="color:#C00000">'''Warnung: Die Konfigurationen, die Sie hier vornehmen werden erst nach einem Neustart des ComManager Dienstes übernommen!'''</span><br />
<br />
;HVS32 Hauptverzeichnis: <br />
:Hier den Pfad zum HVS32 angeben<br />
;HVS32 Datenbank-Datei:<br />
:Pfad zur HVS32 Datenbank angeben. <br />
;HVS32 Datenbank Server:<br />
:IP Adresse oder Hostnamen des PCs auf dem die Datenbank liegt.<br />
;HVS32 Datenbanken Port:<br />
:Der Port zu der HVS32 Datenbank muss nur in den seltensten Fällen angepasst werden. Im Standard ist der Port auf 3050 gestellt.<br />
;REST Port<br />
:Kommunikations-Port unter welchem der ComManager-Dienst via REST erreichbar ist. Dieser muss zur externen Kommunikation mit den Clients auf dem Server in der Firewall freigegeben werden.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Konfigurationsfenster der Diensteinstellungen]]<br />
|}<br />
<br />
==ErrorHandler konfigurieren==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|Ist ein ErrorHandler konfiguriert, werden Sie im Falle einer erfolglosen Übertragung per Mail benachrichtig. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
;Mode<br />
:Wählen Sie zunächst den Modus über welchen Sie die Error-Mails versenden möchten<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
Für den Versand der E-Mails über einen SMTP, wählen Sie "SMTP" und konfigurieren Sie die folgenden Parameter:<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren.<br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt.<br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
Für den Versand der E-Mails via Microsoft Office365, wählen Sie "O365" und konfigurieren Sie die folgenden Parameter:<br />
;Graph URL<br />
:Dies ist die offizielle URL für die Microsoft Graph API. Diese ist im Standard bereits vorbelegt<br />
;Client-ID<br />
:Applikation (Client) ID der registrierten Applikation (siehe Azure Konfiguration)<br />
;Client-Secret<br />
:in Azure hinterlegtes Secret der Applikation (nicht die ID des Secrets)<br />
;Tenant-ID<br />
:Tenant-ID der in Azure registrierten Applikation<br />
;Scope<br />
:Dies ist der Standard-Scope welcher für das Versenden von Mails via Microsoft Graph benötigt wird. Dieser Parameter ist vorbelegt.<br />
<br />
===Allgemein===<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
<br />
;Testen<br />
:Sie können mit dieser Option eine Testnachricht zur Prüfung der eingestellten Parameter verschicken.<br />
<br />
<br />
<br />
|}<br />
<br />
==Module==<br />
[[Datei:ComManager_Modul.png|360px|thumb|right|Module]]<br />
;1 - Übersicht der eingerichteten Module<br />
:'''Modul ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Moduls in HVS32<br />
:'''Modul Typ''' - Modul Typ/Art; das in der Klammer dargestellte Kürzel "U" / "D" gibt Auskunft darüber ob es ein '''D'''ownload (z.B. Routendownload) oder '''U'''pload Modul (FFDatei, WaWi-Rück., etc.) ist<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
[[Datei:ComManager_AddModul.png|340px|thumb|right|Modul hinzufügen]]<br />
;Modul hinzufügen / konfigurieren<br />
Über die Module findet die Kommunikation zwischen HVS32 und dem angegebenen Server statt. Ein solcher Server kann entweder ein eigener [[HVS32_Communication_Manager#Server|(SMTP) Server]] oder direkt der Server vom Frachtführer oder Kunden sein.<br />
<br />
Nach der Auswahl des Modul-Typs (FTP, SFTP, SMTP, PLD/UPS, HTTP) erfolgt die vor Konfiguration vom neuen Modul. In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen.<br />
<br />
;Modul Art<br />
:'''Frachtführer-Modul''' - Standard Auswahl für den Upload von FF-Dateien beim Tagesabschluss<br />
:'''Zusatzübertragung''' - Kundenindividuelle Übertragung von z.B. WaWi-Rück-Dateien an einen Kundeneigenen Server<br />
:'''Download''' - Spezielle Modul Art für den Download von z.B. Routendateien<br />
;ModulID<br />
:Eine automatisch generierte ID für die Auswahl und Zuweisung des Moduls im HVS32<br />
;Frachtführer<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Frachtführer-Modulen im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Auftraggeber<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Auftraggebern/Mandanten im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Notiz<br />
:Optionale Notiz, zur besseren Übersicht (wird in der Übersicht und im HVS32 dargestellt)<br />
<br />
<br />
===FTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;FTP Server: <br />
:IP Adresse des Servers oder Servername<br />
;FTP Port: <br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 21) <br />
;FTP Benutzer<br />
:Benutzername zur Authentifizierung am FTP-Server <br />
;FTP Password<br />
:Password zur Authentifizierung am FTP-Server <br />
;FTP Account<br />
:FTP-Account zur Authentifizierung am FTP-Server<br />
;FTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem FTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "FTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt.<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;FTP Transfer-Modus<br />
:Geben Sie an ob die Daten binär oder als Text übertragen werden sollen.<br />
;FTP Sicherheit <br />
:;FTPS <br />
::FTP über Secure Socket Layer (SSL) implizit<br />
:;FTPES: <br />
::FTP über Secure Socket Layer (SSL) explizit. (Hier kann der Server auch unsichere Verbindungen zulassen)<br />
;FTP Verbindung<br />
:Hier können Sie die Methode zum Verbindungsaufbau wählen. Es sollte standardmäßig PASSIVE gewählt werden.<br />
;Proxy: <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_FTPModulConf.png|thumb|right|FTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SFTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SFTP Server <br />
:IP Adresse des Servers oder Servername<br />
;SFTP Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 22)<br />
;SFTP Benutzer<br />
:Benutzername zur Authentifizierung am SFTP-Server <br />
;SFTP Password<br />
:Password zur Authentifizierung am SFTP-Server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:Falls Sie einen private Key verwenden, können Sie hier den Pfad zur Datei angeben.<br />
;Passphrase<br />
:Hier geben Sie bitte Ihre Passphrase an um die oben genannte Datei zu entschlüsseln<br />
;SFTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem SFTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "SFTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt..<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Timeout (ms)<br />
:Zeit in Millisekunden, die der Verbindungsaufbau und einzelne Kommunikationsschritte maximal in Anspruch nehmen können (im Standard 30000ms).<br />
:Im Konfigurationsdialog selbst wird unabhängig von der Einstellung ein Timeout von 5000ms verwendet, um die Verbindung schneller Testen zu können.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
<br />
'''Sollte beim Verbindungstest der Fehler "Algorithm negotiation fail" auftreten, liegt es i.d.R. daran, dass der SFTP Server alte Sicherheits Algorithmen wie z.B. ssh-dss nutzt, welche nicht mehr unterstützt werden. In diesem Fall setzen Sie den Haken "Alte Algorithmen bevorzugen" bzw. "prefer old algorithms" um eine Unterstützung der alten Sicherheits Algorithmen zu erzwingen.'''<br />
<br />
<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SMTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SMTP Server<br />
:Hier können Sie einen SMPT Server wählen, den Sie zuvor im Reiter „Server“ konfiguriert haben. Eine genaue Beschreibung finden Sie unter '''[[#SMTP Server konfigurieren|SMTP Server konfigurieren]]'''.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
;Mail Inhalt (PLAIN Text)<br />
:Unformatierter Nachrichtentext für die zu versendenden E-Mail.<br />
;Mail Inhalt (HTML Text)<br />
:HTML konform formatierter Nachrichtentext für die zu versendenden E-Mail.<br />
<br />
Der Test erfolgt bei SMTP Modulen über '''Testbutton''' im Konfigurationsdialog des entsprechenden '''Servers'''.<br />
<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
|[[Datei:ComManager_SMTPModulConf.png|thumb|super|SMTP Modul Konfiguration]]<br />
<br />
|}<br />
<br />
===PLD Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;PLD Server <br />
:HTTPS URL des Servers<br />
;PLD Pfad <br />
:Zielpfad vom HTTPS-Server<br />
;PLD Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 443)<br />
;PLD Benutzer<br />
:Benutzername zur Authentifizierung am HTTPS-Server<br />
;PLD Password<br />
:Password zur Authentifizierung am HTTPS-Server<br />
;PLD-Report Speicherpfad<br />
:Hier wird der Pfad zu einem Unterordner angegeben, in welchen die Rückmelde-/Reportdateien vom PLD-Server gespeichert werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_PLDModulConf.png|thumb|super|PLD Modul Konfiguration]]<br />
|}<br />
<br />
===HTTP(S) Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;HTTP(S) URL <br />
:Die HTTP oder HTTPS URL mit Funktionspfad und ggf. abweichendem Port des Servers<br />
:Über die Auswahl "parsbar" lässt sich die URL in Form eines Scripts hinterlegen, den man in einem Bearbeitungsdialog "..." editieren und prüfen kann.<br />
;HTTP Benutzer<br />
:Benutzername zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;HTTP Password<br />
:Password zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;MIME-Type<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Content-Type vom Request, welcher vom Server akzeptiert wird (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Downlaod Modul Konfiguration]]<br />
|}<br />
<br />
==Server==<br />
[[Datei:ComManager_Server.png|360px|thumb|right|Server]]<br />
;1 - Übersicht der eingerichteten Kommunikationsservern<br />
:'''Server ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Servers in den Modulen<br />
:'''Server Typ''' - Server Typ/Art (SMTP)<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
===SMTP Server konfigurieren===<br />
----<br />
[[Datei:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Konfiguration]]<br />
Nach der Eingabe der eindeutigen Server-ID erfolgt die Konfiguration vom neuen Kommunikationsserver.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren. <br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt. <br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert <br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
<br />
==Proxys==<br />
[[Datei:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Übersicht der eingerichteten Proxys<br />
:'''Proxy ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Proxys in den Modulen<br />
:'''Proxy Typ''' - Proxy Typ/Art (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Servername oder IP-Adresse vom Proxy<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Proxy hinzufügen''' - Option zum hinzufügen eines neuen Proxys<br />
:'''Proxy kopieren''' - Ermöglicht es den ausgewählten Proxy als Duplikat mit einer neuen ID anzulegen.<br />
:'''Proxy umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Proxy bearbeiten''' - Öffnet den Proxy-Konfigurationsdialog.<br />
:'''Proxy entfernen''' - Löscht den Proxy Eintrag. Diese Änderung ist unwiderruflich, sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Proxy<br />
<br />
<br />
===Proxy hinzufügen / konfigurieren===<br />
----<br />
[[Datei:ComManager_ProxyConf.png|300px|thumb|right|Proxy Konfiguration]]<br />
Nach der Eingabe der eindeutigen Proxy-ID erfolgt die Konfiguration vom neuen Proxy.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
;PROXY Typ<br />
:Bestimmt die Art vom eingesetzten Proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP Adresse oder Hostname unter dem der Proxy Server erreichbar ist.<br />
;PROXY Port <br />
:Port unter dem der Proxy Server erreichbar ist <br />
;PROXY Benutzer<br />
:Benutzername zur Authentifizierung am Proxy Server<br />
;PROXY Passwort<br />
:Passwort zur Authentifizierung am Proxy Server<br />
<br />
;HINWEIS<br />
:Der FTP Proxy-Typ '''USER <Benutzer>@<Host>''' wird direkt im '''FTP-Modul''' konfiguriert und nicht als Proxy.<br />
:Tragen Sie dazu die Daten im FTP-Modul wie folgt ein: '''FTP Server = <FTP-Proxy-Host>''' und '''FTP Benutzer = <FTP-Benutzer>@<FTP-Server>'''<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
=Microsoft Azure Konfiguration für Microsoft Office365 (O365)=<br />
Um E-Mails vom ComManager via Microsoft Office365 (O365) zu versenden, müssen Sie zuvor in Azure eine App registrieren dieser entsprechende Berechtigungen und Sicherheits-Features zuweisen. Dies ist notwendig um eine gültige Client-ID, Client-Secret und Tenant-ID zu bekommen und dem ComManager die Berechtigung zu erteilen Mails zu versenden.<br><br />
Wir zeigen unten wie eine '''beispielhafte Konfiguration''' vorgenommen werden kann.<br />
<br><br />
<br />
Folgende Schritte sind hierzu notwendig:<br><br />
<br><br />
# Navigieren Sie in Azure zu dem Service "App registrations" '''''[A1]'''''<br />
# Klicken Sie im Menü "App registration" auf "+ New registration" '''''[A2]'''''<br />
# Tragen Sie einen Namen für die Applikation ein (z.B. "HSC-ComManager") und wählen Sie einen Single Tenant Account Type (z.B. "Accounts in this organizational directory only")<br>Redirect URI sind nicht notwendig und können ignoriert werden '''''[A3]'''''<br />
# Klicken Sie nach der Registrierung im Menü "App registrations" auf die soeben registrierte App (z.B. "HSC-ComManager") '''''[A4]'''''<br />
# In dieser Übersicht (Overview) finden Sie die Application (client) ID und die Directory (tenant) ID, welche für den ComManager wichtig sind '''''[A5]'''''<br />
# Klicken Sie in dieser Übersicht auf "Add a certificate or secret" um dieser App ein Client-Secret hinzuzufügen. Dies ist wichtig, damit der ComManager sich später Authentifizieren kann. '''''[A5]'''''<br />
# Klicken Sie in dieser Übersicht auf "New client secret" '''''[A6]'''''<br />
# Tragen Sie eine Beschreibung für dieses Secret ein (z.B. "HSC-ComManager-Secret") und wählen Sie ein Datum, wann dieses Secret abläuft. '''''[A7]'''''<br>'''Achtung: Wenn das Secret dann zum gewählten Datum abgelaufen ist (z.B. in 30 Tagen), müssen Sie ein neues Secret hinzufügen und dies wieder im ComManager hinterlegen. Sonst ist ein Mail-Versand im ComManager mehr möglich. Hinterlegen sie sich daher unbedingt noch eine Notification, damit Sie rechtzeitig das Secret erneuern können!'''<br />
# Kopieren Sie den Wert (Value) des Secrets ('''nicht die Secret ID'''). '''''[A8]'''''<br>'''Achtung: Der Wert des Secrets wird nur jetzt angezeigt. Danach haben Sie darauf keinen Zugriff mehr!'''<br />
# Wechseln Sie danach zum Reiter "API permissions" und fügen Sie der App eine Berechtigung hinzu ("+ Add a permission") '''''[A9]'''''<br />
# Wählen Sie unter "Microsoft APIs" den Eintrag "Microsoft Graph" '''''[A10]'''''<br />
# Selektieren Sie "Application permissions", '''nicht''' "Delegated permissions" '''''[A11]'''''<br />
# Suchen und selektieren Sie "Mail.Send" und fügen Sie die Berechtigungen hinzu '''''[A12]'''''<br />
# Abhängig davon, welches Benutzer-Leven Sie haben, müssen Sie oder Ihr Administrator das Hinzufügen der Berechtigung noch explizit Bestätigen ("Grant admin consent for ...") '''''[A13]'''''<br />
<br />
<br><br />
<br />
<gallery><br />
o365_azure_01_search.png|A1: App Registration<br />
o365_azure_02_new-app-registration.png|A2: App Registration<br />
o365_azure_03_register-app.png|A3: Register App<br />
o365_azure_04_edit-app.png|A4: Edit registered App<br />
o365_azure_05_edit-app-2.png|A5: Relevant Informations / Add Client Secret<br />
o365_azure_06_add-secret.png|A6: New Client Secret<br />
o365_azure_07_add-secret-2.png|A7: Add Client Secret<br />
o365_azure_08_save-secret.png|A8: Copy Client Secret<br />
o365_azure_09_add-permission.png|A9: Add Permission to registered App<br />
o365_azure_10_add-permission-2.png|A10: Request API Permission (Graph)<br />
o365_azure_11_add-permission-3.png|A11: Request API Permission (Application)<br />
o365_azure_12_add-permission-4.png|A12: Add Mail.Send Permission<br />
o365_azure_13_add-permission-5.png|A13: Grant Admin Consent<br />
</gallery><br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Fehlercode ||Fehlerbeschreibung||Fehlerbehebung<br />
|-<br />
|COM11C00100||Unbekannter Fehler bei der Verarbeitung eines Send Message Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Send Message Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unbekannter Fehler bei der Verarbeitung eines Upload Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Upload Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Send Message Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM11W00210||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Upload Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00020||Fehler beim Konvertieren der Antwort in XML - Response ist NULL||Dies ist ein allgemeiner Fehler bei der Verarbeitung eienr Anfrage. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Fehler beim Parsen der XML Daten in REST Funktion uploadFile||Die Übergabe-Daten aus dem HVS32 für den Upload sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00110||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion uploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Fehler beim Konvertieren der Antwort in XML für REST Funktion uploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00130||Fehler beim Einlesen der Datei(en) in REST Funktion uploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob in dem entsprechenden Verzeichnis die zu übertragende Datei existiert und ausreichende Berechtigungen zum Lesen von Dateien für den Windows-Benutzer SYSTEM (oder der im Heidler-ComManager hinterlegten Windows-Benutzer) gesetzt sind. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00131||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00200||Fehler beim Parsen der XML Daten in REST Funktion downloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00210||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion downloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Fehler beim Konvertieren der Antwort in XML für REST Funktion downloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00300||Fehler beim Parsen der XML Daten in REST Funktion sendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00320||Fehler beim Konvertieren der Antwort in XML für REST Funktion sendMessage||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Fehler beim Einlesen der Datei(en) in REST Funktion sendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00331||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00400||Fehler beim Parsen der XML Daten in REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00410||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueUploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00430||Fehler beim Einlesen der Datei(en) in REST Funktion queueUploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00431||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueUploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00500||Fehler beim Parsen der XML Daten in REST Funktion queueDownloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00510||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueDownloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueDownloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00600||Fehler beim Parsen der XML Daten in REST Funktion queueSendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00620||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueSendMessage||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00630||Fehler beim Einlesen der Datei(en) in REST Funktion queueSendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00631||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueSendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00700||Fehler beim Laden der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Fehler beim Lesen der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Fehler beim Konvertieren der Antwort in XML für REST Funktion getModuleList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00800||Fehler beim Laden der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Fehler beim Lesen der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Fehler beim Konvertieren der Antwort in XML für REST Funktion getServerList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00132||Fehler beim Löschen der temporären Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00332||Fehler beim Löschen der temporären Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00100||Fehler bei Initialisierung des HVS32 Datenbank Managers||Es ist ein Fehler beim Initialisieren des DatenbankManagers aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00200||Fehler bei Initialisierung der Schreib-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Schreib-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00210||Fehler bei Initialisierung des Prepared Statements zum Updaten der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00220||Fehler beim Updaten der FF Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00225||Fehler bei Update von FF-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00230||Fehler bei Initialisierung des Prepared Statements zum Updaten der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00240||Fehler beim Updaten der WaWi-Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00245||Fehler bei Update von WaWi-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00300||Fehler bei Initialisierung der Lese-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Lese-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00310||Fehler bei Initialisierung des Prepared Statements zum Lesen der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00320||Fehler beim Lesen der FF-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00325||FF Datei in HVS32 Datenbank nicht gefunden||Die vom HVS32 übermittelte FF-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die FF-Datei wurde bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00330||Fehler bei Initialisierung des Prepared Statements zum Lesen der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00340||Fehler beim Lesen der WaWi-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00345||WaWi-Datei nicht in HVS32 Datenbank gefunden||Die vom HVS32 übermittelte WaWi-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM50C01100||Fehler beim Instanziieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Instanziieren des Upload-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Fehler beim Initialisieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Fehler beim Instanziieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Instanziieren des Download-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Fehler beim Initialisieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Fehler beim Instanziieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Instanziieren des SendMessage-Moduls fehlgeschlagen||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Fehler beim Initialisieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Fehler bei der Verbindung zum FTP Server||Es ist ein Fehler bei der Verbindung zum FTP-Server aufgetreten. Prüfen Sie den hinterlegten FTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Fehler beim Login auf FTP Server ||Es ist ein Fehler beim Login zum FTP-Server aufgetreten. Prüfen Sie die hinterlegten Login-Daten (Benutzername/Passwort) in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Fehler beim Wechseln des Verzeichnisses auf dem FTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem FTP-Server aufgetreten. Prüfen Sie das hinterlegte FTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Fehler beim Hochladen der Datei auf FTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00500||Fehler beim Herunterladen der Datei vom FTP Server||Es ist ein Fehler beim Herunterladen der Datei vom FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00410||Fehler beim Umbenennen der Datei auf FTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C00411||Fehler beim Verschieben der Datei auf FTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C99999||Aufruf einer nicht unterstützten Funktion im FTP Modul||Die Aufgerufene Funktion wird von diesem FTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM52C00100||Fehler beim Starten der Session auf dem STFP Server||Es ist ein Fehler beim Starten der Session zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Fehler beim Starten der Session auf dem Jump Host für die SFTP Übertragung||Es ist ein Fehler beim Starten der Session zum Jump Host aufgetreten. Prüfen Sie den hinterlegten Jump Host Einstellungen in der SFTP-Server Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Fehler beim Öffnen des Kanals zum SFTP Server||Es ist ein Fehler beim Öffnen des Kanals zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Fehler bei der Verbindung zum SFTP Server||Es ist ein Fehler bei der Verbindung zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Fehler beim Wechseln des Verzeichnisses auf dem SFTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem SFTP-Server aufgetreten. Prüfen Sie das hinterlegte SFTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Fehler beim Hochladen der Datei auf SFTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00510||Fehler beim Hochladen der Datei auf SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen. <br />
|-<br />
|COM52C00520||Fehler beim Umbenennen der Datei auf SFTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00521||Fehler beim Verschieben der Datei auf SFTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00600||Fehler beim Herunterladen der Datei vom SFTP Server||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00610||Fehler beim Herunterladen der Datei vom SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen.<br />
|-<br />
|COM52C99999||Aufruf einer nicht unterstützten Funktion im SFTP Modul||Die Aufgerufene Funktion wird von diesem SFTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM53C00100||SMTP Konfiguration nicht gefunden||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den ausgewählten SMTP-Server in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00101||Illegale Parameter in SMTP Konfiguration - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00102||Illegale Parameter in SMTP Konfiguration - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00103||Illegale Parameter in SMTP Konfiguration - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Mail-Text in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00105||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00110||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00111||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00112||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00120||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00130||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00131||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00132||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte CC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00133||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte BCC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00134||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00135||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00200||Keine SMTP Daten von HVS32 gefunden||Es wurden keine SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00201||SMTP Daten von HVS32 sind ungültig||Es wurden fehlerhafte SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00202||Illegale Parameter in SMTP Daten vom HVS32 - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator.<br />
|-<br />
|COM53C00203||Illegale Parameter in SMTP Daten vom HVS32 - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator.<br />
|-<br />
|COM53C00204||Illegale Parameter in SMTP Daten vom HVS32 - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00205||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00210||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00211||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00212||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00220||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00230||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00231||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00232||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte CC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00233||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte BCC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00234||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00235||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator<br />
|-<br />
|COM53C00300||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00400||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C99999||Aufruf einer nicht unterstützten Funktion im SMTP Modul||Die Aufgerufene Funktion wird von diesem SMTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54C99999||Aufruf einer nicht unterstützten Funktion im PLD Modul||Die Aufgerufene Funktion wird von diesem PLD-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54W03005||3005 PLD Warnung - Datei bereits übertragen!||Die Frachtführer-Datei wurde bereits übertragen und konnte somit vom UPS-Server nicht akzeptiert werden. Bitte übertragen Sie diese Datei nicht erneut.<br />
|-<br />
|COM54W06930||6930 PLD Warnung - Daten wurden mit Warnungen hochgeladen. Bitte korrigieren Sie diese vor dem nächsten Upload!||Die Frachtführer-Datei wurde erfolgreich an den UPS-Server übermittelt und von diesem verarbeitet. Die Datei muss nicht erneut übermittelt werden. Allerdings gibt es inhaltliche Fehler in der FF-Datei, welche vor dem nächsten Tagesabschluss behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06931||6931 PLD Fehler - Upload aufgrund von Fehlern in den PLD Daten fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06932||6932 Schwerer PLD Fehler - Upload aufgrund von Fehlern in den Input Parametern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von SCHWEREN Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06933||Unbekannter PLD Fehler - Upload aufgrund von unbekannten Fehlern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von unbekannten Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01000||Fehler in Rückmeldung - kein Statuscode gefunden!||Es wurde ein Fehler in der Rückmeldung vom UPS-Server festgestellt. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01100||Fehler beim Parsen der Rückmeldung||Es ist ein Fehler beim Parsen der Rückmeldung vom UPS-Server aufgetreten. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54W01200||Fehler beim Speichern der Reportdatei(en)||Es ist ein Fehler beim Speichern der Reports vom UPS-Server aufgetreten. Bitte prüfen Sie den konfigurierten Speicher-Pfad in der entsprechenden PLD-Modulkonfiguration des HVS32CommuniationManagers, sowie ggf. die Benutzerrechte dieses Verzeichnisses.<br />
|-<br />
|COM54C02000||HTTPS Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C03000||Fehler beim Lesen der EDI Datei||Es ist ein Fehler beim Lesen der FF-Datei im PLD Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C04000||Fehler beim Übertragen der Daten an den UPS Server||Es ist ein Fehler beim Übertragen der Daten an den UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C02000||HTTP(S) Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C04000||Fehler beim Übertragen der Daten an den HTTP(S) Server||Es ist ein Fehler beim Übertragen der Daten an den HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C05000||Fehler beim Herunterladen der Datei vom HTTP(S) Server||Es ist ein Fehler beim Herunterladen der Datei vom HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM55C99999||Aufruf einer nicht unterstützten Funktion im HTTP-Modul||Die Aufgerufene Funktion wird von diesem HTTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager(en)&diff=6099
HVS32 Communication Manager(en)
2025-03-19T08:05:56Z
<p>Bhauser: </p>
<hr />
<div>[[de:HVS32_Communication_Manager]]<br />
The Communication Manager (hereafter abbreviated as ComManager) is a service that centrally manages communication between HVS32 and customers or HVS32 and carriers. The ComManager is designed for communications via FTP, SFTP, or SMTP protocols.<br />
<br />
Similar to WinSCP, this service is controlled by HVS32 and sends data to the destination server configured in the module.<br />
<br />
It is intended to gradually take over communications from HVS32 and replace other external transmission programs such as WinSCP.<br />
<br />
=ComManager Configuration=<br />
The ComManager Configurator can be accessed either directly through the ''ComManager-Configurator.exe'' in the installation directory ''...Heidler\HVS32\ComManager\'' or from the [[Setting up Communication Manager in HVS32|HVS32 Configurator]].<br />
<br />
[[Datei:ComManager-Main Window EN.png|500px|thumb|ohne|ComManager main window]]<br />
<br />
;1 - Link to this wiki entry<br />
;2 - Selection Tabs<br />
:'''[[HVS32_Communication_Manager(en)#Modules|Modules]]''' - Modules for file transmission during daily closing, Wawi return, and route downloads<br />
:'''[[HVS32_Communication_Manager(en)#Servers|Servers]]''' - Internal communication servers such as Microsoft Exchange (SMTP) connections<br />
:'''[[HVS32_Communication_Manager(en)#Proxies|Proxy]]''' - Internal proxy servers<br />
;3 - Overview of configured modules<br />
;4 - Summary of the configuration of the selected module<br />
;5 - [[HVS32_Communication_Manager(en)#Configure_ErrorHandler|Errorhandler Configuration]]<br />
;6 - [[HVS32_Communication_Manager(en)#Service_Settings|Service Settings]]<br />
<br />
==Service Settings==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|In this section, the basic settings of the ComManager service are configured, which are necessary to establish a connection to the service. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
<span style="color:#C00000">'''Warning: The configurations you make here will be applied only after restarting the ComManager service!'''</span><br />
<br />
;HVS32 Main Directory: <br />
:Specify the path to HVS32 here<br />
;HVS32 Database File:<br />
:Specify the path to the HVS32 database file<br />
;HVS32 Database Server:<br />
:IP address or hostname of the PC where the database is located<br />
;HVS32 Database Port:<br />
:The port for the HVS32 database usually does not need adjustment. The default port is set to 3050.<br />
;REST Port<br />
:Communication port through which the ComManager service is accessible via REST. This port must be opened in the server's firewall for external communication with the clients.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Configuration Window of Service Settings]]<br />
|}<br />
<br />
==Configure ErrorHandler==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|If an ErrorHandler is configured, you will be notified by email in case of a failed transmission. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
;Mode<br />
:First of all, you have to choose wich mode you want to use to send error mails<br />
<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
To send the error mails via SMTP choose the mode "SMTP" and enter the following parameters:<br />
;SMTP Server<br />
:IP address or hostname where the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and enable authentication.<br />
;SMTP Port<br />
:Port at which the SMTP server is accessible (25, 465, 587)<br />
;SSL enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS enabled<br />
:Data sent will be encrypted via Transport Layer Security, provided the SMTP server supports it.<br />
;TLS required<br />
:The server is requested to provide TLS support.<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
To send the error mails via Microsoft Office365 choose the mode "O365" and enter the following parameters:<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure (siehe Azure Konfiguration)<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:Dies This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br />
===General===<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and will be displayed as the sender address for emails sent through this module.<br />
;Subject<br />
:This text will be used as the subject when sending the emails.<br />
<br />
;Test<br />
:You can use this option to send a test message to verify the configured parameters.<br />
<br />
<br />
<br />
|}<br />
<br />
==Modules==<br />
[[File:ComManager_Modules_EN.png|360px|thumb|right|Modules]]<br />
;1 - Overview of configured modules<br />
:'''Module ID''' - Selection and assignment of the module in HVS32 is done through this ID<br />
:'''Module Type''' - Type/category of module; the abbreviation "U" / "D" in parentheses indicates whether it is a '''D'''ownload (e.g., route download) or '''U'''pload module (FFFile, Wawi return, etc.)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will cause errors in process handling.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, it will cause errors in process handling.<br />
;3 - Summary of the configuration of the selected server<br />
<br />
[[File:ComManager_AddModul.png|340px|thumb|right|Add Module]]<br />
;Add / configure module<br />
Communication between HVS32 and the specified server occurs through modules. Such a server can be either a separate [[HVS32_Communication_Manager(en)#Server|(SMTP) server]] or directly the carrier's or customer's server.<br />
<br />
After selecting the module type (FTP, SFTP, SMTP, PLD/UPS, HTTP), the configuration of the new module takes place. In the following dialog, you can adjust the corresponding parameters.<br />
<br />
;Module Type<br />
:'''Carrier Module''' - Standard choice for uploading FF files during daily closing<br />
:'''Additional Transmission''' - Customer-specific transmission of, for example, Wawi return files to a customer's server<br />
:'''Download''' - Special module type for downloading, e.g., route files<br />
;Module ID<br />
:An automatically generated ID for the selection and assignment of the module in HVS32<br />
;Carrier<br />
:Additional restriction of the module for the use of specific carrier modules in HVS32 (exclusively for FF file transmission)<br />
;Principal<br />
:Additional restriction of the module for the use of specific principals/clients in HVS32 (exclusively for FF file transmission)<br />
;Note<br />
:Optional note for better overview (displayed in the overview and in HVS32)<br />
<br />
===Configure FTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;FTP Server: <br />
:IP address or hostname of the server<br />
;FTP Port: <br />
:Port at which the server is accessible (Default port 21) <br />
;FTP User<br />
:Username for authentication on the FTP server <br />
;FTP Password<br />
:Password for authentication on the FTP server <br />
;FTP Account<br />
:FTP account for authentication on the FTP server<br />
;FTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the FTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "FTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;FTP Transfer Mode<br />
:Specify whether the data should be transferred as binary or text.<br />
;FTP Security <br />
:;FTPS <br />
::FTP over Secure Socket Layer (SSL) implicitly<br />
:;FTPES: <br />
::FTP over Secure Socket Layer (SSL) explicitly. (Here, the server can allow insecure connections as well)<br />
;FTP Connection<br />
:Choose the method for establishing the connection. PASSIVE should be chosen by default.<br />
;Proxy: <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the FTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_FTPModulConf.png|thumb|right|FTP Upload Module Configuration]]<br />
[[File:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SFTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SFTP Server <br />
:IP address or hostname of the server<br />
;SFTP Port<br />
:Port at which the server is accessible (Default port 22)<br />
;SFTP User<br />
:Username for authentication on the SFTP server <br />
;SFTP Password<br />
:Password for authentication on the SFTP server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:If you are using a private key, you can specify the path to the file here.<br />
;Passphrase<br />
:Enter your passphrase here to decrypt the file mentioned above<br />
;SFTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the SFTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "SFTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;Timeout (ms)<br />
:Time in milliseconds that the connection setup and individual communication steps can take at most (standard 30000ms).<br />
:In the configuration dialog itself, a timeout of 5000ms is used regardless of the setting to test the connection more quickly.<br />
;Proxy <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
<br />
'''If you encounter the error "Algorithm negotiation fail" during the connection test, it is usually because the SFTP server uses old security algorithms such as ssh-dss, which are no longer supported. In this case, check the box "Prefer Old Algorithms" or "prefer old algorithms" to enforce support for the old security algorithms.'''<br />
<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the SFTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Module Configuration]]<br />
[[File:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SMTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SMTP Server<br />
:Choose an SMTP server that you have configured in the "Server" tab. You can find a detailed description under '''[[#Configure SMTP Server|Configure SMTP Server]]'''.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and is used as the sender address for emails sent via this module.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Subject<br />
:This text is used as the subject when sending emails.<br />
;Email Content (PLAIN Text)<br />
:Unformatted message text for the outgoing email.<br />
;Email Content (HTML Text)<br />
:HTML-compliant formatted message text for the outgoing email.<br />
<br />
Testing is done for SMTP modules via the '''Test button''' in the configuration dialog of the corresponding '''server'''.<br />
<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_SMTPModulConf.png|thumb|super|SMTP Module Configuration]]<br />
<br />
|}<br />
<br />
===Configure PLD Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;PLD Server <br />
:HTTPS URL of the server<br />
;PLD Path <br />
:Destination path on the HTTPS server<br />
;PLD Port<br />
:Port under which the server is reachable (Default port 443)<br />
;PLD User<br />
:Username for authentication on the HTTPS server<br />
;PLD Password<br />
:Password for authentication on the HTTPS server<br />
;PLD-Report Storage Path<br />
:Here, the path to a subfolder is specified where the feedback/report files from the PLD server will be saved.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_PLDModulConf.png|thumb|super|PLD Module Configuration]]<br />
|}<br />
<br />
===Configure HTTP(S) Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;HTTP(S) URL <br />
:The HTTP or HTTPS URL with function path and, if applicable, a different port of the server.<br />
:Using the "parsable" option allows you to store the URL in the form of a script that can be edited and verified in an editing dialog "...".<br />
;HTTP User<br />
:Username for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;HTTP Password<br />
:Password for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;MIME-Type<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transfer'''.)<br />
:Content-Type of the request accepted by the server (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Directory<br />
:(This option is available only for the module type '''Download'''.)<br />
:Local default directory where downloaded files should be written. Depending on the process, the directory can be overridden by HVS32.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Module Configuration]]<br />
[[File:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Download Module Configuration]]<br />
|}<br />
<br />
==Servers==<br />
[[File:ComManager_Server.png|360px|thumb|right|Servers]]<br />
;1 - Overview of configured communication servers<br />
:'''Server ID''' - Selection and assignment of the server in the modules are done based on this ID<br />
:'''Server Type''' - Server Type/Category (SMTP)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will lead to errors in process processing.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected server<br />
Keep the original file tag please<br />
<br />
===Configure SMTP Server===<br />
----<br />
[[File:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Configuration]]<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent via the server.<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;SMTP Server<br />
:IP address or hostname under which the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and activate authentication. <br />
;SMTP Port<br />
:Port under which the SMTP server is accessible (25, 465, 587)<br />
;SSL Enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS Enabled<br />
:Data sent will be encrypted via Transport Layer Security if the SMTP server supports it. <br />
;TLS Required<br />
:The server requires TLS support.<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
<br />
==Proxies==<br />
[[File:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Overview of configured proxies<br />
:'''Proxy ID''' - Selection and assignment of the proxy is done based on this ID in the modules<br />
:'''Proxy Type''' - Proxy Type/Category (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Server name or IP address of the proxy<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Proxy''' - Option to add a new proxy<br />
:'''Copy Proxy''' - Allows duplicating the selected proxy with a new ID.<br />
:'''Rename Proxy''' - Opens an input dialog to change the ID. Note: If the proxy is in use, this will lead to errors in process processing.<br />
:'''Edit Proxy''' - Opens the proxy configuration dialog.<br />
:'''Remove Proxy''' - Deletes the proxy entry. This change is irreversible; if the proxy is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected proxy<br />
<br />
<br />
===Add/Configure Proxy===<br />
----<br />
[[File:ComManager_ProxyConf.png|300px|thumb|right|Proxy Configuration]]<br />
After entering the unique proxy ID, the configuration of the new proxy is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;PROXY Type<br />
:Determines the type of the deployed proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP address or hostname under which the proxy server is accessible.<br />
;PROXY Port <br />
:Port under which the proxy server is accessible <br />
;PROXY User<br />
:Username for authentication on the proxy server<br />
;PROXY Password<br />
:Password for authentication on the proxy server<br />
<br />
;NOTE<br />
:The FTP proxy type '''USER <User>@<Host>''' is configured directly in the '''FTP module''' and not as a proxy.<br />
:To do this, enter the data in the FTP module as follows: '''FTP Server = <FTP Proxy Host>''' and '''FTP User = <FTP User>@<FTP Server>'''<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
<br />
=Microsoft Azure configuration for Microsoft Office365 (O365) support=<br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Error Code ||Error Description||Troubleshooting<br />
|-<br />
|COM11C00100||Unknown error occurred while processing a Send Message job! Response is NULL!||This is a general error in processing a Send Message job. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unknown error occurred while processing an Upload job! Response is NULL!||This is a general error in processing an Upload job. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Error occurred while deleting temporary file(s) during processing of a Send Message job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM11W00210||Error occurred while deleting temporary file(s) during processing of an Upload job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00020||Error converting response to XML - Response is NULL||This is a general error in processing a request. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Error parsing XML data in REST function uploadFile||The data received from HVS32 for upload is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00110||Error creating module configuration for REST function uploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Error converting response to XML for REST function uploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00130||Error reading file(s) in REST function uploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory and if sufficient permissions for reading files are set for the Windows user SYSTEM (or the Windows user specified in Heidler-ComManager). Try repeating the operation.<br />
|-<br />
|COM21C00131||Error writing temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00200||Error parsing XML data in REST function downloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00210||Error creating module configuration for REST function downloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Error converting response to XML for REST function downloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00300||Error parsing XML data in REST function sendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00320||Error converting response to XML for REST function sendMessage||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Error reading file(s) in REST function sendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00331||Error writing temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00400||Error parsing XML data in REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00410||Error creating module configuration for REST function queueUploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Error converting response to XML for REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00430||Error reading file(s) in REST function queueUploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00431||Error writing temporary file(s) in REST function queueUploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00500||Error parsing XML data in REST function queueDownloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00510||Error creating module configuration for REST function queueDownloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Error converting response to XML for REST function queueDownloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00600||Error parsing XML data in REST function queueSendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00620||Error converting response to XML for REST function queueSendMessage||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00630||Error reading file(s) in REST function queueSendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00631||Error writing temporary file(s) in REST function queueSendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00700||Error loading main configuration in REST function getModuleList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Error reading main configuration in REST function getModuleList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Error converting response to XML for REST function getModuleList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00800||Error loading main configuration in REST function getServerList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Error reading main configuration in REST function getServerList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Error converting response to XML for REST function getServerList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00132||Error deleting temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00332||Error deleting temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00100||Error initializing HVS32 Database Manager||There was an error initializing the Database Manager. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00200||Error initializing write connections to HVS32 database||There was an error initializing the write connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00210||Error initializing prepared statements for updating FF file in HVS32 database||There was an error initializing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00220||Error updating FF file||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00225||Error updating FF file - no results found||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00230||Error initializing prepared statements for updating WaWi file in HVS32 database||There was an error initializing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00240||Error updating WaWi file||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00245||Error updating WaWi file - no results found||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00300||Error initializing read connections to HVS32 database||There was an error initializing the read connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00310||Error initializing prepared statements for reading FF file in HVS32 database||There was an error initializing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00320||Error reading FF file from HVS32 database||There was an error executing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00325||FF file not found in HVS32 database||The FF file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The FF file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00330||Error initializing prepared statements for reading WaWi file in HVS32 database||There was an error initializing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00340||Error reading WaWi file from HVS32 database||There was an error executing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00345||WaWi file not found in HVS32 database||The WaWi file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The WaWi file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM50C01100||Error instantiating the upload module||The module for the selected module ID for upload cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Failed to instantiate the upload module||The module for the selected module ID for upload could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Error initializing the upload module||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Error instantiating the download module||The module for the selected module ID for download cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Failed to instantiate the download module||The module for the selected module ID for download could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Error initializing the download module||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Error instantiating the SendMessage module||The server module for the selected server module ID for SendMessage cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Failed to instantiate the SendMessage module||The server module for the selected server module ID for SendMessage could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Error initializing the SendMessage module||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Error connecting to FTP server||There was an error connecting to the FTP server. Please check the configured FTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Error logging into FTP server||There was an error logging into the FTP server. Please check the configured login credentials (username/password) in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Error changing directory on FTP server||There was an error changing the directory on the FTP server. Please check the configured FTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Error uploading file to FTP server||There was an error uploading the FF file to the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00500||Error downloading file from FTP server||There was an error downloading the file from the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00410||Error renaming file on FTP server||There was an error renaming the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C00411||Error moving file on FTP server||There was an error moving the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C99999||Invocation of an unsupported function in FTP module||The invoked function is not supported by this FTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM52C00100||Error starting session on SFTP server||There was an error starting the session to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Error starting session on jump host for SFTP transmission||There was an error starting the session to the jump host. Please check the configured jump host settings in the SFTP server module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Error opening channel to SFTP server||There was an error opening the channel to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Error connecting to SFTP server||There was an error connecting to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Error changing directory on SFTP server||There was an error changing the directory on the SFTP server. Please check the configured SFTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Error uploading file to SFTP server||There was an error uploading the FF file to the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00510||Error uploading file to SFTP server - Access denied!||There was an error uploading the FF file to the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C00520||Error renaming file on SFTP server||There was an error renaming the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00521||Error moving file on SFTP server||There was an error moving the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00600||Error downloading file from SFTP server||There was an error downloading the file from the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00610||Error downloading file from SFTP server - Access denied!||There was an error downloading the file from the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C99999||Invocation of an unsupported function in SFTP module||The invoked function is not supported by this SFTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM53C00100||SMTP configuration not found||There was an error in the configuration of the SMTP module. Please check the selected SMTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00101||Illegal parameters in SMTP configuration - recipient address is empty!||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00102||Illegal parameters in SMTP configuration - subject is empty!||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00103||Illegal parameters in SMTP configuration - mail text is empty!||There was an error in the configuration of the SMTP module. Please check the configured mail text in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00105||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00110||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00111||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00112||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00120||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00130||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00131||Error setting recipient address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00132||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00133||Error setting BCC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured BCC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00134||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00135||Error setting subject in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00200||No SMTP data found from HVS32||No SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00201||Invalid SMTP data from HVS32||Invalid SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00202||Illegal parameters in SMTP data from HVS32 - recipient address is empty!||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53C00203||Illegal parameters in SMTP data from HVS32 - subject is empty!||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00204||Illegal parameters in SMTP data from HVS32 - mail text is empty!||There was an error in the configuration of HVS32. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00205||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00210||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in HVS32 Configurator.<br />
|-<br />
|COM53C00211||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00212||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00220||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00230||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00231||Error setting recipient address in SMTP module||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53W00232||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in HVS32 Configurator.<br />
|-<br />
|COM53W00233||Error setting BCC address in SMTP module||There was an error in the configuration of HVS32. Please check the configured BCC address in HVS32 Configurator.<br />
|-<br />
|COM53W00234||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in HVS32 Configurator.<br />
|-<br />
|COM53W00235||Error setting subject in SMTP module||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00300||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00400||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C99999||Invocation of an unsupported function in SMTP module||The invoked function is not supported by this SMTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54C99999||Invocation of an unsupported function in PLD module||The invoked function is not supported by this PLD module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54W03005||3005 PLD Warning - File already transmitted!||The carrier file has already been transmitted and therefore could not be accepted by the UPS server. Please do not transmit this file again.<br />
|-<br />
|COM54W06930||6930 PLD Warning - Data uploaded with warnings. Please correct before the next upload!||The carrier file has been successfully transmitted to the UPS server and processed. The file does not need to be transmitted again. However, there are content errors in the FF file that need to be fixed before the next day's closure. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06931||6931 PLD Error - Upload failed due to errors in the PLD data.||The carrier file has been transmitted to the UPS server but was NOT processed due to errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06932||6932 Severe PLD Error - Upload failed due to errors in the input parameters.||The carrier file has been transmitted to the UPS server but was NOT processed due to SERIOUS errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06933||Unknown PLD Error - Upload failed due to unknown errors.||The carrier file has been transmitted to the UPS server but was NOT processed due to unknown errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C01000||Error in feedback - no status code found!||An error was detected in the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54C01100||Error parsing the feedback||There was an error parsing the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54W01200||Error saving the report file(s)||There was an error saving the reports from the UPS server. Please check the configured storage path in the corresponding PLD module configuration of HVS32CommunicationManager, as well as the user rights of this directory.<br />
|-<br />
|COM54C02000||HTTPS connection not ready!||There was an error connecting to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C03000||Error reading the EDI file||There was an error reading the FF file in the PLD module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C04000||Error transmitting data to the UPS server||There was an error transmitting data to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C02000||HTTP(S) connection not ready!||There was an error connecting to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C04000||Error transmitting data to the HTTP(S) server||There was an error transmitting data to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C05000||Error downloading file from the HTTP(S) server||There was an error downloading the file from the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C99999||Invocation of an unsupported function in HTTP module||The invoked function is not supported by this HTTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager&diff=6098
HVS32 Communication Manager
2025-03-19T08:04:46Z
<p>Bhauser: </p>
<hr />
<div>[[en:HVS32_Communication_Manager(en)]]<br />
Der Communication Manager (fortan ComManager abgekürzt) ist ein Dienst der die Kommunikation zwischen HVS32 und Kunde oder <br><br />
HVS32 und Frachtführer zentral Verwaltet und übernimmt. Gedacht ist der ComManager für Kommunikationen via FTP, SFTP oder SMTP.<br />
<br />
Genau wie bei WinSCP wird dieser Dienst vom HVS32 angesteuert und versendet die Daten an den im Modul konfigurierten Zielserver.<br />
<br />
Er soll nach und nach die Kommunikationen des HVS32 übernehmen und andere externe Übermittlungsprogramme wie zum Beispiel WinSCP ablösen.<br />
<br />
=ComManager Konfiguration=<br />
Der ComManager-Konfigurator wird entweder direkt über die ''ComManager-Configurator.exe'' im Installationsverzeichnis ''...Heidler\HVS32\ComManager\'' oder aus dem [[HVS32_Communication_Manager_in_HVS32_einrichten|HVS32 Konfigurator]] gestartet. <br />
<br />
[[Datei:Commanager-startmaske.png|500px|thumb|ohne|Commanager-startmaske]]<br />
<br />
;1 - Link zu diesem Wiki Eintrag<br />
;2 - Auswahl Tabs<br />
:'''[[HVS32_Communication_Manager#Module|Module]]''' - Module zur Übertragung von Dateien beim Tagesabschluss, Wawi-Rück und Routendownloads<br />
:'''[[HVS32_Communication_Manager#Server|Server]]''' - Interne Kommunikationsserver wie z.B. Microsoft Exchange (SMTP) Verbindungen<br />
:'''[[HVS32_Communication_Manager#Proxys|Proxy]]''' - Interne Proxyserver<br />
;3 - Übersicht der eingerichteten Module<br />
;4 - Zusammenfassung der Konfiguration vom ausgewählten Modul<br />
;5 - [[HVS32_Communication_Manager#ErrorHandler_konfigurieren|Errorhandler Konfiguration]]<br />
;6 - [[HVS32_Communication_Manager#Dienst_Einstellungen|Dienst Einstellungen]]<br />
<br />
==Dienst Einstellungen==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Hier werden die grundlegenden Einstellungen des ComManager Dienstes vorgenommen, die erforderlich sind um eine Verbindung zum Dienst aufzubauen. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
<span style="color:#C00000">'''Warnung: Die Konfigurationen, die Sie hier vornehmen werden erst nach einem Neustart des ComManager Dienstes übernommen!'''</span><br />
<br />
;HVS32 Hauptverzeichnis: <br />
:Hier den Pfad zum HVS32 angeben<br />
;HVS32 Datenbank-Datei:<br />
:Pfad zur HVS32 Datenbank angeben. <br />
;HVS32 Datenbank Server:<br />
:IP Adresse oder Hostnamen des PCs auf dem die Datenbank liegt.<br />
;HVS32 Datenbanken Port:<br />
:Der Port zu der HVS32 Datenbank muss nur in den seltensten Fällen angepasst werden. Im Standard ist der Port auf 3050 gestellt.<br />
;REST Port<br />
:Kommunikations-Port unter welchem der ComManager-Dienst via REST erreichbar ist. Dieser muss zur externen Kommunikation mit den Clients auf dem Server in der Firewall freigegeben werden.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Konfigurationsfenster der Diensteinstellungen]]<br />
|}<br />
<br />
==ErrorHandler konfigurieren==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|Ist ein ErrorHandler konfiguriert, werden Sie im Falle einer erfolglosen Übertragung per Mail benachrichtig. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
;Mode<br />
:Wählen Sie zunächst den Modus über welchen Sie die Error-Mails versenden möchten<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
Für den Versand der E-Mails über einen SMTP, wählen Sie "SMTP" und konfigurieren Sie die folgenden Parameter:<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren.<br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt.<br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
Für den Versand der E-Mails via Microsoft Office365, wählen Sie "O365" und konfigurieren Sie die folgenden Parameter:<br />
;Graph URL<br />
:Dies ist die offizielle URL für die Microsoft Graph API. Diese ist im Standard bereits vorbelegt<br />
;Client-ID<br />
:Applikation (Client) ID der registrierten Applikation (siehe Azure Konfiguration)<br />
;Client-Secret<br />
:in Azure hinterlegtes Secret der Applikation (nicht die ID des Secrets)<br />
;Tenant-ID<br />
:Tenant-ID der in Azure registrierten Applikation<br />
;Scope<br />
:Dies ist der Standard-Scope welcher für das Versenden von Mails via Microsoft Graph benötigt wird. Dieser Parameter ist vorbelegt.<br />
<br />
===Allgemein===<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
<br />
;Testen<br />
:Sie können mit dieser Option eine Testnachricht zur Prüfung der eingestellten Parameter verschicken.<br />
<br />
<br />
<br />
|}<br />
<br />
==Module==<br />
[[Datei:ComManager_Modul.png|360px|thumb|right|Module]]<br />
;1 - Übersicht der eingerichteten Module<br />
:'''Modul ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Moduls in HVS32<br />
:'''Modul Typ''' - Modul Typ/Art; das in der Klammer dargestellte Kürzel "U" / "D" gibt Auskunft darüber ob es ein '''D'''ownload (z.B. Routendownload) oder '''U'''pload Modul (FFDatei, WaWi-Rück., etc.) ist<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
[[Datei:ComManager_AddModul.png|340px|thumb|right|Modul hinzufügen]]<br />
;Modul hinzufügen / konfigurieren<br />
Über die Module findet die Kommunikation zwischen HVS32 und dem angegebenen Server statt. Ein solcher Server kann entweder ein eigener [[HVS32_Communication_Manager#Server|(SMTP) Server]] oder direkt der Server vom Frachtführer oder Kunden sein.<br />
<br />
Nach der Auswahl des Modul-Typs (FTP, SFTP, SMTP, PLD/UPS, HTTP) erfolgt die vor Konfiguration vom neuen Modul. In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen.<br />
<br />
;Modul Art<br />
:'''Frachtführer-Modul''' - Standard Auswahl für den Upload von FF-Dateien beim Tagesabschluss<br />
:'''Zusatzübertragung''' - Kundenindividuelle Übertragung von z.B. WaWi-Rück-Dateien an einen Kundeneigenen Server<br />
:'''Download''' - Spezielle Modul Art für den Download von z.B. Routendateien<br />
;ModulID<br />
:Eine automatisch generierte ID für die Auswahl und Zuweisung des Moduls im HVS32<br />
;Frachtführer<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Frachtführer-Modulen im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Auftraggeber<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Auftraggebern/Mandanten im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Notiz<br />
:Optionale Notiz, zur besseren Übersicht (wird in der Übersicht und im HVS32 dargestellt)<br />
<br />
<br />
===FTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;FTP Server: <br />
:IP Adresse des Servers oder Servername<br />
;FTP Port: <br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 21) <br />
;FTP Benutzer<br />
:Benutzername zur Authentifizierung am FTP-Server <br />
;FTP Password<br />
:Password zur Authentifizierung am FTP-Server <br />
;FTP Account<br />
:FTP-Account zur Authentifizierung am FTP-Server<br />
;FTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem FTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "FTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt.<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;FTP Transfer-Modus<br />
:Geben Sie an ob die Daten binär oder als Text übertragen werden sollen.<br />
;FTP Sicherheit <br />
:;FTPS <br />
::FTP über Secure Socket Layer (SSL) implizit<br />
:;FTPES: <br />
::FTP über Secure Socket Layer (SSL) explizit. (Hier kann der Server auch unsichere Verbindungen zulassen)<br />
;FTP Verbindung<br />
:Hier können Sie die Methode zum Verbindungsaufbau wählen. Es sollte standardmäßig PASSIVE gewählt werden.<br />
;Proxy: <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_FTPModulConf.png|thumb|right|FTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SFTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SFTP Server <br />
:IP Adresse des Servers oder Servername<br />
;SFTP Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 22)<br />
;SFTP Benutzer<br />
:Benutzername zur Authentifizierung am SFTP-Server <br />
;SFTP Password<br />
:Password zur Authentifizierung am SFTP-Server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:Falls Sie einen private Key verwenden, können Sie hier den Pfad zur Datei angeben.<br />
;Passphrase<br />
:Hier geben Sie bitte Ihre Passphrase an um die oben genannte Datei zu entschlüsseln<br />
;SFTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem SFTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "SFTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt..<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Timeout (ms)<br />
:Zeit in Millisekunden, die der Verbindungsaufbau und einzelne Kommunikationsschritte maximal in Anspruch nehmen können (im Standard 30000ms).<br />
:Im Konfigurationsdialog selbst wird unabhängig von der Einstellung ein Timeout von 5000ms verwendet, um die Verbindung schneller Testen zu können.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
<br />
'''Sollte beim Verbindungstest der Fehler "Algorithm negotiation fail" auftreten, liegt es i.d.R. daran, dass der SFTP Server alte Sicherheits Algorithmen wie z.B. ssh-dss nutzt, welche nicht mehr unterstützt werden. In diesem Fall setzen Sie den Haken "Alte Algorithmen bevorzugen" bzw. "prefer old algorithms" um eine Unterstützung der alten Sicherheits Algorithmen zu erzwingen.'''<br />
<br />
<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SMTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SMTP Server<br />
:Hier können Sie einen SMPT Server wählen, den Sie zuvor im Reiter „Server“ konfiguriert haben. Eine genaue Beschreibung finden Sie unter '''[[#SMTP Server konfigurieren|SMTP Server konfigurieren]]'''.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
;Mail Inhalt (PLAIN Text)<br />
:Unformatierter Nachrichtentext für die zu versendenden E-Mail.<br />
;Mail Inhalt (HTML Text)<br />
:HTML konform formatierter Nachrichtentext für die zu versendenden E-Mail.<br />
<br />
Der Test erfolgt bei SMTP Modulen über '''Testbutton''' im Konfigurationsdialog des entsprechenden '''Servers'''.<br />
<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
|[[Datei:ComManager_SMTPModulConf.png|thumb|super|SMTP Modul Konfiguration]]<br />
<br />
|}<br />
<br />
===PLD Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;PLD Server <br />
:HTTPS URL des Servers<br />
;PLD Pfad <br />
:Zielpfad vom HTTPS-Server<br />
;PLD Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 443)<br />
;PLD Benutzer<br />
:Benutzername zur Authentifizierung am HTTPS-Server<br />
;PLD Password<br />
:Password zur Authentifizierung am HTTPS-Server<br />
;PLD-Report Speicherpfad<br />
:Hier wird der Pfad zu einem Unterordner angegeben, in welchen die Rückmelde-/Reportdateien vom PLD-Server gespeichert werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_PLDModulConf.png|thumb|super|PLD Modul Konfiguration]]<br />
|}<br />
<br />
===HTTP(S) Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;HTTP(S) URL <br />
:Die HTTP oder HTTPS URL mit Funktionspfad und ggf. abweichendem Port des Servers<br />
:Über die Auswahl "parsbar" lässt sich die URL in Form eines Scripts hinterlegen, den man in einem Bearbeitungsdialog "..." editieren und prüfen kann.<br />
;HTTP Benutzer<br />
:Benutzername zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;HTTP Password<br />
:Password zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;MIME-Type<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Content-Type vom Request, welcher vom Server akzeptiert wird (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Downlaod Modul Konfiguration]]<br />
|}<br />
<br />
==Server==<br />
[[Datei:ComManager_Server.png|360px|thumb|right|Server]]<br />
;1 - Übersicht der eingerichteten Kommunikationsservern<br />
:'''Server ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Servers in den Modulen<br />
:'''Server Typ''' - Server Typ/Art (SMTP)<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
===SMTP Server konfigurieren===<br />
----<br />
[[Datei:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Konfiguration]]<br />
Nach der Eingabe der eindeutigen Server-ID erfolgt die Konfiguration vom neuen Kommunikationsserver.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren. <br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt. <br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert <br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
<br />
==Proxys==<br />
[[Datei:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Übersicht der eingerichteten Proxys<br />
:'''Proxy ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Proxys in den Modulen<br />
:'''Proxy Typ''' - Proxy Typ/Art (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Servername oder IP-Adresse vom Proxy<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Proxy hinzufügen''' - Option zum hinzufügen eines neuen Proxys<br />
:'''Proxy kopieren''' - Ermöglicht es den ausgewählten Proxy als Duplikat mit einer neuen ID anzulegen.<br />
:'''Proxy umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Proxy bearbeiten''' - Öffnet den Proxy-Konfigurationsdialog.<br />
:'''Proxy entfernen''' - Löscht den Proxy Eintrag. Diese Änderung ist unwiderruflich, sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Proxy<br />
<br />
<br />
===Proxy hinzufügen / konfigurieren===<br />
----<br />
[[Datei:ComManager_ProxyConf.png|300px|thumb|right|Proxy Konfiguration]]<br />
Nach der Eingabe der eindeutigen Proxy-ID erfolgt die Konfiguration vom neuen Proxy.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
;PROXY Typ<br />
:Bestimmt die Art vom eingesetzten Proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP Adresse oder Hostname unter dem der Proxy Server erreichbar ist.<br />
;PROXY Port <br />
:Port unter dem der Proxy Server erreichbar ist <br />
;PROXY Benutzer<br />
:Benutzername zur Authentifizierung am Proxy Server<br />
;PROXY Passwort<br />
:Passwort zur Authentifizierung am Proxy Server<br />
<br />
;HINWEIS<br />
:Der FTP Proxy-Typ '''USER <Benutzer>@<Host>''' wird direkt im '''FTP-Modul''' konfiguriert und nicht als Proxy.<br />
:Tragen Sie dazu die Daten im FTP-Modul wie folgt ein: '''FTP Server = <FTP-Proxy-Host>''' und '''FTP Benutzer = <FTP-Benutzer>@<FTP-Server>'''<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
=Microsoft Azure Konfiguration für Microsoft Office365 (O365)=<br />
<br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Fehlercode ||Fehlerbeschreibung||Fehlerbehebung<br />
|-<br />
|COM11C00100||Unbekannter Fehler bei der Verarbeitung eines Send Message Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Send Message Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unbekannter Fehler bei der Verarbeitung eines Upload Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Upload Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Send Message Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM11W00210||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Upload Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00020||Fehler beim Konvertieren der Antwort in XML - Response ist NULL||Dies ist ein allgemeiner Fehler bei der Verarbeitung eienr Anfrage. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Fehler beim Parsen der XML Daten in REST Funktion uploadFile||Die Übergabe-Daten aus dem HVS32 für den Upload sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00110||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion uploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Fehler beim Konvertieren der Antwort in XML für REST Funktion uploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00130||Fehler beim Einlesen der Datei(en) in REST Funktion uploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob in dem entsprechenden Verzeichnis die zu übertragende Datei existiert und ausreichende Berechtigungen zum Lesen von Dateien für den Windows-Benutzer SYSTEM (oder der im Heidler-ComManager hinterlegten Windows-Benutzer) gesetzt sind. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00131||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00200||Fehler beim Parsen der XML Daten in REST Funktion downloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00210||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion downloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Fehler beim Konvertieren der Antwort in XML für REST Funktion downloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00300||Fehler beim Parsen der XML Daten in REST Funktion sendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00320||Fehler beim Konvertieren der Antwort in XML für REST Funktion sendMessage||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Fehler beim Einlesen der Datei(en) in REST Funktion sendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00331||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00400||Fehler beim Parsen der XML Daten in REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00410||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueUploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00430||Fehler beim Einlesen der Datei(en) in REST Funktion queueUploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00431||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueUploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00500||Fehler beim Parsen der XML Daten in REST Funktion queueDownloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00510||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueDownloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueDownloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00600||Fehler beim Parsen der XML Daten in REST Funktion queueSendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00620||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueSendMessage||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00630||Fehler beim Einlesen der Datei(en) in REST Funktion queueSendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00631||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueSendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00700||Fehler beim Laden der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Fehler beim Lesen der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Fehler beim Konvertieren der Antwort in XML für REST Funktion getModuleList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00800||Fehler beim Laden der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Fehler beim Lesen der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Fehler beim Konvertieren der Antwort in XML für REST Funktion getServerList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00132||Fehler beim Löschen der temporären Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00332||Fehler beim Löschen der temporären Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00100||Fehler bei Initialisierung des HVS32 Datenbank Managers||Es ist ein Fehler beim Initialisieren des DatenbankManagers aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00200||Fehler bei Initialisierung der Schreib-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Schreib-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00210||Fehler bei Initialisierung des Prepared Statements zum Updaten der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00220||Fehler beim Updaten der FF Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00225||Fehler bei Update von FF-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00230||Fehler bei Initialisierung des Prepared Statements zum Updaten der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00240||Fehler beim Updaten der WaWi-Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00245||Fehler bei Update von WaWi-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00300||Fehler bei Initialisierung der Lese-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Lese-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00310||Fehler bei Initialisierung des Prepared Statements zum Lesen der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00320||Fehler beim Lesen der FF-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00325||FF Datei in HVS32 Datenbank nicht gefunden||Die vom HVS32 übermittelte FF-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die FF-Datei wurde bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00330||Fehler bei Initialisierung des Prepared Statements zum Lesen der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00340||Fehler beim Lesen der WaWi-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00345||WaWi-Datei nicht in HVS32 Datenbank gefunden||Die vom HVS32 übermittelte WaWi-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM50C01100||Fehler beim Instanziieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Instanziieren des Upload-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Fehler beim Initialisieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Fehler beim Instanziieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Instanziieren des Download-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Fehler beim Initialisieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Fehler beim Instanziieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Instanziieren des SendMessage-Moduls fehlgeschlagen||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Fehler beim Initialisieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Fehler bei der Verbindung zum FTP Server||Es ist ein Fehler bei der Verbindung zum FTP-Server aufgetreten. Prüfen Sie den hinterlegten FTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Fehler beim Login auf FTP Server ||Es ist ein Fehler beim Login zum FTP-Server aufgetreten. Prüfen Sie die hinterlegten Login-Daten (Benutzername/Passwort) in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Fehler beim Wechseln des Verzeichnisses auf dem FTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem FTP-Server aufgetreten. Prüfen Sie das hinterlegte FTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Fehler beim Hochladen der Datei auf FTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00500||Fehler beim Herunterladen der Datei vom FTP Server||Es ist ein Fehler beim Herunterladen der Datei vom FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00410||Fehler beim Umbenennen der Datei auf FTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C00411||Fehler beim Verschieben der Datei auf FTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C99999||Aufruf einer nicht unterstützten Funktion im FTP Modul||Die Aufgerufene Funktion wird von diesem FTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM52C00100||Fehler beim Starten der Session auf dem STFP Server||Es ist ein Fehler beim Starten der Session zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Fehler beim Starten der Session auf dem Jump Host für die SFTP Übertragung||Es ist ein Fehler beim Starten der Session zum Jump Host aufgetreten. Prüfen Sie den hinterlegten Jump Host Einstellungen in der SFTP-Server Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Fehler beim Öffnen des Kanals zum SFTP Server||Es ist ein Fehler beim Öffnen des Kanals zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Fehler bei der Verbindung zum SFTP Server||Es ist ein Fehler bei der Verbindung zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Fehler beim Wechseln des Verzeichnisses auf dem SFTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem SFTP-Server aufgetreten. Prüfen Sie das hinterlegte SFTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Fehler beim Hochladen der Datei auf SFTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00510||Fehler beim Hochladen der Datei auf SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen. <br />
|-<br />
|COM52C00520||Fehler beim Umbenennen der Datei auf SFTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00521||Fehler beim Verschieben der Datei auf SFTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00600||Fehler beim Herunterladen der Datei vom SFTP Server||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00610||Fehler beim Herunterladen der Datei vom SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen.<br />
|-<br />
|COM52C99999||Aufruf einer nicht unterstützten Funktion im SFTP Modul||Die Aufgerufene Funktion wird von diesem SFTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM53C00100||SMTP Konfiguration nicht gefunden||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den ausgewählten SMTP-Server in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00101||Illegale Parameter in SMTP Konfiguration - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00102||Illegale Parameter in SMTP Konfiguration - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00103||Illegale Parameter in SMTP Konfiguration - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Mail-Text in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00105||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00110||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00111||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00112||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00120||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00130||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00131||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00132||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte CC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00133||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte BCC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00134||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00135||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00200||Keine SMTP Daten von HVS32 gefunden||Es wurden keine SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00201||SMTP Daten von HVS32 sind ungültig||Es wurden fehlerhafte SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00202||Illegale Parameter in SMTP Daten vom HVS32 - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator.<br />
|-<br />
|COM53C00203||Illegale Parameter in SMTP Daten vom HVS32 - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator.<br />
|-<br />
|COM53C00204||Illegale Parameter in SMTP Daten vom HVS32 - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00205||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00210||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00211||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00212||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00220||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00230||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00231||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00232||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte CC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00233||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte BCC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00234||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00235||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator<br />
|-<br />
|COM53C00300||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00400||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C99999||Aufruf einer nicht unterstützten Funktion im SMTP Modul||Die Aufgerufene Funktion wird von diesem SMTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54C99999||Aufruf einer nicht unterstützten Funktion im PLD Modul||Die Aufgerufene Funktion wird von diesem PLD-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54W03005||3005 PLD Warnung - Datei bereits übertragen!||Die Frachtführer-Datei wurde bereits übertragen und konnte somit vom UPS-Server nicht akzeptiert werden. Bitte übertragen Sie diese Datei nicht erneut.<br />
|-<br />
|COM54W06930||6930 PLD Warnung - Daten wurden mit Warnungen hochgeladen. Bitte korrigieren Sie diese vor dem nächsten Upload!||Die Frachtführer-Datei wurde erfolgreich an den UPS-Server übermittelt und von diesem verarbeitet. Die Datei muss nicht erneut übermittelt werden. Allerdings gibt es inhaltliche Fehler in der FF-Datei, welche vor dem nächsten Tagesabschluss behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06931||6931 PLD Fehler - Upload aufgrund von Fehlern in den PLD Daten fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06932||6932 Schwerer PLD Fehler - Upload aufgrund von Fehlern in den Input Parametern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von SCHWEREN Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06933||Unbekannter PLD Fehler - Upload aufgrund von unbekannten Fehlern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von unbekannten Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01000||Fehler in Rückmeldung - kein Statuscode gefunden!||Es wurde ein Fehler in der Rückmeldung vom UPS-Server festgestellt. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01100||Fehler beim Parsen der Rückmeldung||Es ist ein Fehler beim Parsen der Rückmeldung vom UPS-Server aufgetreten. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54W01200||Fehler beim Speichern der Reportdatei(en)||Es ist ein Fehler beim Speichern der Reports vom UPS-Server aufgetreten. Bitte prüfen Sie den konfigurierten Speicher-Pfad in der entsprechenden PLD-Modulkonfiguration des HVS32CommuniationManagers, sowie ggf. die Benutzerrechte dieses Verzeichnisses.<br />
|-<br />
|COM54C02000||HTTPS Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C03000||Fehler beim Lesen der EDI Datei||Es ist ein Fehler beim Lesen der FF-Datei im PLD Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C04000||Fehler beim Übertragen der Daten an den UPS Server||Es ist ein Fehler beim Übertragen der Daten an den UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C02000||HTTP(S) Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C04000||Fehler beim Übertragen der Daten an den HTTP(S) Server||Es ist ein Fehler beim Übertragen der Daten an den HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C05000||Fehler beim Herunterladen der Datei vom HTTP(S) Server||Es ist ein Fehler beim Herunterladen der Datei vom HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM55C99999||Aufruf einer nicht unterstützten Funktion im HTTP-Modul||Die Aufgerufene Funktion wird von diesem HTTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager(en)&diff=6097
HVS32 Communication Manager(en)
2025-03-19T08:02:15Z
<p>Bhauser: /* Configure ErrorHandler */</p>
<hr />
<div>[[de:HVS32_Communication_Manager]]<br />
The Communication Manager (hereafter abbreviated as ComManager) is a service that centrally manages communication between HVS32 and customers or HVS32 and carriers. The ComManager is designed for communications via FTP, SFTP, or SMTP protocols.<br />
<br />
Similar to WinSCP, this service is controlled by HVS32 and sends data to the destination server configured in the module.<br />
<br />
It is intended to gradually take over communications from HVS32 and replace other external transmission programs such as WinSCP.<br />
<br />
=ComManager Configuration=<br />
The ComManager Configurator can be accessed either directly through the ''ComManager-Configurator.exe'' in the installation directory ''...Heidler\HVS32\ComManager\'' or from the [[Setting up Communication Manager in HVS32|HVS32 Configurator]].<br />
<br />
[[Datei:ComManager-Main Window EN.png|500px|thumb|ohne|ComManager main window]]<br />
<br />
;1 - Link to this wiki entry<br />
;2 - Selection Tabs<br />
:'''[[HVS32_Communication_Manager(en)#Modules|Modules]]''' - Modules for file transmission during daily closing, Wawi return, and route downloads<br />
:'''[[HVS32_Communication_Manager(en)#Servers|Servers]]''' - Internal communication servers such as Microsoft Exchange (SMTP) connections<br />
:'''[[HVS32_Communication_Manager(en)#Proxies|Proxy]]''' - Internal proxy servers<br />
;3 - Overview of configured modules<br />
;4 - Summary of the configuration of the selected module<br />
;5 - [[HVS32_Communication_Manager(en)#Configure_ErrorHandler|Errorhandler Configuration]]<br />
;6 - [[HVS32_Communication_Manager(en)#Service_Settings|Service Settings]]<br />
<br />
==Service Settings==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|In this section, the basic settings of the ComManager service are configured, which are necessary to establish a connection to the service. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
<span style="color:#C00000">'''Warning: The configurations you make here will be applied only after restarting the ComManager service!'''</span><br />
<br />
;HVS32 Main Directory: <br />
:Specify the path to HVS32 here<br />
;HVS32 Database File:<br />
:Specify the path to the HVS32 database file<br />
;HVS32 Database Server:<br />
:IP address or hostname of the PC where the database is located<br />
;HVS32 Database Port:<br />
:The port for the HVS32 database usually does not need adjustment. The default port is set to 3050.<br />
;REST Port<br />
:Communication port through which the ComManager service is accessible via REST. This port must be opened in the server's firewall for external communication with the clients.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Configuration Window of Service Settings]]<br />
|}<br />
<br />
==Configure ErrorHandler==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|If an ErrorHandler is configured, you will be notified by email in case of a failed transmission. '''This area is password-protected; the same password as for HVS32 user "vadmin" is required.'''<br />
<br />
;Mode<br />
:First of all, you have to choose wich mode you want to use to send error mails<br />
<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
To send the error mails via SMTP choose the mode "SMTP" and enter the following parameters:<br />
;SMTP Server<br />
:IP address or hostname where the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and enable authentication.<br />
;SMTP Port<br />
:Port at which the SMTP server is accessible (25, 465, 587)<br />
;SSL enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS enabled<br />
:Data sent will be encrypted via Transport Layer Security, provided the SMTP server supports it.<br />
;TLS required<br />
:The server is requested to provide TLS support.<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
To send the error mails via Microsoft Office365 choose the mode "O365" and enter the following parameters:<br />
;Graph URL<br />
:This is the official URL for the Microsoft Graph API. This parameter is set by default.<br />
;Client-ID<br />
:Application (Client) ID of the registered app in Azure (siehe Azure Konfiguration)<br />
;Client-Secret<br />
:the secret of the app created in Azure (not the id of the secret)<br />
;Tenant-ID<br />
:Tenant-ID of the registered app in Azure<br />
;Scope<br />
:Dies This is the default scope which is needed to send mails via Microsoft Graph. This parameter is set by default.<br />
<br />
===General===<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent through the server.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and will be displayed as the sender address for emails sent through this module.<br />
;Subject<br />
:This text will be used as the subject when sending the emails.<br />
<br />
;Test<br />
:You can use this option to send a test message to verify the configured parameters.<br />
<br />
<br />
<br />
|}<br />
<br />
==Modules==<br />
[[File:ComManager_Modules_EN.png|360px|thumb|right|Modules]]<br />
;1 - Overview of configured modules<br />
:'''Module ID''' - Selection and assignment of the module in HVS32 is done through this ID<br />
:'''Module Type''' - Type/category of module; the abbreviation "U" / "D" in parentheses indicates whether it is a '''D'''ownload (e.g., route download) or '''U'''pload module (FFFile, Wawi return, etc.)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will cause errors in process handling.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, it will cause errors in process handling.<br />
;3 - Summary of the configuration of the selected server<br />
<br />
[[File:ComManager_AddModul.png|340px|thumb|right|Add Module]]<br />
;Add / configure module<br />
Communication between HVS32 and the specified server occurs through modules. Such a server can be either a separate [[HVS32_Communication_Manager(en)#Server|(SMTP) server]] or directly the carrier's or customer's server.<br />
<br />
After selecting the module type (FTP, SFTP, SMTP, PLD/UPS, HTTP), the configuration of the new module takes place. In the following dialog, you can adjust the corresponding parameters.<br />
<br />
;Module Type<br />
:'''Carrier Module''' - Standard choice for uploading FF files during daily closing<br />
:'''Additional Transmission''' - Customer-specific transmission of, for example, Wawi return files to a customer's server<br />
:'''Download''' - Special module type for downloading, e.g., route files<br />
;Module ID<br />
:An automatically generated ID for the selection and assignment of the module in HVS32<br />
;Carrier<br />
:Additional restriction of the module for the use of specific carrier modules in HVS32 (exclusively for FF file transmission)<br />
;Principal<br />
:Additional restriction of the module for the use of specific principals/clients in HVS32 (exclusively for FF file transmission)<br />
;Note<br />
:Optional note for better overview (displayed in the overview and in HVS32)<br />
<br />
===Configure FTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;FTP Server: <br />
:IP address or hostname of the server<br />
;FTP Port: <br />
:Port at which the server is accessible (Default port 21) <br />
;FTP User<br />
:Username for authentication on the FTP server <br />
;FTP Password<br />
:Password for authentication on the FTP server <br />
;FTP Account<br />
:FTP account for authentication on the FTP server<br />
;FTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the FTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "FTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;FTP Transfer Mode<br />
:Specify whether the data should be transferred as binary or text.<br />
;FTP Security <br />
:;FTPS <br />
::FTP over Secure Socket Layer (SSL) implicitly<br />
:;FTPES: <br />
::FTP over Secure Socket Layer (SSL) explicitly. (Here, the server can allow insecure connections as well)<br />
;FTP Connection<br />
:Choose the method for establishing the connection. PASSIVE should be chosen by default.<br />
;Proxy: <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the FTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_FTPModulConf.png|thumb|right|FTP Upload Module Configuration]]<br />
[[File:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SFTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SFTP Server <br />
:IP address or hostname of the server<br />
;SFTP Port<br />
:Port at which the server is accessible (Default port 22)<br />
;SFTP User<br />
:Username for authentication on the SFTP server <br />
;SFTP Password<br />
:Password for authentication on the SFTP server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:If you are using a private key, you can specify the path to the file here.<br />
;Passphrase<br />
:Enter your passphrase here to decrypt the file mentioned above<br />
;SFTP Directory <br />
:'''Upload''' - Target path on the SFTP server; if left blank, files will be uploaded to the user-specific root directory.<br />
:'''Download''' - Target path on the SFTP server; if left blank, files will be downloaded from the user-specific root directory.<br />
;Move to (Directory)<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Target path on the SFTP server where the file will be moved after a successful upload. If left blank, the file will be uploaded directly to the "SFTP Directory" without additional movement.<br />
;Name Extension after Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension after a successful upload to the filename.<br />
;Name Extension on Upload<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transmission''')<br />
:Adds an additional file extension/name extension before the upload to the filename. The filename remains after the upload; the file name extension is not removed.<br />
;Download Directory<br />
:(This option is available only for the module type '''Download''')<br />
:Local default directory where the downloaded files should be written. Depending on the process, the directory can be overwritten by HVS32.<br />
;Timeout (ms)<br />
:Time in milliseconds that the connection setup and individual communication steps can take at most (standard 30000ms).<br />
:In the configuration dialog itself, a timeout of 5000ms is used regardless of the setting to test the connection more quickly.<br />
;Proxy <br />
:Choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
<br />
'''If you encounter the error "Algorithm negotiation fail" during the connection test, it is usually because the SFTP server uses old security algorithms such as ssh-dss, which are no longer supported. In this case, check the box "Prefer Old Algorithms" or "prefer old algorithms" to enforce support for the old security algorithms.'''<br />
<br />
During a test, an attempt is made to establish a connection to the server, and access to the specified directory is checked. <br />If no directory is specified, only the connection to the server is tested. <br />
'''WARNING:''' Only the connection setup is tested; if, for example, the SFTP user does not have sufficient permissions to create files, the error occurs only during an actual transfer via HVS32!<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
|[[File:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Module Configuration]]<br />
[[File:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Module Configuration]]<br />
|}<br />
<br />
===Configure SMTP Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;SMTP Server<br />
:Choose an SMTP server that you have configured in the "Server" tab. You can find a detailed description under '''[[#Configure SMTP Server|Configure SMTP Server]]'''.<br />
;Reply Address<br />
:This address overrides the sender address of the SMTP server and is used as the sender address for emails sent via this module.<br />
;To/CC/BCC Address(es)<br />
:Specify the recipients who should receive a notification email. Multiple recipient email addresses can be entered separated by commas.<br />
;Subject<br />
:This text is used as the subject when sending emails.<br />
;Email Content (PLAIN Text)<br />
:Unformatted message text for the outgoing email.<br />
;Email Content (HTML Text)<br />
:HTML-compliant formatted message text for the outgoing email.<br />
<br />
Testing is done for SMTP modules via the '''Test button''' in the configuration dialog of the corresponding '''server'''.<br />
<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_SMTPModulConf.png|thumb|super|SMTP Module Configuration]]<br />
<br />
|}<br />
<br />
===Configure PLD Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;PLD Server <br />
:HTTPS URL of the server<br />
;PLD Path <br />
:Destination path on the HTTPS server<br />
;PLD Port<br />
:Port under which the server is reachable (Default port 443)<br />
;PLD User<br />
:Username for authentication on the HTTPS server<br />
;PLD Password<br />
:Password for authentication on the HTTPS server<br />
;PLD-Report Storage Path<br />
:Here, the path to a subfolder is specified where the feedback/report files from the PLD server will be saved.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_PLDModulConf.png|thumb|super|PLD Module Configuration]]<br />
|}<br />
<br />
===Configure HTTP(S) Module===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|The combined module ID along with notes is displayed as the title in the dialog.<br />
<br />
<br />
;Max. Retry Count<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from HVS32.<br />
;Wait Time between Retries<br />
:Specify an interval at which the transmission attempt should be retried.<br />
<br />
;Max. Retry Count (Queue)<br />
:Here, you can set how many times a transmission attempt should be retried if the file is sent directly from the queue.<br />
;Wait Time between Retries (Queue)<br />
:Specify an interval at which the transmission attempt should be retried if the file is in the queue.<br />
<br />
;HTTP(S) URL <br />
:The HTTP or HTTPS URL with function path and, if applicable, a different port of the server.<br />
:Using the "parsable" option allows you to store the URL in the form of a script that can be edited and verified in an editing dialog "...".<br />
;HTTP User<br />
:Username for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;HTTP Password<br />
:Password for authentication (HTTP authentication '''Basic''') on the HTTP(S) server<br />
;MIME-Type<br />
:(This option is available only for module types '''Carrier Module''' and '''Additional Transfer'''.)<br />
:Content-Type of the request accepted by the server (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Directory<br />
:(This option is available only for the module type '''Download'''.)<br />
:Local default directory where downloaded files should be written. Depending on the process, the directory can be overridden by HVS32.<br />
;Proxy <br />
:Here, you can choose a proxy that you have configured in the "Proxy" tab. You can find a detailed description under '''[[#Proxies|Proxies]]'''<br />
<br />
You can test the connection by clicking the Test button.<br />
During the test, an attempt is made to establish a connection to the server, but no authentication takes place.<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
|[[File:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Module Configuration]]<br />
[[File:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Download Module Configuration]]<br />
|}<br />
<br />
==Servers==<br />
[[File:ComManager_Server.png|360px|thumb|right|Servers]]<br />
;1 - Overview of configured communication servers<br />
:'''Server ID''' - Selection and assignment of the server in the modules are done based on this ID<br />
:'''Server Type''' - Server Type/Category (SMTP)<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Server''' - Option to add a new server<br />
:'''Copy Server''' - Allows duplicating the selected server with a new ID.<br />
:'''Rename Server''' - Opens an input dialog to change the ID. Note: If the server is in use, this will lead to errors in process processing.<br />
:'''Edit Server''' - Opens the server configuration dialog.<br />
:'''Remove Server''' - Deletes the server entry. This change is irreversible; if the server is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected server<br />
Keep the original file tag please<br />
<br />
===Configure SMTP Server===<br />
----<br />
[[File:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Configuration]]<br />
After entering the unique server ID, the configuration of the new communication server is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
<br />
;From Address<br />
:The email address specified here will be displayed as the sender address for all emails sent via the server.<br />
;From Name<br />
:This name will be displayed as the sender's name.<br />
;SMTP Server<br />
:IP address or hostname under which the SMTP server is accessible.<br />
;SMTP Authentication<br />
:Here, you can enter your credentials for the SMTP server and activate authentication. <br />
;SMTP Port<br />
:Port under which the SMTP server is accessible (25, 465, 587)<br />
;SSL Enabled<br />
:Data sent will be encrypted via Secure Sockets Layer.<br />
;TLS Enabled<br />
:Data sent will be encrypted via Transport Layer Security if the SMTP server supports it. <br />
;TLS Required<br />
:The server requires TLS support.<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations. '''<br />
<br />
==Proxies==<br />
[[File:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Overview of configured proxies<br />
:'''Proxy ID''' - Selection and assignment of the proxy is done based on this ID in the modules<br />
:'''Proxy Type''' - Proxy Type/Category (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Server name or IP address of the proxy<br />
:'''Modified''' - Modification date of the configuration<br />
;2 - Control Options<br />
:'''Add Proxy''' - Option to add a new proxy<br />
:'''Copy Proxy''' - Allows duplicating the selected proxy with a new ID.<br />
:'''Rename Proxy''' - Opens an input dialog to change the ID. Note: If the proxy is in use, this will lead to errors in process processing.<br />
:'''Edit Proxy''' - Opens the proxy configuration dialog.<br />
:'''Remove Proxy''' - Deletes the proxy entry. This change is irreversible; if the proxy is in use, this will lead to errors in process processing.<br />
;3 - Summary of the configuration of the selected proxy<br />
<br />
<br />
===Add/Configure Proxy===<br />
----<br />
[[File:ComManager_ProxyConf.png|300px|thumb|right|Proxy Configuration]]<br />
After entering the unique proxy ID, the configuration of the new proxy is done.<br />
In the following dialog, you can adjust the corresponding parameters. <br />
;PROXY Type<br />
:Determines the type of the deployed proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP address or hostname under which the proxy server is accessible.<br />
;PROXY Port <br />
:Port under which the proxy server is accessible <br />
;PROXY User<br />
:Username for authentication on the proxy server<br />
;PROXY Password<br />
:Password for authentication on the proxy server<br />
<br />
;NOTE<br />
:The FTP proxy type '''USER <User>@<Host>''' is configured directly in the '''FTP module''' and not as a proxy.<br />
:To do this, enter the data in the FTP module as follows: '''FTP Server = <FTP Proxy Host>''' and '''FTP User = <FTP User>@<FTP Server>'''<br />
<br />
'''Before exiting the program, be sure to click on "Save" to save your configurations.'''<br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Error Code ||Error Description||Troubleshooting<br />
|-<br />
|COM11C00100||Unknown error occurred while processing a Send Message job! Response is NULL!||This is a general error in processing a Send Message job. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unknown error occurred while processing an Upload job! Response is NULL!||This is a general error in processing an Upload job. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Error occurred while deleting temporary file(s) during processing of a Send Message job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM11W00210||Error occurred while deleting temporary file(s) during processing of an Upload job.||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00020||Error converting response to XML - Response is NULL||This is a general error in processing a request. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Error parsing XML data in REST function uploadFile||The data received from HVS32 for upload is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00110||Error creating module configuration for REST function uploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Error converting response to XML for REST function uploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00130||Error reading file(s) in REST function uploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory and if sufficient permissions for reading files are set for the Windows user SYSTEM (or the Windows user specified in Heidler-ComManager). Try repeating the operation.<br />
|-<br />
|COM21C00131||Error writing temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00200||Error parsing XML data in REST function downloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00210||Error creating module configuration for REST function downloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Error converting response to XML for REST function downloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00300||Error parsing XML data in REST function sendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00320||Error converting response to XML for REST function sendMessage||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding server module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Error reading file(s) in REST function sendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00331||Error writing temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00400||Error parsing XML data in REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00410||Error creating module configuration for REST function queueUploadFile||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Error converting response to XML for REST function queueUploadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00430||Error reading file(s) in REST function queueUploadFile||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00431||Error writing temporary file(s) in REST function queueUploadFile||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00500||Error parsing XML data in REST function queueDownloadFile||The data received from HVS32 for download is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00510||Error creating module configuration for REST function queueDownloadFile||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Error converting response to XML for REST function queueDownloadFile||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00600||Error parsing XML data in REST function queueSendMessage||The data received from HVS32 for SendMessage is incorrect. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00620||Error converting response to XML for REST function queueSendMessage||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00630||Error reading file(s) in REST function queueSendMessage||The file to be transferred does not exist or cannot be read. Please check if the file to be transferred exists in the specified directory. Try repeating the operation.<br />
|-<br />
|COM21C00631||Error writing temporary file(s) in REST function queueSendMessage||The temporary copy of the file(s) to be transferred could not be created. Try repeating the operation. If this doesn't work, please check the log files and contact our support team.<br />
|-<br />
|COM21C00700||Error loading main configuration in REST function getModuleList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Error reading main configuration in REST function getModuleList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Error converting response to XML for REST function getModuleList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21C00800||Error loading main configuration in REST function getServerList||There was an error loading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Error reading main configuration in REST function getServerList||There was an error reading the main configuration. Please check your main settings in HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Error converting response to XML for REST function getServerList||The response to HVS32 could not be generated. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00132||Error deleting temporary file(s) in REST function uploadFile||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM21W00332||Error deleting temporary file(s) in REST function sendMessage||The temporary copy of the file(s) to be transferred could not be deleted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00100||Error initializing HVS32 Database Manager||There was an error initializing the Database Manager. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00200||Error initializing write connections to HVS32 database||There was an error initializing the write connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00210||Error initializing prepared statements for updating FF file in HVS32 database||There was an error initializing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00220||Error updating FF file||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00225||Error updating FF file - no results found||There was an error executing the SQL for updating database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00230||Error initializing prepared statements for updating WaWi file in HVS32 database||There was an error initializing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00240||Error updating WaWi file||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00245||Error updating WaWi file - no results found||There was an error executing the SQL for updating database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00300||Error initializing read connections to HVS32 database||There was an error initializing the read connections to the database. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00310||Error initializing prepared statements for reading FF file in HVS32 database||There was an error initializing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00320||Error reading FF file from HVS32 database||There was an error executing the SQL for reading database entries for the FF file number. WARNING: The FF file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00325||FF file not found in HVS32 database||The FF file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The FF file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM31E00330||Error initializing prepared statements for reading WaWi file in HVS32 database||There was an error initializing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00340||Error reading WaWi file from HVS32 database||There was an error executing the SQL for reading database entries for the WaWi file number. WARNING: The WaWi file may have already been transmitted. Please check the HVS32 database configuration in the main configuration of HVS32CommunicationManager and restart the "Heidler-ComManager" service on the server at a convenient time.<br />
|-<br />
|COM31E00345||WaWi file not found in HVS32 database||The WaWi file number transmitted by HVS32 could not be found in the HVS32 database. WARNING: The WaWi file may have already been transmitted. Please check the log files and contact our support team.<br />
|-<br />
|COM50C01100||Error instantiating the upload module||The module for the selected module ID for upload cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Failed to instantiate the upload module||The module for the selected module ID for upload could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Error initializing the upload module||The module for the selected module ID for upload cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Error instantiating the download module||The module for the selected module ID for download cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Failed to instantiate the download module||The module for the selected module ID for download could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Error initializing the download module||The module for the selected module ID for download cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Error instantiating the SendMessage module||The server module for the selected server module ID for SendMessage cannot be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Failed to instantiate the SendMessage module||The server module for the selected server module ID for SendMessage could not be instantiated. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Error initializing the SendMessage module||The server module for the selected server module ID for SendMessage cannot be initialized. Please check your settings for the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Error connecting to FTP server||There was an error connecting to the FTP server. Please check the configured FTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Error logging into FTP server||There was an error logging into the FTP server. Please check the configured login credentials (username/password) in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Error changing directory on FTP server||There was an error changing the directory on the FTP server. Please check the configured FTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Error uploading file to FTP server||There was an error uploading the FF file to the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00500||Error downloading file from FTP server||There was an error downloading the file from the FTP server. The FTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM51C00410||Error renaming file on FTP server||There was an error renaming the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C00411||Error moving file on FTP server||There was an error moving the FF file on the FTP server. The file might already exist on the FTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM51C99999||Invocation of an unsupported function in FTP module||The invoked function is not supported by this FTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM52C00100||Error starting session on SFTP server||There was an error starting the session to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Error starting session on jump host for SFTP transmission||There was an error starting the session to the jump host. Please check the configured jump host settings in the SFTP server module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Error opening channel to SFTP server||There was an error opening the channel to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Error connecting to SFTP server||There was an error connecting to the SFTP server. Please check the configured SFTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Error changing directory on SFTP server||There was an error changing the directory on the SFTP server. Please check the configured SFTP directory in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Error uploading file to SFTP server||There was an error uploading the FF file to the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00510||Error uploading file to SFTP server - Access denied!||There was an error uploading the FF file to the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C00520||Error renaming file on SFTP server||There was an error renaming the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00521||Error moving file on SFTP server||There was an error moving the FF file on the SFTP server. The file might already exist on the SFTP server, or there might be invalid characters in the filename.<br />
|-<br />
|COM52C00600||Error downloading file from SFTP server||There was an error downloading the file from the SFTP server. The SFTP server might be temporarily overloaded - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM52C00610||Error downloading file from SFTP server - Access denied!||There was an error downloading the file from the SFTP server. The user might not have sufficient permissions. Please check the parameters such as username and SFTP directory - retry the operation. If this doesn't work, have the permissions checked by the operator of the SFTP server.<br />
|-<br />
|COM52C99999||Invocation of an unsupported function in SFTP module||The invoked function is not supported by this SFTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM53C00100||SMTP configuration not found||There was an error in the configuration of the SMTP module. Please check the selected SMTP server in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00101||Illegal parameters in SMTP configuration - recipient address is empty!||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00102||Illegal parameters in SMTP configuration - subject is empty!||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00103||Illegal parameters in SMTP configuration - mail text is empty!||There was an error in the configuration of the SMTP module. Please check the configured mail text in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00105||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00110||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00111||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00112||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00120||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00130||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00131||Error setting recipient address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured recipient address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00132||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00133||Error setting BCC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured BCC address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00134||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53W00135||Error setting subject in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured subject in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00200||No SMTP data found from HVS32||No SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00201||Invalid SMTP data from HVS32||Invalid SMTP data (recipient, subject, content) was transmitted from HVS32 to HVS32CommunicationsManager. Please check the settings in HVS32 and retry the operation.<br />
|-<br />
|COM53C00202||Illegal parameters in SMTP data from HVS32 - recipient address is empty!||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53C00203||Illegal parameters in SMTP data from HVS32 - subject is empty!||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00204||Illegal parameters in SMTP data from HVS32 - mail text is empty!||There was an error in the configuration of HVS32. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00205||Error creating message instance!||There was an error in the configuration of the SMTP module. Please check the configured mail parameters such as server, encryption, and authentication in the module configuration of the corresponding module in HVS32CommunicationManager.<br />
|-<br />
|COM53C00210||Error setting HTML content in SMTP module||There was an error setting the HTML content in the SMTP module. Please check the configured HTML content in HVS32 Configurator.<br />
|-<br />
|COM53C00211||Error setting text content in SMTP module||There was an error setting the text content in the SMTP module. Please check the configured text content in HVS32 Configurator.<br />
|-<br />
|COM53C00212||Error setting message content in SMTP module||There was an error setting the message content in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00220||Error attaching file in SMTP module||There was an error attaching the file in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00230||Error setting FROM address in SMTP module||There was an error in the configuration of the SMTP server module. Please check the configured FROM address in the corresponding server module configuration of HVS32CommunicationManager.<br />
|-<br />
|COM53C00231||Error setting recipient address in SMTP module||There was an error in the configuration of HVS32. Please check the configured recipient address in HVS32 Configurator.<br />
|-<br />
|COM53W00232||Error setting CC address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured CC address in HVS32 Configurator.<br />
|-<br />
|COM53W00233||Error setting BCC address in SMTP module||There was an error in the configuration of HVS32. Please check the configured BCC address in HVS32 Configurator.<br />
|-<br />
|COM53W00234||Error setting reply-to address in SMTP module||There was an error in the configuration of the SMTP module. Please check the configured reply-to address in HVS32 Configurator.<br />
|-<br />
|COM53W00235||Error setting subject in SMTP module||There was an error in the configuration of HVS32. Please check the configured subject in HVS32 Configurator.<br />
|-<br />
|COM53C00300||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C00400||Error sending email in SMTP module||There was an error sending the email in the SMTP module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM53C99999||Invocation of an unsupported function in SMTP module||The invoked function is not supported by this SMTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54C99999||Invocation of an unsupported function in PLD module||The invoked function is not supported by this PLD module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|-<br />
|COM54W03005||3005 PLD Warning - File already transmitted!||The carrier file has already been transmitted and therefore could not be accepted by the UPS server. Please do not transmit this file again.<br />
|-<br />
|COM54W06930||6930 PLD Warning - Data uploaded with warnings. Please correct before the next upload!||The carrier file has been successfully transmitted to the UPS server and processed. The file does not need to be transmitted again. However, there are content errors in the FF file that need to be fixed before the next day's closure. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06931||6931 PLD Error - Upload failed due to errors in the PLD data.||The carrier file has been transmitted to the UPS server but was NOT processed due to errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06932||6932 Severe PLD Error - Upload failed due to errors in the input parameters.||The carrier file has been transmitted to the UPS server but was NOT processed due to SERIOUS errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C06933||Unknown PLD Error - Upload failed due to unknown errors.||The carrier file has been transmitted to the UPS server but was NOT processed due to unknown errors. The file needs to be retransmitted after fixing the errors. There are content errors in the FF file that need urgent attention. Please check the saved feedback reports from UPS (see module configuration for the directory) and contact our support team.<br />
|-<br />
|COM54C01000||Error in feedback - no status code found!||An error was detected in the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54C01100||Error parsing the feedback||There was an error parsing the feedback from the UPS server. Please check the log files and contact our support team.<br />
|-<br />
|COM54W01200||Error saving the report file(s)||There was an error saving the reports from the UPS server. Please check the configured storage path in the corresponding PLD module configuration of HVS32CommunicationManager, as well as the user rights of this directory.<br />
|-<br />
|COM54C02000||HTTPS connection not ready!||There was an error connecting to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C03000||Error reading the EDI file||There was an error reading the FF file in the PLD module. Retry the operation. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM54C04000||Error transmitting data to the UPS server||There was an error transmitting data to the UPS server. The UPS server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C02000||HTTP(S) connection not ready!||There was an error connecting to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C04000||Error transmitting data to the HTTP(S) server||There was an error transmitting data to the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C05000||Error downloading file from the HTTP(S) server||There was an error downloading the file from the HTTP(S) server. The HTTP(S) server might be temporarily busy - please retry the operation at a later time. If this doesn't work, check the log files and contact our support team.<br />
|-<br />
|COM55C99999||Invocation of an unsupported function in HTTP module||The invoked function is not supported by this HTTP module. Please check the configuration in HVS32 and select a different module for the corresponding function.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Communication_Manager&diff=6096
HVS32 Communication Manager
2025-03-19T08:02:02Z
<p>Bhauser: /* ErrorHandler konfigurieren */</p>
<hr />
<div>[[en:HVS32_Communication_Manager(en)]]<br />
Der Communication Manager (fortan ComManager abgekürzt) ist ein Dienst der die Kommunikation zwischen HVS32 und Kunde oder <br><br />
HVS32 und Frachtführer zentral Verwaltet und übernimmt. Gedacht ist der ComManager für Kommunikationen via FTP, SFTP oder SMTP.<br />
<br />
Genau wie bei WinSCP wird dieser Dienst vom HVS32 angesteuert und versendet die Daten an den im Modul konfigurierten Zielserver.<br />
<br />
Er soll nach und nach die Kommunikationen des HVS32 übernehmen und andere externe Übermittlungsprogramme wie zum Beispiel WinSCP ablösen.<br />
<br />
=ComManager Konfiguration=<br />
Der ComManager-Konfigurator wird entweder direkt über die ''ComManager-Configurator.exe'' im Installationsverzeichnis ''...Heidler\HVS32\ComManager\'' oder aus dem [[HVS32_Communication_Manager_in_HVS32_einrichten|HVS32 Konfigurator]] gestartet. <br />
<br />
[[Datei:Commanager-startmaske.png|500px|thumb|ohne|Commanager-startmaske]]<br />
<br />
;1 - Link zu diesem Wiki Eintrag<br />
;2 - Auswahl Tabs<br />
:'''[[HVS32_Communication_Manager#Module|Module]]''' - Module zur Übertragung von Dateien beim Tagesabschluss, Wawi-Rück und Routendownloads<br />
:'''[[HVS32_Communication_Manager#Server|Server]]''' - Interne Kommunikationsserver wie z.B. Microsoft Exchange (SMTP) Verbindungen<br />
:'''[[HVS32_Communication_Manager#Proxys|Proxy]]''' - Interne Proxyserver<br />
;3 - Übersicht der eingerichteten Module<br />
;4 - Zusammenfassung der Konfiguration vom ausgewählten Modul<br />
;5 - [[HVS32_Communication_Manager#ErrorHandler_konfigurieren|Errorhandler Konfiguration]]<br />
;6 - [[HVS32_Communication_Manager#Dienst_Einstellungen|Dienst Einstellungen]]<br />
<br />
==Dienst Einstellungen==<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Hier werden die grundlegenden Einstellungen des ComManager Dienstes vorgenommen, die erforderlich sind um eine Verbindung zum Dienst aufzubauen. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
<span style="color:#C00000">'''Warnung: Die Konfigurationen, die Sie hier vornehmen werden erst nach einem Neustart des ComManager Dienstes übernommen!'''</span><br />
<br />
;HVS32 Hauptverzeichnis: <br />
:Hier den Pfad zum HVS32 angeben<br />
;HVS32 Datenbank-Datei:<br />
:Pfad zur HVS32 Datenbank angeben. <br />
;HVS32 Datenbank Server:<br />
:IP Adresse oder Hostnamen des PCs auf dem die Datenbank liegt.<br />
;HVS32 Datenbanken Port:<br />
:Der Port zu der HVS32 Datenbank muss nur in den seltensten Fällen angepasst werden. Im Standard ist der Port auf 3050 gestellt.<br />
;REST Port<br />
:Kommunikations-Port unter welchem der ComManager-Dienst via REST erreichbar ist. Dieser muss zur externen Kommunikation mit den Clients auf dem Server in der Firewall freigegeben werden.<br />
<br />
|[[Datei:ComManager Diensteinstellungen.png|460px|thumb|right|Konfigurationsfenster der Diensteinstellungen]]<br />
|}<br />
<br />
==ErrorHandler konfigurieren==<br />
<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
<br />
|Ist ein ErrorHandler konfiguriert, werden Sie im Falle einer erfolglosen Übertragung per Mail benachrichtig. '''Dieser Bereich ist passwortgeschützt, es wird das selbe Passwort wie für HVS32 user "vadmin" benötigt.'''<br />
<br />
;Mode<br />
:Wählen Sie zunächst den Modus über welchen Sie die Error-Mails versenden möchten<br />
<br />
[[Datei:ErrorhandlerKonfigurieren.png|500px|thumb|right|ErrorHandler Konfiguration - SMTP]]<br />
===SMTP===<br />
Für den Versand der E-Mails über einen SMTP, wählen Sie "SMTP" und konfigurieren Sie die folgenden Parameter:<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren.<br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt.<br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert<br />
<br />
[[Datei:o365_commanager_03_errorhandler.png|500px|thumb|right|ErrorHandler Konfiguration - O365]]<br />
===O365===<br />
Für den Versand der E-Mails via Microsoft Office365, wählen Sie "O365" und konfigurieren Sie die folgenden Parameter:<br />
;Graph URL<br />
:Dies ist die offizielle URL für die Microsoft Graph API. Diese ist im Standard bereits vorbelegt<br />
;Client-ID<br />
:Applikation (Client) ID der registrierten Applikation (siehe Azure Konfiguration)<br />
;Client-Secret<br />
:in Azure hinterlegtes Secret der Applikation (nicht die ID des Secrets)<br />
;Tenant-ID<br />
:Tenant-ID der in Azure registrierten Applikation<br />
;Scope<br />
:Dies ist der Standard-Scope welcher für das Versenden von Mails via Microsoft Graph benötigt wird. Dieser Parameter ist vorbelegt.<br />
<br />
===Allgemein===<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
<br />
;Testen<br />
:Sie können mit dieser Option eine Testnachricht zur Prüfung der eingestellten Parameter verschicken.<br />
<br />
<br />
<br />
|}<br />
<br />
==Module==<br />
[[Datei:ComManager_Modul.png|360px|thumb|right|Module]]<br />
;1 - Übersicht der eingerichteten Module<br />
:'''Modul ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Moduls in HVS32<br />
:'''Modul Typ''' - Modul Typ/Art; das in der Klammer dargestellte Kürzel "U" / "D" gibt Auskunft darüber ob es ein '''D'''ownload (z.B. Routendownload) oder '''U'''pload Modul (FFDatei, WaWi-Rück., etc.) ist<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
[[Datei:ComManager_AddModul.png|340px|thumb|right|Modul hinzufügen]]<br />
;Modul hinzufügen / konfigurieren<br />
Über die Module findet die Kommunikation zwischen HVS32 und dem angegebenen Server statt. Ein solcher Server kann entweder ein eigener [[HVS32_Communication_Manager#Server|(SMTP) Server]] oder direkt der Server vom Frachtführer oder Kunden sein.<br />
<br />
Nach der Auswahl des Modul-Typs (FTP, SFTP, SMTP, PLD/UPS, HTTP) erfolgt die vor Konfiguration vom neuen Modul. In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen.<br />
<br />
;Modul Art<br />
:'''Frachtführer-Modul''' - Standard Auswahl für den Upload von FF-Dateien beim Tagesabschluss<br />
:'''Zusatzübertragung''' - Kundenindividuelle Übertragung von z.B. WaWi-Rück-Dateien an einen Kundeneigenen Server<br />
:'''Download''' - Spezielle Modul Art für den Download von z.B. Routendateien<br />
;ModulID<br />
:Eine automatisch generierte ID für die Auswahl und Zuweisung des Moduls im HVS32<br />
;Frachtführer<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Frachtführer-Modulen im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Auftraggeber<br />
:Zusätzliche Eingrenzung des Moduls für die Verwendung von bestimmten Auftraggebern/Mandanten im HVS32 (ausschließlich für die FF-Datei-Übertragung)<br />
;Notiz<br />
:Optionale Notiz, zur besseren Übersicht (wird in der Übersicht und im HVS32 dargestellt)<br />
<br />
<br />
===FTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;FTP Server: <br />
:IP Adresse des Servers oder Servername<br />
;FTP Port: <br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 21) <br />
;FTP Benutzer<br />
:Benutzername zur Authentifizierung am FTP-Server <br />
;FTP Password<br />
:Password zur Authentifizierung am FTP-Server <br />
;FTP Account<br />
:FTP-Account zur Authentifizierung am FTP-Server<br />
;FTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem FTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "FTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt.<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;FTP Transfer-Modus<br />
:Geben Sie an ob die Daten binär oder als Text übertragen werden sollen.<br />
;FTP Sicherheit <br />
:;FTPS <br />
::FTP über Secure Socket Layer (SSL) implizit<br />
:;FTPES: <br />
::FTP über Secure Socket Layer (SSL) explizit. (Hier kann der Server auch unsichere Verbindungen zulassen)<br />
;FTP Verbindung<br />
:Hier können Sie die Methode zum Verbindungsaufbau wählen. Es sollte standardmäßig PASSIVE gewählt werden.<br />
;Proxy: <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_FTPModulConf.png|thumb|right|FTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_FTPModulConf_Download.png|thumb|right|FTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SFTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SFTP Server <br />
:IP Adresse des Servers oder Servername<br />
;SFTP Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 22)<br />
;SFTP Benutzer<br />
:Benutzername zur Authentifizierung am SFTP-Server <br />
;SFTP Password<br />
:Password zur Authentifizierung am SFTP-Server <br />
;Private-Key-File (OPEN-SSH Format)<br />
:Falls Sie einen private Key verwenden, können Sie hier den Pfad zur Datei angeben.<br />
;Passphrase<br />
:Hier geben Sie bitte Ihre Passphrase an um die oben genannte Datei zu entschlüsseln<br />
;SFTP Verzeichnis <br />
:'''Upload''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien in das benutzerspezifische Root-Verzeichnis hochgeladen.<br />
:'''Download''' - Zielpfad auf dem SFTP-Server, wenn die Eingabe leer ist, werden die Dateien aus dem benutzerspezifischen Root-Verzeichnis heruntergeladen.<br />
;Verschiebe nach (Verzeichnis)<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Zielpfad auf dem SFTP-Server, in welchen die Datei nach einem erfolgreichen Upload verschoben wird. Wenn leer, wird die Datei in das "SFTP Verzeichnis" direkt hochgeladen und nicht mehr zusätzlich verschoben.<br />
;Namenserweiterung nach Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung nach einem einem erfolgreichen Upload an den Dateinamen hinzu.<br />
;Namenserweiterung beim Upload<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Fügt eine zusätzliche Dateiendung/Namenserweiterung vor dem Upload an den Dateinamen hinzu. Der Dateiname verbleibt nach dem Upload, die Dateinamenerweiterung wird nicht wieder entfernt..<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Timeout (ms)<br />
:Zeit in Millisekunden, die der Verbindungsaufbau und einzelne Kommunikationsschritte maximal in Anspruch nehmen können (im Standard 30000ms).<br />
:Im Konfigurationsdialog selbst wird unabhängig von der Einstellung ein Timeout von 5000ms verwendet, um die Verbindung schneller Testen zu können.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
<br />
'''Sollte beim Verbindungstest der Fehler "Algorithm negotiation fail" auftreten, liegt es i.d.R. daran, dass der SFTP Server alte Sicherheits Algorithmen wie z.B. ssh-dss nutzt, welche nicht mehr unterstützt werden. In diesem Fall setzen Sie den Haken "Alte Algorithmen bevorzugen" bzw. "prefer old algorithms" um eine Unterstützung der alten Sicherheits Algorithmen zu erzwingen.'''<br />
<br />
<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen und der Zugriff auf das angegebene Verzeichnis geprüft. <br />Ist kein Verzeichnis angegeben wird nur die Verbindung zum Server getestet. <br />
'''ACHTUNG:''' Es wird lediglich der Verbindungsaufbau getestet, sollte z.B. der FTP-Benutzer nicht über ausreichende Berechtigungen Verfügen um Dateien zu erstellen, tritt der Fehler erst bei einer richtigen Übertragung über das HVS32 auf!<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_SFTPModulConf.png|thumb|right|SFTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_SFTPModulConf_Download.png|thumb|right|SFTP Download Modul Konfiguration]]<br />
|}<br />
<br />
===SMTP Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|-<br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;SMTP Server<br />
:Hier können Sie einen SMPT Server wählen, den Sie zuvor im Reiter „Server“ konfiguriert haben. Eine genaue Beschreibung finden Sie unter '''[[#SMTP Server konfigurieren|SMTP Server konfigurieren]]'''.<br />
;Antwort Adresse<br />
:Diese Adresse überschreibt die Absenderadresse des SMTP Servers und wird anstatt dessen als Absenderadresse für E-Mails, welche über dieses Modul versendet werden angezeigt.<br />
;An/CC/BCC Adresse(n)<br />
:Angabe der Empfänger, die eine Benachrichtigungs-Mail erhalten sollen. Es können auch mehrere Empfänger-Mailadressen mit einem Komma getrennt eingegeben werden.<br />
;Betreff<br />
:Dieser Text wird beim Versand der Mails als Betreff verwendet.<br />
;Mail Inhalt (PLAIN Text)<br />
:Unformatierter Nachrichtentext für die zu versendenden E-Mail.<br />
;Mail Inhalt (HTML Text)<br />
:HTML konform formatierter Nachrichtentext für die zu versendenden E-Mail.<br />
<br />
Der Test erfolgt bei SMTP Modulen über '''Testbutton''' im Konfigurationsdialog des entsprechenden '''Servers'''.<br />
<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
|[[Datei:ComManager_SMTPModulConf.png|thumb|super|SMTP Modul Konfiguration]]<br />
<br />
|}<br />
<br />
===PLD Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;PLD Server <br />
:HTTPS URL des Servers<br />
;PLD Pfad <br />
:Zielpfad vom HTTPS-Server<br />
;PLD Port<br />
:Port unter welchem der Server erreichbar ist (Standartmäßig Port 443)<br />
;PLD Benutzer<br />
:Benutzername zur Authentifizierung am HTTPS-Server<br />
;PLD Password<br />
:Password zur Authentifizierung am HTTPS-Server<br />
;PLD-Report Speicherpfad<br />
:Hier wird der Pfad zu einem Unterordner angegeben, in welchen die Rückmelde-/Reportdateien vom PLD-Server gespeichert werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_PLDModulConf.png|thumb|super|PLD Modul Konfiguration]]<br />
|}<br />
<br />
===HTTP(S) Modul konfigurieren===<br />
----<br />
{| border="0" cellpadding="1" cellspacing="1" style="width: 100%;"<br />
|- <br />
|Als Überschrift wird im Dialog die zusammengesetzte Modul-ID inkl. Notiz angezeigt.<br />
<br />
<br />
;max. Anzahl Wdh.<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus HVS32 heraus versendet wird.<br />
;Wartezeit zwischen Wdh.<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll.<br />
<br />
;max. Anzahl Wdh. (Queue)<br />
:Hier können Sie einstellen wie oft ein Übermittlungsversuch wiederholt werden soll, wenn die Datei direkt aus der Queue heraus versendet wird.<br />
;Wartezeit zwischen Wdh. (Queue)<br />
:Hier können sie ein Intervall angeben in welchen Abständen der Übermittlungsversuch wiederholt werden soll, wenn die Datei in der Queue liegt.<br />
<br />
<br />
;HTTP(S) URL <br />
:Die HTTP oder HTTPS URL mit Funktionspfad und ggf. abweichendem Port des Servers<br />
:Über die Auswahl "parsbar" lässt sich die URL in Form eines Scripts hinterlegen, den man in einem Bearbeitungsdialog "..." editieren und prüfen kann.<br />
;HTTP Benutzer<br />
:Benutzername zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;HTTP Password<br />
:Password zur Authentifizierung (HTTP authentication '''Basic''') am HTTP(S)-Server<br />
;MIME-Type<br />
:(Diese Option steht nur bei den Modul-Arten '''Frachtführer-Modul''' und '''Zusatzübertragung''' zur Verfügung)<br />
:Content-Type vom Request, welcher vom Server akzeptiert wird (MULTIPART_FORMDATA, FORM_URLENCODED)<br />
;Download Verzeichnis<br />
:(Diese Option steht nur bei der Modul-Art '''Download''' zur Verfügung)<br />
:Lokales Standard Verzeichnis in welches die Heruntergeladenen Dateien geschrieben werden sollen. Je nach Prozess kann das Verzeichnis vom HVS32 überschrieben werden.<br />
;Proxy <br />
:Hier können Sie einen Proxy wählen, welchen Sie zuvor im Reiter „Proxy“ konfiguriert haben. Eine genaue Beschreibung hierzu finden sie unter '''[[#Proxys|Proxys]]'''<br />
<br />
Sie könne die Verbindung testen indem Sie auf den Testen Button klicken.<br />
Bei einem Test versucht eine Verbindung zum Server auszubauen, eine Authentifizierung findet dabei nicht statt.<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
|[[Datei:ComManager_HTTPModulConf.png|thumb|super|HTTP Upload Modul Konfiguration]]<br />
[[Datei:ComManager_HTTPModulConf_Download.png|thumb|super|HTTP Downlaod Modul Konfiguration]]<br />
|}<br />
<br />
==Server==<br />
[[Datei:ComManager_Server.png|360px|thumb|right|Server]]<br />
;1 - Übersicht der eingerichteten Kommunikationsservern<br />
:'''Server ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Servers in den Modulen<br />
:'''Server Typ''' - Server Typ/Art (SMTP)<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Server hinzufügen''' - Option zum hinzufügen eines neuen Servers<br />
:'''Server kopieren''' - Ermöglicht es den ausgewählten Server als Duplikat mit einer neuen ID anzulegen.<br />
:'''Server umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Server bearbeiten''' - Öffnet den Server-Konfigurationsdialog.<br />
:'''Server entfernen''' - Löscht den Server Eintrag. Diese Änderung ist unwiderruflich, sollte der Server in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Server<br />
<br />
<br />
===SMTP Server konfigurieren===<br />
----<br />
[[Datei:ComManager_SMTPServerConf.png|300px|thumb|right|SMTP Server Konfiguration]]<br />
Nach der Eingabe der eindeutigen Server-ID erfolgt die Konfiguration vom neuen Kommunikationsserver.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
<br />
;Von Adresse<br />
:Die hier angegebene Mailadresse wird als Absenderadresse für alle E-Mails angezeigt, welche über den Server versendet werden.<br />
;Von Name<br />
:Dieser Name wird als Absendername angezeigt.<br />
;SMTP Server<br />
:IP Adresse oder Hostname unter dem der SMPT Server erreichbar ist.<br />
;SMTP Authentifizierung<br />
:Hier können Sie Ihre Zugangsdaten für den SMTP Server hinterlegen und die Authentifizierung aktivieren. <br />
;SMTP Port<br />
:Port unter dem der SMTP Server erreichbar ist (25, 465, 587)<br />
;SSL aktiviert<br />
:gesendete Daten werden über Secure Sockets Layer verschlüsselt.<br />
;TLS aktiviert<br />
:gesendete Daten werden über Transport Layer Security verschlüsselt. Insofern der SMTP Server dies Unterstützt. <br />
;TLS benötigt<br />
:Es wird vom Server eine TLS Unterstützung angefordert <br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern. '''<br />
<br />
==Proxys==<br />
[[Datei:ComManager_Proxy.png|360px|thumb|right|Proxy]]<br />
;1 - Übersicht der eingerichteten Proxys<br />
:'''Proxy ID''' - Über diese ID erfolgt die Auswahl und Zuweisung des Proxys in den Modulen<br />
:'''Proxy Typ''' - Proxy Typ/Art (DIRECT/HTTP/HTTP_TUNNEL/SOCKS4/SOCKS4A/SOCKS5)<br />
:'''Proxy Server''' - Servername oder IP-Adresse vom Proxy<br />
:'''Geändert''' - Änderungsdatum der Konfiguration<br />
;2 - Steuerungsoptionen<br />
:'''Proxy hinzufügen''' - Option zum hinzufügen eines neuen Proxys<br />
:'''Proxy kopieren''' - Ermöglicht es den ausgewählten Proxy als Duplikat mit einer neuen ID anzulegen.<br />
:'''Proxy umbenennen''' - Öffnet ein Eingabe Dialog zur Änderung der ID. Achtung: Sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
:'''Proxy bearbeiten''' - Öffnet den Proxy-Konfigurationsdialog.<br />
:'''Proxy entfernen''' - Löscht den Proxy Eintrag. Diese Änderung ist unwiderruflich, sollte der Proxy in Verwendung sein, führt dies zu Fehlern bei der Prozessverarbeitung.<br />
;3 - Zusammenfassung der Konfiguration vom ausgewählten Proxy<br />
<br />
<br />
===Proxy hinzufügen / konfigurieren===<br />
----<br />
[[Datei:ComManager_ProxyConf.png|300px|thumb|right|Proxy Konfiguration]]<br />
Nach der Eingabe der eindeutigen Proxy-ID erfolgt die Konfiguration vom neuen Proxy.<br />
In dem folgenden Dialog können Sie dann die entsprechenden Parameter einstellen. <br />
;PROXY Typ<br />
:Bestimmt die Art vom eingesetzten Proxy - Direct, HTTP, HTTP Tunnel, SOCKS4, SOCKS4A, SOCKS5<br />
;PROXY Server<br />
:IP Adresse oder Hostname unter dem der Proxy Server erreichbar ist.<br />
;PROXY Port <br />
:Port unter dem der Proxy Server erreichbar ist <br />
;PROXY Benutzer<br />
:Benutzername zur Authentifizierung am Proxy Server<br />
;PROXY Passwort<br />
:Passwort zur Authentifizierung am Proxy Server<br />
<br />
;HINWEIS<br />
:Der FTP Proxy-Typ '''USER <Benutzer>@<Host>''' wird direkt im '''FTP-Modul''' konfiguriert und nicht als Proxy.<br />
:Tragen Sie dazu die Daten im FTP-Modul wie folgt ein: '''FTP Server = <FTP-Proxy-Host>''' und '''FTP Benutzer = <FTP-Benutzer>@<FTP-Server>'''<br />
<br />
'''Klicken Sie vor dem Beenden des Programmes unbedingt auf „Speichern“ um Ihre Konfigurationen zu speichern.'''<br />
<br />
=Troubleshooting=<br />
<br />
{| class="wikitable"<br />
|+<br />
!Fehlercode ||Fehlerbeschreibung||Fehlerbehebung<br />
|-<br />
|COM11C00100||Unbekannter Fehler bei der Verarbeitung eines Send Message Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Send Message Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11C00200||Unbekannter Fehler bei der Verarbeitung eines Upload Jobs! Response ist NULL!||Dies ist ein allgemeiner Fehler bei der Verarbeitung eines Upload Jobs. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM11W00110||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Send Message Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM11W00210||Fehler beim Löschen der temporären Datei(en) bei der Verarbeitung eines Upload Jobs.||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00020||Fehler beim Konvertieren der Antwort in XML - Response ist NULL||Dies ist ein allgemeiner Fehler bei der Verarbeitung eienr Anfrage. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00100||Fehler beim Parsen der XML Daten in REST Funktion uploadFile||Die Übergabe-Daten aus dem HVS32 für den Upload sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00110||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion uploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00120||Fehler beim Konvertieren der Antwort in XML für REST Funktion uploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00130||Fehler beim Einlesen der Datei(en) in REST Funktion uploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob in dem entsprechenden Verzeichnis die zu übertragende Datei existiert und ausreichende Berechtigungen zum Lesen von Dateien für den Windows-Benutzer SYSTEM (oder der im Heidler-ComManager hinterlegten Windows-Benutzer) gesetzt sind. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00131||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00200||Fehler beim Parsen der XML Daten in REST Funktion downloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00210||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion downloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00220||Fehler beim Konvertieren der Antwort in XML für REST Funktion downloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00300||Fehler beim Parsen der XML Daten in REST Funktion sendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00320||Fehler beim Konvertieren der Antwort in XML für REST Funktion sendMessage||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Server-Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00330||Fehler beim Einlesen der Datei(en) in REST Funktion sendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00331||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00400||Fehler beim Parsen der XML Daten in REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00410||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueUploadFile||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00420||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueUploadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00430||Fehler beim Einlesen der Datei(en) in REST Funktion queueUploadFile||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00431||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueUploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00500||Fehler beim Parsen der XML Daten in REST Funktion queueDownloadFile||Die Übergabe-Daten aus dem HVS32 für den Download sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00510||Fehler beim Erstellen der Modul-Konfiguration für REST Funktion queueDownloadFile||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM21C00520||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueDownloadFile||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00600||Fehler beim Parsen der XML Daten in REST Funktion queueSendMessage||Die Übergabe-Daten aus dem HVS32 für SendMessage sind nicht korrekt. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00620||Fehler beim Konvertieren der Antwort in XML für REST Funktion queueSendMessage||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00630||Fehler beim Einlesen der Datei(en) in REST Funktion queueSendMessage||Die zu übertragende Datei existiert nicht oder kann nicht gelesen werden. Bitte prüfen Sie, ob die zu übertragende Datei im entsprechenden Verzeichnis existiert. Versuchen Sie den Vorgang zu wiederholen.<br />
|-<br />
|COM21C00631||Fehler beim Schreiben der temporäten Datei(en) in REST Funktion queueSendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht erstellt werden. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00700||Fehler beim Laden der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00710||Fehler beim Lesen der Haupkonfiguration in REST Funktion getModuleList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00720||Fehler beim Konvertieren der Antwort in XML für REST Funktion getModuleList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21C00800||Fehler beim Laden der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Laden der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00810||Fehler beim Lesen der Haupkonfiguration in REST Funktion getServerList||Es ist ein Fehler beim Lesen der Hauptkonfiguration aufgetreten. Bitte prüfen Sie Ihre Haupt-Einstellungen im HVS32CommunicationManager.<br />
|-<br />
|COM21C00820||Fehler beim Konvertieren der Antwort in XML für REST Funktion getServerList||Die Rückmeldung an das HVS32 konnte nicht erstellt werden. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00132||Fehler beim Löschen der temporären Datei(en) in REST Funktion uploadFile||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM21W00332||Fehler beim Löschen der temporären Datei(en) in REST Funktion sendMessage||Die temporäre Kopie der zu übertragenden Datei konnte nicht gelöscht werden. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00100||Fehler bei Initialisierung des HVS32 Datenbank Managers||Es ist ein Fehler beim Initialisieren des DatenbankManagers aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00200||Fehler bei Initialisierung der Schreib-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Schreib-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00210||Fehler bei Initialisierung des Prepared Statements zum Updaten der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00220||Fehler beim Updaten der FF Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00225||Fehler bei Update von FF-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00230||Fehler bei Initialisierung des Prepared Statements zum Updaten der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00240||Fehler beim Updaten der WaWi-Datei||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00245||Fehler bei Update von WaWi-Datei - keine Resultate gefunden||Es ist ein Fehler beim Ausführen der SQL zum Updaten der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00300||Fehler bei Initialisierung der Lese-Verbindungen zur HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der Lese-Verbindungen zur Datenbank aufgetreten. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00310||Fehler bei Initialisierung des Prepared Statements zum Lesen der FF-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00320||Fehler beim Lesen der FF-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die FF-Datei-Nr aufgetreten. ACHTUNG: Die FF-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00325||FF Datei in HVS32 Datenbank nicht gefunden||Die vom HVS32 übermittelte FF-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die FF-Datei wurde bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM31E00330||Fehler bei Initialisierung des Prepared Statements zum Lesen der WaWi-Datei in der HVS32 Datenbank||Es ist ein Fehler beim Initialisieren der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00340||Fehler beim Lesen der WaWi-Datei aus der HVS32 Datenbank||Es ist ein Fehler beim Ausführen der SQL zum Lesen der Datenbankeinträge für die WaWi-Datei-Nr aufgetreten. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Bitte prüfen Sie die Konfiguration der HVS32 Datenbank in der Haupt-Konfiguration des HVS32CommunicationManager und starten Sie zu einem günstigen Zeitpunkt den Dienst "Heidler-ComManager" auf dem Server neu.<br />
|-<br />
|COM31E00345||WaWi-Datei nicht in HVS32 Datenbank gefunden||Die vom HVS32 übermittelte WaWi-Datei-Nummer konnte in der HVS32 Datenbank nicht gefunden werden. ACHTUNG: Die WaWi-Datei wurde ggf. bereits übermittelt. Prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM50C01100||Fehler beim Instanziieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01150||Instanziieren des Upload-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Upload kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C01200||Fehler beim Initialisieren des Upload-Moduls||Das Modul zur gewählten Modul-ID für den Upload kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02100||Fehler beim Instanziieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02150||Instanziieren des Download-Moduls fehlgeschlagen||Das Modul zur gewählten Modul-ID für den Download kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C02200||Fehler beim Initialisieren des Download-Moduls||Das Modul zur gewählten Modul-ID für den Download kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03100||Fehler beim Instanziieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03150||Instanziieren des SendMessage-Moduls fehlgeschlagen||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht instanziiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM50C03200||Fehler beim Initialisieren des SendMessage-Moduls||Das Server-Modul zur gewählten Server-Modul-ID für SendMessage kann nicht initialisiert werden. Bitte prüfen Sie Ihre Einstellungen des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00100||Fehler bei der Verbindung zum FTP Server||Es ist ein Fehler bei der Verbindung zum FTP-Server aufgetreten. Prüfen Sie den hinterlegten FTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00200||Fehler beim Login auf FTP Server ||Es ist ein Fehler beim Login zum FTP-Server aufgetreten. Prüfen Sie die hinterlegten Login-Daten (Benutzername/Passwort) in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00300||Fehler beim Wechseln des Verzeichnisses auf dem FTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem FTP-Server aufgetreten. Prüfen Sie das hinterlegte FTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM51C00400||Fehler beim Hochladen der Datei auf FTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00500||Fehler beim Herunterladen der Datei vom FTP Server||Es ist ein Fehler beim Herunterladen der Datei vom FTP-Server aufgetreten. Möglicherweise ist der FTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM51C00410||Fehler beim Umbenennen der Datei auf FTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C00411||Fehler beim Verschieben der Datei auf FTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem FTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem FTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM51C99999||Aufruf einer nicht unterstützten Funktion im FTP Modul||Die Aufgerufene Funktion wird von diesem FTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM52C00100||Fehler beim Starten der Session auf dem STFP Server||Es ist ein Fehler beim Starten der Session zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00110||Fehler beim Starten der Session auf dem Jump Host für die SFTP Übertragung||Es ist ein Fehler beim Starten der Session zum Jump Host aufgetreten. Prüfen Sie den hinterlegten Jump Host Einstellungen in der SFTP-Server Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00200||Fehler beim Öffnen des Kanals zum SFTP Server||Es ist ein Fehler beim Öffnen des Kanals zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00300||Fehler bei der Verbindung zum SFTP Server||Es ist ein Fehler bei der Verbindung zum SFTP-Server aufgetreten. Prüfen Sie den hinterlegten SFTP-Server in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00400||Fehler beim Wechseln des Verzeichnisses auf dem SFTP Server||Es ist ein Fehler beim Wechseln des Verzeichnisses auf dem SFTP-Server aufgetreten. Prüfen Sie das hinterlegte SFTP-Verzeichnis in der Modul-Konfiguration des entsprechenden Moduls im HVS32CommunicationManager.<br />
|-<br />
|COM52C00500||Fehler beim Hochladen der Datei auf SFTP Server||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00510||Fehler beim Hochladen der Datei auf SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Hochladen der FF-Datei auf den SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen. <br />
|-<br />
|COM52C00520||Fehler beim Umbenennen der Datei auf SFTP Server||Es ist ein Fehler beim Umbenennen der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00521||Fehler beim Verschieben der Datei auf SFTP Server||Es ist ein Fehler beim Verschieben der FF-Datei auf dem SFTP-Server aufgetreten. Möglicherweise existiert diese Datei bereits auf dem SFTP-Server oder es sind ungültige Zeichen im Dateinamen vorhanden.<br />
|-<br />
|COM52C00600||Fehler beim Herunterladen der Datei vom SFTP Server||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise ist der SFTP-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM52C00610||Fehler beim Herunterladen der Datei vom SFTP Server - Zugriff verweigert!||Es ist ein Fehler beim Herunterladen der Datei vom SFTP-Server aufgetreten. Möglicherweise verfügt der Benutzer nicht über ausreichend Berechtigungen. Prüfen Sie die eingestellten Parameter wie Benutzer und SFTP-Verzeichnis - wiederholen Sie den Vorgang. Sollte dies nicht funktionieren, lassen Sie die Berechtigungen von dem Betreiber des SFTP-Servers prüfen.<br />
|-<br />
|COM52C99999||Aufruf einer nicht unterstützten Funktion im SFTP Modul||Die Aufgerufene Funktion wird von diesem SFTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM53C00100||SMTP Konfiguration nicht gefunden||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den ausgewählten SMTP-Server in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00101||Illegale Parameter in SMTP Konfiguration - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00102||Illegale Parameter in SMTP Konfiguration - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00103||Illegale Parameter in SMTP Konfiguration - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Mail-Text in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00105||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00110||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00111||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00112||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00120||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00130||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00131||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00132||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte CC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00133||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte BCC-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00134||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53W00135||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie den konfigurierten Betreff in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00200||Keine SMTP Daten von HVS32 gefunden||Es wurden keine SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00201||SMTP Daten von HVS32 sind ungültig||Es wurden fehlerhafte SMTP-Daten (Empfänger, Betreff, Inhalt) vom HVS32 an den HVS32CommunicationsManager übermittelt. Bitte prüfen Sie die Einstellungen im HVS32 und wiederholen Sie den Vorgang.<br />
|-<br />
|COM53C00202||Illegale Parameter in SMTP Daten vom HVS32 - Empfänger-Adresse ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator.<br />
|-<br />
|COM53C00203||Illegale Parameter in SMTP Daten vom HVS32 - Betreff ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator.<br />
|-<br />
|COM53C00204||Illegale Parameter in SMTP Daten vom HVS32 - Mail-Text ist leer!||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00205||Fehler beim Erstellen der Nachrichten Instanz!||Es liegt ein Fehler bei der Konfiguration des SMTP-Moduls vor. Bitte prüfen Sie die konfigurierten Mail-Parameter wie Server, Verschlüsselung und Authentifizierung in der entsprechenden Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00210||Fehler beim Setzen des HTML Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des HTML Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten HTML-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00211||Fehler beim Setzen des Text Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Text Inhalts im SMTP Modul aufgetreten. Bitte prüfen Sie den konfigurierten Text-Inhalt im HVS32 Konfigurator.<br />
|-<br />
|COM53C00212||Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul||Es ist ein Fehler beim Setzen des Nachrichten Inhalts im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00220||Fehler beim Anhängen der Datei im SMTP Modul||Es ist ein Fehler beim Anhängen der Datei im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00230||Fehler beim Setzen der VON-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des SMTP-Server-Moduls vor. Bitte prüfen Sie die konfigurierte VON-Adresse in der entsprechenden Server-Modulkonfiguration des HVS32CommuniationManagers<br />
|-<br />
|COM53C00231||Fehler beim Setzen der Empfänger-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Empfänger-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00232||Fehler beim Setzen der CC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte CC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00233||Fehler beim Setzen der BCC-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte BCC-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00234||Fehler beim Setzen der Antwort-Adresse im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie die konfigurierte Antwort-Adresse im HVS32 Konfigurator<br />
|-<br />
|COM53W00235||Fehler beim Setzen des Betreffs im SMTP Modul||Es liegt ein Fehler bei der Konfiguration des HVS32 vor. Bitte prüfen Sie den konfigurierten Betreff im HVS32 Konfigurator<br />
|-<br />
|COM53C00300||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C00400||Fehler beim Senden der Mail im SMTP Modul||Es ist ein Fehler beim Senden der Mail im SMTP Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM53C99999||Aufruf einer nicht unterstützten Funktion im SMTP Modul||Die Aufgerufene Funktion wird von diesem SMTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54C99999||Aufruf einer nicht unterstützten Funktion im PLD Modul||Die Aufgerufene Funktion wird von diesem PLD-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|-<br />
|COM54W03005||3005 PLD Warnung - Datei bereits übertragen!||Die Frachtführer-Datei wurde bereits übertragen und konnte somit vom UPS-Server nicht akzeptiert werden. Bitte übertragen Sie diese Datei nicht erneut.<br />
|-<br />
|COM54W06930||6930 PLD Warnung - Daten wurden mit Warnungen hochgeladen. Bitte korrigieren Sie diese vor dem nächsten Upload!||Die Frachtführer-Datei wurde erfolgreich an den UPS-Server übermittelt und von diesem verarbeitet. Die Datei muss nicht erneut übermittelt werden. Allerdings gibt es inhaltliche Fehler in der FF-Datei, welche vor dem nächsten Tagesabschluss behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06931||6931 PLD Fehler - Upload aufgrund von Fehlern in den PLD Daten fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06932||6932 Schwerer PLD Fehler - Upload aufgrund von Fehlern in den Input Parametern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von SCHWEREN Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C06933||Unbekannter PLD Fehler - Upload aufgrund von unbekannten Fehlern fehlgeschlagen.||Die Frachtführer-Datei wurde an den UPS-Server übermittelt, jedoch von diesem auf Grund von unbekannten Fehlern NICHT verarbeitet. Die Datei muss nach der Fehlerbehebeung erneut übermittelt werden. Es exsitieren inhaltliche Fehler in der FF-Datei, welche dringend behoben werden müssen. Bitte prüfen Sie die gespeicherten Rückmelde-Reports von UPS (siehe Modul-Konfiguration für das Verzeichnis) und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01000||Fehler in Rückmeldung - kein Statuscode gefunden!||Es wurde ein Fehler in der Rückmeldung vom UPS-Server festgestellt. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C01100||Fehler beim Parsen der Rückmeldung||Es ist ein Fehler beim Parsen der Rückmeldung vom UPS-Server aufgetreten. Bitte prüfen Sie die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54W01200||Fehler beim Speichern der Reportdatei(en)||Es ist ein Fehler beim Speichern der Reports vom UPS-Server aufgetreten. Bitte prüfen Sie den konfigurierten Speicher-Pfad in der entsprechenden PLD-Modulkonfiguration des HVS32CommuniationManagers, sowie ggf. die Benutzerrechte dieses Verzeichnisses.<br />
|-<br />
|COM54C02000||HTTPS Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C03000||Fehler beim Lesen der EDI Datei||Es ist ein Fehler beim Lesen der FF-Datei im PLD Modul aufgetreten. Versuchen Sie den Vorgang zu wiederholen. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM54C04000||Fehler beim Übertragen der Daten an den UPS Server||Es ist ein Fehler beim Übertragen der Daten an den UPS-Server aufgetreten. Möglicherweise ist der UPS-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C02000||HTTP(S) Verbindung nicht bereit!||Es ist ein Fehler bei der Verbindung mit dem HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C04000||Fehler beim Übertragen der Daten an den HTTP(S) Server||Es ist ein Fehler beim Übertragen der Daten an den HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support.<br />
|-<br />
|COM55C05000||Fehler beim Herunterladen der Datei vom HTTP(S) Server||Es ist ein Fehler beim Herunterladen der Datei vom HTTP(S)-Server aufgetreten. Möglicherweise ist der HTTP(S)-Server temporär ausgelastet - wiederholen Sie daher den Vorgang zu einem späteren Zeitpunkt erneut. Sollte dies nicht funktionieren, prüfen Sie bitte die Log-Dateien und wenden Sie sich an unseren Support<br />
|-<br />
|COM55C99999||Aufruf einer nicht unterstützten Funktion im HTTP-Modul||Die Aufgerufene Funktion wird von diesem HTTP-Modul nicht unterstützt. Bitte prüfen Sie im HVS32 die Konfiguration und wählen Sie für die entsprechende Funktion ein anderes Modul.<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_commanager_03_errorhandler.png&diff=6095
Datei:O365 commanager 03 errorhandler.png
2025-03-19T07:42:10Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_commanager_02_add-server-2.png&diff=6094
Datei:O365 commanager 02 add-server-2.png
2025-03-19T07:41:57Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_commanager_01_add-server.png&diff=6093
Datei:O365 commanager 01 add-server.png
2025-03-19T07:41:45Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_13_add-permission-5.png&diff=6092
Datei:O365 azure 13 add-permission-5.png
2025-03-19T07:41:33Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_12_add-permission-4.png&diff=6091
Datei:O365 azure 12 add-permission-4.png
2025-03-19T07:41:24Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_11_add-permission-3.png&diff=6090
Datei:O365 azure 11 add-permission-3.png
2025-03-19T07:41:11Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_10_add-permission-2.png&diff=6089
Datei:O365 azure 10 add-permission-2.png
2025-03-19T07:41:00Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_09_add-permission.png&diff=6088
Datei:O365 azure 09 add-permission.png
2025-03-19T07:40:51Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_08_save-secret.png&diff=6087
Datei:O365 azure 08 save-secret.png
2025-03-19T07:40:38Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_07_add-secret-2.png&diff=6086
Datei:O365 azure 07 add-secret-2.png
2025-03-19T07:40:26Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_06_add-secret.png&diff=6085
Datei:O365 azure 06 add-secret.png
2025-03-19T07:40:05Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_05_edit-app-2.png&diff=6084
Datei:O365 azure 05 edit-app-2.png
2025-03-19T07:39:47Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_04_edit-app.png&diff=6083
Datei:O365 azure 04 edit-app.png
2025-03-19T07:39:33Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_03_register-app.png&diff=6082
Datei:O365 azure 03 register-app.png
2025-03-19T07:39:23Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_02_new-app-registration.png&diff=6081
Datei:O365 azure 02 new-app-registration.png
2025-03-19T07:39:13Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:O365_azure_01_search.png&diff=6080
Datei:O365 azure 01 search.png
2025-03-19T07:38:53Z
<p>Bhauser: </p>
<hr />
<div></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Schnittstellen:_Security_Levels_und_Authentifizierung&diff=6050
Schnittstellen: Security Levels und Authentifizierung
2024-11-22T14:37:33Z
<p>Bhauser: /* Credentials verwalten */</p>
<hr />
<div>[[en:Interfaces:_Security_Levels_and_Authentication]]<br />
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.<br>Wenn das Versandsystem HVS32 allerdings öffentlich erreichbar sein muss - also sich das Vorsystem (ERP/WMS) und das Versandsystem HVS32 nicht im gleichen Netzwerk (LAN, vLAN, vNET, private cloud) befinden - muss die Kommunikations-Verbindung der beiden Systeme abgesichert werden.<br>Dies impliziert, dass sowohl die Verbindung verschlüsselt als auch jede eingehende Verbindung authentifiziert werden muss.<br><br />
<br />
=Security Levels (Infrastruktur)=<br />
Zur Absicherung der Netzwerk-Brücke gibt es keine zu 100% perfekte oder sichere Lösung. Meist muss man sich für einen Kompromiss je nach Fall entscheiden. In der Infrastruktur können jedoch bereits diverse Security Levels implementiert werden, um die Sicherheit maßgeblich zu erhöhen.<br />
==LAN / vLAN / vNET / private cloud / VPN==<br />
Befinden sich die beiden Server in einem gemeinsamen Netzwerk, bzw. liegt eine gesicherte Netzwerk-Brücke via VPN zu Grunde, bietet dies grundlegend die beste Basis für eine sichere Datenkommunikation zwischen dem Vorsystem und dem Versandsystem HVS32.<br>[[Datei:Securitylevel infrastructure vpn.png|1000px|rahmenlos|Security Level (Infrastruktur) - LAN / vLAN / vNET / private cloud / VPN]]<br><br><br />
<br />
==S2S (Server-to-Server)==<br />
Bei einer ungesicherten Netzwerk-Brücke ist unbedingt darauf zu achten, dass die Kommunikation ausschließlich verschlüsselt und authentifiziert stattfindet.<br />
[[Datei:Securitylevel infrastructure s2s.png|1000px|rahmenlos|Security Level (Infrastruktur) - S2S (Server-to-Server)]]<br />
==Dead-End-Server==<br />
Da alle Verbindungen zum DGS (DataGatewayServer - Kommunikations-/Schnittstellen-Software) eingehend sind, kann als zusätzliche Sicherheitsmaßnahme der DGS auf einem separaten Server installiert werden, bei welchem alle ausgehenden Verbindungen via Firewall blockiert werden.<br />
[[Datei:Securitylevel infrastructure des.png|1000px|rahmenlos|Security Level (Infrastruktur) - Dead-End-Server]]<br />
<br />
=Authentifizierung=<br />
Authentifizierungs-Mechanismen können nur als "sicher" bezeichnet werden, wenn diese in Kombination mit anderen Sicherheits-Mechanismen wie HTTPS/SSL genutzt werden. Die Verschlüsselung ist mittels HTTPS unter Verwendung von TLSv1.2 oder TLSv1.3 (sofern vom Client unterstützt) möglich.<br />
<br />
Für die Verschlüsselung wird jeweils ein Zertifikat mit zugehörigem Private Key benötigt. Die folgenden Zertifikatsformate werden unterstützt:<br />
<br />
* '''Zertifikate:''' *.crt, *.cer, *.pem, *.der oder *.p7b<br />
* '''Private Key:''' *.der, *.pem, oder *.ssh (OpenSSH)<br><br />
Stellen Sie sicher, dass falls vorhanden die Zertifikatskette vollständig im Zertifikat hinterlegt ist.<br><br><br />
Die folgenden Authentifizierungs-Optionen beziehen sich '''ausschließlich''' auf die [https://interface.heidler-strichcode.de?version=v2 RESTv2 Schnittstelle]<br />
<br>Es wird '''mindestens''' die DataGatewayServer Version '''3.8.39''' benötigt.<br />
==Basic Authentication==<br />
Die Basisauthentifizierung ist ein einfaches Authentifizierungsschema, welches in das HTTP-Protokoll integriert ist. Der Client sendet in jeder HTTP-Anfrage den Authentifizierungsheader, welcher Benutzername und Passwort enthält.<br />
<br />
Der Authentifizierungsheader lautet '''Authorization''' und beinhaltet den Benutzer und das Passwort Base64 codiert im Format ''- Basic <Benutzer>:<Passwort>''.<br />
<br />
<br />
<br />
Die Benutzerverwaltung erfolgt im DataGatewayServer. Dort können neue Benutzer angelegt und gelöscht werden.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen Benutzern steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für eine Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In diesem Beispiel wird der Benutzer ''heidler'' mit dem Passwort ''Wolfschlugen'' verwendet.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Authorization: Basic aGVpZGxlcjpXb2xmc2NobHVnZW4=<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung - 401 Unauthorized</div><br />
<div class="mw-collapsible-content"><br />
Sollte die Authentifizierung aufgrund von ungültigen Benutzerdaten fehlschlagen, so wird der HTTP-Code '''401 Unauthorized''' mit der Fehlermeldung ''"Unauthorized acces"'' im Body quittiert.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Www-authenticate: Basic realm="Restricted Area"<br />
Date: Mon, 26 Feb 2024 09:00:44 GMT<br />
Content-type: application/json<br />
Content-length: 19<br />
<br />
Unauthorized access<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==Digest Access Authentication==<br />
HTTP Digest Access Authentication ist ein Authentifizierungsmechanismus, der in das HTTP-Protokoll integriert ist und dazu dient, die Sicherheit von Webanwendungen zu erhöhen. Im Gegensatz zur einfachen Basisauthentifizierung überträgt Digest Access Authentication keine Benutzernamen und Passwörter im Klartext, sondern verwendet kryptografisch sichere Methoden.<br><br />
<br />
Bei der Digest-Authentifizierung sendet der Client eine Anfrage an den Server (ohne Authentifizierung im Header), der daraufhin eine "Nonce" (eine einmalige Zufallszahl) zurückgibt. Alternativ kann diese über den Enpoint ''v2/hsc/auth/digest'' abgerufen werden. Der Client kombiniert diese Nonce mit Benutzername, Passwort, Anfrage-Methode und URI und erstellt einen "Digest" (Prüfzusammenstellung). Dieser Digest wird dann an den Server gesendet.<br>Der Server kann den Digest überprüfen, indem er denselben Algorithmus auf der Serverseite anwendet und die berechneten Werte vergleicht. Da der Digest mit Hilfe der Nonce und kryptografisch sicheren Techniken erstellt wird, schützt die Digest-Authentifizierung effektiv vor Angriffen wie Passwortdiebstahl und Mann-in-the-Middle-Angriffen (MitM).<br />
<br />
Für die Erstellung vom Digest wird aktuell nur der Algorithmus MD5 unterstützt. Weitere Algorithmusverfahren können nach Rücksprache implementiert werden.<br />
<br />
<br />
<br />
Die Benutzerverwaltung erfolgt im DataGatewayServer. Dort können neue Benutzer angelegt und gelöscht werden.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen Benutzern steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Anfrage einer nonce für die Erstellung des Digest</div><br />
<div class="mw-collapsible-content"><br />
In der initialen Anfrage wird im Header keine Authentifizierung geliefert, da vom Server zuerst die nonce abgefragt werden muss. In der Rückmeldung vom DataGatewayServer befindet sich dann die '''nonce''' zusammen mit weiteren Informationen, welche für die Erstellung eines Digest benötigt werden, im HTTP-Header '''Www-authenticate'''.<br><br />
<br />
Diese Anfrage wird mit dem HTTP-Code '''401 Unauthorized''' und der Fehlermeldung ''"Authentication required!"'' im Body quittiert.<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Www-authenticate: Digest realm="Restricted Area",qop="auth",nonce="079ae550-11c1-40bf-9ee9-7cce5f1dd70e",opaque="opaque"<br />
Date: Mon, 26 Feb 2024 10:21:41 GMT<br />
Content-type: application/json<br />
Content-length: 24<br />
<br />
Authentication required!<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Anfrage nach erhaltener nonce</div><br />
<div class="mw-collapsible-content"><br />
Nachdem der Client die '''nonce, realm, qop und die opaque''' aus der initialen Anfrage extrahiert und damit den Digest generiert hat, kann dieser für die Authentifizierung über den HTTP-Header '''Authorization''' übermittelt werden.<br />
<br />
Das Format entspricht dabei:<br>''Digest username="<BENUTZERNAME>", realm="<REALM>", nonce="<NONCE>", uri="<ENDPOINT>", algorithm="MD5", qop=<QOP>, nc=<NC>, cnonce="<CNONCE>", response="<DIGEST>", opaque="<OPAQUE>"''<br><br>Der Parameter '''nc''' = "Nonce count" und '''cnonce''' = "Client nonce" wird jeweils vom Client generiert und muss für die Erstellung vom Digest genutzt werden.<br />
<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Cache-Control: no-cache<br />
Authorization: Digest username="<BENUTZER>", realm="Restricted Area", nonce="079ae550-11c1-40bf-9ee9-7cce5f1dd70e", uri="<ENDPOINT>", algorithm="MD5", qop=auth, nc=00000001, cnonce="PoYGQC6K", response="ce3fb921e353290142e34ac886694a4c", opaque="opaque"<br />
</syntaxhighlight><br />
</div></div><br />
<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung</div><br />
<div class="mw-collapsible-content"><br />
Bei einer ungültigen Authentifizierung (Verwendung vom HTTP-Header '''Authorization''') wird der HTTP-Code '''401 Unauthorized''' mit der Fehlermeldung ''"client credentials invalid!"'' im Body zurück gemeldet.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 10:45:40 GMT<br />
Content-type: application/json<br />
Content-length: 27<br />
<br />
client credentials invalid!<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==API Keys==<br />
Die API-Key-Authentifizierung ist eine einfache Methode zur Sicherung von API-Zugriffen. Bei dieser Authentifizierungsmethode erhält der Benutzer / Client einmalig einen eindeutigen API-Schlüssel (API-Key). Dieser Schlüssel muss dann bei jeder API-Anfrage im Header mit gesendet werden.<br>Der Server überprüft den empfangenen API-Key, um sicherzustellen, dass die Anfrage von einem authentifizierten Benutzer oder Anwendung stammt.<br><br />
<br />
Der API-Key muss sicher aufbewahrt werden, um unbefugten Zugriff zu verhindern. Außerdem ist es wichtig, diesen regelmäßig zu zu aktualisieren, um die Sicherheit zu gewährleisten.<br />
<br />
<br />
<br />
Der API-Key wird im DataGatewayServer verwaltet. Dort kann ein neuer Key generiert oder bestehende gelöscht werden. Es können mehrere gültige API-Keys existieren.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen API-Keys steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für eine Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In diesem Beispiel wird der API-Key ''apikey_heidler'' verwendet.<br />
<br />
'''Hinweis:''' Aus demonstrationszwecken wird in dem Beispiel ein einfacher API-Key verwendet. Der DataGatewayServer erzeugt einen entsprechend langen und komplexen Key.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
x-api-key: apikey_heidler<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung</div><br />
<div class="mw-collapsible-content"><br />
Bei einem falschen API-Key wird der HTTP-Code '''401 Unauthorized''' mit der Fehlermeldung ''"api key invalid!"'' im Body zurück gemeldet.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 09:46:30 GMT<br />
Content-type: application/json<br />
Content-length: 16<br />
<br />
api key invalid!<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==OAuth 2.0==<br />
===Client Credentials===<br />
OAuth 2.0 Client Credentials ist eine Authentifizierungs-Methode im OAuth 2.0-Protokoll, die es einer Anwendung ermöglicht, sich beim Authorization Server (Authentifizierungsserver) zu authentifizieren. Dies ist besonders nützlich für den Zugriff von Anwendungen auf APIs ohne Benutzerbeteiligung und eignet sich gut für server-seitige Kommunikation zwischen Diensten.<br />
<br />
<br>Das ERP wird am Server registriert und erhält eine eindeutige Client-ID und ein Client-Secret.<br>Inital wird dann von dem ERP eine HTTP-POST-Anfrage an den Authorization Server gesendet, welche die Client-Anmeldeinformationen (Client-ID und Client-Secret) beinhaltet. Im Response wird ein Access-Token und ein Refresh-Token zurück gemeldet.<br>Das ERP sendet nun für die Authentifizierung bei jeder Anfrage das Access-Token im Authorization Header der HTTP-Anfragen mit. Wenn das Access-Token abgelaufen ist, kann mit dem Refresh-Token ein neuer Access-Token angefragt werden. Im Falle einer mehrfachen Nutzung eines Refresh-Tokens werden automatisch alle Refresh-Tokens und Access-Tokens gesperrt.<br>Das Client-Secret muss sicher aufbewahrt werden, um unbefugten Zugriff zu verhindern. Außerdem ist es wichtig, das Client Secret regelmäßig zu zu aktualisieren, um die Sicherheit weiter zu erhöhen.<br />
<br />
<br />
<br />
Die Client-ID und Client-Secret werden im DataGatewayServer verwaltet. Dort können neue Zugangsdaten angelegt oder bestehende gelöscht werden.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen Client-IDs steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br><br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispiel für die Token-Anfrage (Access- und Refreshtoken mit Client-ID + Client-Secret generieren)</div><br />
<div class="mw-collapsible-content"><br />
Bei der Token-Anfrage muss die Client-ID und das Client-Secret im HTTP-Header '''Authorization''' Base64 codiert im Format - ''Basic <ClientID>:<ClientSecret>'' übermittelt werden. Zusätzlich ist für diese Funktion der '''grant_type''' mit dem Wert ''client_credentials'' notwendig.<br />
<syntaxhighlight lang="http"><br />
POST /v2/hsc/auth/token HTTP/1.1<br />
Accept: application/json<br />
Authorization: Basic <ClientID>:<ClientSecret><br />
grant_type: client_credentials<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung der Token-Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In der Rückmeldung der Token-Anfrage wird im Body der Accesstoken (access_token), der Refreshtoken (refresh_token), der Tokentyp (token_type) und Gültigkeit vom Accesstoken in Sekunden (expires_in) zurück gemeldet.<br />
<br />
Der Accesstoken kann nun für die Authentifizierung in den restlichen Anfragen genutzt werden.<br />
<br />
<br />
Der Accesstoken hat aus Sicherheitsgründen eine begrenzte Gültigkeit. Nach Ablauf ist der Accesstoken nicht mehr verwendbar und man erhält einen HTTP-Code '''401 Unauthorized'''. In diesem Fall muss über die Refresh-Anfrage und einem gültigen Refreshtoken ein neuer Accesstoken generiert werden (empfohlen) oder über die Token-Anfrage und der Client-ID + Client-Secret ein neues Accesstoken angefragt werden (nicht empfohlen).<br />
<br />
'''Hinweis:''' Die regelmäßige Generierung von Accesstoken über die Token-Anfrage wird nicht empfohlen, da hier die Client-ID + Client-Secret übertragen wird. Dadurch ist die Anfälligkeit gegen MitM-Angriffen höher. Das Client-Secret sollte so selten wie möglich eingesetzt werden. <br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 200 OK<br />
Date: Mon, 26 Feb 2024 12:06:32 GMT<br />
Content-type: application/json<br />
Content-length: 711<br />
Cache-control: no-cache<br />
<br />
{<br />
"access_token": "eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk3OTIsImp0aSI6ImM0ZDFkNTdiLWUzZTAtNDkwOC1hMDk4LWJiMjc2NmZmODdiMSIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.4zrctPAnBAlMj9CFUL6jQ33Gkou3V_bmcLBUrEsUKL0",<br />
"refresh_token": "eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMxOTIsImp0aSI6IjEwMGZmN2JiLTQ1MzItNDFlNi05NTZjLTBjZjE0YWIzYTljNCIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.vAPo2Zobu2BNGNrUvmxKd5RVGWIn91sT83js33n2UUA",<br />
"token_type": "Bearer",<br />
"expires_in": 600<br />
}<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für die Nutzung eines Accesstokens</div><br />
<div class="mw-collapsible-content"><br />
Der aus der Token-Anfrage erhaltene Accesstoken kann nun im HTTP-Header '''Authorization''' an den DataGatewayServer übermittelt werden, um sich zu authentifizieren. Dieser muss im Format - ''Bearer <Accesstoken>'' übertragen werden.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Authorization: Bearer eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk3OTIsImp0aSI6ImM0ZDFkNTdiLWUzZTAtNDkwOC1hMDk4LWJiMjc2NmZmODdiMSIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.4zrctPAnBAlMj9CFUL6jQ33Gkou3V_bmcLBUrEsUKL0<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für die Refresh-Anfrage (Access- und Refreshtoken mit gültigem Refreshtoken erneuern)</div><br />
<div class="mw-collapsible-content"><br />
Falls ein Accesstoken abgelaufen ist und dieser erneut werden muss, kann über die Refresh-Anfrage und einem gültigen Refreshtoken ein neuer Accesstoken + Refreshtoken generiert werden. In dieser Anfrage muss der HTTP-Header '''refresh_token''' mit dem Refreshtoken und der Header '''grant_type''' mit dem Wert ''refresh_token'' übermittelt werden.<br />
<br />
Um die Sicherheit vor MitM-Angriffen zu erhöhen, empfiehlt es sich den Accesstoken regelmäßig und im kurzen intervall zu aktualisieren.<br />
<br />
'''Hinweis:''' Ein Refreshtoken kann nur einmalig für die Refreshanfrage genutzt werden. Anschließend verliert der Token seine Gültigkeit. Falls ein ungültiger Refreshtoken für die Authentifizierung beim DataGatewayServer genutzt wird, werden aus Sicherheitsgründen alle gültigen Access- und Refreshtoken deaktiviert. Die Authentifizierung muss in diesem Fall wieder über die Token-Anfrage stattfinden.<br />
<syntaxhighlight lang="http"><br />
POST /v2/hsc/auth/refresh HTTP/1.1<br />
Accept: application/json<br />
refresh_token: eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMxOTIsImp0aSI6IjEwMGZmN2JiLTQ1MzItNDFlNi05NTZjLTBjZjE0YWIzYTljNCIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.vAPo2Zobu2BNGNrUvmxKd5RVGWIn91sT83js33n2UUA<br />
grant_type: refresh_token<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung der Refresh-Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In der Rückmeldung der Refresh-Anfrage wird im Body der Accesstoken (access_token), der Refreshtoken (refresh_token), der Tokentyp (token_type) und Gültigkeit vom Accesstoken (expires_in) in Sekunden zurück gemeldet.<br />
<br />
Der Accesstoken kann nun für die Authentifizierung in den restlichen Anfragen genutzt werden.<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 200 OK<br />
Date: Mon, 26 Feb 2024 12:06:43 GMT<br />
Content-type: application/json<br />
Content-length: 711<br />
<br />
{<br />
"access_token": "eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk4MDMsImp0aSI6ImJmYjgyZWE0LTU2NmEtNDc3ZS04NDRjLWRkM2VhYWZmZjQ1ZSIsInV1SUQiOiI0ZmY5ZThhNC01YTY2LTQ0ZDQtYjY4Zi1jNjlmMzFiOTNiYjciLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkyMDN9.vMoedyTSnfWXYXbGPZTX-nfhfNUAvp2upQJ3pTU-u_k",<br />
"refresh_token": "eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMyMDMsImp0aSI6IjI5MTc0NzBkLTNjYTUtNGZiMC1hZDliLThjNjkxYWVjNDYzOSIsInV1SUQiOiI0ZmY5ZThhNC01YTY2LTQ0ZDQtYjY4Zi1jNjlmMzFiOTNiYjciLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkyMDN9.DonI4KsNiTuG6pb705U3QIT7tNnU0pmDS7Tp6UZWHVk",<br />
"token_type": "Bearer",<br />
"expires_in": 600<br />
}<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung - 401 Unauthorized</div><br />
<div class="mw-collapsible-content"><br />
Sollte die Authentifizierung fehlschlagen, so wird der HTTP-Code 401 Unauthorized mit einer entsprechenden Fehlermeldung im Body quittiert.<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 12:38:59 GMT<br />
Content-type: application/json<br />
Content-length: <LÄNGE><br />
<br />
<FEHLERMELDUNG><br />
</syntaxhighlight><br />
</div></div><br />
<br><br><br />
===Authorization Code===<br />
Diese Authentifizierungs-Methode ist ausschließlich über das Authentifzierungssystem [[IRIS_Cloudsystem|IRIS Cloudsystem]] möglich.<br />
<br />
==Client Credentials im DGS verwalten==<br />
Die Client Credentials werden im DataGatewayServer verwaltet. Dort können neue Zugangsdaten angelegt oder bestehende gelöscht werden.<br><br />
Dazu muss im Installationsverzeichnis des DataGatewayServer der Credentials-Configurator(.exe) gestartet werden.<br />
===Config===<br />
[[Datei:Authorization Credentials 001.png|mini|rechts|Credentials Configurator - config]]<br />
Hier können allgemeine Konfigurationen vorgenommen werden.<br />
* '''check invalid logins'''<br>Wenn diese Option aktiv ist, wird die Anzahl der ungültigen Authentifizierungen gezählt und nach '''max invalid logins''' innerhalb von '''timespan in seconds''' werden alle Credentials gesperrt<br />
* '''execute CODE RED for OAuth2.0 CC'''<br>Wenn diese Option bei der Nutzung von OAuth2.0 CC aktiv ist, wird bei mehrfachen verwenden eines REFRESH TOKENS ein '''CODE RED''' ausgelöst. Hierbei werden alle ACCESS und REFRESH TOKENS deaktiviert und es müssen neue Tokens via Client Credentials angefordert werden. Zusätzlich kann im DGS Konfigurator das Versenden einer E-Mail bei einem CODE RED konfiguriert werden.<br />
* '''Lock Credentials / Unlock credentials'''<br>Über diesen Button können alle Credentials gesperrt oder entsperrt werden. Wenn z.b. durch die Option '''check invalid logins''' alle Client Credentials gesperrt wurden, können diese somit wieder entsperrt werden. Diese Option greift sofort, ohne speichern.<br />
* Save<br>Mit diesem Button werden die Einstellungen und Credentials persistent gespeichert. Erst nach dem Speichern werden die Optionen und Credentials aktiv. Ein DGS Neustart ist nicht notwendig.<br />
===Credentials verwalten===<br />
[[Datei:Authorization Credentials 002.png|mini|rechts|Credentials Configurator - OAuth2.0 CC]]<br />
[[Datei:Authorization Credentials 003.png|mini|rechts|Enter Username / ClientID]]<br />
[[Datei:Authorization Credentials 004.png|mini|rechts|Show Credentials Dialog]]<br />
Um Ihre Credentials zu verwalten, wählen Sie den passenden Reiter zu Ihrer im DGS konfigurierten Authentifizierungs-Methode (z.B. OAuth2.0 CC)<br />
* '''add'''<br>Hier können Sie neue Credentials anlegen. Beachten Sie, dass das Passwort bzw. das Client-Secret nur einmalig in einem Dialog angezeigt wird. Kopieren Sie es daher in einen sicheren Platz und stellen Sie sicher, dass keine unautorisierten Personen darauf Zugriff haben.<br />
* '''change secret''' bzw. '''change password'''<br>Hier können Sie ein neues Passwort bzw. Client Secret vergeben. Wie bei der add Funktion, wird das Passwort bzw. das Client-Secret nur einmalig in einem Dialog angezeigt.<br />
* '''remove'''<br>Hier können Sie die die ausgewählten Credentials entfernen.</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Interfaces:_Security_Levels_and_Authentication&diff=6049
Interfaces: Security Levels and Authentication
2024-11-22T14:28:45Z
<p>Bhauser: /* Managing Credentials */</p>
<hr />
<div>[[de:Schnittstellen:_Security_Levels_und_Authentifizierung]]<br />
The HVS32 can be operated in cloud environments without concerns, assuming that the connection from the host system (ERP or WMS, hereinafter referred to as ERP for simplicity) to HVS32 is within a shared, secure, internal network.<br>However, if the shipping software HVS32 needs to be publicly accessible — meaning that the host system (ERP/WMS) and the shipping software HVS32 are not located in the same network (LAN, vLAN, vNET, private cloud) — the communication between the two systems must be secured.<br>This implies that both the connection must be encrypted, and each incoming connection must be authenticated and authorized.<br />
<br />
=Security Levels (Infrastructure)=<br />
To secure the network bridge, there is no 100% perfect or foolproof solution. Typically, one has to opt for a compromise depending on the specific case. However, in the infrastructure, various security levels can already be implemented to significantly enhance security.<br />
==LAN / vLAN / vNET / private cloud / VPN==<br />
If the two servers are within the same network or there is a secured network bridge via VPN in place, this provides the best foundation for secure data communication between the host system and the shipping software HVS32.<br>[[Datei:Securitylevel infrastructure vpn.png|1000px|rahmenlos|Security Levels (Infrastructure) - LAN / vLAN / vNET / private cloud / VPN]]<br />
<br />
==S2S (Server-to-Server)==<br />
In the case of an unsecured network bridge, it is crucial to ensure that communication takes place exclusively through encryption and authentication.<br>[[Datei:Securitylevel infrastructure s2s.png|1000px|rahmenlos|Security Levels (Infrastructure) - S2S (Server-to-Server)]]<br />
==Dead-End-Server==<br />
Since all connections to the DGS (DataGatewayServer - Communication-/Interface-Software) are incoming, as an additional security measure, the DGS can be installed on a separate server where all outgoing connections are blocked via firewall.<br>[[Datei:Securitylevel infrastructure des.png|1000px|rahmenlos|Security Levels (Infrastructure) - Dead-End-Server]]<br />
<br />
=Authentication=<br />
Authentication mechanisms can only be considered "secure" when used in combination with other security mechanisms such as HTTPS/SSL. Encryption is achieved through HTTPS using TLSv1.2 or TLSv1.3 (if supported by the client).<br />
<br />
For encryption, a certificate with the corresponding private key is required. The following certificate formats are supported:<br />
<br />
* '''Certificates:''' *.crt, *.cer, *.pem, *.der, or *.p7b<br />
* '''Private Key:''' *.der, *.pem, or *.ssh (OpenSSH)<br><br />
Please make sure that the certificate chain in the provided certificate is complete.<br><br><br />
The following authentication options are specific to the [https://interface.heidler-strichcode.de?version=v2 RESTv2 interface].<br />
<br>DataGatewayServer Version '''3.8.39''' or higher is needed.<br />
==Basic Authentication==<br />
The Basic authentication is a simple authentication scheme integrated into the HTTP protocol. The client sends the authentication header in every HTTP request, which contains the username and password.<br />
<br />
The authentication header is named '''Authorization''' and includes the username and password base64 encoded in the format - ''Basic <Username>:<Password>''.<br />
<br />
User management is handled within the DataGatewayServer. New users can be created and deleted there.<br />
<br />
'''Note:''' As the number of valid users increases, so does the probability of unauthorized access being granted through a "brute-force attack."<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><div style="font-weight:bold;line-height:1.6;">Example header for request</div><br />
<div class="mw-collapsible-content"><br />
In this example user ''heidler'' and password ''Wolfschlugen'' is used.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Authorization: Basic aGVpZGxlcjpXb2xmc2NobHVnZW4=<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Feedback on failed authentication - 401 Unauthorized</div><br />
<div class="mw-collapsible-content"><br />
If authentication fails due to invalid user data, the HTTP status code '''401 Unauthorized''' will be returned with the error message ''Unauthorized access'' in the body.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Www-authenticate: Basic realm="Restricted Area"<br />
Date: Mon, 26 Feb 2024 09:00:44 GMT<br />
Content-type: application/json<br />
Content-length: 19<br />
<br />
Unauthorized access<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==Digest Access Authentication==<br />
The Digest Access Authentication is an authentication mechanism using the HTTP protocol designed to enhance the security of web applications. Unlike basic authentication, which transmits usernames and passwords in plaintext, Digest Access Authentication uses cryptographically secure methods.<br />
<br />
In Digest authentication, the client sends a request to the server (without authentication in the header), which then returns a "nonce" (a unique random number). Alternatively, this nonce can be obtained via the endpoint ''v2/hsc/auth/digest''.<br />
<br />
The client combines this nonce with the username, password, request method, and URI to create a "digest" (checksum). This digest is then sent to the server. The server can verify the digest by applying the same algorithm on the server side and comparing the calculated values. Because the digest is created using the nonce and cryptographically secure techniques, Digest Authentication effectively protects against attacks such as password theft and man-in-the-middle (MitM) attacks.<br />
<br />
<br />
<br />
Currently, only the MD5 algorithm is supported for digest creation. Additional algorithm procedures can be implemented upon consultation.<br />
<br />
User management is handled within the DataGatewayServer. New users can be created and deleted there.<br />
<br />
'''Note:''' As the number of valid users increases, so does the probability of unauthorized access being granted through a "brute-force attack."<br><br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Request for a nonce to create the digest</div><br />
<div class="mw-collapsible-content"><br />
In the initial request, no authentication is provided in the header because the client first needs to request the nonce. In the response from the DataGatewayServer, the nonce along with further information needed to create a digest is included in the HTTP header '''Www-authenticate'''.<br />
<br />
This request is acknowledged with the HTTP status code '''401 Unauthorized''' and the error message ''Authentication required!'' in the body.<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Www-authenticate: Digest realm="Restricted Area",qop="auth",nonce="079ae550-11c1-40bf-9ee9-7cce5f1dd70e",opaque="opaque"<br />
Date: Mon, 26 Feb 2024 10:21:41 GMT<br />
Content-type: application/json<br />
Content-length: 24<br />
<br />
Authentication required!<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Request after receiving nonce</div><br />
<div class="mw-collapsible-content"><br />
After the client has extracted the '''nonce''', '''realm''', '''qop''', and '''opaque''' from the initial request and generated the digest with them, it can be transmitted for authentication via the HTTP header '''Authorization'''.<br />
<br />
The format is as follows:<br>''Digest username="<USERNAME>", realm="<REALM>", nonce="<NONCE>", uri="<ENDPOINT>", algorithm="MD5", qop=<QOP>, nc=<NC>, cnonce="<CNONCE>", response="<DIGEST>", opaque="<OPAQUE>"''<br><br>The parameter '''nc''' = "Nonce count" and '''cnonce''' = "Client nonce" are both generated by the client and must be used for creating the digest.<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Cache-Control: no-cache<br />
Authorization: Digest username="<USERNAME>", realm="Restricted Area", nonce="079ae550-11c1-40bf-9ee9-7cce5f1dd70e", uri="<ENDPOINT>", algorithm="MD5", qop=auth, nc=00000001, cnonce="PoYGQC6K", response="ce3fb921e353290142e34ac886694a4c", opaque="opaque"<br />
</syntaxhighlight><br />
</div></div><br />
<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Response on failed authentication</div><br />
<div class="mw-collapsible-content"><br />
In case of invalid authentication (using the HTTP header '''Authorization'''), the HTTP status code '''401 Unauthorized''' is returned with the error message ''client credentials invalid!'' in the body.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 10:45:40 GMT<br />
Content-type: application/json<br />
Content-length: 27<br />
<br />
client credentials invalid!<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==API Keys==<br />
API key authentication is a simple method for securing API access. With this authentication method, the user/client is provided with a unique API key. This key must be included in the header of each API request.<br />
<br />
The server verifies the received API key to ensure that the request is coming from an authenticated user or application.<br />
<br />
It's crucial to securely store the API key to prevent unauthorized access. Additionally, regular updates to the API key are important to maintain security.<br />
<br />
The API key is managed within the DataGatewayServer. New keys can be generated or existing ones can be deleted. Multiple valid API keys can exist.<br />
<br />
'''Note:''' As the number of valid API keys increases, so does the probability of unauthorized access being granted through a "brute-force attack."<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Example header for a request</div><br />
<div class="mw-collapsible-content"><br />
In this example, the API key ''apikey_heidler'' is used.<br />
<br />
'''Note:''' For demonstration purposes, a simple API key is used in this example. The keys generated within the DataGatewayServer follow a more complex algorithm.<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
x-api-key: apikey_heidler<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Response on failed authentication</div><br />
<div class="mw-collapsible-content"><br />
In case of an incorrect API key, the HTTP status code '''401 Unauthorized''' is returned with the error message ''api key invalid!'' in the body.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 09:46:30 GMT<br />
Content-type: application/json<br />
Content-length: 16<br />
<br />
api key invalid!<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==OAuth 2.0==<br />
===Client Credentials===<br />
<br />
OAuth 2.0 Client Credentials is an authentication method within the OAuth 2.0 protocol that allows an application to authenticate with the authorization server without user involvement. This is particularly useful for applications accessing APIs without user participation and is well-suited for server-to-server communication between services.<br />
<br />
The ERP system is registered on the authorization server and receives a unique client ID and client secret. Initially, the ERP sends an HTTP POST request to the authorization server including the client credentials (client ID and client secret). The response includes an access token and a refresh token. For authentication with each subsequent request, the ERP includes the access token in the authorization header of the HTTP requests. If the access token expires, a new access token can be requested by using the refresh token. A refresh token can only used once.<br />
<br />
In case of multiple uses of a refresh token, all refresh tokens and access tokens are automatically disabled.<br />
<br />
The client secret must be securely stored to prevent unauthorized access. Additionally, it's important to regularly update the client secret to enhance security further.<br />
<br />
<br />
The client ID and client secret are managed within the DataGatewayServer. New credentials can be created or existing ones can be deleted there.<br />
<br />
'''Note:''' As the number of valid client IDs increases, so does the probability of unauthorized access being granted through a "brute-force attack."<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Example of token request (generating access and refresh tokens with client ID + client secret)</div><br />
<div class="mw-collapsible-content"><br />
For the token request, the client ID and client secret must be transmitted in the HTTP header '''Authorization''', base64 encoded in the format - ''Basic <ClientID>:<ClientSecret>''. Additionally, the '''grant_type''' with the value ''client_credentials'' is necessary for this function.<br />
<syntaxhighlight lang="http"><br />
POST /v2/hsc/auth/token HTTP/1.1<br />
Accept: application/json<br />
Authorization: Basic <ClientID>:<ClientSecret><br />
grant_type: client_credentials<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Response of the token request</div><br />
<div class="mw-collapsible-content"><br />
In the response of the token request, the access token (access_token), refresh token (refresh_token), token type (token_type), and expiration of the access token in seconds (expires_in) are returned in the body.<br />
<br />
The access token can now be used for authentication in subsequent requests.<br />
<br />
For security reasons, the access token has a expiration time. After expiration, the access token is no longer usable, and a HTTP status code '''401 Unauthorized''' is returned. In this case, a new access token must be generated either through the refresh request with a valid refresh token (recommended), or through the token request with the client ID + client secret (not recommended).<br />
<br />
'''Note:''' Using the token request regularly to generate an access tokens is not recommended, as it involves transmitting the client ID + client secret. This increases vulnerability to Man-in-the-Middle (MitM) attacks. The client secret should be used as infrequently as possible.<syntaxhighlight lang="http"><br />
HTTP/1.1 200 OK<br />
Date: Mon, 26 Feb 2024 12:06:32 GMT<br />
Content-type: application/json<br />
Content-length: 711<br />
Cache-control: no-cache<br />
<br />
{<br />
"access_token": "eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk3OTIsImp0aSI6ImM0ZDFkNTdiLWUzZTAtNDkwOC1hMDk4LWJiMjc2NmZmODdiMSIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.4zrctPAnBAlMj9CFUL6jQ33Gkou3V_bmcLBUrEsUKL0",<br />
"refresh_token": "eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMxOTIsImp0aSI6IjEwMGZmN2JiLTQ1MzItNDFlNi05NTZjLTBjZjE0YWIzYTljNCIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.vAPo2Zobu2BNGNrUvmxKd5RVGWIn91sT83js33n2UUA",<br />
"token_type": "Bearer",<br />
"expires_in": 600<br />
}<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Example header for using an access token</div><br />
<div class="mw-collapsible-content"><br />
The access token obtained from the token request can now be transmitted to the DataGatewayServer in the HTTP header '''Authorization''' to authenticate. It must be transmitted in the format - ''Bearer <Access token>''.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Authorization: Bearer eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk3OTIsImp0aSI6ImM0ZDFkNTdiLWUzZTAtNDkwOC1hMDk4LWJiMjc2NmZmODdiMSIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.4zrctPAnBAlMj9CFUL6jQ33Gkou3V_bmcLBUrEsUKL0<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Example header for the refresh request (renewing access and refresh tokens with a valid refresh token)</div><br />
<div class="mw-collapsible-content"><br />
If an access token has expired and needs to be renewed, a new access token + refresh token can be requested by using the refresh request and a valid refresh token. In this request, the HTTP header '''refresh_token''' must be transmitted with the refresh token, and the header '''grant_type''' must be transmitted with the value ''refresh_token''.<br />
<br />
To enhance security against MitM attacks, it is recommended to regularly update the access token at short intervals.<br />
<br />
'''Note:''' A refresh token can only be used once for the refresh request. Afterwards, the token is disabled. For security reasons, if an invalid refresh token is used for authentication with the DataGatewayServer all access and refresh tokens, which were created prior to that, will be disabled. Authentication via token request is required afterwards.<syntaxhighlight lang="http"><br />
POST /v2/hsc/auth/refresh HTTP/1.1<br />
Accept: application/json<br />
refresh_token: eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMxOTIsImp0aSI6IjEwMGZmN2JiLTQ1MzItNDFlNi05NTZjLTBjZjE0YWIzYTljNCIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.vAPo2Zobu2BNGNrUvmxKd5RVGWIn91sT83js33n2UUA<br />
grant_type: refresh_token<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Response of the refresh request</div><br />
<div class="mw-collapsible-content"><br />
In the response of the refresh request, the access token (access_token), refresh token (refresh_token), token type (token_type), and validity of the access token (expires_in) in seconds are returned in the body.<br />
<br />
The access token can now be used for authentication in subsequent requests.<syntaxhighlight lang="http"><br />
HTTP/1.1 200 OK<br />
Date: Mon, 26 Feb 2024 12:06:43 GMT<br />
Content-type: application/json<br />
Content-length: 711<br />
<br />
{<br />
"access_token": "eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk4MDMsImp0aSI6ImJmYjgyZWE0LTU2NmEtNDc3ZS04NDRjLWRkM2VhYWZmZjQ1ZSIsInV1SUQiOiI0ZmY5ZThhNC01YTY2LTQ0ZDQtYjY4Zi1jNjlmMzFiOTNiYjciLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkyMDN9.vMoedyTSnfWXYXbGPZTX-nfhfNUAvp2upQJ3pTU-u_k",<br />
"refresh_token": "eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMyMDMsImp0aSI6IjI5MTc0NzBkLTNjYTUtNGZiMC1hZDliLThjNjkxYWVjNDYzOSIsInV1SUQiOiI0ZmY5ZThhNC01YTY2LTQ0ZDQtYjY4Zi1jNjlmMzFiOTNiYjciLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkyMDN9.DonI4KsNiTuG6pb705U3QIT7tNnU0pmDS7Tp6UZWHVk",<br />
"token_type": "Bearer",<br />
"expires_in": 600<br />
}<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Feedback on failed authentication - 401 Unauthorized</div><br />
<div class="mw-collapsible-content"><br />
If authentication fails, the HTTP status code '''401 Unauthorized''' will be returned along with an appropriate error message in the body.<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 12:38:59 GMT<br />
Content-type: application/json<br />
Content-length: <LÄNGE><br />
<br />
<ERRORMESSAGE><br />
</syntaxhighlight><br />
</div></div><br />
<br><br><br />
<br />
===Authorization Code===<br />
This authentication method is exclusively available through the authentication system [[IRIS_cloud_system|IRIS Cloudsystem]].<br />
<br />
==Managing Client Credentials in the DGS==<br />
The client credentials are managed in the DataGatewayServer. You can create new credentials or delete existing ones.<br><br />
To do this, start the Credentials Configurator (.exe) located in the installation directory of the DataGatewayServer.<br />
===Config===<br />
[[File:Authorization Credentials 001.png|thumb|right|Credentials Configurator - config]]<br />
On this screen, general configurations can be made.<br />
* '''check invalid logins'''<br>If this option is active, the number of invalid authentication attempts will be counted. After '''max invalid logins''' within '''timespan in seconds''', all credentials will be locked.<br />
* '''execute CODE RED for OAuth2.0 CC'''<br>If this option is active when using OAuth2.0 CC, a '''CODE RED''' will be triggered if a REFRESH TOKEN is reused multiple times. This action deactivates all ACCESS and REFRESH TOKENS, requiring new tokens to be requested via client credentials. Additionally, the DGS Configurator can be configured to send an email notification in the event of a CODE RED.<br />
* '''Lock Credentials / Unlock Credentials'''<br>With this button, all credentials can be locked or unlocked. For instance, if all client credentials were locked due to the '''check invalid logins''' option, they can be unlocked here. This action takes effect immediately without needing to save.<br />
* Save<br>This button persistently saves the settings and credentials. The options and credentials only become active after saving. A DGS restart is not required.<br />
===Managing Credentials===<br />
[[File:Authorization Credentials 002.png|thumb|right|Credentials Configurator - OAuth2.0 CC]]<br />
[[File:Authorization Credentials 003.png|thumb|right|Enter Username / ClientID]]<br />
[[File:Authorization Credentials 004.png|thumb|right|Show Credentials Dialog]]<br />
To manage your credentials, select the appropriate tab for the authentication method configured in the DGS (e.g., OAuth2.0 CC).<br />
* '''add'''<br>create new credentials. Note that the password or client secret will only be displayed once in a dialog. Be sure to copy it to a secure location and ensure no unauthorized persons have access to it.<br />
* '''change secret''' or '''change password'''<br>assign a new password or client secret. As with the add function, the password or client secret will only be displayed once in a dialog.<br />
* '''remove'''<br>remove the selected credentials.</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Interfaces:_Security_Levels_and_Authentication&diff=6048
Interfaces: Security Levels and Authentication
2024-11-22T14:27:14Z
<p>Bhauser: </p>
<hr />
<div>[[de:Schnittstellen:_Security_Levels_und_Authentifizierung]]<br />
The HVS32 can be operated in cloud environments without concerns, assuming that the connection from the host system (ERP or WMS, hereinafter referred to as ERP for simplicity) to HVS32 is within a shared, secure, internal network.<br>However, if the shipping software HVS32 needs to be publicly accessible — meaning that the host system (ERP/WMS) and the shipping software HVS32 are not located in the same network (LAN, vLAN, vNET, private cloud) — the communication between the two systems must be secured.<br>This implies that both the connection must be encrypted, and each incoming connection must be authenticated and authorized.<br />
<br />
=Security Levels (Infrastructure)=<br />
To secure the network bridge, there is no 100% perfect or foolproof solution. Typically, one has to opt for a compromise depending on the specific case. However, in the infrastructure, various security levels can already be implemented to significantly enhance security.<br />
==LAN / vLAN / vNET / private cloud / VPN==<br />
If the two servers are within the same network or there is a secured network bridge via VPN in place, this provides the best foundation for secure data communication between the host system and the shipping software HVS32.<br>[[Datei:Securitylevel infrastructure vpn.png|1000px|rahmenlos|Security Levels (Infrastructure) - LAN / vLAN / vNET / private cloud / VPN]]<br />
<br />
==S2S (Server-to-Server)==<br />
In the case of an unsecured network bridge, it is crucial to ensure that communication takes place exclusively through encryption and authentication.<br>[[Datei:Securitylevel infrastructure s2s.png|1000px|rahmenlos|Security Levels (Infrastructure) - S2S (Server-to-Server)]]<br />
==Dead-End-Server==<br />
Since all connections to the DGS (DataGatewayServer - Communication-/Interface-Software) are incoming, as an additional security measure, the DGS can be installed on a separate server where all outgoing connections are blocked via firewall.<br>[[Datei:Securitylevel infrastructure des.png|1000px|rahmenlos|Security Levels (Infrastructure) - Dead-End-Server]]<br />
<br />
=Authentication=<br />
Authentication mechanisms can only be considered "secure" when used in combination with other security mechanisms such as HTTPS/SSL. Encryption is achieved through HTTPS using TLSv1.2 or TLSv1.3 (if supported by the client).<br />
<br />
For encryption, a certificate with the corresponding private key is required. The following certificate formats are supported:<br />
<br />
* '''Certificates:''' *.crt, *.cer, *.pem, *.der, or *.p7b<br />
* '''Private Key:''' *.der, *.pem, or *.ssh (OpenSSH)<br><br />
Please make sure that the certificate chain in the provided certificate is complete.<br><br><br />
The following authentication options are specific to the [https://interface.heidler-strichcode.de?version=v2 RESTv2 interface].<br />
<br>DataGatewayServer Version '''3.8.39''' or higher is needed.<br />
==Basic Authentication==<br />
The Basic authentication is a simple authentication scheme integrated into the HTTP protocol. The client sends the authentication header in every HTTP request, which contains the username and password.<br />
<br />
The authentication header is named '''Authorization''' and includes the username and password base64 encoded in the format - ''Basic <Username>:<Password>''.<br />
<br />
User management is handled within the DataGatewayServer. New users can be created and deleted there.<br />
<br />
'''Note:''' As the number of valid users increases, so does the probability of unauthorized access being granted through a "brute-force attack."<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><div style="font-weight:bold;line-height:1.6;">Example header for request</div><br />
<div class="mw-collapsible-content"><br />
In this example user ''heidler'' and password ''Wolfschlugen'' is used.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Authorization: Basic aGVpZGxlcjpXb2xmc2NobHVnZW4=<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Feedback on failed authentication - 401 Unauthorized</div><br />
<div class="mw-collapsible-content"><br />
If authentication fails due to invalid user data, the HTTP status code '''401 Unauthorized''' will be returned with the error message ''Unauthorized access'' in the body.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Www-authenticate: Basic realm="Restricted Area"<br />
Date: Mon, 26 Feb 2024 09:00:44 GMT<br />
Content-type: application/json<br />
Content-length: 19<br />
<br />
Unauthorized access<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==Digest Access Authentication==<br />
The Digest Access Authentication is an authentication mechanism using the HTTP protocol designed to enhance the security of web applications. Unlike basic authentication, which transmits usernames and passwords in plaintext, Digest Access Authentication uses cryptographically secure methods.<br />
<br />
In Digest authentication, the client sends a request to the server (without authentication in the header), which then returns a "nonce" (a unique random number). Alternatively, this nonce can be obtained via the endpoint ''v2/hsc/auth/digest''.<br />
<br />
The client combines this nonce with the username, password, request method, and URI to create a "digest" (checksum). This digest is then sent to the server. The server can verify the digest by applying the same algorithm on the server side and comparing the calculated values. Because the digest is created using the nonce and cryptographically secure techniques, Digest Authentication effectively protects against attacks such as password theft and man-in-the-middle (MitM) attacks.<br />
<br />
<br />
<br />
Currently, only the MD5 algorithm is supported for digest creation. Additional algorithm procedures can be implemented upon consultation.<br />
<br />
User management is handled within the DataGatewayServer. New users can be created and deleted there.<br />
<br />
'''Note:''' As the number of valid users increases, so does the probability of unauthorized access being granted through a "brute-force attack."<br><br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Request for a nonce to create the digest</div><br />
<div class="mw-collapsible-content"><br />
In the initial request, no authentication is provided in the header because the client first needs to request the nonce. In the response from the DataGatewayServer, the nonce along with further information needed to create a digest is included in the HTTP header '''Www-authenticate'''.<br />
<br />
This request is acknowledged with the HTTP status code '''401 Unauthorized''' and the error message ''Authentication required!'' in the body.<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Www-authenticate: Digest realm="Restricted Area",qop="auth",nonce="079ae550-11c1-40bf-9ee9-7cce5f1dd70e",opaque="opaque"<br />
Date: Mon, 26 Feb 2024 10:21:41 GMT<br />
Content-type: application/json<br />
Content-length: 24<br />
<br />
Authentication required!<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Request after receiving nonce</div><br />
<div class="mw-collapsible-content"><br />
After the client has extracted the '''nonce''', '''realm''', '''qop''', and '''opaque''' from the initial request and generated the digest with them, it can be transmitted for authentication via the HTTP header '''Authorization'''.<br />
<br />
The format is as follows:<br>''Digest username="<USERNAME>", realm="<REALM>", nonce="<NONCE>", uri="<ENDPOINT>", algorithm="MD5", qop=<QOP>, nc=<NC>, cnonce="<CNONCE>", response="<DIGEST>", opaque="<OPAQUE>"''<br><br>The parameter '''nc''' = "Nonce count" and '''cnonce''' = "Client nonce" are both generated by the client and must be used for creating the digest.<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Cache-Control: no-cache<br />
Authorization: Digest username="<USERNAME>", realm="Restricted Area", nonce="079ae550-11c1-40bf-9ee9-7cce5f1dd70e", uri="<ENDPOINT>", algorithm="MD5", qop=auth, nc=00000001, cnonce="PoYGQC6K", response="ce3fb921e353290142e34ac886694a4c", opaque="opaque"<br />
</syntaxhighlight><br />
</div></div><br />
<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Response on failed authentication</div><br />
<div class="mw-collapsible-content"><br />
In case of invalid authentication (using the HTTP header '''Authorization'''), the HTTP status code '''401 Unauthorized''' is returned with the error message ''client credentials invalid!'' in the body.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 10:45:40 GMT<br />
Content-type: application/json<br />
Content-length: 27<br />
<br />
client credentials invalid!<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==API Keys==<br />
API key authentication is a simple method for securing API access. With this authentication method, the user/client is provided with a unique API key. This key must be included in the header of each API request.<br />
<br />
The server verifies the received API key to ensure that the request is coming from an authenticated user or application.<br />
<br />
It's crucial to securely store the API key to prevent unauthorized access. Additionally, regular updates to the API key are important to maintain security.<br />
<br />
The API key is managed within the DataGatewayServer. New keys can be generated or existing ones can be deleted. Multiple valid API keys can exist.<br />
<br />
'''Note:''' As the number of valid API keys increases, so does the probability of unauthorized access being granted through a "brute-force attack."<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Example header for a request</div><br />
<div class="mw-collapsible-content"><br />
In this example, the API key ''apikey_heidler'' is used.<br />
<br />
'''Note:''' For demonstration purposes, a simple API key is used in this example. The keys generated within the DataGatewayServer follow a more complex algorithm.<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
x-api-key: apikey_heidler<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Response on failed authentication</div><br />
<div class="mw-collapsible-content"><br />
In case of an incorrect API key, the HTTP status code '''401 Unauthorized''' is returned with the error message ''api key invalid!'' in the body.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 09:46:30 GMT<br />
Content-type: application/json<br />
Content-length: 16<br />
<br />
api key invalid!<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==OAuth 2.0==<br />
===Client Credentials===<br />
<br />
OAuth 2.0 Client Credentials is an authentication method within the OAuth 2.0 protocol that allows an application to authenticate with the authorization server without user involvement. This is particularly useful for applications accessing APIs without user participation and is well-suited for server-to-server communication between services.<br />
<br />
The ERP system is registered on the authorization server and receives a unique client ID and client secret. Initially, the ERP sends an HTTP POST request to the authorization server including the client credentials (client ID and client secret). The response includes an access token and a refresh token. For authentication with each subsequent request, the ERP includes the access token in the authorization header of the HTTP requests. If the access token expires, a new access token can be requested by using the refresh token. A refresh token can only used once.<br />
<br />
In case of multiple uses of a refresh token, all refresh tokens and access tokens are automatically disabled.<br />
<br />
The client secret must be securely stored to prevent unauthorized access. Additionally, it's important to regularly update the client secret to enhance security further.<br />
<br />
<br />
The client ID and client secret are managed within the DataGatewayServer. New credentials can be created or existing ones can be deleted there.<br />
<br />
'''Note:''' As the number of valid client IDs increases, so does the probability of unauthorized access being granted through a "brute-force attack."<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Example of token request (generating access and refresh tokens with client ID + client secret)</div><br />
<div class="mw-collapsible-content"><br />
For the token request, the client ID and client secret must be transmitted in the HTTP header '''Authorization''', base64 encoded in the format - ''Basic <ClientID>:<ClientSecret>''. Additionally, the '''grant_type''' with the value ''client_credentials'' is necessary for this function.<br />
<syntaxhighlight lang="http"><br />
POST /v2/hsc/auth/token HTTP/1.1<br />
Accept: application/json<br />
Authorization: Basic <ClientID>:<ClientSecret><br />
grant_type: client_credentials<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Response of the token request</div><br />
<div class="mw-collapsible-content"><br />
In the response of the token request, the access token (access_token), refresh token (refresh_token), token type (token_type), and expiration of the access token in seconds (expires_in) are returned in the body.<br />
<br />
The access token can now be used for authentication in subsequent requests.<br />
<br />
For security reasons, the access token has a expiration time. After expiration, the access token is no longer usable, and a HTTP status code '''401 Unauthorized''' is returned. In this case, a new access token must be generated either through the refresh request with a valid refresh token (recommended), or through the token request with the client ID + client secret (not recommended).<br />
<br />
'''Note:''' Using the token request regularly to generate an access tokens is not recommended, as it involves transmitting the client ID + client secret. This increases vulnerability to Man-in-the-Middle (MitM) attacks. The client secret should be used as infrequently as possible.<syntaxhighlight lang="http"><br />
HTTP/1.1 200 OK<br />
Date: Mon, 26 Feb 2024 12:06:32 GMT<br />
Content-type: application/json<br />
Content-length: 711<br />
Cache-control: no-cache<br />
<br />
{<br />
"access_token": "eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk3OTIsImp0aSI6ImM0ZDFkNTdiLWUzZTAtNDkwOC1hMDk4LWJiMjc2NmZmODdiMSIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.4zrctPAnBAlMj9CFUL6jQ33Gkou3V_bmcLBUrEsUKL0",<br />
"refresh_token": "eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMxOTIsImp0aSI6IjEwMGZmN2JiLTQ1MzItNDFlNi05NTZjLTBjZjE0YWIzYTljNCIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.vAPo2Zobu2BNGNrUvmxKd5RVGWIn91sT83js33n2UUA",<br />
"token_type": "Bearer",<br />
"expires_in": 600<br />
}<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Example header for using an access token</div><br />
<div class="mw-collapsible-content"><br />
The access token obtained from the token request can now be transmitted to the DataGatewayServer in the HTTP header '''Authorization''' to authenticate. It must be transmitted in the format - ''Bearer <Access token>''.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Authorization: Bearer eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk3OTIsImp0aSI6ImM0ZDFkNTdiLWUzZTAtNDkwOC1hMDk4LWJiMjc2NmZmODdiMSIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.4zrctPAnBAlMj9CFUL6jQ33Gkou3V_bmcLBUrEsUKL0<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Example header for the refresh request (renewing access and refresh tokens with a valid refresh token)</div><br />
<div class="mw-collapsible-content"><br />
If an access token has expired and needs to be renewed, a new access token + refresh token can be requested by using the refresh request and a valid refresh token. In this request, the HTTP header '''refresh_token''' must be transmitted with the refresh token, and the header '''grant_type''' must be transmitted with the value ''refresh_token''.<br />
<br />
To enhance security against MitM attacks, it is recommended to regularly update the access token at short intervals.<br />
<br />
'''Note:''' A refresh token can only be used once for the refresh request. Afterwards, the token is disabled. For security reasons, if an invalid refresh token is used for authentication with the DataGatewayServer all access and refresh tokens, which were created prior to that, will be disabled. Authentication via token request is required afterwards.<syntaxhighlight lang="http"><br />
POST /v2/hsc/auth/refresh HTTP/1.1<br />
Accept: application/json<br />
refresh_token: eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMxOTIsImp0aSI6IjEwMGZmN2JiLTQ1MzItNDFlNi05NTZjLTBjZjE0YWIzYTljNCIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.vAPo2Zobu2BNGNrUvmxKd5RVGWIn91sT83js33n2UUA<br />
grant_type: refresh_token<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Response of the refresh request</div><br />
<div class="mw-collapsible-content"><br />
In the response of the refresh request, the access token (access_token), refresh token (refresh_token), token type (token_type), and validity of the access token (expires_in) in seconds are returned in the body.<br />
<br />
The access token can now be used for authentication in subsequent requests.<syntaxhighlight lang="http"><br />
HTTP/1.1 200 OK<br />
Date: Mon, 26 Feb 2024 12:06:43 GMT<br />
Content-type: application/json<br />
Content-length: 711<br />
<br />
{<br />
"access_token": "eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk4MDMsImp0aSI6ImJmYjgyZWE0LTU2NmEtNDc3ZS04NDRjLWRkM2VhYWZmZjQ1ZSIsInV1SUQiOiI0ZmY5ZThhNC01YTY2LTQ0ZDQtYjY4Zi1jNjlmMzFiOTNiYjciLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkyMDN9.vMoedyTSnfWXYXbGPZTX-nfhfNUAvp2upQJ3pTU-u_k",<br />
"refresh_token": "eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMyMDMsImp0aSI6IjI5MTc0NzBkLTNjYTUtNGZiMC1hZDliLThjNjkxYWVjNDYzOSIsInV1SUQiOiI0ZmY5ZThhNC01YTY2LTQ0ZDQtYjY4Zi1jNjlmMzFiOTNiYjciLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkyMDN9.DonI4KsNiTuG6pb705U3QIT7tNnU0pmDS7Tp6UZWHVk",<br />
"token_type": "Bearer",<br />
"expires_in": 600<br />
}<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Feedback on failed authentication - 401 Unauthorized</div><br />
<div class="mw-collapsible-content"><br />
If authentication fails, the HTTP status code '''401 Unauthorized''' will be returned along with an appropriate error message in the body.<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 12:38:59 GMT<br />
Content-type: application/json<br />
Content-length: <LÄNGE><br />
<br />
<ERRORMESSAGE><br />
</syntaxhighlight><br />
</div></div><br />
<br><br><br />
<br />
===Authorization Code===<br />
This authentication method is exclusively available through the authentication system [[IRIS_cloud_system|IRIS Cloudsystem]].<br />
<br />
==Managing Client Credentials in the DGS==<br />
The client credentials are managed in the DataGatewayServer. You can create new credentials or delete existing ones.<br><br />
To do this, start the Credentials Configurator (.exe) located in the installation directory of the DataGatewayServer.<br />
===Config===<br />
[[File:Authorization Credentials 001.png|thumb|right|Credentials Configurator - config]]<br />
On this screen, general configurations can be made.<br />
* '''check invalid logins'''<br>If this option is active, the number of invalid authentication attempts will be counted. After '''max invalid logins''' within '''timespan in seconds''', all credentials will be locked.<br />
* '''execute CODE RED for OAuth2.0 CC'''<br>If this option is active when using OAuth2.0 CC, a '''CODE RED''' will be triggered if a REFRESH TOKEN is reused multiple times. This action deactivates all ACCESS and REFRESH TOKENS, requiring new tokens to be requested via client credentials. Additionally, the DGS Configurator can be configured to send an email notification in the event of a CODE RED.<br />
* '''Lock Credentials / Unlock Credentials'''<br>With this button, all credentials can be locked or unlocked. For instance, if all client credentials were locked due to the '''check invalid logins''' option, they can be unlocked here. This action takes effect immediately without needing to save.<br />
* Save<br>This button persistently saves the settings and credentials. The options and credentials only become active after saving. A DGS restart is not required.<br />
===Managing Credentials===<br />
[[File:Authorization Credentials 002.png|thumb|right|Credentials Configurator - OAuth2.0 CC]]<br />
[[File:Authorization Credentials 003.png|thumb|right|Enter Username / ClientID]]<br />
[[File:Authorization Credentials 004.png|thumb|right|Show Credentials Dialog]]<br />
To manage your credentials, select the appropriate tab for the authentication method configured in the DGS (e.g., OAuth2.0 CC).<br />
* '''add'''<br>Here, you can create new credentials. Note that the password or client secret will only be displayed once in a dialog. Be sure to copy it to a secure location and ensure no unauthorized persons have access to it.<br />
* '''change secret''' or '''change password'''<br>Here, you can assign a new password or client secret. As with the add function, the password or client secret will only be displayed once in a dialog.<br />
* '''remove'''<br>Here, you can remove the selected credentials.</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_REST_Schnittstelle_(Automatik-Polling)&diff=5914
HVS32 REST Schnittstelle (Automatik-Polling)
2024-09-09T07:34:19Z
<p>Bhauser: /* Packstückdaten aktualisieren (updateVersanddaten) */</p>
<hr />
<div>[[en:HVS32_REST_Interface_(Polling)]]<br />
<br />
<!-- ------------------------------------------------------------------------------- Voraussetzungen ------------------------------------------------------------------------------- --><br />
= Voraussetzungen =<br />
{| class="wikitable"<br />
|-<br />
| DGS-Version || 3.8.23 oder höher<br />
|-<br />
| DGS-Plugins || HVS32Client, REST Server<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE Voraussetzungen ------------------------------------------------------------------------------- --><br />
<br />
= OpenAPI / Swagger =<br />
[https://interface.heidler-strichcode.de?version=v1 RESTv1]<br />
<!-- ------------------------------------------------------------------------------- Funktionsbeschreibung ------------------------------------------------------------------------------- --><br />
<br />
= Funktionsbeschreibung =<br />
Bei der REST-Schnittstelle stellt der DataGatewayServer (DGS) einen REST Server mit folgenden [[#Übersicht der Funktionen|Funktionen]] zur Verfügung.<br />
Dieser ist in der Standardkonfiguration unter '''http://<Servername>:<Port>/hvs32rest''' erreichbar. Dabei wird der Port 8081 verwendet, welcher bei Bedarf geändert werden kann.<br />
<!-- ------------------------------------------------------------------------------- ENDE Funktionsbeschreibung ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- DATENTYPEN ------------------------------------------------------------------------------- --><br />
<br />
= Datentypen =<br />
'''Integer''' - Zahl mit ausschließlich numerischen Zeichen (0-9).<br><br />
'''Decimal''' - Zahl mit Nachkommastellen (Dezimaltrennzeichen mit Punkt, anstelle von Komma)<br><br />
'''Calendar''' - Datum. Monat ist dabei 0-basierend (0 = Januar, 11 = Dezember)<br><br />
'''String''' - Beliebige Zeichen aus dem Zeichensatz ISO-8859-1. Maximale Länge darf nicht überschritten werden.<br><br />
'''Binary''' - Base64 kodierte Binärdaten<br><br />
'''Sequence''' - Eine Liste von Elementen<br><br />
'''Map''' - Key/Value Map<br><br />
<!-- ------------------------------------------------------------------------------- ENDE DATENTYPEN ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ÜBERSICHT spezial Datentypen ------------------------------------------------------------------------------- --><br />
<br />
= Zusätzliche Datentypen =<br />
Ein spezial Datentyp kann innerhalb der Anfrage / Rückmeldung einer [[#Übersicht der Funktionen|Funktion]] genutzt werden.<br />
<!-- ------------------------------------------------------------------------------- artikelDaten ------------------------------------------------------------------------------- --><br />
== artikelDaten ==<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Artikel-Daten</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| anzahlBuegel || [[#Datentypen|Integer]] || - || - || Nur für Hängeversand: Anzahl der Bügel auf welche die Artikelgruppe aufgeteilt ist<br />
|-<br />
| anzahlPosEtiketten || [[#Datentypen|Integer]] || - || - || Anzahl Artikeletiketten, welche gedruckt werden sollen<br />
|-<br />
| artikelBTNNr || [[#Datentypen|String]] || 25 || - || BTN Nummer / Zolltarifnummer<br />
|-<br />
| artikelEAN || [[#Datentypen|String]] || 20 || - || EAN Nummer<br />
|-<br />
| artikelEinheit || [[#Datentypen|String]] || 10 || - || Einheit der Artikelmenge<br />
|-<br />
| artikelGewicht || [[#Datentypen|Decimal]] || 9 || 3 || Gewicht des Arikels<br />
|-<br />
| artikelGruppe || [[#Datentypen|String]] || 50 || - || Artikelgruppe<br />
|-<br />
| artikelMenge || [[#Datentypen|Decimal]] || 9 || 3 || Menge des Artikels<br />
|-<br />
| artikelServices || [[#Datentypen|String]] || 100 || - || Pipe getrennte Services für diesen Artikel<br />
|-<br />
| artikelSollMenge || [[#Datentypen|Decimal]] || 9 || 3 || -<br />
|-<br />
| artikelText1 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung<br />
|-<br />
| artikelText2 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung<br />
|-<br />
| artikelText3 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung<br />
|-<br />
| artikelText4 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung<br />
|-<br />
| artikelVolumen || [[#Datentypen|Decimal]] || 9 || 3 || Volumen des Artikels<br />
|-<br />
| artikelWaehrung || [[#Datentypen|String]] || 3 || - || Währung in welcher der Wert des Artikels angegeben wird<br />
|-<br />
| artikelWert || [[#Datentypen|Decimal]] || 18 || 2 || Wert des Artikels<br />
|-<br />
| chargeFlag || [[#Datentypen|String]] || 1 || - || <br />
|-<br />
| kundenArtikelNr || [[#Datentypen|String]] || 50 || - || Artikelnummer<br />
|-<br />
| kundenBestellNr || [[#Datentypen|String]] || 50 || - || Bestellnummer<br />
|-<br />
| posAuftragNr || [[#Datentypen|String]] || 50 || - || Auftragsnummer<br />
|-<br />
| posLieferNr || [[#Datentypen|String]] || 40 || - || Lieferscheinnummer<br />
|-<br />
| positionNr || [[#Datentypen|String]] || 50 || - || Laufende Nummer innerhalb des Packstücks<br />
|-<br />
| serienNr || [[#Datentypen|String]] || 30 || - || Seriennummer<br />
|-<br />
| ursprungLand || [[#Datentypen|String]] || 2 || - || Ursprungsland des Artikels<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE artikelDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- --><br />
<br />
== gefahrgut ==<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Gefahrgut-Daten</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| '''gefahrgutBefoerdKat''' ||[[#Datentypen|Integer]] || 1 || - || Beförderungskategorie, Pflicht (siehe ADR-Tabelle Spalte (15)), kann 0-4 sein. Achtung! Muss unbedingt korrekt sein.<br />
|-<br />
| gefahrgutBegrenzteMenge || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status LQ / Begrenzte Menge nach ADR 3.4 verschickt wird, ansonsten F, Pflicht<br />
|-<br />
| '''gefahrgutBezeichnung''' ||[[#Datentypen|String]] || 110 || - || Pflicht (siehe ADR-Tabelle Spalte (2))<br />
|-<br />
| gefahrgutBuchst640 || [[#Datentypen|String]] || 1 || - || Buchstabe für Sondervorschrift 640, bedingte Pflicht bei Stoffen, bei denen die Sondervorschrift 640 gilt (siehe ADR-Tabelle Spalte (6))<br />
|-<br />
| gefahrgutFFCode || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG --><br />
|-<br />
| gefahrgutFaktor || [[#Datentypen|Integer]] || 3 || - || Bewertungsfaktor für Punktesummation auf dem Beförderungspapier, (kann 0, 1, 3, 50 oder 999 sein), eigentlich Pflicht, kann aber eindeutig aus der Beförderungskategorie geschlossen werden, daher muss es nicht unbedingt belegt sein<br />
|-<br />
| gefahrgutFreigestMenge || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status EQ / Excepted Quantities nach ADR 3.5 verschickt wird, ansonsten F, Pflicht<br />
|-<br />
| gefahrgutID || [[#Datentypen|String]] || 8 || - || Eindeutige Suchnummer für Gefahrgut-Stammdaten<br />
|-<br />
| gefahrgutKCode || [[#Datentypen|String]] || 10 || - || Klassifizierungscode, Pflicht (siehe ADR-Tabelle Spalte (3b))<br />
|-<br />
| '''gefahrgutKlasse''' ||[[#Datentypen|String]] || 100 || - || Pflicht (siehe ADR-Tabelle Spalte (3a))<br />
|-<br />
| '''gefahrgutMenge''' ||[[#Datentypen|Decimal]] || 8 || 3 || Stoff-Menge an Gefahrgut, die ADR-technisch zu deklarieren ist ( in Litern bei Flüssigkeiten und verdichteten Gasen, sonst in kg, bei LQ-Gefahrgut immer kg )<br />
|-<br />
| '''gefahrgutMengenEinheit''' ||[[#Datentypen|String]] || 2 || - || Mengeneinheit zur Stoff-Menge. ‚1‘ oder ‚l‘: Liter ; ‚0‘ oder ‚kg‘ oder leer: kg<br />
|-<br />
| gefahrgutNebenGefahr || [[#Datentypen|String]] || 10 || - || bedingte Pflicht bei Stoffen, bei denen neben der Hauptgefahr-Klasse/Zettelnummer noch Nebengefahr-Zettelnummern vorhanden sind (siehe ADR-Tabelle Spalte (5), wenn dort z.B. 3+6.1+8 eingetragen ist, sind 6.1 und 8 die Nebengefahr-Zettelnummern und als (6.1)(8) im Feld Nebengefahr zu übermitteln )<br />
|-<br />
| gefahrgutNettoExplMasse || [[#Datentypen|Decimal]] || 8 || 3 || Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1<br />
|-<br />
| gefahrgutPositionNr || [[#Datentypen|Integer]] || - || - || Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1<br />
|-<br />
| gefahrgutTechBenennung || [[#Datentypen|String]] || 150 || - || bedingt Pflicht bei N.A.G. Gefahrgut (d.h. wenn die Bezeichnung mit N.A.G. endet)<br />
|-<br />
| gefahrgutTunnelBCode || [[#Datentypen|String]] || 10 || - || Tunnelbeschränkungscode, Pflicht (siehe ADR-Tabelle Spalte (15))<br />
|-<br />
| '''gefahrgutUNNR''' ||[[#Datentypen|String]] || 10 || - || Pflicht (siehe ADR-Tabelle Spalte (1))<br />
|-<br />
| gefahrgutUmweltGef || [[#Datentypen|String]] || 1 || - || T wenn Stoff umweltgefährdend ist , ansonsten F, Pflicht bei umweltgefährdenden Stoffen<br />
|-<br />
| gefahrgutVPG || [[#Datentypen|String]] || 3 || - || Verpackungsgruppe, bedingt Pflicht bei den Stoffen, bei denen diese in der ADR-Tabelle belegt ist, kann I,II oder III sein oder gar nicht belegt (letzteres z.B. bei Klasse 2)) (siehe ADR-Tabelle Spalte (4))<br />
|-<br />
| '''gefahrgutVerpAnzahl''' ||[[#Datentypen|Integer]] || 4 || - || Anzahl der Einheiten, in denen das Gefahrgut verpackt ist (in Zusammenhang mit dem nächsten Feld GefahrgutVerpackungsart)<br />
|-<br />
| '''gefahrgutVerpackungsart''' ||[[#Datentypen|String]] || 5 || - || ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- edistatus ------------------------------------------------------------------------------- --><br />
<br />
== edistatus ==<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">EDIStatus</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich<br />
|-<br />
| statuscode || [[#Datentypen|String]] || 2 || - || <br />
01 = FFDatei wurde erzeugt.<br><br />
02 = FFDatei wurde geschrieben.<br><br />
03 = FFDatei wurde verschickt.<br><br />
11 = FFDatei konnte nicht erzeugt werden!<br><br />
12 = FFDatei konnte nicht geschrieben werden!<br><br />
13 = FFDatei konnte nicht verschickt werden!<br><br />
<br />
Es ist zu beachten, dass nicht jede FFDatei verschickt wird, dies hängt ab von der HVS32 Konfiguration.<br><br />
D.h. solange kein Status „1x“ enthalten ist, wurde mit der FFDatei gemäß der HVS32 Konfiguration verfahren.<br />
|-<br />
| statustext || [[#Datentypen|String]] || 200 || - || Klartext des Statuscodes<br />
|-<br />
| fftyp || [[#Datentypen|String]] || 50 || - || Frachtführertyp (z.B. UPS, GLS, DPD)<br />
|-<br />
| dateityp || [[#Datentypen|String]] || 50 || - || FFDateityp (z.B.: Standard, Express, etc.)<br />
|-<br />
| auftraggeber || [[#Datentypen|String]] || 10 || - || Auftraggebernummer ('''ACHTUNG!''' Nicht die AuftraggeberID)<br />
|-<br />
| ffdateinr || [[#Datentypen|String]] || 10 || - || Nummer der FF-Datei (ggf. im Fehlerfall nicht gefüllt)<br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE edistatus ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- packstueckDaten ------------------------------------------------------------------------------- --><br />
== packStueckDaten ==<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Packstückdaten</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)<br />
|-<br />
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)<br />
|-<br />
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)<br />
|-<br />
| '''gewicht''' || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG<br />
|-<br />
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Falls die Paketnummer aus dem Vorsystem verwendet werden soll.<br />
|-<br />
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstück der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)<br />
|-<br />
| nachnahme || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode<br />
|-<br />
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG<br />
|-<br />
| nnVermerk || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode<br />
|-<br />
| nnVerwendung || [[#Datentypen|String]] || 1 || - || 'B' = Bar, 'V' = Verrechnungsscheck<br />
|-<br />
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode<br />
|-<br />
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Laufende Nummer pro Sendung<br />
|-<br />
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm<br />
|-<br />
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm<br />
|-<br />
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.<br />
|-<br />
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm<br />
|-<br />
| verpackungsart || [[#Datentypen|String]] || 6 || - || -<br />
|-<br />
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe-Versicherungswert<br />
|-<br />
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode<br />
|-<br />
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode<br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE packstueckDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT spezial Datentypen ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- --><br />
<br />
= Übersicht der Funktionen =<br />
<!-- ------------------------------------------------------------------------------- echo ------------------------------------------------------------------------------- --><br />
== Schnittstelle testen (echo) ==<br />
Zum Testen der REST-Schnittstelle. Liefert die übergebene Nachricht unverändert zurück.<br><br><br />
{| class="wikitable"<br />
|-<br />
| '''Funktion (GET): /hvs32rest/echo/<Nachricht>'''<br />
|}<br />
<br />
<Nachricht> wird zurück gegeben.<br />
<!-- ------------------------------------------------------------------------------- ENDE echo ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- versanddatenAnfrage ------------------------------------------------------------------------------- --><br />
== Packstück-Verarbeitung (versanddatenAnfrage) ==<br />
Die Gatewayfunktion versanddatenAnfrage wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück zu erzeugen und verbuchen. Ein Etikett wird für alle weiteren Funktionen wir Storno, Verladefreigabe, etc. anhand der hostseitigen Packstück-ID identifiziert. Diese wird im Feld PackstueckID übergeben und muss dementsprechend innerhalb des Versandsystems eindeutig sein.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/versanddatenAnfrage'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br />
<br />
<br><br />
<!-- ------------------------------------------------------------------------------- Request ------------------------------------------------------------------------------- --><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
|absenderAdresseID<br />
|[[#Datentypen|String]]<br />
|10<br />
| -<br />
| Eindeutige ID um eine Neutrale-Absenderadresse aus dem HVS32 zu verwenden<br />
|-<br />
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner<br />
|-<br />
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)<br />
|-<br />
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| auftragNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32<br />
|-<br />
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisZusatz1 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 1<br />
|-<br />
| avisZusatz2 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 2<br />
|-<br />
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)<br />
|-<br />
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)<br />
|-<br />
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers<br />
|-<br />
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers<br />
|-<br />
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse<br />
|-<br />
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll<br />
|-<br />
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer<br />
|-<br />
|freiAvis1<br />
|[[#Datentypen|String]]<br />
| -<br />
| -<br />
| -<br />
|-<br />
|freiAvis2<br />
|[[#Datentypen|String]]<br />
| -<br />
| -<br />
| -<br />
|-<br />
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -<br />
|-<br />
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] [[#gefahrgut|<Gefahrgut>]] || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)<br />
|-<br />
| '''gewicht''' ||[[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG<br />
|-<br />
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem<br />
|-<br />
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)<br />
|-<br />
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| kostenstelle || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender<br />
|-<br />
| lagerkennzeichen || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)<br />
|-<br />
| lieferantenID || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet<br />
|-<br />
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG<br />
|-<br />
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck<br />
|-<br />
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck<br />
|-<br />
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode<br />
|-<br />
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung<br />
|-<br />
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.<br />
|-<br />
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm<br />
|-<br />
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm<br />
|-<br />
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.<br />
|-<br />
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm<br />
|-<br />
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)<br />
|-<br />
| postLeitcode || [[#Datentypen|String]] || 15 || - || -<br />
|-<br />
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -<br />
|-<br />
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer<br />
|-<br />
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt<br />
|-<br />
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren<br />
|-<br />
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers<br />
|-<br />
| terminArt || [[#Datentypen|String]] || 1 || - || 'A' = ab diesem Tag liefern<br />
'B' = bis zu diesem Tag liefern<br />
<br />
'F' = an diesem Tag liefern<br />
|-<br />
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers<br />
|-<br />
| verpackungsart || [[#Datentypen|String]] || 6 || - || -<br />
|-<br />
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32<br />
|-<br />
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert<br />
|-<br />
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode<br />
|-<br />
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird<br />
|-<br />
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode<br />
|-<br />
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort<br />
|-<br />
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse<br />
|-<br />
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse<br />
|-<br />
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)<br />
|-<br />
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE Request ------------------------------------------------------------------------------- --><br />
<br><br />
<!-- ------------------------------------------------------------------------------- Response ------------------------------------------------------------------------------- --><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum (Monat ist 0-basierend), wann das Etikett an den Frachtführer übermittelt worden ist<br />
|-<br />
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)<br />
|-<br />
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum (Monat ist 0-basierend), wann das Etikett im HVS32 gedruckt worden ist<br />
|-<br />
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)<br />
|-<br />
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts<br />
|-<br />
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten<br />
|-<br />
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode<br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage<br />
|-<br />
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure<br />
|-<br />
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer<br />
|-<br />
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung<br />
|-<br />
| versandSendungsNr || [[#Datentypen|String]] || - || - || -<br />
|-<br />
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map<br />
|-<br />
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE Response ------------------------------------------------------------------------------- --><br />
<br><br />
<!-- ------------------------------------------------------------------------------- Beispiel ------------------------------------------------------------------------------- --><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"absenderAdresseID": "",<br />
"ansprechpartner": "",<br />
"assoc": {<br />
"Key": "Value"<br />
},<br />
"artikelDaten": [<br />
{<br />
"anzahlBuegel": 0,<br />
"anzahlPosEtiketten": 0,<br />
"artikelBTNNr": "",<br />
"artikelEAN": "",<br />
"artikelEinheit": "",<br />
"artikelGewicht": 0,<br />
"artikelGruppe": "",<br />
"artikelMenge": 0,<br />
"artikelServices": "",<br />
"artikelSollMenge": 0,<br />
"artikelText1": "",<br />
"artikelText2": "",<br />
"artikelText3": "",<br />
"artikelText4": "",<br />
"artikelVolumen": 0,<br />
"artikelWaehrung": "",<br />
"artikelWert": 0,<br />
"chargeFlag": "",<br />
"kundenArtikelNr": "",<br />
"kundenBestellNr": "",<br />
"posAuftragNr": "",<br />
"posLieferNr": "",<br />
"positionNr": "",<br />
"serienNr": "",<br />
"ursprungLand": ""<br />
}<br />
],<br />
"auftragNr": "",<br />
"auftraggeberID": "",<br />
"avisHinweis1": "",<br />
"avisHinweis2": "",<br />
"avisZusatz1": "",<br />
"avisZusatz2": "",<br />
"bestellNr": "",<br />
"druckername": "",<br />
"email": "",<br />
"faxNr": "",<br />
"frachtBrief": "",<br />
"frachtfuehrerKdNr": "",<br />
"freiAvis1": "",<br />
"freiAvis2": "",<br />
"frankaturKennung": "",<br />
"gefahrgut": [<br />
{<br />
"gefahrgutBefoerdKat": 0,<br />
"gefahrgutBegrenzteMenge": "",<br />
"gefahrgutBezeichnung": "",<br />
"gefahrgutBuchst640": "",<br />
"gefahrgutFFCode": "",<br />
"gefahrgutFaktor": 0,<br />
"gefahrgutFreigestMenge": "",<br />
"gefahrgutKCode": "",<br />
"gefahrgutKlasse": "",<br />
"gefahrgutMenge": 0,<br />
"gefahrgutMengenEinheit": "",<br />
"gefahrgutNebenGefahr": "",<br />
"gefahrgutNettoExplMasse": 0,<br />
"gefahrgutTunnelBCode": "",<br />
"gefahrgutUNNR": "",<br />
"gefahrgutUmweltGef": "",<br />
"gefahrgutVPG": "",<br />
"gefahrgutVerpAnzahl": 0,<br />
"gefahrgutVerpackungsart": ""<br />
}<br />
],<br />
"gewicht": 0,<br />
"ilnNr": "",<br />
"infotext1": "",<br />
"infotext2": "",<br />
"infotext3": "",<br />
"infotext4": "",<br />
"infotext5": "",<br />
"infotext6": "",<br />
"infotext7": "",<br />
"infotext8": "",<br />
"infotext9": "",<br />
"infotext10": "",<br />
"kostenstelle": "",<br />
"kundenNr": "",<br />
"lieferscheinNr": "",<br />
"nachnahme": 0,<br />
"nettoGewicht": 0,<br />
"neutabsenderLKZ": "",<br />
"neutabsenderName1": "",<br />
"neutabsenderName2": "",<br />
"neutabsenderName3": "",<br />
"neutabsenderOrt": "",<br />
"neutabsenderPLZ": "",<br />
"neutabsenderStrasse": "",<br />
"nnVermerk": "",<br />
"nnVerwendung": "",<br />
"nnWaehrung": "",<br />
"packStkGes": 0,<br />
"packStkNr": 0,<br />
"packplatz": "",<br />
"packstueckBreite": 0,<br />
"packstueckHoehe": 0,<br />
"packstueckID": "",<br />
"packstueckLaenge": 0,<br />
"paperlessInvoice": "",<br />
"postLeitcode": "",<br />
"postZielFrachtzent": "",<br />
"rechnungsEmpfLKZ": "",<br />
"rechnungsEmpfName1": "",<br />
"rechnungsEmpfName2": "",<br />
"rechnungsEmpfName3": "",<br />
"rechnungsEmpfOrt": "",<br />
"rechnungsEmpfPLZ": "",<br />
"rechnungsEmpfStrasse": "",<br />
"sendungsinhalt": "",<br />
"sonderdienste": "",<br />
"telefonNr": "",<br />
"terminArt": "",<br />
"terminDatum": "",<br />
"terminZeit": "",<br />
"ustIDNr": "",<br />
"verpackungsart": "",<br />
"versandartID": "",<br />
"versicherungswert": 0,<br />
"vwWaehrung": "",<br />
"warenwert": 0,<br />
"wwWaehrung": "",<br />
"zahlungsbedingung": "",<br />
"zbZoll": "",<br />
"zielAdrBahnhof": "",<br />
"zielAdrLKZ": "",<br />
"zielAdrName1": "",<br />
"zielAdrName2": "",<br />
"zielAdrName3": "",<br />
"zielAdrOrt": "",<br />
"zielAdrPLZ": "",<br />
"zielAdrRegion": "",<br />
"zielAdrStrasse": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"assoc": {<br />
"": ""<br />
},<br />
"packstueckID": "",<br />
"trackingNr": "",<br />
"retourTrackingNr": "",<br />
"versandSendungsNr": "",<br />
"druckDateTime": {<br />
"year": 2023,<br />
"month": 0,<br />
"dayOfMonth": 25,<br />
"hourOfDay": 8,<br />
"minute": 59,<br />
"second": 22<br />
},<br />
"druckDateTimeString": "25.01.2023 08:59:22",<br />
"ausgangDateTime": {<br />
"year": 2023,<br />
"month": 0,<br />
"dayOfMonth": 25,<br />
"hourOfDay": 0,<br />
"minute": 0,<br />
"second": 0<br />
},<br />
"ausgangDateTimeString": "25.01.2023",<br />
"gebuehr": 0,<br />
"gebuehrWaehrung": "",<br />
"fehlertext1": "",<br />
"fehlertext2": "",<br />
"etikettName": "",<br />
"etikettDaten": "",<br />
"zusatzEtikettenDaten": {<br />
"": ""<br />
},<br />
"trackingURL": "",<br />
"zusatzfeld1": "",<br />
"zusatzfeld2": "",<br />
"zusatzfeld3": "",<br />
"zusatzfeld4": "",<br />
"zusatzfeld5": "",<br />
"zusatzfeld6": "",<br />
"zusatzfeld7": "",<br />
"zusatzfeld8": "",<br />
"zusatzfeld9": "",<br />
"zusatzfeld10": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE Beispiel ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ENDE versanddatenAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- versanddatenNachdruckAnfrage ------------------------------------------------------------------------------- --><br />
<br />
== Etikett nachdrucken (versanddatenNachdruckAnfrage) ==<br />
Die Gatewayfunktion versanddatenNachdruckAnfrage wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück nachzudrucken. Ein Etikett wird anhand der hostseitigen Packstück-ID nachgedruckt. Diese wird im Feld PackstueckID übergeben. Bei manchen Frachtführern (z.B. DPD) werden beim Nachdruck neue Trackingnummern vergeben. Somit ist die alte Trackingnummer nicht mehr gültig und das alte Versandetikett muss vernichtet werden. Die neue Trackingnummer kann in der Rückmeldung zurückgemeldet werden.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/versanddatenNachdruckAnfrage'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird.<br />
|-<br />
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.<br />
|-<br />
| '''packstueckID''' || [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.<br />
|-<br />
| trackingNr|| [[#Datentypen|String]] || 35 || - || Paketnummer<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum (Monat ist 0-basierend), wann das Etikett an den Frachtführer übermittelt worden ist<br />
|-<br />
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)<br />
|-<br />
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum (Monat ist 0-basierend), wann das Etikett im HVS32 gedruckt worden ist<br />
|-<br />
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)<br />
|-<br />
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts<br />
|-<br />
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten<br />
|-<br />
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode<br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage<br />
|-<br />
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure<br />
|-<br />
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer<br />
|-<br />
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung<br />
|-<br />
| versandSendungsNr || [[#Datentypen|String]] || - || - || -<br />
|-<br />
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map<br />
|-<br />
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"druckername": "",<br />
"packplatz": "",<br />
"packstueckID": "",<br />
"trackingNr": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"assoc": {<br />
"": ""<br />
},<br />
"packstueckID": "",<br />
"trackingNr": "",<br />
"retourTrackingNr": "",<br />
"versandSendungsNr": "",<br />
"druckDateTime": {<br />
"year": 2023,<br />
"month": 0,<br />
"dayOfMonth": 25,<br />
"hourOfDay": 8,<br />
"minute": 59,<br />
"second": 22<br />
},<br />
"druckDateTimeString": "25.01.2023 08:59:22",<br />
"ausgangDateTime": {<br />
"year": 2023,<br />
"month": 0,<br />
"dayOfMonth": 25,<br />
"hourOfDay": 0,<br />
"minute": 0,<br />
"second": 0<br />
},<br />
"ausgangDateTimeString": "25.01.2023",<br />
"gebuehr": 0,<br />
"gebuehrWaehrung": "",<br />
"fehlertext1": "",<br />
"fehlertext2": "",<br />
"etikettName": "",<br />
"etikettDaten": "",<br />
"zusatzEtikettenDaten": {<br />
"": ""<br />
},<br />
"trackingURL": "",<br />
"zusatzfeld1": "",<br />
"zusatzfeld2": "",<br />
"zusatzfeld3": "",<br />
"zusatzfeld4": "",<br />
"zusatzfeld5": "",<br />
"zusatzfeld6": "",<br />
"zusatzfeld7": "",<br />
"zusatzfeld8": "",<br />
"zusatzfeld9": "",<br />
"zusatzfeld10": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE versanddatenNachdruckAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- stornoVersanddaten ------------------------------------------------------------------------------- --><br />
<br />
== Packstück stornieren (stornoVersanddaten) ==<br />
Die Gatewayfunktion stornoVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort bestehende Packstücke zu stornieren, die noch nicht auf einer Ausgangsliste sind. In der Regel wird ein Packstück anhand der hostseitigen Packstück-ID storniert. Diese wird im Feld PackstueckID übergeben. Zusätzlich zur hostseitigen Packstück-ID kann auch die TrackingNr zur Identifikation des Packstücks beitragen, für den Fall, dass die hostseitige Packstück-ID keine Eindeutigkeit garantieren kann. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Storno wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/stornoVersanddaten'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.<br />
|-<br />
| '''packstueckID'''|| [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.<br />
|-<br />
| trackingNr|| [[#Datentypen|String]] || 35 || - || Paketnummer<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"packplatz": "",<br />
"packstueckID": "",<br />
"trackingNr": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"fehlertext2": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE stornoversanddaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- verladeVersandaten ------------------------------------------------------------------------------- --><br />
== Packstück verladen / freigeben (verladeVersanddaten) ==<br />
Die Gatewayfunktion verladeVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort Packstücke für den Ausgang frei zu geben. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreicher Freigabe wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/verladeVersanddaten'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| hostFreigabeNr || [[#Datentypen|String]] || 20 || - || Hostseitige Freigabenummer die für dieses Packstück gesetzt wird.<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.<br />
|-<br />
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. <br><br />
Beim Etikettendruck zuvor muss die gleiche ID übergeben worden sein, damit das HVS32 das zu verladene Packstück eindeutig identifizieren kann.<br />
|-<br />
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"hostFreigabeNr": "",<br />
"packplatz": "",<br />
"packstueckID": "",<br />
"wechselbruecke": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"fehlertext2": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE verladeVersandaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- sperreVersanddaten ------------------------------------------------------------------------------- --><br />
<br />
== Packstück sperren (sperreVersanddaten) ==<br />
Die Gatewayfunktion sperreVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort Packstücke für den Ausgang zu sperren. Gesperrte Packstücke, werden für den Tagesabschluss nicht berücksichtigt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreicher Sperrung wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/sperreVersanddaten'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.<br />
|-<br />
| '''packstueckID'''|| [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"packplatz": "",<br />
"packstueckID": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"fehlertext2": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE sperreversanddaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- tagesabschluss ------------------------------------------------------------------------------- --><br />
<br />
== Tagesabschluss (tagesabschluss) ==<br />
Das Gateway sendet die tagesabschluss-Anfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit ein Tagesabschluss anhand der zusätzlich übergebenen Parameter ausgelöst. Der Tagesabschluss setzt sich aus den Punkten Ausgangsliste erzeugen und Frachtführer DFÜ erzeugen zusammen. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt. Standardmäßig sind alle Packstücke freigegeben, außer sie wurden durch das Erweiterungsmodul Ausgangsscannung gesperrt. Die Rückmeldung im HVS32 findet nach dem Ausführen des Tagesabschluss statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Tagesabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/tagesabschluss'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| auftraggeberID || [[#Datentypen|Sequence<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Auftraggebern mitgegeben werden. Es können n-Auftraggeber abgeschlossen werden.<br />
(Option MultiAGTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
|assoc<br />
|[[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]])<br />
| -<br />
| -<br />
|Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.<br />
(Benötigt Druckerspooler Erweiterungsmodul)<br />
|-<br />
| frachtfuehrerTyp || [[#Datentypen|Sequence<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.<br />
(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.<br />
|-<br />
| versandartID || [[#Datentypen|Sequence<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.<br />
(Option MultiVATagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] '''[[#Sequence|<EDIStatus>]]''' || - || - || -<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.<br />
|-<br />
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Etiketten als Key/Value Map.<br />
|-<br />
| ausgangsListeNr|| [[#Datentypen|Sequence<String>]] || - || - || Ausgangslisten-Nummer(n) der erzeugten Ausgangsliste(n).<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"auftraggeberID": [<br />
""<br />
],<br />
"assoc": {<br />
"":""<br />
},<br />
"druckername": "",<br />
"frachtfuehrerTyp": [<br />
""<br />
],<br />
"packplatz": "",<br />
"versandartID": [<br />
""<br />
],<br />
"wechselbruecke": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"assoc": {<br />
"":""<br />
},<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"edistatus": [<br />
{<br />
"fehlercode": 0,<br />
"statuscode": "",<br />
"statustext": "",<br />
"fftyp": "",<br />
"dateityp": "",<br />
"auftraggeber": "",<br />
"ffdateinr": ""<br />
}<br />
],<br />
"listenDaten": {},<br />
"ausgangsListeNr": [<br />
"75"<br />
]<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE tagesabschluss ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- listenabschlussAnfrage ------------------------------------------------------------------------------- --><br />
<br />
== Ausgangsliste erzeugen (listenabschlussAnfrage) ==<br />
Das Gateway sendet die listenabschlussAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine Ausgangsliste anhand der zusätzlich übergebenen Parameter erzeugt. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Listenabschluss berücksichtigt. Standardmäßig sind alle Packstücke freigegeben, außer sie wurden durch das Erweiterungsmodul Ausgangsscannung gesperrt. Die Rückmeldung im HVS32 findet nach dem Erzeugen der Ausgangsliste statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Listenabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/listenabschlussAnfrage'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| auftraggeberID || [[#Datentypen|String]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Auftraggebern mitgegeben werden. Es können n-Auftraggeber abgeschlossen werden.<br />
(Option MultiAGTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.<br />
(Benötigt Druckerspooler Erweiterungsmodul)<br />
|-<br />
| frachtfuehrerTyp || [[#Datentypen|String]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.<br />
(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.<br />
|-<br />
| versandartID || [[#Datentypen|String]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.<br />
(Option MultiVATagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.<br />
|-<br />
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Etiketten als Key/Value Map.<br />
|-<br />
| ausgangsListeNr|| [[#Datentypen|Sequence<String>]] || - || - || Ausgangslisten-Nummer(n) der erzeugten Ausgangsliste(n).<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"auftraggeberID": [<br />
""<br />
],<br />
"druckername": "",<br />
"frachtfuehrerTyp": [<br />
""<br />
],<br />
"packplatz": "",<br />
"versandartID": [<br />
""<br />
],<br />
"wechselbruecke": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"assoc": {<br />
"":""<br />
},<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"listenDaten": {<br />
"": ""<br />
},<br />
"ausgangsListeNr": [<br />
"75"<br />
]<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE Listenabschluss ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ListenNachdruck------------------------------------------------------------------------------- --><br />
<br />
== Ausgangsliste nachdrucken (listenNachdruckAnfrage) ==<br />
Das Gateway sendet die listenNachdruckAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine bereits erstellte Ausgangsliste anhand der übergebenen ausgangsListeNr anchgedruckt. Eine Liste kann nur nachgedruckt werden, wenn diese bereits über die Funktionen tagesabschluss, listenabschlussAnfrage oder manuell über die HVS32 Maske erzeugt wurde. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Listenabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/listenNachdruckAnfrage'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| ausgangsListeNr || [[#Datentypen|Sequence<String>]] || - || - || Liste der Ausgangslisten-Nr. der Listen, die nachgedruckt werden sollen.<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.<br />
(Benötigt Druckerspooler Erweiterungsmodul)<br />
|-<br />
| auftraggeberID || [[#Datentypen|Sequence<String>]] || - || - || Liste der Auftraggerber-ID's, für welche die Listen nachgedruckt werden sollen.<br />
|-<br />
| frachtFuehrerTyp || [[#Datentypen|Sequence<String>]] || - || - || Liste der Frachtführertypen, für welche die Listen nachgedruckt werden sollen.<br />
|-<br />
| erstellDatum || [[#Datentypen|String]] || 10 || - || Erstelldatum der Ausgangslisten, die nachgedruckt werden sollen. Im Format "dd.mm.yyyy", z.B. 01.01.2001<br />
|-<br />
| druckDatum || [[#Datentypen|String]] || 10 || - || Druckdatum der Ausgangslisten, die nachgedruckt werden sollen. Im Format "dd.mm.yyyy", z.B. 01.01.2001 oder null wenn nur Listen nachgedruckt werden sollen, die noch nicht gedruckt wurden<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| ausgangsListeNr || [[#Datentypen|Sequence<String>]] || - || - || Liste der Ausgangslisten-Nr. der Listen, die nachgedruckt wurden.<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.<br />
|-<br />
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Etiketten als Key/Value Map.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"ausgangsListeNr": [<br />
"77"<br />
],<br />
"druckername": "",<br />
"auftraggeberID": [], <br />
"frachtFuehrerTyp": [], <br />
"erstellDatum": "", <br />
"druckDatum": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"ausgangsListeNr": [<br />
"77"<br />
]<br />
"assoc": {<br />
"":""<br />
},<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"listenDaten": {<br />
"": ""<br />
}<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE ListenNachdruck ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ediabschlussAnfrage ------------------------------------------------------------------------------- --><br />
<br />
== Frachtführer DFÜ erzeugen (ediabschlussAnfrage) ==<br />
Das Gateway sendet die ediabschlussAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine Frachtführer DFÜ anhand der zusätzlich übergebenen Parameter erzeugt und (falls konfiguriert) an den Frachtführer übertragen. Nur Packstücke, für welche zuvor eine Ausgangsliste erzeugt wurde, werden für eine Frachtführer DFÜ berücksichtigt. Die Rückmeldung im HVS32 findet nach dem Erzeugen der Frachtführer DFÜ statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem EDIAbschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/ediabschlussAnfrage'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| auftraggeberID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Auftraggebern mitgegeben werden. Es können n-Auftraggeber abgeschlossen werden.<br />
(Option MultiAGTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den z.B. die UPS Summary gedruckt wird.<br><br />
(Benötigt Druckerspooler Erweiterungsmodul)<br />
|-<br />
| frachtfuehrerTyp || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.<br />
(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.<br />
|-<br />
| versandartID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.<br />
(Option MultiVATagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] [[#edistatus|<EDIStatus>]] || - || - || Liste mit Statusinformationen für EDIs.<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der EDI-Listen (z.B. UPS Summary) als Key/Value Map.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"auftraggeberID": [<br />
""<br />
],<br />
"druckername": "",<br />
"frachtfuehrerTyp": [<br />
""<br />
],<br />
"packplatz": "",<br />
"versandartID": [<br />
""<br />
],<br />
"wechselbruecke": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"assoc": {<br />
"":""<br />
},<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"edistatus": [<br />
{<br />
"fehlercode": 0,<br />
"statuscode": "",<br />
"statustext": "",<br />
"fftyp": "",<br />
"dateityp": "",<br />
"auftraggeber": "",<br />
"ffdateinr": ""<br />
}<br />
],<br />
"listenDaten": {}<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE ediabschlussAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- versanddatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
<br />
== Packstückdaten prüfen (versanddatenPruefAnfrage) ==<br />
Das Gateway sendet die versanddatenPruefAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine VersandDatenAnfrage simuliert. Dabei werden keine Etiketten gedruckt und das Packstück bzw. das Etikett wird nicht verbucht, jedoch sind alle weiteren Prozesse identisch zur VersandDatenAnfrage (Routenermittlung, Trackingnummer-Ermittlung, Adressprüfung, etc.) Diese Funktion dient dazu im Vorfeld alle Versand-Daten zu validieren.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/versanddatenPruefAnfrage'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner<br />
|-<br />
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| auftragNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32<br />
|-<br />
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisZusatz1 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 1<br />
|-<br />
| avisZusatz2 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 2<br />
|-<br />
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)<br />
|-<br />
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)<br />
|-<br />
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers<br />
|-<br />
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse<br />
|-<br />
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll<br />
|-<br />
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer<br />
|-<br />
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -<br />
|-<br />
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)<br />
|-<br />
| '''gewicht''' ||[[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG<br />
|-<br />
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)<br />
|-<br />
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| kostenstelle || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender<br />
|-<br />
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet<br />
|-<br />
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG<br />
|-<br />
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck<br />
|-<br />
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck<br />
|-<br />
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode<br />
|-<br />
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung<br />
|-<br />
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.<br />
|-<br />
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm<br />
|-<br />
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm<br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.<br />
|-<br />
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm<br />
|-<br />
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)<br />
|-<br />
| postLeitcode || [[#Datentypen|String]] || 15 || - || -<br />
|-<br />
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -<br />
|-<br />
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer<br />
|-<br />
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt<br />
|-<br />
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers<br />
|-<br />
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix<br />
|-<br />
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers<br />
|-<br />
| verpackungsart || [[#Datentypen|String]] || 6 || - || -<br />
|-<br />
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32<br />
|-<br />
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert<br />
|-<br />
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode<br />
|-<br />
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode<br />
|-<br />
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort<br />
|-<br />
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse<br />
|-<br />
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse<br />
|-<br />
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)<br />
|-<br />
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|-<br />
|-<br />
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum (Monat ist 0-basierend), wann das Etikett im HVS32 gedruckt worden ist<br />
|-<br />
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"ansprechpartner": "",<br />
"artikelDaten": [<br />
{<br />
"anzahlBuegel": 0,<br />
"anzahlPosEtiketten": 0,<br />
"artikelBTNNr": "",<br />
"artikelEAN": "",<br />
"artikelEinheit": "",<br />
"artikelGewicht": 0,<br />
"artikelGruppe": "",<br />
"artikelMenge": 0,<br />
"artikelServices": "",<br />
"artikelSollMenge": 0,<br />
"artikelText1": "",<br />
"artikelText2": "",<br />
"artikelText3": "",<br />
"artikelText4": "",<br />
"artikelVolumen": 0,<br />
"artikelWaehrung": "",<br />
"artikelWert": 0,<br />
"chargeFlag": "",<br />
"kundenArtikelNr": "",<br />
"kundenBestellNr": "",<br />
"posAuftragNr": "",<br />
"posLieferNr": "",<br />
"positionNr": "",<br />
"serienNr": "",<br />
"ursprungLand": ""<br />
}<br />
],<br />
"auftragNr": "",<br />
"auftraggeberID": "",<br />
"avisHinweis1": "",<br />
"avisHinweis2": "",<br />
"avisZusatz1": "",<br />
"avisZusatz2": "",<br />
"bestellNr": "",<br />
"druckername": "",<br />
"email": "",<br />
"faxNr": "",<br />
"frachtBrief": "",<br />
"frachtfuehrerKdNr": "",<br />
"frankaturKennung": "",<br />
"gefahrgut": [<br />
{<br />
"gefahrgutBefoerdKat": 0,<br />
"gefahrgutBegrenzteMenge": "",<br />
"gefahrgutBezeichnung": "",<br />
"gefahrgutBuchst640": "",<br />
"gefahrgutFFCode": "",<br />
"gefahrgutFaktor": 0,<br />
"gefahrgutFreigestMenge": "",<br />
"gefahrgutKCode": "",<br />
"gefahrgutKlasse": "",<br />
"gefahrgutMenge": 0,<br />
"gefahrgutMengenEinheit": "",<br />
"gefahrgutNebenGefahr": "",<br />
"gefahrgutNettoExplMasse": 0,<br />
"gefahrgutTunnelBCode": "",<br />
"gefahrgutUNNR": "",<br />
"gefahrgutUmweltGef": "",<br />
"gefahrgutVPG": "",<br />
"gefahrgutVerpAnzahl": 0,<br />
"gefahrgutVerpackungsart": ""<br />
}<br />
],<br />
"gewicht": 0,<br />
"ilnNr": "",<br />
"infotext1": "",<br />
"infotext2": "",<br />
"infotext3": "",<br />
"infotext4": "",<br />
"infotext5": "",<br />
"infotext6": "",<br />
"infotext7": "",<br />
"infotext8": "",<br />
"infotext9": "",<br />
"infotext10": "",<br />
"kostenstelle": "",<br />
"kundenNr": "",<br />
"lieferscheinNr": "",<br />
"nachnahme": 0,<br />
"nettoGewicht": 0,<br />
"neutabsenderLKZ": "",<br />
"neutabsenderName1": "",<br />
"neutabsenderName2": "",<br />
"neutabsenderName3": "",<br />
"neutabsenderOrt": "",<br />
"neutabsenderPLZ": "",<br />
"neutabsenderStrasse": "",<br />
"nnVermerk": "",<br />
"nnVerwendung": "",<br />
"nnWaehrung": "",<br />
"packStkGes": 0,<br />
"packStkNr": 0,<br />
"packplatz": "",<br />
"packstueckBreite": 0,<br />
"packstueckHoehe": 0,<br />
"packstueckID": "",<br />
"packstueckLaenge": 0,<br />
"paperlessInvoice": "",<br />
"postLeitcode": "",<br />
"postZielFrachtzent": "",<br />
"rechnungsEmpfLKZ": "",<br />
"rechnungsEmpfName1": "",<br />
"rechnungsEmpfName2": "",<br />
"rechnungsEmpfName3": "",<br />
"rechnungsEmpfOrt": "",<br />
"rechnungsEmpfPLZ": "",<br />
"rechnungsEmpfStrasse": "",<br />
"sendungsinhalt": "",<br />
"sonderdienste": "",<br />
"telefonNr": "",<br />
"terminArt": "",<br />
"terminDatum": "",<br />
"terminZeit": "",<br />
"ustIDNr": "",<br />
"verpackungsart": "",<br />
"versandartID": "",<br />
"versicherungswert": 0,<br />
"vwWaehrung": "",<br />
"warenwert": 0,<br />
"wwWaehrung": "",<br />
"zahlungsbedingung": "",<br />
"zbZoll": "",<br />
"zielAdrBahnhof": "",<br />
"zielAdrLKZ": "",<br />
"zielAdrName1": "",<br />
"zielAdrName2": "",<br />
"zielAdrName3": "",<br />
"zielAdrOrt": "",<br />
"zielAdrPLZ": "",<br />
"zielAdrRegion": "",<br />
"zielAdrStrasse": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"druckDateTime": {<br />
"year": 2023,<br />
"month": 0,<br />
"dayOfMonth": 25,<br />
"hourOfDay": 8,<br />
"minute": 59,<br />
"second": 22<br />
},<br />
"druckDateTimeString": "25.01.2023 08:59:22",<br />
"fehlertext1": "",<br />
"fehlertext2": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE versanddatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- updateVersanddaten ------------------------------------------------------------------------------- --><br />
<br />
== Packstückdaten aktualisieren (updateVersanddaten) ==<br />
Die Gatewayfunktion updateVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort die Daten von bestehende Packstücken zu verändern. Diese Anfrage wird zum Beispiel gesendet, wenn der Warenwert für ein Packstück erst zu einem späteren Zeitpunkt bekannt ist. Aktualisiert werden können Daten innerhalb der Tabellen Versandeinheit, Abrechnungseinheit und Lieferung. Dabei wird stets über das Feld PackstueckID und bei Belegung auch über das Feld TrackingNr gesucht.<br><br><br />
'''Bei dieser Anfrage werden allerdings die zu aktualisierenden Felder und Inhalte nicht mehr nach den Richtlinien des Frachtführers geprüft (z.B. Gewichtsgrenzen, etc.). Es muss somit vom Vorsystem sichergestellt werden, dass die aktualisierenden Werte mit den Richtlinien des Frachtführers übereinstimmen. Sollte dies nicht möglich sein, kann diese Funktion nicht genutzt werden, sondern das Etikett muss storniert und neu verarbeitet werden. Außerdem können Felder, welche bereits auf einem Etikett angedruckt oder vom Versandsystem HVS32 in einer Frachtführerabwicklung ermittelt wurden (z.B. Adresse, Route, TrackingNr, Sonderdienste, etc.) nicht manipuliert werden.'''<br><br><br />
<br />
'''ACHTUNG: Alle Felder, welche im Versandsystem aktualisiert werden sollen, müssen vor der Nutzung dieser Funktion abgestimmt und im Versandsystem entsprechend konfiguriert werden!'''<br><br><br />
<br />
Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Update wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/updateVersanddaten'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner<br />
|-<br />
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)<br />
|-<br />
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| auftragNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32<br />
|-<br />
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisZusatz1 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 1<br />
|-<br />
| avisZusatz2 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 2<br />
|-<br />
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)<br />
|-<br />
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)<br />
|-<br />
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers<br />
|-<br />
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers<br />
|-<br />
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse<br />
|-<br />
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll<br />
|-<br />
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer<br />
|-<br />
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -<br />
|-<br />
| freiAvis1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| freiAvis2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)<br />
|-<br />
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG<br />
|-<br />
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem<br />
|-<br />
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)<br />
|-<br />
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| kostenstelle || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender<br />
|-<br />
| lagerkennzeichen || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)<br />
|-<br />
| lieferantenID || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet<br />
|-<br />
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG<br />
|-<br />
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck<br />
|-<br />
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck<br />
|-<br />
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode<br />
|-<br />
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung<br />
|-<br />
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.<br />
|-<br />
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm<br />
|-<br />
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm<br />
|-<br />
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.<br />
|-<br />
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm<br />
|-<br />
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)<br />
|-<br />
| postLeitcode || [[#Datentypen|String]] || 15 || - || -<br />
|-<br />
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -<br />
|-<br />
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer<br />
|-<br />
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt<br />
|-<br />
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren<br />
|-<br />
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers<br />
|-<br />
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix<br />
|-<br />
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers<br />
|-<br />
| verpackungsart || [[#Datentypen|String]] || 6 || - || -<br />
|-<br />
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32<br />
|-<br />
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert<br />
|-<br />
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode<br />
|-<br />
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird<br />
|-<br />
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode<br />
|-<br />
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort<br />
|-<br />
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse<br />
|-<br />
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse<br />
|-<br />
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)<br />
|-<br />
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum (Monat ist 0-basierend), wann das Etikett an den Frachtführer übermittelt worden ist<br />
|-<br />
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)<br />
|-<br />
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum (Monat ist 0-basierend), wann das Etikett im HVS32 gedruckt worden ist<br />
|-<br />
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)<br />
|-<br />
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts<br />
|-<br />
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten<br />
|-<br />
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode<br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage<br />
|-<br />
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure<br />
|-<br />
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer<br />
|-<br />
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung<br />
|-<br />
| versandSendungsNr || [[#Datentypen|String]] || - || - || -<br />
|-<br />
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map<br />
|-<br />
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"absenderAdresseID": "",<br />
"ansprechpartner": "",<br />
"assoc": {<br />
"Key": "Value"<br />
},<br />
"artikelDaten": [<br />
{<br />
"anzahlBuegel": 0,<br />
"anzahlPosEtiketten": 0,<br />
"artikelBTNNr": "",<br />
"artikelEAN": "",<br />
"artikelEinheit": "",<br />
"artikelGewicht": 0,<br />
"artikelGruppe": "",<br />
"artikelMenge": 0,<br />
"artikelServices": "",<br />
"artikelSollMenge": 0,<br />
"artikelText1": "",<br />
"artikelText2": "",<br />
"artikelText3": "",<br />
"artikelText4": "",<br />
"artikelVolumen": 0,<br />
"artikelWaehrung": "",<br />
"artikelWert": 0,<br />
"chargeFlag": "",<br />
"kundenArtikelNr": "",<br />
"kundenBestellNr": "",<br />
"posAuftragNr": "",<br />
"posLieferNr": "",<br />
"positionNr": "",<br />
"serienNr": "",<br />
"ursprungLand": ""<br />
}<br />
],<br />
"auftragNr": "",<br />
"auftraggeberID": "",<br />
"avisHinweis1": "",<br />
"avisHinweis2": "",<br />
"avisZusatz1": "",<br />
"avisZusatz2": "",<br />
"bestellNr": "",<br />
"druckername": "",<br />
"email": "",<br />
"faxNr": "",<br />
"frachtBrief": "",<br />
"frachtfuehrerKdNr": "",<br />
"freiAvis1": "",<br />
"freiAvis2": "",<br />
"frankaturKennung": "",<br />
"gefahrgut": [<br />
{<br />
"gefahrgutBefoerdKat": 0,<br />
"gefahrgutBegrenzteMenge": "",<br />
"gefahrgutBezeichnung": "",<br />
"gefahrgutBuchst640": "",<br />
"gefahrgutFFCode": "",<br />
"gefahrgutFaktor": 0,<br />
"gefahrgutFreigestMenge": "",<br />
"gefahrgutKCode": "",<br />
"gefahrgutKlasse": "",<br />
"gefahrgutMenge": 0,<br />
"gefahrgutMengenEinheit": "",<br />
"gefahrgutNebenGefahr": "",<br />
"gefahrgutNettoExplMasse": 0,<br />
"gefahrgutTunnelBCode": "",<br />
"gefahrgutUNNR": "",<br />
"gefahrgutUmweltGef": "",<br />
"gefahrgutVPG": "",<br />
"gefahrgutVerpAnzahl": 0,<br />
"gefahrgutVerpackungsart": ""<br />
}<br />
],<br />
"gewicht": 0,<br />
"ilnNr": "",<br />
"infotext1": "",<br />
"infotext2": "",<br />
"infotext3": "",<br />
"infotext4": "",<br />
"infotext5": "",<br />
"infotext6": "",<br />
"infotext7": "",<br />
"infotext8": "",<br />
"infotext9": "",<br />
"infotext10": "",<br />
"kostenstelle": "",<br />
"kundenNr": "",<br />
"lieferscheinNr": "",<br />
"nachnahme": 0,<br />
"nettoGewicht": 0,<br />
"neutabsenderLKZ": "",<br />
"neutabsenderName1": "",<br />
"neutabsenderName2": "",<br />
"neutabsenderName3": "",<br />
"neutabsenderOrt": "",<br />
"neutabsenderPLZ": "",<br />
"neutabsenderStrasse": "",<br />
"nnVermerk": "",<br />
"nnVerwendung": "",<br />
"nnWaehrung": "",<br />
"packStkGes": 0,<br />
"packStkNr": 0,<br />
"packplatz": "",<br />
"packstueckBreite": 0,<br />
"packstueckHoehe": 0,<br />
"packstueckID": "",<br />
"packstueckLaenge": 0,<br />
"paperlessInvoice": "",<br />
"postLeitcode": "",<br />
"postZielFrachtzent": "",<br />
"rechnungsEmpfLKZ": "",<br />
"rechnungsEmpfName1": "",<br />
"rechnungsEmpfName2": "",<br />
"rechnungsEmpfName3": "",<br />
"rechnungsEmpfOrt": "",<br />
"rechnungsEmpfPLZ": "",<br />
"rechnungsEmpfStrasse": "",<br />
"sendungsinhalt": "",<br />
"sonderdienste": "",<br />
"telefonNr": "",<br />
"terminArt": "",<br />
"terminDatum": "",<br />
"terminZeit": "",<br />
"ustIDNr": "",<br />
"verpackungsart": "",<br />
"versandartID": "",<br />
"versicherungswert": 0,<br />
"vwWaehrung": "",<br />
"warenwert": 0,<br />
"wwWaehrung": "",<br />
"zahlungsbedingung": "",<br />
"zbZoll": "",<br />
"zielAdrBahnhof": "",<br />
"zielAdrLKZ": "",<br />
"zielAdrName1": "",<br />
"zielAdrName2": "",<br />
"zielAdrName3": "",<br />
"zielAdrOrt": "",<br />
"zielAdrPLZ": "",<br />
"zielAdrRegion": "",<br />
"zielAdrStrasse": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"packstueckID": "",<br />
"trackingNr": "",<br />
"retourTrackingNr": "",<br />
"versandSendungsNr": "",<br />
"druckDateTime": {<br />
"year": 2023,<br />
"month": 0,<br />
"dayOfMonth": 25,<br />
"hourOfDay": 8,<br />
"minute": 59,<br />
"second": 22<br />
},<br />
"druckDateTimeString": "25.01.2023 08:59:22",<br />
"ausgangDateTime": {<br />
"year": 2023,<br />
"month": 0,<br />
"dayOfMonth": 25,<br />
"hourOfDay": 0,<br />
"minute": 0,<br />
"second": 0<br />
},<br />
"ausgangDateTimeString": "25.01.2023",<br />
"gebuehrWaehrung": "",<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"fehlertext2": "",<br />
"etikettName": "",<br />
"etikettDaten": "",<br />
"trackingURL": "",<br />
"zusatzfeld1": "",<br />
"zusatzfeld2": "",<br />
"zusatzfeld3": "",<br />
"zusatzfeld4": "",<br />
"zusatzfeld5": "",<br />
"zusatzfeld6": "",<br />
"zusatzfeld7": "",<br />
"zusatzfeld8": "",<br />
"zusatzfeld9": "",<br />
"zusatzfeld10": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE updateVersanddaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- anonymisiereVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
== Packstückdaten anonymisieren (anonymisiereVersandDaten) ==<br />
Das Gateway sendet die anonymisiereVersandDaten an das Automatik-Polling des HVS32. Im HVS32 werden somit Kunden bezogene Daten für den entsprechenden Datensatz gemäß DSGVO anonymisiert. Diese Anonymisierung wird unwiderruflich und endgültig auf der Datenbankebene des Versandsystems durchgeführt. Eine Wiederherstellung der ursprünglichen Daten ist somit nicht mehr möglich. Log-Dateien, Rückmelde-Dateien, bereits übertragene Frachtführer DFÜs etc. sind hiervon nicht betroffen. Es können ausschließlich Packstücke und Sendungen anonymisiert werden, welche bereits Tages abgeschlossen sind.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/anonymisiereVersandDaten'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Nachkommastellen !! Belegung<br />
|-<br />
| auftragsNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet.<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.<br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.<br />
|-<br />
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Nachkommastellen !! Belegung<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"auftragNr": "",<br />
"lieferscheinNr": "",<br />
"packplatz": "",<br />
"packstueckID": "",<br />
"trackingNr": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"fehlertext1": "",<br />
"fehlertext2": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE anonymisiereVersandDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- sendungsdatenAnfrage ------------------------------------------------------------------------------- --><br />
<br />
== Sendungs-Verarbeitung (sendungsdatenAnfrage) ==<br />
sendungsdatenAnfrage – wird zur Laufzeit in einzelne [[#versandDatenAnfragen|versandDatenAnfragen]] unterteilt. Muss bei einer Anfrage für das [[Shipment_Policy_Manager_(Tarifwerk)|SPM]] genutzt werden (requestSPM=TRUE)<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Funktion (POST) || /hvs32rest/sendungsdatenAnfrage'''<br />
|-<br />
| '''MediaType || application/json; text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| auftragNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32<br />
|-<br />
| ausschlussFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Ausschluss-Frachtführer für SPM Anfrage<br />
|-<br />
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisZusatz1 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 1<br />
|-<br />
| avisZusatz2 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 2<br />
|-<br />
| bestellNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| email || [[#Datentypen|String]] || 100 || - || Für automatische Mailavisierung<br />
|-<br />
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers<br />
|-<br />
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers<br />
|-<br />
| flexZustellungEmailadResponsese || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Email-Adresse<br />
|-<br />
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer, falls Frachtbrief durch Vorsystem gedruckt wird.<br />
|-<br />
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer.<br />
|-<br />
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -<br />
|-<br />
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)<br />
|-<br />
| kostenstelle || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender<br />
|-<br />
| Lagerkennzeichen || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG --><br />
|-<br />
| LieferantenID || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG --><br />
|-<br />
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet.<br />
|-<br />
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung<br />
|-<br />
| [[#packStueckDaten|packStueckDaten]] || [[#Datentypen|Sequence]] [[#packStueckDaten|<PackStueckDaten>]] || - || - || -<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.<br />
|-<br />
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)<br />
|-<br />
| postLeitcode || [[#Datentypen|String]] || 15 || - || -<br />
|-<br />
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -<br />
|-<br />
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse<br />
|-<br />
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer<br />
|-<br />
| requestSPM || [[#Datentypen|String]] || 5 || - || T/TRUE wenn die Entscheidungsmatrix angesprochen werden soll, sonst leer<br />
|-<br />
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt<br />
|-<br />
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren<br />
|-<br />
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers<br />
|-<br />
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix<br />
|-<br />
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| terminZeit || [[#Datentypen|String]] || 5 || - || HH:MM<br />
|-<br />
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers<br />
|-<br />
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32<br />
|-<br />
| vorgabeFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Vorgabe-Frachtführer für [[Shipment_Policy_Manager_(Tarifwerk)|SPM]] Anfrage<br />
|-<br />
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen werden soll<br />
|-<br />
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort des Bahnhofs<br />
|-<br />
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Länderkennzeichen (LKZ)<br />
|-<br />
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse<br />
|-<br />
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)<br />
|-<br />
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| fehler || [[#Datentypen|String]] || - || - || Wird im Fehlerfall befüllt<br />
|-<br />
| sendungsGebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachkosten<br />
|-<br />
| sendungsGebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode<br />
|-<br />
| versandSendungsNr || [[#Datentypen|String]] || 20 || - || Sendungsnummer<br />
|}<br />
<br />
;Packstückdaten<br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)<br />
|-<br />
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum (Monat ist 0-basierend), wann das Etikett an den Frachtführer übermittelt worden ist<br />
|-<br />
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)<br />
|-<br />
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum (Monat ist 0-basierend), wann das Etikett im HVS32 gedruckt worden ist<br />
|-<br />
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)<br />
|-<br />
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts<br />
|-<br />
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten<br />
|-<br />
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode<br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage<br />
|-<br />
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure<br />
|-<br />
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer<br />
|-<br />
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung<br />
|-<br />
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map<br />
|-<br />
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|-<br />
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"ansprechpartner": "",<br />
"assoc": {<br />
"":""<br />
},<br />
"auftragNr": "",<br />
"auftraggeberID": "",<br />
"ausschlussFrachtfuehrer": "",<br />
"avisHinweis1": "",<br />
"avisHinweis2": "",<br />
"avisZusatz1": "",<br />
"avisZusatz2": "",<br />
"bestellNr": "",<br />
"email": "",<br />
"empfMobilfunkNr": "",<br />
"faxNr": "",<br />
"flexZustellungEmailadResponsese": "",<br />
"frachtBrief": "",<br />
"frachtfuehrerKdNr": "",<br />
"frankaturKennung": "",<br />
"ilnNr": "",<br />
"kostenstelle": "",<br />
"kundenNr": "",<br />
"Lagerkennzeichen": 0,<br />
"LieferantenID": 0,<br />
"lieferscheinNr": "",<br />
"neutBIC": "",<br />
"neutBankBezeichnung": "",<br />
"neutIBAN": "",<br />
"neutKontoInhaber": "",<br />
"neutabsenderLKZ": "",<br />
"neutabsenderName1": "",<br />
"neutabsenderName2": "",<br />
"neutabsenderName3": "",<br />
"neutabsenderOrt": "",<br />
"neutabsenderPLZ": "",<br />
"neutabsenderStrasse": "",<br />
"packStkGes": 0,<br />
"packStueckDaten": [<br />
{<br />
"anzahlArtikel": 0,<br />
"assoc": {<br />
"":""<br />
},<br />
"artikelDaten": [<br />
{<br />
"anzahlBuegel": 0,<br />
"anzahlPosEtiketten": 0,<br />
"artikelBTNNr": "",<br />
"artikelEAN": "",<br />
"artikelEinheit": "",<br />
"artikelGewicht": 0,<br />
"artikelGruppe": "",<br />
"artikelMenge": 0,<br />
"artikelServices": "",<br />
"artikelSollMenge": 0,<br />
"artikelText1": "",<br />
"artikelText2": "",<br />
"artikelText3": "",<br />
"artikelText4": "",<br />
"artikelVolumen": 0,<br />
"artikelWaehrung": "",<br />
"artikelWert": 0,<br />
"chargeFlag": "",<br />
"kundenArtikelNr": "",<br />
"kundenBestellNr": "",<br />
"posAuftragNr": "",<br />
"posLieferNr": "",<br />
"positionNr": "",<br />
"serienNr": "",<br />
"ursprungLand": ""<br />
}<br />
],<br />
"barcodeID": "",<br />
"barcodeText": "",<br />
"barcodeTyp": "",<br />
"druckername": "",<br />
"gefahrgut": [<br />
{<br />
"gefahrgutBefoerdKat": 0,<br />
"gefahrgutBegrenzteMenge": "",<br />
"gefahrgutBezeichnung": "",<br />
"gefahrgutBuchst640": "",<br />
"gefahrgutFFCode": "",<br />
"gefahrgutFaktor": 0,<br />
"gefahrgutFreigestMenge": "",<br />
"gefahrgutKCode": "",<br />
"gefahrgutKlasse": "",<br />
"gefahrgutMenge": 0,<br />
"gefahrgutMengenEinheit": "",<br />
"gefahrgutNebenGefahr": "",<br />
"gefahrgutNettoExplMasse": 0,<br />
"gefahrgutTunnelBCode": "",<br />
"gefahrgutUNNR": "",<br />
"gefahrgutUmweltGef": "",<br />
"gefahrgutVPG": "",<br />
"gefahrgutVerpAnzahl": 0,<br />
"gefahrgutVerpackungsart": ""<br />
}<br />
],<br />
"gewicht": 0,<br />
"hostTrackingNr": "",<br />
"infotext1": "",<br />
"infotext10": "",<br />
"infotext2": "",<br />
"infotext3": "",<br />
"infotext4": "",<br />
"infotext5": "",<br />
"infotext6": "",<br />
"infotext7": "",<br />
"infotext8": "",<br />
"infotext9": "",<br />
"letztesPackstueck": "",<br />
"nachnahme": 0,<br />
"nettoGewicht": 0,<br />
"nnVermerk": "",<br />
"nnVerwendung": "",<br />
"nnWaehrung": "",<br />
"packStkNr": 0,<br />
"packstueckBreite": 0,<br />
"packstueckHoehe": 0,<br />
"packstueckID": "",<br />
"packstueckLaenge": 0,<br />
"verpackungsart": "",<br />
"versicherungswert": 0,<br />
"vwWaehrung": "",<br />
"warenwert": 0,<br />
"wwWaehrung": ""<br />
}<br />
],<br />
"packplatz": "",<br />
"paperlessInvoice": "",<br />
"postLeitcode": "",<br />
"postZielFrachtzent": "",<br />
"rechnungsEmpfLKZ": "",<br />
"rechnungsEmpfName1": "",<br />
"rechnungsEmpfName2": "",<br />
"rechnungsEmpfName3": "",<br />
"rechnungsEmpfOrt": "",<br />
"rechnungsEmpfPLZ": "",<br />
"rechnungsEmpfStrasse": "",<br />
"rechnungsNr": "",<br />
"requestSPM": "",<br />
"sendungsinhalt": "",<br />
"sonderdienste": "",<br />
"sperrFlag": "",<br />
"telefonNr": "",<br />
"terminArt": "",<br />
"terminDatum": "",<br />
"terminZeit": "",<br />
"ustIDNr": "",<br />
"versandartID": "",<br />
"vorgabeFrachtfuehrer": "",<br />
"vorpackdatum": "",<br />
"wechselbruecke": "",<br />
"zahlungsbedingung": "",<br />
"zbZoll": "",<br />
"zielAdrBahnhof": "",<br />
"zielAdrLKZ": "",<br />
"zielAdrName1": "",<br />
"zielAdrName2": "",<br />
"zielAdrName3": "",<br />
"zielAdrName4": "",<br />
"zielAdrOrt": "",<br />
"zielAdrPLZ": "",<br />
"zielAdrRegion": "",<br />
"zielAdrStrasse": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"versandSendungsNr": "",<br />
"sendungsGebuehrWaehrung": "",<br />
"fehler": "",<br />
"packStueckDaten": [<br />
{<br />
"assoc": {<br />
"": ""<br />
},<br />
"packstueckID": "",<br />
"trackingNr": "",<br />
"retourTrackingNr": "",<br />
"druckDateTime": {<br />
"year": 2023,<br />
"month": 0,<br />
"dayOfMonth": 25,<br />
"hourOfDay": 8,<br />
"minute": 59,<br />
"second": 22<br />
},<br />
"druckDateTimeString": "25.01.2023 08:59:22",<br />
"ausgangDateTime": {<br />
"year": 2023,<br />
"month": 0,<br />
"dayOfMonth": 25,<br />
"hourOfDay": 0,<br />
"minute": 0,<br />
"second": 0<br />
},<br />
"ausgangDateTimeString": "25.01.2023",<br />
"gebuehrWaehrung": "",<br />
"fehlertext1": "",<br />
"fehlertext2": "",<br />
"etikettName": "",<br />
"etikettDaten": "",<br />
"zusatzEtikettenDaten": {<br />
"": ""<br />
},<br />
"trackingURL": "",<br />
"zusatzfeld1": "",<br />
"zusatzfeld2": "",<br />
"zusatzfeld3": "",<br />
"zusatzfeld4": "",<br />
"zusatzfeld5": "",<br />
"zusatzfeld6": "",<br />
"zusatzfeld7": "",<br />
"zusatzfeld8": "",<br />
"zusatzfeld9": "",<br />
"zusatzfeld10": ""<br />
}<br />
]<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE sendungsdatenAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- --><br />
<br />
= Beispiele =<br />
Alle JSON Beispiele finden Sie auch hier: [[REST_Beispiel|REST SERVER JSON Beispiele]]</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Schnittstellen:_Security_Levels_und_Authentifizierung&diff=5900
Schnittstellen: Security Levels und Authentifizierung
2024-09-03T10:32:30Z
<p>Bhauser: </p>
<hr />
<div>[[en:Interfaces:_Security_Levels_and_Authentication]]<br />
<br />
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.<br>Wenn das Versandsystem HVS32 allerdings öffentlich erreichbar sein muss - also sich das Vorsystem (ERP/WMS) und das Versandsystem HVS32 nicht im gleichen Netzwerk (LAN, vLAN, vNET, private cloud) befinden - muss die Kommunikations-Verbindung der beiden Systeme abgesichert werden.<br>Dies impliziert, dass sowohl die Verbindung verschlüsselt als auch jede eingehende Verbindung authentifiziert werden muss.<br><br />
<br />
=Security Levels (Infrastruktur)=<br />
Zur Absicherung der Netzwerk-Brücke gibt es keine zu 100% perfekte oder sichere Lösung. Meist muss man sich für einen Kompromiss je nach Fall entscheiden. In der Infrastruktur können jedoch bereits diverse Security Levels implementiert werden, um die Sicherheit maßgeblich zu erhöhen.<br />
==LAN / vLAN / vNET / private cloud / VPN==<br />
Befinden sich die beiden Server in einem gemeinsamen Netzwerk, bzw. liegt eine gesicherte Netzwerk-Brücke via VPN zu Grunde, bietet dies grundlegend die beste Basis für eine sichere Datenkommunikation zwischen dem Vorsystem und dem Versandsystem HVS32.<br>[[Datei:Securitylevel infrastructure vpn.png|1000px|rahmenlos|Security Level (Infrastruktur) - LAN / vLAN / vNET / private cloud / VPN]]<br><br><br />
<br />
==S2S (Server-to-Server)==<br />
Bei einer ungesicherten Netzwerk-Brücke ist unbedingt darauf zu achten, dass die Kommunikation ausschließlich verschlüsselt und authentifiziert stattfindet.<br />
[[Datei:Securitylevel infrastructure s2s.png|1000px|rahmenlos|Security Level (Infrastruktur) - S2S (Server-to-Server)]]<br />
==Dead-End-Server==<br />
Da alle Verbindungen zum DGS (DataGatewayServer - Kommunikations-/Schnittstellen-Software) eingehend sind, kann als zusätzliche Sicherheitsmaßnahme der DGS auf einem separaten Server installiert werden, bei welchem alle ausgehenden Verbindungen via Firewall blockiert werden.<br />
[[Datei:Securitylevel infrastructure des.png|1000px|rahmenlos|Security Level (Infrastruktur) - Dead-End-Server]]<br />
<br />
=Authentifizierung=<br />
Authentifizierungs-Mechanismen können nur als "sicher" bezeichnet werden, wenn diese in Kombination mit anderen Sicherheits-Mechanismen wie HTTPS/SSL genutzt werden. Die Verschlüsselung ist mittels HTTPS unter Verwendung von TLSv1.2 oder TLSv1.3 (sofern vom Client unterstützt) möglich.<br><br />
<br />
Die folgenden Authentifizierungs-Optionen beziehen sich '''ausschließlich''' auf die [https://interface.heidler-strichcode.de?version=v2 RESTv2 Schnittstelle]<br />
<br>Es wird '''mindestens''' die DataGatewayServer Version '''3.8.31''' benötigt.<br />
==Basic Authentication==<br />
Die Basisauthentifizierung ist ein einfaches Authentifizierungsschema, welches in das HTTP-Protokoll integriert ist. Der Client sendet in jeder HTTP-Anfrage den Authentifizierungsheader, welcher Benutzername und Passwort enthält.<br />
<br />
Der Authentifizierungsheader lautet '''Authorization''' und beinhaltet den Benutzer und das Passwort Base64 codiert im Format ''- Basic <Benutzer>:<Passwort>''.<br />
<br />
<br />
<br />
Die Benutzerverwaltung erfolgt im DataGatewayServer. Dort können neue Benutzer angelegt und gelöscht werden.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen Benutzern steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für eine Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In diesem Beispiel wird der Benutzer ''heidler'' mit dem Passwort ''Wolfschlugen'' verwendet.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Authorization: Basic aGVpZGxlcjpXb2xmc2NobHVnZW4=<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung - 401 Unauthorized</div><br />
<div class="mw-collapsible-content"><br />
Sollte die Authentifizierung aufgrund von ungültigen Benutzerdaten fehlschlagen, so wird der HTTP-Code '''401 Unauthorized''' mit der Fehlermeldung ''"Unauthorized acces"'' im Body quittiert.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Www-authenticate: Basic realm="Restricted Area"<br />
Date: Mon, 26 Feb 2024 09:00:44 GMT<br />
Content-type: application/json<br />
Content-length: 19<br />
<br />
Unauthorized access<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==Digest Access Authentication==<br />
HTTP Digest Access Authentication ist ein Authentifizierungsmechanismus, der in das HTTP-Protokoll integriert ist und dazu dient, die Sicherheit von Webanwendungen zu erhöhen. Im Gegensatz zur einfachen Basisauthentifizierung überträgt Digest Access Authentication keine Benutzernamen und Passwörter im Klartext, sondern verwendet kryptografisch sichere Methoden.<br><br />
<br />
Bei der Digest-Authentifizierung sendet der Client eine Anfrage an den Server (ohne Authentifizierung im Header), der daraufhin eine "Nonce" (eine einmalige Zufallszahl) zurückgibt. Alternativ kann diese über den Enpoint ''v2/hsc/auth/digest'' abgerufen werden. Der Client kombiniert diese Nonce mit Benutzername, Passwort, Anfrage-Methode und URI und erstellt einen "Digest" (Prüfzusammenstellung). Dieser Digest wird dann an den Server gesendet.<br>Der Server kann den Digest überprüfen, indem er denselben Algorithmus auf der Serverseite anwendet und die berechneten Werte vergleicht. Da der Digest mit Hilfe der Nonce und kryptografisch sicheren Techniken erstellt wird, schützt die Digest-Authentifizierung effektiv vor Angriffen wie Passwortdiebstahl und Mann-in-the-Middle-Angriffen (MitM).<br />
<br />
Für die Erstellung vom Digest wird aktuell nur der Algorithmus MD5 unterstützt. Weitere Algorithmusverfahren können nach Rücksprache implementiert werden.<br />
<br />
<br />
<br />
Die Benutzerverwaltung erfolgt im DataGatewayServer. Dort können neue Benutzer angelegt und gelöscht werden.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen Benutzern steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Anfrage einer nonce für die Erstellung des Digest</div><br />
<div class="mw-collapsible-content"><br />
In der initialen Anfrage wird im Header keine Authentifizierung geliefert, da vom Server zuerst die nonce abgefragt werden muss. In der Rückmeldung vom DataGatewayServer befindet sich dann die '''nonce''' zusammen mit weiteren Informationen, welche für die Erstellung eines Digest benötigt werden, im HTTP-Header '''Www-authenticate'''.<br><br />
<br />
Diese Anfrage wird mit dem HTTP-Code '''401 Unauthorized''' und der Fehlermeldung ''"Authentication required!"'' im Body quittiert.<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Www-authenticate: Digest realm="Restricted Area",qop="auth",nonce="079ae550-11c1-40bf-9ee9-7cce5f1dd70e",opaque="opaque"<br />
Date: Mon, 26 Feb 2024 10:21:41 GMT<br />
Content-type: application/json<br />
Content-length: 24<br />
<br />
Authentication required!<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Anfrage nach erhaltener nonce</div><br />
<div class="mw-collapsible-content"><br />
Nachdem der Client die '''nonce, realm, qop und die opaque''' aus der initialen Anfrage extrahiert und damit den Digest generiert hat, kann dieser für die Authentifizierung über den HTTP-Header '''Authorization''' übermittelt werden.<br />
<br />
Das Format entspricht dabei:<br>''Digest username="<BENUTZERNAME>", realm="<REALM>", nonce="<NONCE>", uri="<ENDPOINT>", algorithm="MD5", qop=<QOP>, nc=<NC>, cnonce="<CNONCE>", response="<DIGEST>", opaque="<OPAQUE>"''<br><br>Der Parameter '''nc''' = "Nonce count" und '''cnonce''' = "Client nonce" wird jeweils vom Client generiert und muss für die Erstellung vom Digest genutzt werden.<br />
<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Cache-Control: no-cache<br />
Authorization: Digest username="<BENUTZER>", realm="Restricted Area", nonce="079ae550-11c1-40bf-9ee9-7cce5f1dd70e", uri="<ENDPOINT>", algorithm="MD5", qop=auth, nc=00000001, cnonce="PoYGQC6K", response="ce3fb921e353290142e34ac886694a4c", opaque="opaque"<br />
</syntaxhighlight><br />
</div></div><br />
<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung</div><br />
<div class="mw-collapsible-content"><br />
Bei einer ungültigen Authentifizierung (Verwendung vom HTTP-Header '''Authorization''') wird der HTTP-Code '''401 Unauthorized''' mit der Fehlermeldung ''"client credentials invalid!"'' im Body zurück gemeldet.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 10:45:40 GMT<br />
Content-type: application/json<br />
Content-length: 27<br />
<br />
client credentials invalid!<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==API Keys==<br />
Die API-Key-Authentifizierung ist eine einfache Methode zur Sicherung von API-Zugriffen. Bei dieser Authentifizierungsmethode erhält der Benutzer / Client einmalig einen eindeutigen API-Schlüssel (API-Key). Dieser Schlüssel muss dann bei jeder API-Anfrage im Header mit gesendet werden.<br>Der Server überprüft den empfangenen API-Key, um sicherzustellen, dass die Anfrage von einem authentifizierten Benutzer oder Anwendung stammt.<br><br />
<br />
Der API-Key muss sicher aufbewahrt werden, um unbefugten Zugriff zu verhindern. Außerdem ist es wichtig, diesen regelmäßig zu zu aktualisieren, um die Sicherheit zu gewährleisten.<br />
<br />
<br />
<br />
Der API-Key wird im DataGatewayServer verwaltet. Dort kann ein neuer Key generiert oder bestehende gelöscht werden. Es können mehrere gültige API-Keys existieren.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen API-Keys steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für eine Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In diesem Beispiel wird der API-Key ''apikey_heidler'' verwendet.<br />
<br />
'''Hinweis:''' Aus demonstrationszwecken wird in dem Beispiel ein einfacher API-Key verwendet. Der DataGatewayServer erzeugt einen entsprechend langen und komplexen Key.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
x-api-key: apikey_heidler<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung</div><br />
<div class="mw-collapsible-content"><br />
Bei einem falschen API-Key wird der HTTP-Code '''401 Unauthorized''' mit der Fehlermeldung ''"api key invalid!"'' im Body zurück gemeldet.<br />
<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 09:46:30 GMT<br />
Content-type: application/json<br />
Content-length: 16<br />
<br />
api key invalid!<br />
</syntaxhighlight><br />
</div></div><br />
<br />
==OAuth 2.0==<br />
===Client Credentials===<br />
OAuth 2.0 Client Credentials ist eine Authentifizierungs-Methode im OAuth 2.0-Protokoll, die es einer Anwendung ermöglicht, sich beim Authorization Server (Authentifizierungsserver) zu authentifizieren. Dies ist besonders nützlich für den Zugriff von Anwendungen auf APIs ohne Benutzerbeteiligung und eignet sich gut für server-seitige Kommunikation zwischen Diensten.<br />
<br />
<br>Das ERP wird am Server registriert und erhält eine eindeutige Client-ID und ein Client-Secret.<br>Inital wird dann von dem ERP eine HTTP-POST-Anfrage an den Authorization Server gesendet, welche die Client-Anmeldeinformationen (Client-ID und Client-Secret) beinhaltet. Im Response wird ein Access-Token und ein Refresh-Token zurück gemeldet.<br>Das ERP sendet nun für die Authentifizierung bei jeder Anfrage das Access-Token im Authorization Header der HTTP-Anfragen mit. Wenn das Access-Token abgelaufen ist, kann mit dem Refresh-Token ein neuer Access-Token angefragt werden. Im Falle einer mehrfachen Nutzung eines Refresh-Tokens werden automatisch alle Refresh-Tokens und Access-Tokens gesperrt.<br>Das Client-Secret muss sicher aufbewahrt werden, um unbefugten Zugriff zu verhindern. Außerdem ist es wichtig, das Client Secret regelmäßig zu zu aktualisieren, um die Sicherheit weiter zu erhöhen.<br />
<br />
<br />
<br />
Die Client-ID und Client-Secret werden im DataGatewayServer verwaltet. Dort können neue Zugangsdaten angelegt oder bestehende gelöscht werden.<br />
<br />
'''Hinweis:''' Mit zunehmender Anzahl von gültigen Client-IDs steigt auch die Wahrscheinlichkeit, dass sich durch eine "Brute-Force-Attacke" unerlaubter Zugriff gewährt wird.<br><br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispiel für die Token-Anfrage (Access- und Refreshtoken mit Client-ID + Client-Secret generieren)</div><br />
<div class="mw-collapsible-content"><br />
Bei der Token-Anfrage muss die Client-ID und das Client-Secret im HTTP-Header '''Authorization''' Base64 codiert im Format - ''Basic <ClientID>:<ClientSecret>'' übermittelt werden. Zusätzlich ist für diese Funktion der '''grant_type''' mit dem Wert ''client_credentials'' notwendig.<br />
<syntaxhighlight lang="http"><br />
POST /v2/hsc/auth/token HTTP/1.1<br />
Accept: application/json<br />
Authorization: Basic <ClientID>:<ClientSecret><br />
grant_type: client_credentials<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung der Token-Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In der Rückmeldung der Token-Anfrage wird im Body der Accesstoken (access_token), der Refreshtoken (refresh_token), der Tokentyp (token_type) und Gültigkeit vom Accesstoken in Sekunden (expires_in) zurück gemeldet.<br />
<br />
Der Accesstoken kann nun für die Authentifizierung in den restlichen Anfragen genutzt werden.<br />
<br />
<br />
Der Accesstoken hat aus Sicherheitsgründen eine begrenzte Gültigkeit. Nach Ablauf ist der Accesstoken nicht mehr verwendbar und man erhält einen HTTP-Code '''401 Unauthorized'''. In diesem Fall muss über die Refresh-Anfrage und einem gültigen Refreshtoken ein neuer Accesstoken generiert werden (empfohlen) oder über die Token-Anfrage und der Client-ID + Client-Secret ein neues Accesstoken angefragt werden (nicht empfohlen).<br />
<br />
'''Hinweis:''' Die regelmäßige Generierung von Accesstoken über die Token-Anfrage wird nicht empfohlen, da hier die Client-ID + Client-Secret übertragen wird. Dadurch ist die Anfälligkeit gegen MitM-Angriffen höher. Das Client-Secret sollte so selten wie möglich eingesetzt werden. <br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 200 OK<br />
Date: Mon, 26 Feb 2024 12:06:32 GMT<br />
Content-type: application/json<br />
Content-length: 711<br />
Cache-control: no-cache<br />
<br />
{<br />
"access_token": "eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk3OTIsImp0aSI6ImM0ZDFkNTdiLWUzZTAtNDkwOC1hMDk4LWJiMjc2NmZmODdiMSIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.4zrctPAnBAlMj9CFUL6jQ33Gkou3V_bmcLBUrEsUKL0",<br />
"refresh_token": "eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMxOTIsImp0aSI6IjEwMGZmN2JiLTQ1MzItNDFlNi05NTZjLTBjZjE0YWIzYTljNCIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.vAPo2Zobu2BNGNrUvmxKd5RVGWIn91sT83js33n2UUA",<br />
"token_type": "Bearer",<br />
"expires_in": 600<br />
}<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für die Nutzung eines Accesstokens</div><br />
<div class="mw-collapsible-content"><br />
Der aus der Token-Anfrage erhaltene Accesstoken kann nun im HTTP-Header '''Authorization''' an den DataGatewayServer übermittelt werden, um sich zu authentifizieren. Dieser muss im Format - ''Bearer <Accesstoken>'' übertragen werden.<br />
<syntaxhighlight lang="http"><br />
POST <ENDPOINT> HTTP/1.1<br />
Content-Type: application/json<br />
Accept: application/json<br />
Authorization: Bearer eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk3OTIsImp0aSI6ImM0ZDFkNTdiLWUzZTAtNDkwOC1hMDk4LWJiMjc2NmZmODdiMSIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.4zrctPAnBAlMj9CFUL6jQ33Gkou3V_bmcLBUrEsUKL0<br />
Cache-Control: no-cache<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispielheader für die Refresh-Anfrage (Access- und Refreshtoken mit gültigem Refreshtoken erneuern)</div><br />
<div class="mw-collapsible-content"><br />
Falls ein Accesstoken abgelaufen ist und dieser erneut werden muss, kann über die Refresh-Anfrage und einem gültigen Refreshtoken ein neuer Accesstoken + Refreshtoken generiert werden. In dieser Anfrage muss der HTTP-Header '''refresh_token''' mit dem Refreshtoken und der Header '''grant_type''' mit dem Wert ''refresh_token'' übermittelt werden.<br />
<br />
Um die Sicherheit vor MitM-Angriffen zu erhöhen, empfiehlt es sich den Accesstoken regelmäßig und im kurzen intervall zu aktualisieren.<br />
<br />
'''Hinweis:''' Ein Refreshtoken kann nur einmalig für die Refreshanfrage genutzt werden. Anschließend verliert der Token seine Gültigkeit. Falls ein ungültiger Refreshtoken für die Authentifizierung beim DataGatewayServer genutzt wird, werden aus Sicherheitsgründen alle gültigen Access- und Refreshtoken deaktiviert. Die Authentifizierung muss in diesem Fall wieder über die Token-Anfrage stattfinden.<br />
<syntaxhighlight lang="http"><br />
POST /v2/hsc/auth/refresh HTTP/1.1<br />
Accept: application/json<br />
refresh_token: eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMxOTIsImp0aSI6IjEwMGZmN2JiLTQ1MzItNDFlNi05NTZjLTBjZjE0YWIzYTljNCIsInV1SUQiOiI0NTJiNWE4Ni1iZDRlLTRlNjktOGYxOC1hOGM5YWFlZTE1YzkiLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkxOTJ9.vAPo2Zobu2BNGNrUvmxKd5RVGWIn91sT83js33n2UUA<br />
grant_type: refresh_token<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung der Refresh-Anfrage</div><br />
<div class="mw-collapsible-content"><br />
In der Rückmeldung der Refresh-Anfrage wird im Body der Accesstoken (access_token), der Refreshtoken (refresh_token), der Tokentyp (token_type) und Gültigkeit vom Accesstoken (expires_in) in Sekunden zurück gemeldet.<br />
<br />
Der Accesstoken kann nun für die Authentifizierung in den restlichen Anfragen genutzt werden.<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 200 OK<br />
Date: Mon, 26 Feb 2024 12:06:43 GMT<br />
Content-type: application/json<br />
Content-length: 711<br />
<br />
{<br />
"access_token": "eyJ1c2FnZSI6IkFDQ0VTUyIsInR5cCI6IkpXVCIsImFsZyI6IkhTMjU2In0.eyJleHAiOjE3MDg5NDk4MDMsImp0aSI6ImJmYjgyZWE0LTU2NmEtNDc3ZS04NDRjLWRkM2VhYWZmZjQ1ZSIsInV1SUQiOiI0ZmY5ZThhNC01YTY2LTQ0ZDQtYjY4Zi1jNjlmMzFiOTNiYjciLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkyMDN9.vMoedyTSnfWXYXbGPZTX-nfhfNUAvp2upQJ3pTU-u_k",<br />
"refresh_token": "eyJ1c2FnZSI6IlJFRlJFU0giLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MDk4MTMyMDMsImp0aSI6IjI5MTc0NzBkLTNjYTUtNGZiMC1hZDliLThjNjkxYWVjNDYzOSIsInV1SUQiOiI0ZmY5ZThhNC01YTY2LTQ0ZDQtYjY4Zi1jNjlmMzFiOTNiYjciLCJzdWIiOiJvZCIsImlzcyI6IkhTQy1ER1MiLCJpYXQiOjE3MDg5NDkyMDN9.DonI4KsNiTuG6pb705U3QIT7tNnU0pmDS7Tp6UZWHVk",<br />
"token_type": "Bearer",<br />
"expires_in": 600<br />
}<br />
</syntaxhighlight><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung bei fehlgeschlagener Authentifizierung - 401 Unauthorized</div><br />
<div class="mw-collapsible-content"><br />
Sollte die Authentifizierung fehlschlagen, so wird der HTTP-Code 401 Unauthorized mit einer entsprechenden Fehlermeldung im Body quittiert.<br />
<syntaxhighlight lang="http"><br />
HTTP/1.1 401 Unauthorized<br />
Date: Mon, 26 Feb 2024 12:38:59 GMT<br />
Content-type: application/json<br />
Content-length: <LÄNGE><br />
<br />
<FEHLERMELDUNG><br />
</syntaxhighlight><br />
</div></div><br />
<br><br><br />
===Authorization Code===<br />
Diese Authentifizierungs-Methode ist ausschließlich über das Authentifzierungssystem [[IRIS_Cloudsystem|IRIS Cloudsystem]] möglich.<br />
<br />
==Client Credentials im DGS verwalten==<br />
Die Client Credentials werden im DataGatewayServer verwaltet. Dort können neue Zugangsdaten angelegt oder bestehende gelöscht werden.<br><br />
Dazu muss im Installationsverzeichnis des DataGatewayServer der Credentials-Configurator(.exe) gestartet werden.<br />
===Config===<br />
[[Datei:Authorization Credentials 001.png|mini|rechts|Credentials Configurator - config]]<br />
Hier können allgemeine Konfigurationen vorgenommen werden.<br />
* '''check invalid logins'''<br>Wenn diese Option aktiv ist, wird die Anzahl der ungültigen Authentifizierungen gezählt und nach '''max invalid logins''' innerhalb von '''timespan in seconds''' werden alle Credentials gesperrt<br />
* '''execute CODE RED for OAuth2.0 CC'''<br>Wenn diese Option bei der Nutzung von OAuth2.0 CC aktiv ist, wird bei mehrfachen verwenden eines REFRESH TOKENS ein '''CODE RED''' ausgelöst. Hierbei werden alle ACCESS und REFRESH TOKENS deaktiviert und es müssen neue Tokens via Client Credentials angefordert werden. Zusätzlich kann im DGS Konfigurator das Versenden einer E-Mail bei einem CODE RED konfiguriert werden.<br />
* '''Lock Credentials / Unlock credentials'''<br>Über diesen Button können alle Credentials gesperrt oder entsperrt werden. Wenn z.b. durch die Option '''check invalid logins''' alle Client Credentials gesperrt wurden, können diese somit wieder entsperrt werden. Diese Option greift sofort, ohne speichern.<br />
* Save<br>Mit diesem Button werden die Einstellungen und Credentials persistent gespeichert. Erst nach dem Speichern werden die Optionen und Credentials aktiv. Ein DGS Neustart ist nicht notwendig.<br />
===Credentials verwalten===<br />
[[Datei:Authorization Credentials 002.png|mini|rechts|Credentials Configurator - OAuth2.0 CC]]<br />
[[Datei:Authorization Credentials 003.png|mini|rechts|Enter Username / ClientID]]<br />
[[Datei:Authorization Credentials 004.png|mini|rechts|Show Credentials Dialog]]<br />
Um Ihre Credentials zu verwalten, wählen Sie den passenden Reiter zu Ihrer im DGS konfigurierten Authentifizierungs-Methode (z.B. OAuth2.0 CC)<br />
* '''add'''<br>Hier können Sie neue Credentials anlegen. Beachten Sie, dass das Passwort bzw. das Client-Secret nur einmalig in einem Dialog angezeigt wird. Kopieren Sie es daher in einen sicheren Platz und stellen Sie sicher, dass keine unautorisierten Personen darauf Zugriff haben.<br />
* '''change secret''' bzw. '''change password'''<br>Hier können Sie ein neues Passwort bzw. Client Secret vergeben. Wie bei der add Funktion, wird das Passwort bzw. das Client-Secret nur einmalig in einem Dialog angezeigt.<br />
* '''remove'''<br>Hier können die die ausgewählten Credentials entfernen.</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:Authorization_Credentials_004.png&diff=5899
Datei:Authorization Credentials 004.png
2024-09-03T10:32:08Z
<p>Bhauser: </p>
<hr />
<div>Show Credentials Dialog</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:Authorization_Credentials_003.png&diff=5898
Datei:Authorization Credentials 003.png
2024-09-03T10:31:26Z
<p>Bhauser: </p>
<hr />
<div>Enter ClientID / Username</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:Authorization_Credentials_002.png&diff=5897
Datei:Authorization Credentials 002.png
2024-09-03T10:30:36Z
<p>Bhauser: </p>
<hr />
<div>Credentials Configurator - OAuth2.0 CC</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=Datei:Authorization_Credentials_001.png&diff=5896
Datei:Authorization Credentials 001.png
2024-09-03T10:06:30Z
<p>Bhauser: </p>
<hr />
<div>Credentials Configurator - config</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_File_Schnittstelle_(Automatik-Polling)&diff=5770
HVS32 File Schnittstelle (Automatik-Polling)
2024-05-16T14:18:22Z
<p>Bhauser: /* Beispiele */</p>
<hr />
<div>[[en:HVS32 default interface]]<br />
<br />
= Voraussetzungen =<br />
<br />
Eine beliebige HVS-Version.<br />
<br />
= Funktionsbeschreibung =<br />
<br />
Diese Schnittstelle listet die am häufigsten verwendeten Felder auf und beschreibt die Positionen der Daten im Standard-Datei-Import. Das Format kann in Rücksprache mit Ihrem Ansprechpartner sehr flexibel erweitert und angepasst werden. Es wird eine Zeile pro Packstück erwartet, mehrere Packstücke dürfen in einer Datei enthalten sein.<br />
<br />
In einem spaltenbasierten Format geben die Felder "Von" und "Bis" die Positionen der Daten an, in einem Format wie CSV wird die Spalte "Nr." ausgewertet.<br />
<br />
= Sendungsdaten =<br />
<br />
Die Sendungsdaten geben die Eigenschaften eines Packstücks an.<br />
<br />
Erläuterung Spalte Pflicht: M= Must / O= Optional / C= Conditional (in Abhängigkeit der Carrier Belange)<br />
<br />
{| class="wikitable"<br />
|-<br />
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung<br />
|-<br />
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || M || 3 || "IMP" / "EXP"<br />
|-<br />
| || '''--- SENDUNGS-TEIL ---''' || || || || || || || ||<br />
|-<br />
| 2 || Kunden-Nummer || 4 || 13 || 10 || || A || O || 20 || Kdnr des Empfängers beim Versender<br />
|-<br />
| 3 || Empfänger-Name1 || 14 || 43 || 30 || || A || M || 50 || LIEFER-ADRESSE<br />
|-<br />
| 4 || Empfänger-Name2 || 44 || 73 || 30 || || A || O || 50 || EMPFÄNGER<br />
|-<br />
| 5 || Empfänger-Name3 || 74 || 103 || 30 || || A || O || 50 ||<br />
|-<br />
| 6 || Empfänger-Strasse || 104 || 133 || 30 || || A || M || 50 ||<br />
|-<br />
| 7 || Empfänger-LKZ || 134 || 136 || 3 || || A || M || 3 ||<br />
|-<br />
| 8 || Empfänger-PLZ || 137 || 146 || 10 || || A || M || 10 ||<br />
|-<br />
| 9 || Empfänger-Ort || 147 || 176 || 30 || || A || M || 50 ||<br />
|-<br />
| 10 || Empfänger-Region / Staat || 177 || 196 || 20 || || A || C || 20 || Staat/Provinz (z.B. für USA wichtig)<br />
|-<br />
| 11 || Empfänger-Bahnhof || 197 || 226 || 30 || || A || O || 30 || PLZ und Ort<br />
|-<br />
| 12 || Ansprechpartner Empfänger || 227 || 246 || 20 || || A || O || 50 ||<br />
|-<br />
| 13 || Telefon-Nummer Empfänger || 247 || 266 || 20 || || A || C || 30 ||<br />
|-<br />
| 14 || Fax-Nummer Empfänger || 267 || 286 || 20 || || A || O || 30 ||<br />
|-<br />
| 15 || Ust-ID-Nummer Empfänger || 287 || 306 || 20 || || A || O || 20 ||<br />
|-<br />
| 16 || ILN-Nummer Empfänger || 307 || 319 || 13 || || A || C || 13 || Pflicht bei Metro-Versand<br />
|-<br />
| 17 || Mandant (HVS32: "Auftraggeber_ID") || 320 || 327 || 8 || || A || M || 10 ||<br />
|-<br />
| 18 || Versandart (HVS32: "Versandart_ID") || 328 || 333 || 6 || || A || M || 10 || Pflicht bei Automatikpolling<br />
|-<br />
| 19 || AVIS-Hinweis 1 || 334 || 363 || 30 || || A || O || 30 ||<br />
|-<br />
| 20 || AVIS-Hinweis 2 || 264 || 393 || 30 || || A || O || 30 ||<br />
|-<br />
| 21 || AVIS-Zusatz 1 || 394 || 413 || 60 || || A || O || 20 || Zusatz zu Fest-AVIS-Schlüssel 1<br />
|-<br />
| 22 || AVIS-Zusatz 2 || 414 || 433 || 60 || || A || O || 20 || Zusatz zu Fest-AVIS-Schlüssel 2<br />
|-<br />
| 23 || Lieferschein-Nummer || 434 || 443 || 10 || 0 || A || M || 40 || Wird im VS als Such-Nummer verwendet<br />
|-<br />
| 24 || Auftrags-Nummer || 444 || 453 || 10 || || A || O || 50 ||<br />
|-<br />
| 25 || Bestell-Nummer || 454 || 473 || 20 || || A || O || 50 || Metro-Bestellnr (Metro-Versand)<br />
|-<br />
| 26 || Warenwert || 474 || 482 || 9 || 2 || N || C || 9 ||<br />
|-<br />
| 27 || Warenwert-Währung || 483 || 485 || 3 || || A || C || 3 || ISO-Währungscode <br />
|-<br />
| 28 || Nachnahme || 486 || 494 || 9 || 2 || N || C || 9 ||<br />
|-<br />
| 29 || Nachnahme-Währung || 495 || 497 || 3 || || A || C || 3 || ISO-Währungscode<br />
|-<br />
| 30 || Nachnahme-Vermerk || 498 || 498 || 1 || || A || C || 1 || 'B': Bar / 'V': Verrechnungsscheck<br />
|-<br />
| 31 || Nachnahme-Verwendungszweck || 499 || 518 || 20 || || A || C || 30 ||<br />
|-<br />
| 32 || Höher-Versicherungswert || 519 || 527 || 9 || 2 || N || C || 9 ||<br />
|-<br />
| 33 || Höher-Versicherungswert-Währung || 528 || 530 || 3 || || A || C || 3 || ISO-Währungscode<br />
|-<br />
| 34 || Frankatur-Kennung || 531 || 540 || 10 || || A || C || 10 ||<br />
|-<br />
| 35 || Zahlungsbedingung || 541 || 550 || 10 || || A || C || 10 || 'S':Sender,'R':Empfänger<br />
|-<br />
| 36 || Zahlungsbedingung Zoll/Steuern || 551 || 551 || 1 || || A || C || 1 || 'S':Sender,'R':Empfänger<br />
|-<br />
| 37 || Frachtführer-Kunden-Nr || 552 || 561 || 10 || || A || C || 20 || Kdnr des Frachtzahlers beim Frachtführer<br />
|-<br />
| 38 || Sonderdienst || 562 || 591 || 30 || || A || C || 30 || versandart-spezifisch belegt<br />
|-<br />
| 39 || Sendungs-Inhalt || 592 || 621 || 30 || || A || C || 30 ||<br />
|-<br />
| 40 || Termin-Art || 622 || 622 || 1 || || A || C || 1 || 'A'b / 'B'is / 'F'ix<br />
|-<br />
| 41 || Termin-Datum || 623 || 632 || 10 || || A || C || 10 || TT.MM.JJJJ<br />
|-<br />
| 42 || Termin-Zeit || 633 || 637 || 5 || || A || C || 5 || HH:MM<br />
|-<br />
| 43 || Neutral-Absender-Name1 || 638 || 667 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt<br />
|-<br />
| 44 || Neutral-Absender-Name2 || 668 || 697 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt<br />
|-<br />
| 45 || Neutral-Absender-Name3 || 698 || 727 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt<br />
|-<br />
| 46 || Neutral-Absender-Strasse || 728 || 757 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt<br />
|-<br />
| 47 || Neutral-Absender-LKZ || 758 || 760 || 3 || || A || O || 3 || Nur bei Neutral-Absendern belegt<br />
|-<br />
| 48 || Neutral-Absender-PLZ || 761 || 770 || 10 || || A || O || 10 || Nur bei Neutral-Absendern belegt<br />
|-<br />
| 49 || Neutral-Absender-Ort || 771 || 800 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt<br />
|-<br />
| 50 || Rechnungsempfänger-Name1 || 801 || 830 || 30 || || A || C || 50 || RECHNUNGSADRESSE<br />
|-<br />
| 51 || Rechnungsempfänger-Name2 || 831 || 860 || 30 || || A || O || 50 || EMPFÄNGER<br />
|-<br />
| 52 || Rechnungsempfänger-Name3 || 861 || 890 || 30 || || A || O || 50 ||<br />
|-<br />
| 53 || Rechnungsempfänger-Strasse || 891 || 920 || 30 || || A || C || 50 ||<br />
|-<br />
| 54 || Rechungsempfänger-LKZ || 921 || 923 || 3 || || A || C || 3 ||<br />
|-<br />
| 55 || Rechungsempfänger-PLZ || 924 || 933 || 10 || || A || C || 10 ||<br />
|-<br />
| 56 || Rechungsempfänger-Ort || 934 || 963 || 30 || || A || C || 50 ||<br />
|-<br />
| 57 || Post-Leitcode || 964 || 978 || 15 || || A || C || 15 ||<br />
|-<br />
| 58 || Post-Zielfrachtzentrum || 979 || 983 || 5 || || A || C || 5 ||<br />
|-<br />
| 59 || Frachtbrief-Nr || 984 || 1003 || 20 || || A || O || 20 || falls Fr.brief d. Vorsystem gedruckt<br />
|-<br />
| || '''--- PACKSTÜCK-TEIL ---''' || || || || || || || ||<br />
|-<br />
| 60 || Gewicht Brutto (kg) || 1004 || 1011 || 8 || 3 || N || M || 8 ||<br />
|-<br />
| 61 || Gewicht Netto (kg) || 1012 || 1019 || 8 || 3 || N || O || 8 ||<br />
|-<br />
| 62 || Packstück-Anzahl || 1020 || 1022 || 3 || 0 || N || C || 3 || Gesamt-Anzahl Colli der Sendung+J15<br />
|-<br />
| 63 || Packstück-Nummer || 1023 || 1025 || 3 || 0 || N || C || 3 || Laufende Nr pro Sendung<br />
|-<br />
| 64 || Verpackungsart || 1026 || 1031 || 6 || || A || C || 20 ||<br />
|-<br />
| 65 || Länge Packstück (cm) || 1032 || 1035 || 4 || 0 || N || C || 4 ||<br />
|-<br />
| 66 || Breite Packstück (cm) || 1036 || 1039 || 4 || 0 || N || C || 4 ||<br />
|-<br />
| 67 || Höhe Packstück (cm) || 1040 || 1043 || 4 || 0 || N || C || 4 ||<br />
|-<br />
| 68 || PackPlatz-Nr || 1044 || 1053 || 10 || || A || C || 10 || System, das den Auftrag verarbeiten soll<br />
|-<br />
| 69 || Hostseitige Packstück-ID || 1054 || 1068 || 15 || || A || C || 20 ||<br />
|-<br />
| || '''--- RÜCKMELDE-TEIL ---''' || || || || || || || ||<br />
|-<br />
| 70 || Paket-Nummer || 1069 || 1083 || 15 || || A || || 15 || Nummernkreis-Nr des Frachtführers<br />
|-<br />
| 71 || Tracking-Nummer || 1084 || 1113 || 30 || || A || || 30 ||<br />
|-<br />
| 72 || Druck-Datum || 1114 || 1123 || 10 || || A || || 10 || Datum der Abarbeitung (TT.MM.CCJJ)<br />
|-<br />
| 73 || Versand-Datum || 1124 || 1133 || 10 || || A || || 10 || Datum der Versendung(TT.MM.CCJJ)<br />
|-<br />
| 74 || Fracht-Gebühr || 1134 || 1141 || 8 || 2 || N || || 8 || Frachtkosten<br />
|-<br />
| 75 || Währung Fracht-Gebühr || 1142 || 1144 || 3 || || A || || 3 || ISO-Währungscode<br />
|-<br />
| 76 || Status || 1145 || 1149 || 5 || || A || || 5 ||<br />
|-<br />
| 77 || Ladelisten-Nummer || 1150 || 1153 || 4 || || A || || 4 ||<br />
|-<br />
| || '''--- STEUERUNGS-TEIL ---''' || || || || || || || ||<br />
|-<br />
| 78 || IMPStatus || 1154 || 1154 || 1 || || A || || 1 || 'L':Löschsatz,'F':Fehlersatz, sonst Leer<br />
|-<br />
| 79 || Fehlertext || 1155 || 1214 || 60 || || A || || 60 || Fehler bei Eingangs-Plausi-Prüfung<br />
|-<br />
| 80 || Gefahrgut-Status || 1215 || 1217 || 3 || || A || || 3 || Für int. Kommunikation, nach Absprache<br />
|-<br />
| 81 || ReferenzNr || 1218 || 1237 || 20 || || A || || 20 || Für int. Kommunikation, nach Absprache<br />
|-<br />
| || '''--- Zusatz - Teil ---''' || || || || || || || ||<br />
|-<br />
| 82 || Broker-Name || 1238 || 1262 || 25 || || A || C || 25 ||<br />
|-<br />
| 83 || Broker-Telefonnummer || 1263 || 1282 || 20 || || A || C || 20 ||<br />
|-<br />
| 84 || Hold-At-Location J/N || 1283 || 1283 || 1 || || A || C || 1 || 'J': ja, 'N' oder Blank: Nein<br />
|-<br />
| 85 || Hold-At-Location Telefon || 1284 || 1303 || 20 || || A || C || 20 || Mit Telefonnummer belegt<br />
|-<br />
| 86 || Hold-At-Location Ansprechpartner || 1304 || 1333 || 30 || || A || C || 30 || Mit einem Ansprechpartner belegt<br />
|-<br />
| || '''--- Zusatz - HVS32 ---''' || || || || || || || ||<br />
|-<br />
| 87 || AnzahlArtikel || 1334 || 1339 || 6 || || || O || 6 || Anzahl Artikel (Druck auf Etikett)<br />
|-<br />
| 88 || ZusatzZeile1 || 1340 || 1369 || 30 || || || O || 30 || Zusatztext (Druck auf Etikett)<br />
|-<br />
| 89 || ZusatzZeile2 || 1370 || 1399 || 30 || || || O || 30 || Zusatztext (Druck auf Etikett)<br />
|-<br />
| 90 || Frei-AVIS1 || 1400 || 1461 || 62 || || A || O || 62 ||<br />
|-<br />
| 91 || Frei-AVIS2 || 1462 || 1523 || 62 || || A || O || 62 ||<br />
|-<br />
| 92 || Status "Elektronik-Artikel" J/N || 1524 || 1524 || 1 || || A || O || 1 || 'J'/'T'(True): Elektronik-Artikel, ansonsten nicht<br />
|-<br />
| 93 || Empfänger-Emailadresse || 1525 || 1604 || 80 || || A || O || 80 || f. automatische Mailavisierung<br />
|-<br />
| 94 || Kostenstelle || 1605 || 1634 || 30 || || A || O || 30 ||<br />
|-<br />
| 95 || Druckername || 1635 || 1664 || 30 || || A || O || 30 || Name eines Ausgabekanals im HVS32<br />
|-<br />
| 96 || CR/LF || 1665 || 1666 || 2 || || || M || 2 || Carriage Return/Line Feed<br />
|}<br />
<br />
= Artikeldaten =<br />
<br />
Die Artikeldaten geben die Eigenschaften eines Artikels an. Ein Packstück kann mehrere Artikel beinhalten.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung<br />
|-<br />
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || M || || Festeintrag "ART"<br />
|-<br />
| 2 || Lieferschein-Nr || 4 || 13 || 10 || || A || M || || nicht Pflicht im Dateipolling mit Vormerkdaten<br />
|-<br />
| 3 || Packstück-Nr || 14 || 16 || 3 || || N || C || || nicht Pflicht im Dateipolling mit Vormerkdaten<br />
|-<br />
| 4 || Positions-Nr || 17 || 26 || 10 || 0 || N || M || ||<br />
|-<br />
| 5 || Artikel-Nr || 27 || 76 || 50 || || A || O || ||<br />
|-<br />
| 6 || Artikel-Bezeichnung 1 || 77 || 176 || 100 || || A || M || ||<br />
|-<br />
| 7 || Artikel-Bezeichnung 2 || 177 || 276 || 100 || || A || O || ||<br />
|-<br />
| 8 || Artikel-Netto-Gewicht (je Masseinheit) || 277 || 285 || 9 || 3 || N || O || ||<br />
|-<br />
| 9 || BTN-Nummer || 286 || 310 || 25 || || A || M || ||<br />
|-<br />
| 10 || Artikel-Anzahl (je Masseinheit) || 311 || 319 || 9 || 0 || N || M || ||<br />
|-<br />
| 11 || Ursprungsland || 320 || 321 || 2 || || A || M || ||<br />
|-<br />
| 12 || Artikel-Wert (je Masseinheit) || 322 || 330 || 9 || 2 || N || M || ||<br />
|-<br />
| 13 || Artikelwert-Währung || 331 || 333 || 3 || || A || M || || ISO-Währung (z.B. "EUR")<br />
|-<br />
| 14 || Artikelwert-Masseinheit || 334 || 343 || 10 || || A || M || || keine Vorgabe kann frei Belegt werden (z.B. Stück, Rollen, etc.)<br />
|-<br />
| 15 || CR/LF || 344 || 345 || 2 || || || || || Carriage Return / Line Feed<br />
|}<br />
<br />
= Gefahrgut =<br />
<br />
Die Gefahrgutdaten geben die Gefahreneigenschaften eines zu transportierenden Stoffes an. Ein Stoff kann mehrere Gefahrgutdaten besitzen.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung<br />
|-<br />
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || || || Fest 'GEF'<br />
|-<br />
| 2 || GefahrgutUNNr || 4 || 7 || 4 || || A || || || <br />
|-<br />
| 3 || GefahrgutKlasse || 8 || 11 || 4 || || A || || || <br />
|-<br />
| 4 || GefahrgutVPG || 12 || 14 || 3 || || A || || || I,II,III bzw. leer<br />
|-<br />
| 5 || GefahrgutKCode || 15 || 18 || 4 || || A || || || Pflicht bei Klasse 2<br />
|-<br />
| 6 || GefahrgutBezeichnung || 19 || 128 || 110 || || A || || || Stoffbezeichnung lt. ADR-Tabelle<br />
|-<br />
| 7 || GefahrgutMenge || 129 || 139 || 11 || 3 || N || || || <br />
|-<br />
| 8 || GefahrgutBegrenzteMenge || 140 || 140 || 1 || || A || || || '*' oder 'T': Status 'Begrenzte Menge'<br />
|-<br />
| 9 || GefahrgutVerpAnzahl || 141 || 143 || 3 || || N || || || <br />
|-<br />
| 10 || GefahrgutVerpackungsart || 144 || 151 || 8 || || A || || || GG-konform, z.B. '4G' , '6HG2' usw.<br />
|-<br />
| 11 || GefahrgutID || 152 || 159 || 8 || || A || || || Eindeutige Suchnummer für Gefahrgut-Stammdaten<br />
|-<br />
| 12 || GefahrgutNebengefahr || 160 || 171 || 12 || || A || || || GG-Nebengefahrklasse(n)<br />
|-<br />
| 13 || GefahrgutBuchst640 || 172 || 172 || 1 || || A || || || Buchst. Bei Sondervorschr. 640 (A-L)<br />
|-<br />
| 14 || GefahrgutMengeneinheit || 173 || 173 || 1 || || A || || || 0' bzw Blank: Kilogramm; '1': Liter<br />
|-<br />
| 15 || GefahrgutBefoerdKat || 174 || 174 || 1 || || N || || || 0-4 lt. ADR 1.1.3.6<br />
|-<br />
| 16 || GefahrgutFaktor || 175 || 178 || 4 || || N || || || Gewichtungsfaktor lt. ADR 1.1.3.6<br />
|-<br />
| 17 || GefahrgutNettoExplMasse || 179 || 189 || 11 || 3 || N || || || Nur bei Klasse 1, dann aber Pflicht<br />
|-<br />
| 18 || GefahrgutTunnelBCode || 190 || 199 || 10 || || A || || || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E)<br />
|-<br />
| 19 || GefahrgutFreigestMenge || 200 || 200 || 1 || || A || || || '*' oder 'T': Status 'Freigestellte Menge' (überstimmt Feld 8)<br />
|-<br />
| 20 || GefahrgutUmweltgef || 201 || 201 || 1 || || A || || || '*' oder 'T': Status 'Umweltgefährdend'<br />
|-<br />
| 21 || GefahrgutTechBenennung || 202 || 301 || 100 || || A || || || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut<br />
|-<br />
| 22 || CR/LF || 302 || 302 || 1 || || || || || Carriage Return/Line Feed<br />
|}<br />
<br />
= Gefahrgutstamm =<br />
<br />
Im Gefahrgutstamm legt man die Eigenschaften eines Gefahrguts fest, welche dann in der HVS32 Datenbank gespeichert werden. Anschließend kann man über die GefahrgutID und Menge die Eigenschaften des Gefahrgutstoffs abrufen und dem jeweiligen Packstück zuordnen. Somit müssen nicht immer alle Gefahrgutdaten aus dem Vorsystem übergeben werden.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung<br />
|-<br />
| 1 || GefahrgutID || 1 || 8 || 8 || || A || || || Eindeutige Suchnummer für Gefahrgut-Stammdaten<br />
|-<br />
| 2 || GefahrgutBezeichnung || 9 || 118 || 110 || || A || || || Stoffbezeichnung lt. ADR-Tabelle<br />
|-<br />
| 3 || GefahrgutTechBenennung || 119 || 218 || 100 || || A || || || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut<br />
|-<br />
| 4 || GefahrgutUNNR || 219 || 222 || 4 || || A || || || <br />
|-<br />
| 5 || GefahrgutKlasse || 223 || 226 || 4 || || A || || || <br />
|-<br />
| 6 || GefahrgutNebenGefahr || 227 || 238 || 12 || || A || || || GG-Nebengefahrklasse(n)<br />
|-<br />
| 7 || GefahrgutVPG || 239 || 241 || 3 || || A || || || I,II,III bzw. leer<br />
|-<br />
| 8 || GefahrgutKCode || 242 || 245 || 4 || || A || || || Pflicht bei Klasse 2<br />
|-<br />
| 9 || GefahrgutFaktor || 246 || 249 || 4 || || N || || || Gewichtungsfaktor lt. ADR 1.1.3.6<br />
|-<br />
| 10 || GefahrgutBefoerdKat || 250 || 250 || 1 || || N || || || 0-4 lt. ADR 1.1.3.6<br />
|-<br />
| 11 || GefahrgutBuchst640 || 251 || 251 || 1 || || A || || || Buchst. Bei Sondervorschr. 640 (A-L)<br />
|-<br />
| 12 || GefahrgutMengenEinheit || 252 || 252 || 1 || || A || || || 0' bzw Blank: Kilogramm; '1': Liter<br />
|-<br />
| 13 || GefahrgutVerpackungsart || 253 || 260 || 8 || || A || || || GG-konform, z.B. '4G' , '6HG2' usw.<br />
|-<br />
| 14 || GefahrgutTunnelBCode || 261 || 270 || 10 || || A || || || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E)<br />
|-<br />
| 15 || GefahrgutBegrenzteMenge || 271 || 271 || 1 || || A || || || '*' oder 'T': Status 'Begrenzte Menge'<br />
|-<br />
| 16 || Umweltgefaehrdend || 272 || 272 || 1 || || A || || || '*' oder 'T': Status 'Umweltgefährdend'<br />
|-<br />
| 17 || CR/LF || 302 || 302 || 1 || || || || || Carriage Return/Line Feed<br />
|}<br />
<br />
= Datentypen =<br />
<br />
<b>A - Alphanumerisch </b>- Besteht aus Zahlen und Buchstaben<br><br />
<b>N - Numerisch </b>- Besteht ausschließlich aus Zahlen<br />
<br />
= Beispiele =<br />
<br />
<div style="overflow-x: scroll"><br />
<br />
<b>CSV-Datei - Sendungsdaten einer Sendung mit zwei Packstücken und Definitionszeile. [https://wiki.heidler-strichcode.de/w/download/Sendungsdaten.csv Download File]</b><br />
<br />
SatzKennung;KundenNummer;EmpfängerName1;EmpfängerName2;EmpfängerName3;EmpfängerStrasse;EmpfängerLKZ;EmpfängerPLZ;EmpfängerOrt;EmpfängerRegion/Staat;EmpfängerBahnhof;AnsprechpartnerEmpfänger;TelefonNummerEmpfänger;FaxNummerEmpfänger;UstIDNummerEmpfänger;ILNNummerEmpfänger;"Mandant";"Versandart";AVISHinweis1;AVISHinweis2;AVISZusatz1;AVISZusatz2;LieferscheinNummer;AuftragsNummer;BestellNummer;Warenwert;WarenwertWährung;Nachnahme;NachnahmeWährung;NachnahmeVermerk;NachnahmeVerwendungszweck;HöherVersicherungswert;HöherVersicherungswertWährung;FrankaturKennung;Zahlungsbedingung;ZahlungsbedingungZollSteuern;FrachtführerKundenNr;Sonderdienst;SendungsInhalt;TerminArt;TerminDatum;TerminZeit;NeutralAbsenderName1;NeutralAbsenderName2;NeutralAbsenderName3;NeutralAbsenderStrasse;NeutralAbsenderLKZ;NeutralAbsenderPLZ;NeutralAbsenderOrt;RechnungsempfängerName1;RechnungsempfängerName2;RechnungsempfängerName3;RechnungsempfängerStrasse;RechungsempfängerLKZ;RechungsempfängerPLZ;RechungsempfängerOrt;PostLeitcode;PostZielfrachtzentrum;FrachtbriefNr;GewichtBruttoGewichtNettoPackstückAnzahl;PackstückNummer;Verpackungsart;LängePackstückBreitePackstückHöhePackstückPackPlatzNr;HostseitigePackstückID<br />
IMP;0011800229;EmpfängerGes.m.b.H;PrintingSystems;;Bergergasse38;D;72649;Wolfschlugen;01;NVESped;;;;;;,;;;;;DDP;ZusatzInfo;200,00;EUR;;20,00;20;2;1;;;;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KARTON;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;<br />
IMP;0011800229;EmpfängerGes.m.b.H;PrintingSystems;;Bergergasse38;D;72649;Wolfschlugen;01;NVESped;;;;;;,;;;;;DDP;weitereInfo;200,00;EUR;;20,00;14;2;2;;;;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;<br />
{|<br />
|}<br />
<br />
<p><b>CSV-Datei - Sendungsdaten und Artikeldaten einer Sendung mit zwei Packstücken mit jeweils zwei Artikeln [https://wiki.heidler-strichcode.de/w/download/Sendungsdaten_Artikeldaten.csv Download File]</b><p>IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KT;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;<br />
ART;487010005;1;1;321321;Test Artikel1;;30;321321231;2;DE;20;EUR;STUECK;<br><br />
ART;487010005;1;2;321323;Test Artikel2;;30;321321233;2;DE;20;EUR;STUECK;<br />
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;<br />
ART;487010005;2;2;321322;Test Artikel3;;30;321321232;2;DE;20;EUR;STUECK;<br><br />
ART;487010005;2;2;321322;Test Artikel4;;30;321321232;2;DE;20;EUR;STUECK;<br />
{|<br />
|}<br />
<br />
<p><b>CSV-Datei - Sendungsdaten und Gefahrgut Positionen einer Sendung mit zwei Packstücken mit jeweils drei Gefahrgut Positionen [https://wiki.heidler-strichcode.de/w/download/Sendungsdaten_GefahrgutPositionen.csv Download File]<br />
</b><p>IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KT;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;<br><br />
GEF;1072;2.2;III;1O;3;SAUERSTOFF VERDICHTET / Sauerstoff-Flasche fllen 2 Liter CONOXIA©;;2;;;;56944;(5.1);;1;1;;(E);;;;25<br><br />
GEF;1133;3;II;F1;3;KLEBSTOFFE (FLAMMPUNKT < 23°C), / Alleskleber Flinke Flasche 90g Uhu;;90;;;;12667;;;1;3;;(D/E);;;;33<br><br />
GEF;1133;3;II;F1;3;KLEBSTOFFE (FLAMMPUNKT < 23°C), / Elefantenkleber 850gr;;0,85;;;;33566;;;1;3;;(D/E);;;;33<br><br />
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;<br><br />
GEF;1170;3;III;F1;3;ETHANOL LÖSUNG / Skinsept Mucosa Lösung 500ml ATM2;(Ethylalkohol);0,5;;;;48380;;;1;1;;(D/E);;;;30<br><br />
GEF;1170;3;III;F1;3;ETHANOL LÖSUNG / Skinsept Mucosa Lösung 500ml Palette;(Ethylalkohol);0,5;;;;51252;;;1;1;;(D/E);;;;30<br><br />
GEF;1173;3;II;F1;2;UN 1173 ETHYLACETAT / Nagellackentferner;;0,25;;;;51203;;;1;3;;(D);;;;33<br><br />
{|<br />
|}<br />
<br />
<p><b>CSV-Datei - Gefahrgutstamm mit drei drei neuen Gefahrguteinträgen [https://wiki.heidler-strichcode.de/w/download/Gefahrgutstamm.csv Download File]</b><p>1013;1013;2;(2.2);Kohlendioxid;;;2A;3;;4G;1;<br><br />
1950;1950;2;(2.2);Druckgaspackungen;;;5A;3;;4G;1;<br><br />
1956;1956;2;(2.2);Verdichtetes Gas, N.A.G. (Kohlendioxid, Nitrogen);;;1A;3;;4G;1;<br><br />
{|<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_automatic_polling_functions&diff=5729
HVS32 automatic polling functions
2024-04-22T06:47:18Z
<p>Bhauser: /* Update package data (UpdateVersandDaten) */</p>
<hr />
<div>[[de:HVS32_Automatik-Polling_Funktionen]]<br />
= Data types =<br />
'''Integer''' - Number with only numeric characters (0-9).<br><br />
'''Decimal''' - Number with decimal places<br><br />
'''String''' - Any character from the ISO-8859-1 character set. Maximum length not to be exceeded.<br><br />
= Additional data types =<br />
Additional data types, which occur in the description, are in a 1:n relation to the packages.<br />
Please refer to the respective interface documentation of the corresponding plug-in (file, JDBC, SAP, etc.) to find out how this relation must be realised.<br />
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT UNTERFUNKTIONEN ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- artikelDaten ------------------------------------------------------------------------------- --><br />
== Article data ==<br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
|Satz-Kennung<br />
|[[#Data types|String]]<br />
|3<br />
| -<br />
|'''Only required for file processing'''<br />
"Satzkennung" in the polling file: "ART"<br />
|-<br />
|'''--- ARTICLE DATA SECTION ---'''<br />
|<br />
|<br />
|<br />
|<br />
|-<br />
| ANZAHLBUEGEL || [[#Data types|Integer]] || - || - || Only for hanging shipment: Number of hangers on which the article group is divided up<br />
|-<br />
| ANZAHLPOSETIKETTEN || [[#Data types|Integer]] || - || - || Number of article labels to be printed<br />
|-<br />
| ARTIKELBTNNR || [[#Data types|String]] || 25 || - || BTN number / customs tariff number<br />
|-<br />
| ARTIKELEAN || [[#Data types|String]] || 20 || - || EAN number<br />
|-<br />
| ARTIKELEINHEIT || [[#Data types|String]] || 10 || - || Unit of the article quantity<br />
|-<br />
| ARTIKELGEWICHT || [[#Data types|Decimal]] || 9 || 3 || Article weight<br />
|-<br />
| ARTIKELGRUPPE || [[#Data types|String]] || 50 || - || Article group<br />
|-<br />
| ARTIKELMENGE || [[#Data types|Decimal]] || 9 || 3 || Article quantity<br />
|-<br />
| ARTIKELSERVICES || [[#Data types|String]] || 100 || - || Pipe separate services for this article<br />
|-<br />
| ARTIKELSOLLMENGE || [[#Data types|Decimal]] || 9 || 3 || Article target quantity<br />
|-<br />
| ARTIKELTEXT1 || [[#Data types|String]] || 100 || - || Article description<br />
|-<br />
| ARTIKELTEXT2 || [[#Data types|String]] || 100 || - || Article description<br />
|-<br />
| ARTIKELTEXT3 || [[#Data types|String]] || 100 || - || Article description<br />
|-<br />
| ARTIKELTEXT4 || [[#Data types|String]] || 100 || - || Article description<br />
|-<br />
| ARTIKELVOLUMEN || [[#Data types|Decimal]] || 9 || 3 || Article volume<br />
|-<br />
| ARTIKELWAEHRUNG || [[#Data types|String]] || 3 || - || Currency in which the value of the article is indicated<br />
|-<br />
| ARTIKELWERT || [[#Data types|Decimal]] || 18 || 2 || Value of the article<br />
|-<br />
| CHARGEFLAG || [[#Data types|String]] || 1 || - || <br />
|-<br />
| KUNDENARTIKELNR || [[#Data types|String]] || 50 || - || Article number<br />
|-<br />
| KUNDENBESTELLNR || [[#Data types|String]] || 50 || - || Purchase order number<br />
|-<br />
| POSAUFTRAGNR || [[#Data types|String]] || 50 || - || Order number<br />
|-<br />
| POSLIEFERNR || [[#Data types|String]] || 40 || - || Delivery note number<br />
|-<br />
| POSITIONNR || [[#Data types|String]] || 50 || - || Sequence number within the package<br />
|-<br />
| SERIENNR || [[#Data types|String]] || 30 || - || Serial number<br />
|-<br />
| URSPRUNGLAND || [[#Data types|String]] || 2 || - || Country of origin of the article<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE artikelDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- --><br />
<br />
== Dangerous goods ==<br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
|Satz-Kennung<br />
|[[#Data types|String]]<br />
|3<br />
| -<br />
|'''Only required for file processing'''<br />
"Satzkennung" in the polling file: "GEF"<br />
|-<br />
|'''--- DANGEROUS GOODS DATA SECTION ---'''<br />
|<br />
|<br />
|<br />
|<br />
|-<br />
| GEFAHRGUTBEFOERDKAT || [[#Data types|Integer]] || 1 || - || Transport category, mandatory (see ADR table column (15)), can be 0-4. Attention! Must be correct.<br />
|-<br />
| GEFAHRGUTBEGRENZTEMENGE || [[#Data types|String]] || 1 || - || T if the substance is shipped with status LQ / Limited Quantity according to ADR 3.4, otherwise F, mandatory<br />
|-<br />
| GEFAHRGUTBEZEICHNUNG || [[#Data types|String]] || 110 || - || Mandatory (see ADR table column (2))<br />
|-<br />
| GEFAHRGUTBUCHST640 || [[#Data types|String]] || 1 || - || Letter for special provision 640, conditionally mandatory for substances to which special provision 640 applies (see ADR table column (6)).<br />
|-<br />
| GEFAHRGUTFFCODE || [[#Data types|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG --><br />
|-<br />
| GEFAHRGUTFAKTOR || [[#Data types|Integer]] || 3 || - || Assessment factor for point summation on the transport document, (can be 0, 1, 3, 50 or 999), technically mandatory, but can be clearly concluded from the transport category, therefore it does not necessarily have to be documented<br />
|-<br />
| GEFAHRGUTFREIGESTMENGE || [[#Data types|String]] || 1 || - || T if the substance is shipped with status EQ / Excepted Quantities according to ADR 3.5, otherwise F, mandatory<br />
|-<br />
| GEFAHRGUTID || [[#Data types|String]] || 20 || - || Unique search number for dangerous goods master data<br />
|-<br />
| GEFAHRGUTKCODE || [[#Data types|String]] || 10 || - || Classification code, mandatory (see ADR table column (3b))<br />
|-<br />
| GEFAHRGUTKLASSE || [[#Data types|String]] || 100 || - || Mandatory (see ADR table column (3a))<br />
|-<br />
| GEFAHRGUTMENGE || [[#Data types|Decimal]] || 8 || 3 || Substance quantity of dangerous goods to be declared according to ADR (in litres for liquids and compressed gases, otherwise in kg, for LQ dangerous goods always kg).<br />
|-<br />
| GEFAHRGUTMENGENEINHEIT || [[#Data types|String]] || 2 || - || Unit of measurement for the substance quantity. 1' or 'l': litre ; '0' or 'kg' or empty: kg<br />
|-<br />
| GEFAHRGUTNEBENGEFAHR || [[#Data types|String]] || 10 || - || Conditionally mandatory for substances where subsidiary risk label numbers exist in addition to the main hazard class/label number (see ADR table column (5), if e.g. 3+6.1+8 is entered there, 6.1 and 8 are the subsidiary risk label numbers and are to be transmitted as (6.1)(8) in the subsidiary risk field).<br />
|-<br />
| GEFAHRGUTNETTOEXPLMASSE || [[#Data types|Decimal]] || 8 || 3 || Net explosive mass in kg, only for dangerous goods of class 1<br />
|-<br />
| GEFAHRGUTPOSITIONNR || [[#Data types|Integer]] || - || - || <br />
|-<br />
| GEFAHRGUTTECHBENENNUNG || [[#Data types|String]] || 150 || - || Conditionally mandatory for N.A.G. dangerous goods (i.e. if the designation ends with N.A.G.)<br />
|-<br />
| GEFAHRGUTTUNNELBCODE || [[#Data types|String]] || 10 || - || Tunnel restriction code, mandatory (see ADR table column (15))<br />
|-<br />
| GEFAHRGUTUNNR || [[#Data types|String]] || 10 || - || Mandatory (see ADR table column (1))<br />
|-<br />
| GEFAHRGUTUMWELTGEF || [[#Data types|String]] || 1 || - || T if substance is environmentally hazardous, otherwise F, mandatory for environmentally hazardous substances.<br />
|-<br />
| GEFAHRGUTVPG || [[#Data types|String]] || 3 || - || Packing group, conditionally mandatory for those substances for which it is assigned in the ADR table, may be I,II or III or not assigned at all (the latter e.g. for Class 2)) (see ADR table column (4)).<br />
|-<br />
| GEFAHRGUTVERPANZAHL || [[#Data types|Integer]] || 4 || - || Number of units in which the dangerous goods are packed (in connection with the next field GefahrgutVerpackungsart)<br />
|-<br />
| GEFAHRGUTVERPACKUNGSART || [[#Data types|String]] || 5 || - || ADR code of the type of packaging, e.g. 4G for box (cardboard), mandatory, see separate documentation for packaging codes.<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- VersandDatenAnfrage ------------------------------------------------------------------------------- --><br />
= Package processing (VersandDatenAnfrage) =<br />
The gateway function VersandDatenAnfrage is sent from the data gateway server in automatic polling mode to the HVS32 in order to generate and post a label for a package.<br />
A label is identified for all further functions such as cancellation, loading release, etc. by means of the host-side package ID. This is transferred in the Package ID field and must therefore be unique within the shipping system.<br />
<br />
<br />
By means of an additional configuration in the HVS32, the VersandDatenAnfrage can also be used to initiate a reprint. In this case, the same PackstueckID must be used for the new request.<br><br />
<br><br />
<big>'''Parameters'''</big><br />
<br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| ANSPRECHPARTNER || [[#Data types|String]] || 50 || - || Recipient Contact person<br />
|-<br />
| ANZAHLARTIKEL || [[#Data types|Integer]] || 6 || - || Number of articles (print on label)<br />
|-<br />
| [[#Article data|ARTIKELDATEN]] || [[#Data types|Sequence]] '''[[#Article data|<ArtikelDaten>]]''' || - || - || A list of the [[#Article data|package articles]] of the type '''[[#Article data|ArtikelDaten]]''' (1:n)<br />
|-<br />
| AUFTRAGNR || [[#Data types|String]] || 20 || - || -<br />
|-<br />
| '''AUFTRAGGEBERID''' || [[#Data types|String]] || 10 || - || Mandantenkennung aus dem HVS32<br />
|-<br />
| AVISHINWEIS1 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISHINWEIS2 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISZUSATZ1 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 1<br />
|-<br />
| AVISZUSATZ2 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 2<br />
|-<br />
| BARCODEID || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BARCODETEXT || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BARCODETYP || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BESTELLNR || [[#Data types|String]] || 20 || - || Metro order no. (Metro shipping)<br />
|-<br />
| DRUCKERNAME || [[#Data types|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module)<br />
|-<br />
| EMAIL || [[#Data types|String]] || 100 || - || E-mail address of the recipient (e.g.: for automatic e-mail notification)<br />
|-<br />
| EMPFMOBILFUNKNR || [[#Data types|String]] || 20 || - || Mobile phone number of the recipient<br />
|-<br />
| FAXNR || [[#Data types|String]] || 20 || - || Fax number of the recipient<br />
|-<br />
| FLEXZUSTELLUNGEMAILADRESSE || [[#Data types|String]] || 80 || - || Flex delivery email address<br />
|-<br />
| FRACHTBRIEF || [[#Data types|String]] || 20 || - || Consignment note number if the consignment note is to be printed by the pre-system<br />
|-<br />
| FRACHTFUEHRERKDNR || [[#Data types|String]] || 10 || - || Customer number of the freight payer with the carrier<br />
|-<br />
| FRANKATURKENNUNG || [[#Data types|String]] || 10 || - || -<br />
|-<br />
| [[#Dangerous goods|GEFAHRGUT]] || [[#Data types|Sequence]] '''[[#Dangerous goods|<Gefahrgut>]]''' || - || - || A list of [[#Dangerous goods|Dangerous goods]] of type '''[[#Dangerous goods|Gefahrgut]]''' (1:n)<br />
|-<br />
| GEWICHT || [[#Data types|Decimal]] || 8 || 3 || Gross weight in KG<br />
|-<br />
| HOSTTRACKINGNR || [[#Data types|String]] || 35 || - || Package number from the host system<br />
|-<br />
| ILNNR || [[#Data types|String]] || 20 || - || ILN of the recipient (mandatory for Metro shipping)<br />
|-<br />
| KOSTENSTELLE || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| KUNDENNR || [[#Data types|String]] || 20 || - || Customer number of the recipient with the sender<br />
|-<br />
| LAGERKENNZEICHEN || [[#Data types|Integer]] || - || - || -<br />
|-<br />
| LETZTESPACKSTUECK || [[#Data types|String]] || 1 || - || T/F: T=last packing piece of the consignment (required for printing the consignment hanging card in the case of hanging consignments).<br />
|-<br />
| LIEFERANTENID || [[#Data types|Integer]] || - || - || -<br />
|-<br />
| '''LIEFERSCHEINNR''' || [[#Data types|String]] || 40 || - || Used in the HVS32 as a search number<br />
|-<br />
| NACHNAHME || [[#Data types|Decimal]] || 18 || 2 || -<br />
|-<br />
| NETTOGEWICHT || [[#Data types|Decimal]] || 8 || 3 || Net weight in KG<br />
|-<br />
| NEUTBIC || [[#Data types|String]] || 11 || - || Only used with neutral senders<br />
|-<br />
| NEUTBANKBEZEICHNUNG || [[#Data types|String]] || 40 || - || Only used with neutral senders<br />
|-<br />
| NEUTIBAN || [[#Data types|String]] || 31 || - || Only used with neutral senders<br />
|-<br />
| NEUTKONTOINHABER || [[#Data types|String]] || 40 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERLKZ || [[#Data types|String]] || 3 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME1 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME2 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME3 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERORT || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERPLZ || [[#Data types|String]] || 10 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERSTRASSE || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NNVERMERK || [[#Data types|String]] || 1 || - || 'B': Cash / 'V': Crossed cheque<br />
|-<br />
| NNVERWENDUNG || [[#Data types|String]] || 30 || - || Cash on delivery - Intended use<br />
|-<br />
| NNWAEHRUNG || [[#Data types|String]] || 3 || - || Cash on delivery - ISO currency code<br />
|-<br />
| '''PACKSTKGES''' || [[#Data types|Integer]] || - || - || Total number of colli of the consignment<br />
|-<br />
| '''PACKSTKNR''' || [[#Data types|Integer]] || - || - || Sequence number per consignment<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station that will process the job.<br />
|-<br />
| PACKSTUECKBREITE || [[#Data types|Integer]] || - || - || Width in cm<br />
|-<br />
| PACKSTUECKHOEHE || [[#Data types|Integer]] || - || - || Height in cm<br />
|-<br />
| '''PACKSTUECKID''' || [[#Data types|String]] || 20 || - || Unique number for the parcel in the pre-system. Needed as a unique parcel reference to cancel or load the label later.<br />
|-<br />
| PACKSTUECKLAENGE || [[#Data types|Integer]] || - || - || Length in cm<br />
|-<br />
| PAPERLESSINVOICE || [[#Data types|String]] || 1 || - || Only in UPS PaperlessInvoice case (T=PaperlessInvoice / F=not PaperlessInvoice)<br />
|-<br />
| POSTLEITCODE || [[#Data types|String]] || 15 || - || -<br />
|-<br />
| POSTZIELFRACHTZENT || [[#Data types|String]] || 5 || - || -<br />
|-<br />
| RECHNUNGSEMPFLKZ || [[#Data types|String]] || 5 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFNAME1 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME2 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME3 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFORT || [[#Data types|String]] || 50 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFPLZ || [[#Data types|String]] || 10 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFSTRASSE || [[#Data types|String]] || 50 || - || Invoice address<br />
|-<br />
| RECHNUNGSNR || [[#Data types|String]] || 20 || - || Invoice number<br />
|-<br />
| SENDUNGSINHALT || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| SONDERDIENSTE || [[#Data types|String]] || 30 || - || SPECIAL SERVICES - depending on the shipping method used<br />
|-<br />
| SPERRFLAG || [[#Data types|String]] || 1 || - || T/F: T=lock, otherwise do not lock<br />
|-<br />
| TELEFONNR || [[#Data types|String]] || 20 || - || Recipient's phone number<br />
|-<br />
| TERMINART || [[#Data types|String]] || 1 || - || 'A' = deliver from this day on<br />
'B' = deliver until this day<br />
<br />
'F' = deliver on this day<br />
|-<br />
| TERMINDATUM || [[#Data types|String]] || 10 || - || DD.MM.YYYY<br />
|-<br />
| TERMINZEIT || [[#Data types|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| USTIDNR || [[#Data types|String]] || 20 || - || VAT number of the recipient<br />
|-<br />
| VERPACKUNGSART || [[#Data types|String]] || 6 || - || -<br />
|-<br />
| '''VERSANDARTID''' || [[#Data types|String]] || 10 || - || Dispatch type identifier from the HVS32<br />
|-<br />
| VERSICHERUNGSWERT || [[#Data types|Decimal]] || 18 || 2 || Amount of insured value<br />
|-<br />
| VORPACKDATUM || [[#Data types|String]] || 10 || - || DD.MM.YYYY<br />
|-<br />
| VWWAEHRUNG || [[#Data types|String]] || 3 || - || Insured value - ISO currency code<br />
|-<br />
| WARENWERT || [[#Data types|Decimal]] || 18 || 2 || Value of goods<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Swap body assigned to this package<br />
|-<br />
| WWWAEHRUNG || [[#Data types|String]] || 3 || - || Value of goods - ISO currency code<br />
|-<br />
| ZAHLUNGSBEDINGUNG || [[#Data types|String]] || 10 || - || 'S' = sender, 'R' = receiver<br />
|-<br />
| ZBZOLL || [[#Data types|String]] || 1 || - || Payment condition for customs taxes 'S' = Sender, 'R' = Receiver<br />
|-<br />
| ZIELADRBAHNHOF || [[#Data types|String]] || 30 || - || Postcode and city<br />
|-<br />
| '''ZIELADRLKZ''' || [[#Data types|String]] || 5 || - || Delivery address<br />
|-<br />
| '''ZIELADRNAME1''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME2 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME3 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME4 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| '''ZIELADRORT''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| '''ZIELADRPLZ''' || [[#Data types|String]] || 10 || - || Delivery address<br />
|-<br />
| ZIELADRREGION || [[#Data types|String]] || 20 || - || State/province (e.g.: important for shipments to the USA)<br />
|-<br />
| '''ZIELADRSTRASSE''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|}<br />
<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment|<br />
|-<br />
| AUSGANGDATETIME || [[#Data types|String]] || 10 || - || Date when the label was transmitted to the carrier (DD.MM.YYYY)<br />
|-<br />
| DRUCKDATETIME || [[#Data types|String]] || 19 || - || Date when the label was printed in the HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 if successful<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| GEBUEHR || [[#Data types|Decimal]] || 18 || 2 || Freight costs<br />
|-<br />
| GEBUEHRWAEHRUNG || [[#Data types|String]] || 3 || - || Freight costs - ISO currency code<br />
|-<br />
| PACKSTUECKID || [[#Data types|String]] || 20 || - || PackstueckID from the request<br />
|-<br />
| RETOURTRACKINGNR || [[#Data types|String]] || 50 || - || Package number for the return<br />
|-<br />
| TRACKINGNR || [[#Data types|String]] || 35 || - || Package number<br />
|-<br />
| TRACKINGURL || [[#Data types|String]] || 255 || - || URL of the tracking link<br />
|-<br />
| VERSANDSENDUNGSNR || [[#Data types|String]] || - || - || -<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE VersandDatenAnfrage ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- VersandDatenWdhDruck ------------------------------------------------------------------------------- --><br />
= Reprint label (VersandDatenWdhDruck) =<br />
The gateway function VersandDatenWdhDruck is sent from the data gateway server in automatic polling mode to the HVS32 to reprint a label for a package.<br />
A label is reprinted using the host-side package ID. This is transferred in the PackstueckID field.<br />
Some carriers (e.g. DPD) assign new tracking numbers when reprinting. This means that the old tracking number is no longer valid and the old shipping label must be destroyed.<br />
The new tracking number can be reported back in the response.<br />
<br><br><big>'''Parameters '''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| '''PACKSTUECKID''' || [[#Data types|String]] || 20 || - || '''Unique''' number for the parcel in the pre-system.<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station that will process the job. <br />
|-<br />
| DRUCKERNAME || [[#Data types|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module) <br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| TRACKINGNR || [[#Data types|String]] || 35 || - || (New) tracking number of the package<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE VersandDatenWdhDruck ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- StornoVersandDaten ------------------------------------------------------------------------------- --><br />
= Cancel package (StornoVersandDaten) =<br />
The gateway function StornoVersandDaten is sent from the data gateway server (DGS) in automatic polling mode to the HVS32 to cancel existing packages there that are not yet on an outgoing list.<br />
As a rule, a package is cancelled on the basis of the package ID on the host side. This is transferred in the PackstueckID field.<br />
In addition to the host-side package ID, the tracking number can also contribute to the identification of the package, in case the host-side package ID cannot guarantee uniqueness.<br />
No package/shipment data is available for the feedback. After a successful cancellation, only the field Error with value 0 is reported back - or in case of an error, Error with value 1 and the error Fehlertext1 are reported back.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| '''PACKSTUECKID''' || [[#Data types|String]] || 20 || - || '''Unique''' number for the parcel in the pre-system. <br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station that will process the job.<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error <br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE StornoVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- VerladeVersandDaten ------------------------------------------------------------------------------- --><br />
= Load/release package (VerladeVersandDaten) =<br />
The gateway function VerladeVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to release packages for outgoing.<br />
Only packages that have been released for exit are taken into account for the daily closing. <br />
No package/shipment data is available for the feedback. After successful release, only the field Fehler with value 0 is reported back - or in case of an error, Fehler with value 1 and the error Fehlertext1 are reported back.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| '''PACKSTUECKID''' || [[#Datentypen|String]] || 20 || - || '''Unique''' number for the parcel in the pre-system. <br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32 packing station that will process the job. <br />
|-<br />
| SPERRKENNZEICHEN || [[#Datentypen|String]] || 1 || - || "J" if the package is to be blocked<br />
|-<br />
| WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Swap body on which the package is to be booked<br />
|-<br />
| SAMMELFREIGABE || [[#Datentypen|String]] || 1 || - || "T" for a collective release (release all packages with identical VE-ReferenzNr)<br />
|-<br />
| VEREFERENZNR || [[#Datentypen|String]] || 20 || - || must be filled for a collective release<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Successful, 1 = Error <br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE VerladeVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- Tagesabschluss ------------------------------------------------------------------------------- --><br />
= Daily closing (Tagesabschluss) =<br />
The gateway sends the daily closing request to the automatic polling of the HVS32. A daily closing is thus triggered in the HVS32 on the basis of the additionally transferred parameters.<br />
The daily closing consists of the points generate outgoing list and Generate EDI file.<br />
Only packages that have been released for exit are taken into account for the daily closing. By default, all packages are released unless they have been blocked by the output scanning extension module.<br />
The feedback in the HVS32 takes place after the daily closing has been executed.<br />
No package/shipment data is available for the feedback. After successful day-end closing, only the field Fehler is reported with the value 0 - or in the case of an error, Fehler is reported with the value 1 and the Fehlertext1 .<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station client that is to execute the daily closing.<br />
|-<br />
| FRACHTFUEHRERTYPLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the carriers to be concluded can be entered here. N carriers can be concluded.<br />
(Option MultiFFTagesabschluss must be active in HVS32)<br />
|-<br />
| AUFTRAGGEBERIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the clients to be completed can be entered here. N clients can be concluded.<br />
(Option MultiAGTagesabschluss must be active in HVS32)<br />
|-<br />
| VERSANDARTIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the dispatch types to be completed can be entered here. N shipping types can be completed.<br />
(Option MultiVATagesabschluss must be active in HVS32)<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Indicator of the swap body to be closed. Only certain consignments can be closed with this.<br />
|-<br />
| DRUCKERNAME || [[#Data types|String]] || 30 || - || Name of the output channel on which the list is to be printed.<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE Tagesabschluss ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- Listenabschluss ------------------------------------------------------------------------------- --><br />
= Generate output list (Listenabschluss) =<br />
The gateway sends the generate-output-list request to the automatic polling of the HVS32. An outgoing list is thus generated in the HVS32 on the basis of the additionally transferred parameters.<br />
Only packages that have been released for exit are taken into account for the list closure. By default, all packages are released unless they have been blocked by the output scanning extension module.<br />
The feedback in the HVS32 takes place after the output list has been generated.<br />
No package/shipment data is available for feedback. After successful completion of the list, only the field Error with value 0 is reported back - or in the case of an error, Error with value 1 and the error text1 are reported back.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station client that is to execute the daily closing.<br />
|-<br />
| FRACHTFUEHRERTYPLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the carriers to be concluded can be entered here. N carriers can be concluded.<br />
(Option MultiFFTagesabschluss must be active in HVS32)<br />
|-<br />
| AUFTRAGGEBERIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the clients to be completed can be entered here. N clients can be concluded.<br />
(Option MultiAGTagesabschluss must be active in HVS32)<br />
|-<br />
| VERSANDARTIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the dispatch types to be completed can be entered here. N shipping types can be completed.<br />
(Option MultiVATagesabschluss must be active in HVS32)<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Indicator of the swap body to be closed. Only certain consignments can be closed with this.<br />
|-<br />
| DRUCKERNAME || [[#Data types|String]] || 30 || - || Name of the output channel on which the list is to be printed.<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE Listenabschluss ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- EDIAbschluss ------------------------------------------------------------------------------- --><br />
= Create carrier EDI (EDIAbschluss) =<br />
The gateway sends the create-carrier-EDI request to the automatic polling of the HVS32. A carrier EDI is thus generated in the HVS32 on the basis of the additionally transferred parameters and (if configured) transmitted to the carrier.<br />
Only packages for which an outgoing list was previously generated are taken into account for a carrier EDI.<br />
The confirmation in the HVS32 takes place after the carrier EDI has been generated.<br />
No package/shipment data is available for the confirmation. After successful completion of the EDI, only the field Error with value 0 is reported - or in case of an error, Error with value 1 and the error text1 are reported.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station client that is to execute the daily closing.<br />
|-<br />
| FRACHTFUEHRERTYPLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the carriers to be concluded can be entered here. N carriers can be concluded.<br />
(Option MultiFFTagesabschluss must be active in HVS32)<br />
|-<br />
| AUFTRAGGEBERIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the clients to be completed can be entered here. N clients can be concluded.<br />
(Option MultiAGTagesabschluss must be active in HVS32)<br />
|-<br />
| VERSANDARTIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the dispatch types to be completed can be entered here. N shipping types can be completed.<br />
(Option MultiVATagesabschluss must be active in HVS32)<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Indicator of the swap body to be closed. Only certain consignments can be closed with this.<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE EDIAbschluss ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- VersandDatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
= Verify package data (VersandDatenPruefAnfrage) =<br />
The gateway sends the VersandDatenPruefAnfrage to the automatic polling of the HVS32. A shipping data request is thus simulated in the HVS32.<br />
No labels are printed and the package or label is not booked, but all other processes are identical to the shipping data request (route determination, tracking number determination, address check, etc.).<br />
This function is used to validate all shipping data in advance.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| ANSPRECHPARTNER || [[#Data types|String]] || 50 || - || Recipient Contact person<br />
|-<br />
| ANZAHLARTIKEL || [[#Data types|Integer]] || 6 || - || Number of articles (print on label)<br />
|-<br />
| [[#Article data|ARTIKELDATEN]] || [[#Data types|Sequence]] '''[[#Article data|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#Article data|Package article]] vom Typ '''[[#Article data|ArtikelDaten]]''' (1:n)<br />
|-<br />
| AUFTRAGNR || [[#Data types|String]] || 20 || - || -<br />
|-<br />
| '''AUFTRAGGEBERID''' || [[#Data types|String]] || 10 || - || Client identifier from HVS32<br />
|-<br />
| AVISHINWEIS1 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISHINWEIS2 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISZUSATZ1 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 1<br />
|-<br />
| AVISZUSATZ2 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 2<br />
|-<br />
| BARCODEID || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BARCODETEXT || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BARCODETYP || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BESTELLNR || [[#Data types|String]] || 20 || - || Metro order number (Metro shipping)<br />
|-<br />
| DRUCKERNAME || [[#Data types|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module)<br />
|-<br />
| EMAIL || [[#Data types|String]] || 100 || - || Recipient's e-mail address (e.g.: for automatic e-mail notification)<br />
|-<br />
| EMPFMOBILFUNKNR || [[#Data types|String]] || 20 || - || Mobile phone number of the recipient<br />
|-<br />
| FAXNR || [[#Data types|String]] || 20 || - || Fax number of the recipient<br />
|-<br />
| FLEXZUSTELLUNGEMAILADRESSE || [[#Data types|String]] || 80 || - || Flex delivery email address<br />
|-<br />
| FRACHTBRIEF || [[#Data types|String]] || 20 || - || Consignment note number if consignment note is to be printed by pre-system<br />
|-<br />
| FRACHTFUEHRERKDNR || [[#Data types|String]] || 10 || - || Customer number of the freight payer with the carrier<br />
|-<br />
| FRANKATURKENNUNG || [[#Data types|String]] || 10 || - || -<br />
|-<br />
| [[#Dangerous goods|GEFAHRGUT]] || [[#Data types|Sequence]] '''[[#Dangerous goods|<Gefahrgut>]]''' || - || - || A list of [[#Dangerous goods|Dangerous goods]] of type '''[[#Dangerous goods|Gefahrgut]]''' (1:n)<br />
|-<br />
| GEWICHT || [[#Data types|Decimal]] || 8 || 3 || Gross weight in KG<br />
|-<br />
| HOSTTRACKINGNR || [[#Data types|String]] || 35 || - || Package number from the host system<br />
|-<br />
| ILNNR || [[#Data types|String]] || 20 || - || ILN of the recipient (mandatory for Metro shipping)<br />
|-<br />
| KOSTENSTELLE || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| KUNDENNR || [[#Data types|String]] || 20 || - || Customer number of the recipient with the sender<br />
|-<br />
| LAGERKENNZEICHEN || [[#Data types|Integer]] || - || - || -<br />
|-<br />
| LETZTESPACKSTUECK || [[#Data types|String]] || 1 || - || T/F: T=last package of the consignment (required for printing the consignment hanging card for hanging consignments)<br />
|-<br />
| LIEFERANTENID || [[#Data types|Integer]] || - || - || -<br />
|-<br />
| '''LIEFERSCHEINNR''' || [[#Data types|String]] || 40 || - || Used in the HVS32 as a search number<br />
|-<br />
| NACHNAHME || [[#Data types|Decimal]] || 18 || 2 || -<br />
|-<br />
| NETTOGEWICHT || [[#Data types|Decimal]] || 8 || 3 || Net weight in KG<br />
|-<br />
| NEUTBIC || [[#Data types|String]] || 11 || - || Only used with neutral senders<br />
|-<br />
| NEUTBANKBEZEICHNUNG || [[#Data types|String]] || 40 || - || Only used with neutral senders<br />
|-<br />
| NEUTIBAN || [[#Data types|String]] || 31 || - || Only used with neutral senders<br />
|-<br />
| NEUTKONTOINHABER || [[#Data types|String]] || 40 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERLKZ || [[#Data types|String]] || 3 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME1 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME2 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME3 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERORT || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERPLZ || [[#Data types|String]] || 10 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERSTRASSE || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NNVERMERK || [[#Data types|String]] || 1 || - || 'B': Cash / 'V': Crossed cheque<br />
|-<br />
| NNVERWENDUNG || [[#Data types|String]] || 30 || - || Cash on delivery - Intended use <br />
|-<br />
| NNWAEHRUNG || [[#Data types|String]] || 3 || - || Cash on delivery - ISO currency code <br />
|-<br />
| '''PACKSTKGES''' || [[#Data types|Integer]] || - || - || Total number of colli of the consignment<br />
|-<br />
| '''PACKSTKNR''' || [[#Data types|Integer]] || - || - || Sequence number per consignment<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station that will process the job. <br />
|-<br />
| PACKSTUECKBREITE || [[#Data types|Integer]] || - || - || Width in cm<br />
|-<br />
| PACKSTUECKHOEHE || [[#Data types|Integer]] || - || - || Height in cm<br />
|-<br />
| PACKSTUECKID || [[#Data types|String]] || 20 || - || Unique number for the parcel in the pre-system. Needed as a unique parcel reference to cancel or load the label later. <br />
|-<br />
| PACKSTUECKLAENGE || [[#Data types|Integer]] || - || - || Length in cm<br />
|-<br />
| PAPERLESSINVOICE || [[#Data types|String]] || 1 || - || Only in UPS PaperlessInvoice case (T=PaperlessInvoice / F=not PaperlessInvoice)<br />
|-<br />
| POSTLEITCODE || [[#Data types|String]] || 15 || - || -<br />
|-<br />
| POSTZIELFRACHTZENT || [[#Data types|String]] || 5 || - || -<br />
|-<br />
| RECHNUNGSEMPFLKZ || [[#Data types|String]] || 5 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFNAME1 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME2 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME3 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFORT || [[#Data types|String]] || 50 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFPLZ || [[#Data types|String]] || 10 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFSTRASSE || [[#Data types|String]] || 50 || - || Invoice address<br />
|-<br />
| RECHNUNGSNR || [[#Data types|String]] || 20 || - || Invoice number<br />
|-<br />
| SENDUNGSINHALT || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| SONDERDIENSTE || [[#Data types|String]] || 30 || - || SPECIAL SERVICES - depending on the shipping method used<br />
|-<br />
| SPERRFLAG || [[#Data types|String]] || 1 || - || T/F: T=lock, otherwise do not lock<br />
|-<br />
| TELEFONNR || [[#Data types|String]] || 20 || - || Recipient's phone number <br />
|-<br />
| TERMINART || [[#Data types|String]] || 1 || - || 'A' = deliver from this day on <br />
<br />
'B' = deliver until this day<br />
<br />
'F' = deliver on this day <br />
<br />
|-<br />
| TERMINDATUM || [[#Data types|String]] || 10 || - || DD.MM.YYYY<br />
|-<br />
| TERMINZEIT || [[#Data types|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| USTIDNR || [[#Data types|String]] || 20 || - || VAT number of the recipient<br />
|-<br />
| VERPACKUNGSART || [[#Data types|String]] || 6 || - || -<br />
|-<br />
| '''VERSANDARTID''' || [[#Data types|String]] || 10 || - || Dispatch type identifier from the HVS32 <br />
|-<br />
| VERSICHERUNGSWERT || [[#Data types|Decimal]] || 18 || 2 || Amount of insured value<br />
|-<br />
| VORPACKDATUM || [[#Data types|String]] || 10 || - || DD.MM.YYYY<br />
|-<br />
| VWWAEHRUNG || [[#Data types|String]] || 3 || - || Insured value - ISO currency code<br />
|-<br />
| WARENWERT || [[#Data types|Decimal]] || 18 || 2 || Value of goods<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Swap body assigned to this package<br />
|-<br />
| WWWAEHRUNG || [[#Data types|String]] || 3 || - || Value of goods - ISO currency code<br />
|-<br />
| ZAHLUNGSBEDINGUNG || [[#Data types|String]] || 10 || - || 'S' = sender, 'R' = receiver<br />
|-<br />
| ZBZOLL || [[#Data types|String]] || 1 || - || Payment condition for customs taxes 'S' = Sender, 'R' = Receiver<br />
|-<br />
| ZIELADRBAHNHOF || [[#Data types|String]] || 30 || - || Postcode and city<br />
|-<br />
| '''ZIELADRLKZ''' || [[#Data types|String]] || 5 || - || Delivery address<br />
|-<br />
| '''ZIELADRNAME1''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME2 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME3 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME4 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| '''ZIELADRORT''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| '''ZIELADRPLZ''' || [[#Data types|String]] || 10 || - || Delivery address<br />
|-<br />
| ZIELADRREGION || [[#Data types|String]] || 20 || - || State/province (e.g.: important for shipments to the USA) <br />
|-<br />
| '''ZIELADRSTRASSE''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|}<br />
<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment|<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 if successful<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| GEBUEHR || [[#Data types|Decimal]] || 18 || 2 || Freight costs<br />
|-<br />
| GEBUEHRWAEHRUNG || [[#Data types|String]] || 3 || - || Freight costs ISO currency code<br />
|-<br />
| PACKSTUECKID || [[#Data types|String]] || 20 || - || PackstueckID from the request<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE VersandDatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- UpdateVersandDaten ------------------------------------------------------------------------------- --><br />
= Update package data (UpdateVersandDaten) =<br />
The gateway function UpdateVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to change the data of existing packages.<br />
This request is sent, for example, if the value of goods for a package is only known at a later time.<br />
Data can be updated within the tables Versandeinheit, Abrechnungseinheit and Lieferung. The search is always carried out via the field PackstueckID and, if occupied, also via the field TrackingNr.<br><br><br />
<br />
'''With this request, however, the fields and content to be updated are no longer checked according to the guidelines of the carrier (e.g. weight limits, etc.). The upstream system must therefore ensure that the updated values match the carrier's guidelines. If this is not possible, this function cannot be used and the label must be canceled and reprocessed. In addition, fields that have already been printed on a label or that have been determined by the HVS32 shipping system in a carrier transaction (e.g. address, route, tracking number, special services, etc.) cannot be manipulated.'''<br><br><br />
<br />
'''ATTENTION: All fields that are to be updated in the shipping system must be coordinated and configured accordingly in the shipping system before using this function!'''<br><br><br />
No package/shipment data is available for the confirmation. After a successful update, only the field Error with value 0 is reported back - or in case of an error, Error with value 1 and the error text1 are reported back.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| '''PACKSTUECKID''' || [[#Data types|String]] || 20 || - || Unique number for the package in the pre-system. Required as a unique package reference to identify the record.<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station that will process the job.<br />
|-<br />
| ANSPRECHPARTNER || [[#Data types|String]] || 50 || - || Recipient Contact person <br />
|-<br />
| AVISHINWEIS1 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISHINWEIS2 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISZUSATZ1 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 1<br />
|-<br />
| AVISZUSATZ2 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 2<br />
|-<br />
| BESTELLNR || [[#Data types|String]] || 20 || - || Metro order number (Metro shipping)<br />
|-<br />
| EMAIL || [[#Data types|String]] || 100 || - || Recipient's e-mail address (e.g.: for automatic e-mail notification)<br />
|-<br />
| EMPFMOBILFUNKNR || [[#Data types|String]] || 20 || - || Mobile phone number of the recipient<br />
|-<br />
| FAXNR || [[#Data types|String]] || 20 || - || Fax number of the recipient<br />
|-<br />
| FLEXZUSTELLUNGEMAILADRESSE || [[#Data types|String]] || 80 || - || Flex delivery email address<br />
|-<br />
| GEWICHT || [[#Data types|Decimal]] || 8 || 3 || Gross weight in KG<br />
|-<br />
| NETTOGEWICHT || [[#Data types|Decimal]] || 8 || 3 || Net weight in KG<br />
|-<br />
| ILNNR || [[#Data types|String]] || 20 || - || ILN of the recipient (mandatory for Metro shipping)<br />
|-<br />
| KOSTENSTELLE || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| LIEFERANTENID || [[#Data types|Integer]] || - || - || -<br />
|-<br />
| NACHNAHME || [[#Data types|Decimal]] || 18 || 2 || -<br />
|-<br />
| NNVERMERK || [[#Data types|String]] || 1 || - || 'B': Cash / 'V': Crossed cheque<br />
|-<br />
| NNVERWENDUNG || [[#Data types|String]] || 30 || - || Cash on delivery - Intended use <br />
|-<br />
| NNWAEHRUNG || [[#Data types|String]] || 3 || - || Cash on delivery - ISO currency code <br />
|-<br />
| PACKSTUECKBREITE || [[#Data types|Integer]] || - || - || Width in cm<br />
|-<br />
| PACKSTUECKHOEHE || [[#Data types|Integer]] || - || - || Height in cm<br />
|-<br />
| PACKSTUECKLAENGE || [[#Data types|Integer]] || - || - || Length in cm<br />
|-<br />
| RECHNUNGSEMPFLKZ || [[#Data types|String]] || 5 || - || Invoice address <br />
|-<br />
| RECHNUNGSEMPFNAME1 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME2 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME3 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFORT || [[#Data types|String]] || 50 || - || Invoice address <br />
|-<br />
| RECHNUNGSEMPFPLZ || [[#Data types|String]] || 10 || - || Invoice address <br />
|-<br />
| RECHNUNGSEMPFSTRASSE || [[#Data types|String]] || 50 || - || Invoice address <br />
|-<br />
| RECHNUNGSNR || [[#Data types|String]] || 20 || - || Invoice number<br />
|-<br />
| SENDUNGSINHALT || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| TELEFONNR || [[#Data types|String]] || 20 || - || Recipient's telephone number<br />
|-<br />
| VORPACKDATUM || [[#Data types|String]] || 10 || - || DD.MM.YYYY<br />
|-<br />
| VERSICHERUNGSWERT || [[#Data types|Decimal]] || 18 || 2 || Amount of insured value<br />
|-<br />
| VWWAEHRUNG || [[#Data types|String]] || 3 || - || Insured value - ISO currency code<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Swap body assigned to this package<br />
|-<br />
| WARENWERT || [[#Data types|Decimal]] || 18 || 2 || Value of goods<br />
|-<br />
| WWWAEHRUNG || [[#Data types|String]] || 3 || - || Value of goods - ISO currency code<br />
|}<br />
<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE UpdateVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- AnonymisiereVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
= Anonymise package data (AnonymisiereVersandDaten) =<br />
The gateway sends the AnonymisiereVersandDaten request to the automatic polling of the HVS32. In the HVS32, customer-related data is thus anonymised for the corresponding data record in accordance with the DSGVO.<br />
This anonymisation is irrevocably and finally carried out at the database level of the dispatch system. A recovery of the original data is therefore no longer possible.<br />
Log files, confirmation files, already transmitted carrier data transmission etc. are not affected by this. Only packages and consignments that have already been completed for the day can be anonymised.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| PACKSTUECKID || [[#Data types|String]] || 20 || - || Package ID of the package to be anonymised.<br />
|-<br />
| TRACKINGNR || [[#Data types|String]] || 35 || - || Tracking number of the package to be anonymised.<br />
|-<br />
| LIEFERSCHEINNR || [[#Data types|String]] || 40 || - || Delivery note number of the consignment to be anonymised.<br />
|-<br />
| AUFTRAGSNR || [[#Data types|String]] || 50 || - || Order number of the item to be anonymised.<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 Packing Station that is to process the anonymisation.<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE AnonymisiereVersandDaten ------------------------------------------------------------------------------- --></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_automatic_polling_functions&diff=5728
HVS32 automatic polling functions
2024-04-22T06:45:54Z
<p>Bhauser: /* Update package data (UpdateVersandDaten) */</p>
<hr />
<div>[[de:HVS32_Automatik-Polling_Funktionen]]<br />
= Data types =<br />
'''Integer''' - Number with only numeric characters (0-9).<br><br />
'''Decimal''' - Number with decimal places<br><br />
'''String''' - Any character from the ISO-8859-1 character set. Maximum length not to be exceeded.<br><br />
= Additional data types =<br />
Additional data types, which occur in the description, are in a 1:n relation to the packages.<br />
Please refer to the respective interface documentation of the corresponding plug-in (file, JDBC, SAP, etc.) to find out how this relation must be realised.<br />
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT UNTERFUNKTIONEN ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- artikelDaten ------------------------------------------------------------------------------- --><br />
== Article data ==<br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
|Satz-Kennung<br />
|[[#Data types|String]]<br />
|3<br />
| -<br />
|'''Only required for file processing'''<br />
"Satzkennung" in the polling file: "ART"<br />
|-<br />
|'''--- ARTICLE DATA SECTION ---'''<br />
|<br />
|<br />
|<br />
|<br />
|-<br />
| ANZAHLBUEGEL || [[#Data types|Integer]] || - || - || Only for hanging shipment: Number of hangers on which the article group is divided up<br />
|-<br />
| ANZAHLPOSETIKETTEN || [[#Data types|Integer]] || - || - || Number of article labels to be printed<br />
|-<br />
| ARTIKELBTNNR || [[#Data types|String]] || 25 || - || BTN number / customs tariff number<br />
|-<br />
| ARTIKELEAN || [[#Data types|String]] || 20 || - || EAN number<br />
|-<br />
| ARTIKELEINHEIT || [[#Data types|String]] || 10 || - || Unit of the article quantity<br />
|-<br />
| ARTIKELGEWICHT || [[#Data types|Decimal]] || 9 || 3 || Article weight<br />
|-<br />
| ARTIKELGRUPPE || [[#Data types|String]] || 50 || - || Article group<br />
|-<br />
| ARTIKELMENGE || [[#Data types|Decimal]] || 9 || 3 || Article quantity<br />
|-<br />
| ARTIKELSERVICES || [[#Data types|String]] || 100 || - || Pipe separate services for this article<br />
|-<br />
| ARTIKELSOLLMENGE || [[#Data types|Decimal]] || 9 || 3 || Article target quantity<br />
|-<br />
| ARTIKELTEXT1 || [[#Data types|String]] || 100 || - || Article description<br />
|-<br />
| ARTIKELTEXT2 || [[#Data types|String]] || 100 || - || Article description<br />
|-<br />
| ARTIKELTEXT3 || [[#Data types|String]] || 100 || - || Article description<br />
|-<br />
| ARTIKELTEXT4 || [[#Data types|String]] || 100 || - || Article description<br />
|-<br />
| ARTIKELVOLUMEN || [[#Data types|Decimal]] || 9 || 3 || Article volume<br />
|-<br />
| ARTIKELWAEHRUNG || [[#Data types|String]] || 3 || - || Currency in which the value of the article is indicated<br />
|-<br />
| ARTIKELWERT || [[#Data types|Decimal]] || 18 || 2 || Value of the article<br />
|-<br />
| CHARGEFLAG || [[#Data types|String]] || 1 || - || <br />
|-<br />
| KUNDENARTIKELNR || [[#Data types|String]] || 50 || - || Article number<br />
|-<br />
| KUNDENBESTELLNR || [[#Data types|String]] || 50 || - || Purchase order number<br />
|-<br />
| POSAUFTRAGNR || [[#Data types|String]] || 50 || - || Order number<br />
|-<br />
| POSLIEFERNR || [[#Data types|String]] || 40 || - || Delivery note number<br />
|-<br />
| POSITIONNR || [[#Data types|String]] || 50 || - || Sequence number within the package<br />
|-<br />
| SERIENNR || [[#Data types|String]] || 30 || - || Serial number<br />
|-<br />
| URSPRUNGLAND || [[#Data types|String]] || 2 || - || Country of origin of the article<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE artikelDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- --><br />
<br />
== Dangerous goods ==<br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
|Satz-Kennung<br />
|[[#Data types|String]]<br />
|3<br />
| -<br />
|'''Only required for file processing'''<br />
"Satzkennung" in the polling file: "GEF"<br />
|-<br />
|'''--- DANGEROUS GOODS DATA SECTION ---'''<br />
|<br />
|<br />
|<br />
|<br />
|-<br />
| GEFAHRGUTBEFOERDKAT || [[#Data types|Integer]] || 1 || - || Transport category, mandatory (see ADR table column (15)), can be 0-4. Attention! Must be correct.<br />
|-<br />
| GEFAHRGUTBEGRENZTEMENGE || [[#Data types|String]] || 1 || - || T if the substance is shipped with status LQ / Limited Quantity according to ADR 3.4, otherwise F, mandatory<br />
|-<br />
| GEFAHRGUTBEZEICHNUNG || [[#Data types|String]] || 110 || - || Mandatory (see ADR table column (2))<br />
|-<br />
| GEFAHRGUTBUCHST640 || [[#Data types|String]] || 1 || - || Letter for special provision 640, conditionally mandatory for substances to which special provision 640 applies (see ADR table column (6)).<br />
|-<br />
| GEFAHRGUTFFCODE || [[#Data types|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG --><br />
|-<br />
| GEFAHRGUTFAKTOR || [[#Data types|Integer]] || 3 || - || Assessment factor for point summation on the transport document, (can be 0, 1, 3, 50 or 999), technically mandatory, but can be clearly concluded from the transport category, therefore it does not necessarily have to be documented<br />
|-<br />
| GEFAHRGUTFREIGESTMENGE || [[#Data types|String]] || 1 || - || T if the substance is shipped with status EQ / Excepted Quantities according to ADR 3.5, otherwise F, mandatory<br />
|-<br />
| GEFAHRGUTID || [[#Data types|String]] || 20 || - || Unique search number for dangerous goods master data<br />
|-<br />
| GEFAHRGUTKCODE || [[#Data types|String]] || 10 || - || Classification code, mandatory (see ADR table column (3b))<br />
|-<br />
| GEFAHRGUTKLASSE || [[#Data types|String]] || 100 || - || Mandatory (see ADR table column (3a))<br />
|-<br />
| GEFAHRGUTMENGE || [[#Data types|Decimal]] || 8 || 3 || Substance quantity of dangerous goods to be declared according to ADR (in litres for liquids and compressed gases, otherwise in kg, for LQ dangerous goods always kg).<br />
|-<br />
| GEFAHRGUTMENGENEINHEIT || [[#Data types|String]] || 2 || - || Unit of measurement for the substance quantity. 1' or 'l': litre ; '0' or 'kg' or empty: kg<br />
|-<br />
| GEFAHRGUTNEBENGEFAHR || [[#Data types|String]] || 10 || - || Conditionally mandatory for substances where subsidiary risk label numbers exist in addition to the main hazard class/label number (see ADR table column (5), if e.g. 3+6.1+8 is entered there, 6.1 and 8 are the subsidiary risk label numbers and are to be transmitted as (6.1)(8) in the subsidiary risk field).<br />
|-<br />
| GEFAHRGUTNETTOEXPLMASSE || [[#Data types|Decimal]] || 8 || 3 || Net explosive mass in kg, only for dangerous goods of class 1<br />
|-<br />
| GEFAHRGUTPOSITIONNR || [[#Data types|Integer]] || - || - || <br />
|-<br />
| GEFAHRGUTTECHBENENNUNG || [[#Data types|String]] || 150 || - || Conditionally mandatory for N.A.G. dangerous goods (i.e. if the designation ends with N.A.G.)<br />
|-<br />
| GEFAHRGUTTUNNELBCODE || [[#Data types|String]] || 10 || - || Tunnel restriction code, mandatory (see ADR table column (15))<br />
|-<br />
| GEFAHRGUTUNNR || [[#Data types|String]] || 10 || - || Mandatory (see ADR table column (1))<br />
|-<br />
| GEFAHRGUTUMWELTGEF || [[#Data types|String]] || 1 || - || T if substance is environmentally hazardous, otherwise F, mandatory for environmentally hazardous substances.<br />
|-<br />
| GEFAHRGUTVPG || [[#Data types|String]] || 3 || - || Packing group, conditionally mandatory for those substances for which it is assigned in the ADR table, may be I,II or III or not assigned at all (the latter e.g. for Class 2)) (see ADR table column (4)).<br />
|-<br />
| GEFAHRGUTVERPANZAHL || [[#Data types|Integer]] || 4 || - || Number of units in which the dangerous goods are packed (in connection with the next field GefahrgutVerpackungsart)<br />
|-<br />
| GEFAHRGUTVERPACKUNGSART || [[#Data types|String]] || 5 || - || ADR code of the type of packaging, e.g. 4G for box (cardboard), mandatory, see separate documentation for packaging codes.<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- VersandDatenAnfrage ------------------------------------------------------------------------------- --><br />
= Package processing (VersandDatenAnfrage) =<br />
The gateway function VersandDatenAnfrage is sent from the data gateway server in automatic polling mode to the HVS32 in order to generate and post a label for a package.<br />
A label is identified for all further functions such as cancellation, loading release, etc. by means of the host-side package ID. This is transferred in the Package ID field and must therefore be unique within the shipping system.<br />
<br />
<br />
By means of an additional configuration in the HVS32, the VersandDatenAnfrage can also be used to initiate a reprint. In this case, the same PackstueckID must be used for the new request.<br><br />
<br><br />
<big>'''Parameters'''</big><br />
<br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| ANSPRECHPARTNER || [[#Data types|String]] || 50 || - || Recipient Contact person<br />
|-<br />
| ANZAHLARTIKEL || [[#Data types|Integer]] || 6 || - || Number of articles (print on label)<br />
|-<br />
| [[#Article data|ARTIKELDATEN]] || [[#Data types|Sequence]] '''[[#Article data|<ArtikelDaten>]]''' || - || - || A list of the [[#Article data|package articles]] of the type '''[[#Article data|ArtikelDaten]]''' (1:n)<br />
|-<br />
| AUFTRAGNR || [[#Data types|String]] || 20 || - || -<br />
|-<br />
| '''AUFTRAGGEBERID''' || [[#Data types|String]] || 10 || - || Mandantenkennung aus dem HVS32<br />
|-<br />
| AVISHINWEIS1 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISHINWEIS2 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISZUSATZ1 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 1<br />
|-<br />
| AVISZUSATZ2 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 2<br />
|-<br />
| BARCODEID || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BARCODETEXT || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BARCODETYP || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BESTELLNR || [[#Data types|String]] || 20 || - || Metro order no. (Metro shipping)<br />
|-<br />
| DRUCKERNAME || [[#Data types|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module)<br />
|-<br />
| EMAIL || [[#Data types|String]] || 100 || - || E-mail address of the recipient (e.g.: for automatic e-mail notification)<br />
|-<br />
| EMPFMOBILFUNKNR || [[#Data types|String]] || 20 || - || Mobile phone number of the recipient<br />
|-<br />
| FAXNR || [[#Data types|String]] || 20 || - || Fax number of the recipient<br />
|-<br />
| FLEXZUSTELLUNGEMAILADRESSE || [[#Data types|String]] || 80 || - || Flex delivery email address<br />
|-<br />
| FRACHTBRIEF || [[#Data types|String]] || 20 || - || Consignment note number if the consignment note is to be printed by the pre-system<br />
|-<br />
| FRACHTFUEHRERKDNR || [[#Data types|String]] || 10 || - || Customer number of the freight payer with the carrier<br />
|-<br />
| FRANKATURKENNUNG || [[#Data types|String]] || 10 || - || -<br />
|-<br />
| [[#Dangerous goods|GEFAHRGUT]] || [[#Data types|Sequence]] '''[[#Dangerous goods|<Gefahrgut>]]''' || - || - || A list of [[#Dangerous goods|Dangerous goods]] of type '''[[#Dangerous goods|Gefahrgut]]''' (1:n)<br />
|-<br />
| GEWICHT || [[#Data types|Decimal]] || 8 || 3 || Gross weight in KG<br />
|-<br />
| HOSTTRACKINGNR || [[#Data types|String]] || 35 || - || Package number from the host system<br />
|-<br />
| ILNNR || [[#Data types|String]] || 20 || - || ILN of the recipient (mandatory for Metro shipping)<br />
|-<br />
| KOSTENSTELLE || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| KUNDENNR || [[#Data types|String]] || 20 || - || Customer number of the recipient with the sender<br />
|-<br />
| LAGERKENNZEICHEN || [[#Data types|Integer]] || - || - || -<br />
|-<br />
| LETZTESPACKSTUECK || [[#Data types|String]] || 1 || - || T/F: T=last packing piece of the consignment (required for printing the consignment hanging card in the case of hanging consignments).<br />
|-<br />
| LIEFERANTENID || [[#Data types|Integer]] || - || - || -<br />
|-<br />
| '''LIEFERSCHEINNR''' || [[#Data types|String]] || 40 || - || Used in the HVS32 as a search number<br />
|-<br />
| NACHNAHME || [[#Data types|Decimal]] || 18 || 2 || -<br />
|-<br />
| NETTOGEWICHT || [[#Data types|Decimal]] || 8 || 3 || Net weight in KG<br />
|-<br />
| NEUTBIC || [[#Data types|String]] || 11 || - || Only used with neutral senders<br />
|-<br />
| NEUTBANKBEZEICHNUNG || [[#Data types|String]] || 40 || - || Only used with neutral senders<br />
|-<br />
| NEUTIBAN || [[#Data types|String]] || 31 || - || Only used with neutral senders<br />
|-<br />
| NEUTKONTOINHABER || [[#Data types|String]] || 40 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERLKZ || [[#Data types|String]] || 3 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME1 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME2 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME3 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERORT || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERPLZ || [[#Data types|String]] || 10 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERSTRASSE || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NNVERMERK || [[#Data types|String]] || 1 || - || 'B': Cash / 'V': Crossed cheque<br />
|-<br />
| NNVERWENDUNG || [[#Data types|String]] || 30 || - || Cash on delivery - Intended use<br />
|-<br />
| NNWAEHRUNG || [[#Data types|String]] || 3 || - || Cash on delivery - ISO currency code<br />
|-<br />
| '''PACKSTKGES''' || [[#Data types|Integer]] || - || - || Total number of colli of the consignment<br />
|-<br />
| '''PACKSTKNR''' || [[#Data types|Integer]] || - || - || Sequence number per consignment<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station that will process the job.<br />
|-<br />
| PACKSTUECKBREITE || [[#Data types|Integer]] || - || - || Width in cm<br />
|-<br />
| PACKSTUECKHOEHE || [[#Data types|Integer]] || - || - || Height in cm<br />
|-<br />
| '''PACKSTUECKID''' || [[#Data types|String]] || 20 || - || Unique number for the parcel in the pre-system. Needed as a unique parcel reference to cancel or load the label later.<br />
|-<br />
| PACKSTUECKLAENGE || [[#Data types|Integer]] || - || - || Length in cm<br />
|-<br />
| PAPERLESSINVOICE || [[#Data types|String]] || 1 || - || Only in UPS PaperlessInvoice case (T=PaperlessInvoice / F=not PaperlessInvoice)<br />
|-<br />
| POSTLEITCODE || [[#Data types|String]] || 15 || - || -<br />
|-<br />
| POSTZIELFRACHTZENT || [[#Data types|String]] || 5 || - || -<br />
|-<br />
| RECHNUNGSEMPFLKZ || [[#Data types|String]] || 5 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFNAME1 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME2 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME3 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFORT || [[#Data types|String]] || 50 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFPLZ || [[#Data types|String]] || 10 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFSTRASSE || [[#Data types|String]] || 50 || - || Invoice address<br />
|-<br />
| RECHNUNGSNR || [[#Data types|String]] || 20 || - || Invoice number<br />
|-<br />
| SENDUNGSINHALT || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| SONDERDIENSTE || [[#Data types|String]] || 30 || - || SPECIAL SERVICES - depending on the shipping method used<br />
|-<br />
| SPERRFLAG || [[#Data types|String]] || 1 || - || T/F: T=lock, otherwise do not lock<br />
|-<br />
| TELEFONNR || [[#Data types|String]] || 20 || - || Recipient's phone number<br />
|-<br />
| TERMINART || [[#Data types|String]] || 1 || - || 'A' = deliver from this day on<br />
'B' = deliver until this day<br />
<br />
'F' = deliver on this day<br />
|-<br />
| TERMINDATUM || [[#Data types|String]] || 10 || - || DD.MM.YYYY<br />
|-<br />
| TERMINZEIT || [[#Data types|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| USTIDNR || [[#Data types|String]] || 20 || - || VAT number of the recipient<br />
|-<br />
| VERPACKUNGSART || [[#Data types|String]] || 6 || - || -<br />
|-<br />
| '''VERSANDARTID''' || [[#Data types|String]] || 10 || - || Dispatch type identifier from the HVS32<br />
|-<br />
| VERSICHERUNGSWERT || [[#Data types|Decimal]] || 18 || 2 || Amount of insured value<br />
|-<br />
| VORPACKDATUM || [[#Data types|String]] || 10 || - || DD.MM.YYYY<br />
|-<br />
| VWWAEHRUNG || [[#Data types|String]] || 3 || - || Insured value - ISO currency code<br />
|-<br />
| WARENWERT || [[#Data types|Decimal]] || 18 || 2 || Value of goods<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Swap body assigned to this package<br />
|-<br />
| WWWAEHRUNG || [[#Data types|String]] || 3 || - || Value of goods - ISO currency code<br />
|-<br />
| ZAHLUNGSBEDINGUNG || [[#Data types|String]] || 10 || - || 'S' = sender, 'R' = receiver<br />
|-<br />
| ZBZOLL || [[#Data types|String]] || 1 || - || Payment condition for customs taxes 'S' = Sender, 'R' = Receiver<br />
|-<br />
| ZIELADRBAHNHOF || [[#Data types|String]] || 30 || - || Postcode and city<br />
|-<br />
| '''ZIELADRLKZ''' || [[#Data types|String]] || 5 || - || Delivery address<br />
|-<br />
| '''ZIELADRNAME1''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME2 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME3 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME4 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| '''ZIELADRORT''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| '''ZIELADRPLZ''' || [[#Data types|String]] || 10 || - || Delivery address<br />
|-<br />
| ZIELADRREGION || [[#Data types|String]] || 20 || - || State/province (e.g.: important for shipments to the USA)<br />
|-<br />
| '''ZIELADRSTRASSE''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|}<br />
<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment|<br />
|-<br />
| AUSGANGDATETIME || [[#Data types|String]] || 10 || - || Date when the label was transmitted to the carrier (DD.MM.YYYY)<br />
|-<br />
| DRUCKDATETIME || [[#Data types|String]] || 19 || - || Date when the label was printed in the HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 if successful<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| GEBUEHR || [[#Data types|Decimal]] || 18 || 2 || Freight costs<br />
|-<br />
| GEBUEHRWAEHRUNG || [[#Data types|String]] || 3 || - || Freight costs - ISO currency code<br />
|-<br />
| PACKSTUECKID || [[#Data types|String]] || 20 || - || PackstueckID from the request<br />
|-<br />
| RETOURTRACKINGNR || [[#Data types|String]] || 50 || - || Package number for the return<br />
|-<br />
| TRACKINGNR || [[#Data types|String]] || 35 || - || Package number<br />
|-<br />
| TRACKINGURL || [[#Data types|String]] || 255 || - || URL of the tracking link<br />
|-<br />
| VERSANDSENDUNGSNR || [[#Data types|String]] || - || - || -<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE VersandDatenAnfrage ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- VersandDatenWdhDruck ------------------------------------------------------------------------------- --><br />
= Reprint label (VersandDatenWdhDruck) =<br />
The gateway function VersandDatenWdhDruck is sent from the data gateway server in automatic polling mode to the HVS32 to reprint a label for a package.<br />
A label is reprinted using the host-side package ID. This is transferred in the PackstueckID field.<br />
Some carriers (e.g. DPD) assign new tracking numbers when reprinting. This means that the old tracking number is no longer valid and the old shipping label must be destroyed.<br />
The new tracking number can be reported back in the response.<br />
<br><br><big>'''Parameters '''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| '''PACKSTUECKID''' || [[#Data types|String]] || 20 || - || '''Unique''' number for the parcel in the pre-system.<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station that will process the job. <br />
|-<br />
| DRUCKERNAME || [[#Data types|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module) <br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| TRACKINGNR || [[#Data types|String]] || 35 || - || (New) tracking number of the package<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE VersandDatenWdhDruck ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- StornoVersandDaten ------------------------------------------------------------------------------- --><br />
= Cancel package (StornoVersandDaten) =<br />
The gateway function StornoVersandDaten is sent from the data gateway server (DGS) in automatic polling mode to the HVS32 to cancel existing packages there that are not yet on an outgoing list.<br />
As a rule, a package is cancelled on the basis of the package ID on the host side. This is transferred in the PackstueckID field.<br />
In addition to the host-side package ID, the tracking number can also contribute to the identification of the package, in case the host-side package ID cannot guarantee uniqueness.<br />
No package/shipment data is available for the feedback. After a successful cancellation, only the field Error with value 0 is reported back - or in case of an error, Error with value 1 and the error Fehlertext1 are reported back.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| '''PACKSTUECKID''' || [[#Data types|String]] || 20 || - || '''Unique''' number for the parcel in the pre-system. <br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station that will process the job.<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error <br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE StornoVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- VerladeVersandDaten ------------------------------------------------------------------------------- --><br />
= Load/release package (VerladeVersandDaten) =<br />
The gateway function VerladeVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to release packages for outgoing.<br />
Only packages that have been released for exit are taken into account for the daily closing. <br />
No package/shipment data is available for the feedback. After successful release, only the field Fehler with value 0 is reported back - or in case of an error, Fehler with value 1 and the error Fehlertext1 are reported back.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| '''PACKSTUECKID''' || [[#Datentypen|String]] || 20 || - || '''Unique''' number for the parcel in the pre-system. <br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32 packing station that will process the job. <br />
|-<br />
| SPERRKENNZEICHEN || [[#Datentypen|String]] || 1 || - || "J" if the package is to be blocked<br />
|-<br />
| WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Swap body on which the package is to be booked<br />
|-<br />
| SAMMELFREIGABE || [[#Datentypen|String]] || 1 || - || "T" for a collective release (release all packages with identical VE-ReferenzNr)<br />
|-<br />
| VEREFERENZNR || [[#Datentypen|String]] || 20 || - || must be filled for a collective release<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Successful, 1 = Error <br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE VerladeVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- Tagesabschluss ------------------------------------------------------------------------------- --><br />
= Daily closing (Tagesabschluss) =<br />
The gateway sends the daily closing request to the automatic polling of the HVS32. A daily closing is thus triggered in the HVS32 on the basis of the additionally transferred parameters.<br />
The daily closing consists of the points generate outgoing list and Generate EDI file.<br />
Only packages that have been released for exit are taken into account for the daily closing. By default, all packages are released unless they have been blocked by the output scanning extension module.<br />
The feedback in the HVS32 takes place after the daily closing has been executed.<br />
No package/shipment data is available for the feedback. After successful day-end closing, only the field Fehler is reported with the value 0 - or in the case of an error, Fehler is reported with the value 1 and the Fehlertext1 .<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station client that is to execute the daily closing.<br />
|-<br />
| FRACHTFUEHRERTYPLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the carriers to be concluded can be entered here. N carriers can be concluded.<br />
(Option MultiFFTagesabschluss must be active in HVS32)<br />
|-<br />
| AUFTRAGGEBERIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the clients to be completed can be entered here. N clients can be concluded.<br />
(Option MultiAGTagesabschluss must be active in HVS32)<br />
|-<br />
| VERSANDARTIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the dispatch types to be completed can be entered here. N shipping types can be completed.<br />
(Option MultiVATagesabschluss must be active in HVS32)<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Indicator of the swap body to be closed. Only certain consignments can be closed with this.<br />
|-<br />
| DRUCKERNAME || [[#Data types|String]] || 30 || - || Name of the output channel on which the list is to be printed.<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE Tagesabschluss ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- Listenabschluss ------------------------------------------------------------------------------- --><br />
= Generate output list (Listenabschluss) =<br />
The gateway sends the generate-output-list request to the automatic polling of the HVS32. An outgoing list is thus generated in the HVS32 on the basis of the additionally transferred parameters.<br />
Only packages that have been released for exit are taken into account for the list closure. By default, all packages are released unless they have been blocked by the output scanning extension module.<br />
The feedback in the HVS32 takes place after the output list has been generated.<br />
No package/shipment data is available for feedback. After successful completion of the list, only the field Error with value 0 is reported back - or in the case of an error, Error with value 1 and the error text1 are reported back.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station client that is to execute the daily closing.<br />
|-<br />
| FRACHTFUEHRERTYPLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the carriers to be concluded can be entered here. N carriers can be concluded.<br />
(Option MultiFFTagesabschluss must be active in HVS32)<br />
|-<br />
| AUFTRAGGEBERIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the clients to be completed can be entered here. N clients can be concluded.<br />
(Option MultiAGTagesabschluss must be active in HVS32)<br />
|-<br />
| VERSANDARTIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the dispatch types to be completed can be entered here. N shipping types can be completed.<br />
(Option MultiVATagesabschluss must be active in HVS32)<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Indicator of the swap body to be closed. Only certain consignments can be closed with this.<br />
|-<br />
| DRUCKERNAME || [[#Data types|String]] || 30 || - || Name of the output channel on which the list is to be printed.<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE Listenabschluss ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- EDIAbschluss ------------------------------------------------------------------------------- --><br />
= Create carrier EDI (EDIAbschluss) =<br />
The gateway sends the create-carrier-EDI request to the automatic polling of the HVS32. A carrier EDI is thus generated in the HVS32 on the basis of the additionally transferred parameters and (if configured) transmitted to the carrier.<br />
Only packages for which an outgoing list was previously generated are taken into account for a carrier EDI.<br />
The confirmation in the HVS32 takes place after the carrier EDI has been generated.<br />
No package/shipment data is available for the confirmation. After successful completion of the EDI, only the field Error with value 0 is reported - or in case of an error, Error with value 1 and the error text1 are reported.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station client that is to execute the daily closing.<br />
|-<br />
| FRACHTFUEHRERTYPLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the carriers to be concluded can be entered here. N carriers can be concluded.<br />
(Option MultiFFTagesabschluss must be active in HVS32)<br />
|-<br />
| AUFTRAGGEBERIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the clients to be completed can be entered here. N clients can be concluded.<br />
(Option MultiAGTagesabschluss must be active in HVS32)<br />
|-<br />
| VERSANDARTIDLIST || [[#Data types|String]] || 250 || - || A semicolon separated list with the dispatch types to be completed can be entered here. N shipping types can be completed.<br />
(Option MultiVATagesabschluss must be active in HVS32)<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Indicator of the swap body to be closed. Only certain consignments can be closed with this.<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE EDIAbschluss ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- VersandDatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
= Verify package data (VersandDatenPruefAnfrage) =<br />
The gateway sends the VersandDatenPruefAnfrage to the automatic polling of the HVS32. A shipping data request is thus simulated in the HVS32.<br />
No labels are printed and the package or label is not booked, but all other processes are identical to the shipping data request (route determination, tracking number determination, address check, etc.).<br />
This function is used to validate all shipping data in advance.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| ANSPRECHPARTNER || [[#Data types|String]] || 50 || - || Recipient Contact person<br />
|-<br />
| ANZAHLARTIKEL || [[#Data types|Integer]] || 6 || - || Number of articles (print on label)<br />
|-<br />
| [[#Article data|ARTIKELDATEN]] || [[#Data types|Sequence]] '''[[#Article data|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#Article data|Package article]] vom Typ '''[[#Article data|ArtikelDaten]]''' (1:n)<br />
|-<br />
| AUFTRAGNR || [[#Data types|String]] || 20 || - || -<br />
|-<br />
| '''AUFTRAGGEBERID''' || [[#Data types|String]] || 10 || - || Client identifier from HVS32<br />
|-<br />
| AVISHINWEIS1 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISHINWEIS2 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISZUSATZ1 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 1<br />
|-<br />
| AVISZUSATZ2 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 2<br />
|-<br />
| BARCODEID || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BARCODETEXT || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BARCODETYP || [[#Data types|String]] || - || - || Additional field for possible extensions<br />
|-<br />
| BESTELLNR || [[#Data types|String]] || 20 || - || Metro order number (Metro shipping)<br />
|-<br />
| DRUCKERNAME || [[#Data types|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module)<br />
|-<br />
| EMAIL || [[#Data types|String]] || 100 || - || Recipient's e-mail address (e.g.: for automatic e-mail notification)<br />
|-<br />
| EMPFMOBILFUNKNR || [[#Data types|String]] || 20 || - || Mobile phone number of the recipient<br />
|-<br />
| FAXNR || [[#Data types|String]] || 20 || - || Fax number of the recipient<br />
|-<br />
| FLEXZUSTELLUNGEMAILADRESSE || [[#Data types|String]] || 80 || - || Flex delivery email address<br />
|-<br />
| FRACHTBRIEF || [[#Data types|String]] || 20 || - || Consignment note number if consignment note is to be printed by pre-system<br />
|-<br />
| FRACHTFUEHRERKDNR || [[#Data types|String]] || 10 || - || Customer number of the freight payer with the carrier<br />
|-<br />
| FRANKATURKENNUNG || [[#Data types|String]] || 10 || - || -<br />
|-<br />
| [[#Dangerous goods|GEFAHRGUT]] || [[#Data types|Sequence]] '''[[#Dangerous goods|<Gefahrgut>]]''' || - || - || A list of [[#Dangerous goods|Dangerous goods]] of type '''[[#Dangerous goods|Gefahrgut]]''' (1:n)<br />
|-<br />
| GEWICHT || [[#Data types|Decimal]] || 8 || 3 || Gross weight in KG<br />
|-<br />
| HOSTTRACKINGNR || [[#Data types|String]] || 35 || - || Package number from the host system<br />
|-<br />
| ILNNR || [[#Data types|String]] || 20 || - || ILN of the recipient (mandatory for Metro shipping)<br />
|-<br />
| KOSTENSTELLE || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| KUNDENNR || [[#Data types|String]] || 20 || - || Customer number of the recipient with the sender<br />
|-<br />
| LAGERKENNZEICHEN || [[#Data types|Integer]] || - || - || -<br />
|-<br />
| LETZTESPACKSTUECK || [[#Data types|String]] || 1 || - || T/F: T=last package of the consignment (required for printing the consignment hanging card for hanging consignments)<br />
|-<br />
| LIEFERANTENID || [[#Data types|Integer]] || - || - || -<br />
|-<br />
| '''LIEFERSCHEINNR''' || [[#Data types|String]] || 40 || - || Used in the HVS32 as a search number<br />
|-<br />
| NACHNAHME || [[#Data types|Decimal]] || 18 || 2 || -<br />
|-<br />
| NETTOGEWICHT || [[#Data types|Decimal]] || 8 || 3 || Net weight in KG<br />
|-<br />
| NEUTBIC || [[#Data types|String]] || 11 || - || Only used with neutral senders<br />
|-<br />
| NEUTBANKBEZEICHNUNG || [[#Data types|String]] || 40 || - || Only used with neutral senders<br />
|-<br />
| NEUTIBAN || [[#Data types|String]] || 31 || - || Only used with neutral senders<br />
|-<br />
| NEUTKONTOINHABER || [[#Data types|String]] || 40 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERLKZ || [[#Data types|String]] || 3 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME1 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME2 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERNAME3 || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERORT || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERPLZ || [[#Data types|String]] || 10 || - || Only used with neutral senders<br />
|-<br />
| NEUTABSENDERSTRASSE || [[#Data types|String]] || 50 || - || Only used with neutral senders<br />
|-<br />
| NNVERMERK || [[#Data types|String]] || 1 || - || 'B': Cash / 'V': Crossed cheque<br />
|-<br />
| NNVERWENDUNG || [[#Data types|String]] || 30 || - || Cash on delivery - Intended use <br />
|-<br />
| NNWAEHRUNG || [[#Data types|String]] || 3 || - || Cash on delivery - ISO currency code <br />
|-<br />
| '''PACKSTKGES''' || [[#Data types|Integer]] || - || - || Total number of colli of the consignment<br />
|-<br />
| '''PACKSTKNR''' || [[#Data types|Integer]] || - || - || Sequence number per consignment<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station that will process the job. <br />
|-<br />
| PACKSTUECKBREITE || [[#Data types|Integer]] || - || - || Width in cm<br />
|-<br />
| PACKSTUECKHOEHE || [[#Data types|Integer]] || - || - || Height in cm<br />
|-<br />
| PACKSTUECKID || [[#Data types|String]] || 20 || - || Unique number for the parcel in the pre-system. Needed as a unique parcel reference to cancel or load the label later. <br />
|-<br />
| PACKSTUECKLAENGE || [[#Data types|Integer]] || - || - || Length in cm<br />
|-<br />
| PAPERLESSINVOICE || [[#Data types|String]] || 1 || - || Only in UPS PaperlessInvoice case (T=PaperlessInvoice / F=not PaperlessInvoice)<br />
|-<br />
| POSTLEITCODE || [[#Data types|String]] || 15 || - || -<br />
|-<br />
| POSTZIELFRACHTZENT || [[#Data types|String]] || 5 || - || -<br />
|-<br />
| RECHNUNGSEMPFLKZ || [[#Data types|String]] || 5 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFNAME1 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME2 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME3 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFORT || [[#Data types|String]] || 50 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFPLZ || [[#Data types|String]] || 10 || - || Invoice address<br />
|-<br />
| RECHNUNGSEMPFSTRASSE || [[#Data types|String]] || 50 || - || Invoice address<br />
|-<br />
| RECHNUNGSNR || [[#Data types|String]] || 20 || - || Invoice number<br />
|-<br />
| SENDUNGSINHALT || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| SONDERDIENSTE || [[#Data types|String]] || 30 || - || SPECIAL SERVICES - depending on the shipping method used<br />
|-<br />
| SPERRFLAG || [[#Data types|String]] || 1 || - || T/F: T=lock, otherwise do not lock<br />
|-<br />
| TELEFONNR || [[#Data types|String]] || 20 || - || Recipient's phone number <br />
|-<br />
| TERMINART || [[#Data types|String]] || 1 || - || 'A' = deliver from this day on <br />
<br />
'B' = deliver until this day<br />
<br />
'F' = deliver on this day <br />
<br />
|-<br />
| TERMINDATUM || [[#Data types|String]] || 10 || - || DD.MM.YYYY<br />
|-<br />
| TERMINZEIT || [[#Data types|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| USTIDNR || [[#Data types|String]] || 20 || - || VAT number of the recipient<br />
|-<br />
| VERPACKUNGSART || [[#Data types|String]] || 6 || - || -<br />
|-<br />
| '''VERSANDARTID''' || [[#Data types|String]] || 10 || - || Dispatch type identifier from the HVS32 <br />
|-<br />
| VERSICHERUNGSWERT || [[#Data types|Decimal]] || 18 || 2 || Amount of insured value<br />
|-<br />
| VORPACKDATUM || [[#Data types|String]] || 10 || - || DD.MM.YYYY<br />
|-<br />
| VWWAEHRUNG || [[#Data types|String]] || 3 || - || Insured value - ISO currency code<br />
|-<br />
| WARENWERT || [[#Data types|Decimal]] || 18 || 2 || Value of goods<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Swap body assigned to this package<br />
|-<br />
| WWWAEHRUNG || [[#Data types|String]] || 3 || - || Value of goods - ISO currency code<br />
|-<br />
| ZAHLUNGSBEDINGUNG || [[#Data types|String]] || 10 || - || 'S' = sender, 'R' = receiver<br />
|-<br />
| ZBZOLL || [[#Data types|String]] || 1 || - || Payment condition for customs taxes 'S' = Sender, 'R' = Receiver<br />
|-<br />
| ZIELADRBAHNHOF || [[#Data types|String]] || 30 || - || Postcode and city<br />
|-<br />
| '''ZIELADRLKZ''' || [[#Data types|String]] || 5 || - || Delivery address<br />
|-<br />
| '''ZIELADRNAME1''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME2 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME3 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| ZIELADRNAME4 || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| '''ZIELADRORT''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|-<br />
| '''ZIELADRPLZ''' || [[#Data types|String]] || 10 || - || Delivery address<br />
|-<br />
| ZIELADRREGION || [[#Data types|String]] || 20 || - || State/province (e.g.: important for shipments to the USA) <br />
|-<br />
| '''ZIELADRSTRASSE''' || [[#Data types|String]] || 50 || - || Delivery address<br />
|}<br />
<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment|<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 if successful<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| GEBUEHR || [[#Data types|Decimal]] || 18 || 2 || Freight costs<br />
|-<br />
| GEBUEHRWAEHRUNG || [[#Data types|String]] || 3 || - || Freight costs ISO currency code<br />
|-<br />
| PACKSTUECKID || [[#Data types|String]] || 20 || - || PackstueckID from the request<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE VersandDatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- UpdateVersandDaten ------------------------------------------------------------------------------- --><br />
= Update package data (UpdateVersandDaten) =<br />
The gateway function UpdateVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to change the data of existing packages.<br />
This request is sent, for example, if the value of goods for a package is only known at a later time.<br />
Data can be updated within the tables Versandeinheit, Abrechnungseinheit and Lieferung. The search is always carried out via the field PackstueckID and, if occupied, also via the field TrackingNr.<br />
<br><br><br />
<br />
'''With this request, however, the fields and content to be updated are no longer checked according to the guidelines of the carrier (e.g. weight limits, etc.). The upstream system must therefore ensure that the updated values match the carrier's guidelines. If this is not possible, this function cannot be used and the label must be canceled and reprocessed. In addition, fields that have already been printed on a label or that have been determined by the HVS32 shipping system in a carrier transaction (e.g. address, route, tracking number, special services, etc.) cannot be manipulated.'''<br><br><br />
<br />
'''ATTENTION: All fields that are to be updated in the shipping system must be coordinated and configured accordingly in the shipping system before using this function!'''<br><br><br />
No package/shipment data is available for the confirmation. After a successful update, only the field Error with value 0 is reported back - or in case of an error, Error with value 1 and the error text1 are reported back.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| '''PACKSTUECKID''' || [[#Data types|String]] || 20 || - || Unique number for the package in the pre-system. Required as a unique package reference to identify the record.<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 packing station that will process the job.<br />
|-<br />
| ANSPRECHPARTNER || [[#Data types|String]] || 50 || - || Recipient Contact person <br />
|-<br />
| AVISHINWEIS1 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISHINWEIS2 || [[#Data types|String]] || 100 || - || -<br />
|-<br />
| AVISZUSATZ1 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 1<br />
|-<br />
| AVISZUSATZ2 || [[#Data types|String]] || 20 || - || Addition to fixed AVIS key 2<br />
|-<br />
| BESTELLNR || [[#Data types|String]] || 20 || - || Metro order number (Metro shipping)<br />
|-<br />
| EMAIL || [[#Data types|String]] || 100 || - || Recipient's e-mail address (e.g.: for automatic e-mail notification)<br />
|-<br />
| EMPFMOBILFUNKNR || [[#Data types|String]] || 20 || - || Mobile phone number of the recipient<br />
|-<br />
| FAXNR || [[#Data types|String]] || 20 || - || Fax number of the recipient<br />
|-<br />
| FLEXZUSTELLUNGEMAILADRESSE || [[#Data types|String]] || 80 || - || Flex delivery email address<br />
|-<br />
| GEWICHT || [[#Data types|Decimal]] || 8 || 3 || Gross weight in KG<br />
|-<br />
| NETTOGEWICHT || [[#Data types|Decimal]] || 8 || 3 || Net weight in KG<br />
|-<br />
| ILNNR || [[#Data types|String]] || 20 || - || ILN of the recipient (mandatory for Metro shipping)<br />
|-<br />
| KOSTENSTELLE || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| LIEFERANTENID || [[#Data types|Integer]] || - || - || -<br />
|-<br />
| NACHNAHME || [[#Data types|Decimal]] || 18 || 2 || -<br />
|-<br />
| NNVERMERK || [[#Data types|String]] || 1 || - || 'B': Cash / 'V': Crossed cheque<br />
|-<br />
| NNVERWENDUNG || [[#Data types|String]] || 30 || - || Cash on delivery - Intended use <br />
|-<br />
| NNWAEHRUNG || [[#Data types|String]] || 3 || - || Cash on delivery - ISO currency code <br />
|-<br />
| PACKSTUECKBREITE || [[#Data types|Integer]] || - || - || Width in cm<br />
|-<br />
| PACKSTUECKHOEHE || [[#Data types|Integer]] || - || - || Height in cm<br />
|-<br />
| PACKSTUECKLAENGE || [[#Data types|Integer]] || - || - || Length in cm<br />
|-<br />
| RECHNUNGSEMPFLKZ || [[#Data types|String]] || 5 || - || Invoice address <br />
|-<br />
| RECHNUNGSEMPFNAME1 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME2 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFNAME3 || [[#Data types|String]] || 50 || - || Invoice recipient<br />
|-<br />
| RECHNUNGSEMPFORT || [[#Data types|String]] || 50 || - || Invoice address <br />
|-<br />
| RECHNUNGSEMPFPLZ || [[#Data types|String]] || 10 || - || Invoice address <br />
|-<br />
| RECHNUNGSEMPFSTRASSE || [[#Data types|String]] || 50 || - || Invoice address <br />
|-<br />
| RECHNUNGSNR || [[#Data types|String]] || 20 || - || Invoice number<br />
|-<br />
| SENDUNGSINHALT || [[#Data types|String]] || 30 || - || -<br />
|-<br />
| TELEFONNR || [[#Data types|String]] || 20 || - || Recipient's telephone number<br />
|-<br />
| VORPACKDATUM || [[#Data types|String]] || 10 || - || DD.MM.YYYY<br />
|-<br />
| VERSICHERUNGSWERT || [[#Data types|Decimal]] || 18 || 2 || Amount of insured value<br />
|-<br />
| VWWAEHRUNG || [[#Data types|String]] || 3 || - || Insured value - ISO currency code<br />
|-<br />
| WECHSELBRUECKE || [[#Data types|String]] || 20 || - || Swap body assigned to this package<br />
|-<br />
| WARENWERT || [[#Data types|Decimal]] || 18 || 2 || Value of goods<br />
|-<br />
| WWWAEHRUNG || [[#Data types|String]] || 3 || - || Value of goods - ISO currency code<br />
|}<br />
<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE UpdateVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- AnonymisiereVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
= Anonymise package data (AnonymisiereVersandDaten) =<br />
The gateway sends the AnonymisiereVersandDaten request to the automatic polling of the HVS32. In the HVS32, customer-related data is thus anonymised for the corresponding data record in accordance with the DSGVO.<br />
This anonymisation is irrevocably and finally carried out at the database level of the dispatch system. A recovery of the original data is therefore no longer possible.<br />
Log files, confirmation files, already transmitted carrier data transmission etc. are not affected by this. Only packages and consignments that have already been completed for the day can be anonymised.<br />
<br><br><big>'''Parameters'''</big><br><br />
<small>'''Bold''' fields must ALWAYS be filled</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| PACKSTUECKID || [[#Data types|String]] || 20 || - || Package ID of the package to be anonymised.<br />
|-<br />
| TRACKINGNR || [[#Data types|String]] || 35 || - || Tracking number of the package to be anonymised.<br />
|-<br />
| LIEFERSCHEINNR || [[#Data types|String]] || 40 || - || Delivery note number of the consignment to be anonymised.<br />
|-<br />
| AUFTRAGSNR || [[#Data types|String]] || 50 || - || Order number of the item to be anonymised.<br />
|-<br />
| PACKPLATZ || [[#Data types|String]] || 10 || - || HVS32 Packing Station that is to process the anonymisation.<br />
|}<br />
<br><big>'''Return parameters'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimal places !! Assignment<br />
|-<br />
| FEHLER || [[#Data types|Integer]] || - || - || 0 = Successful, 1 = Error<br />
|-<br />
| FEHLERTEXT1 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|-<br />
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error <br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE AnonymisiereVersandDaten ------------------------------------------------------------------------------- --></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_JDBC_interface_(automatic_polling)&diff=5727
HVS32 JDBC interface (automatic polling)
2024-04-22T06:45:23Z
<p>Bhauser: /* Update package data (UpdateVersandDaten) */</p>
<hr />
<div>[[de:HVS32_JDBC_Schnittstelle_(Automatik-Polling)]]<br />
<!-- ------------------------------------------------------------------------------- Voraussetzungen ------------------------------------------------------------------------------- --><br />
= Requirements =<br />
{| class="wikitable"<br />
|-<br />
| DGS version || DGS-3_8_1_661 or higher<br />
|-<br />
| DGS Plugins || HVS32Client, JDBC Server<br />
|-<br />
| JDBC Treiber || Latest version of JDBC driver for the used database.<br />
The driver needs to support '''at least''' Java 11 and JDBC 4.2.<br />
|-<br />
|Datenbank<br />
|We support databases from Oracle, Microsoft SQL Server (MSSQL), mySQL, MariaDB, Firebird and IBM (DB2)<br />
Further databases only on request.<br />
<br />
'''Deprecated database versions are not supported.'''<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE Voraussetzungen ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- Funktionsbeschreibung ------------------------------------------------------------------------------- --><br />
<br />
= Description of functions =<br />
The DataGatewayServer (DGS) selects the data records to be processed from the polling table at a configurable interval (default 1000 ms) and transmits them to the HVS32 Client for processing. The data records are selected on the basis of the control field '''[[#Control section|HVS32Verarbeitet]]''' (value = 0).<br><br />
By means of the control field '''[[#Control section|HVS32Funktion]]''', the DGS is informed which function is to be executed for the selected data record.<br><br />
<br />
After the data set has been processed by the HVS32, the feedback is given. Thereby, the value '''[[#Control section|HVS32Verarbeitet]]''' is set to the value 1. If an error should have occurred in the HVS32 during processing, e.g. "The route could not be determined!", the field '''[[#Control section|HVS32Fehler]]''' is additionally set to the value 1 and the error text in '''[[#Control section|HVS32Fehlertext1]]''' + '''[[#Control section|HVS32Fehlertext2]]''' is reported back.<br><br />
<br />
Further "subrequests / -responses" can be configured for the request and response. These SQLs are additionally executed and the data is enriched with the main request / response. For each request/response and subrequest/response, the SQL can be individually adapted and a different database source can be configured.<br />
<br />
In addition, it is possible to configure a Fall Back, which is executed as soon as the request or response fails. For example, if an incorrect data type (alphanumeric instead of numeric values) is transmitted in the request control character or in the response. Furthermore, the case back can be used if no HVS32 clients are connected to the DGS. This is to prevent incorrect data records from being selected again and again and thus running into errors again.<br />
<!-- ------------------------------------------------------------------------------- ENDE Funktionsbeschreibung ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- Steuerungs-Teil ------------------------------------------------------------------------------- --><br />
== Control section ==<br />
The control section is used to define which action is to be carried out with the data set from the database.<br />
{| class="wikitable sortable"<br />
|-<br />
! Field name <br />
!Field name english translation!! Type !! Max length !! Decimal places !! Assignment<br />
|-<br />
| '''ID''' <br />
| ||[[#Data types|Integer]] || - || - || Unique number to identify the record (autocounter).<br />
|-<br />
| '''HVS32Funktion'''<br />
|HVS32Function||[[#DataTypes|Integer]] || - || - || The function number to be executed in HVS32 for the record.<br><br />
1 = [[#Package processing (VersandDatenAnfrage)|VersandDatenAnfrage (en: shipping data request)]]<br><br />
2 = [[#Load/release package (VerladeVersandDaten)|VerladeVersandDaten (en: load shipping data)]]<br><br />
3 = [[#Update package data (UpdateVersandDaten)|UpdateVersandDaten (en: update shipping data)]]<br><br />
4 = [[#Cancel package (StornoVersandDaten)|StornoVersandDaten (en: cancel shipping data)]]<br><br />
5 = [[#Daily Closing (Tagesabschluss)|Tagesabschluss (en: daily closing)]]<br><br />
6 = [[#Verify package data (VersandDatenPruefAnfrage)|VersandDatenPruefAnfrage (en: verify shipping data request)]]<br><br />
7 = [[#Anonymise package data (AnonymisiereVersandDaten)|AnonymisiereVersandDaten (en: anonymise shipping data)]]<br />
|-<br />
| '''HVS32Verarbeitet'''<br />
|HVS32Processed||[[#DataTypes|Integer]] || - || - || Set to 1 after processing in HVS32. Records are selected based on this field.<br />
|-<br />
| HVS32Fehler<br />
|HVS32Error||[[#DataTypes|Integer]] || - || - || If the record has been processed in HVS32 and an error occurred, this value is set to 1.<br />
|-<br />
| HVS32Fehlertext1<br />
|HVS32Errortext1||[[#DataTypes|String]] || 200 || - || Error text in case of error<br />
|-<br />
| HVS32Fehlertext2<br />
|HVS32Errortext2||[[#DataTypes|String]] || 200 || - || Error text in case of error<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE Steuerungs-Teil ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- Verfügbare Funktionen ------------------------------------------------------------------------------- --><br />
<br />
= Available HVS32 functions =<br />
<!-- ------------------------------------------------------------------------------- VersandDatenAnfrage ------------------------------------------------------------------------------- --><br />
=== Package processing (VersandDatenAnfrage) ===<br />
The gateway function VersandDatenAnfrage is sent from the data gateway server in automatic polling mode to the HVS32 to generate and post a label for a package. A label is identified for all further functions such as cancellation, loading release, etc. by means of the package ID on the host side. This is transferred in the PackstueckID field and must therefore be unique within the shipping system.<br />
<br><br><br />
Article and dangerous goods data should each be realised in a separate table with a 1:n relation to the package table. The relation of the tables can be done, for example, via the ID from the [[#Control section|Control section]].<br />
<br><br><br />
'''[[HVS32_automatic_polling_functions#Package processing (VersandDatenAnfrage)|Interface Field Description]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE VersandDatenAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- VerladeDatenAnfrage ------------------------------------------------------------------------------- --><br />
=== Load/release package (VerladeVersandDaten) ===<br />
The gateway function VerladeVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to release packages for outgoing. Only packages that have been released for exit are taken into account for the daily closing.<br />
<br><br><br />
'''[[HVS32_automatic_polling_functions#Load/release package (VerladeVersandDaten)|Interface Field Description]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE VerladeVersandDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- UpdateVersandDaten ------------------------------------------------------------------------------- --><br />
=== Update package data (UpdateVersandDaten) ===<br />
The gateway function UpdateVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 to change the data of existing packages. This request is sent, for example, if the value of goods for a package is only known at a later time. A search is always made via the PackstueckID field and, if occupied, also via the TrackingNr field. <br><br><br />
<br />
'''With this request, however, the fields and content to be updated are no longer checked according to the guidelines of the carrier (e.g. weight limits, etc.). The upstream system must therefore ensure that the updated values match the carrier's guidelines. If this is not possible, this function cannot be used and the label must be canceled and reprocessed. In addition, fields that have already been printed on a label or that have been determined by the HVS32 shipping system in a carrier transaction (e.g. address, route, tracking number, special services, etc.) cannot be manipulated.'''<br><br><br />
<br />
'''ATTENTION: All fields that are to be updated in the shipping system must be coordinated and configured accordingly in the shipping system before using this function!'''<br><br><br />
<br><br><br />
'''[[HVS32_automatic_polling_functions#Update package data (UpdateVersandDaten)|Interface Field Description]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE UpdateVersandDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- StornoVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
=== Cancel package (StornoVersandDaten) ===<br />
The gateway function StornoVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to cancel existing packages there that are not yet on an outgoing list. As a rule, a package is cancelled on the basis of the package ID on the host side. This is transferred in the Packing unit ID field. In addition to the host-side package ID, the tracking number can also help to identify the package, in case the host-side package ID cannot guarantee uniqueness.<br />
<br><br><br />
'''[[HVS32_automatic_polling_functions#Cancel package (StornoVersandDaten)|Interface Field Description]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE StornoVersandDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- VersandDatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
=== Verify package data (VersandDatenPruefAnfrage) ===<br />
The Gateway sends the VersandDatenPruefAnfrage to the automatic polling of the HVS32. A dispatch data request is thus simulated in the HVS32. No labels are printed and the package or label is not booked, but all other processes are identical to the shipping data request (route determination, tracking number determination, address check, etc.) This function is used to validate all shipping data in advance.<br />
<br><br><br />
Article and dangerous goods data should each be realised in a separate table with a 1:n relation to the package table. The relation of the tables can be done, for example, via the ID from the [[#Control section|Control section]].<br />
<br><br><br />
'''[[HVS32_automatic_polling_functions#Verify package data (VersandDatenPruefAnfrage)|Interface Field Description]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE VersandDatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- AnonymisiereVersandDaten ------------------------------------------------------------------------------- --><br />
=== Anonymise package data (AnonymisiereVersandDaten) ===<br />
The gateway sends the AnonymisiereVersandDaten to the automatic polling of the HVS32. In the HVS32, customer-related data is thus anonymised for the corresponding data record in accordance with the DSGVO. This anonymisation is irrevocably and finally carried out at the database level of the dispatch system. A recovery of the original data is therefore no longer possible. Log files, confirmation files, already transmitted carrier data transmission etc. are not affected by this. Only packages and consignments that have already been completed on a daily basis can be anonymised.<br />
<br><br><br />
'''[[HVS32_automatic_polling_functions#Anonymise package data (AnonymisiereVersandDaten)|Interface Field Description]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE AnonymisiereVersandDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- Tagesabschluss ------------------------------------------------------------------------------- --><br />
=== Daily Closing (Tagesabschluss) ===<br />
The gateway sends the daily closing request to the automatic polling of the HVS32. A daily closing is thus triggered in the HVS32 on the basis of the additionally transferred parameters. The daily closing consists of the items [[HVS32_automatic_polling_functions#Generate output list (Listenabschluss)|Generate Outgoing List]] and [[HVS32_automatic_polling_functions#Create carrier EDI (EDIAbschluss)|Create carrier EDI]]. Only packages that have been released for exit are taken into account for the daily closing. By default, all packages are released unless they have been blocked by the output scanning extension module. The feedback in the HVS32 takes place after the daily closing has been executed. No package/shipment data is available for feedback.<br />
<br><br><br />
'''[[HVS32_automatic_polling_functions#Daily closing (Tagesabschluss)|Interface Field Description]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE Tagesabschluss ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ENDE Verfügbare Funktionen ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- Beispiele ------------------------------------------------------------------------------- --><br />
<br />
= Examples =<br />
Please note that the following scripts are only an aid from our side. The administration of the database is the responsibility of the customer.<br> Field names /-lengths /-formats or table names can differ in principle, but in this case must be considered/analysed individually.<br />
<br><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''MySQL'''</div><br />
<div class="mw-collapsible-content"><br />
<source><br />
CREATE TABLE polling_packstueck (<br />
-- Steuerungsteil<br />
ID bigint(20) unsigned NOT NULL auto_increment,<br />
HVS32Funktion int(10) unsigned NOT NULL default 1,<br />
HVS32Verarbeitet int(1) unsigned NOT NULL default 0,<br />
HVS32Fehler int(1) unsigned NOT NULL default 0,<br />
HVS32Fehlertext1 varchar(200) default NULL,<br />
HVS32Fehlertext2 varchar(200) default NULL,<br />
-- Sendungsteil<br />
KundenNr varchar(20) default NULL,<br />
ZielAdrName1 varchar(50) NOT NULL,<br />
ZielAdrName2 varchar(50) default NULL,<br />
ZielAdrName3 varchar(50) default NULL,<br />
ZielAdrStrasse varchar(50) NOT NULL,<br />
ZielAdrLKZ varchar(5) NOT NULL,<br />
ZielAdrPLZ varchar(10) NOT NULL,<br />
ZielAdrOrt varchar(50) NOT NULL,<br />
ZielAdrRegion varchar(20) default NULL,<br />
ZielAdrBahnhof varchar(30) default NULL,<br />
Ansprechpartner varchar(20) default NULL,<br />
TelefonNr varchar(20) default NULL,<br />
FaxNr varchar(20) default NULL,<br />
UstIDNr varchar(20) default NULL,<br />
ILNNr varchar(20) default NULL,<br />
AuftraggeberID varchar(10) NOT NULL,<br />
VersandartID varchar(10) NOT NULL,<br />
AVISHinweis1 varchar(100) default NULL,<br />
AVISHinweis2 varchar(100) default NULL,<br />
AVISZusatz1 varchar(20) default NULL,<br />
AVISZusatz2 varchar(20) default NULL,<br />
LieferscheinNr varchar(40) NOT NULL,<br />
AuftragNr varchar(20) default NULL,<br />
BestellNr varchar(20) default NULL,<br />
Warenwert decimal(18,2) default NULL,<br />
WWWaehrung varchar(3) default NULL,<br />
Nachnahme decimal(18,2) default NULL,<br />
NNWaehrung varchar(3) default NULL,<br />
NNVermerk varchar(1) default NULL,<br />
NNVerwendung varchar(30) default NULL,<br />
Versicherungswert decimal(18,2) default NULL,<br />
VWWaehrung varchar(3) default NULL,<br />
FrankaturKennung varchar(10) default NULL,<br />
Zahlungsbedinung varchar(10) default NULL,<br />
ZBZoll varchar(1) default NULL,<br />
FrachtfuehrerKDNr varchar(10) default NULL,<br />
Sonderdienste varchar(30) default NULL,<br />
SendungsInhalt varchar(30) default NULL,<br />
TerminArt varchar(1) default NULL,<br />
TerminDatum varchar(10) default NULL,<br />
TerminZeit varchar(5) default NULL,<br />
NeutabsenderName1 varchar(30) default NULL,<br />
NeutabsenderName2 varchar(30) default NULL,<br />
NeutabsenderName3 varchar(30) default NULL,<br />
NeutabsenderStrasse varchar(30) default NULL,<br />
NeutabsenderLKZ varchar(3) default NULL,<br />
NeutabsenderPLZ varchar(10) default NULL,<br />
NeutabsenderOrt varchar(30) default NULL,<br />
RechnungsEmpfName1 varchar(50) default NULL,<br />
RechnungsEmpfName2 varchar(50) default NULL,<br />
RechnungsEmpfName3 varchar(50) default NULL,<br />
RechnungsEmpfStr varchar(50) default NULL,<br />
RechnungsEmpfLKZ varchar(5) default NULL,<br />
RechnungsEmpfPLZ varchar(10) default NULL,<br />
RechnungsEmpfOrt varchar(50) default NULL,<br />
PostLeitcode varchar(15) default NULL,<br />
PostZielFrachtzent varchar(5) default NULL,<br />
FrachtBrief varchar(20) default NULL,<br />
-- Packstueckteil<br />
Gewicht decimal(8,3) default NULL,<br />
NettoGewicht decimal(8,3) default NULL,<br />
PackStkGes int(10) unsigned default NULL,<br />
PackStkNr int(10) unsigned default NULL,<br />
Verpackungsart varchar(6) default NULL,<br />
PackstueckLaenge int(10) unsigned default NULL,<br />
PackstueckBreite int(10) unsigned default NULL,<br />
PackstueckHoehe int(10) unsigned default NULL,<br />
Packplatz varchar(10) default NULL,<br />
PackstueckID varchar(15) NOT NULL,<br />
-- Rückmeldung<br />
TrackingNr varchar(35) default NULL,<br />
VersandSendungsNr varchar(20) default NULL,<br />
DruckDateTime varchar(20) default NULL,<br />
AusgangDateTime varchar(10) default NULL,<br />
Gebuehr decimal(8,3) default NULL, <br />
GebuehrWaehrung varchar(3) default NULL,<br />
-- Primärschlüssel<br />
PRIMARY KEY (ID)<br />
) ENGINE=InnoDB DEFAULT CHARSET=latin1;<br />
</source><br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''MSSQL'''</div><br />
<div class="mw-collapsible-content"><br />
<source><br />
CREATE TABLE polling_packstueck (<br />
-- Steuerungsteil<br />
ID bigINT IDENTITY(1,1) NOT NULL,<br />
HVS32Funktion INT NOT NULL default 1,<br />
HVS32Verarbeitet INT NOT NULL default 0,<br />
HVS32Fehler INT NOT NULL default 0,<br />
HVS32Fehlertext1 VARCHAR(200) default NULL,<br />
HVS32Fehlertext2 VARCHAR(200) default NULL,<br />
-- Sendungsteil<br />
KundenNr VARCHAR(20) default NULL,<br />
ZielAdrName1 VARCHAR(50) NOT NULL,<br />
ZielAdrName2 VARCHAR(50) default NULL,<br />
ZielAdrName3 VARCHAR(50) default NULL,<br />
ZielAdrStrasse VARCHAR(50) NOT NULL,<br />
ZielAdrLKZ VARCHAR(5) NOT NULL,<br />
ZielAdrPLZ VARCHAR(10) NOT NULL,<br />
ZielAdrOrt VARCHAR(50) NOT NULL,<br />
ZielAdrRegion VARCHAR(20) default NULL,<br />
ZielAdrBahnhof VARCHAR(30) default NULL,<br />
Ansprechpartner VARCHAR(20) default NULL,<br />
TelefonNr VARCHAR(20) default NULL,<br />
FaxNr VARCHAR(20) default NULL,<br />
UstIDNr VARCHAR(20) default NULL,<br />
ILNNr VARCHAR(20) default NULL,<br />
AuftraggeberID VARCHAR(10) NOT NULL,<br />
VersandartID VARCHAR(10) NOT NULL,<br />
AVISHinweis1 VARCHAR(100) default NULL,<br />
AVISHinweis2 VARCHAR(100) default NULL,<br />
AVISZusatz1 VARCHAR(20) default NULL,<br />
AVISZusatz2 VARCHAR(20) default NULL,<br />
LieferscheinNr VARCHAR(40) NOT NULL,<br />
AuftragNr VARCHAR(20) default NULL,<br />
BestellNr VARCHAR(20) default NULL,<br />
Warenwert NUMERIC(18,2) default NULL,<br />
WWWaehrung VARCHAR(3) default NULL,<br />
Nachnahme NUMERIC(18,2) default NULL,<br />
NNWaehrung VARCHAR(3) default NULL,<br />
NNVermerk VARCHAR(1) default NULL,<br />
NNVerwendung VARCHAR(30) default NULL,<br />
Versicherungswert NUMERIC(18,2) default NULL,<br />
VWWaehrung VARCHAR(3) default NULL,<br />
FrankaturKennung VARCHAR(10) default NULL,<br />
Zahlungsbedinung VARCHAR(10) default NULL,<br />
ZBZoll VARCHAR(1) default NULL,<br />
FrachtfuehrerKDNr VARCHAR(10) default NULL,<br />
Sonderdienste VARCHAR(30) default NULL,<br />
SendungsInhalt VARCHAR(30) default NULL,<br />
TerminArt VARCHAR(1) default NULL,<br />
TerminDatum VARCHAR(10) default NULL,<br />
TerminZeit VARCHAR(5) default NULL,<br />
NeutabsenderName1 VARCHAR(30) default NULL,<br />
NeutabsenderName2 VARCHAR(30) default NULL,<br />
NeutabsenderName3 VARCHAR(30) default NULL,<br />
NeutabsenderStrasse VARCHAR(30) default NULL,<br />
NeutabsenderLKZ VARCHAR(3) default NULL,<br />
NeutabsenderPLZ VARCHAR(10) default NULL,<br />
NeutabsenderOrt VARCHAR(30) default NULL,<br />
RechnungsEmpfName1 VARCHAR(50) default NULL,<br />
RechnungsEmpfName2 VARCHAR(50) default NULL,<br />
RechnungsEmpfName3 VARCHAR(50) default NULL,<br />
RechnungsEmpfStr VARCHAR(50) default NULL,<br />
RechnungsEmpfLKZ VARCHAR(5) default NULL,<br />
RechnungsEmpfPLZ VARCHAR(10) default NULL,<br />
RechnungsEmpfOrt VARCHAR(50) default NULL,<br />
PostLeitcode VARCHAR(15) default NULL,<br />
PostZielFrachtzent VARCHAR(5) default NULL,<br />
FrachtBrief VARCHAR(20) default NULL,<br />
-- Packstueckteil<br />
Gewicht NUMERIC(8,3) default NULL,<br />
NettoGewicht NUMERIC(8,3) default NULL,<br />
PackStkGes INT default NULL,<br />
PackStkNr INT default NULL,<br />
Verpackungsart VARCHAR(6) default NULL,<br />
PackstueckLaenge INT default NULL,<br />
PackstueckBreite INT default NULL,<br />
PackstueckHoehe INT default NULL,<br />
Packplatz VARCHAR(10) default NULL,<br />
PackstueckID VARCHAR(15) NOT NULL,<br />
-- Rückmeldung<br />
TrackingNr VARCHAR(35) default NULL,<br />
VersandSendungsNr VARCHAR(20) default NULL,<br />
DruckDateTime VARCHAR(10) default NULL,<br />
AusgangDateTime VARCHAR(10) default NULL,<br />
Gebuehr NUMERIC(8,3) default NULL, <br />
GebuehrWaehrung VARCHAR(3) default NULL,<br />
AusgangslisteNr INT default NULL<br />
)<br />
</source><br />
</div></div><br />
<br><br />
<!-- <div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Oracle'''</div><br />
<div class="mw-collapsible-content"><br />
<source><br />
<br />
</source><br />
</div></div> --><br />
<!-- ------------------------------------------------------------------------------- ENDE Beispiele ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- FAQ / Troubleshooting ------------------------------------------------------------------------------- --><br />
<br />
= FAQ / Troubleshooting =<br />
<!-- ------------------------------------------------------------------------------- ENDE FAQ / Troubleshooting ------------------------------------------------------------------------------- --></div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_REST_Interface_(Polling)&diff=5726
HVS32 REST Interface (Polling)
2024-04-22T06:44:20Z
<p>Bhauser: /* Update package data (updateVersanddaten) */</p>
<hr />
<div>[[de:HVS32_REST_Schnittstelle_(Automatik-Polling)]]<br />
<br />
<!-- ------------------------------------------------------------------------------- Voraussetzungen ------------------------------------------------------------------------------- --><br />
= Prerequisite =<br />
{| class="wikitable"<br />
|-<br />
| DGS-Version || 3.6.0.595 or higher<br />
|-<br />
| DGS-Plugins || HVS32Client, REST Server<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE Voraussetzungen ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- Funktionsbeschreibung ------------------------------------------------------------------------------- --><br />
<br />
= Function description =<br />
For the REST interface, the DataGatewayServer (DGS) provides a REST server with the following [[#Übersicht der Funktionen|Funktionen]].<br />
This is accessible in the default configuration at '''http://<server name>:<port>/hvs32rest'''. Port 8081 is used, which can be changed if necessary.<br />
<!-- ------------------------------------------------------------------------------- ENDE Funktionsbeschreibung ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- DATENTYPEN ------------------------------------------------------------------------------- --><br />
<br />
= Data types =<br />
'''Integer''' - Number with numeric characters only (0-9).<br><br />
'''Decimal''' - Number with decimal places<br><br />
'''Calendar''' - Date. Month is 0-based (0 = January, 11 = December)<br><br />
'''String''' - Any character from the ISO-8859-1 character set. Maximum length must not be exceeded.<br><br />
'''Binary''' - Base64 encoded binary data<br><br />
'''Sequence''' - A list of elements<br><br />
'''Map''' - Key/Value Map<br><br />
<!-- ------------------------------------------------------------------------------- ENDE DATENTYPEN ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ÜBERSICHT spezial Datentypen ------------------------------------------------------------------------------- --><br />
<br />
= Additional data types =<br />
A special data type can be used within the request/feedback of a [[#Übersicht der Funktionen|Funktion]].<br />
<!-- ------------------------------------------------------------------------------- artikelDaten ------------------------------------------------------------------------------- --><br />
== articleData ==<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">article-data</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max length !! Decimal places !! Assignment<br />
|-<br />
| anzahlBuegel || [[#Datentypen|Integer]] || - || - || Only for hanging shipment: number of hangers on which the article group is split up<br />
|-<br />
| anzahlPosEtiketten || [[#Datentypen|Integer]] || - || - || number of article labels which should be printed<br />
|-<br />
| artikelBTNNr || [[#Datentypen|String]] || 25 || - || BTN number / customs tariff number<br />
|-<br />
| artikelEAN || [[#Datentypen|String]] || 20 || - || EAN number<br />
|-<br />
| artikelEinheit || [[#Datentypen|String]] || 10 || - || Unit of article quantity<br />
|-<br />
| artikelGewicht || [[#Datentypen|Decimal]] || 9 || 3 || Weight of the article<br />
|-<br />
| artikelGruppe || [[#Datentypen|String]] || 50 || - || articlegroup<br />
|-<br />
| artikelMenge || [[#Datentypen|Decimal]] || 9 || 3 || quantity of the article<br />
|-<br />
| artikelServices || [[#Datentypen|String]] || 100 || - || Pipe separate services for this article<br />
|-<br />
| artikelSollMenge || [[#Datentypen|Decimal]] || 9 || 3 || -<br />
|-<br />
| artikelText1 || [[#Datentypen|String]] || 100 || - || article description<br />
|-<br />
| artikelText2 || [[#Datentypen|String]] || 100 || - || article description<br />
|-<br />
| artikelText3 || [[#Datentypen|String]] || 100 || - || article description<br />
|-<br />
| artikelText4 || [[#Datentypen|String]] || 100 || - || article description<br />
|-<br />
| artikelVolumen || [[#Datentypen|Decimal]] || 9 || 3 || volume of the article<br />
|-<br />
| artikelWaehrung || [[#Datentypen|String]] || 3 || - || Currency in which the value of the article is specified<br />
|-<br />
| artikelWert || [[#Datentypen|Decimal]] || 18 || 2 || value of the article<br />
|-<br />
| chargeFlag || [[#Datentypen|String]] || 1 || - || <br />
|-<br />
| kundenArtikelNr || [[#Datentypen|String]] || 50 || - || article number<br />
|-<br />
| kundenBestellNr || [[#Datentypen|String]] || 50 || - || order number<br />
|-<br />
| posAuftragNr || [[#Datentypen|String]] || 50 || - || order number<br />
|-<br />
| posLieferNr || [[#Datentypen|String]] || 40 || - || Delivery note number<br />
|-<br />
| positionNr || [[#Datentypen|String]] || 50 || - || Sequence number within the package<br />
|-<br />
| serienNr || [[#Datentypen|String]] || 30 || - || Serial number<br />
|-<br />
| ursprungLand || [[#Datentypen|String]] || 2 || - || Country of origin of the item<br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE artikelDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- --><br />
<br />
== dangerous goods ==<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Dangerous materials data</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max length !! Decimal places !! Assignment<br />
|-<br />
| '''gefahrgutBefoerdKat''' ||[[#Datentypen|Integer]] || 1 || - || Transport category, mandatory (see ADR table column (15)), can be 0-4. Attention. Must be correct.<br />
|-<br />
| gefahrgutBegrenzteMenge || [[#Datentypen|String]] || 1 || - || T if the substance is shipped with status LQ / Limited Quantity according to ADR 3.4, otherwise F, Mandatory<br />
|-<br />
| '''gefahrgutBezeichnung''' ||[[#Datentypen|String]] || 110 || - || mandatory (see ADR table column (2))<br />
|-<br />
| gefahrgutBuchst640 || [[#Datentypen|String]] || 1 || - || Letter for special provision 640, conditional obligation for substances where special provision 640 applies (see ADR table column (6))<br />
|-<br />
| gefahrgutFFCode || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG --><br />
|-<br />
| gefahrgutFaktor || [[#Datentypen|Integer]] || 3 || - || Evaluation factor for point summation on the transport document, (can be 0, 1, 3, 50 or 999), actually mandatory, but can be clearly concluded from the transport category, therefore it does not necessarily have to be assigned<br />
|-<br />
| gefahrgutFreigestMenge || [[#Datentypen|String]] || 1 || - || T if the substance is shipped with status EQ / Excepted Quantities according to ADR 3.5, otherwise F, mandatory<br />
|-<br />
| gefahrgutID || [[#Datentypen|String]] || 8 || - || Unique search number for dangerous goods master data<br />
|-<br />
| gefahrgutKCode || [[#Datentypen|String]] || 10 || - || Classification code, mandatory (see ADR table column (3b))<br />
|-<br />
| '''gefahrgutKlasse''' ||[[#Datentypen|String]] || 100 || - || Mandatory (see ADR table column (3a))<br />
|-<br />
| '''gefahrgutMenge''' ||[[#Datentypen|Decimal]] || 8 || 3 || Substance quantity of dangerous goods to be declared ADR-technically ( in liters for liquids and compressed gases, otherwise in kg, for LQ dangerous goods always kg )<br />
|-<br />
| '''gefahrgutMengenEinheit''' ||[[#Datentypen|String]] || 2 || - || Unit of quantity for substance quantity. '1' or 'l': liter ; '0' or 'kg' or empty: kg<br />
|-<br />
| gefahrgutNebenGefahr || [[#Datentypen|String]] || 10 || - || conditional obligation for substances where subsidiary hazard tick numbers exist in addition to the main hazard class/tick number (see ADR table column (5), if e.g. 3+6.1+8 is entered there, 6.1 and 8 are the subsidiary hazard tick numbers and to be transmitted as (6.1)(8) in the subsidiary hazard field )<br />
|-<br />
| gefahrgutNettoExplMasse || [[#Datentypen|Decimal]] || 8 || 3 || Net explosive mass in kg, only for dangerous goods of class 1<br />
|-<br />
| gefahrgutPositionNr || [[#Datentypen|Integer]] || - || - || Net explosive mass in kg, only for class 1 dangerous goods<br />
|-<br />
| gefahrgutTechBenennung || [[#Datentypen|String]] || 150 || - || conditionally mandatory for N.A.G. dangerous goods (i.e. if the designation ends with N.A.G.)<br />
|-<br />
| gefahrgutTunnelBCode || [[#Datentypen|String]] || 10 || - || Tunnel restriction code, mandatory (see ADR table column (15))<br />
|-<br />
| '''gefahrgutUNNR''' ||[[#Datentypen|String]] || 10 || - || Mandatory (see ADR table column (1))<br />
|-<br />
| gefahrgutUmweltGef || [[#Datentypen|String]] || 1 || - || T if substance is environmentally hazardous , otherwise F, mandatory for environmentally hazardous substances<br />
|-<br />
| gefahrgutVPG || [[#Datentypen|String]] || 3 || - || Packing group, conditionally obligatory for substances for which this is assigned in the ADR table, can be I,II or III or not assigned at all (the latter e.g. for class 2)) (see ADR table column (4))<br />
|-<br />
| '''gefahrgutVerpAnzahl''' ||[[#Datentypen|Integer]] || 4 || - || Number of units in which the dangerous goods are packed (in connection with the next field Dangerous goods packaging type)<br />
|-<br />
| '''gefahrgutVerpackungsart''' ||[[#Datentypen|String]] || 5 || - || ADR code of packing type, e.g. 4G for box (cardboard), mandatory, see separate doc f. Packaging codes<br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- edistatus ------------------------------------------------------------------------------- --><br />
<br />
== edistatus ==<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">EDIStatus</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max length !! Decimal places !! Assignment<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Successful<br />
|-<br />
| statuscode || [[#Datentypen|String]] || 2 || - || <br />
01 = Carrier file was created.<br><br />
02 = Carrier file was written.<br><br />
03 = Carrier file was sent.<br><br />
11 = Carrier file could not be created.<br><br />
12 = Carrier file could not be written!<br><br />
13 = Carrier file could not be sent!<br><br />
<br />
It is to be noted that not every carrier file is sent, this depends on the HVS32 configuration.<br><br />
I.e. as long as no status "1x" is contained, was proceeded with the carrier file according to the HVS32 configuration.<br />
|-<br />
| statustext || [[#Datentypen|String]] || 200 || - || Plain text of the status code<br />
|-<br />
| fftyp || [[#Datentypen|String]] || 50 || - || Carrier type (e.g. UPS, GLS, DPD)<br />
|-<br />
| dateityp || [[#Datentypen|String]] || 50 || - || Carrier Datatype (e.g.: Standard, Express, etc.)<br />
|-<br />
| auftraggeber || [[#Datentypen|String]] || 10 || - || Client number ('''ATTENTION!''' Not the ClientID)<br />
|-<br />
| ffdateinr || [[#Datentypen|String]] || 10 || - || number of the carrier file (may not be filled in case of error)<br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE edistatus ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- packstueckDaten ------------------------------------------------------------------------------- --><br />
<br />
== packstueckDaten ==<br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Package Data</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! decimals !! occupancy<br />
|-<br />
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Number of items (print on label)<br />
|-<br />
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || A list of the [[#artikelDaten|Packstück-Artikel]] of type '''[[#artikelDaten|ArtikelDaten]]''' (1:n)<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Fieldname / Value=Value)<br />
|-<br />
| barcodeID || [[#Datentypen|String]] || - || - || Additional field for extra extensions<br />
|-<br />
| barcodeText || [[#Datentypen|String]] || - || - || Additional field for extra extensions<br />
|-<br />
| barcodeTyp || [[#Datentypen|String]] || - || - || Additional field for extra extensions<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module) <br />
|-<br />
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || A list of [[#gefahrgut|Gefahrgüter]] of type '''[[#gefahrgut|Gefahrgut]]''' (1:n)<br />
|-<br />
| '''gewicht''' || [[#Datentypen|Decimal]] || 8 || 3 || Gross Mass in kg<br />
|-<br />
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || If the package number from the previous system is to be used. <br />
|-<br />
| infotext1 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext2 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext3 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext4 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext5 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext6 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext7 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext8 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext9 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext10 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=last package in the shipment (is required for hanging shipments to print the shipment hanging card )<br />
|-<br />
| cash on delivery || [[#Datentypen|String]] || 3 || - || Value of goods - ISO currency code<br />
|-<br />
| Net weight || [[#Datentypen|Decimal]] || 8 || 3 || Net weight in KG<br />
|-<br />
| nnVermerk || [[#Datentypen|String]] || 3 || - || cash on delivery - ISO currency code<br />
|-<br />
| nnVerwendung || [[#Datentypen|String]] || 1 || - || 'B' = Bar, 'V' = personal cheque<br />
|-<br />
| nnWaehrung || [[#Datentypen|String]] || 3 || - || cash on delivery - ISO currency code<br />
|-<br />
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Consecutive number per shipment<br />
|-<br />
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Width in cm<br />
|-<br />
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Height in cm<br />
|-<br />
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || '''Unique''' Number for the package in the source system. Is required as a unique package reference to later cancel or load the label.<br />
|-<br />
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Length in cm<br />
|-<br />
| verpackungsart || [[#Datentypen|String]] || 6 || - || -<br />
|-<br />
| insurance value || [[#Datentypen|Decimal]] || 18 || 2 || amount-insured value<br />
|-<br />
| vwWaehrung || [[#Datentypen|String]] || 3 || - || insurance value - ISO currency code<br />
|-<br />
| Value of goods || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Value of goods - ISO currency code<br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE packstueckDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT spezial Datentypen ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- --><br />
<br />
= Overview of the functions =<br />
<!-- ------------------------------------------------------------------------------- echo ------------------------------------------------------------------------------- --><br />
== test interface (echo) ==<br />
For testing the REST interface. Returns the passed message unchanged.<br><br><br />
{| class="wikitable"<br />
|-<br />
| '''Function (method: GET): /hvs32rest/echo/<Message>'''<br />
|}<br />
<br />
<Message> will be returned.<br />
<!-- ------------------------------------------------------------------------------- ENDE echo ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- versanddatenAnfrage ------------------------------------------------------------------------------- --><br />
<br />
== package processing (versanddatenAnfrage) ==<br />
The gateway function versanddatenAnfrage is sent from the data gateway server to the HVS32 in automatic polling mode in order to generate and book a label for a package there. A label is identified for all other functions such as cancellation, loading release, etc. using the package ID on the host side. This is transferred in the PackstueckID field and must therefore be unique within the shipping system.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/versanddatenAnfrage'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br />
<br />
<br><br />
<!-- ------------------------------------------------------------------------------- Request ------------------------------------------------------------------------------- --><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters'''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' highlighted fields need to be filled at all times!</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
|absenderAdresseID<br />
|[[#Datentypen|String]]<br />
|10<br />
| -<br />
| -<br />
|-<br />
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Recipient contact person <br />
|-<br />
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Number of articles (print on label) <br />
|-<br />
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || A list of [[#articleDaten|Packstück-Artikel]] of type '''[[#artikelDaten|ArtikelDaten]]''' (1:n)<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| auftragNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Client ID from the HVS32 <br />
|-<br />
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Addition to fixed AVIS key 1<br />
|-<br />
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Addition to fixed AVIS key 2<br />
|-<br />
| barcodeID || [[#Datentypen|String]] || - || - || Additional field for extra extensions<br />
|-<br />
| barcodeText || [[#Datentypen|String]] || - || - || Additional field for extra extensions<br />
|-<br />
| barcodeTyp || [[#Datentypen|String]] || - || - || Additional field for extra extensions<br />
|-<br />
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro Order Number (Metro Shipping)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module)<br />
|-<br />
| email || [[#Datentypen|String]] || 100 || - || E-mail address of the recipient (e.g. for automatic e-mail notification)<br />
|-<br />
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobile phone number of the recipient<br />
|-<br />
| faxNr || [[#Datentypen|String]] || 20 || - || Recipient's fax number<br />
|-<br />
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex delivery email address<br />
|-<br />
| frachtBrief || [[#Datentypen|String]] || 20 || - || Bill of lading number if bill of lading is to be printed by the upstream system<br />
|-<br />
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Customer number of the freight payer at the carrier<br />
|-<br />
|freiAvis1<br />
|[[#Datentypen|String]]<br />
| -<br />
| -<br />
| -<br />
|-<br />
|freiAvis2<br />
|[[#Datentypen|String]]<br />
| -<br />
| -<br />
| -<br />
|-<br />
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -<br />
|-<br />
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] [[#gefahrgut|<Gefahrgut>]] || - || - || A list of [[#gefahrgut|Gefahrgüter]] of type '''[[#gefahrgut|Gefahrgut]]''' (1:n)<br />
|-<br />
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Gross weight in KG<br />
|-<br />
| hostTrackingNr || [[#Datentypen|String]] || 35 || - ||Packet number from the host system<br />
|-<br />
| ilnNr || [[#Datentypen|String]] || 20 || - || Recipient's ILN (required for Metro shipping)<br />
|-<br />
| infotext1 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext2 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext3 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext4 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext5 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext6 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext7 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext8 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext9 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext10 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| kostenstelle || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| kundenNr || [[#Datentypen|String]] || 20 || - || Customer number of the recipient at the sender<br />
|-<br />
| lagerkennzeichen || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=last package of the shipment (required for hanging shipment to print the shipment hanging card)<br />
|-<br />
| lieferantenID || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Is used in the HVS32 as a search number<br />
|-<br />
| cash on delivery || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| Net weight || [[#Datentypen|Decimal]] || 8 || 3 || Net weight in KG<br />
|-<br />
| neutBIC || [[#Datentypen|String]] || 11 || - || Only assigned to neutral senders<br />
|-<br />
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Only assigned to neutral senders<br />
|-<br />
| neutIBAN || [[#Datentypen|String]] || 31 || - || Only assigned to neutral senders<br />
|-<br />
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': personal cheque<br />
|-<br />
| nnVerwendung || [[#Datentypen|String]] || 30 || - || cash on delivery usage<br />
|-<br />
| nnWaehrung || [[#Datentypen|String]] || 3 || - || cash on delivery - ISO currency code<br />
|-<br />
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Total number of packages in the shipment<br />
|-<br />
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Consecutive number per shipment<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32 packing station client that is to process the order.<br />
|-<br />
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Width in cm<br />
|-<br />
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Height in cm<br />
|-<br />
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || Unique number for the package in the source system. Is required as a unique package reference to later cancel or load the label.<br />
|-<br />
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Length in cm<br />
|-<br />
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Only in the UPS PaperlessInvoice case (T=PaperlessInvoice / F=not PaperlessInvoice)<br />
|-<br />
| postLeitcode || [[#Datentypen|String]] || 15 || - || -<br />
|-<br />
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -<br />
|-<br />
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Billing address <br />
|-<br />
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Billing address <br />
|-<br />
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Billing address <br />
|-<br />
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Billing address <br />
|-<br />
| rechnungsNr || [[#Datentypen|String]] || 20 || - || bill number<br />
|-<br />
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| sonderdienste || [[#Datentypen|String]] || 30 || - || Shipping type-specific<br />
|-<br />
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=lock, otherwise don't lock<br />
|-<br />
| telefonNr || [[#Datentypen|String]] || 20 || - || Recipient's phone number<br />
|-<br />
| terminArt || [[#Datentypen|String]] || 1 || - || 'A' = deliver from this day<br />
'B' = deliver by this date<br />
<br />
'F' = an diesem Tag liefern<br />
|-<br />
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| ustIDNr || [[#Datentypen|String]] || 20 || - || VAT number of the recipient<br />
|-<br />
| verpackungsart || [[#Datentypen|String]] || 6 || - || -<br />
|-<br />
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Shipping type identifier from the HVS32<br />
|-<br />
| insurance value || [[#Datentypen|Decimal]] || 18 || 2 || Amount of insurance value <br />
|-<br />
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| vwWaehrung || [[#Datentypen|String]] || 3 || - || insurance value - ISO currency code<br />
|-<br />
| Value of goods || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Swap body assigned to this package<br />
|-<br />
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Value of goods - ISO currency code<br />
|-<br />
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = recipient<br />
|-<br />
| zbZoll || [[#Datentypen|String]] || 1 || - || Terms of payment for customs taxes 'S' = Sender, 'R' = recipient<br />
|-<br />
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || Postal code and city<br />
|-<br />
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || delivery address <br />
|-<br />
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || delivery address <br />
|-<br />
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || State/Province (e.g. important for shipments to the USA)<br />
|-<br />
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE Request ------------------------------------------------------------------------------- --><br />
<br><br />
<!-- ------------------------------------------------------------------------------- Response ------------------------------------------------------------------------------- --><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy |<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Date when the label was sent to the carrier (DD.MM.YYYY)<br />
|-<br />
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Date when the label was sent to the carrier (DD.MM.YYYY)<br />
|-<br />
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Date when the label was printed in HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Date when the label was printed in HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| etikettDaten || [[#Datentypen|String]] || - || - || Label binary data<br />
|-<br />
| etikettName || [[#Datentypen|String]] || - || - || Label template name<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 if successful<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || freight charges<br />
|-<br />
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Freight costs ISO currency code<br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID from the request<br />
|-<br />
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Parcel number for the return<br />
|-<br />
| trackingNr || [[#Datentypen|String]] || 35 || - || package number<br />
|-<br />
| trackingURL || [[#Datentypen|String]] || 255 || - || URL of the tracking link for shipment tracking<br />
|-<br />
| versandSendungsNr || [[#Datentypen|String]] || - || - || -<br />
|-<br />
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name and binary data of the additional labels as key/value map<br />
|-<br />
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|}<br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE Response ------------------------------------------------------------------------------- --><br />
<br><br />
<!-- ------------------------------------------------------------------------------- Beispiel ------------------------------------------------------------------------------- --><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Examples</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"absenderAdresseID": "",<br />
"ansprechpartner": "",<br />
"assoc": {<br />
"":""<br />
},<br />
"artikelDaten": [<br />
{<br />
"anzahlBuegel": 0,<br />
"anzahlPosEtiketten": 0,<br />
"artikelBTNNr": "",<br />
"artikelEAN": "",<br />
"artikelEinheit": "",<br />
"artikelGewicht": 0,<br />
"artikelGruppe": "",<br />
"artikelMenge": 0,<br />
"artikelServices": "",<br />
"artikelSollMenge": 0,<br />
"artikelText1": "",<br />
"artikelText2": "",<br />
"artikelText3": "",<br />
"artikelText4": "",<br />
"artikelVolumen": 0,<br />
"artikelWaehrung": "",<br />
"artikelWert": 0,<br />
"chargeFlag": "",<br />
"kundenArtikelNr": "",<br />
"kundenBestellNr": "",<br />
"posAuftragNr": "",<br />
"posLieferNr": "",<br />
"positionNr": "",<br />
"serienNr": "",<br />
"ursprungLand": ""<br />
}<br />
],<br />
"auftragNr": "",<br />
"auftraggeberID": "",<br />
"avisHinweis1": "",<br />
"avisHinweis2": "",<br />
"avisZusatz1": "",<br />
"avisZusatz2": "",<br />
"bestellNr": "",<br />
"druckername": "",<br />
"email": "",<br />
"faxNr": "",<br />
"frachtBrief": "",<br />
"frachtfuehrerKdNr": "",<br />
"freiAvis1": "",<br />
"freiAvis2": "",<br />
"frankaturKennung": "",<br />
"gefahrgut": [<br />
{<br />
"gefahrgutBefoerdKat": 0,<br />
"gefahrgutBegrenzteMenge": "",<br />
"gefahrgutBezeichnung": "",<br />
"gefahrgutBuchst640": "",<br />
"gefahrgutFFCode": "",<br />
"gefahrgutFaktor": 0,<br />
"gefahrgutFreigestMenge": "",<br />
"gefahrgutKCode": "",<br />
"gefahrgutKlasse": "",<br />
"gefahrgutMenge": 0,<br />
"gefahrgutMengenEinheit": "",<br />
"gefahrgutNebenGefahr": "",<br />
"gefahrgutNettoExplMasse": 0,<br />
"gefahrgutTunnelBCode": "",<br />
"gefahrgutUNNR": "",<br />
"gefahrgutUmweltGef": "",<br />
"gefahrgutVPG": "",<br />
"gefahrgutVerpAnzahl": 0,<br />
"gefahrgutVerpackungsart": ""<br />
}<br />
],<br />
"gewicht": 0,<br />
"ilnNr": "",<br />
"infotext1": "",<br />
"infotext2": "",<br />
"infotext3": "",<br />
"infotext4": "",<br />
"infotext5": "",<br />
"infotext6": "",<br />
"infotext7": "",<br />
"infotext8": "",<br />
"infotext9": "",<br />
"infotext10": "",<br />
"kostenstelle": "",<br />
"kundenNr": "",<br />
"lieferscheinNr": "",<br />
"cash on delivery ": 0,<br />
"Net weight": 0,<br />
"neutabsenderLKZ": "",<br />
"neutabsenderName1": "",<br />
"neutabsenderName2": "",<br />
"neutabsenderName3": "",<br />
"neutabsenderOrt": "",<br />
"neutabsenderPLZ": "",<br />
"neutabsenderStrasse": "",<br />
"nnVermerk": "",<br />
"nnVerwendung": "",<br />
"nnWaehrung": "",<br />
"packStkGes": 0,<br />
"packStkNr": 0,<br />
"packplatz": "",<br />
"packstueckBreite": 0,<br />
"packstueckHoehe": 0,<br />
"packstueckID": "",<br />
"packstueckLaenge": 0,<br />
"paperlessInvoice": "",<br />
"postLeitcode": "",<br />
"postZielFrachtzent": "",<br />
"rechnungsEmpfLKZ": "",<br />
"rechnungsEmpfName1": "",<br />
"rechnungsEmpfName2": "",<br />
"rechnungsEmpfName3": "",<br />
"rechnungsEmpfOrt": "",<br />
"rechnungsEmpfPLZ": "",<br />
"rechnungsEmpfStrasse": "",<br />
"sendungsinhalt": "",<br />
"sonderdienste": "",<br />
"telefonNr": "",<br />
"terminArt": "",<br />
"terminDatum": "",<br />
"terminZeit": "",<br />
"ustIDNr": "",<br />
"verpackungsart": "",<br />
"versandartID": "",<br />
"insurance value": 0,<br />
"vwWaehrung": "",<br />
"Value of goods ": 0,<br />
"wwWaehrung": "",<br />
"zahlungsbedingung": "",<br />
"zbZoll": "",<br />
"zielAdrBahnhof": "",<br />
"zielAdrLKZ": "",<br />
"zielAdrName1": "",<br />
"zielAdrName2": "",<br />
"zielAdrName3": "",<br />
"zielAdrOrt": "",<br />
"zielAdrPLZ": "",<br />
"zielAdrRegion": "",<br />
"zielAdrStrasse": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"assoc": {<br />
"":""<br />
},<br />
"packstueckID": "",<br />
"trackingNr": "",<br />
"retourTrackingNr": "",<br />
"versandSendungsNr": "",<br />
"druckDateTime": "",<br />
"ausgangDateTime": "",<br />
"gebuehr": 0,<br />
"gebuehrWaehrung": "",<br />
"fehlertext1": "",<br />
"fehlertext2": "",<br />
"etikettName": "",<br />
"etikettDaten": "",<br />
"zusatzEtikettenDaten": {<br />
"": ""<br />
},<br />
"trackingURL": "",<br />
"zusatzfeld1": "",<br />
"zusatzfeld2": "",<br />
"zusatzfeld3": "",<br />
"zusatzfeld4": "",<br />
"zusatzfeld5": "",<br />
"zusatzfeld6": "",<br />
"zusatzfeld7": "",<br />
"zusatzfeld8": "",<br />
"zusatzfeld9": "",<br />
"zusatzfeld10": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE Beispiel ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ENDE versanddatenAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- versanddatenNachdruckAnfrage ------------------------------------------------------------------------------- --><br />
<br />
==reprint label (versanddatenNachdruckAnfrage) ==<br />
The gateway function versanddatenReprintRequest is sent by the data gateway server in automatic polling mode to the HVS32 in order to reprint a label for a package there. A label is reprinted using the host-side package ID. This is transferred in the PackstueckID field. Some carriers (e.g. DPD) assign new tracking numbers when reprinting. The old tracking number is therefore no longer valid and the old shipping label must be destroyed. The new tracking number can be reported back in the feedback.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/versanddatenNachdruckAnfrage'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''bold''' fields must always be occupied</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the label is printed.<br />
|-<br />
| packplatz|| [[#Datentypen|String]] || 10 || - || Name of an output channel (printer) in the HVS32 via which the label is <br />
|-<br />
| '''packstueckID''' || [[#Datentypen|String]] || 30 || - || '''Unique''' number for the package in the source system. <br />
|-<br />
| trackingNr|| [[#Datentypen|String]] || 35 || - || package number<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy |<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Date when the label was sent to the carrier (DD.MM.YYYY)<br />
|-<br />
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Date when the label was sent to the carrier (DD.MM.YYYY)<br />
|-<br />
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Date when the label was printed in HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Date when the label was printed in HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| etikettDaten || [[#Datentypen|String]] || - || - || Label binary data<br />
|-<br />
| etikettName || [[#Datentypen|String]] || - || - || Label template name<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 if successful<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || freight charges<br />
|-<br />
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Freight costs ISO currency code<br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID from the request<br />
|-<br />
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Parcel number for the return<br />
|-<br />
| trackingNr || [[#Datentypen|String]] || 35 || - || package number<br />
|-<br />
| trackingURL || [[#Datentypen|String]] || 255 || - || URL of the tracking link for shipment tracking<br />
|-<br />
| versandSendungsNr || [[#Datentypen|String]] || - || - || -<br />
|-<br />
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name and binary data of the additional labels as key/value map<br />
|-<br />
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"druckername": "",<br />
"packplatz": "",<br />
"packstueckID": "",<br />
"trackingNr": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"assoc": {<br />
"":""<br />
},<br />
"packstueckID": "",<br />
"trackingNr": "",<br />
"retourTrackingNr": "",<br />
"versandSendungsNr": "",<br />
"druckDateTime": "",<br />
"ausgangDateTime": "",<br />
"gebuehr": 0,<br />
"gebuehrWaehrung": "",<br />
"fehlertext1": "",<br />
"fehlertext2": "",<br />
"etikettName": "",<br />
"etikettDaten": "",<br />
"zusatzEtikettenDaten": {<br />
"": ""<br />
},<br />
"trackingURL": "",<br />
"zusatzfeld1": "",<br />
"zusatzfeld2": "",<br />
"zusatzfeld3": "",<br />
"zusatzfeld4": "",<br />
"zusatzfeld5": "",<br />
"zusatzfeld6": "",<br />
"zusatzfeld7": "",<br />
"zusatzfeld8": "",<br />
"zusatzfeld9": "",<br />
"zusatzfeld10": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE versanddatenNachdruckAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- stornoVersanddaten ------------------------------------------------------------------------------- --><br />
<br />
== cancel package(stornoVersanddaten) ==<br />
The gateway function stornoVersanddaten is sent from the data gateway server to the HVS32 in automatic polling mode in order to cancel existing packages that are not yet on an outgoing list. As a rule, a package is canceled using the package ID on the host side. This is transferred in the PackstueckID field. In addition to the host-side package ID, the TrackingNr can also contribute to the identification of the package in the event that the host-side package ID cannot guarantee uniqueness. There are no package/shipment data available for confirmation. After a successful reversal, only the error field is returned with the value 0 - or in the event of an error, the error is returned with the value 1 and Fehlertext1.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/stornoVersanddaten'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' fields must ALWAYS be filled </small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| packplatz|| [[#Datentypen|String]] || 10 || - || Name of an output channel (printer) in the HVS32 via which the label is <br />
|-<br />
| '''packstueckID'''|| [[#Datentypen|String]] || 30 || - || '''Unique''' number for the package in the source system. <br />
|-<br />
| trackingNr|| [[#Datentypen|String]] || 35 || - || package number<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Successful<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"packplatz": "",<br />
"packstueckID": "",<br />
"trackingNr": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"fehlertext2": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE stornoversanddaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- verladeVersandaten ------------------------------------------------------------------------------- --><br />
== Load / release package(verladeVersanddaten) ==<br />
The gateway function verladeVersanddaten is sent by the data gateway server in automatic polling mode to the HVS32 in order to release packages there for exit. Only packages that have been released for exit are taken into account for the daily closing. There are no package/shipment data available for confirmation. After successful release, only the error field is returned with the value 0 - or in the event of an error, the error is returned with the value 1 and Fehlertext1.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/verladeVersanddaten'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' fields must ALWAYS be filled </small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| hostFreigabeNr || [[#Datentypen|String]] || 20 || - || Host-side release number that is set for this package.<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || Name of an output channel (printer) in the HVS32 via which the label is <br />
|-<br />
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || Unique number for the package in the source system. <br><br />
When printing the label, the same ID must have been transferred beforehand so that the HVS32 can clearly identify the package to be loaded.<br />
|-<br />
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Swap body assigned to this package.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Successful<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"hostFreigabeNr": "",<br />
"packplatz": "",<br />
"packstueckID": "",<br />
"wechselbruecke": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"fehlertext2": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE verladeVersandaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- sperreVersanddaten ------------------------------------------------------------------------------- --><br />
<br />
== lock package (sperreVersanddaten) ==<br />
The gateway function sperreVersanddaten is sent by the data gateway server in automatic polling mode to the HVS32 in order to block packages for exit there. Blocked packages are not taken into account for the daily closing. There are no package/shipment data available for confirmation. After successful blocking, only the error field is returned with the value 0 - or in the event of an error, the error is returned with the value 1 and Fehlertext1.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/sperreVersanddaten'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' fields must ALWAYS be filled </small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| packplatz|| [[#Datentypen|String]] || 10 || - || Name of an output channel (printer) in the HVS32 via which the label is <br />
|-<br />
| '''packstueckID'''|| [[#Datentypen|String]] || 20 || - || '''Unique''' number for the package in the source system. <br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Successful<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"packplatz": "",<br />
"packstueckID": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"fehlertext2": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE sperreversanddaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- tagesabschluss ------------------------------------------------------------------------------- --><br />
<br />
== End of day (tagesabschluss) ==<br />
The gateway sends the tagesabschluss request to the automatic polling of the HVS32. In the HVS32, a daily closing is thus triggered using the additionally transferred parameters. The daily closing consists of the items Generate outbound list and Generate EDI carrier. Only packages that have been released for exit are taken into account for the daily closing. By default, all packages are released unless they have been blocked by the Outgoing Scan extension module. The feedback in the HVS32 takes place after the daily closing has been carried out. There are no package/shipment data available for confirmation. After a successful end of day, only the error field is returned with the value 0 - or in the event of an error, the error is returned with the value 1 and Fehlertext1.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/tagesabschluss'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' fields must ALWAYS be filled </small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| auftraggeberID || [[#Datentypen|Sequence<String>]] || 255 || - || A semicolon-separated list with the clients to be closed can be given here. n clients can be concluded.<br />
(Option MultiAGTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the lists are to be printed.<br />
(Requires printer spooler extension module)<br />
|-<br />
| frachtfuehrerTyp || [[#Datentypen|Sequence<String>]] || 255 || - || A semicolon-separated list with the freight forwarders to be concluded can be given here. n carriers can be contracted.<br />
(MultiFFTagesabschluss option must be active in HVS32)<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32 packing station client that is to carry out the list closure.<br />
|-<br />
| versandartID || [[#Datentypen|Sequence<String>]] || 255 || - || A semicolon-separated list with the shipping methods to be completed can be given here. n types of shipping can be contracted.<br />
(MultiVATagesabschluss option must be active in HVS32)<br />
|-<br />
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Identification of the swap body to be locked. Only certain shipments can be completed with this.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] '''[[#Sequence|<EDIStatus>]]''' || - || - || -<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Successful<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name and binary data of the lists as a key/value map.<br />
|-<br />
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Label name and binary data as key/value map.<br />
|-<br />
| ausgangsListeNr|| [[#Datentypen|Sequence<String>]] || - || - || Output list number(s) of the generated output list(s).<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"auftraggeberID": [<br />
""<br />
],<br />
"druckername": "",<br />
"frachtfuehrerTyp": [<br />
""<br />
],<br />
"packplatz": "",<br />
"versandartID": [<br />
""<br />
],<br />
"wechselbruecke": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"assoc": {<br />
"":""<br />
},<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"edistatus": [<br />
{<br />
"fehlercode": 0,<br />
"statuscode": "",<br />
"statustext": "",<br />
"fftyp": "",<br />
"dateityp": "",<br />
"auftraggeber": "",<br />
"ffdateinr": ""<br />
}<br />
],<br />
"listenDaten": {},<br />
"ausgangsListeNr": [<br />
"75"<br />
]<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE tagesabschluss ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- listenabschlussAnfrage ------------------------------------------------------------------------------- --><br />
<br />
== Generate output list (listenabschlussAnfrage) ==<br />
The gateway sends the listenabschlussAnfrage request to the automatic polling of the HVS32. An output list is thus generated in the HVS32 using the additionally transferred parameters. Only packages that have been released for exit are considered for the end of the list. By default, all packages are released unless they have been blocked by the Outgoing Scan extension module. The feedback in the HVS32 takes place after the output list has been generated. There are no package/shipment data available for confirmation. After successful completion of the list, only the Error field is returned with the value 0 - or in the event of an error, the Error is returned with the value 1 and Error text1.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/listenabschlussAnfrage'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' fields must ALWAYS be filled </small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| auftraggeberID || [[#Datentypen|String]] || 255 || - || A semicolon-separated list with the clients to be closed can be given here. n clients can be concluded.<br />
(Option MultiAGTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the lists are to be printed.<br />
(Requires printer spooler extension module)<br />
|-<br />
| frachtfuehrerTyp || [[#Datentypen|String]] || 255 || - || A semicolon-separated list with the freight forwarders to be concluded can be given here. n carriers can be contracted.<br />
(MultiFFTagesabschluss option must be active in HVS32)<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32 packing station client that is to carry out the list closure.<br />
|-<br />
| versandartID || [[#Datentypen|String]] || 255 || - || A semicolon-separated list with the shipping methods to be completed can be given here. n types of shipping can be contracted.<br />
(MultiVATagesabschluss option must be active in HVS32)<br />
|-<br />
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Identification of the swap body to be locked. Only certain shipments can be completed with this.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Successful<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name and binary data of the lists as a key/value map.<br />
|-<br />
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Label name and binary data as key/value map.<br />
|-<br />
| ausgangsListeNr|| [[#Datentypen|Sequence<String>]] || - || - || Output list number(s) of the generated output list(s).<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"auftraggeberID": [<br />
""<br />
],<br />
"druckername": "",<br />
"frachtfuehrerTyp": [<br />
""<br />
],<br />
"packplatz": "",<br />
"versandartID": [<br />
""<br />
],<br />
"wechselbruecke": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"assoc": {<br />
"":""<br />
},<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"listenDaten": {<br />
"": ""<br />
},<br />
"ausgangsListeNr": [<br />
"75"<br />
]<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE Listenabschluss ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ListenNachdruck------------------------------------------------------------------------------- --><br />
<br />
== reprint outgoing list (listenNachdruckAnfrage) ==<br />
The gateway sends the listenNachdruckAnfrage request to the automatic polling of the HVS32. In the HVS32, an output list that has already been created is then reprinted using the output list number that was transferred. A list can only be reprinted if it has already been generated using the functions daily closing, list closing request or manually using the HVS32 mask. There are no package/shipment data available for confirmation. After successful completion of the list, only the Error field is returned with the value 0 - or in the event of an error, the Error is returned with the value 1 and Fehlertext1.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/listenNachdruckAnfrage'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' fields must ALWAYS be filled </small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| ausgangsListeNr || [[#Datentypen|Sequence<String>]] || - || - || List of output list no. of the lists to be reprinted.<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the lists are to be printed.<br />
(Requires printer spooler extension module)<br />
|-<br />
| auftraggeberID || [[#Datentypen|Sequence<String>]] || - || - || List of client IDs for which the lists are to be reprinted.<br />
|-<br />
| frachtFuehrerTyp || [[#Datentypen|Sequence<String>]] || - || - || List of carrier types for which the lists are to be reprinted.<br />
|-<br />
| erstellDatum || [[#Datentypen|String]] || 10 || - || Creation date of the outgoing lists to be reprinted. In the format "dd.mm.yyyy", e.g. 01.01.2001<br />
|-<br />
| druckDatum || [[#Datentypen|String]] || 10 || - || Print date of the outgoing lists to be reprinted. In the format "dd.mm.yyyy", e.g. 01.01.2001 or zero if only lists that have not yet been printed are to be reprinted<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| ausgangsListeNr || [[#Datentypen|Sequence<String>]] || - || - || List of output list no. of the lists that have been reprinted.<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Successful<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name and binary data of the lists as a key/value map.<br />
|-<br />
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Label name and binary data as key/value map.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"ausgangsListeNr": [<br />
"77"<br />
],<br />
"druckername": "",<br />
"auftraggeberID": [], <br />
"frachtFuehrerTyp": [], <br />
"erstellDatum": "", <br />
"druckDatum": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"ausgangsListeNr": [<br />
"77"<br />
]<br />
"assoc": {<br />
"":""<br />
},<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"listenDaten": {<br />
"": ""<br />
}<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE ListenNachdruck ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ediabschlussAnfrage ------------------------------------------------------------------------------- --><br />
<br />
== Generate carrier EDI (ediabschlussAnfrage) ==<br />
The gateway sends the ediabschlussAnfrage request to the automatic polling of the HVS32. In the HVS32, a carrier EDI is generated based on the additionally transferred parameters and (if configured) transmitted to the carrier. Only packages for which an outgoing list was previously generated are taken into account for a carrier EDI. The feedback in the HVS32 takes place after the carrier EDI has been generated. There are no package/shipment data available for confirmation. After successful EDI completion, only the error field is reported with the value 0 - or in the event of an error, the error is reported with the value 1 Fehlertext1.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/ediabschlussAnfrage'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' fields must ALWAYS be filled </small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| auftraggeberID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || A semicolon-separated list with the clients to be closed can be given here. n clients can be concluded.<br />
(Option MultiAGTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which, for example, the UPS summary is printed.<br><br />
(Requires printer spooler extension module)<br />
|-<br />
| frachtfuehrerTyp || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || A semicolon-separated list with the freight forwarders to be concluded can be given here. n carriers can be contracted.<br />
(MultiFFTagesabschluss option must be active in HVS32)<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32 packing station client that is to carry out the daily closing.<br />
|-<br />
| versandartID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || A semicolon-separated list with the shipping methods to be completed can be given here. n types of shipping can be contracted.<br />
(MultiVATagesabschluss option must be active in HVS32)<br />
|-<br />
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Identification of the swap body to be locked. Only certain shipments can be completed with this.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] [[#edistatus|<EDIStatus>]] || - || - || List of status information for EDIs.<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Successful<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name and binary data of the EDI lists (e.g. UPS Summary) as key/value map.<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"auftraggeberID": [<br />
""<br />
],<br />
"druckername": "",<br />
"frachtfuehrerTyp": [<br />
""<br />
],<br />
"packplatz": "",<br />
"versandartID": [<br />
""<br />
],<br />
"wechselbruecke": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"assoc": {<br />
"":""<br />
},<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"edistatus": [<br />
{<br />
"fehlercode": 0,<br />
"statuscode": "",<br />
"statustext": "",<br />
"fftyp": "",<br />
"dateityp": "",<br />
"auftraggeber": "",<br />
"ffdateinr": ""<br />
}<br />
],<br />
"listenDaten": {}<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE ediabschlussAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- versanddatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
<br />
== Check package data (versanddatenPruefAnfrage) ==<br />
The gateway sends the versanddatenPruefAnfrage to the automatic polling of the HVS32. A versanddatenAnfrage is thus simulated in the HVS32. No labels are printed and the package or label is not booked, but all other processes are identical to the shipping data request (route determination, tracking number determination, address verification, etc.). This function is used to validate all shipping data in advance.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/versanddatenPruefAnfrage'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' fields must ALWAYS be filled </small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Recipient contact person <br />
|-<br />
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || A list of [[#articleDaten|Packstück-Artikel]] of type '''[[#artikelDaten|ArtikelDaten]]''' (1:n)<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| auftragNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Client ID from the HVS32 <br />
|-<br />
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Addition to fixed AVIS key 1<br />
|-<br />
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Addition to fixed AVIS key 2<br />
|-<br />
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro Order Number (Metro Shipping)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module)<br />
|-<br />
| email || [[#Datentypen|String]] || 100 || - || E-mail address of the recipient (e.g. for automatic e-mail notification)<br />
|-<br />
| faxNr || [[#Datentypen|String]] || 20 || - || Recipient's fax number<br />
|-<br />
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex delivery email address<br />
|-<br />
| frachtBrief || [[#Datentypen|String]] || 20 || - || Bill of lading number if bill of lading is to be printed by the upstream system<br />
|-<br />
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Customer number of the freight payer at the carrier<br />
|-<br />
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -<br />
|-<br />
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || A list of [[#gefahrgut|Gefahrgüter]] of type '''[[#gefahrgut|Gefahrgut]]''' (1:n)<br />
|-<br />
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Gross weight in KG<br />
|-<br />
| ilnNr || [[#Datentypen|String]] || 20 || - || Recipient's ILN (required for Metro shipping)<br />
|-<br />
| infotext1 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext2 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext3 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext4 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext5 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext6 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext7 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext8 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext9 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext10 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| kostenstelle || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| kundenNr || [[#Datentypen|String]] || 20 || - || Customer number of the recipient at the sender<br />
|-<br />
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Is used in the HVS32 as a search number<br />
|-<br />
| cash on delivery || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| Net weight || [[#Datentypen|Decimal]] || 8 || 3 || Net weight in KG<br />
|-<br />
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': personal cheque<br />
|-<br />
| nnVerwendung || [[#Datentypen|String]] || 30 || - || cash on delivery usage<br />
|-<br />
| nnWaehrung || [[#Datentypen|String]] || 3 || - || cash on delivery - ISO currency code<br />
|-<br />
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Total number of packages in the shipment<br />
|-<br />
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Consecutive number per shipment<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32 packing station client that is to process the order.<br />
|-<br />
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Width in cm<br />
|-<br />
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Height in cm<br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || Unique number for the package in the source system. Is required as a unique package reference to later cancel or load the label.<br />
|-<br />
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Length in cm<br />
|-<br />
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Only in the UPS PaperlessInvoice case (T=PaperlessInvoice / F=not PaperlessInvoice)<br />
|-<br />
| postLeitcode || [[#Datentypen|String]] || 15 || - || -<br />
|-<br />
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -<br />
|-<br />
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Billing address <br />
|-<br />
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Billing address <br />
|-<br />
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Billing address <br />
|-<br />
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Billing address <br />
|-<br />
| rechnungsNr || [[#Datentypen|String]] || 20 || - || bill number<br />
|-<br />
| sonderdienste || [[#Datentypen|String]] || 30 || - || Shipping type-specific<br />
|-<br />
| telefonNr || [[#Datentypen|String]] || 20 || - || Recipient's phone number<br />
|-<br />
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix<br />
|-<br />
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| ustIDNr || [[#Datentypen|String]] || 20 || - || VAT number of the recipient<br />
|-<br />
| verpackungsart || [[#Datentypen|String]] || 6 || - || -<br />
|-<br />
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Shipping type identifier from the HVS32<br />
|-<br />
| insurance value || [[#Datentypen|Decimal]] || 18 || 2 || Amount of insurance value <br />
|-<br />
| vwWaehrung || [[#Datentypen|String]] || 3 || - || insurance value - ISO currency code<br />
|-<br />
| Value of goods || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Value of goods - ISO currency code<br />
|-<br />
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = recipient<br />
|-<br />
| zbZoll || [[#Datentypen|String]] || 1 || - || Terms of payment for customs taxes 'S' = Sender, 'R' = recipient<br />
|-<br />
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || Postal code and city<br />
|-<br />
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || delivery address <br />
|-<br />
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || delivery address <br />
|-<br />
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || State/Province (e.g. important for shipments to the USA)<br />
|-<br />
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy |-<br />
|-<br />
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Date when the label was printed in HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Date when the label was printed in HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"ansprechpartner": "",<br />
"artikelDaten": [<br />
{<br />
"anzahlBuegel": 0,<br />
"anzahlPosEtiketten": 0,<br />
"artikelBTNNr": "",<br />
"artikelEAN": "",<br />
"artikelEinheit": "",<br />
"artikelGewicht": 0,<br />
"artikelGruppe": "",<br />
"artikelMenge": 0,<br />
"artikelServices": "",<br />
"artikelSollMenge": 0,<br />
"artikelText1": "",<br />
"artikelText2": "",<br />
"artikelText3": "",<br />
"artikelText4": "",<br />
"artikelVolumen": 0,<br />
"artikelWaehrung": "",<br />
"artikelWert": 0,<br />
"chargeFlag": "",<br />
"kundenArtikelNr": "",<br />
"kundenBestellNr": "",<br />
"posAuftragNr": "",<br />
"posLieferNr": "",<br />
"positionNr": "",<br />
"serienNr": "",<br />
"ursprungLand": ""<br />
}<br />
],<br />
"auftragNr": "",<br />
"auftraggeberID": "",<br />
"avisHinweis1": "",<br />
"avisHinweis2": "",<br />
"avisZusatz1": "",<br />
"avisZusatz2": "",<br />
"bestellNr": "",<br />
"druckername": "",<br />
"email": "",<br />
"faxNr": "",<br />
"frachtBrief": "",<br />
"frachtfuehrerKdNr": "",<br />
"frankaturKennung": "",<br />
"gefahrgut": [<br />
{<br />
"gefahrgutBefoerdKat": 0,<br />
"gefahrgutBegrenzteMenge": "",<br />
"gefahrgutBezeichnung": "",<br />
"gefahrgutBuchst640": "",<br />
"gefahrgutFFCode": "",<br />
"gefahrgutFaktor": 0,<br />
"gefahrgutFreigestMenge": "",<br />
"gefahrgutKCode": "",<br />
"gefahrgutKlasse": "",<br />
"gefahrgutMenge": 0,<br />
"gefahrgutMengenEinheit": "",<br />
"gefahrgutNebenGefahr": "",<br />
"gefahrgutNettoExplMasse": 0,<br />
"gefahrgutTunnelBCode": "",<br />
"gefahrgutUNNR": "",<br />
"gefahrgutUmweltGef": "",<br />
"gefahrgutVPG": "",<br />
"gefahrgutVerpAnzahl": 0,<br />
"gefahrgutVerpackungsart": ""<br />
}<br />
],<br />
"gewicht": 0,<br />
"ilnNr": "",<br />
"infotext1": "",<br />
"infotext2": "",<br />
"infotext3": "",<br />
"infotext4": "",<br />
"infotext5": "",<br />
"infotext6": "",<br />
"infotext7": "",<br />
"infotext8": "",<br />
"infotext9": "",<br />
"infotext10": "",<br />
"kostenstelle": "",<br />
"kundenNr": "",<br />
"lieferscheinNr": "",<br />
"cash on delivery ": 0,<br />
"Net weight": 0,<br />
"neutabsenderLKZ": "",<br />
"neutabsenderName1": "",<br />
"neutabsenderName2": "",<br />
"neutabsenderName3": "",<br />
"neutabsenderOrt": "",<br />
"neutabsenderPLZ": "",<br />
"neutabsenderStrasse": "",<br />
"nnVermerk": "",<br />
"nnVerwendung": "",<br />
"nnWaehrung": "",<br />
"packStkGes": 0,<br />
"packStkNr": 0,<br />
"packplatz": "",<br />
"packstueckBreite": 0,<br />
"packstueckHoehe": 0,<br />
"packstueckID": "",<br />
"packstueckLaenge": 0,<br />
"paperlessInvoice": "",<br />
"postLeitcode": "",<br />
"postZielFrachtzent": "",<br />
"rechnungsEmpfLKZ": "",<br />
"rechnungsEmpfName1": "",<br />
"rechnungsEmpfName2": "",<br />
"rechnungsEmpfName3": "",<br />
"rechnungsEmpfOrt": "",<br />
"rechnungsEmpfPLZ": "",<br />
"rechnungsEmpfStrasse": "",<br />
"sendungsinhalt": "",<br />
"sonderdienste": "",<br />
"telefonNr": "",<br />
"terminArt": "",<br />
"terminDatum": "",<br />
"terminZeit": "",<br />
"ustIDNr": "",<br />
"verpackungsart": "",<br />
"versandartID": "",<br />
"insurance value": 0,<br />
"vwWaehrung": "",<br />
"Value of goods ": 0,<br />
"wwWaehrung": "",<br />
"zahlungsbedingung": "",<br />
"zbZoll": "",<br />
"zielAdrBahnhof": "",<br />
"zielAdrLKZ": "",<br />
"zielAdrName1": "",<br />
"zielAdrName2": "",<br />
"zielAdrName3": "",<br />
"zielAdrOrt": "",<br />
"zielAdrPLZ": "",<br />
"zielAdrRegion": "",<br />
"zielAdrStrasse": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"druckDateTime": "",<br />
"fehlertext1": "",<br />
"fehlertext2": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE versanddatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- updateVersanddaten ------------------------------------------------------------------------------- --><br />
<br />
== Update package data (updateVersanddaten) ==<br />
The gateway function updateVersanddaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to change the data of existing packages there. This request is sent, for example, if the value of goods for a package is only known at a later point in time. Data within the shipping unit, billing unit and delivery tables can be updated. The search is always made via the PackstueckID field and, if occupied, also via the TrackingNr field. <br><br><br />
<br />
'''With this request, however, the fields and content to be updated are no longer checked according to the guidelines of the carrier (e.g. weight limits, etc.). The upstream system must therefore ensure that the updated values match the carrier's guidelines. If this is not possible, this function cannot be used and the label must be canceled and reprocessed. In addition, fields that have already been printed on a label or that have been determined by the HVS32 shipping system in a carrier transaction (e.g. address, route, tracking number, special services, etc.) cannot be manipulated.'''<br><br><br />
<br />
'''ATTENTION: All fields that are to be updated in the shipping system must be coordinated and configured accordingly in the shipping system before using this function!'''<br><br><br />
<br />
There are no package/shipment data available for confirmation. After a successful update, only the error field is returned with the value 0 - or in the event of an error, the error is returned with the value 1 and Fehlertext1.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/updateVersanddaten'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' fields must ALWAYS be filled </small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Recipient contact person <br />
|-<br />
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Number of articles (print on label) <br />
|-<br />
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || A list of [[#articleDaten|Packstück-Artikel]] of type '''[[#artikelDaten|ArtikelDaten]]''' (1:n)<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| auftragNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Client ID from the HVS32 <br />
|-<br />
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Addition to fixed AVIS key 1<br />
|-<br />
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Addition to fixed AVIS key 2<br />
|-<br />
| barcodeID || [[#Datentypen|String]] || - || - || Additional field for extra extensions<br />
|-<br />
| barcodeText || [[#Datentypen|String]] || - || - || Additional field for extra extensions<br />
|-<br />
| barcodeTyp || [[#Datentypen|String]] || - || - || Additional field for extra extensions<br />
|-<br />
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro Order Number (Metro Shipping)<br />
|-<br />
| druckername || [[#Datentypen|String]] || 30 || - || Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module)<br />
|-<br />
| email || [[#Datentypen|String]] || 100 || - || E-mail address of the recipient (e.g. for automatic e-mail notification)<br />
|-<br />
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobile phone number of the recipient<br />
|-<br />
| faxNr || [[#Datentypen|String]] || 20 || - || Recipient's fax number<br />
|-<br />
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex delivery email address<br />
|-<br />
| frachtBrief || [[#Datentypen|String]] || 20 || - || Bill of lading number if bill of lading is to be printed by the upstream system<br />
|-<br />
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Customer number of the freight payer at the carrier<br />
|-<br />
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -<br />
|-<br />
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || A list of [[#gefahrgut|Gefahrgüter]] of type '''[[#gefahrgut|Gefahrgut]]''' (1:n)<br />
|-<br />
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Gross weight in KG<br />
|-<br />
| hostTrackingNr || [[#Datentypen|String]] || 35 || - ||Packet number from the host system<br />
|-<br />
| ilnNr || [[#Datentypen|String]] || 20 || - || Recipient's ILN (required for Metro shipping)<br />
|-<br />
| infotext1 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext2 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext3 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext4 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext5 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext6 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext7 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext8 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext9 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| infotext10 || [[#Datentypen|String]] || 150 || - || Additional field for extra extensions<br />
|-<br />
| kostenstelle || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| kundenNr || [[#Datentypen|String]] || 20 || - || Customer number of the recipient at the sender<br />
|-<br />
| lagerkennzeichen || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=last package of the shipment (required for hanging shipment to print the shipment hanging card)<br />
|-<br />
| lieferantenID || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Is used in the HVS32 as a search number<br />
|-<br />
| cash on delivery || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| Net weight || [[#Datentypen|Decimal]] || 8 || 3 || Net weight in KG<br />
|-<br />
| neutBIC || [[#Datentypen|String]] || 11 || - || Only assigned to neutral senders<br />
|-<br />
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Only assigned to neutral senders<br />
|-<br />
| neutIBAN || [[#Datentypen|String]] || 31 || - || Only assigned to neutral senders<br />
|-<br />
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': personal cheque<br />
|-<br />
| nnVerwendung || [[#Datentypen|String]] || 30 || - || cash on delivery usage<br />
|-<br />
| nnWaehrung || [[#Datentypen|String]] || 3 || - || cash on delivery - ISO currency code<br />
|-<br />
| packStkGes || [[#Datentypen|Integer]] || - || - || Total number of packages in the shipment<br />
|-<br />
| packStkNr || [[#Datentypen|Integer]] || - || - || Consecutive number per shipment<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32 packing station client that is to process the order.<br />
|-<br />
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Width in cm<br />
|-<br />
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Height in cm<br />
|-<br />
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || Unique number for the package in the source system. Is required as a unique package reference to later cancel or load the label.<br />
|-<br />
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Length in cm<br />
|-<br />
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Only in the UPS PaperlessInvoice case (T=PaperlessInvoice / F=not PaperlessInvoice)<br />
|-<br />
| postLeitcode || [[#Datentypen|String]] || 15 || - || -<br />
|-<br />
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -<br />
|-<br />
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Billing address <br />
|-<br />
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Billing address <br />
|-<br />
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Billing address <br />
|-<br />
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Billing address <br />
|-<br />
| rechnungsNr || [[#Datentypen|String]] || 20 || - || bill number<br />
|-<br />
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| sonderdienste || [[#Datentypen|String]] || 30 || - || Shipping type-specific<br />
|-<br />
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=lock, otherwise don't lock<br />
|-<br />
| telefonNr || [[#Datentypen|String]] || 20 || - || Recipient's phone number<br />
|-<br />
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix<br />
|-<br />
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| ustIDNr || [[#Datentypen|String]] || 20 || - || VAT number of the recipient<br />
|-<br />
| verpackungsart || [[#Datentypen|String]] || 6 || - || -<br />
|-<br />
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Shipping type identifier from the HVS32<br />
|-<br />
| insurance value || [[#Datentypen|Decimal]] || 18 || 2 || Amount of insurance value <br />
|-<br />
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| vwWaehrung || [[#Datentypen|String]] || 3 || - || insurance value - ISO currency code<br />
|-<br />
| Value of goods || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Swap body assigned to this package<br />
|-<br />
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Value of goods - ISO currency code<br />
|-<br />
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = recipient<br />
|-<br />
| zbZoll || [[#Datentypen|String]] || 1 || - || Terms of payment for customs taxes 'S' = Sender, 'R' = recipient<br />
|-<br />
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || Postal code and city<br />
|-<br />
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || delivery address <br />
|-<br />
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || delivery address <br />
|-<br />
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || State/Province (e.g. important for shipments to the USA)<br />
|-<br />
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy |<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Date when the label was sent to the carrier (DD.MM.YYYY)<br />
|-<br />
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Date when the label was sent to the carrier (DD.MM.YYYY)<br />
|-<br />
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Date when the label was printed in HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Date when the label was printed in HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| etikettDaten || [[#Datentypen|String]] || - || - || Label binary data<br />
|-<br />
| etikettName || [[#Datentypen|String]] || - || - || Label template name<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 if successful<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || freight charges<br />
|-<br />
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Freight costs ISO currency code<br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID from the request<br />
|-<br />
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Parcel number for the return<br />
|-<br />
| trackingNr || [[#Datentypen|String]] || 35 || - || package number<br />
|-<br />
| trackingURL || [[#Datentypen|String]] || 255 || - || URL of the tracking link for shipment tracking<br />
|-<br />
| versandSendungsNr || [[#Datentypen|String]] || - || - || -<br />
|-<br />
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name and binary data of the additional labels as key/value map<br />
|-<br />
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"ansprechpartner": "",<br />
"anzahlArtikel": 0,<br />
"artikelDaten": [<br />
{<br />
"anzahlBuegel": 0,<br />
"anzahlPosEtiketten": 0,<br />
"artikelBTNNr": "",<br />
"artikelEAN": "",<br />
"artikelEinheit": "",<br />
"artikelGewicht": 0,<br />
"artikelGruppe": "",<br />
"artikelMenge": 0,<br />
"artikelServices": "",<br />
"artikelSollMenge": 0,<br />
"artikelText1": "",<br />
"artikelText2": "",<br />
"artikelText3": "",<br />
"artikelText4": "",<br />
"artikelVolumen": 0,<br />
"artikelWaehrung": "",<br />
"artikelWert": 0,<br />
"chargeFlag": "",<br />
"kundenArtikelNr": "",<br />
"kundenBestellNr": "",<br />
"posAuftragNr": "",<br />
"posLieferNr": "",<br />
"positionNr": "",<br />
"serienNr": "",<br />
"ursprungLand": ""<br />
}<br />
],<br />
"auftragNr": "",<br />
"auftraggeberID": "",<br />
"avisHinweis1": "",<br />
"avisHinweis2": "",<br />
"avisZusatz1": "",<br />
"avisZusatz2": "",<br />
"barcodeID": "",<br />
"barcodeText": "",<br />
"barcodeTyp": "",<br />
"bestellNr": "",<br />
"druckername": "",<br />
"email": "",<br />
"empfMobilfunkNr": "",<br />
"faxNr": "",<br />
"flexZustellungEmailadResponsese": "",<br />
"frachtBrief": "",<br />
"frachtfuehrerKdNr": "",<br />
"frankaturKennung": "",<br />
"gefahrgut": [<br />
{<br />
"gefahrgutBefoerdKat": 0,<br />
"gefahrgutBegrenzteMenge": "",<br />
"gefahrgutBezeichnung": "",<br />
"gefahrgutBuchst640": "",<br />
"gefahrgutFFCode": "",<br />
"gefahrgutFaktor": 0,<br />
"gefahrgutFreigestMenge": "",<br />
"gefahrgutKCode": "",<br />
"gefahrgutKlasse": "",<br />
"gefahrgutMenge": 0,<br />
"gefahrgutMengenEinheit": "",<br />
"gefahrgutNebenGefahr": "",<br />
"gefahrgutNettoExplMasse": 0,<br />
"gefahrgutTunnelBCode": "",<br />
"gefahrgutUNNR": "",<br />
"gefahrgutUmweltGef": "",<br />
"gefahrgutVPG": "",<br />
"gefahrgutVerpAnzahl": 0,<br />
"gefahrgutVerpackungsart": ""<br />
}<br />
],<br />
"gewicht": 0,<br />
"hostTrackingNr": "",<br />
"ilnNr": "",<br />
"infotext1": "",<br />
"infotext2": "",<br />
"infotext3": "",<br />
"infotext4": "",<br />
"infotext5": "",<br />
"infotext6": "",<br />
"infotext7": "",<br />
"infotext8": "",<br />
"infotext9": "",<br />
"infotext10": "",<br />
"kostenstelle": "",<br />
"kundenNr": "",<br />
"lagerkennzeichen": 0,<br />
"letztesPackstueck": "",<br />
"lieferantenID": 0,<br />
"lieferscheinNr": "",<br />
"cash on delivery ": 0,<br />
"Net weight": 0,<br />
"neutBIC": "",<br />
"neutBankBezeichnung": "",<br />
"neutIBAN": "",<br />
"neutKontoInhaber": "",<br />
"neutabsenderLKZ": "",<br />
"neutabsenderName1": "",<br />
"neutabsenderName2": "",<br />
"neutabsenderName3": "",<br />
"neutabsenderOrt": "",<br />
"neutabsenderPLZ": "",<br />
"neutabsenderStrasse": "",<br />
"nnVermerk": "",<br />
"nnVerwendung": "",<br />
"nnWaehrung": "",<br />
"packStkGes": 0,<br />
"packStkNr": 0,<br />
"packplatz": "",<br />
"packstueckBreite": 0,<br />
"packstueckHoehe": 0,<br />
"packstueckID": "",<br />
"packstueckLaenge": 0,<br />
"paperlessInvoice": "",<br />
"postLeitcode": "",<br />
"postZielFrachtzent": "",<br />
"rechnungsEmpfLKZ": "",<br />
"rechnungsEmpfName1": "",<br />
"rechnungsEmpfName2": "",<br />
"rechnungsEmpfName3": "",<br />
"rechnungsEmpfOrt": "",<br />
"rechnungsEmpfPLZ": "",<br />
"rechnungsEmpfStrasse": "",<br />
"rechnungsNr": "",<br />
"sendungsinhalt": "",<br />
"sonderdienste": "",<br />
"sperrFlag": "",<br />
"telefonNr": "",<br />
"terminArt": "",<br />
"terminDatum": "",<br />
"terminZeit": "",<br />
"ustIDNr": "",<br />
"verpackungsart": "",<br />
"versandartID": "",<br />
"insurance value": 0,<br />
"vorpackdatum": "",<br />
"vwWaehrung": "",<br />
"Value of goods ": 0,<br />
"wechselbruecke": "",<br />
"wwWaehrung": "",<br />
"zahlungsbedingung": "",<br />
"zbZoll": "",<br />
"zielAdrBahnhof": "",<br />
"zielAdrLKZ": "",<br />
"zielAdrName1": "",<br />
"zielAdrName2": "",<br />
"zielAdrName3": "",<br />
"zielAdrName4": "",<br />
"zielAdrOrt": "",<br />
"zielAdrPLZ": "",<br />
"zielAdrRegion": "",<br />
"zielAdrStrasse": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"packstueckID": "",<br />
"trackingNr": "",<br />
"retourTrackingNr": "",<br />
"versandSendungsNr": "",<br />
"druckDateTime": "",<br />
"ausgangDateTime": "",<br />
"gebuehrWaehrung": "",<br />
"fehlercode": 0,<br />
"fehlertext1": "",<br />
"fehlertext2": "",<br />
"etikettName": "",<br />
"etikettDaten": "",<br />
"trackingURL": "",<br />
"zusatzfeld1": "",<br />
"zusatzfeld2": "",<br />
"zusatzfeld3": "",<br />
"zusatzfeld4": "",<br />
"zusatzfeld5": "",<br />
"zusatzfeld6": "",<br />
"zusatzfeld7": "",<br />
"zusatzfeld8": "",<br />
"zusatzfeld9": "",<br />
"zusatzfeld10": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE updateVersanddaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- anonymisiereVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
== Anonymize package data (anonymisiereVersandDaten) ==<br />
The gateway sends the anonymisiereVersandDaten to the automatic polling of the HVS32. In the HVS32, customer-related data is thus anonymized for the corresponding data set in accordance with the GDPR. This anonymization is irrevocably and definitively carried out at the database level of the shipping system. It is therefore no longer possible to restore the original data. Log files, feedback files, carrier EDIs that have already been transferred, etc. are not affected. Only packages and shipments that have already been closed during the day can be anonymised.<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/anonymisiereVersandDaten'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' fields must ALWAYS be filled </small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max length !! Decimal places !! occupancy<br />
|-<br />
| auftragsNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Is used in the HVS32 as a search number.<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || Name of an output channel (printer) in the HVS32 via which the label is <br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || '''Unique''' number for the package in the source system. <br />
|-<br />
| trackingNr || [[#Datentypen|String]] || 35 || - || package number<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max length !! Decimal places !! occupancy<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"auftragNr": "",<br />
"lieferscheinNr": "",<br />
"packplatz": "",<br />
"packstueckID": "",<br />
"trackingNr": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"fehlertext1": "",<br />
"fehlertext2": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE anonymisiereVersandDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- sendungsdatenAnfrage ------------------------------------------------------------------------------- --><br />
<br />
== shipment processing (sendungsdatenAnfrage) ==<br />
sendungsdatenAnfrage – is divided into individual [[#versandDatenAnfragen|versandDatenAnfragen]] at runtime. Must be used with a request for the [[Shipment_Policy_Manager_(Tarifwerk)|SPM]] (requestSPM=TRUE)<br />
<br><br />
{| class="wikitable"<br />
|-<br />
|'''Function (method: POST) || /hvs32rest/sendungsdatenAnfrage'''<br />
|-<br />
| '''MediaType || text/plain'''<br><br />
|-<br />
| '''Charset || UTF-8'''<br><br />
|}<br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''request parameters '''</div><br />
<div class="mw-collapsible-content"><br />
<small>'''Bold''' fields must ALWAYS be filled </small><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Recipient contact person <br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| auftragNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Client ID from the HVS32 <br />
|-<br />
| ausschlussFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Exclusion carrier for SPM request<br />
|-<br />
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Addition to fixed AVIS key 1<br />
|-<br />
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Addition to fixed AVIS key 2<br />
|-<br />
| bestellNr || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| email || [[#Datentypen|String]] || 100 || - || For automatic mail notification<br />
|-<br />
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobile phone number of the recipient<br />
|-<br />
| faxNr || [[#Datentypen|String]] || 20 || - || Recipient's fax number<br />
|-<br />
| flexZustellungEmailadResponsese || [[#Datentypen|String]] || 80 || - || Flex delivery email address<br />
|-<br />
| frachtBrief || [[#Datentypen|String]] || 20 || - || Bill of lading number if bill of lading is printed by the upstream system.<br />
|-<br />
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Customer number of the freight payer at the carrier.<br />
|-<br />
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -<br />
|-<br />
| ilnNr || [[#Datentypen|String]] || 20 || - || Recipient's ILN (required for Metro shipping)<br />
|-<br />
| kostenstelle || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| kundenNr || [[#Datentypen|String]] || 20 || - || Customer number of the recipient at the sender<br />
|-<br />
| Lagerkennzeichen || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG --><br />
|-<br />
| LieferantenID || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG --><br />
|-<br />
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Is used in the HVS32 as a search number.<br />
|-<br />
| neutBIC || [[#Datentypen|String]] || 11 || - || Only assigned to neutral senders<br />
|-<br />
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Only assigned to neutral senders<br />
|-<br />
| neutIBAN || [[#Datentypen|String]] || 31 || - || Only assigned to neutral senders<br />
|-<br />
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Only assigned to neutral senders<br />
|-<br />
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Only assigned to neutral senders<br />
|-<br />
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Total number of packages in the shipment<br />
|-<br />
| [[#packstueckDaten|packstueckDaten]] || [[#Datentypen|Sequence]] [[#packstueckDaten|<PackStueckDaten>]] || - || - || -<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32 packing station client that is to process the order.<br />
|-<br />
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Only in the UPS PaperlessInvoice case (T=PaperlessInvoice / F=not PaperlessInvoice)<br />
|-<br />
| postLeitcode || [[#Datentypen|String]] || 15 || - || -<br />
|-<br />
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -<br />
|-<br />
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Billing address <br />
|-<br />
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || invoice recipient <br />
|-<br />
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Billing address <br />
|-<br />
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Billing address <br />
|-<br />
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Billing address <br />
|-<br />
| rechnungsNr || [[#Datentypen|String]] || 20 || - || bill number<br />
|-<br />
| requestSPM || [[#Datentypen|String]] || 5 || - || T/TRUE if the decision matrix is to be addressed, empty otherwise<br />
|-<br />
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| sonderdienste || [[#Datentypen|String]] || 30 || - || Shipping type-specific<br />
|-<br />
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=lock, otherwise don't lock<br />
|-<br />
| telefonNr || [[#Datentypen|String]] || 20 || - || Recipient's phone number<br />
|-<br />
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix<br />
|-<br />
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| terminZeit || [[#Datentypen|String]] || 5 || - || HH:MM<br />
|-<br />
| ustIDNr || [[#Datentypen|String]] || 20 || - || VAT number of the recipient<br />
|-<br />
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Shipping type identifier from the HVS32<br />
|-<br />
| vorgabeFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Default carrier for [[Shipment_Policy_Manager_(Tarifwerk)|SPM]] request<br />
|-<br />
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Swap body that is to be assigned to this package<br />
|-<br />
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = recipient<br />
|-<br />
| zbZoll || [[#Datentypen|String]] || 1 || - || Terms of payment for customs taxes 'S' = Sender, 'R' = recipient<br />
|-<br />
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || Postal code and city des Bahnhofs<br />
|-<br />
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Country code (LKZ)<br />
|-<br />
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|-<br />
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || delivery address <br />
|-<br />
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || State/Province (e.g. important for shipments to the USA)<br />
|-<br />
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || delivery address <br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''response parameters'''</div><br />
<div class="mw-collapsible-content"><br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy <br />
|-<br />
| fehler || [[#Datentypen|String]] || - || - || Is filled in the event of an error<br />
|-<br />
| sendungsGebuehr || [[#Datentypen|Decimal]] || 18 || 2 || freight charges<br />
|-<br />
| sendungsGebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Freight costs ISO currency code<br />
|-<br />
| versandSendungsNr || [[#Datentypen|String]] || 20 || - || tracking number<br />
|}<br />
<br />
;Packstückdaten<br />
{| class="wikitable sortable"<br />
|-<br />
! Field name !! Type !! Max Length !! Decimals !! Occupancy |<br />
|-<br />
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Additional field for extra extensions (Key=Field name / Value=Wert)<br />
|-<br />
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Date when the label was sent to the carrier (DD.MM.YYYY)<br />
|-<br />
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Date when the label was sent to the carrier (DD.MM.YYYY)<br />
|-<br />
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Date when the label was printed in HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Date when the label was printed in HVS32 (DD.MM.YYYY HH:mm:SS)<br />
|-<br />
| etikettDaten || [[#Datentypen|String]] || - || - || Label binary data<br />
|-<br />
| etikettName || [[#Datentypen|String]] || - || - || Label template name<br />
|-<br />
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 if successful<br />
|-<br />
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error<br />
|-<br />
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || freight charges<br />
|-<br />
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Freight costs ISO currency code<br />
|-<br />
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID from the request<br />
|-<br />
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Parcel number for the return<br />
|-<br />
| trackingNr || [[#Datentypen|String]] || 35 || - || package number<br />
|-<br />
| trackingURL || [[#Datentypen|String]] || 255 || - || URL of the tracking link for shipment tracking<br />
|-<br />
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name and binary data of the additional labels as key/value map<br />
|-<br />
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|-<br />
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - ||Additional field - can optionally be mapped in the HVS32 to report back additional information<br />
|}<br />
</div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''Examples'''</div><br />
<div class="mw-collapsible-content"><br />
;Request<br />
<source lang="json"><br />
{<br />
"ansprechpartner": "",<br />
"assoc": {<br />
"":""<br />
},<br />
"auftragNr": "",<br />
"auftraggeberID": "",<br />
"ausschlussFrachtfuehrer": "",<br />
"avisHinweis1": "",<br />
"avisHinweis2": "",<br />
"avisZusatz1": "",<br />
"avisZusatz2": "",<br />
"bestellNr": "",<br />
"email": "",<br />
"empfMobilfunkNr": "",<br />
"faxNr": "",<br />
"flexZustellungEmailadResponsese": "",<br />
"frachtBrief": "",<br />
"frachtfuehrerKdNr": "",<br />
"frankaturKennung": "",<br />
"ilnNr": "",<br />
"kostenstelle": "",<br />
"kundenNr": "",<br />
"Lagerkennzeichen": 0,<br />
"LieferantenID": 0,<br />
"lieferscheinNr": "",<br />
"neutBIC": "",<br />
"neutBankBezeichnung": "",<br />
"neutIBAN": "",<br />
"neutKontoInhaber": "",<br />
"neutabsenderLKZ": "",<br />
"neutabsenderName1": "",<br />
"neutabsenderName2": "",<br />
"neutabsenderName3": "",<br />
"neutabsenderOrt": "",<br />
"neutabsenderPLZ": "",<br />
"neutabsenderStrasse": "",<br />
"packStkGes": 0,<br />
"packStueckDaten": [<br />
{<br />
"anzahlArtikel": 0,<br />
"assoc": {<br />
"":""<br />
},<br />
"artikelDaten": [<br />
{<br />
"anzahlBuegel": 0,<br />
"anzahlPosEtiketten": 0,<br />
"artikelBTNNr": "",<br />
"artikelEAN": "",<br />
"artikelEinheit": "",<br />
"artikelGewicht": 0,<br />
"artikelGruppe": "",<br />
"artikelMenge": 0,<br />
"artikelServices": "",<br />
"artikelSollMenge": 0,<br />
"artikelText1": "",<br />
"artikelText2": "",<br />
"artikelText3": "",<br />
"artikelText4": "",<br />
"artikelVolumen": 0,<br />
"artikelWaehrung": "",<br />
"artikelWert": 0,<br />
"chargeFlag": "",<br />
"kundenArtikelNr": "",<br />
"kundenBestellNr": "",<br />
"posAuftragNr": "",<br />
"posLieferNr": "",<br />
"positionNr": "",<br />
"serienNr": "",<br />
"ursprungLand": ""<br />
}<br />
],<br />
"barcodeID": "",<br />
"barcodeText": "",<br />
"barcodeTyp": "",<br />
"druckername": "",<br />
"gefahrgut": [<br />
{<br />
"gefahrgutBefoerdKat": 0,<br />
"gefahrgutBegrenzteMenge": "",<br />
"gefahrgutBezeichnung": "",<br />
"gefahrgutBuchst640": "",<br />
"gefahrgutFFCode": "",<br />
"gefahrgutFaktor": 0,<br />
"gefahrgutFreigestMenge": "",<br />
"gefahrgutKCode": "",<br />
"gefahrgutKlasse": "",<br />
"gefahrgutMenge": 0,<br />
"gefahrgutMengenEinheit": "",<br />
"gefahrgutNebenGefahr": "",<br />
"gefahrgutNettoExplMasse": 0,<br />
"gefahrgutTunnelBCode": "",<br />
"gefahrgutUNNR": "",<br />
"gefahrgutUmweltGef": "",<br />
"gefahrgutVPG": "",<br />
"gefahrgutVerpAnzahl": 0,<br />
"gefahrgutVerpackungsart": ""<br />
}<br />
],<br />
"gewicht": 0,<br />
"hostTrackingNr": "",<br />
"infotext1": "",<br />
"infotext10": "",<br />
"infotext2": "",<br />
"infotext3": "",<br />
"infotext4": "",<br />
"infotext5": "",<br />
"infotext6": "",<br />
"infotext7": "",<br />
"infotext8": "",<br />
"infotext9": "",<br />
"letztesPackstueck": "",<br />
"cash on delivery ": 0,<br />
"Net weight": 0,<br />
"nnVermerk": "",<br />
"nnVerwendung": "",<br />
"nnWaehrung": "",<br />
"packStkNr": 0,<br />
"packstueckBreite": 0,<br />
"packstueckHoehe": 0,<br />
"packstueckID": "",<br />
"packstueckLaenge": 0,<br />
"verpackungsart": "",<br />
"insurance value": 0,<br />
"vwWaehrung": "",<br />
"Value of goods ": 0,<br />
"wwWaehrung": ""<br />
}<br />
],<br />
"packplatz": "",<br />
"paperlessInvoice": "",<br />
"postLeitcode": "",<br />
"postZielFrachtzent": "",<br />
"rechnungsEmpfLKZ": "",<br />
"rechnungsEmpfName1": "",<br />
"rechnungsEmpfName2": "",<br />
"rechnungsEmpfName3": "",<br />
"rechnungsEmpfOrt": "",<br />
"rechnungsEmpfPLZ": "",<br />
"rechnungsEmpfStrasse": "",<br />
"rechnungsNr": "",<br />
"RequestuestSPM": "",<br />
"sendungsinhalt": "",<br />
"sonderdienste": "",<br />
"sperrFlag": "",<br />
"telefonNr": "",<br />
"terminArt": "",<br />
"terminDatum": "",<br />
"terminZeit": "",<br />
"ustIDNr": "",<br />
"versandartID": "",<br />
"vorgabeFrachtfuehrer": "",<br />
"vorpackdatum": "",<br />
"wechselbruecke": "",<br />
"zahlungsbedingung": "",<br />
"zbZoll": "",<br />
"zielAdrBahnhof": "",<br />
"zielAdrLKZ": "",<br />
"zielAdrName1": "",<br />
"zielAdrName2": "",<br />
"zielAdrName3": "",<br />
"zielAdrName4": "",<br />
"zielAdrOrt": "",<br />
"zielAdrPLZ": "",<br />
"zielAdrRegion": "",<br />
"zielAdrStrasse": ""<br />
}<br />
</source><br />
;Response<br />
<source lang="json"><br />
{<br />
"versandSendungsNr": "",<br />
"sendungsGebuehrWaehrung": "",<br />
"fehler": "",<br />
"packStueckDaten": [<br />
{<br />
"assoc": {<br />
"":""<br />
},<br />
"packstueckID": "",<br />
"trackingNr": "",<br />
"retourTrackingNr": "",<br />
"druckDateTime": "",<br />
"gebuehrWaehrung": "",<br />
"fehlertext1": "",<br />
"fehlertext2": "",<br />
"etikettName": "",<br />
"etikettDaten": "",<br />
"zusatzEtikettenDaten": {<br />
"": ""<br />
},<br />
"trackingURL": "",<br />
"zusatzfeld1": "",<br />
"zusatzfeld2": "",<br />
"zusatzfeld3": "",<br />
"zusatzfeld4": "",<br />
"zusatzfeld5": "",<br />
"zusatzfeld6": "",<br />
"zusatzfeld7": "",<br />
"zusatzfeld8": "",<br />
"zusatzfeld9": "",<br />
"zusatzfeld10": "",<br />
"ausgangDateTime": ""<br />
}<br />
]<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE sendungsdatenAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- --><br />
<br />
= Examples =<br />
All JSON examples can also be found here: [[REST_Beispiel|REST SERVER JSON Examples]]</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Ehrhardt_%2B_Partner_LFS_Schnittstelle_(Automatik-Polling)&diff=5725
HVS32 Ehrhardt + Partner LFS Schnittstelle (Automatik-Polling)
2024-04-22T06:40:59Z
<p>Bhauser: /* Packstückdaten aktualisieren (UpdateVersandDaten) [HCUSAG=2] */</p>
<hr />
<div>= Voraussetzungen =<br />
{| class="wikitable"<br />
|-<br />
| DGS-Version || 3.6.0.550 oder höher<br />
|-<br />
| DGS-Plugins || HVS32Client, EPServer<br />
|}<br />
<br />
<br />
= Funktionsbeschreibung =<br />
Der DataGatewayServer (DGS) nutzt für die Kommunikation mit einem E+P LFS ein spezielles Kommunikationsprotokoll und stellt einen TCP-Server bereit, der auf<br />
Verbindungen vom E+P LFS wartet.<br><br />
<br />
Der DGS ist die zentrale Kommunikationseinheit, über die sämtliche Daten zwischen dem Versandsystem und dem E+P-System ausgetauscht werden. Er läuft in Form eines Dienstes auf einem Windows-Server.<br><br />
<br />
Pro LFS Druck-Job wird vom LFS eine Verbindung zum Gateway aufgebaut, in der dann die Anfragen (Druck,Storno, etc.) mittels eines auf TCP basierenden Protkolles in einem XML-Dokument übermittelt werden. Auf E+P Seite ist ebenfalls eine Standardschnittstelle für diese Art der Kommunikation hinterlegt.<br><br />
<br />
=== Ablauf ===<br />
Das Server-Plugin wartet auf eine ankommende TCP-Verbindung vom LFS. Der LFS Job Verbindet sich auf diesen Server und hält dann dauerhaft die Verbindung, in einem bestimmten Intervall werden KEEPALIVE Meldungen von E+P gesendet.<br><br />
<br />
Sobald eine Verbindung aufgebaut ist und Daten gesendet werden, vermittelt der DGS die Anfrage an den entsprechenden HVS32-Client / HVS32 Monitoringservice. Der Packplatz / Druckername wird dabei vom LFS im Feld HCOUTQ übergeben und die auszuführende Gatewayfunktion in HCUSAG.<br><br />
<br />
Nach der Verarbeitung im HVS32 werden die Rückmeldedaten als XML-Dokument über die gleiche Verbindung an das LFS zurückgemeldet.<br><br />
<br />
<gallery><br />
Ablauf_dgs_ep.png|Ablauf: DGS E+P LFS Server<br />
</gallery><br />
<br />
=== Kommunikationsprotokoll ===<br />
Das verwendete Kommunikationsprotokoll basiert auf TCP und ist folgendermaßen aufgebaut:<br />
{| class="wikitable"<br />
|-<br />
! Name !! Beschreibung !! Länge<br />
|-<br />
| Startflag || Fest ASCII-Wert 0x02 <STX> || 1 Byte<br />
|-<br />
| Bytecount || Anzahl der Bytes des XML || 4 Byte<br />
|-<br />
| XML Daten || XML-Dokument mit den Anfragedaten || Wert von Bytecount<br />
|-<br />
| Endeflag || Fest ASCII-Wert 0x03 (ETX) || 1 Byte<br />
|}<br />
<br />
=== XML-Format ===<br />
Der Rootknoten des XML-Dokuments hat stets den Namen LFS. Die darin enthaltenen Knoten stehen für jeweils einen Datensatz. Diese tragen den Namen PESSSND bei Anfragen vom LFS an das HVS, oder PESSRCV bei Rückmeldungen vom HVS zum LFS. In einem Datensatz sind die Felder mit den Namen aus den LFS-Tabellen enthalten. Numerische Felder habenzusätzlich noch einen Suffix _NUM.<br><br />
<br />
Zusätzlich können bei einer Anfrage neben den PESSSND Knoten weitere Knoten für Gefahrgut- und Lieferscheinpositionen im Rootknoten enthalten sein. Die Namen dieser Knoten sind frei konfigurierbar, müssen aber nach dem PESSSND-Knoten übergeben werden. Für Gefahrgutdaten wird z.B. momentan PESSGGV verwendet.<br><br />
<br />
Die auszuführende Gatewayfunktion wird im Feld HCUSAG als numerischer Wert übergeben. Die Verwendungsnummer HCUSAG aus dem LFS steht für folgende Funktionen:<br><br />
;1 = Packstück-Verarbeitung (VersandDatenAnfrage)<br />
;2 = Packstückdaten aktualisieren (UpdateVersandDaten)<br />
;4 = Packstück stornieren (StornoVersandDaten)<br />
;5 = Packstück verladen/freigeben (VerladeVersandDaten)<br />
;6 = Tagesabschluss<br />
<br />
= Notwendige E+P LFS Parameter =<br />
<br />
Folgende Parameter werden für die Einrichtung vom DGS benötigt:<br />
{| class="wikitable"<br />
|-<br />
! Parameter !! Beschreibung<br />
|-<br />
| TCP/IP Port || TCP/IP Port über welchen der DataGatewayServer verfügbar sein soll<br />
|-<br />
| Stream Charset || Zeichensatz des TCP/IP Streams über welchen das E+P LFS Daten sendet<br />
|-<br />
| XML Charset || Zeichensatz des XML, welches von E+P gesendet wird<br />
|-<br />
| LFS Request-Element || XML Knoten, in welchen das E+P LFS die Packstückdaten sendet (Standard: PESSSND)<br />
|-<br />
| LFS Response-Element || XML Knoten, in welchen das E+P LFS die Rückmeldedaten erwartet (Standard: PESSRCV)<br />
|}<br />
<br />
= Verfügbare HVS32 Funktionen =<br />
Artikel-Daten und Gefahrgut-Informationen müssen im Request-XML als eigener Knoten (z.B. PESSGGV) auf gleicher Hirachie-Ebene zu den Packstückdaten übergeben werden, da diese in einer 1:n Beziehung zu den Packstückdaten stehen.<br><br />
Die Kommunikation ist bidirektional, d.h. die Rückmeldung erfolgt synchron in der gleichen Transaktion wie die Anfrage.<br><br />
<br />
Bitte beachten Sie, dass die Feld-Beschreibungen sich nur auf einen Standard beziehen, welcher als Vorschlag für die Schnittstelle dienen soll. Funktionsnamen, Feldnamen /-längen /-formate können prinzipiell abweichen, müssen in diesem Fall jedoch individuell betrachtet/analysiert werden.<br><br />
<br><br />
=== Packstück-Verarbeitung (VersandDatenAnfrage) [HCUSAG=1] ===<br />
Die Gatewayfunktion VersandDatenAnfrage wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück zu erzeugen und verbuchen. Ein Etikett wird für alle weiteren Funktionen wie Storno, Verladefreigabe, etc. anhand der hostseitigen Packstück-ID identifiziert. Diese wird im Feld PackstueckID übergeben und muss dementsprechend innerhalb des Versandsystems eindeutig sein.<br />
<br><br><br />
[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck-Verarbeitung_.28VersandDatenAnfrage.29|'''Schnittstellen-Feld-Beschreibung''']]<br />
<br />
=== Packstück verladen/freigeben (VerladeVersandDaten) [HCUSAG=5] ===<br />
Die Gatewayfunktion VerladeVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort Packstücke für den Ausgang frei zu geben. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt.<br />
<br><br><br />
[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck_verladen.2Ffreigeben_.28VerladeVersandDaten.29|'''Schnittstellen-Feld-Beschreibung''']]<br />
<br />
=== Packstückdaten aktualisieren (UpdateVersandDaten) [HCUSAG=2] ===<br />
Die Gatewayfunktion UpdateVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort die Daten von bestehende Packstücken zu verändern. Diese Anfrage wird zum Beispiel gesendet, wenn der Warenwert für ein Packstück erst zu einem späteren Zeitpunkt bekannt ist. Dabei wird stets über das Feld PackstueckID und bei Belegung auch über das Feld TrackingNr gesucht. <br><br><br />
'''Bei dieser Anfrage werden allerdings die zu aktualisierenden Felder und Inhalte nicht mehr nach den Richtlinien des Frachtführers geprüft (z.B. Gewichtsgrenzen, etc.). Es muss somit vom Vorsystem sichergestellt werden, dass die aktualisierenden Werte mit den Richtlinien des Frachtführers übereinstimmen. Sollte dies nicht möglich sein, kann diese Funktion nicht genutzt werden, sondern das Etikett muss storniert und neu verarbeitet werden. Außerdem können Felder, welche bereits auf einem Etikett angedruckt oder vom Versandsystem HVS32 in einer Frachtführerabwicklung ermittelt wurden (z.B. Adresse, Route, TrackingNr, Sonderdienste, etc.) nicht manipuliert werden.'''<br><br><br />
<br />
'''ACHTUNG: Alle Felder, welche im Versandsystem aktualisiert werden sollen, müssen vor der Nutzung dieser Funktion abgestimmt und im Versandsystem entsprechend konfiguriert werden!'''<br><br><br />
[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCckdaten_aktualisieren_.28UpdateVersandDaten.29|'''Schnittstellen-Feld-Beschreibung''']]<br />
<br />
=== Packstück stornieren (StornoVersandDaten) [HCUSAG=4] ===<br />
Die Gatewayfunktion StornoVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort bestehende Packstücke zu stornieren, die noch nicht auf einer Ausgangsliste sind. In der Regel wird ein Packstück anhand der hostseitigen Packstück-ID storniert. Diese wird im Feld PackstueckID übergeben. Zusätzlich zur hostseitigen Packstück-ID kann auch die TrackingNr zur Identifikation des Packstücks beitragen, für den Fall, dass die hostseitige Packstück-ID keine Eindeutigkeit garantieren kann.<br />
<br><br><br />
[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck_stornieren_.28StornoVersandDaten.29|'''Schnittstellen-Feld-Beschreibung''']]<br />
<br />
=== Tagesabschluss (Tagesabschluss) [HCUSAG=6] ===<br />
Das Gateway sendet die Tagesabschluss-Anfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit ein Tagesabschluss anhand der zusätzlich übergebenen Parameter ausgelöst. Der Tagesabschluss setzt sich aus den Punkten [[HVS32_Automatik-Polling_Funktionen#Ausgangsliste_erzeugen_.28Listenabschluss.29|Ausgangsliste erzeugen]] und [[HVS32_Automatik-Polling_Funktionen#Frachtf.C3.BChrer_DF.C3.9C_erzeugen_.28EDIAbschluss.29|Frachtführer DFÜ erzeugen]] zusammen. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt. Standardmäßig sind alle Packstücke freigegeben, außer sie wurden durch das Erweiterungsmodul Ausgangsscannung gesperrt. Die Rückmeldung im HVS32 findet nach dem Ausführen des Tagesabschluss statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung.<br />
<br><br><br />
[[HVS32_Automatik-Polling_Funktionen#Tagesabschluss_.28Tagesabschluss.29|'''Schnittstellen-Feld-Beschreibung''']]<br />
<br />
= Beispiele =<br />
<div class="toccolours mw-collapsible mw-collapsed" style="width:60%; overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispiel eines XML-Dokuments für eine Druckanfrage an den Packplatz DRELPPA07 inklusive einer<br />
Gefahrgutposition.</div><br />
<div class="mw-collapsible-content"><br />
<source><br />
<?xml version="1.0" encoding="ISO-8859-15"?><br />
<LFS><br />
<PESSSND><br />
<HCKONZ>200</HCKONZ><br />
<HCFIRM>010</HCFIRM><br />
<HCUSAG>1</HCUSAG><br />
<HCOUTQ>DRELPPA07</HCOUTQ><br />
<HCSART>IMP</HCSART><br />
<HCKDNR>0091052005</HCKDNR><br />
<HCAN1>Beispiel GmbH</HCAN1><br />
<HCAN2>z.H. Max Mustermann</HCAN2><br />
<HCSTR>Teststr. 4</HCSTR><br />
<HCLAKZ>DE</HCLAKZ><br />
<HCPLZ>12345</HCPLZ><br />
<HCLORT>Musterstadt</HCLORT><br />
<HCLRGN>001</HCLRGN><br />
<HCBHF>Versand+LS</HCBHF><br />
<HCMAND>200010</HCMAND><br />
<HCHVAR>DANS</HCHVAR><br />
<HCLSNR>0014488006</HCLSNR><br />
<HCANR1>0014488006</HCANR1><br />
<HCBST1>0201583029</HCBST1><br />
<HCWAWE_NUM>427,5000</HCWAWE_NUM><br />
<HCWSWW>EUR</HCWSWW><br />
<HCSSVC>31000</HCSSVC><br />
<HCFLCO>medical equipment</HCFLCO><br />
<HCDEDA>00.00.0000</HCDEDA><br />
<HCDETI>00:00</HCDETI><br />
<HCBGEW_NUM>224,05000</HCBGEW_NUM><br />
<HCNGEW_NUM>201,15000</HCNGEW_NUM><br />
<HCQUPA_NUM>1</HCQUPA_NUM><br />
<HCPANR_NUM>1</HCPANR_NUM><br />
<HCTOPA>PAL</HCTOPA><br />
<HCPLEN_NUM>120</HCPLEN_NUM><br />
<HCPWID_NUM>80</HCPWID_NUM><br />
<HCPHEI_NUM>72</HCPHEI_NUM><br />
<HCPKNR_NUM>357249014</HCPKNR_NUM><br />
<HCDDAT>01.06.2007</HCDDAT><br />
<HCDTIM>10:22</HCDTIM><br />
<HCIDOC>0000000022309156</HCIDOC><br />
<HCLBSL>FH</HCLBSL><br />
<HCLAPA>1</HCLAPA><br />
<HCRA13>A3001140</HCRA13><br />
<HCRA18>DZL/4501017185</HCRA18><br />
<HCAJH_NUM>20</HCAJH_NUM><br />
<HCAJA_NUM>7</HCAJA_NUM><br />
<HCAMO_NUM>6</HCAMO_NUM><br />
<HCATA_NUM>1</HCATA_NUM><br />
<HCASTD_NUM>10</HCASTD_NUM><br />
<HCAMIN_NUM>22</HCAMIN_NUM><br />
<HCASEK_NUM>24</HCASEK_NUM><br />
<HCLFDN_NUM>1992951</HCLFDN_NUM><br />
</PESSSND><br />
<PESSGGV><br />
<HGKONZ>200</HGKONZ><br />
<HGFIRM>010</HGFIRM><br />
<HGZUNR_NUM>6251</HGZUNR_NUM><br />
<HGGGS>UN31</HGGGS><br />
<HGGMEN_NUM>1,000</HGGMEN_NUM><br />
<HGME>ST</HGME><br />
</PESSGGV><br />
</LFS><br />
</source><br />
</div></div><br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="width:60%; overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Rückmeldung für die obige Anfrage:</div><br />
<div class="mw-collapsible-content"><br />
<br />
<source><br />
<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?><br />
<LFS><br />
<PHVSRCV><br />
<HCKONZ>200</HCKONZ><br />
<HCFIRM>010</HCFIRM><br />
<HCUSAG>1</HCUSAG><br />
<HCOUTQ>DRELPPA07</HCOUTQ><br />
<HCSART>IMP</HCSART><br />
<HCKDNR>0091052005</HCKDNR><br />
<HCAN1>Beispiel GmbH</HCAN1><br />
<HCAN2>z.H. Max Mustermann</HCAN2><br />
<HCSTR>Teststr. 4</HCSTR><br />
<HCLAKZ>DE</HCLAKZ><br />
<HCPLZ>12345</HCPLZ><br />
<HCLORT>Musterstadt</HCLORT><br />
<HCLRGN>001</HCLRGN><br />
<HCBHF>Versand+LS</HCBHF><br />
<HCMAND>200010</HCMAND><br />
<HCHVAR>DANS</HCHVAR><br />
<HCLSNR>0014488006</HCLSNR><br />
<HCANR1>0014488006</HCANR1><br />
<HCBST1>0201583029</HCBST1><br />
<HCWAWE_NUM>427,5000</HCWAWE_NUM><br />
<HCWSWW>EUR</HCWSWW><br />
<HCSSVC>31000</HCSSVC><br />
<HCFLCO>medical equipment</HCFLCO><br />
<HCDEDA>00.00.0000</HCDEDA><br />
<HCDETI>00:00</HCDETI><br />
<HCBGEW_NUM>224,05000</HCBGEW_NUM><br />
<HCNGEW_NUM>201,15000</HCNGEW_NUM><br />
<HCQUPA_NUM>1</HCQUPA_NUM><br />
<HCPANR_NUM>1</HCPANR_NUM><br />
<HCTOPA>PAL</HCTOPA><br />
<HCPLEN_NUM>120</HCPLEN_NUM><br />
<HCPWID_NUM>80</HCPWID_NUM><br />
<HCPHEI_NUM>72</HCPHEI_NUM><br />
<HCPKNR_NUM>357249014</HCPKNR_NUM><br />
<HCDDAT>01.06.2007</HCDDAT><br />
<HCDTIM>10:22</HCDTIM><br />
<HCIDOC>0000000022309156</HCIDOC><br />
<HCLBSL>FH</HCLBSL><br />
<HCLAPA>1</HCLAPA><br />
<HCRA13>A3001140</HCRA13><br />
<HCRA18>DZL/4501017185</HCRA18><br />
<HCAJH_NUM>20</HCAJH_NUM><br />
<HCAJA_NUM>7</HCAJA_NUM><br />
<HCAMO_NUM>6</HCAMO_NUM><br />
<HCATA_NUM>1</HCATA_NUM><br />
<HCASTD_NUM>10</HCASTD_NUM><br />
<HCAMIN_NUM>22</HCAMIN_NUM><br />
<HCASEK_NUM>24</HCASEK_NUM><br />
<HCLFDN_NUM>1992951</HCLFDN_NUM><br />
<HCRA15>073427000040941</HCRA15><br />
<HCVENR>JND60073427000040941</HCVENR><br />
</PHVSRCV><br />
</LFS><br />
</source><br />
</div></div><br />
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="width:60%; overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">Beispiel-Mapping</div><br />
<div class="mw-collapsible-content"><br />
{|class="wikitable sortable"<br />
|-<br />
! HVS32 Feld !! LFS Feld<br />
|-<br />
| KundenNr || HCKDNR<br />
|-<br />
| ZielAdrName1 || HCAN1<br />
|-<br />
| ZielAdrName2 || HCAN2<br />
|-<br />
| ZielAdrName3 || HCAN3<br />
|-<br />
| ZielAdrStrasse || HCSTR<br />
|-<br />
| ZielAdrLKZ || HCLAKZ<br />
|-<br />
| ZielAdrPLZ || HCPLZ<br />
|-<br />
| ZielAdrOrt || HCLORT<br />
|-<br />
| ZielAdrRegion || HCLRGN<br />
|-<br />
| ZielAdrBahnhof || HCBHF<br />
|-<br />
| Ansprechpartner || HCCNTC<br />
|-<br />
| TelefonNr || HCTEL<br />
|-<br />
| FaxNr || HCFAX<br />
|-<br />
| EmpfEmailAdresse || HCEMAI<br />
|-<br />
| UstIDNr || HCUIDN<br />
|-<br />
| ILNNr || HCKILN<br />
|-<br />
| AuftraggeberID || HCMAND<br />
|-<br />
| VersandartID || HCVAVS<br />
|-<br />
| AVISHinweis1 || HCSHW1<br />
|-<br />
| AVISHinweis2 || HCSHW2<br />
|-<br />
| ZusatzZeile1 || HCADA1<br />
|-<br />
| ZusatzZeile2 || HCADA2<br />
|-<br />
| LieferscheinNr || HCLSVS<br />
|-<br />
| AuftragNr || HCANR1<br />
|-<br />
| BestellNr || HCBST1<br />
|-<br />
| KundenBestellNr || HCRA18<br />
|-<br />
| Warenwert || HCWAWE_NUM<br />
|-<br />
| WWWaehrung || HCWSWW<br />
|-<br />
| Nachnahme || HCNNWE_NUM<br />
|-<br />
| NNWaehrung || HCWSNN<br />
|-<br />
| NNVermerk || HCCODT<br />
|-<br />
| NNVerwendung || HCCODU<br />
|-<br />
| Versicherungswert || HCINSW<br />
|-<br />
| VWWaehrung || HCCKIW<br />
|-<br />
| FrankaturKennung || HCLBSL<br />
|-<br />
| Zahlungsbedinung || HCTPAY<br />
|-<br />
| ZbZoll || HCTCUS<br />
|-<br />
| FrachtfuehrerKdNr || HCTPNR<br />
|-<br />
| FrachtfuehrerKdNrZoll || HCTCNR<br />
|-<br />
| SonderdiensteInaktiv || HCSSVC<br />
|-<br />
| SendungsInhalt || HCFLCO<br />
|-<br />
| TerminArt || HCTKZ<br />
|-<br />
| TerminDatum || HCDTLF<br />
|-<br />
| RechnungsEmpfName1 || HCBAN1<br />
|-<br />
| RechnungsEmpfName2 || HCBAN2<br />
|-<br />
| RechnungsEmpfName3 || HCBAN3<br />
|-<br />
| RechnungsEmpfStr || HCBSTR<br />
|-<br />
| RechnungsEmpfLKZ || HCBLKZ<br />
|-<br />
| RechnungsEmpfPLZ || HCBPLZ<br />
|-<br />
| RechnungsEmpfOrt || HCBORT<br />
|-<br />
| PostLeitcode || HCPLCD<br />
|-<br />
| PostZielfrachtzent || HCDEFC<br />
|-<br />
| Frachtbrief || HCBOL<br />
|-<br />
| Gewicht || HCBGEW_NUM<br />
|-<br />
| PackStkGes || HCQUPA_NUM<br />
|-<br />
| PackStkNr || HCPANR_NUM<br />
|-<br />
| VerpackungsArt || HCTOPA<br />
|-<br />
| PackStueckLaenge || HCPLEN_NUM<br />
|-<br />
| PackStueckBreite || HCPWID_NUM<br />
|-<br />
| PackStueckHoehe || HCPHEI_NUM<br />
|-<br />
| PackStueckID || HCPKNR_NUM<br />
|-<br />
| LieferscheinDatum || HCRA10<br />
|}<br />
</div></div><br />
<br />
= FAQ / Troubleshooting =</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Automatik-Polling_Funktionen&diff=5724
HVS32 Automatik-Polling Funktionen
2024-04-22T06:40:12Z
<p>Bhauser: /* Packstückdaten aktualisieren (UpdateVersandDaten) */</p>
<hr />
<div>[[en:HVS32_automatic_polling_functions]]<br />
= Datentypen =<br />
'''Integer''' - Zahl mit ausschließlich numerischen Zeichen (0-9).<br><br />
'''Decimal''' - Zahl mit Nachkommastellen<br><br />
'''String''' - Beliebige Zeichen aus dem Zeichensatz ISO-8859-1. Maximale Länge darf nicht überschritten werden.<br><br />
= Zusätzliche Datentypen =<br />
Zusätzliche Datentypen, welche in der Beschreibung vorkommen, stehen in einer 1:n Relation zu den Packstücken.<br />
Bitte entnehmen Sie der jeweiligen Schnittstellen-Dokumentation des entsprechenden Plugins (File, JDBC, SAP, etc.), wie diese Relation realisiert werden muss.<br />
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT UNTERFUNKTIONEN ------------------------------------------------------------------------------- --><br />
<br />
<!-- ------------------------------------------------------------------------------- artikelDaten ------------------------------------------------------------------------------- --><br />
== ArtikelDaten ==<br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
|Satz-Kennung<br />
|[[#Datentypen|String]]<br />
|3<br />
| -<br />
|'''Wird nur bei Datei Verabeitung benötigt'''<br />
Satzkennung in der Polling Datei: "ART"<br />
|-<br />
|'''--- ARTIKELDATEN-TEIL ---'''<br />
|<br />
|<br />
|<br />
|<br />
|-<br />
| ANZAHLBUEGEL || [[#Datentypen|Integer]] || - || - || Nur für Hängeversand: Anzahl der Bügel auf welche die Artikelgruppe aufgeteilt ist<br />
|-<br />
| ANZAHLPOSETIKETTEN || [[#Datentypen|Integer]] || - || - || Anzahl Artikeletiketten, welche gedruckt werden sollen<br />
|-<br />
| ARTIKELBTNNR || [[#Datentypen|String]] || 25 || - || BTN Nummer / Zolltarifnummer<br />
|-<br />
| ARTIKELEAN || [[#Datentypen|String]] || 20 || - || EAN Nummer<br />
|-<br />
| ARTIKELEINHEIT || [[#Datentypen|String]] || 10 || - || Einheit der Artikelmenge<br />
|-<br />
| ARTIKELGEWICHT || [[#Datentypen|Decimal]] || 9 || 3 || Gewicht des Artikels in kg<br />
|-<br />
| ARTIKELGRUPPE || [[#Datentypen|String]] || 50 || - || Artikelgruppe<br />
|-<br />
| ARTIKELMENGE || [[#Datentypen|Decimal]] || 9 || 3 || Menge des Artikels<br />
|-<br />
| ARTIKELSERVICES || [[#Datentypen|String]] || 100 || - || Pipe getrennte Services für diesen Artikel<br />
|-<br />
| ARTIKELSOLLMENGE || [[#Datentypen|Decimal]] || 9 || 3 || -<br />
|-<br />
| ARTIKELTEXT1 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung<br />
|-<br />
| ARTIKELTEXT2 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung<br />
|-<br />
| ARTIKELTEXT3 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung<br />
|-<br />
| ARTIKELTEXT4 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung<br />
|-<br />
| ARTIKELVOLUMEN || [[#Datentypen|Decimal]] || 9 || 3 || Volumen des Artikels<br />
|-<br />
| ARTIKELWAEHRUNG || [[#Datentypen|String]] || 3 || - || Währung in welcher der Wert des Artikels angegeben wird<br />
|-<br />
| ARTIKELWERT || [[#Datentypen|Decimal]] || 18 || 2 || Wert des Artikels<br />
|-<br />
| CHARGEFLAG || [[#Datentypen|String]] || 1 || - || <br />
|-<br />
| KUNDENARTIKELNR || [[#Datentypen|String]] || 50 || - || Artikelnummer<br />
|-<br />
| KUNDENBESTELLNR || [[#Datentypen|String]] || 50 || - || Bestellnummer<br />
|-<br />
| POSAUFTRAGNR || [[#Datentypen|String]] || 50 || - || Auftragsnummer<br />
|-<br />
| POSLIEFERNR || [[#Datentypen|String]] || 40 || - || Lieferscheinnummer<br />
|-<br />
| POSITIONNR || [[#Datentypen|String]] || 50 || - || Laufende Nummer innerhalb des Packstücks<br />
|-<br />
| SERIENNR || [[#Datentypen|String]] || 30 || - || Seriennummer<br />
|-<br />
| URSPRUNGLAND || [[HVS32 Automatik-Polling Funktionen#Datentypen|String]] || 2 || - || Ursprungsland des Artikels<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE artikelDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- --><br />
<br />
== Gefahrgut ==<br />
<br />
<br />
In der Gefahrgut Abwicklung bieten wir zwei Möglichkeiten der Abwicklung an. Zum einen können die kompletten Gefahrgutdaten ans HVS32 übermittelt werden [[HVS32 Automatik-Polling Funktionen#Gefahrgut (aus den Positionsdaten)|(aus den Positionsdaten)]].<br />
<br />
Zum anderen gibt es die Möglichkeit, die Gefahrgutdaten ins HVS32 zu importieren und dort zu pflegen (siehe [[Verarbeitungsbeschreibung: Gefahrgut|Gefahrgutstamm]]). In diesem Fall müssen nicht alle Gefahrgutdaten ans HVS32 übermittelt werden, sondern werden aus dem im HVS32 hinterlegten Stamm ausgelesen. [[HVS32 Automatik-Polling Funktionen#Gefahrgut (über Gefahrgutstamm im HVS32)|(über Gefahrgutstamm im HVS32)]]<!--------------------------------------------------------------------------------- gefahrgut positionsdaten ---------------------------------------------------------------------------------><br />
===Gefahrgut (aus den Positionsdaten)===<br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
|Satz-Kennung<br />
|[[#Datentypen|String]]<br />
|3<br />
| -<br />
|'''Wird nur bei Datei Verabeitung benötigt'''<br />
Satzkennung in der Polling Datei: "GEF"<br />
|-<br />
|'''--- GEFAHRGUTDATEN-TEIL ---'''<br />
|<br />
|<br />
|<br />
|<br />
|-<br />
| '''GEFAHRGUTBEFOERDKAT''' ||[[#Datentypen|Integer]] || 1 || - || Beförderungskategorie, Pflicht (siehe ADR-Tabelle Spalte (15)), kann 0-4 sein. Achtung! Muss unbedingt korrekt sein.<br />
|-<br />
| GEFAHRGUTBEGRENZTEMENGE || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status LQ / Begrenzte Menge nach ADR 3.4 verschickt wird, ansonsten F, Pflicht<br />
|-<br />
| '''GEFAHRGUTBEZEICHNUNG''' ||[[#Datentypen|String]] || 110 || - || Pflicht (siehe ADR-Tabelle Spalte (2))<br />
|-<br />
| GEFAHRGUTBUCHST640 || [[#Datentypen|String]] || 1 || - || Buchstabe für Sondervorschrift 640, bedingte Pflicht bei Stoffen, bei denen die Sondervorschrift 640 gilt (siehe ADR-Tabelle Spalte (6))<br />
|-<br />
| GEFAHRGUTFFCODE || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG --><br />
|-<br />
| GEFAHRGUTFAKTOR || [[#Datentypen|Integer]] || 3 || - || Bewertungsfaktor für Punktesummation auf dem Beförderungspapier, (kann 0, 1, 3, 50 oder 999 sein), eigentlich Pflicht, kann aber eindeutig aus der Beförderungskategorie geschlossen werden, daher muss es nicht unbedingt belegt sein<br />
|-<br />
| GEFAHRGUTFREIGESTMENGE || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status EQ / Excepted Quantities nach ADR 3.5 verschickt wird, ansonsten F, Pflicht<br />
|-<br />
| GEFAHRGUTID || [[#Datentypen|String]] || 20 || - || Eindeutige Suchnummer für Gefahrgut-Stammdaten<br />
|-<br />
| GEFAHRGUTKCODE || [[#Datentypen|String]] || 10 || - || Klassifizierungscode, Pflicht (siehe ADR-Tabelle Spalte (3b))<br />
|-<br />
| '''GEFAHRGUTKLASSE''' ||[[#Datentypen|String]] || 100 || - || Pflicht (siehe ADR-Tabelle Spalte (3a))<br />
|-<br />
| '''GEFAHRGUTMENGE''' ||[[#Datentypen|Decimal]] || 8 || 3 || Stoff-Menge an Gefahrgut, die ADR-technisch zu deklarieren ist ( in Litern bei Flüssigkeiten und verdichteten Gasen, sonst in kg, bei LQ-Gefahrgut immer kg )<br />
|-<br />
| '''GEFAHRGUTMENGENEINHEIT''' ||[[#Datentypen|String]] || 2 || - || Mengeneinheit zur Stoff-Menge. ‚1‘ oder ‚l‘: Liter ; ‚0‘ oder ‚kg‘ oder leer: kg<br />
|-<br />
| GEFAHRGUTNEBENGEFAHR || [[#Datentypen|String]] || 10 || - || bedingte Pflicht bei Stoffen, bei denen neben der Hauptgefahr-Klasse/Zettelnummer noch Nebengefahr-Zettelnummern vorhanden sind (siehe ADR-Tabelle Spalte (5), wenn dort z.B. 3+6.1+8 eingetragen ist, sind 6.1 und 8 die Nebengefahr-Zettelnummern und als (6.1)(8) im Feld Nebengefahr zu übermitteln )<br />
|-<br />
| GEFAHRGUTNETTOEXPLMASSE || [[#Datentypen|Decimal]] || 8 || 3 || Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1<br />
|-<br />
| GEFAHRGUTPOSITIONNR || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| GEFAHRGUTTECHBENENNUNG || [[#Datentypen|String]] || 150 || - || bedingt Pflicht bei N.A.G. Gefahrgut (d.h. wenn die Bezeichnung mit N.A.G. endet)<br />
|-<br />
| GEFAHRGUTTUNNELBCODE || [[#Datentypen|String]] || 10 || - || Tunnelbeschränkungscode, Pflicht (siehe ADR-Tabelle Spalte (15))<br />
|-<br />
| '''GEFAHRGUTUNNR''' ||[[#Datentypen|String]] || 10 || - || Pflicht (siehe ADR-Tabelle Spalte (1))<br />
|-<br />
| GEFAHRGUTUMWELTGEF || [[#Datentypen|String]] || 1 || - || T wenn Stoff umweltgefährdend ist , ansonsten F, Pflicht bei umweltgefährdenden Stoffen<br />
|-<br />
| GEFAHRGUTVPG || [[#Datentypen|String]] || 3 || - || Verpackungsgruppe, bedingt Pflicht bei den Stoffen, bei denen diese in der ADR-Tabelle belegt ist, kann I,II oder III sein oder gar nicht belegt (letzteres z.B. bei Klasse 2)) (siehe ADR-Tabelle Spalte (4))<br />
|-<br />
| '''GEFAHRGUTVERPANZAHL''' ||[[#Datentypen|Integer]] || 4 || - || Anzahl der Einheiten, in denen das Gefahrgut verpackt ist (in Zusammenhang mit dem nächsten Feld GefahrgutVerpackungsart)<br />
|-<br />
| '''GEFAHRGUTVERPACKUNGSART''' ||[[#Datentypen|String]] || 5 || - || ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes<br />
|}<br />
===Gefahrgut (über [[Verarbeitungsbeschreibung: Gefahrgut|Gefahrgutstamm im HVS32]])===<br />
{| class="wikitable sortable"<br />
|-<br />
!Feldname !!Typ!!Max Länge!! Dezimalstellen!!Belegung<br />
|-<br />
|'''GefahrgutID'''||[[HVS32 Automatik-Polling Funktionen#Datentypen|String]]||20||- ||Eindeutige Suchnummer für Gefahrgut-Stammdaten<br />
|-<br />
|'''GefahrgutMenge'''||[[HVS32 Automatik-Polling Funktionen#Datentypen|Decimal]]||8||3||-<br />
|-<br />
|'''GefahrgutVerpAnzahl'''||[[HVS32 Automatik-Polling Funktionen#Datentypen|Integer]]||-||-||-<br />
|-<br />
|'''GefahrgutMengenEinheit'''||[[HVS32 Automatik-Polling Funktionen#Datentypen|String]]||2||- ||'0' bzw Blank: Kilogramm; '1': Liter<br />
|-<br />
|GefahrgutNettoExplMasse ||[[HVS32 Automatik-Polling Funktionen#Datentypen|Decimal]]||8||3 ||Nur bei Klasse 1, dann aber Pflicht<br />
|}<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- --><br />
<br />
= Packstück-Verarbeitung (VersandDatenAnfrage) =<br />
Die Gatewayfunktion VersandDatenAnfrage wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück zu erzeugen und verbuchen.<br />
Ein Etikett wird für alle weiteren Funktionen wir Storno, Verladefreigabe, etc. anhand der hostseitigen Packstück-ID identifiziert. Diese wird im Feld PackstueckID übergeben und muss dementsprechend innerhalb des Versandsystems eindeutig sein.<br />
<br />
<br />
Durch eine zusätzliche Konfiguration im HVS32 kann die VersandDatenAnfrage auch dazu verwendet werden, um einen Nachdruck anzustoßen. Dabei muss bei der erneuten Anfrage die selbe PackstueckID verwendet werden.<br><br />
<br><br />
<big>'''Übergabe Parameter'''</big><br />
<br><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| ANSPRECHPARTNER || [[#Datentypen|String]] || 50 || - || Empfänger Ansprechpartner<br />
|-<br />
| ANZAHLARTIKEL || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)<br />
|-<br />
| [[#ArtikelDaten|ARTIKELDATEN]] || [[#Datentypen|Sequence]] '''[[#ArtikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#ArtikelDaten|Packstück-Artikel]] vom Typ '''[[#ArtikelDaten|ArtikelDaten]]''' (1:n)<br />
|-<br />
| AUFTRAGNR || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| '''AUFTRAGGEBERID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32<br />
|-<br />
| AVISHINWEIS1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| AVISHINWEIS2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| AVISZUSATZ1 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 1<br />
|-<br />
| AVISZUSATZ2 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 2<br />
|-<br />
| BARCODEID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| BARCODETEXT || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| BARCODETYP || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| BESTELLNR || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)<br />
|-<br />
| DRUCKERNAME || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)<br />
|-<br />
| EMAIL || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)<br />
|-<br />
| EMPFMOBILFUNKNR || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers<br />
|-<br />
| FAXNR || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers<br />
|-<br />
| FLEXZUSTELLUNGEMAILADRESSE || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse<br />
|-<br />
| FRACHTBRIEF || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll<br />
|-<br />
| FRACHTFUEHRERKDNR || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer<br />
|-<br />
| FRANKATURKENNUNG || [[#Datentypen|String]] || 10 || - || -<br />
|-<br />
| [[#Gefahrgut|GEFAHRGUT]] || [[#Datentypen|Sequence]] '''[[#Gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#Gefahrgut|Gefahrgüter]] vom Typ '''[[#Gefahrgut|Gefahrgut]]''' (1:n)<br />
|-<br />
| '''GEWICHT''' ||[[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG<br />
|-<br />
| HOSTTRACKINGNR || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem<br />
|-<br />
| ILNNR || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)<br />
|-<br />
| KOSTENSTELLE || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| KUNDENNR || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender<br />
|-<br />
| LAGERKENNZEICHEN || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| LETZTESPACKSTUECK || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)<br />
|-<br />
| LIEFERANTENID || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| '''LIEFERSCHEINNR''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet<br />
|-<br />
| NACHNAHME || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| NETTOGEWICHT || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG<br />
|-<br />
| NEUTBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTBANKBEZEICHNUNG || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTKONTOINHABER || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERNAME1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERNAME2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERNAME3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERORT || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERSTRASSE || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NNVERMERK || [[#Datentypen|String]] || 1 || - || 'B': Bar / 'V': Verrechnungsscheck<br />
|-<br />
| NNVERWENDUNG || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck<br />
|-<br />
| NNWAEHRUNG || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode<br />
|-<br />
| '''PACKSTKGES''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung<br />
|-<br />
| '''PACKSTKNR''' || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung<br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.<br />
|-<br />
| PACKSTUECKBREITE || [[#Datentypen|Integer]] || - || - || Breite in cm<br />
|-<br />
| PACKSTUECKHOEHE || [[#Datentypen|Integer]] || - || - || Höhe in cm<br />
|-<br />
| '''PACKSTUECKID''' || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.<br />
|-<br />
| PACKSTUECKLAENGE || [[#Datentypen|Integer]] || - || - || Länge in cm<br />
|-<br />
| PAPERLESSINVOICE || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)<br />
|-<br />
| POSTLEITCODE || [[#Datentypen|String]] || 15 || - || -<br />
|-<br />
| POSTZIELFRACHTZENT || [[#Datentypen|String]] || 5 || - || -<br />
|-<br />
| RECHNUNGSEMPFLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSEMPFNAME1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| RECHNUNGSEMPFNAME2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| RECHNUNGSEMPFNAME3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| RECHNUNGSEMPFORT || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSEMPFPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSEMPFSTRASSE || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSNR || [[#Datentypen|String]] || 20 || - || Rechnungsnummer<br />
|-<br />
| SENDUNGSINHALT || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| SONDERDIENSTE || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt<br />
|-<br />
| SPERRFLAG || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren<br />
|-<br />
| TELEFONNR || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers<br />
|-<br />
| TERMINART || [[#Datentypen|String]] || 1 || - || 'A' = ab diesem Tag liefern<br />
'B' = bis zu diesem Tag liefern<br />
<br />
'F' = an diesem Tag liefern<br />
|-<br />
| TERMINDATUM || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| TERMINZEIT || [[#Datentypen|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| USTIDNR || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers<br />
|-<br />
| VERPACKUNGSART || [[#Datentypen|String]] || 6 || - || -<br />
|-<br />
| '''VERSANDARTID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32<br />
|-<br />
| VERSICHERUNGSWERT || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert<br />
|-<br />
| VORPACKDATUM || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| VWWAEHRUNG || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode<br />
|-<br />
| WARENWERT || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird<br />
|-<br />
| WWWAEHRUNG || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode<br />
|-<br />
| ZAHLUNGSBEDINGUNG || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| ZBZOLL || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| ZIELADRBAHNHOF || [[#Datentypen|String]] || 30 || - || PLZ und Ort<br />
|-<br />
| '''ZIELADRLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse<br />
|-<br />
| '''ZIELADRNAME1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| ZIELADRNAME2 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| ZIELADRNAME3 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| ZIELADRNAME4 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''ZIELADRORT''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''ZIELADRPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse<br />
|-<br />
| ZIELADRREGION || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)<br />
|-<br />
| '''ZIELADRSTRASSE''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|}<br />
<br />
<br><big>'''Rückgabe Parameter'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|<br />
|-<br />
| AUSGANGDATETIME || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)<br />
|-<br />
| DRUCKDATETIME || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich<br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| GEBUEHR || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten<br />
|-<br />
| GEBUEHRWAEHRUNG || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode<br />
|-<br />
| PACKSTUECKID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage<br />
|-<br />
| RETOURTRACKINGNR || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure<br />
|-<br />
| TRACKINGNR || [[#Datentypen|String]] || 35 || - || Paketnummer<br />
|-<br />
| TRACKINGURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung<br />
|-<br />
| VERSANDSENDUNGSNR || [[#Datentypen|String]] || - || - || -<br />
|}<br />
<br />
= Etikett nachdrucken (VersandDatenWdhDruck) =<br />
Die Gatewayfunktion VersandDatenWdhDruck wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück nachzudrucken.<br />
Ein Etikett wird anhand der hostseitigen Packstück-ID nachgedruckt. Diese wird im Feld PackstueckID übergeben.<br />
Bei manchen Frachtführern (z.B. DPD) werden beim Nachdruck neue Trackingnummern vergeben. Somit ist die alte Trackingnummer nicht mehr gültig und das alte Versandetikett muss vernichtet werden.<br />
Die neue Trackingnummer kann in der Rückmeldung zurückgemeldet werden.<br />
<br><br><big>'''Übergabe Parameter'''</big><br><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| '''PACKSTUECKID''' || [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.<br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.<br />
|-<br />
| DRUCKERNAME || [[#Datentypen|String]] || 30 || - || Ausgabekanal, an welchem das Etikett nachgedruckt werden soll (benötigt HVS32 Erweiterungsmodul "Druckerspooler")<br />
|}<br />
<br><big>'''Rückgabe Parameter'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich, 1 = Fehler<br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| TRACKINGNR || [[#Datentypen|String]] || 35 || - || (neue) TrackingNr des Packstücks<br />
|}<br />
<br />
= Packstück stornieren (StornoVersandDaten) =<br />
Die Gatewayfunktion StornoVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort bestehende Packstücke zu stornieren, die noch nicht auf einer Ausgangsliste sind.<br />
In der Regel wird ein Packstück anhand der hostseitigen Packstück-ID storniert. Diese wird im Feld PackstueckID übergeben.<br />
Zusätzlich zur hostseitigen Packstück-ID kann auch die TrackingNr zur Identifikation des Packstücks beitragen, für den Fall, dass die hostseitige Packstück-ID keine Eindeutigkeit garantieren kann.<br />
Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Storno wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br><big>'''Übergabe Parameter'''</big><br><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| '''PACKSTUECKID''' || [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.<br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.<br />
|}<br />
<br><big>'''Rückgabe Parameter'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich, 1 = Fehler<br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
<br />
= Packstück verladen/freigeben (VerladeVersandDaten) =<br />
Die Gatewayfunktion VerladeVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort Packstücke für den Ausgang frei zu geben.<br />
Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt.<br />
Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreicher Freigabe wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br><big>'''Übergabe Parameter'''</big><br><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| '''PACKSTUECKID''' || [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.<br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.<br />
|-<br />
| SPERRKENNZEICHEN || [[#Datentypen|String]] || 1 || - || "J" wenn das Packstück gesperrt werden soll<br />
|-<br />
| WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Wechselbrücke auf welche das Packstück gebucht werden soll<br />
|-<br />
| SAMMELFREIGABE || [[#Datentypen|String]] || 1 || - || "T" bei einer Sammel-Freigabe (Alle Packstücke mit identischer VE-ReferenzNr freigeben)<br />
|-<br />
| VEREFERENZNR || [[#Datentypen|String]] || 20 || - || muss bei einer Sammel-Freigabe gefüllt sein<br />
|}<br />
<br><big>'''Rückgabe Parameter'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich, 1 = Fehler<br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
<br />
= Tagesabschluss (Tagesabschluss) =<br />
Das Gateway sendet die Tagesabschluss-Anfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit ein Tagesabschluss anhand der zusätzlich übergebenen Parameter ausgelöst.<br />
Der Tagesabschluss setzt sich aus den Punkten Ausgangsliste erzeugen und Frachtführer DFÜ erzeugen zusammen.<br />
Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt. Standardmäßig sind alle Packstücke freigegeben, außer sie wurden durch das Erweiterungsmodul Ausgangsscannung gesperrt.<br />
Die Rückmeldung im HVS32 findet nach dem Ausführen des Tagesabschluss statt.<br />
Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Tagesabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br><big>'''Übergabe Parameter'''</big><br><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.<br />
|-<br />
| FRACHTFUEHRERTYPLIST || [[#Datentypen|String]] || 250 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.<br />
(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| AUFTRAGGEBERIDLIST || [[#Datentypen|String]] || 250 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Auftraggebern mitgegeben werden. Es können n-Auftraggeber abgeschlossen werden.<br />
(Option MultiAGTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| VERSANDARTIDLIST || [[#Datentypen|String]] || 250 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.<br />
(Option MultiVATagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.<br />
|-<br />
| DRUCKERNAME || [[#Datentypen|String]] || 30 || - || Name des Ausgabekanals auf welchem die Liste gedruckt werden soll<br />
|}<br />
<br><big>'''Rückgabe Parameter'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich, 1 = Fehler<br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
<br />
= Ausgangsliste erzeugen (Listenabschluss) =<br />
Das Gateway sendet die Listenabschluss-Anfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine Ausgangsliste anhand der zusätzlich übergebenen Parameter erzeugt.<br />
Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Listenabschluss berücksichtigt. Standardmäßig sind alle Packstücke freigegeben, außer sie wurden durch das Erweiterungsmodul Ausgangsscannung gesperrt.<br />
Die Rückmeldung im HVS32 findet nach dem Erzeugen der Ausgangsliste statt.<br />
Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Listenabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br><big>'''Übergabe Parameter'''</big><br><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.<br />
|-<br />
| FRACHTFUEHRERTYPLIST || [[#Datentypen|String]] || 250 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.<br />
(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| AUFTRAGGEBERIDLIST || [[#Datentypen|String]] || 250 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Auftraggebern mitgegeben werden. Es können n-Auftraggeber abgeschlossen werden.<br />
(Option MultiAGTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| VERSANDARTIDLIST || [[#Datentypen|String]] || 250 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.<br />
(Option MultiVATagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.<br />
|-<br />
| DRUCKERNAME || [[#Datentypen|String]] || 30 || - || Name des Ausgabekanals auf welchem die Liste gedruckt werden soll<br />
|}<br />
<br><big>'''Rückgabe Parameter'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich, 1 = Fehler<br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
<br />
= Frachtführer DFÜ erzeugen (EDIAbschluss) =<br />
Das Gateway sendet die EDIAbschluss-Anfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine Frachtführer DFÜ anhand der zusätzlich übergebenen Parameter erzeugt und (falls konfiguriert) an den Frachtführer übertragen.<br />
Nur Packstücke, für welche zuvor eine Ausgangsliste erzeugt wurde, werden für eine Frachtführer DFÜ berücksichtigt.<br />
Die Rückmeldung im HVS32 findet nach dem Erzeugen der Frachtführer DFÜ statt.<br />
Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem EDIAbschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br><big>'''Übergabe Parameter'''</big><br><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.<br />
|-<br />
| FRACHTFUEHRERTYPLIST || [[#Datentypen|String]] || 250 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.<br />
(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| AUFTRAGGEBERIDLIST || [[#Datentypen|String]] || 250 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Auftraggebern mitgegeben werden. Es können n-Auftraggeber abgeschlossen werden.<br />
(Option MultiAGTagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| VERSANDARTIDLIST || [[#Datentypen|String]] || 250 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.<br />
(Option MultiVATagesabschluss muss im HVS32 aktiv sein)<br />
|-<br />
| WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.<br />
|}<br />
<br><big>'''Rückgabe Parameter'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich, 1 = Fehler<br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
<br />
= Packstückdaten prüfen (VersandDatenPruefAnfrage) =<br />
Das Gateway sendet die VersandDatenPruefAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine VersandDatenAnfrage simuliert.<br />
Dabei werden keine Etiketten gedruckt und das Packstück bzw. das Etikett wird nicht verbucht, jedoch sind alle weiteren Prozesse identisch zur VersandDatenAnfrage (Routenermittlung, Trackingnummer-Ermittlung, Adressprüfung, etc.)<br />
Diese Funktion dient dazu im Vorfeld alle Versand-Daten zu validieren.<br />
<br><br><big>'''Übergabe Parameter'''</big><br><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| ANSPRECHPARTNER || [[#Datentypen|String]] || 50 || - || Empfänger Ansprechpartner<br />
|-<br />
| ANZAHLARTIKEL || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)<br />
|-<br />
| [[#ArtikelDaten|ARTIKELDATEN]] || [[#Datentypen|Sequence]] '''[[#ArtikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#ArtikelDaten|Packstück-Artikel]] vom Typ '''[[#ArtikelDaten|ArtikelDaten]]''' (1:n)<br />
|-<br />
| AUFTRAGNR || [[#Datentypen|String]] || 20 || - || -<br />
|-<br />
| '''AUFTRAGGEBERID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32<br />
|-<br />
| AVISHINWEIS1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| AVISHINWEIS2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| AVISZUSATZ1 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 1<br />
|-<br />
| AVISZUSATZ2 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 2<br />
|-<br />
| BARCODEID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| BARCODETEXT || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| BARCODETYP || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen<br />
|-<br />
| BESTELLNR || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)<br />
|-<br />
| DRUCKERNAME || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)<br />
|-<br />
| EMAIL || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)<br />
|-<br />
| EMPFMOBILFUNKNR || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers<br />
|-<br />
| FAXNR || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers<br />
|-<br />
| FLEXZUSTELLUNGEMAILADRESSE || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse<br />
|-<br />
| FRACHTBRIEF || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll<br />
|-<br />
| FRACHTFUEHRERKDNR || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer<br />
|-<br />
| FRANKATURKENNUNG || [[#Datentypen|String]] || 10 || - || -<br />
|-<br />
| [[#Gefahrgut|GEFAHRGUT]] || [[#Datentypen|Sequence]] '''[[#Gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#Gefahrgut|Gefahrgüter]] vom Typ '''[[#Gefahrgut|Gefahrgut]]''' (1:n)<br />
|-<br />
| '''GEWICHT''' ||[[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG<br />
|-<br />
| HOSTTRACKINGNR || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem<br />
|-<br />
| ILNNR || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)<br />
|-<br />
| KOSTENSTELLE || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| KUNDENNR || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender<br />
|-<br />
| LAGERKENNZEICHEN || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| LETZTESPACKSTUECK || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)<br />
|-<br />
| LIEFERANTENID || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| '''LIEFERSCHEINNR''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet<br />
|-<br />
| NACHNAHME || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| NETTOGEWICHT || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG<br />
|-<br />
| NEUTBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTBANKBEZEICHNUNG || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTKONTOINHABER || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERNAME1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERNAME2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERNAME3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERORT || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NEUTABSENDERSTRASSE || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt<br />
|-<br />
| NNVERMERK || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck<br />
|-<br />
| NNVERWENDUNG || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck<br />
|-<br />
| NNWAEHRUNG || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode<br />
|-<br />
| '''PACKSTKGES''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung<br />
|-<br />
| '''PACKSTKNR''' || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung<br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.<br />
|-<br />
| PACKSTUECKBREITE || [[#Datentypen|Integer]] || - || - || Breite in cm<br />
|-<br />
| PACKSTUECKHOEHE || [[#Datentypen|Integer]] || - || - || Höhe in cm<br />
|-<br />
| PACKSTUECKID || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.<br />
|-<br />
| PACKSTUECKLAENGE || [[#Datentypen|Integer]] || - || - || Länge in cm<br />
|-<br />
| PAPERLESSINVOICE || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)<br />
|-<br />
| POSTLEITCODE || [[#Datentypen|String]] || 15 || - || -<br />
|-<br />
| POSTZIELFRACHTZENT || [[#Datentypen|String]] || 5 || - || -<br />
|-<br />
| RECHNUNGSEMPFLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSEMPFNAME1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| RECHNUNGSEMPFNAME2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| RECHNUNGSEMPFNAME3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| RECHNUNGSEMPFORT || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSEMPFPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSEMPFSTRASSE || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSNR || [[#Datentypen|String]] || 20 || - || Rechnungsnummer<br />
|-<br />
| SENDUNGSINHALT || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| SONDERDIENSTE || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt<br />
|-<br />
| SPERRFLAG || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren<br />
|-<br />
| TELEFONNR || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers<br />
|-<br />
| TERMINART || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix<br />
|-<br />
| TERMINDATUM || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| TERMINZEIT || [[#Datentypen|Calendar]] || 5 || - || HH:MM<br />
|-<br />
| USTIDNR || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers<br />
|-<br />
| VERPACKUNGSART || [[#Datentypen|String]] || 6 || - || -<br />
|-<br />
| '''VERSANDARTID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32<br />
|-<br />
| VERSICHERUNGSWERT || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert<br />
|-<br />
| VORPACKDATUM || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| VWWAEHRUNG || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode<br />
|-<br />
| WARENWERT || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird<br />
|-<br />
| WWWAEHRUNG || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode<br />
|-<br />
| ZAHLUNGSBEDINGUNG || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| ZBZOLL || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger<br />
|-<br />
| ZIELADRBAHNHOF || [[#Datentypen|String]] || 30 || - || PLZ und Ort<br />
|-<br />
| '''ZIELADRLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse<br />
|-<br />
| '''ZIELADRNAME1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| ZIELADRNAME2 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| ZIELADRNAME3 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| ZIELADRNAME4 || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''ZIELADRORT''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|-<br />
| '''ZIELADRPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse<br />
|-<br />
| ZIELADRREGION || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)<br />
|-<br />
| '''ZIELADRSTRASSE''' || [[#Datentypen|String]] || 50 || - || Lieferadresse<br />
|}<br />
<br />
<br><big>'''Rückgabe Parameter'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich<br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt<br />
|-<br />
| GEBUEHR || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten<br />
|-<br />
| GEBUEHRWAEHRUNG || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode<br />
|-<br />
| PACKSTUECKID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage<br />
|}<br />
<br />
= Packstückdaten aktualisieren (UpdateVersandDaten) =<br />
Die Gatewayfunktion UpdateVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort die Daten von bestehende Packstücken zu verändern.<br />
Diese Anfrage wird zum Beispiel gesendet, wenn der Warenwert für ein Packstück erst zu einem späteren Zeitpunkt bekannt ist.<br />
Aktualisiert werden können Daten innerhalb der Tabellen Versandeinheit, Abrechnungseinheit und Lieferung. Dabei wird stets über das Feld PackstueckID und bei Belegung auch über das Feld TrackingNr gesucht.<br />
<br><br><br />
'''Bei dieser Anfrage werden allerdings die zu aktualisierenden Felder und Inhalte nicht mehr nach den Richtlinien des Frachtführers geprüft (z.B. Gewichtsgrenzen, etc.). Es muss somit vom Vorsystem sichergestellt werden, dass die aktualisierenden Werte mit den Richtlinien des Frachtführers übereinstimmen. Sollte dies nicht möglich sein, kann diese Funktion nicht genutzt werden, sondern das Etikett muss storniert und neu verarbeitet werden. Außerdem können Felder, welche bereits auf einem Etikett angedruckt oder vom Versandsystem HVS32 in einer Frachtführerabwicklung ermittelt wurden (z.B. Adresse, Route, TrackingNr, Sonderdienste, etc.) nicht manipuliert werden.'''<br><br><br />
<br />
'''ACHTUNG: Alle Felder, welche im Versandsystem aktualisiert werden sollen, müssen vor der Nutzung dieser Funktion abgestimmt und im Versandsystem entsprechend konfiguriert werden!'''<br><br><br />
Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Update wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.<br />
<br><br><big>'''Übergabe Parameter'''</big><br><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| '''PACKSTUECKID''' || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um den Datensatz zu identifizieren.<br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.<br />
|-<br />
| ANSPRECHPARTNER || [[#Datentypen|String]] || 50 || - || Empfänger Ansprechpartner<br />
|-<br />
| AVISHINWEIS1 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| AVISHINWEIS2 || [[#Datentypen|String]] || 100 || - || -<br />
|-<br />
| AVISZUSATZ1 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 1<br />
|-<br />
| AVISZUSATZ2 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 2<br />
|-<br />
| BESTELLNR || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)<br />
|-<br />
| EMAIL || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)<br />
|-<br />
| EMPFMOBILFUNKNR || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers<br />
|-<br />
| FAXNR || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers<br />
|-<br />
| FLEXZUSTELLUNGEMAILADRESSE || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse<br />
|-<br />
| GEWICHT || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG<br />
|-<br />
| NETTOGEWICHT || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG<br />
|-<br />
| ILNNR || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)<br />
|-<br />
| KOSTENSTELLE || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| LIEFERANTENID || [[#Datentypen|Integer]] || - || - || -<br />
|-<br />
| NACHNAHME || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| NNVERMERK || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck<br />
|-<br />
| NNVERWENDUNG || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck<br />
|-<br />
| NNWAEHRUNG || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode<br />
|-<br />
| PACKSTUECKBREITE || [[#Datentypen|Integer]] || - || - || Breite in cm<br />
|-<br />
| PACKSTUECKHOEHE || [[#Datentypen|Integer]] || - || - || Höhe in cm<br />
|-<br />
| PACKSTUECKLAENGE || [[#Datentypen|Integer]] || - || - || Länge in cm<br />
|-<br />
| RECHNUNGSEMPFLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSEMPFNAME1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| RECHNUNGSEMPFNAME2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| RECHNUNGSEMPFNAME3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger<br />
|-<br />
| RECHNUNGSEMPFORT || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSEMPFPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSEMPFSTRASSE || [[#Datentypen|String]] || 50 || - || Rechnungsadresse<br />
|-<br />
| RECHNUNGSNR || [[#Datentypen|String]] || 20 || - || Rechnungsnummer<br />
|-<br />
| SENDUNGSINHALT || [[#Datentypen|String]] || 30 || - || -<br />
|-<br />
| TELEFONNR || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers<br />
|-<br />
| VORPACKDATUM || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ<br />
|-<br />
| VERSICHERUNGSWERT || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert<br />
|-<br />
| VWWAEHRUNG || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode<br />
|-<br />
| WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird<br />
|-<br />
| WARENWERT || [[#Datentypen|Decimal]] || 18 || 2 || -<br />
|-<br />
| WWWAEHRUNG || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode<br />
|}<br />
<br />
<br><big>'''Rückgabe Parameter'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich, 1 = Fehler<br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || -<br />
|}<br />
<br />
= Packstückdaten anonymisieren (AnonymisiereVersandDaten) =<br />
Das Gateway sendet die AnonymisiereVersandDaten an das Automatik-Polling des HVS32. Im HVS32 werden somit Kunden bezogene Daten für den entsprechenden Datensatz gemäß DSGVO anonymisiert.<br />
Diese Anonymisierung wird unwiderruflich und endgültig auf der Datenbankebene des Versandsystems durchgeführt. Eine Wiederherstellung der ursprünglichen Daten ist somit nicht mehr möglich.<br />
Log-Dateien, Rückmelde-Dateien, bereits übertragene Frachtführer DFÜs etc. sind hiervon nicht betroffen. Es können ausschließlich Packstücke und Sendungen anonymisiert werden, welche bereits Tages abgeschlossen sind.<br />
<br><br><big>'''Übergabe Parameter'''</big><br><br />
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| PACKSTUECKID || [[#Datentypen|String]] || 20 || - || PackstückID des Packstücks, welches anonymisiert werden soll.<br />
|-<br />
| TRACKINGNR || [[#Datentypen|String]] || 35 || - || TrackingNr des Packstücks, welches anonymisiert werden soll.<br />
|-<br />
| LIEFERSCHEINNR || [[#Datentypen|String]] || 40 || - || LieferscheinNr der Sendung, welche anonymisiert werden soll.<br />
|-<br />
| AUFTRAGSNR || [[#Datentypen|String]] || 50 || - || AuftragsNr der Sendung, welche anonymisiert werden soll.<br />
|-<br />
| PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der die Anonymisierung verarbeiten soll.<br />
|}<br />
<br><big>'''Rückgabe Parameter'''</big><br><br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich, 1 = Fehler<br />
|-<br />
| FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || -<br />
|-<br />
| FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || -<br />
|}</div>
Bhauser
https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_JDBC_Schnittstelle_(Automatik-Polling)&diff=5723
HVS32 JDBC Schnittstelle (Automatik-Polling)
2024-04-22T06:39:42Z
<p>Bhauser: /* Packstückdaten aktualisieren (UpdateVersandDaten) */</p>
<hr />
<div>[[en:HVS32 JDBC interface (automatic polling)]]<br />
Falls Sie bereits unsere ODBC-Schnittstelle im Einsatz haben, finden Sie die Beschreibung unter: [[HVS32_ODBC_Schnittstelle_(Automatik-Polling)|ODBC-Schnittstelle]]<br />
<!-- ------------------------------------------------------------------------------- Voraussetzungen ------------------------------------------------------------------------------- --><br />
= Voraussetzungen =<br />
{| class="wikitable"<br />
|-<br />
| DGS-Version || DGS-3_8_1_661 oder höher<br />
|-<br />
| DGS-Plugins || HVS32Client, JDBC Server<br />
|-<br />
| JDBC Treiber || neuste Version der JDBC Treiber für die eingesetzte Datenbank.<br />
Der JDBC-Treiber muss '''mindestens''' Java 11 und JDBC 4.2 unterstützen.<br />
|-<br />
|Datenbank<br />
|Unterstützt werden Datenbanken vom Hersteller Oracle, Microsoft SQL Server (MSSQL), mySQL, MariaDB, Firebird und IBM (DB2)<br />
Weitere Datenbanken auf Anfrage.<br />
'''Vom Hersteller abgekündigte Datenbankversionen werden grundsätzlich nicht unterstützt.'''<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE Voraussetzungen ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- Funktionsbeschreibung ------------------------------------------------------------------------------- --><br />
<br />
= Funktionsbeschreibung =<br />
Der DataGatewayServer (DGS) selektiert in einem konfigurierbaren Intervall (default 1000 ms) die zu verarbeitenden Datensätze aus der Polling Tabelle und übermittelt diese an den HVS32 Client zur Verarbeitung. Die Datensätze werden dabei anhand vom Steuerungsfeld '''[[#Steuerungs-Teil|HVS32Verarbeitet]]''' (Wert = 0) selektiert.<br><br />
Anhand vom Steuerungsfeld '''[[#Steuerungs-Teil|HVS32Funktion]]''' wird dem DGS mitgeteilt, welche Funktion für den selektierten Datensatz ausgeführt werden soll.<br><br />
<br />
Nachdem der Datensatz vom HVS32 bearbeitet wurde, erfolgt die Rückmeldung. Dabei wird der Wert '''[[#Steuerungs-Teil|HVS32Verarbeitet]]''' auf den Wert 1 gesetzt. Sollte im HVS32 ein Fehler bei der Verarbeitung aufgetreten sein, z.B. "Die Route konnte nicht ermittelt werden!", so wird zusätzlich das Feld '''[[#Steuerungs-Teil|HVS32Fehler]]''' mit dem Wert 1 und der Fehlertext in '''[[#Steuerungs-Teil|HVS32Fehlertext1]]''' + '''[[#Steuerungs-Teil|HVS32Fehlertext2]]''' zurück gemeldet.<br><br />
<br />
Für die Anfrage (Request) und Rückmeldung (Response) können weitere "Subrequests / -responses" konfiguriert werden. Diese SQLs werden zusätzlich ausgeführt und die Daten mit dem Hauptrequest / -response angereichert. Für jede Request / Response und Subrequest / - response kann die SQL individuell angepasst, sowie eine unterschiedliche Datenbankquelle konfiguriert werden.<br><br />
<br />
Zusätzlich gibt es die Möglichkeit einen Fall Back zu konfigurieren, welcher ausgeführt wird, sobald der Request oder Response fehlschlagen sollte. Zum Beispiel wenn in der Request Steuerzeichen oder in der Rückmeldung ein falscher Datentyp (alphanumerische anstelle von numerischen Werten) übermittelt wird. Des Weiteren kann der Fall Back genutzt werden, wenn keine HVS32 Clients am DGS verbunden sind. Damit soll verhindert werden, das fehlerhafte Datensätze immer wieder selektiert werden und somit erneut auf Fehler laufen.<br />
<!-- ------------------------------------------------------------------------------- ENDE Funktionsbeschreibung ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- Steuerungs-Teil ------------------------------------------------------------------------------- --><br />
== Steuerungs-Teil ==<br />
Anhand vom Steuerungs-Teil wird definiert, welche Aktion mit dem Datensatz aus der Datenbank durchgeführt werden soll.<br />
{| class="wikitable sortable"<br />
|-<br />
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung<br />
|-<br />
| '''ID''' || [[#Datentypen|Integer]] || - || - || Eindeutige Nummer zur Identifizierung des Datensatzes (Autocounter).<br />
|-<br />
| '''HVS32Funktion''' || [[#Datentypen|Integer]] || - || - || Die Funktionsnummer, die im HVS32 für den Datensatz ausgeführt werden soll.<br><br />
1 = [[#Packstück-Verarbeitung (VersandDatenAnfrage)|VersandDatenAnfrage]]<br><br />
2 = [[#Packstück verladen/freigeben (VerladeVersandDaten)|VerladeVersandDaten]]<br><br />
3 = [[#Packstückdaten aktualisieren (UpdateVersandDaten)|UpdateVersandDaten]]<br><br />
4 = [[#Packstück stornieren (StornoVersandDaten)|StornoVersandDaten]]<br><br />
5 = [[#Tagesabschluss (Tagesabschluss)|Tagesabschluss]]<br><br />
6 = [[#Packstückdaten prüfen (VersandDatenPruefAnfrage)|VersandDatenPruefAnfrage]]<br><br />
7 = [[#Packstückdaten anonymisieren (AnonymisiereVersandDaten)|AnonymisiereVersandDaten]]<br />
|-<br />
| '''HVS32Verarbeitet''' || [[#Datentypen|Integer]] || - || - || Wird nach der Verarbeitung im HVS32 auf 1 gesetzt. Datensätze werden anhand dieses Feldes selektiert.<br />
|-<br />
| HVS32Fehler || [[#Datentypen|Integer]] || - || - || Wenn der Datensatz im HVS32 verarbeitet worden ist und ein Fehler auftrat, wird dieser Wert auf 1 gesetzt.<br />
|-<br />
| HVS32Fehlertext1 || [[#Datentypen|String]] || 200 || - || Fehlertext im Fehlerfall<br />
|-<br />
| HVS32Fehlertext2 || [[#Datentypen|String]] || 200 || - || Fehlertext im Fehlerfall<br />
|}<br />
<!-- ------------------------------------------------------------------------------- ENDE Steuerungs-Teil ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- Verfügbare Funktionen ------------------------------------------------------------------------------- --><br />
<br />
= Verfügbare HVS32 Funktionen =<br />
<!-- ------------------------------------------------------------------------------- VersandDatenAnfrage ------------------------------------------------------------------------------- --><br />
=== Packstück-Verarbeitung (VersandDatenAnfrage) ===<br />
Die Gatewayfunktion VersandDatenAnfrage wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück zu erzeugen und verbuchen. Ein Etikett wird für alle weiteren Funktionen wie Storno, Verladefreigabe, etc. anhand der hostseitigen Packstück-ID identifiziert. Diese wird im Feld PackstueckID übergeben und muss dementsprechend innerhalb des Versandsystems eindeutig sein.<br />
<br><br><br />
Artikel- und Gefahrgutdaten sollten jeweils in einer eigenen Tabelle mit 1:n relation zur Packstücktabelle realisiert werden. Die Relation der Tabellen kann zum Beispiel über die ID aus dem [[#Steuerungs-Teil|Steuerungs-Teil]] erfolgen.<br />
<br><br><br />
'''[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck-Verarbeitung_.28VersandDatenAnfrage.29|Schnittstellen-Feld-Beschreibung]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE VersandDatenAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- VerladeDatenAnfrage ------------------------------------------------------------------------------- --><br />
=== Packstück verladen/freigeben (VerladeVersandDaten) ===<br />
Die Gatewayfunktion VerladeVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort Packstücke für den Ausgang frei zu geben. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt.<br />
<br><br><br />
'''[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck_verladen.2Ffreigeben_.28VerladeVersandDaten.29|Schnittstellen-Feld-Beschreibung]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE VerladeVersandDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- UpdateVersandDaten ------------------------------------------------------------------------------- --><br />
=== Packstückdaten aktualisieren (UpdateVersandDaten) ===<br />
Die Gatewayfunktion UpdateVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort die Daten von bestehende Packstücken zu verändern. Diese Anfrage wird zum Beispiel gesendet, wenn der Warenwert für ein Packstück erst zu einem späteren Zeitpunkt bekannt ist. Dabei wird stets über das Feld PackstueckID und bei Belegung auch über das Feld TrackingNr gesucht. <br><br><br />
'''Bei dieser Anfrage werden allerdings die zu aktualisierenden Felder und Inhalte nicht mehr nach den Richtlinien des Frachtführers geprüft (z.B. Gewichtsgrenzen, etc.). Es muss somit vom Vorsystem sichergestellt werden, dass die aktualisierenden Werte mit den Richtlinien des Frachtführers übereinstimmen. Sollte dies nicht möglich sein, kann diese Funktion nicht genutzt werden, sondern das Etikett muss storniert und neu verarbeitet werden. Außerdem können Felder, welche bereits auf einem Etikett angedruckt oder vom Versandsystem HVS32 in einer Frachtführerabwicklung ermittelt wurden (z.B. Adresse, Route, TrackingNr, Sonderdienste, etc.) nicht manipuliert werden.'''<br><br><br />
<br />
'''ACHTUNG: Alle Felder, welche im Versandsystem aktualisiert werden sollen, müssen vor der Nutzung dieser Funktion abgestimmt und im Versandsystem entsprechend konfiguriert werden!'''<br><br><br />
'''[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCckdaten_aktualisieren_.28UpdateVersandDaten.29|Schnittstellen-Feld-Beschreibung]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE UpdateVersandDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- StornoVersandDaten ------------------------------------------------------------------------------- --><br />
<br />
=== Packstück stornieren (StornoVersandDaten) ===<br />
Die Gatewayfunktion StornoVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort bestehende Packstücke zu stornieren, die noch nicht auf einer Ausgangsliste sind. In der Regel wird ein Packstück anhand der hostseitigen Packstück-ID storniert. Diese wird im Feld PackstueckID übergeben. Zusätzlich zur hostseitigen Packstück-ID kann auch die TrackingNr zur Identifikation des Packstücks beitragen, für den Fall, dass die hostseitige Packstück-ID keine Eindeutigkeit garantieren kann.<br />
<br><br><br />
'''[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck_stornieren_.28StornoVersandDaten.29|Schnittstellen-Feld-Beschreibung]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE StornoVersandDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- VersandDatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
=== Packstückdaten prüfen (VersandDatenPruefAnfrage) ===<br />
Das Gateway sendet die VersandDatenPruefAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine VersandDatenAnfrage simuliert. Dabei werden keine Etiketten gedruckt und das Packstück bzw. das Etikett wird nicht verbucht, jedoch sind alle weiteren Prozesse identisch zur VersandDatenAnfrage (Routenermittlung, Trackingnummer-Ermittlung, Adressprüfung, etc.) Diese Funktion dient dazu im Vorfeld alle Versand-Daten zu validieren.<br />
<br><br><br />
Artikel- und Gefahrgutdaten sollten jeweils in einer eigenen Tabelle mit 1:n relation zur Packstücktabelle realisiert werden. Die Relation der Tabellen kann zum Beispiel über die ID aus dem [[#Steuerungs-Teil|Steuerungs-Teil]] erfolgen.<br />
<br><br><br />
'''[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCckdaten_pr.C3.BCfen_.28VersandDatenPruefAnfrage.29|Schnittstellen-Feld-Beschreibung]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE VersandDatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- AnonymisiereVersandDaten ------------------------------------------------------------------------------- --><br />
=== Packstückdaten anonymisieren (AnonymisiereVersandDaten) ===<br />
Das Gateway sendet die AnonymisiereVersandDaten an das Automatik-Polling des HVS32. Im HVS32 werden somit Kunden bezogene Daten für den entsprechenden Datensatz gemäß DSGVO anonymisiert. Diese Anonymisierung wird unwiderruflich und endgültig auf der Datenbankebene des Versandsystems durchgeführt. Eine Wiederherstellung der ursprünglichen Daten ist somit nicht mehr möglich. Log-Dateien, Rückmelde-Dateien, bereits übertragene Frachtführer DFÜs etc. sind hiervon nicht betroffen. Es können ausschließlich Packstücke und Sendungen anonymisiert werden, welche bereits Tages abgeschlossen sind.<br />
<br><br><br />
'''[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCckdaten_anonymisieren_.28AnonymisiereVersandDaten.29|Schnittstellen-Feld-Beschreibung]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE AnonymisiereVersandDaten ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- Tagesabschluss ------------------------------------------------------------------------------- --><br />
=== Tagesabschluss (Tagesabschluss) ===<br />
Das Gateway sendet die Tagesabschluss-Anfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit ein Tagesabschluss anhand der zusätzlich übergebenen Parameter ausgelöst. Der Tagesabschluss setzt sich aus den Punkten [[HVS32_Automatik-Polling_Funktionen#Ausgangsliste_erzeugen_.28Listenabschluss.29|Ausgangsliste erzeugen]] und [[HVS32_Automatik-Polling_Funktionen#Frachtf.C3.BChrer_DF.C3.9C_erzeugen_.28EDIAbschluss.29|Frachtführer DFÜ erzeugen]] zusammen. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt. Standardmäßig sind alle Packstücke freigegeben, außer sie wurden durch das Erweiterungsmodul Ausgangsscannung gesperrt. Die Rückmeldung im HVS32 findet nach dem Ausführen des Tagesabschluss statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung.<br />
<br />
<br />
Im Vergleich zu den anderen Funktionalitäten bezieht sich ein Tagesabschluss nicht auf ein einzelnes Packstück. Somit darf ein bestehender Datensatz, welcher z.B. für einen Labeldruck verwendet worden ist, nicht in der HVS32Funktion (=5) aus dem [[HVS32 JDBC Schnittstelle (Automatik-Polling)#Steuerungs-Teil|Steuerungs-Teil]] angepasst werden. Der Tagesabschluss sollte als eigenständiger Datensatz in der Tabelle angelegt werden. Da sich die Übergabeparameter vom Tagesabschluss von den restlichen Funktionalitäten unterscheiden, ist es empfohlen eine separate Tabelle aufzusetzen, in welcher nur die für diese Anfrage benötigten Felder vorhanden sind.<br><br><br />
'''[[HVS32_Automatik-Polling_Funktionen#Tagesabschluss_.28Tagesabschluss.29|Schnittstellen-Feld-Beschreibung]]'''<br />
<!-- ------------------------------------------------------------------------------- ENDE Tagesabschluss ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ENDE Verfügbare Funktionen ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- Beispiele ------------------------------------------------------------------------------- --><br />
= Beispiele =<br />
Bitte beachten Sie, dass es sich bei den folgenden Scripten nur um eine Hilfestellung von unserer Seite handelt. Die Administration der Datenbank obliegt in der Verantwortung des Kunden.<br> Feldnamen /-längen /-formate oder auch Tabellennamen können prinzipiell abweichen, müssen in diesem Fall jedoch individuell betrachtet/analysiert werden.<br />
<br><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''MySQL'''</div><br />
<div class="mw-collapsible-content"><br />
<source><br />
CREATE TABLE polling_packstueck (<br />
-- Steuerungsteil<br />
ID bigint(20) unsigned NOT NULL auto_increment,<br />
HVS32Funktion int(10) unsigned NOT NULL default 1,<br />
HVS32Verarbeitet int(1) unsigned NOT NULL default 0,<br />
HVS32Fehler int(1) unsigned NOT NULL default 0,<br />
HVS32Fehlertext1 varchar(200) default NULL,<br />
HVS32Fehlertext2 varchar(200) default NULL,<br />
-- Sendungsteil<br />
KundenNr varchar(20) default NULL,<br />
ZielAdrName1 varchar(50) NOT NULL,<br />
ZielAdrName2 varchar(50) default NULL,<br />
ZielAdrName3 varchar(50) default NULL,<br />
ZielAdrStrasse varchar(50) NOT NULL,<br />
ZielAdrLKZ varchar(5) NOT NULL,<br />
ZielAdrPLZ varchar(10) NOT NULL,<br />
ZielAdrOrt varchar(50) NOT NULL,<br />
ZielAdrRegion varchar(20) default NULL,<br />
ZielAdrBahnhof varchar(30) default NULL,<br />
Ansprechpartner varchar(20) default NULL,<br />
TelefonNr varchar(20) default NULL,<br />
FaxNr varchar(20) default NULL,<br />
UstIDNr varchar(20) default NULL,<br />
ILNNr varchar(20) default NULL,<br />
AuftraggeberID varchar(10) NOT NULL,<br />
VersandartID varchar(10) NOT NULL,<br />
AVISHinweis1 varchar(100) default NULL,<br />
AVISHinweis2 varchar(100) default NULL,<br />
AVISZusatz1 varchar(60) default NULL,<br />
AVISZusatz2 varchar(60) default NULL,<br />
LieferscheinNr varchar(40) NOT NULL,<br />
AuftragNr varchar(20) default NULL,<br />
BestellNr varchar(20) default NULL,<br />
Warenwert decimal(18,2) default NULL,<br />
WWWaehrung varchar(3) default NULL,<br />
Nachnahme decimal(18,2) default NULL,<br />
NNWaehrung varchar(3) default NULL,<br />
NNVermerk varchar(1) default NULL,<br />
NNVerwendung varchar(30) default NULL,<br />
Versicherungswert decimal(18,2) default NULL,<br />
VWWaehrung varchar(3) default NULL,<br />
FrankaturKennung varchar(10) default NULL,<br />
Zahlungsbedinung varchar(10) default NULL,<br />
ZBZoll varchar(1) default NULL,<br />
FrachtfuehrerKDNr varchar(10) default NULL,<br />
Sonderdienste varchar(30) default NULL,<br />
SendungsInhalt varchar(30) default NULL,<br />
TerminArt varchar(1) default NULL,<br />
TerminDatum varchar(10) default NULL,<br />
TerminZeit varchar(5) default NULL,<br />
NeutabsenderName1 varchar(30) default NULL,<br />
NeutabsenderName2 varchar(30) default NULL,<br />
NeutabsenderName3 varchar(30) default NULL,<br />
NeutabsenderStrasse varchar(30) default NULL,<br />
NeutabsenderLKZ varchar(3) default NULL,<br />
NeutabsenderPLZ varchar(10) default NULL,<br />
NeutabsenderOrt varchar(30) default NULL,<br />
RechnungsEmpfName1 varchar(50) default NULL,<br />
RechnungsEmpfName2 varchar(50) default NULL,<br />
RechnungsEmpfName3 varchar(50) default NULL,<br />
RechnungsEmpfStr varchar(50) default NULL,<br />
RechnungsEmpfLKZ varchar(5) default NULL,<br />
RechnungsEmpfPLZ varchar(10) default NULL,<br />
RechnungsEmpfOrt varchar(50) default NULL,<br />
PostLeitcode varchar(15) default NULL,<br />
PostZielFrachtzent varchar(5) default NULL,<br />
FrachtBrief varchar(20) default NULL,<br />
-- Packstueckteil<br />
Gewicht decimal(8,3) default NULL,<br />
NettoGewicht decimal(8,3) default NULL,<br />
PackStkGes int(10) unsigned default NULL,<br />
PackStkNr int(10) unsigned default NULL,<br />
Verpackungsart varchar(6) default NULL,<br />
PackstueckLaenge int(10) unsigned default NULL,<br />
PackstueckBreite int(10) unsigned default NULL,<br />
PackstueckHoehe int(10) unsigned default NULL,<br />
Packplatz varchar(10) default NULL,<br />
PackstueckID varchar(15) NOT NULL,<br />
-- Rückmeldung<br />
TrackingNr varchar(35) default NULL,<br />
VersandSendungsNr varchar(20) default NULL,<br />
DruckDateTime varchar(20) default NULL,<br />
AusgangDateTime varchar(10) default NULL,<br />
Gebuehr decimal(8,3) default NULL, <br />
GebuehrWaehrung varchar(3) default NULL,<br />
-- Primärschlüssel<br />
PRIMARY KEY (ID)<br />
) ENGINE=InnoDB DEFAULT CHARSET=latin1;<br />
</source><br />
<br />
<source><br />
CREATE TABLE polling_packstueck_dailyclosing (<br />
-- Steuerungsteil<br />
ID bigint(20) unsigned NOT NULL auto_increment,<br />
HVS32Funktion int(10) unsigned NOT NULL default 1,<br />
HVS32Verarbeitet int(1) unsigned NOT NULL default 0,<br />
HVS32Fehler int(1) unsigned NOT NULL default 0,<br />
HVS32Fehlertext1 varchar(200) default NULL,<br />
HVS32Fehlertext2 varchar(200) default NULL,<br />
-- Tagesabschluss Parameter<br />
Packplatz varchar(10) default NULL,<br />
FrachtfuehrerTypList varchar(250) default NULL,<br />
AuftraggeberIDList varchar(250) default NULL, <br />
VersandartIDList varchar(250) default NULL,<br />
Wechselbruecke varchar(20) default NULL,<br />
Druckername varchar(30) default NULL,<br />
-- Primärschlüssel<br />
PRIMARY KEY (ID)<br />
) ENGINE=InnoDB DEFAULT CHARSET=latin1;<br />
</source></div></div><br />
<br><br />
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"><br />
<div style="font-weight:bold;line-height:1.6;">'''MSSQL'''</div><br />
<div class="mw-collapsible-content"><br />
<source><br />
CREATE TABLE polling_packstueck (<br />
-- Steuerungsteil<br />
ID bigINT IDENTITY(1,1) NOT NULL,<br />
HVS32Funktion INT NOT NULL default 1,<br />
HVS32Verarbeitet INT NOT NULL default 0,<br />
HVS32Fehler INT NOT NULL default 0,<br />
HVS32Fehlertext1 VARCHAR(200) default NULL,<br />
HVS32Fehlertext2 VARCHAR(200) default NULL,<br />
-- Sendungsteil<br />
KundenNr VARCHAR(20) default NULL,<br />
ZielAdrName1 VARCHAR(50) NOT NULL,<br />
ZielAdrName2 VARCHAR(50) default NULL,<br />
ZielAdrName3 VARCHAR(50) default NULL,<br />
ZielAdrStrasse VARCHAR(50) NOT NULL,<br />
ZielAdrLKZ VARCHAR(5) NOT NULL,<br />
ZielAdrPLZ VARCHAR(10) NOT NULL,<br />
ZielAdrOrt VARCHAR(50) NOT NULL,<br />
ZielAdrRegion VARCHAR(20) default NULL,<br />
ZielAdrBahnhof VARCHAR(30) default NULL,<br />
Ansprechpartner VARCHAR(20) default NULL,<br />
TelefonNr VARCHAR(20) default NULL,<br />
FaxNr VARCHAR(20) default NULL,<br />
UstIDNr VARCHAR(20) default NULL,<br />
ILNNr VARCHAR(20) default NULL,<br />
AuftraggeberID VARCHAR(10) NOT NULL,<br />
VersandartID VARCHAR(10) NOT NULL,<br />
AVISHinweis1 VARCHAR(100) default NULL,<br />
AVISHinweis2 VARCHAR(100) default NULL,<br />
AVISZusatz1 VARCHAR(60) default NULL,<br />
AVISZusatz2 VARCHAR(60) default NULL,<br />
LieferscheinNr VARCHAR(40) NOT NULL,<br />
AuftragNr VARCHAR(20) default NULL,<br />
BestellNr VARCHAR(20) default NULL,<br />
Warenwert NUMERIC(18,2) default NULL,<br />
WWWaehrung VARCHAR(3) default NULL,<br />
Nachnahme NUMERIC(18,2) default NULL,<br />
NNWaehrung VARCHAR(3) default NULL,<br />
NNVermerk VARCHAR(1) default NULL,<br />
NNVerwendung VARCHAR(30) default NULL,<br />
Versicherungswert NUMERIC(18,2) default NULL,<br />
VWWaehrung VARCHAR(3) default NULL,<br />
FrankaturKennung VARCHAR(10) default NULL,<br />
Zahlungsbedinung VARCHAR(10) default NULL,<br />
ZBZoll VARCHAR(1) default NULL,<br />
FrachtfuehrerKDNr VARCHAR(10) default NULL,<br />
Sonderdienste VARCHAR(30) default NULL,<br />
SendungsInhalt VARCHAR(30) default NULL,<br />
TerminArt VARCHAR(1) default NULL,<br />
TerminDatum VARCHAR(10) default NULL,<br />
TerminZeit VARCHAR(5) default NULL,<br />
NeutabsenderName1 VARCHAR(30) default NULL,<br />
NeutabsenderName2 VARCHAR(30) default NULL,<br />
NeutabsenderName3 VARCHAR(30) default NULL,<br />
NeutabsenderStrasse VARCHAR(30) default NULL,<br />
NeutabsenderLKZ VARCHAR(3) default NULL,<br />
NeutabsenderPLZ VARCHAR(10) default NULL,<br />
NeutabsenderOrt VARCHAR(30) default NULL,<br />
RechnungsEmpfName1 VARCHAR(50) default NULL,<br />
RechnungsEmpfName2 VARCHAR(50) default NULL,<br />
RechnungsEmpfName3 VARCHAR(50) default NULL,<br />
RechnungsEmpfStr VARCHAR(50) default NULL,<br />
RechnungsEmpfLKZ VARCHAR(5) default NULL,<br />
RechnungsEmpfPLZ VARCHAR(10) default NULL,<br />
RechnungsEmpfOrt VARCHAR(50) default NULL,<br />
PostLeitcode VARCHAR(15) default NULL,<br />
PostZielFrachtzent VARCHAR(5) default NULL,<br />
FrachtBrief VARCHAR(20) default NULL,<br />
-- Packstueckteil<br />
Gewicht NUMERIC(8,3) default NULL,<br />
NettoGewicht NUMERIC(8,3) default NULL,<br />
PackStkGes INT default NULL,<br />
PackStkNr INT default NULL,<br />
Verpackungsart VARCHAR(6) default NULL,<br />
PackstueckLaenge INT default NULL,<br />
PackstueckBreite INT default NULL,<br />
PackstueckHoehe INT default NULL,<br />
Packplatz VARCHAR(10) default NULL,<br />
PackstueckID VARCHAR(15) NOT NULL,<br />
-- Rückmeldung<br />
TrackingNr VARCHAR(35) default NULL,<br />
VersandSendungsNr VARCHAR(20) default NULL,<br />
DruckDateTime VARCHAR(20) default NULL,<br />
AusgangDateTime VARCHAR(10) default NULL,<br />
Gebuehr NUMERIC(8,3) default NULL, <br />
GebuehrWaehrung VARCHAR(3) default NULL,<br />
AusgangslisteNr INT default NULL<br />
)<br />
</source><br />
<br />
<source><br />
CREATE TABLE polling_packstueck_dailyclosing (<br />
-- Steuerungsteil<br />
ID bigINT IDENTITY(1,1) NOT NULL,<br />
HVS32Funktion INT NOT NULL default 5,<br />
HVS32Verarbeitet INT NOT NULL default 0,<br />
HVS32Fehler INT NOT NULL default 0,<br />
HVS32Fehlertext1 VARCHAR(200) default NULL,<br />
HVS32Fehlertext2 VARCHAR(200) default NULL,<br />
-- Tagesabschluss Parameter<br />
Packplatz VARCHAR(10) default NULL,<br />
FrachtfuehrerTypList VARCHAR(250) default NULL,<br />
AuftraggeberIDList VARCHAR(250) default NULL, <br />
VersandartIDList VARCHAR(250) default NULL,<br />
Wechselbruecke VARCHAR(20) default NULL,<br />
Druckername VARCHAR(30) default NULL<br />
)<br />
</source></div></div><br />
<br><br />
<!-- ------------------------------------------------------------------------------- ENDE Beispiele ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- FAQ / Troubleshooting ------------------------------------------------------------------------------- --><br />
<br />
= FAQ / Troubleshooting =<br />
<!-- ------------------------------------------------------------------------------- ENDE FAQ / Troubleshooting ------------------------------------------------------------------------------- --></div>
Bhauser