https://wiki.heidler-strichcode.de/w/api.php?action=feedcontributions&feedformat=atom&user=DdangWiki - Heidler Strichcode GmbH - Benutzerbeiträge [de]2026-09-21T12:48:13ZBenutzerbeiträgeMediaWiki 1.35.2https://wiki.heidler-strichcode.de/w/index.php?title=Script_(Tarifwerk)_(en)&diff=6016Script (Tarifwerk) (en)2024-10-18T14:44:28Z<p>Ddang: </p>
<hr />
<div>[[de:Script (Tarifwerk)]]<br />
<br />
[[File:Script_Zuschlag(en).png|frameless|right|super|475x413px|TW Script Editor.png]]Scripts are the central point in the Tarifwerk for creating rules for surcharges and rate structures. These can be simple queries, such as checking whether it is an island delivery, or complex constructs that implement carrier or customer-specific requirements.<br />
All scripts use the Pegasus parser, a proprietary development of Heidler Strichcode GmbH. The scripting language is based on the Java programming language, which can make some things more complicated, but offers significantly more flexibility and performance.<br />
<br />
== Scripteditor ==<br />
<br />
The script editor is divided into three areas:<br />
<br />
=== Information panel ===<br />
<br />
The information panel is located at the top left. It shows you all the information you need for script development.<br />
<br />
First of all, it lists which variables you have available and which type (which class) the variables have. In the Tarifwerk, you will usually see the variable shipment, which corresponds to the current shipment, and possibly the variable packageData, which corresponds to the current package.<br />
<br />
The Expected return type is the type of value that you must return in this script. As a rule, only Boolean (true or false) or Double (floating point number with double precision) is expected in the Tarifwerk.<br />
<br />
=== Button bar ===<br />
<br />
The button bar is located at the top right. You can use it to make additional adjustments and tests.<br />
<br />
==== Imports ====<br />
<br />
The Imports button opens an editor in which you can add additional classes (functionalities) to the current script. You can use the Search button to search for the currently entered class. If successful, this class will be displayed in the list above.<br />
<br />
The following classes and interfaces are imported by default and do not need to be specified:<br />
<br />
*java.util.Date <br />
*java.text.SimpleDateFormat <br />
*java.util.ArrayList <br />
*java.util.List <br />
*java.util.Map <br />
*java.util.HashMap <br />
<br />
==== Variables ====<br />
<br />
The variable editor allows you to set up various test scenarios by changing the values of the given variables as required. For more complex variable types (such as shipment or package), the variable is displayed and edited in JSON format. The usual rules for escape characters apply.<br />
<br />
==== Test ====<br />
<br />
You can test your current script using the Test button. If there is a syntax error, this is displayed along with the line. In addition, you can view the complete class created in the folder Tarifwerk\compile\scriptbase as long as the results window is open.<br />
<br />
=== Editor ===<br />
<br />
You can implement your script in the editor. The editor has several features to make creating scripts easier:<br />
<br />
*If a script is single-line and does not end with a semicolon, you do not need a return statement. This is added automatically. <br />
*The script editor has code highlighting to separate variables, comments and classes from each other <br />
*The script editor has limited code completion features. These are activated via the key combination Ctrl+Space <br />
<br />
== Additional functions ==<br />
<br />
The script editor comes with some additional functions as standard. Many of these functions correspond to the parser expressions from the HVS32.<br />
<br />
The detailed description and use can be found in the code completion (Ctrl+Space). Frequently used and useful functions are<br />
<br />
*ATrim: Removes all spaces at the beginning and end of the string. <br />
*Left: Returns the first n digits of a string. <br />
*Right: Returns the last n digits of a string. <br />
*DEBUG: Displays the value of a variable in a message box. (Please never save a script that contains these functions) <br />
*DateTimeFormat: Converts a string into a date. <br />
*FormatDateTime: Converts a date into a string. <br />
*GetListItem: Extracts the nth element from a string that was separated by a separator. <br />
*LeftPad: Fills a string on the left with the specified number of digits and characters<br />
<br />
&nbsp;<br />
<br />
== Special features ==<br />
<br />
Since the Pegasus parser is based on Java, there are a few things to consider that are not common in other scripting languages (such as Javascript).<br />
<br />
=== String comparisons ===<br />
<br />
Numbers are compared as usual using a double ==:<br />
<pre>int a = 5;<br />
if (a == 5) {<br />
....</pre><br />
<br />
Unfortunately, strings cannot be compared using this method. Instead, you have to use the equals() method:<br />
<pre>String a = “test”;<br />
if (a.equals(“test”)) {<br />
...</pre><br />
<br />
Case-insensitive comparisons are made using the&nbsp;equalsIgnoreCase() method.<br />
<br />
=== Elements of variables ===<br />
<br />
Elements of variables (such as the destination address zip code of the shipment) are read and set using getter and setter methods.<br />
<br />
These always have the prefix “get” or “set” and the next character is written as an uppercase letter. For Booleans, “is” is used instead of “get”. Examples:<br />
<pre>shipment.getReceiverZipcode()<br />
shipment.getShipmentWeight()<br />
shipment.isIsle()<br />
packageData.getPackageType()</pre><br />
<br />
=== Direct definition of non-int numbers. ===<br />
<br />
If you want to define a double, float or long directly in the source code, they require a corresponding suffix after the number:<br />
<pre>double d = 4.3d;<br />
float f = 5.4f;<br />
long l = 200000l;</pre><br />
<br />
== Example scripts ==<br />
<br />
=== Check for island delivery ===<br />
<pre>shipment.isIsle()</pre><br />
<br />
The corresponding island table for the respective carrier is required.<br />
<br />
=== Check for specific countries ===<br />
<pre>final List<String> zielLaender = java.util.Arrays.asList(“DE”, “CH”, “AT”);<br />
return zielLaender.contains(shipment.getReceiverCountry());</pre><br />
<br />
The elements DE, CH, AT must be replaced by the desired countries in ISO2 format.<br />
<br />
=== Check for specific shipping type ===<br />
<pre>shipment.getServiceType().equals(“VID”)</pre><br />
<br />
The dispatch type ID “VID” must be replaced by the desired shipping type. If several dispatch types are possible, you can also create a list here as in the example above.<br />
<br />
=== Cash on delivery shipment ===<br />
<pre>shipment.getCodAmount() > 0d</pre><br />
<br />
=== Check packaging type ===<br />
<pre>packageData.getPackageType().equals(“KT”)</pre><br />
<br />
The packaging type should usually only be defined with package rate structures and surcharges.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Script_(Tarifwerk)_(en)&diff=6015Script (Tarifwerk) (en)2024-10-18T14:41:34Z<p>Ddang: </p>
<hr />
<div>[[de:Script (Tarifwerk)]]<br />
<br />
[[File:Script_Zuschlag(en).png|frameless|right|super|475x413px|TW Script Editor.png]]Scripts are the central point in the Tarifwerk for creating rules for surcharges and rate structures. These can be simple queries, such as checking whether it is an island delivery, or complex constructs that implement carrier or customer-specific requirements.<br />
All scripts use the Pegasus parser, a proprietary development of Heidler Strichcode GmbH. The scripting language is based on the Java programming language, which can make some things more complicated, but offers significantly more flexibility and performance.<br />
<br />
== Scripteditor ==<br />
<br />
The script editor is divided into three areas:<br />
<br />
=== Information panel ===<br />
<br />
The information panel is located at the top left. It shows you all the information you need for script development.<br />
<br />
First of all, it lists which variables you have available and which type (which class) the variables have. In the Tarifwerk, you will usually see the variable shipment, which corresponds to the current shipment, and possibly the variable packageData, which corresponds to the current package.<br />
<br />
The Expected return type is the type of value that you must return in this script. As a rule, only Boolean (true or false) or Double (floating point number with double precision) is expected in the Tarifwerk.<br />
<br />
=== Button bar ===<br />
<br />
The button bar is located at the top right. You can use it to make additional adjustments and tests.<br />
<br />
==== Imports ====<br />
<br />
The Imports button opens an editor in which you can add additional classes (functionalities) to the current script. You can use the Search button to search for the currently entered class. If successful, this class will be displayed in the list above.<br />
<br />
The following classes and interfaces are imported by default and do not need to be specified:<br />
<br />
*java.util.Date <br />
*java.text.SimpleDateFormat <br />
*java.util.ArrayList <br />
*java.util.List <br />
*java.util.Map <br />
*java.util.HashMap <br />
<br />
==== Variables ====<br />
<br />
The variable editor allows you to set up various test scenarios by changing the values of the given variables as required. For more complex variable types (such as shipment or package), the variable is displayed and edited in JSON format. The usual rules for escape characters apply.<br />
<br />
==== Test ====<br />
<br />
You can test your current script using the Test button. If there is a syntax error, this is displayed along with the line. In addition, you can view the complete class created in the folder Tarifwerk\compile\scriptbase as long as the results window is open.<br />
<br />
=== Editor ===<br />
<br />
You can implement your script in the editor. The editor has several features to make creating scripts easier:<br />
<br />
*If a script is single-line and does not end with a semicolon, you do not need a return statement. This is added automatically. <br />
*The script editor has code highlighting to separate variables, comments and classes from each other <br />
*The script editor has limited code completion features. These are activated via the key combination Ctrl+Space <br />
<br />
== Additional functions ==<br />
<br />
The script editor comes with some additional functions as standard. Many of these functions correspond to the parser expressions from the HVS32.<br />
<br />
The detailed description and use can be found in the code completion (Ctrl+Space). Frequently used and useful functions are<br />
<br />
*ATrim: Removes all spaces at the beginning and end of the string. <br />
*Left: Returns the first n digits of a string. <br />
*Right: Returns the last n digits of a string. <br />
*DEBUG: Displays the value of a variable in a message box. (Please never save a script that contains these functions) <br />
*DateTimeFormat: Converts a string into a date. <br />
*FormatDateTime: Converts a date into a string. <br />
*GetListItem: Extracts the nth element from a string that was separated by a separator. <br />
*LeftPad: Fills a string on the left with the specified number of digits and characters<br />
<br />
&nbsp;<br />
<br />
== Special features ==<br />
<br />
Since the Pegasus parser is based on Java, there are a few things to consider that are not common in other scripting languages (such as Javascript).<br />
<br />
=== String comparisons ===<br />
<br />
Numbers are compared as usual using a double ==:<br />
<pre>int a = 5;<br />
if (a == 5) {<br />
....</pre><br />
<br />
Unfortunately, strings cannot be compared using this method. Instead, you have to use the equals() method:<br />
<pre>String a = “test”;<br />
if (a.equals(“test”)) {<br />
...</pre><br />
<br />
Case-insensitive comparisons are made using the&nbsp;equalsIgnoreCase() method.<br />
<br />
=== Elements of variables ===<br />
<br />
Elements of variables (such as the destination address zip code of the shipment) are read and set using getter and setter methods.<br />
<br />
These always have the prefix “get” or “set” and the next character is written as an uppercase letter. For Booleans, “is” is used instead of “get”. Examples:<br />
<pre>shipment.getReceiverZipcode()<br />
shipment.getShipmentWeight()<br />
shipment.isIsle()<br />
packageData.getPackageType()</pre><br />
<br />
=== Direct definition of non-int numbers. ===<br />
<br />
If you want to define a double, float or long directly in the source code, they require a corresponding suffix after the number:<br />
<pre>double d = 4.3d;<br />
float f = 5.4f;<br />
long l = 200000l;</pre><br />
<br />
== Example scripts ==<br />
<br />
=== Check for island delivery ===<br />
<pre>shipment.isIsle()</pre><br />
<br />
The corresponding island table for the respective carrier is required.<br />
<br />
=== Check for specific countries ===<br />
<pre>final List<String> zielLaender = java.util.Arrays.asList(“DE”, “CH”, “AT”);<br />
return zielLaender.contains(shipment.getReceiverCountry());</pre><br />
<br />
The elements DE, CH, AT must be replaced by the desired countries in ISO2 format.<br />
<br />
=== Check for specific shipping type ===<br />
<pre>shipment.getServiceType().equals(“VID”)</pre><br />
<br />
The shipping type ID “VID” must be replaced by the desired shipping type. If several shipping types are possible, you can also create a list here as in the example above.<br />
<br />
=== Cash on delivery shipment ===<br />
<pre>shipment.getCodAmount() > 0d</pre><br />
<br />
=== Check packaging type ===<br />
<pre>packageData.getPackageType().equals(“KT”)</pre><br />
<br />
The packaging type should usually only be defined with package tariff units and surcharges.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Script_(Tarifwerk)_(en)&diff=6014Script (Tarifwerk) (en)2024-10-18T14:34:41Z<p>Ddang: </p>
<hr />
<div>[[de:Script (Tarifwerk)]]<br />
<br />
[[File:Script_Zuschlag(en).png|frameless|right|super|475x413px|TW Script Editor.png]]Scripts are the central point in the rate structure for creating rules for surcharges and rate structures. These can be simple queries, such as checking whether it is an island delivery, or complex constructs that implement carrier or customer-specific requirements.<br />
All scripts use the Pegasus parser, a proprietary development of Heidler Strichcode GmbH. The scripting language is based on the Java programming language, which can make some things more complicated, but offers significantly more flexibility and performance.<br />
<br />
== Scripteditor ==<br />
<br />
The script editor is divided into three areas:<br />
<br />
=== Information panel ===<br />
<br />
The information panel is located at the top left. It shows you all the information you need for script development.<br />
<br />
First of all, it lists which variables you have available and which type (which class) the variables have. In the tariff structure, you will usually see the variable shipment, which corresponds to the current shipment, and possibly the variable packageData, which corresponds to the current package.<br />
<br />
The Expected return type is the type of value that you must return in this script. As a rule, only Boolean (true or false) or Double (floating point number with double precision) is expected in the tariff plant.<br />
<br />
=== Button bar ===<br />
<br />
The button bar is located at the top right. You can use it to make additional adjustments and tests.<br />
<br />
==== Imports ====<br />
<br />
The Imports button opens an editor in which you can add additional classes (functionalities) to the current script. You can use the Search button to search for the currently entered class. If successful, this class will be displayed in the list above.<br />
<br />
The following classes and interfaces are imported by default and do not need to be specified:<br />
<br />
*java.util.Date <br />
*java.text.SimpleDateFormat <br />
*java.util.ArrayList <br />
*java.util.List <br />
*java.util.Map <br />
*java.util.HashMap <br />
<br />
==== Variables ====<br />
<br />
The variable editor allows you to set up various test scenarios by changing the values of the given variables as required. For more complex variable types (such as shipment or package), the variable is displayed and edited in JSON format. The usual rules for escape characters apply.<br />
<br />
==== Test ====<br />
<br />
You can test your current script using the Test button. If there is a syntax error, this is displayed along with the line. In addition, you can view the complete class created in the folder Tarifwerk\compile\scriptbase as long as the results window is open.<br />
<br />
=== Editor ===<br />
<br />
You can implement your script in the editor. The editor has several features to make creating scripts easier:<br />
<br />
*If a script is single-line and does not end with a semicolon, you do not need a return statement. This is added automatically. <br />
*The script editor has code highlighting to separate variables, comments and classes from each other <br />
*The script editor has limited code completion features. These are activated via the key combination Ctrl+Space <br />
<br />
== Additional functions ==<br />
<br />
The script editor comes with some additional functions as standard. Many of these functions correspond to the parser expressions from the HVS32.<br />
<br />
The detailed description and use can be found in the code completion (Ctrl+Space). Frequently used and useful functions are<br />
<br />
*ATrim: Removes all spaces at the beginning and end of the string. <br />
*Left: Returns the first n digits of a string. <br />
*Right: Returns the last n digits of a string. <br />
*DEBUG: Displays the value of a variable in a message box. (Please never save a script that contains these functions) <br />
*DateTimeFormat: Converts a string into a date. <br />
*FormatDateTime: Converts a date into a string. <br />
*GetListItem: Extracts the nth element from a string that was separated by a separator. <br />
*LeftPad: Fills a string on the left with the specified number of digits and characters<br />
<br />
&nbsp;<br />
<br />
== Besonderheiten ==<br />
<br />
Da der Pegasus Parser auf Java basiert, muss man einige Dinge beachten, die in anderen Scriptsprachen (wie z.B. Javascript) nicht üblich sind.<br />
<br />
=== Stringvergleiche ===<br />
<br />
Zahlen werden wie üblich über ein doppeltes == verglichen:<br />
<pre>int a = 5;<br />
if (a == 5) {<br />
....</pre><br />
<br />
Strings können damit leider nicht verglichen werden. Stattdessen muss man die Methode equals() verwenden:<br />
<pre>String a = "test";<br />
if (a.equals("test")) {<br />
...</pre><br />
<br />
Vergleiche ohne Beachtung von Groß- und Kleinschreibung geschehen über die Methode&nbsp;equalsIgnoreCase().<br />
<br />
=== Elemente von Variablen ===<br />
<br />
Elemente von Variablen (wie z.B. die Zieladress-PLZ der Sendung) werden über Getter- und Setter-Methoden gelesen und gesetzt.<br />
<br />
Diese besitzen immer den Prefix "get" bzw. "set" und das nächste Zeichen wird als Großbuchstabe geschrieben. Bei Boolean wird "is" statt "get"&nbsp;verwendet. Beispiele:<br />
<pre>shipment.getReceiverZipcode()<br />
shipment.getShipmentWeight()<br />
shipment.isIsle()<br />
packageData.getPackageType()</pre><br />
<br />
=== Direktes definieren von Nicht-int Zahlen. ===<br />
<br />
Wenn Sie einen double, float oder long direkt im Quelltext definieren wollen, benötigen diese nach der Zahl einen entsprechenden&nbsp;Suffix:<br />
<pre>double d = 4.3d;<br />
float f = 5.4f;<br />
long l = 200000l;</pre><br />
<br />
== Beispielscripte ==<br />
<br />
=== Prüfen auf Inselzustellung ===<br />
<pre>shipment.isIsle()</pre><br />
<br />
Es wird die entsprechende Inseltabelle für den jeweiligen Frachtführer benötigt.<br />
<br />
=== Auf bestimmte Länder prüfen ===<br />
<pre>final List<String> zielLaender = java.util.Arrays.asList("DE", "CH", "AT");<br />
return zielLaender.contains(shipment.getReceiverCountry());</pre><br />
<br />
Die Elemente DE, CH, AT müssen durch die gewünschten Länder im ISO2 Format ersetzt werden.<br />
<br />
=== Auf bestimmte Versandart prüfen ===<br />
<pre>shipment.getServiceType().equals("VID")</pre><br />
<br />
Die Versandart ID "VID" muss durch die Gewünschte ersetzt werden. Falls mehrere Versandarten in Frage kommen, kann man auch hier eine Liste wie im Beispiel darüber erstellen.<br />
<br />
=== Nachnahme-Sendung ===<br />
<pre>shipment.getCodAmount() > 0d</pre><br />
<br />
=== Verpackungsart prüfen ===<br />
<pre>packageData.getPackageType().equals("KT")</pre><br />
<br />
Die Verpackungsart sollte meist auch nur mit Packstück-Tarifwerken und -Zuschlägen definiert werden.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Script_(Tarifwerk)&diff=6013Script (Tarifwerk)2024-10-18T14:34:26Z<p>Ddang: </p>
<hr />
<div>[[en:Script (Tarifwerk) (en)]]<br />
<br />
[[File:TW Script Editor.png|frameless|right|super|475x413px|TW Script Editor.png]]Scripte bilden die zentrale Stelle im Tarifwerk um Regeln für [[Zuschlag_(Tarifwerk)|Zuschläge]] und [[Tarifwerk_(Tarifwerk_/_Stammdaten)|Tarifwerke]] aufzubauen. Dies&nbsp;können simple Abfragen sein, wie z.B. prüfen, ob es sich um eine Inselzustellung handelt, oder aber komplexe Konstrukte, die Frachtführer- oder Kundenspezifische Anforderungen umsetzen.<br />
<br />
Alle Scripte verwenden den Pegasus Parser, eine Eigenentwicklung der Heidler Strichcode GmbH. Die Scriptsprache basiert&nbsp;auf der Programmiersprache Java, was manche Dinge komplizierter machen kann, dafür aber deutlich mehr Flexibilität und Performance bietet.<br />
<br />
== Scripteditor ==<br />
<br />
Der Scripteditor ist in drei Bereiche unterteilt:<br />
<br />
=== Informationspanel ===<br />
<br />
Das Informationspanel befindet sich links oben. Es zeigt Ihnen alle Informationen an, welche Sie für die Scriptentwicklung benötigen.<br />
<br />
Zunächst wird Ihnen aufgelistet, welche Variablen Sie zur Verfügung haben und welchen Typ (welche Klasse) die Variablen besitzen. Im Tarifwerk erhalten Sie hier meist die Variable shipment, was der aktuellen Sendung entspricht, und eventuell die Variable packageData, was dem aktuellen Packstück entspricht.<br />
<br />
Der Erwartete Rückgabetyp ist der Typ des Wertes, welchen Sie in diesem Script zurückgeben müssen. Im Tarifwerk wird in der Regel nur Boolean (true oder false) oder Double (Gleitkommazahl mit doppelter Präzision) erwartet.<br />
<br />
=== Button-Leiste ===<br />
<br />
Die Button-Leiste befindet sich rechts oben. Sie können damit zusätzliche Anpassungen und Tests vornehmen.<br />
<br />
==== Importe ====<br />
<br />
Der Button Importe öffnet einen Editor, in dem Sie zusätzliche Klassen (Funktionalitäten) zum aktuellen Script hinzufügen können. Über den Button Suchen können Sie die aktuell eingegebene Klasse suchen. Bei Erfolg wird Ihnen diese Klasse in der Liste darüber angezeigt.<br />
<br />
Folgende Klassen und Interfaces sind standardmäßig Importiert und müssen nicht angegeben werden:<br />
<br />
*java.util.Date <br />
*java.text.SimpleDateFormat <br />
*java.util.ArrayList <br />
*java.util.List <br />
*java.util.Map <br />
*java.util.HashMap <br />
<br />
==== Variablen ====<br />
<br />
Der Variableneditor ermöglicht es Ihnen, diverse Testszenarien aufzubauen, indem Sie die Werte der gegebenen Variablen beliebig verändern können. Bei komplexeren Variablen-Typen (wie z.B. Sendung oder Packstück) wird die Variable im JSON-Format angezeigt und editiert. Es gelten die üblichen Regeln für Escape-Zeichen.<br />
<br />
==== Test ====<br />
<br />
Über den Button Test können Sie Ihr aktuelles Script testen. Falls ein Syntaxfehler vorhanden ist, wird Ihnen dieser mit Angabe der Zeile angezeigt. Zusätzlich können Sie, solange das Ergebnisfenster offen ist, die komplette erstellte Klasse im Ordner Tarifwerk\compile\scriptbase einsehen.<br />
<br />
=== Editor ===<br />
<br />
Im Editor können Sie Ihr Script implementieren. Der Editor besitzt einige Features um das Erstellen von Scripten einfacher zu machen:<br />
<br />
*Falls ein Script einzeilig ist und nicht mit einem Semikolon endet benötigen Sie kein return Statement. Dieses wird automatisch hinzugefügt. <br />
*Der Scripteditor besitzt Code-Highlighting um Variablen, Kommentare und Klassen voneinander trennen zu können <br />
*Der Scripteditor besitzt eingeschränkte Code-Vervollständigungs-Features. Diese aktiviert man über die Tastenkombination Strg+Leer <br />
<br />
== Zusatzfunktionen ==<br />
<br />
Der Scripteditor kommt standardmäßig mit einigen zusätzlichen Funktionen. Viele dieser Funktionen entsprechen den Parserausdrücken aus dem HVS32.<br />
<br />
Die Detailbeschreibung und Verwendung können Sie der Code-Vervollständigung (Strg+Leer) entnehmen. Oft verwendete und nützliche Funktionen sind:<br />
<br />
*ATrim: Entfernt alle Leerzeichen am Anfang und Ende des Strings. <br />
*Left: Gibt die ersten n Stellen eines String zurück. <br />
*Right: Gibt die letzten n Stellen eines Strings zurück. <br />
*DEBUG: Zeigt den Wert einer Variable in einer Message Box an. (Bitte niemals ein Script&nbsp;speichern was diese Funktionen enthält) <br />
*DateTimeFormat: Konvertiert einen String in ein Datum. <br />
*FormatDateTime: Konvertiert ein Datum in einen String. <br />
*GetListItem: Extrahiert aus einem String das n-te Element was durch ein Trennzeichen getrennt wurde. <br />
*LeftPad: Füllt einen String links mit der angegebenen Anzahl Stellen und Zeichen auf <br />
<br />
&nbsp;<br />
<br />
== Besonderheiten ==<br />
<br />
Da der Pegasus Parser auf Java basiert, muss man einige Dinge beachten, die in anderen Scriptsprachen (wie z.B. Javascript) nicht üblich sind.<br />
<br />
=== Stringvergleiche ===<br />
<br />
Zahlen werden wie üblich über ein doppeltes == verglichen:<br />
<pre>int a = 5;<br />
if (a == 5) {<br />
....</pre><br />
<br />
Strings können damit leider nicht verglichen werden. Stattdessen muss man die Methode equals() verwenden:<br />
<pre>String a = "test";<br />
if (a.equals("test")) {<br />
...</pre><br />
<br />
Vergleiche ohne Beachtung von Groß- und Kleinschreibung geschehen über die Methode&nbsp;equalsIgnoreCase().<br />
<br />
=== Elemente von Variablen ===<br />
<br />
Elemente von Variablen (wie z.B. die Zieladress-PLZ der Sendung) werden über Getter- und Setter-Methoden gelesen und gesetzt.<br />
<br />
Diese besitzen immer den Prefix "get" bzw. "set" und das nächste Zeichen wird als Großbuchstabe geschrieben. Bei Boolean wird "is" statt "get"&nbsp;verwendet. Beispiele:<br />
<pre>shipment.getReceiverZipcode()<br />
shipment.getShipmentWeight()<br />
shipment.isIsle()<br />
packageData.getPackageType()</pre><br />
<br />
=== Direktes definieren von Nicht-int Zahlen. ===<br />
<br />
Wenn Sie einen double, float oder long direkt im Quelltext definieren wollen, benötigen diese nach der Zahl einen entsprechenden&nbsp;Suffix:<br />
<pre>double d = 4.3d;<br />
float f = 5.4f;<br />
long l = 200000l;</pre><br />
<br />
== Beispielscripte ==<br />
<br />
=== Prüfen auf Inselzustellung ===<br />
<pre>shipment.isIsle()</pre><br />
<br />
Es wird die entsprechende Inseltabelle für den jeweiligen Frachtführer benötigt.<br />
<br />
=== Auf bestimmte Länder prüfen ===<br />
<pre>final List<String> zielLaender = java.util.Arrays.asList("DE", "CH", "AT");<br />
return zielLaender.contains(shipment.getReceiverCountry());</pre><br />
<br />
Die Elemente DE, CH, AT müssen durch die gewünschten Länder im ISO2 Format ersetzt werden.<br />
<br />
=== Auf bestimmte Versandart prüfen ===<br />
<pre>shipment.getServiceType().equals("VID")</pre><br />
<br />
Die Versandart ID "VID" muss durch die Gewünschte ersetzt werden. Falls mehrere Versandarten in Frage kommen, kann man auch hier eine Liste wie im Beispiel darüber erstellen.<br />
<br />
=== Nachnahme-Sendung ===<br />
<pre>shipment.getCodAmount() > 0d</pre><br />
<br />
=== Verpackungsart prüfen ===<br />
<pre>packageData.getPackageType().equals("KT")</pre><br />
<br />
Die Verpackungsart sollte meist auch nur mit Packstück-Tarifwerken und -Zuschlägen definiert werden.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Script_(Tarifwerk)&diff=6012Script (Tarifwerk)2024-10-18T14:33:42Z<p>Ddang: </p>
<hr />
<div>[[en:Script (Tarifwerk) (en)]]<br />
<br />
[[File:TW Script Editor.png|frameless|right|super|475x413px|TW Script Editor.png]]Scripte bilden die zentrale Stelle im Tarifwerk um Regeln für [[Zuschlag_(Tarifwerk)|Zuschläge]] und [[Tarifwerk_(Tarifwerk_/_Stammdaten)|Tarifwerke]] aufzubauen. Dies&nbsp;können simple Abfragen sein, wie z.B. prüfen, ob es sich um eine Inselzustellung handelt, oder aber komplexe Konstrukte, die Frachtführer- oder Kundenspezifische Anforderungen umsetzen.<br />
<br />
Alle Scripte verwenden den Pegasus Parser, eine Eigenentwicklung der Heidler Strichcode GmbH. Die Scriptsprache basiert&nbsp;auf der Programmiersprache Java, was manche Dinge komplizierter machen kann, dafür aber deutlich mehr Flexibilität und Performance bietet.<br />
<br />
== Scripteditor ==<br />
<br />
The script editor is divided into three areas:<br />
<br />
=== Information panel ===<br />
<br />
The information panel is located at the top left. It shows you all the information you need for script development.<br />
<br />
First of all, it lists which variables you have available and which type (which class) the variables have. In the tariff structure, you will usually see the variable shipment, which corresponds to the current shipment, and possibly the variable packageData, which corresponds to the current package.<br />
<br />
The Expected return type is the type of value that you must return in this script. As a rule, only Boolean (true or false) or Double (floating point number with double precision) is expected in the tariff plant.<br />
<br />
=== Button bar ===<br />
<br />
The button bar is located at the top right. You can use it to make additional adjustments and tests.<br />
<br />
==== Imports ====<br />
<br />
The Imports button opens an editor in which you can add additional classes (functionalities) to the current script. You can use the Search button to search for the currently entered class. If successful, this class will be displayed in the list above.<br />
<br />
The following classes and interfaces are imported by default and do not need to be specified:<br />
<br />
*java.util.Date <br />
*java.text.SimpleDateFormat <br />
*java.util.ArrayList <br />
*java.util.List <br />
*java.util.Map <br />
*java.util.HashMap <br />
<br />
==== Variables ====<br />
<br />
The variable editor allows you to set up various test scenarios by changing the values of the given variables as required. For more complex variable types (such as shipment or package), the variable is displayed and edited in JSON format. The usual rules for escape characters apply.<br />
<br />
==== Test ====<br />
<br />
You can test your current script using the Test button. If there is a syntax error, this is displayed along with the line. In addition, you can view the complete class created in the folder Tarifwerk\compile\scriptbase as long as the results window is open.<br />
<br />
=== Editor ===<br />
<br />
You can implement your script in the editor. The editor has several features to make creating scripts easier:<br />
<br />
*If a script is single-line and does not end with a semicolon, you do not need a return statement. This is added automatically. <br />
*The script editor has code highlighting to separate variables, comments and classes from each other <br />
*The script editor has limited code completion features. These are activated via the key combination Ctrl+Space <br />
<br />
== Additional functions ==<br />
<br />
The script editor comes with some additional functions as standard. Many of these functions correspond to the parser expressions from the HVS32.<br />
<br />
The detailed description and use can be found in the code completion (Ctrl+Space). Frequently used and useful functions are<br />
<br />
*ATrim: Removes all spaces at the beginning and end of the string. <br />
*Left: Returns the first n digits of a string. <br />
*Right: Returns the last n digits of a string. <br />
*DEBUG: Displays the value of a variable in a message box. (Please never save a script that contains these functions) <br />
*DateTimeFormat: Converts a string into a date. <br />
*FormatDateTime: Converts a date into a string. <br />
*GetListItem: Extracts the nth element from a string that was separated by a separator. <br />
*LeftPad: Fills a string on the left with the specified number of digits and characters<br />
<br />
&nbsp;<br />
<br />
== Besonderheiten ==<br />
<br />
Da der Pegasus Parser auf Java basiert, muss man einige Dinge beachten, die in anderen Scriptsprachen (wie z.B. Javascript) nicht üblich sind.<br />
<br />
=== Stringvergleiche ===<br />
<br />
Zahlen werden wie üblich über ein doppeltes == verglichen:<br />
<pre>int a = 5;<br />
if (a == 5) {<br />
....</pre><br />
<br />
Strings können damit leider nicht verglichen werden. Stattdessen muss man die Methode equals() verwenden:<br />
<pre>String a = "test";<br />
if (a.equals("test")) {<br />
...</pre><br />
<br />
Vergleiche ohne Beachtung von Groß- und Kleinschreibung geschehen über die Methode&nbsp;equalsIgnoreCase().<br />
<br />
=== Elemente von Variablen ===<br />
<br />
Elemente von Variablen (wie z.B. die Zieladress-PLZ der Sendung) werden über Getter- und Setter-Methoden gelesen und gesetzt.<br />
<br />
Diese besitzen immer den Prefix "get" bzw. "set" und das nächste Zeichen wird als Großbuchstabe geschrieben. Bei Boolean wird "is" statt "get"&nbsp;verwendet. Beispiele:<br />
<pre>shipment.getReceiverZipcode()<br />
shipment.getShipmentWeight()<br />
shipment.isIsle()<br />
packageData.getPackageType()</pre><br />
<br />
=== Direktes definieren von Nicht-int Zahlen. ===<br />
<br />
Wenn Sie einen double, float oder long direkt im Quelltext definieren wollen, benötigen diese nach der Zahl einen entsprechenden&nbsp;Suffix:<br />
<pre>double d = 4.3d;<br />
float f = 5.4f;<br />
long l = 200000l;</pre><br />
<br />
== Beispielscripte ==<br />
<br />
=== Prüfen auf Inselzustellung ===<br />
<pre>shipment.isIsle()</pre><br />
<br />
Es wird die entsprechende Inseltabelle für den jeweiligen Frachtführer benötigt.<br />
<br />
=== Auf bestimmte Länder prüfen ===<br />
<pre>final List<String> zielLaender = java.util.Arrays.asList("DE", "CH", "AT");<br />
return zielLaender.contains(shipment.getReceiverCountry());</pre><br />
<br />
Die Elemente DE, CH, AT müssen durch die gewünschten Länder im ISO2 Format ersetzt werden.<br />
<br />
=== Auf bestimmte Versandart prüfen ===<br />
<pre>shipment.getServiceType().equals("VID")</pre><br />
<br />
Die Versandart ID "VID" muss durch die Gewünschte ersetzt werden. Falls mehrere Versandarten in Frage kommen, kann man auch hier eine Liste wie im Beispiel darüber erstellen.<br />
<br />
=== Nachnahme-Sendung ===<br />
<pre>shipment.getCodAmount() > 0d</pre><br />
<br />
=== Verpackungsart prüfen ===<br />
<pre>packageData.getPackageType().equals("KT")</pre><br />
<br />
Die Verpackungsart sollte meist auch nur mit Packstück-Tarifwerken und -Zuschlägen definiert werden.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Script_(Tarifwerk)_(en)&diff=6011Script (Tarifwerk) (en)2024-10-18T14:29:28Z<p>Ddang: </p>
<hr />
<div>[[de:Script (Tarifwerk)]]<br />
<br />
[[File:Script_Zuschlag(en).png|frameless|right|super|475x413px|TW Script Editor.png]]Scripts are the central point in the rate structure for creating rules for surcharges and rate structures. These can be simple queries, such as checking whether it is an island delivery, or complex constructs that implement carrier or customer-specific requirements.<br />
All scripts use the Pegasus parser, a proprietary development of Heidler Strichcode GmbH. The scripting language is based on the Java programming language, which can make some things more complicated, but offers significantly more flexibility and performance.<br />
<br />
== Scripteditor ==<br />
<br />
Der Scripteditor ist in drei Bereiche unterteilt:<br />
<br />
=== Informationspanel ===<br />
<br />
Das Informationspanel befindet sich links oben. Es zeigt Ihnen alle Informationen an, welche Sie für die Scriptentwicklung benötigen.<br />
<br />
Zunächst wird Ihnen aufgelistet, welche Variablen Sie zur Verfügung haben und welchen Typ (welche Klasse) die Variablen besitzen. Im Tarifwerk erhalten Sie hier meist die Variable shipment, was der aktuellen Sendung entspricht, und eventuell die Variable packageData, was dem aktuellen Packstück entspricht.<br />
<br />
Der Erwartete Rückgabetyp ist der Typ des Wertes, welchen Sie in diesem Script zurückgeben müssen. Im Tarifwerk wird in der Regel nur Boolean (true oder false) oder Double (Gleitkommazahl mit doppelter Präzision) erwartet.<br />
<br />
=== Button-Leiste ===<br />
<br />
Die Button-Leiste befindet sich rechts oben. Sie können damit zusätzliche Anpassungen und Tests vornehmen.<br />
<br />
==== Importe ====<br />
<br />
Der Button Importe öffnet einen Editor, in dem Sie zusätzliche Klassen (Funktionalitäten) zum aktuellen Script hinzufügen können. Über den Button Suchen können Sie die aktuell eingegebene Klasse suchen. Bei Erfolg wird Ihnen diese Klasse in der Liste darüber angezeigt.<br />
<br />
Folgende Klassen und Interfaces sind standardmäßig Importiert und müssen nicht angegeben werden:<br />
<br />
*java.util.Date <br />
*java.text.SimpleDateFormat <br />
*java.util.ArrayList <br />
*java.util.List <br />
*java.util.Map <br />
*java.util.HashMap <br />
<br />
==== Variablen ====<br />
<br />
Der Variableneditor ermöglicht es Ihnen, diverse Testszenarien aufzubauen, indem Sie die Werte der gegebenen Variablen beliebig verändern können. Bei komplexeren Variablen-Typen (wie z.B. Sendung oder Packstück) wird die Variable im JSON-Format angezeigt und editiert. Es gelten die üblichen Regeln für Escape-Zeichen.<br />
<br />
==== Test ====<br />
<br />
Über den Button Test können Sie Ihr aktuelles Script testen. Falls ein Syntaxfehler vorhanden ist, wird Ihnen dieser mit Angabe der Zeile angezeigt. Zusätzlich können Sie, solange das Ergebnisfenster offen ist, die komplette erstellte Klasse im Ordner Tarifwerk\compile\scriptbase einsehen.<br />
<br />
=== Editor ===<br />
<br />
Im Editor können Sie Ihr Script implementieren. Der Editor besitzt einige Features um das Erstellen von Scripten einfacher zu machen:<br />
<br />
*Falls ein Script einzeilig ist und nicht mit einem Semikolon endet benötigen Sie kein return Statement. Dieses wird automatisch hinzugefügt. <br />
*Der Scripteditor besitzt Code-Highlighting um Variablen, Kommentare und Klassen voneinander trennen zu können <br />
*Der Scripteditor besitzt eingeschränkte Code-Vervollständigungs-Features. Diese aktiviert man über die Tastenkombination Strg+Leer <br />
<br />
== Zusatzfunktionen ==<br />
<br />
Der Scripteditor kommt standardmäßig mit einigen zusätzlichen Funktionen. Viele dieser Funktionen entsprechen den Parserausdrücken aus dem HVS32.<br />
<br />
Die Detailbeschreibung und Verwendung können Sie der Code-Vervollständigung (Strg+Leer) entnehmen. Oft verwendete und nützliche Funktionen sind:<br />
<br />
*ATrim: Entfernt alle Leerzeichen am Anfang und Ende des Strings. <br />
*Left: Gibt die ersten n Stellen eines String zurück. <br />
*Right: Gibt die letzten n Stellen eines Strings zurück. <br />
*DEBUG: Zeigt den Wert einer Variable in einer Message Box an. (Bitte niemals ein Script&nbsp;speichern was diese Funktionen enthält) <br />
*DateTimeFormat: Konvertiert einen String in ein Datum. <br />
*FormatDateTime: Konvertiert ein Datum in einen String. <br />
*GetListItem: Extrahiert aus einem String das n-te Element was durch ein Trennzeichen getrennt wurde. <br />
*LeftPad: Füllt einen String links mit der angegebenen Anzahl Stellen und Zeichen auf <br />
<br />
&nbsp;<br />
<br />
== Besonderheiten ==<br />
<br />
Da der Pegasus Parser auf Java basiert, muss man einige Dinge beachten, die in anderen Scriptsprachen (wie z.B. Javascript) nicht üblich sind.<br />
<br />
=== Stringvergleiche ===<br />
<br />
Zahlen werden wie üblich über ein doppeltes == verglichen:<br />
<pre>int a = 5;<br />
if (a == 5) {<br />
....</pre><br />
<br />
Strings können damit leider nicht verglichen werden. Stattdessen muss man die Methode equals() verwenden:<br />
<pre>String a = "test";<br />
if (a.equals("test")) {<br />
...</pre><br />
<br />
Vergleiche ohne Beachtung von Groß- und Kleinschreibung geschehen über die Methode&nbsp;equalsIgnoreCase().<br />
<br />
=== Elemente von Variablen ===<br />
<br />
Elemente von Variablen (wie z.B. die Zieladress-PLZ der Sendung) werden über Getter- und Setter-Methoden gelesen und gesetzt.<br />
<br />
Diese besitzen immer den Prefix "get" bzw. "set" und das nächste Zeichen wird als Großbuchstabe geschrieben. Bei Boolean wird "is" statt "get"&nbsp;verwendet. Beispiele:<br />
<pre>shipment.getReceiverZipcode()<br />
shipment.getShipmentWeight()<br />
shipment.isIsle()<br />
packageData.getPackageType()</pre><br />
<br />
=== Direktes definieren von Nicht-int Zahlen. ===<br />
<br />
Wenn Sie einen double, float oder long direkt im Quelltext definieren wollen, benötigen diese nach der Zahl einen entsprechenden&nbsp;Suffix:<br />
<pre>double d = 4.3d;<br />
float f = 5.4f;<br />
long l = 200000l;</pre><br />
<br />
== Beispielscripte ==<br />
<br />
=== Prüfen auf Inselzustellung ===<br />
<pre>shipment.isIsle()</pre><br />
<br />
Es wird die entsprechende Inseltabelle für den jeweiligen Frachtführer benötigt.<br />
<br />
=== Auf bestimmte Länder prüfen ===<br />
<pre>final List<String> zielLaender = java.util.Arrays.asList("DE", "CH", "AT");<br />
return zielLaender.contains(shipment.getReceiverCountry());</pre><br />
<br />
Die Elemente DE, CH, AT müssen durch die gewünschten Länder im ISO2 Format ersetzt werden.<br />
<br />
=== Auf bestimmte Versandart prüfen ===<br />
<pre>shipment.getServiceType().equals("VID")</pre><br />
<br />
Die Versandart ID "VID" muss durch die Gewünschte ersetzt werden. Falls mehrere Versandarten in Frage kommen, kann man auch hier eine Liste wie im Beispiel darüber erstellen.<br />
<br />
=== Nachnahme-Sendung ===<br />
<pre>shipment.getCodAmount() > 0d</pre><br />
<br />
=== Verpackungsart prüfen ===<br />
<pre>packageData.getPackageType().equals("KT")</pre><br />
<br />
Die Verpackungsart sollte meist auch nur mit Packstück-Tarifwerken und -Zuschlägen definiert werden.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Script_(Tarifwerk)_(en)&diff=6010Script (Tarifwerk) (en)2024-10-18T14:28:28Z<p>Ddang: </p>
<hr />
<div>[[de:Script (Tarifwerk)]]<br />
<br />
[[File:Script_Zuschlag(en).png|frameless|right|super|475x413px|TW Script Editor.png]]Scripts are the central point in the rate structure for creating rules for surcharges and rate structures. These can be simple queries, such as checking whether it is an island delivery, or complex constructs that implement carrier or customer-specific requirements.<br />
All scripts use the Pegasus parser, a proprietary development of Heidler Strichcode GmbH. The scripting language is based on the Java programming language, which can make some things more complicated, but offers significantly more flexibility and performance.<br />
<br />
Alle Scripte verwenden den Pegasus Parser, eine Eigenentwicklung der Heidler Strichcode GmbH. Die Scriptsprache basiert&nbsp;auf der Programmiersprache Java, was manche Dinge komplizierter machen kann, dafür aber deutlich mehr Flexibilität und Performance bietet.<br />
<br />
== Scripteditor ==<br />
<br />
Der Scripteditor ist in drei Bereiche unterteilt:<br />
<br />
=== Informationspanel ===<br />
<br />
Das Informationspanel befindet sich links oben. Es zeigt Ihnen alle Informationen an, welche Sie für die Scriptentwicklung benötigen.<br />
<br />
Zunächst wird Ihnen aufgelistet, welche Variablen Sie zur Verfügung haben und welchen Typ (welche Klasse) die Variablen besitzen. Im Tarifwerk erhalten Sie hier meist die Variable shipment, was der aktuellen Sendung entspricht, und eventuell die Variable packageData, was dem aktuellen Packstück entspricht.<br />
<br />
Der Erwartete Rückgabetyp ist der Typ des Wertes, welchen Sie in diesem Script zurückgeben müssen. Im Tarifwerk wird in der Regel nur Boolean (true oder false) oder Double (Gleitkommazahl mit doppelter Präzision) erwartet.<br />
<br />
=== Button-Leiste ===<br />
<br />
Die Button-Leiste befindet sich rechts oben. Sie können damit zusätzliche Anpassungen und Tests vornehmen.<br />
<br />
==== Importe ====<br />
<br />
Der Button Importe öffnet einen Editor, in dem Sie zusätzliche Klassen (Funktionalitäten) zum aktuellen Script hinzufügen können. Über den Button Suchen können Sie die aktuell eingegebene Klasse suchen. Bei Erfolg wird Ihnen diese Klasse in der Liste darüber angezeigt.<br />
<br />
Folgende Klassen und Interfaces sind standardmäßig Importiert und müssen nicht angegeben werden:<br />
<br />
*java.util.Date <br />
*java.text.SimpleDateFormat <br />
*java.util.ArrayList <br />
*java.util.List <br />
*java.util.Map <br />
*java.util.HashMap <br />
<br />
==== Variablen ====<br />
<br />
Der Variableneditor ermöglicht es Ihnen, diverse Testszenarien aufzubauen, indem Sie die Werte der gegebenen Variablen beliebig verändern können. Bei komplexeren Variablen-Typen (wie z.B. Sendung oder Packstück) wird die Variable im JSON-Format angezeigt und editiert. Es gelten die üblichen Regeln für Escape-Zeichen.<br />
<br />
==== Test ====<br />
<br />
Über den Button Test können Sie Ihr aktuelles Script testen. Falls ein Syntaxfehler vorhanden ist, wird Ihnen dieser mit Angabe der Zeile angezeigt. Zusätzlich können Sie, solange das Ergebnisfenster offen ist, die komplette erstellte Klasse im Ordner Tarifwerk\compile\scriptbase einsehen.<br />
<br />
=== Editor ===<br />
<br />
Im Editor können Sie Ihr Script implementieren. Der Editor besitzt einige Features um das Erstellen von Scripten einfacher zu machen:<br />
<br />
*Falls ein Script einzeilig ist und nicht mit einem Semikolon endet benötigen Sie kein return Statement. Dieses wird automatisch hinzugefügt. <br />
*Der Scripteditor besitzt Code-Highlighting um Variablen, Kommentare und Klassen voneinander trennen zu können <br />
*Der Scripteditor besitzt eingeschränkte Code-Vervollständigungs-Features. Diese aktiviert man über die Tastenkombination Strg+Leer <br />
<br />
== Zusatzfunktionen ==<br />
<br />
Der Scripteditor kommt standardmäßig mit einigen zusätzlichen Funktionen. Viele dieser Funktionen entsprechen den Parserausdrücken aus dem HVS32.<br />
<br />
Die Detailbeschreibung und Verwendung können Sie der Code-Vervollständigung (Strg+Leer) entnehmen. Oft verwendete und nützliche Funktionen sind:<br />
<br />
*ATrim: Entfernt alle Leerzeichen am Anfang und Ende des Strings. <br />
*Left: Gibt die ersten n Stellen eines String zurück. <br />
*Right: Gibt die letzten n Stellen eines Strings zurück. <br />
*DEBUG: Zeigt den Wert einer Variable in einer Message Box an. (Bitte niemals ein Script&nbsp;speichern was diese Funktionen enthält) <br />
*DateTimeFormat: Konvertiert einen String in ein Datum. <br />
*FormatDateTime: Konvertiert ein Datum in einen String. <br />
*GetListItem: Extrahiert aus einem String das n-te Element was durch ein Trennzeichen getrennt wurde. <br />
*LeftPad: Füllt einen String links mit der angegebenen Anzahl Stellen und Zeichen auf <br />
<br />
&nbsp;<br />
<br />
== Besonderheiten ==<br />
<br />
Da der Pegasus Parser auf Java basiert, muss man einige Dinge beachten, die in anderen Scriptsprachen (wie z.B. Javascript) nicht üblich sind.<br />
<br />
=== Stringvergleiche ===<br />
<br />
Zahlen werden wie üblich über ein doppeltes == verglichen:<br />
<pre>int a = 5;<br />
if (a == 5) {<br />
....</pre><br />
<br />
Strings können damit leider nicht verglichen werden. Stattdessen muss man die Methode equals() verwenden:<br />
<pre>String a = "test";<br />
if (a.equals("test")) {<br />
...</pre><br />
<br />
Vergleiche ohne Beachtung von Groß- und Kleinschreibung geschehen über die Methode&nbsp;equalsIgnoreCase().<br />
<br />
=== Elemente von Variablen ===<br />
<br />
Elemente von Variablen (wie z.B. die Zieladress-PLZ der Sendung) werden über Getter- und Setter-Methoden gelesen und gesetzt.<br />
<br />
Diese besitzen immer den Prefix "get" bzw. "set" und das nächste Zeichen wird als Großbuchstabe geschrieben. Bei Boolean wird "is" statt "get"&nbsp;verwendet. Beispiele:<br />
<pre>shipment.getReceiverZipcode()<br />
shipment.getShipmentWeight()<br />
shipment.isIsle()<br />
packageData.getPackageType()</pre><br />
<br />
=== Direktes definieren von Nicht-int Zahlen. ===<br />
<br />
Wenn Sie einen double, float oder long direkt im Quelltext definieren wollen, benötigen diese nach der Zahl einen entsprechenden&nbsp;Suffix:<br />
<pre>double d = 4.3d;<br />
float f = 5.4f;<br />
long l = 200000l;</pre><br />
<br />
== Beispielscripte ==<br />
<br />
=== Prüfen auf Inselzustellung ===<br />
<pre>shipment.isIsle()</pre><br />
<br />
Es wird die entsprechende Inseltabelle für den jeweiligen Frachtführer benötigt.<br />
<br />
=== Auf bestimmte Länder prüfen ===<br />
<pre>final List<String> zielLaender = java.util.Arrays.asList("DE", "CH", "AT");<br />
return zielLaender.contains(shipment.getReceiverCountry());</pre><br />
<br />
Die Elemente DE, CH, AT müssen durch die gewünschten Länder im ISO2 Format ersetzt werden.<br />
<br />
=== Auf bestimmte Versandart prüfen ===<br />
<pre>shipment.getServiceType().equals("VID")</pre><br />
<br />
Die Versandart ID "VID" muss durch die Gewünschte ersetzt werden. Falls mehrere Versandarten in Frage kommen, kann man auch hier eine Liste wie im Beispiel darüber erstellen.<br />
<br />
=== Nachnahme-Sendung ===<br />
<pre>shipment.getCodAmount() > 0d</pre><br />
<br />
=== Verpackungsart prüfen ===<br />
<pre>packageData.getPackageType().equals("KT")</pre><br />
<br />
Die Verpackungsart sollte meist auch nur mit Packstück-Tarifwerken und -Zuschlägen definiert werden.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Datei:TW_Script_Editor.png&diff=6009Datei:TW Script Editor.png2024-10-18T14:22:06Z<p>Ddang: Ddang lud eine neue Version von Datei:TW Script Editor.png hoch</p>
<hr />
<div></div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Script_(Tarifwerk)_(en)&diff=6008Script (Tarifwerk) (en)2024-10-18T14:21:10Z<p>Ddang: </p>
<hr />
<div>[[de:Script (Tarifwerk)]]<br />
<br />
[[File:Script_Zuschlag(en).png|frameless|right|super|475x413px|TW Script Editor.png]]Scripte bilden die zentrale Stelle im Tarifwerk um Regeln für [[Zuschlag_(Tarifwerk)|Zuschläge]] und [[Tarifwerk_(Tarifwerk_/_Stammdaten)|Tarifwerke]] aufzubauen. Dies&nbsp;können simple Abfragen sein, wie z.B. prüfen, ob es sich um eine Inselzustellung handelt, oder aber komplexe Konstrukte, die Frachtführer- oder Kundenspezifische Anforderungen umsetzen.<br />
<br />
Alle Scripte verwenden den Pegasus Parser, eine Eigenentwicklung der Heidler Strichcode GmbH. Die Scriptsprache basiert&nbsp;auf der Programmiersprache Java, was manche Dinge komplizierter machen kann, dafür aber deutlich mehr Flexibilität und Performance bietet.<br />
<br />
== Scripteditor ==<br />
<br />
Der Scripteditor ist in drei Bereiche unterteilt:<br />
<br />
=== Informationspanel ===<br />
<br />
Das Informationspanel befindet sich links oben. Es zeigt Ihnen alle Informationen an, welche Sie für die Scriptentwicklung benötigen.<br />
<br />
Zunächst wird Ihnen aufgelistet, welche Variablen Sie zur Verfügung haben und welchen Typ (welche Klasse) die Variablen besitzen. Im Tarifwerk erhalten Sie hier meist die Variable shipment, was der aktuellen Sendung entspricht, und eventuell die Variable packageData, was dem aktuellen Packstück entspricht.<br />
<br />
Der Erwartete Rückgabetyp ist der Typ des Wertes, welchen Sie in diesem Script zurückgeben müssen. Im Tarifwerk wird in der Regel nur Boolean (true oder false) oder Double (Gleitkommazahl mit doppelter Präzision) erwartet.<br />
<br />
=== Button-Leiste ===<br />
<br />
Die Button-Leiste befindet sich rechts oben. Sie können damit zusätzliche Anpassungen und Tests vornehmen.<br />
<br />
==== Importe ====<br />
<br />
Der Button Importe öffnet einen Editor, in dem Sie zusätzliche Klassen (Funktionalitäten) zum aktuellen Script hinzufügen können. Über den Button Suchen können Sie die aktuell eingegebene Klasse suchen. Bei Erfolg wird Ihnen diese Klasse in der Liste darüber angezeigt.<br />
<br />
Folgende Klassen und Interfaces sind standardmäßig Importiert und müssen nicht angegeben werden:<br />
<br />
*java.util.Date <br />
*java.text.SimpleDateFormat <br />
*java.util.ArrayList <br />
*java.util.List <br />
*java.util.Map <br />
*java.util.HashMap <br />
<br />
==== Variablen ====<br />
<br />
Der Variableneditor ermöglicht es Ihnen, diverse Testszenarien aufzubauen, indem Sie die Werte der gegebenen Variablen beliebig verändern können. Bei komplexeren Variablen-Typen (wie z.B. Sendung oder Packstück) wird die Variable im JSON-Format angezeigt und editiert. Es gelten die üblichen Regeln für Escape-Zeichen.<br />
<br />
==== Test ====<br />
<br />
Über den Button Test können Sie Ihr aktuelles Script testen. Falls ein Syntaxfehler vorhanden ist, wird Ihnen dieser mit Angabe der Zeile angezeigt. Zusätzlich können Sie, solange das Ergebnisfenster offen ist, die komplette erstellte Klasse im Ordner Tarifwerk\compile\scriptbase einsehen.<br />
<br />
=== Editor ===<br />
<br />
Im Editor können Sie Ihr Script implementieren. Der Editor besitzt einige Features um das Erstellen von Scripten einfacher zu machen:<br />
<br />
*Falls ein Script einzeilig ist und nicht mit einem Semikolon endet benötigen Sie kein return Statement. Dieses wird automatisch hinzugefügt. <br />
*Der Scripteditor besitzt Code-Highlighting um Variablen, Kommentare und Klassen voneinander trennen zu können <br />
*Der Scripteditor besitzt eingeschränkte Code-Vervollständigungs-Features. Diese aktiviert man über die Tastenkombination Strg+Leer <br />
<br />
== Zusatzfunktionen ==<br />
<br />
Der Scripteditor kommt standardmäßig mit einigen zusätzlichen Funktionen. Viele dieser Funktionen entsprechen den Parserausdrücken aus dem HVS32.<br />
<br />
Die Detailbeschreibung und Verwendung können Sie der Code-Vervollständigung (Strg+Leer) entnehmen. Oft verwendete und nützliche Funktionen sind:<br />
<br />
*ATrim: Entfernt alle Leerzeichen am Anfang und Ende des Strings. <br />
*Left: Gibt die ersten n Stellen eines String zurück. <br />
*Right: Gibt die letzten n Stellen eines Strings zurück. <br />
*DEBUG: Zeigt den Wert einer Variable in einer Message Box an. (Bitte niemals ein Script&nbsp;speichern was diese Funktionen enthält) <br />
*DateTimeFormat: Konvertiert einen String in ein Datum. <br />
*FormatDateTime: Konvertiert ein Datum in einen String. <br />
*GetListItem: Extrahiert aus einem String das n-te Element was durch ein Trennzeichen getrennt wurde. <br />
*LeftPad: Füllt einen String links mit der angegebenen Anzahl Stellen und Zeichen auf <br />
<br />
&nbsp;<br />
<br />
== Besonderheiten ==<br />
<br />
Da der Pegasus Parser auf Java basiert, muss man einige Dinge beachten, die in anderen Scriptsprachen (wie z.B. Javascript) nicht üblich sind.<br />
<br />
=== Stringvergleiche ===<br />
<br />
Zahlen werden wie üblich über ein doppeltes == verglichen:<br />
<pre>int a = 5;<br />
if (a == 5) {<br />
....</pre><br />
<br />
Strings können damit leider nicht verglichen werden. Stattdessen muss man die Methode equals() verwenden:<br />
<pre>String a = "test";<br />
if (a.equals("test")) {<br />
...</pre><br />
<br />
Vergleiche ohne Beachtung von Groß- und Kleinschreibung geschehen über die Methode&nbsp;equalsIgnoreCase().<br />
<br />
=== Elemente von Variablen ===<br />
<br />
Elemente von Variablen (wie z.B. die Zieladress-PLZ der Sendung) werden über Getter- und Setter-Methoden gelesen und gesetzt.<br />
<br />
Diese besitzen immer den Prefix "get" bzw. "set" und das nächste Zeichen wird als Großbuchstabe geschrieben. Bei Boolean wird "is" statt "get"&nbsp;verwendet. Beispiele:<br />
<pre>shipment.getReceiverZipcode()<br />
shipment.getShipmentWeight()<br />
shipment.isIsle()<br />
packageData.getPackageType()</pre><br />
<br />
=== Direktes definieren von Nicht-int Zahlen. ===<br />
<br />
Wenn Sie einen double, float oder long direkt im Quelltext definieren wollen, benötigen diese nach der Zahl einen entsprechenden&nbsp;Suffix:<br />
<pre>double d = 4.3d;<br />
float f = 5.4f;<br />
long l = 200000l;</pre><br />
<br />
== Beispielscripte ==<br />
<br />
=== Prüfen auf Inselzustellung ===<br />
<pre>shipment.isIsle()</pre><br />
<br />
Es wird die entsprechende Inseltabelle für den jeweiligen Frachtführer benötigt.<br />
<br />
=== Auf bestimmte Länder prüfen ===<br />
<pre>final List<String> zielLaender = java.util.Arrays.asList("DE", "CH", "AT");<br />
return zielLaender.contains(shipment.getReceiverCountry());</pre><br />
<br />
Die Elemente DE, CH, AT müssen durch die gewünschten Länder im ISO2 Format ersetzt werden.<br />
<br />
=== Auf bestimmte Versandart prüfen ===<br />
<pre>shipment.getServiceType().equals("VID")</pre><br />
<br />
Die Versandart ID "VID" muss durch die Gewünschte ersetzt werden. Falls mehrere Versandarten in Frage kommen, kann man auch hier eine Liste wie im Beispiel darüber erstellen.<br />
<br />
=== Nachnahme-Sendung ===<br />
<pre>shipment.getCodAmount() > 0d</pre><br />
<br />
=== Verpackungsart prüfen ===<br />
<pre>packageData.getPackageType().equals("KT")</pre><br />
<br />
Die Verpackungsart sollte meist auch nur mit Packstück-Tarifwerken und -Zuschlägen definiert werden.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Datei:Script_Zuschlag(en).png&diff=6007Datei:Script Zuschlag(en).png2024-10-18T14:20:52Z<p>Ddang: </p>
<hr />
<div></div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Script_(Tarifwerk)_(en)&diff=6006Script (Tarifwerk) (en)2024-10-18T14:17:26Z<p>Ddang: </p>
<hr />
<div>[[de:Script (Tarifwerk)]]<br />
<br />
[[File:Script_Tarifwerk.png|frameless|right|super|475x413px|TW Script Editor.png]]Scripte bilden die zentrale Stelle im Tarifwerk um Regeln für [[Zuschlag_(Tarifwerk)|Zuschläge]] und [[Tarifwerk_(Tarifwerk_/_Stammdaten)|Tarifwerke]] aufzubauen. Dies&nbsp;können simple Abfragen sein, wie z.B. prüfen, ob es sich um eine Inselzustellung handelt, oder aber komplexe Konstrukte, die Frachtführer- oder Kundenspezifische Anforderungen umsetzen.<br />
<br />
Alle Scripte verwenden den Pegasus Parser, eine Eigenentwicklung der Heidler Strichcode GmbH. Die Scriptsprache basiert&nbsp;auf der Programmiersprache Java, was manche Dinge komplizierter machen kann, dafür aber deutlich mehr Flexibilität und Performance bietet.<br />
<br />
== Scripteditor ==<br />
<br />
Der Scripteditor ist in drei Bereiche unterteilt:<br />
<br />
=== Informationspanel ===<br />
<br />
Das Informationspanel befindet sich links oben. Es zeigt Ihnen alle Informationen an, welche Sie für die Scriptentwicklung benötigen.<br />
<br />
Zunächst wird Ihnen aufgelistet, welche Variablen Sie zur Verfügung haben und welchen Typ (welche Klasse) die Variablen besitzen. Im Tarifwerk erhalten Sie hier meist die Variable shipment, was der aktuellen Sendung entspricht, und eventuell die Variable packageData, was dem aktuellen Packstück entspricht.<br />
<br />
Der Erwartete Rückgabetyp ist der Typ des Wertes, welchen Sie in diesem Script zurückgeben müssen. Im Tarifwerk wird in der Regel nur Boolean (true oder false) oder Double (Gleitkommazahl mit doppelter Präzision) erwartet.<br />
<br />
=== Button-Leiste ===<br />
<br />
Die Button-Leiste befindet sich rechts oben. Sie können damit zusätzliche Anpassungen und Tests vornehmen.<br />
<br />
==== Importe ====<br />
<br />
Der Button Importe öffnet einen Editor, in dem Sie zusätzliche Klassen (Funktionalitäten) zum aktuellen Script hinzufügen können. Über den Button Suchen können Sie die aktuell eingegebene Klasse suchen. Bei Erfolg wird Ihnen diese Klasse in der Liste darüber angezeigt.<br />
<br />
Folgende Klassen und Interfaces sind standardmäßig Importiert und müssen nicht angegeben werden:<br />
<br />
*java.util.Date <br />
*java.text.SimpleDateFormat <br />
*java.util.ArrayList <br />
*java.util.List <br />
*java.util.Map <br />
*java.util.HashMap <br />
<br />
==== Variablen ====<br />
<br />
Der Variableneditor ermöglicht es Ihnen, diverse Testszenarien aufzubauen, indem Sie die Werte der gegebenen Variablen beliebig verändern können. Bei komplexeren Variablen-Typen (wie z.B. Sendung oder Packstück) wird die Variable im JSON-Format angezeigt und editiert. Es gelten die üblichen Regeln für Escape-Zeichen.<br />
<br />
==== Test ====<br />
<br />
Über den Button Test können Sie Ihr aktuelles Script testen. Falls ein Syntaxfehler vorhanden ist, wird Ihnen dieser mit Angabe der Zeile angezeigt. Zusätzlich können Sie, solange das Ergebnisfenster offen ist, die komplette erstellte Klasse im Ordner Tarifwerk\compile\scriptbase einsehen.<br />
<br />
=== Editor ===<br />
<br />
Im Editor können Sie Ihr Script implementieren. Der Editor besitzt einige Features um das Erstellen von Scripten einfacher zu machen:<br />
<br />
*Falls ein Script einzeilig ist und nicht mit einem Semikolon endet benötigen Sie kein return Statement. Dieses wird automatisch hinzugefügt. <br />
*Der Scripteditor besitzt Code-Highlighting um Variablen, Kommentare und Klassen voneinander trennen zu können <br />
*Der Scripteditor besitzt eingeschränkte Code-Vervollständigungs-Features. Diese aktiviert man über die Tastenkombination Strg+Leer <br />
<br />
== Zusatzfunktionen ==<br />
<br />
Der Scripteditor kommt standardmäßig mit einigen zusätzlichen Funktionen. Viele dieser Funktionen entsprechen den Parserausdrücken aus dem HVS32.<br />
<br />
Die Detailbeschreibung und Verwendung können Sie der Code-Vervollständigung (Strg+Leer) entnehmen. Oft verwendete und nützliche Funktionen sind:<br />
<br />
*ATrim: Entfernt alle Leerzeichen am Anfang und Ende des Strings. <br />
*Left: Gibt die ersten n Stellen eines String zurück. <br />
*Right: Gibt die letzten n Stellen eines Strings zurück. <br />
*DEBUG: Zeigt den Wert einer Variable in einer Message Box an. (Bitte niemals ein Script&nbsp;speichern was diese Funktionen enthält) <br />
*DateTimeFormat: Konvertiert einen String in ein Datum. <br />
*FormatDateTime: Konvertiert ein Datum in einen String. <br />
*GetListItem: Extrahiert aus einem String das n-te Element was durch ein Trennzeichen getrennt wurde. <br />
*LeftPad: Füllt einen String links mit der angegebenen Anzahl Stellen und Zeichen auf <br />
<br />
&nbsp;<br />
<br />
== Besonderheiten ==<br />
<br />
Da der Pegasus Parser auf Java basiert, muss man einige Dinge beachten, die in anderen Scriptsprachen (wie z.B. Javascript) nicht üblich sind.<br />
<br />
=== Stringvergleiche ===<br />
<br />
Zahlen werden wie üblich über ein doppeltes == verglichen:<br />
<pre>int a = 5;<br />
if (a == 5) {<br />
....</pre><br />
<br />
Strings können damit leider nicht verglichen werden. Stattdessen muss man die Methode equals() verwenden:<br />
<pre>String a = "test";<br />
if (a.equals("test")) {<br />
...</pre><br />
<br />
Vergleiche ohne Beachtung von Groß- und Kleinschreibung geschehen über die Methode&nbsp;equalsIgnoreCase().<br />
<br />
=== Elemente von Variablen ===<br />
<br />
Elemente von Variablen (wie z.B. die Zieladress-PLZ der Sendung) werden über Getter- und Setter-Methoden gelesen und gesetzt.<br />
<br />
Diese besitzen immer den Prefix "get" bzw. "set" und das nächste Zeichen wird als Großbuchstabe geschrieben. Bei Boolean wird "is" statt "get"&nbsp;verwendet. Beispiele:<br />
<pre>shipment.getReceiverZipcode()<br />
shipment.getShipmentWeight()<br />
shipment.isIsle()<br />
packageData.getPackageType()</pre><br />
<br />
=== Direktes definieren von Nicht-int Zahlen. ===<br />
<br />
Wenn Sie einen double, float oder long direkt im Quelltext definieren wollen, benötigen diese nach der Zahl einen entsprechenden&nbsp;Suffix:<br />
<pre>double d = 4.3d;<br />
float f = 5.4f;<br />
long l = 200000l;</pre><br />
<br />
== Beispielscripte ==<br />
<br />
=== Prüfen auf Inselzustellung ===<br />
<pre>shipment.isIsle()</pre><br />
<br />
Es wird die entsprechende Inseltabelle für den jeweiligen Frachtführer benötigt.<br />
<br />
=== Auf bestimmte Länder prüfen ===<br />
<pre>final List<String> zielLaender = java.util.Arrays.asList("DE", "CH", "AT");<br />
return zielLaender.contains(shipment.getReceiverCountry());</pre><br />
<br />
Die Elemente DE, CH, AT müssen durch die gewünschten Länder im ISO2 Format ersetzt werden.<br />
<br />
=== Auf bestimmte Versandart prüfen ===<br />
<pre>shipment.getServiceType().equals("VID")</pre><br />
<br />
Die Versandart ID "VID" muss durch die Gewünschte ersetzt werden. Falls mehrere Versandarten in Frage kommen, kann man auch hier eine Liste wie im Beispiel darüber erstellen.<br />
<br />
=== Nachnahme-Sendung ===<br />
<pre>shipment.getCodAmount() > 0d</pre><br />
<br />
=== Verpackungsart prüfen ===<br />
<pre>packageData.getPackageType().equals("KT")</pre><br />
<br />
Die Verpackungsart sollte meist auch nur mit Packstück-Tarifwerken und -Zuschlägen definiert werden.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Datei:Script_Tarifwerk.png&diff=6005Datei:Script Tarifwerk.png2024-10-18T14:17:01Z<p>Ddang: </p>
<hr />
<div></div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Script_(Tarifwerk)_(en)&diff=6004Script (Tarifwerk) (en)2024-10-18T14:07:44Z<p>Ddang: Die Seite wurde neu angelegt: „de:Script (Tarifwerk) TW Script Editor.pngScripte bilden die zentrale Stelle im Tarifwerk um…“</p>
<hr />
<div>[[de:Script (Tarifwerk)]]<br />
<br />
[[File:TW Script Editor.png|frameless|right|super|475x413px|TW Script Editor.png]]Scripte bilden die zentrale Stelle im Tarifwerk um Regeln für [[Zuschlag_(Tarifwerk)|Zuschläge]] und [[Tarifwerk_(Tarifwerk_/_Stammdaten)|Tarifwerke]] aufzubauen. Dies&nbsp;können simple Abfragen sein, wie z.B. prüfen, ob es sich um eine Inselzustellung handelt, oder aber komplexe Konstrukte, die Frachtführer- oder Kundenspezifische Anforderungen umsetzen.<br />
<br />
Alle Scripte verwenden den Pegasus Parser, eine Eigenentwicklung der Heidler Strichcode GmbH. Die Scriptsprache basiert&nbsp;auf der Programmiersprache Java, was manche Dinge komplizierter machen kann, dafür aber deutlich mehr Flexibilität und Performance bietet.<br />
<br />
== Scripteditor ==<br />
<br />
Der Scripteditor ist in drei Bereiche unterteilt:<br />
<br />
=== Informationspanel ===<br />
<br />
Das Informationspanel befindet sich links oben. Es zeigt Ihnen alle Informationen an, welche Sie für die Scriptentwicklung benötigen.<br />
<br />
Zunächst wird Ihnen aufgelistet, welche Variablen Sie zur Verfügung haben und welchen Typ (welche Klasse) die Variablen besitzen. Im Tarifwerk erhalten Sie hier meist die Variable shipment, was der aktuellen Sendung entspricht, und eventuell die Variable packageData, was dem aktuellen Packstück entspricht.<br />
<br />
Der Erwartete Rückgabetyp ist der Typ des Wertes, welchen Sie in diesem Script zurückgeben müssen. Im Tarifwerk wird in der Regel nur Boolean (true oder false) oder Double (Gleitkommazahl mit doppelter Präzision) erwartet.<br />
<br />
=== Button-Leiste ===<br />
<br />
Die Button-Leiste befindet sich rechts oben. Sie können damit zusätzliche Anpassungen und Tests vornehmen.<br />
<br />
==== Importe ====<br />
<br />
Der Button Importe öffnet einen Editor, in dem Sie zusätzliche Klassen (Funktionalitäten) zum aktuellen Script hinzufügen können. Über den Button Suchen können Sie die aktuell eingegebene Klasse suchen. Bei Erfolg wird Ihnen diese Klasse in der Liste darüber angezeigt.<br />
<br />
Folgende Klassen und Interfaces sind standardmäßig Importiert und müssen nicht angegeben werden:<br />
<br />
*java.util.Date <br />
*java.text.SimpleDateFormat <br />
*java.util.ArrayList <br />
*java.util.List <br />
*java.util.Map <br />
*java.util.HashMap <br />
<br />
==== Variablen ====<br />
<br />
Der Variableneditor ermöglicht es Ihnen, diverse Testszenarien aufzubauen, indem Sie die Werte der gegebenen Variablen beliebig verändern können. Bei komplexeren Variablen-Typen (wie z.B. Sendung oder Packstück) wird die Variable im JSON-Format angezeigt und editiert. Es gelten die üblichen Regeln für Escape-Zeichen.<br />
<br />
==== Test ====<br />
<br />
Über den Button Test können Sie Ihr aktuelles Script testen. Falls ein Syntaxfehler vorhanden ist, wird Ihnen dieser mit Angabe der Zeile angezeigt. Zusätzlich können Sie, solange das Ergebnisfenster offen ist, die komplette erstellte Klasse im Ordner Tarifwerk\compile\scriptbase einsehen.<br />
<br />
=== Editor ===<br />
<br />
Im Editor können Sie Ihr Script implementieren. Der Editor besitzt einige Features um das Erstellen von Scripten einfacher zu machen:<br />
<br />
*Falls ein Script einzeilig ist und nicht mit einem Semikolon endet benötigen Sie kein return Statement. Dieses wird automatisch hinzugefügt. <br />
*Der Scripteditor besitzt Code-Highlighting um Variablen, Kommentare und Klassen voneinander trennen zu können <br />
*Der Scripteditor besitzt eingeschränkte Code-Vervollständigungs-Features. Diese aktiviert man über die Tastenkombination Strg+Leer <br />
<br />
== Zusatzfunktionen ==<br />
<br />
Der Scripteditor kommt standardmäßig mit einigen zusätzlichen Funktionen. Viele dieser Funktionen entsprechen den Parserausdrücken aus dem HVS32.<br />
<br />
Die Detailbeschreibung und Verwendung können Sie der Code-Vervollständigung (Strg+Leer) entnehmen. Oft verwendete und nützliche Funktionen sind:<br />
<br />
*ATrim: Entfernt alle Leerzeichen am Anfang und Ende des Strings. <br />
*Left: Gibt die ersten n Stellen eines String zurück. <br />
*Right: Gibt die letzten n Stellen eines Strings zurück. <br />
*DEBUG: Zeigt den Wert einer Variable in einer Message Box an. (Bitte niemals ein Script&nbsp;speichern was diese Funktionen enthält) <br />
*DateTimeFormat: Konvertiert einen String in ein Datum. <br />
*FormatDateTime: Konvertiert ein Datum in einen String. <br />
*GetListItem: Extrahiert aus einem String das n-te Element was durch ein Trennzeichen getrennt wurde. <br />
*LeftPad: Füllt einen String links mit der angegebenen Anzahl Stellen und Zeichen auf <br />
<br />
&nbsp;<br />
<br />
== Besonderheiten ==<br />
<br />
Da der Pegasus Parser auf Java basiert, muss man einige Dinge beachten, die in anderen Scriptsprachen (wie z.B. Javascript) nicht üblich sind.<br />
<br />
=== Stringvergleiche ===<br />
<br />
Zahlen werden wie üblich über ein doppeltes == verglichen:<br />
<pre>int a = 5;<br />
if (a == 5) {<br />
....</pre><br />
<br />
Strings können damit leider nicht verglichen werden. Stattdessen muss man die Methode equals() verwenden:<br />
<pre>String a = "test";<br />
if (a.equals("test")) {<br />
...</pre><br />
<br />
Vergleiche ohne Beachtung von Groß- und Kleinschreibung geschehen über die Methode&nbsp;equalsIgnoreCase().<br />
<br />
=== Elemente von Variablen ===<br />
<br />
Elemente von Variablen (wie z.B. die Zieladress-PLZ der Sendung) werden über Getter- und Setter-Methoden gelesen und gesetzt.<br />
<br />
Diese besitzen immer den Prefix "get" bzw. "set" und das nächste Zeichen wird als Großbuchstabe geschrieben. Bei Boolean wird "is" statt "get"&nbsp;verwendet. Beispiele:<br />
<pre>shipment.getReceiverZipcode()<br />
shipment.getShipmentWeight()<br />
shipment.isIsle()<br />
packageData.getPackageType()</pre><br />
<br />
=== Direktes definieren von Nicht-int Zahlen. ===<br />
<br />
Wenn Sie einen double, float oder long direkt im Quelltext definieren wollen, benötigen diese nach der Zahl einen entsprechenden&nbsp;Suffix:<br />
<pre>double d = 4.3d;<br />
float f = 5.4f;<br />
long l = 200000l;</pre><br />
<br />
== Beispielscripte ==<br />
<br />
=== Prüfen auf Inselzustellung ===<br />
<pre>shipment.isIsle()</pre><br />
<br />
Es wird die entsprechende Inseltabelle für den jeweiligen Frachtführer benötigt.<br />
<br />
=== Auf bestimmte Länder prüfen ===<br />
<pre>final List<String> zielLaender = java.util.Arrays.asList("DE", "CH", "AT");<br />
return zielLaender.contains(shipment.getReceiverCountry());</pre><br />
<br />
Die Elemente DE, CH, AT müssen durch die gewünschten Länder im ISO2 Format ersetzt werden.<br />
<br />
=== Auf bestimmte Versandart prüfen ===<br />
<pre>shipment.getServiceType().equals("VID")</pre><br />
<br />
Die Versandart ID "VID" muss durch die Gewünschte ersetzt werden. Falls mehrere Versandarten in Frage kommen, kann man auch hier eine Liste wie im Beispiel darüber erstellen.<br />
<br />
=== Nachnahme-Sendung ===<br />
<pre>shipment.getCodAmount() > 0d</pre><br />
<br />
=== Verpackungsart prüfen ===<br />
<pre>packageData.getPackageType().equals("KT")</pre><br />
<br />
Die Verpackungsart sollte meist auch nur mit Packstück-Tarifwerken und -Zuschlägen definiert werden.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Script_(Tarifwerk)&diff=6003Script (Tarifwerk)2024-10-18T14:06:59Z<p>Ddang: </p>
<hr />
<div>[[en:Script (Tarifwerk) (en)]]<br />
<br />
[[File:TW Script Editor.png|frameless|right|super|475x413px|TW Script Editor.png]]Scripte bilden die zentrale Stelle im Tarifwerk um Regeln für [[Zuschlag_(Tarifwerk)|Zuschläge]] und [[Tarifwerk_(Tarifwerk_/_Stammdaten)|Tarifwerke]] aufzubauen. Dies&nbsp;können simple Abfragen sein, wie z.B. prüfen, ob es sich um eine Inselzustellung handelt, oder aber komplexe Konstrukte, die Frachtführer- oder Kundenspezifische Anforderungen umsetzen.<br />
<br />
Alle Scripte verwenden den Pegasus Parser, eine Eigenentwicklung der Heidler Strichcode GmbH. Die Scriptsprache basiert&nbsp;auf der Programmiersprache Java, was manche Dinge komplizierter machen kann, dafür aber deutlich mehr Flexibilität und Performance bietet.<br />
<br />
== Scripteditor ==<br />
<br />
Der Scripteditor ist in drei Bereiche unterteilt:<br />
<br />
=== Informationspanel ===<br />
<br />
Das Informationspanel befindet sich links oben. Es zeigt Ihnen alle Informationen an, welche Sie für die Scriptentwicklung benötigen.<br />
<br />
Zunächst wird Ihnen aufgelistet, welche Variablen Sie zur Verfügung haben und welchen Typ (welche Klasse) die Variablen besitzen. Im Tarifwerk erhalten Sie hier meist die Variable shipment, was der aktuellen Sendung entspricht, und eventuell die Variable packageData, was dem aktuellen Packstück entspricht.<br />
<br />
Der Erwartete Rückgabetyp ist der Typ des Wertes, welchen Sie in diesem Script zurückgeben müssen. Im Tarifwerk wird in der Regel nur Boolean (true oder false) oder Double (Gleitkommazahl mit doppelter Präzision) erwartet.<br />
<br />
=== Button-Leiste ===<br />
<br />
Die Button-Leiste befindet sich rechts oben. Sie können damit zusätzliche Anpassungen und Tests vornehmen.<br />
<br />
==== Importe ====<br />
<br />
Der Button Importe öffnet einen Editor, in dem Sie zusätzliche Klassen (Funktionalitäten) zum aktuellen Script hinzufügen können. Über den Button Suchen können Sie die aktuell eingegebene Klasse suchen. Bei Erfolg wird Ihnen diese Klasse in der Liste darüber angezeigt.<br />
<br />
Folgende Klassen und Interfaces sind standardmäßig Importiert und müssen nicht angegeben werden:<br />
<br />
*java.util.Date <br />
*java.text.SimpleDateFormat <br />
*java.util.ArrayList <br />
*java.util.List <br />
*java.util.Map <br />
*java.util.HashMap <br />
<br />
==== Variablen ====<br />
<br />
Der Variableneditor ermöglicht es Ihnen, diverse Testszenarien aufzubauen, indem Sie die Werte der gegebenen Variablen beliebig verändern können. Bei komplexeren Variablen-Typen (wie z.B. Sendung oder Packstück) wird die Variable im JSON-Format angezeigt und editiert. Es gelten die üblichen Regeln für Escape-Zeichen.<br />
<br />
==== Test ====<br />
<br />
Über den Button Test können Sie Ihr aktuelles Script testen. Falls ein Syntaxfehler vorhanden ist, wird Ihnen dieser mit Angabe der Zeile angezeigt. Zusätzlich können Sie, solange das Ergebnisfenster offen ist, die komplette erstellte Klasse im Ordner Tarifwerk\compile\scriptbase einsehen.<br />
<br />
=== Editor ===<br />
<br />
Im Editor können Sie Ihr Script implementieren. Der Editor besitzt einige Features um das Erstellen von Scripten einfacher zu machen:<br />
<br />
*Falls ein Script einzeilig ist und nicht mit einem Semikolon endet benötigen Sie kein return Statement. Dieses wird automatisch hinzugefügt. <br />
*Der Scripteditor besitzt Code-Highlighting um Variablen, Kommentare und Klassen voneinander trennen zu können <br />
*Der Scripteditor besitzt eingeschränkte Code-Vervollständigungs-Features. Diese aktiviert man über die Tastenkombination Strg+Leer <br />
<br />
== Zusatzfunktionen ==<br />
<br />
Der Scripteditor kommt standardmäßig mit einigen zusätzlichen Funktionen. Viele dieser Funktionen entsprechen den Parserausdrücken aus dem HVS32.<br />
<br />
Die Detailbeschreibung und Verwendung können Sie der Code-Vervollständigung (Strg+Leer) entnehmen. Oft verwendete und nützliche Funktionen sind:<br />
<br />
*ATrim: Entfernt alle Leerzeichen am Anfang und Ende des Strings. <br />
*Left: Gibt die ersten n Stellen eines String zurück. <br />
*Right: Gibt die letzten n Stellen eines Strings zurück. <br />
*DEBUG: Zeigt den Wert einer Variable in einer Message Box an. (Bitte niemals ein Script&nbsp;speichern was diese Funktionen enthält) <br />
*DateTimeFormat: Konvertiert einen String in ein Datum. <br />
*FormatDateTime: Konvertiert ein Datum in einen String. <br />
*GetListItem: Extrahiert aus einem String das n-te Element was durch ein Trennzeichen getrennt wurde. <br />
*LeftPad: Füllt einen String links mit der angegebenen Anzahl Stellen und Zeichen auf <br />
<br />
&nbsp;<br />
<br />
== Besonderheiten ==<br />
<br />
Da der Pegasus Parser auf Java basiert, muss man einige Dinge beachten, die in anderen Scriptsprachen (wie z.B. Javascript) nicht üblich sind.<br />
<br />
=== Stringvergleiche ===<br />
<br />
Zahlen werden wie üblich über ein doppeltes == verglichen:<br />
<pre>int a = 5;<br />
if (a == 5) {<br />
....</pre><br />
<br />
Strings können damit leider nicht verglichen werden. Stattdessen muss man die Methode equals() verwenden:<br />
<pre>String a = "test";<br />
if (a.equals("test")) {<br />
...</pre><br />
<br />
Vergleiche ohne Beachtung von Groß- und Kleinschreibung geschehen über die Methode&nbsp;equalsIgnoreCase().<br />
<br />
=== Elemente von Variablen ===<br />
<br />
Elemente von Variablen (wie z.B. die Zieladress-PLZ der Sendung) werden über Getter- und Setter-Methoden gelesen und gesetzt.<br />
<br />
Diese besitzen immer den Prefix "get" bzw. "set" und das nächste Zeichen wird als Großbuchstabe geschrieben. Bei Boolean wird "is" statt "get"&nbsp;verwendet. Beispiele:<br />
<pre>shipment.getReceiverZipcode()<br />
shipment.getShipmentWeight()<br />
shipment.isIsle()<br />
packageData.getPackageType()</pre><br />
<br />
=== Direktes definieren von Nicht-int Zahlen. ===<br />
<br />
Wenn Sie einen double, float oder long direkt im Quelltext definieren wollen, benötigen diese nach der Zahl einen entsprechenden&nbsp;Suffix:<br />
<pre>double d = 4.3d;<br />
float f = 5.4f;<br />
long l = 200000l;</pre><br />
<br />
== Beispielscripte ==<br />
<br />
=== Prüfen auf Inselzustellung ===<br />
<pre>shipment.isIsle()</pre><br />
<br />
Es wird die entsprechende Inseltabelle für den jeweiligen Frachtführer benötigt.<br />
<br />
=== Auf bestimmte Länder prüfen ===<br />
<pre>final List<String> zielLaender = java.util.Arrays.asList("DE", "CH", "AT");<br />
return zielLaender.contains(shipment.getReceiverCountry());</pre><br />
<br />
Die Elemente DE, CH, AT müssen durch die gewünschten Länder im ISO2 Format ersetzt werden.<br />
<br />
=== Auf bestimmte Versandart prüfen ===<br />
<pre>shipment.getServiceType().equals("VID")</pre><br />
<br />
Die Versandart ID "VID" muss durch die Gewünschte ersetzt werden. Falls mehrere Versandarten in Frage kommen, kann man auch hier eine Liste wie im Beispiel darüber erstellen.<br />
<br />
=== Nachnahme-Sendung ===<br />
<pre>shipment.getCodAmount() > 0d</pre><br />
<br />
=== Verpackungsart prüfen ===<br />
<pre>packageData.getPackageType().equals("KT")</pre><br />
<br />
Die Verpackungsart sollte meist auch nur mit Packstück-Tarifwerken und -Zuschlägen definiert werden.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Setup:_Versand-Stammdaten&diff=5943Setup: Versand-Stammdaten2024-09-25T11:36:43Z<p>Ddang: </p>
<hr />
<div>[[en:Setup:_dispatch_master_data]]<br />
'''<u>Menüpunkt: Setup > Versandstammdaten bearbeiten</u>'''<br />
<br />
In diesem Schirm haben Sie direkten Zugriff auf die internen Daten des Versandsystems.<br />
<br />
= ACHTUNG: =<br />
<br />
[[File:Gefahr.jpg|left|Gefahr.jpg]]<br />
<br />
Solange das Fenster für Versand-Stammdaten geöffnet ist, wird das Automatik-Polling angehalten, sodass keine Sendungen verarbeitet werden können.<br />
<br />
Änderungen an den Stammdaten haben ohne Sicherheitsprüfung direkte Auswirkungen auf das Programmverhalten und die Lizenzierung des Heidler-Versandsystems.<br />
<br />
Bitte nehmen Sie Änderungen nur nach Absprache mit dem Heidler Support-Team vor oder mithilfe der Wiki Anleitung, welche Sie in manchen Menüpunkten vorfinden werden.<br />
<br />
Nicht authorisierte Änderungen können die sofortige Annulierung Ihrer Lizenz zur Folge haben! Das Heidler-Versandsystem ist dann nur noch im Demo-Modus nutzbar und muss durch das Heidler Support-Team erneut lizenziert werden!<br />
<br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
<br />
== Bedienung ==<br />
<br />
Auf der linken Seite finden Sie eine Liste der verfügbaren Einstellungen. Wählen Sie den gewünschten Bereich mittels Doppelklick aus, er erscheint dann auf der rechten Seite.<br />
<br />
== Besondere Bereiche ==<br />
<br />
=== Auftraggeber ===<br />
<br />
Unter diesem Punkt können Sie die Auftraggeber editieren, aber bitte ändern Sie hier nur nach Aufforderung des Heidler-Supports etwas da diese Daten direkt in die Lizenz einbezogen sind.<br />
<br />
=== Versandarten ===<br />
<br />
Hier werden die später verfügbaren Versandarten eingerichtet.&nbsp;<br />
<br />
Weiterführende Dokumentation: [[Versand-Stammdaten: Versandarten]]<br />
<br />
=== Frankaturen ===<br />
<br />
Incoterms/Frankaturen können in detaillierter Ansicht an dieser Stelle bearbeitet werden.&nbsp;<br />
<br />
Weiterführende Dokumentation: [[Index.php?title=Versand-Stammdaten: Frankaturen|Versand-Stammdaten: Frankaturen]]<br />
<br />
=== Systemkonfiguration ===<br />
<br />
Unter diesem Bereich befinden sie verschiedene Möglichkeiten mit denen das Verhalten von HVS gesteuert werden kann.<br />
<br />
Ähnlich wie eine INI-Datei ist dieser Bereich in verschiedene Sektionen aufgeteilt die unabhängig eingestellt werden können.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Setup:_Systeminfo_(HVS32)&diff=5942Setup: Systeminfo (HVS32)2024-09-25T11:35:49Z<p>Ddang: </p>
<hr />
<div>[[en:Setup:_systeminfo_(_HVS32_EN_)]]<br />
'''Menüpunkt: Setup > Systeminfo (HVS32)'''<br />
[[Datei:Setup-Systeminfo(HVS32).png|alternativtext=Setup-Systeminfo(HVS32)|ohne|mini|Setup-Systeminfo(HVS32)]]<br />
<br />
<br />
Die Systeminfo erzeugt eine TXT-Datei, welche im Ordner '''...\Heidler\HVS32\Systeminfo\SYSTEMINFO_2022_01_01_XXXX.txt''' gespeichert wird. Diese Datei dient dem Heidler Support-Team als Information über den aktuellen Stand Ihres HVS32 Systems.<br />
<br />
= Inhalt =<br />
<br />
Die Systeminfo beinhaltet Informationen wie zum Beispiel:<br />
<br />
*HVS32 Version <br />
*Lizenzen <br />
*Autraggeber <br />
*Packplätze <br />
*Drucker Einstellungen <br />
*Frachtführer Einstellungen</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Setup:_systeminfo_(_HVS32_EN_)&diff=5941Setup: systeminfo ( HVS32 EN )2024-09-25T11:35:35Z<p>Ddang: </p>
<hr />
<div>[[de:Setup:_Systeminfo_(HVS32)]]<br />
'''menu: setup > systeminfo (HVS32)'''<br><br><br />
This option will generate a so called "Systeminfo" text file in the folder ...\HVS32\Systeminfo\xxx.txt <br><br />
This File contains complete information about the settings of your HVS32 Installation and helps the Heidler Support Team in case of support requests.<br />
<br />
= Content of a Systeminfo =<br />
<br />
The Systeminfo contains information like:<br />
<br />
*HVS32 Version Number<br />
*active licences <br />
*Mandators/Clients <br />
*Packaging places/workstations <br />
*printer settings <br />
*carrier configuration</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Setup:_Individuelle_Einstellungen_und_Daten&diff=5940Setup: Individuelle Einstellungen und Daten2024-09-25T10:48:59Z<p>Ddang: </p>
<hr />
<div>[[en:Setup:_individual_settings_and_data]]<br />
In dieser Maske können Sie Ihre individuellen Einstellungen und Ihre Datenbank in einer ZIP absichern. Diese werden im Ordner&nbsp;HVS32\Individuell XX:XX:XX_.zip gespeichert und helfen dem Heidler-Support eventuelle Probleme zu lokalisieren und zu beheben..[[File:IndividuelleEinstellungen sichern.PNG|right|400x350px|IndividuelleEinstellungen sichern.PNG]]<br />
<br />
= Individuelle Einstellungen =<br />
<br />
Bei den individuellen Einstellungen handelt es sich um folgende Dateien, welche abgelegt werden:<br />
<br />
*Individuell angepasste Labelvorlagen und Listen <br />
<br />
*Import- und Export Einstellungen <br />
<br />
&nbsp;<br />
<br />
= Speichern =<br />
<br />
=== Systeminformation einschließen ===<br />
<br />
:Sie haben hier noch die Möglichkeit [[Setup:_Systeminfo_(HVS32)|eine aktuelle Systeminfo]] von Ihrem HVS32 zu erzeugen und der ZIP beizulegen. Diese wird in den meisten Fällen von unserem Support benötigt, um Ihre HVS32 Einstellungen prüfen zu können. <br />
<br />
&nbsp;<br />
<br />
=== Komplette Datenbank einschließen ===<br />
<br />
:Mit dieser Option können Sie Ihre HVS32 Datenbank mit absichern. Diese Aktion beansprucht mehrere Minuten, je nachdem wie groß Ihre Datenbank ist. <br />
:Bitte wählen Sie diese Option nur an wenn Sie explizit dazu aufgefordert werden. <br />
<br />
=== Einstellungen via FTP an Heidler übertragen ===<br />
<br />
:Sie können Ihre individuellen Einstellungen auch direkt an unsere FTP Server übertragen. Diese Option ist im normalfall nur notwendig, wenn der Support von Ihnen die individuellen Einstellungen + Datenbank anfordert. Dies setzt die Möglichkeit des FTP Versands an den Heidler FTP Server voraus. <br />
<br />
=== ZIP-Archiv verschlüsseln? ===<br />
<br />
:Hier können Sie die ZIP Datei mit einem Passwort sichern um sie gegen unbefugtes Öffnen zu sichern. Ein Vorschlag wird aus Ihrem Firmennamen erzeugt. Wenn Sie diese Funktion verwenden&nbsp;teilen Sie das Passwort bitte dem Heidler-Support mit. <br />
<br />
= Laden =<br />
<br />
[[File:IndividuelleEinstellungen laden.PNG|right|350x300px|IndividuelleEinstellungen laden.PNG]] '''ACHTUNG!''' Diese Funktion dient nur zur Ersteinrichtung und darf nicht im bestehenden Produktivsystem verwendet werden!<br />
<br />
Mit der Laden Funktion können Sie eine bereits erzeugte ZIP in Ihr HVS32 System importieren und den Stand der individuellen Einstellungen auf den Zeitpunkt der Sicherung zurücksetzen.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Setup:_Individuelle_Einstellungen_und_Daten&diff=5939Setup: Individuelle Einstellungen und Daten2024-09-25T10:48:45Z<p>Ddang: </p>
<hr />
<div>[[EN.Setup:_individual_settings_and_data]]<br />
In dieser Maske können Sie Ihre individuellen Einstellungen und Ihre Datenbank in einer ZIP absichern. Diese werden im Ordner&nbsp;HVS32\Individuell XX:XX:XX_.zip gespeichert und helfen dem Heidler-Support eventuelle Probleme zu lokalisieren und zu beheben..[[File:IndividuelleEinstellungen sichern.PNG|right|400x350px|IndividuelleEinstellungen sichern.PNG]]<br />
<br />
= Individuelle Einstellungen =<br />
<br />
Bei den individuellen Einstellungen handelt es sich um folgende Dateien, welche abgelegt werden:<br />
<br />
*Individuell angepasste Labelvorlagen und Listen <br />
<br />
*Import- und Export Einstellungen <br />
<br />
&nbsp;<br />
<br />
= Speichern =<br />
<br />
=== Systeminformation einschließen ===<br />
<br />
:Sie haben hier noch die Möglichkeit [[Setup:_Systeminfo_(HVS32)|eine aktuelle Systeminfo]] von Ihrem HVS32 zu erzeugen und der ZIP beizulegen. Diese wird in den meisten Fällen von unserem Support benötigt, um Ihre HVS32 Einstellungen prüfen zu können. <br />
<br />
&nbsp;<br />
<br />
=== Komplette Datenbank einschließen ===<br />
<br />
:Mit dieser Option können Sie Ihre HVS32 Datenbank mit absichern. Diese Aktion beansprucht mehrere Minuten, je nachdem wie groß Ihre Datenbank ist. <br />
:Bitte wählen Sie diese Option nur an wenn Sie explizit dazu aufgefordert werden. <br />
<br />
=== Einstellungen via FTP an Heidler übertragen ===<br />
<br />
:Sie können Ihre individuellen Einstellungen auch direkt an unsere FTP Server übertragen. Diese Option ist im normalfall nur notwendig, wenn der Support von Ihnen die individuellen Einstellungen + Datenbank anfordert. Dies setzt die Möglichkeit des FTP Versands an den Heidler FTP Server voraus. <br />
<br />
=== ZIP-Archiv verschlüsseln? ===<br />
<br />
:Hier können Sie die ZIP Datei mit einem Passwort sichern um sie gegen unbefugtes Öffnen zu sichern. Ein Vorschlag wird aus Ihrem Firmennamen erzeugt. Wenn Sie diese Funktion verwenden&nbsp;teilen Sie das Passwort bitte dem Heidler-Support mit. <br />
<br />
= Laden =<br />
<br />
[[File:IndividuelleEinstellungen laden.PNG|right|350x300px|IndividuelleEinstellungen laden.PNG]] '''ACHTUNG!''' Diese Funktion dient nur zur Ersteinrichtung und darf nicht im bestehenden Produktivsystem verwendet werden!<br />
<br />
Mit der Laden Funktion können Sie eine bereits erzeugte ZIP in Ihr HVS32 System importieren und den Stand der individuellen Einstellungen auf den Zeitpunkt der Sicherung zurücksetzen.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Setup:_individual_settings_and_data&diff=5938Setup: individual settings and data2024-09-25T10:48:28Z<p>Ddang: </p>
<hr />
<div>[[de:Setup:_Individuelle_Einstellungen_und_Daten]]<br />
In "individual settings and data" you can zip your individual settings. The zip will be saved in the folder&nbsp;HVS32\Individuell XX:XX:XX_.zip to help the Heidler-support in case your system has any problems. <br />
..[[File:individuelledaten.PNG|right|400x350px|individuelledaten.PNG]]<br />
<br />
= individual settings" =<br />
<br />
Bei den individuellen Einstellungen handelt es sich um folgende Dateien, welche abgelegt werden:<br />
The files that are affected by individual settings are the following:<br />
<br />
*individual list and labels <br />
<br />
*import- and export settings<br />
&nbsp;<br />
<br />
= save =<br />
<br />
=== add system information ===<br />
<br />
:you have the possibility to create [[setup:_systeminfo_( HVS32_EN )|a system info (HVS32)]] from your HVS32 which will be saved in the zip. The system information will be used most of the time by our support, to analyse your settings.<br />
<br />
&nbsp;<br />
<br />
=== add complete database ===<br />
<br />
:with this option you can safe your HVS32 database. This will take a couple minutes, depending on how big your database is.<br />
:Please do only select this option if our colleagues ask you to do it.<br />
<br />
=== encrypt zip with password? ===<br />
<br />
:with this option you can encrypt the zip with a password to protect it against unauthorized access. The HVS32 makes you a suggestion with your company name. If you use this function please&nbsp; please share the passwod with the Heidler-support.<br />
<br />
= load =<br />
<br />
[[File:load.PNG|right|350x300px|load.PNG]] '''WARNING!''' This option is only for initial setup and should not be used in your productive system!<br />
<br />
With the load function you can import an old zip into your HVS32 to reset your individual setting to the moment where the zip was created.<br />
9o</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Setup:_gateway_settings_and_data&diff=5937Setup: gateway settings and data2024-09-25T10:47:34Z<p>Ddang: </p>
<hr />
<div>[[de:Setup:_Gateway_Einstellungen_und_Daten]]<br />
With the menu "Gateway settings and data" you have the possibility to import or export your [[Setup:_Gateway-Exportfunktionsdefinition|gateway settings]].<br />
<br />
[[File:Setup gateway import export en.png|right|Setup gateway import export.PNG]]<br />
<br />
<br />
= Load gateway data =<br />
<br />
You can import your gateway settings in to the HVS32.<br />
<br />
= Extract gateway data =<br />
<br />
You can export your current gateway settings. It will be saved you settings and also the import / export-mapping from your gateway.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Setup:_Gateway_Einstellungen_und_Daten&diff=5936Setup: Gateway Einstellungen und Daten2024-09-25T10:47:26Z<p>Ddang: </p>
<hr />
<div>[[en:Setup:_gateway_settings_and_data]]<br />
Mit Gateway Einstellungen und Daten haben Sie die Möglichkeit Ihre [[Setup:_Gateway-Exportfunktionsdefinition|Gateway Einstellungen]] zu exportieren und zu importieren.<br />
<br />
[[File:Setup gateway import export.PNG|right|Setup gateway import export.PNG]]<br />
<br />
= Gateway-Daten Importieren =<br />
<br />
Hiermit können Sie Ihre Gateway-Daten ins HVS32 importieren.<br />
<br />
= Gateway-Daten Exportieren =<br />
<br />
Hiermit können Sie Ihre Gateway-Daten vom HVS32 exportieren. Exportiert werden sowohl Einstellungen, als auch Import- und Exportmapping</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Setup:_gateway_settings_and_data&diff=5935Setup: gateway settings and data2024-09-25T10:47:12Z<p>Ddang: </p>
<hr />
<div>[[de:Setup:_Gateway_Einstellungen_und_Daten]]<br />
<br />
With the menu "Gateway settings and data" you have the possibility to import or export your [[Setup:_Gateway-Exportfunktionsdefinition|gateway settings]].<br />
<br />
[[File:Setup gateway import export en.png|right|Setup gateway import export.PNG]]<br />
<br />
<br />
= Load gateway data =<br />
<br />
You can import your gateway settings in to the HVS32.<br />
<br />
= Extract gateway data =<br />
<br />
You can export your current gateway settings. It will be saved you settings and also the import / export-mapping from your gateway.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Setup:_Gateway_Einstellungen_und_Daten&diff=5934Setup: Gateway Einstellungen und Daten2024-09-25T10:46:54Z<p>Ddang: </p>
<hr />
<div>[[en:Setup:_gateway_settings_and_data]]<br />
<br />
Mit Gateway Einstellungen und Daten haben Sie die Möglichkeit Ihre [[Setup:_Gateway-Exportfunktionsdefinition|Gateway Einstellungen]] zu exportieren und zu importieren.<br />
<br />
[[File:Setup gateway import export.PNG|right|Setup gateway import export.PNG]]<br />
<br />
= Gateway-Daten Importieren =<br />
<br />
Hiermit können Sie Ihre Gateway-Daten ins HVS32 importieren.<br />
<br />
= Gateway-Daten Exportieren =<br />
<br />
Hiermit können Sie Ihre Gateway-Daten vom HVS32 exportieren. Exportiert werden sowohl Einstellungen, als auch Import- und Exportmapping</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Setup:_Benutzerverwaltung&diff=5933Setup: Benutzerverwaltung2024-09-25T10:46:10Z<p>Ddang: </p>
<hr />
<div>[[en:Setup:_user_administration]]<br />
<br />
Funktionen des Erweiterungsmodules "Benutzerverwaltung":<br />
-Anlage eigener HVS32 Benutzer<br />
-Änderung der Standardpasswörter<br />
-Anpassung der Benutzerlevel<br />
-individuelle Rechtevergabe pro HVS32 Benutzer<br />
<br />
<br />
<br />
Die Benutzerverwaltung ist ein kostenpflichtiges Erweiterungsmodul und ist erst nach bestellter Lizenzierung unter folgendem Menüpunkt erreichbar:<br />
<br />
Setup > Benutzerverwaltung<br />
<br />
In der HVS32 Benutzerverwaltung gibt es bereits vier angelegte Standard Benutzer. Jeder dieser User hat unterschiedliche Rechte innerhalb des HVS32.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Benutzer !! Standard Passwort !! Benutzerlevel !! verwendete Lizenzart !! Etikettendruck möglich<br />
|-<br />
| auskunft || auskunft || 0 || Auskunft || Nein<br />
|-<br />
| versand || ... || 1 || Workstation || Ja<br />
|-<br />
| vleiter || ... || 2 || Workstation || Ja<br />
|-<br />
| vadmin || ... || 3 || Workstation || Ja<br />
<br />
|}<br />
<br />
Die Benutzerlevels gehen von 0 ( am wenigsten Rechte ) bis Level 3 ( am meisten Rechte ). Die Lizenzart ist die benötigte Lizenz im HVS32. Für Level Null ist eine Auskunfts-Lizenz ausreichend, mit welcher aber keine Versandetiketten gedruckt werden können, sondern das HVS32 lediglich mit den Auskunftsmenüpunkten genutzt werden kann.<br />
Mit Level 1 – 3, können Versandetiketten gedruckt werden und Sie benötigen dafür eine HVS32 Workstation – Lizenz. Je nach Benutzerlevel, kann der User im HVS32 mehr oder weniger im HVS32 durchführen.<br />
Die vordefinierten Benutzerlevel (und damit verfügbaren Funktionen) können als Vorlage verwendet werden um dann einzelne Menüpunkte einem Benutzer zuzuweisen oder zu entfernen.<br />
<br />
<br />
[[Datei:Benutzerverwaltung2.png|rahmenlos|links]]<br />
<br />
Hier im Beispiel, wurde ein User „test“ angelegt und mit dem Benutzerlevel 1 versehen. Also dem Standardprofil von „versand“ der am wenigsten Rechte hat, aber trotzdem Drucken kann. Auf der Linken Seite „Module und Optionen“, können Sie dem angelegten User entweder Menüpunkte zuordnen ( von links nach rechts ) oder dem Benutzer Menüpunkte und Funktionen entfernen ( von rechts nach links ).</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Processing:_action_from_file&diff=5932Processing: action from file2024-09-25T10:33:16Z<p>Ddang: </p>
<hr />
<div>[[de:Verarbeitung:_Aktion_aus_Datei]]<br />
'''Menu: Processing > Action from file'''<br />
<br />
[[File:Normal_mask_action_from_file.PNG|right|700px|NormaleMaske AktionAusDatei.PNG]]Similar to the&nbsp;[[Processing:_Automatik-Polling|Datei Automatik-Polling]], you can read a file and create a label per sentence.<br />
<br />
With the help of the HVS32 extension module "action from file", complete files can be processed with address data. The appropriate file will be selected in the given ASCII or CSV format. After that it needs to be determined which package - weight / fee is valid for this action. Up to 4 different package weights / fees per sentence can be determined. The default settings for the client (sender address) will be displayed. If several clients are deposited, it can be manually selected for this action. If a neutr. sender address is selected, it will be displayed on the shipping label. A different sorting of the shipping labels that need to be printed is also configurable, if several package-pieces have been defined for this action: Sort by address (all shipping labels per address will be printed one after the other) or sort by package-pieces (all shipping labels of the respective package-piece will be printed one after the other). The processing can be halted with the pause-switch. The stop-switch interrupts the processing. This action processing can be restarted on a later time for the continued processing. Each interrupted processing receives a defined action name. If several actions get interrupted, an action name can be chosen for the continued processing. On the display field system-errorscreen unexpected processing errors created by the system will be displayed, for instance: no network connection etc..<br />
<br />
= Import file =<br />
<br />
Enter the path+file name (for example: C:\HVS32\Testdaten\Polling.txt) or open the explorer with a click on the button to the right of the input field to search for the desired file.<br />
<br />
= Action name =<br />
<br />
Here you assign a name for the action which will later be displayed under details in the information.<br />
<br />
The button next to the input field, marked by an arrow, opens a window in which you can select the so far applied action names.<br />
<br />
= Package-pieces data =<br />
<br />
You can send up to 4 package-pieces per recipient. Here you enter the corresponding parameters for each package-piece.<br />
<br />
=== Package-piece #1-4 ===<br />
<br />
*Weight<br />
<br />
:Enter the weight for the respective package-piece. This input is a required field. <br />
<br />
*Fee<br />
<br />
:The fee of the package-piece. This input is optional.<br />
<br />
*Description<br />
<br />
:The description is optional as well, but it can be indicated here if needed.<br />
<br />
= Neutr. sender address =<br />
<br />
Here you can use other sender addresses which do not correspond with the address of the client. You can create these under [[Dispatch_data:_Neutral_Sender_Adress|neutr. sender adresses]] or directly in the displayed mask.<br />
<br />
You can now select the desired address. With a click on Continue, the address will be taken over.<br />
<br />
= Client =<br />
<br />
Here you can choose which client should be used. Under&nbsp;[https://wiki.heidler-strichcode.de/w/index.php?title=Configurator:_client/sender client/sender], you can create, edit and delete the client.<br />
<br />
The client is later important for the&nbsp;[https://wiki.heidler-strichcode.de/w/index.php?title=Setup:_configurator carrier], because the client contains specific settings, for example: customer number, number range etc..<br />
<br />
= Dispatch type =<br />
<br />
Here you select the [[Setup:_configurator|carrier]] and the desired dispatch type, with which you want to ship.<br />
<br />
= Sender address =<br />
<br />
This is a display field which mainly serves as a check for your inputs.<br />
<br />
The address of the selected client will be displayed here or, if selected, the address of the neutral sender.<br />
<br />
The address in this field is the address which you will find on the printed label.<br />
<br />
= Label printing-sequence =<br />
<br />
Choose the order in which the labels should be printed.<br />
<br />
=== sentence by sentence ===<br />
<br />
:One label gets printed per data set.<br />
<br />
=== Pakettyp-weise ===<br />
<br />
:All labels will be printed first per package type. In this case, all 1. packages will be printed, then all 2. packages and so on.<br />
<br />
= Start =<br />
<br />
[[File:Verarbeitungsmaske AktionAusDatei.PNG|right|700px|Verarbeitungsmaske AktionAusDatei.PNG]] By pressing this button you start the processing.<br />
<br />
=== Processing-status ===<br />
<br />
:In this window the current status of the processing will get displayed.<br />
<br />
=== Loading process ===<br />
<br />
:The data set number shows how many data records were loaded from the file.<br />
<br />
=== Label printing ===<br />
<br />
*Action label<br />
<br />
:Shows how many labels were printed so far.<br />
<br />
*Error labels<br />
<br />
:Shows how many labels could not be printed due to errors.<br />
<br />
=== System reports ===<br />
<br />
:The system reports serve as a protocoll, for example, when was the start or finish of a processing.<br />
<br />
=== Data records ===<br />
<br />
:Here the information to the current processed data set will get displayed.<br />
<br />
*Delivery note number<br />
<br />
:Here the delivery note number will get displayed.<br />
<br />
*Destination address<br />
<br />
:Here the target address will get displayed.<br />
<br />
*Created tracking number<br />
<br />
:The tracking number to the shipment will get displayed.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Postal_Code_Formats&diff=5931Postal Code Formats2024-09-25T10:31:25Z<p>Ddang: </p>
<hr />
<div>[[de:Postleitzahlenformate]]<br />
"Below you will find a list of possible postal code formats in HVS32. These are crucial for the error message 'Postal code format is not correct,' or similar.<br />
<br />
Postal Code Country Formats:<br />
(Meaning of format identifiers: N=Digit, A=Digit or uppercase letter, L=Uppercase letter)<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
5 digits numeric ="NNNNN"<br />
<br />
"DE" <br />
"BA" <br />
"EE" <br />
"ES" <br />
"FI" <br />
"FR" <br />
"FM" <br />
"HR"<br />
"ID" <br />
"IL" <br />
"IT" <br />
"LK" <br />
"MC" <br />
"MH" <br />
"MQ" <br />
"MX" <br />
"MY" <br />
"NP" <br />
"PK" <br />
"PW" <br />
"RE" <br />
"SA" <br />
"SM" <br />
"TH" <br />
"TR" <br />
"TW" <br />
"UA" <br />
"UY" <br />
"VN" <br />
"YU"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
4 digits numeric ="NNNN"<br />
<br />
<br />
"AR"<br />
"AT"<br />
"AU"<br />
"BD"<br />
"BE"<br />
"BG"<br />
"CH"<br />
"CY"<br />
"DK"<br />
"FO"<br />
"GL"<br />
"HU"<br />
"LV"<br />
"LI"<br />
"LU"<br />
"MK"<br />
"MD"<br />
"NO"<br />
"PH"<br />
"SI"<br />
"ZA"<br />
For the following country codes, the postal code format is expected as follows:<br />
6 digits numeric ="NNNNNN"<br />
<br />
"AM"<br />
"AZ"<br />
"BY"<br />
"CN"<br />
"GE"<br />
"KG"<br />
"KZ"<br />
"MN"<br />
"RU"<br />
"SG"<br />
"TJ"<br />
"TM"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
3 digits numeric ="NNN"<br />
<br />
"IC"<br />
"MG"<br />
"VA"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
2 digits numeric ="NN"<br />
<br />
"BN"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
5 digits numeric or "NNNNN-NNNN"<br />
<br />
<br />
"US"<br />
"PR"<br />
"VI"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
6 digits numeric or "AAA AAA"<br />
<br />
"CA"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
7 digits numeric ="NNN-NNNN"<br />
<br />
"JP"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
3 digits numeric or "NNN-NNN"<br />
<br />
"KR"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
8 digits numeric or 'NNNNN NNN' or 'NNNNN-NNN'<br />
<br />
"BR"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
5 digits numeric or 'NNN NN'<br />
<br />
<br />
"CZ"<br />
"GR"<br />
"SE"<br />
"SG"<br />
"SK"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
4 digits numeric or 'NNNN LL' or 'NNNNLL'<br />
<br />
"NL"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
'AA AAA' or 'AAA AAA' or 'AAAA AAA' or 'AAAAA' or 'AAAAAA' or 'AAAAAAA'<br />
<br />
"GB"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
6 digits numeric or 'NNN NNN'<br />
<br />
"IN"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
5 digits numeric or 'NN-NNN'<br />
<br />
"PL"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
4 digits numeric or 7 digits numeric or 'NNNN-NNN'<br />
<br />
"PT"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
4 digits numeric or 5 digits numeric<br />
<br />
"LT"<br />
<br />
For the following country codes, the postal code format is expected as follows:<br />
4 digits numeric or 5 digits numeric or 6 digits numeric<br />
<br />
"RO"</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Custom_reports&diff=5930Custom reports2024-09-25T09:29:21Z<p>Ddang: </p>
<hr />
<div>[[de:Kundenspezifische_Reports]]<br />
<br />
HVS hat die Möglichkeit an besondere Wünsche angepasste Abfragen durchzuführen. Über den Menüpunkt "Reporte Drucken" erhalten Sie eine Auswahlmaske aller für Ihre Firma erstellten Reporte,<br />
The HVS32 has the possibility for<br />
<br />
[[File:ReportAuswahl.png|Liste der verfügbaren Reporte]]<br />
<br />
Diese Reporte werden auf Anfrage erstellt und nach Aufwand berechnet. Eine Ausgabe ist als Liste oder als Excel-kompatibles Format möglich.<br />
<br />
Wenn Sie eine Datenabfrage erstellen möchten die nicht von den standardisierten Ausgabemöglichkeiten von HVS32 abgedeckt sind wenden Sie sich bitte an Ihren Heidler-Vertriebspartner.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Kundenspezifische_Reports&diff=5929Kundenspezifische Reports2024-09-25T09:29:05Z<p>Ddang: </p>
<hr />
<div>[[en:Custom_reports]]<br />
<br />
HVS hat die Möglichkeit an besondere Wünsche angepasste Abfragen durchzuführen. Über den Menüpunkt "Reporte Drucken" erhalten Sie eine Auswahlmaske aller für Ihre Firma erstellten Reporte,<br />
<br />
[[File:ReportAuswahl.png|Liste der verfügbaren Reporte]]<br />
<br />
Diese Reporte werden auf Anfrage erstellt und nach Aufwand berechnet. Eine Ausgabe ist als Liste oder als Excel-kompatibles Format möglich.<br />
<br />
Wenn Sie eine Datenabfrage erstellen möchten die nicht von den standardisierten Ausgabemöglichkeiten von HVS32 abgedeckt sind wenden Sie sich bitte an Ihren Heidler-Vertriebspartner.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Standard_Datei_Schnittstelle&diff=5928HVS32 Standard Datei Schnittstelle2024-09-25T09:14:11Z<p>Ddang: </p>
<hr />
<div>= Funktionsbeschreibung =<br />
<br />
Die Dateischnittstelle ist sehr flexibel und kann an nahezu alle Eingangsdaten angepasst werden. Es ist möglich mehrere Datensätze in einer Datei zu übergeben, aber auch ein Datensatz pro Datei ist möglich. <br />
In der Regel belegt ein Packstück eine Zeile, eventuell gefolgt von Zusatzinformationen wie Artikeldaten oder Gefahrgutsätzen.<br />
<br><br />
Die einzelnen Felder sind unter [[HVS32_File_Schnittstelle_(Automatik-Polling)|Standard Datei Tabellenbeschreibung (CSV, SDF, etc.)]] beschrieben.<br />
<br />
= Übersicht der Funktionen =<br />
<!-- ------------------------------------------------------------------------------- echo ------------------------------------------------------------------------------- --><br />
== Packstück-Verarbeitung ==<br />
Ein neues Packstück wird durch eine Zeile gekennzeichnet die mit der Kennung "IMP" beginnt.<br />
<br />
Die weiteren Felder sind in der [[HVS32_File_Schnittstelle_(Automatik-Polling)|Standardschnittstelle]] beschrieben.<br />
<br />
== Etikett nachdrucken ==<br />
<br />
Ein Nachdruck wird ausgelöst indem ein bereits übergebener Satz erneut erfasst wird. Je nach Einstellungen kann es dabei zu einer Warnung oder einer Verhinderung des Nachdrucks kommen - die zugehörigen Wahlmöglichkeiten befinden sich im Allgemein-Konfigurator, Bereich "Lieferschein-Verarbeitung".<br />
<br />
== Packstück stornieren ==<br />
<!--<br />
Text anpassen<br />
<br><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 />
<br />
== Ausgangsliste erzeugen ==<br />
<!--<br />
Text anpassen<br />
<br><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 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br><br />
Wenn leer, werden alle Auftraggeber abgeschlossen, welche am betreffenden Packplatz freigegeben sind.<br><br />
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiAGTagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt 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 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".<br />
Wenn leer, werden alle Frachtführer abgeschlossen.<br><br />
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiFFTagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt sein.<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.<br />
|-<br />
| versandartID || [[#Datentypen|String]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.<br />
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiVATagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt 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 />
</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 />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE Listenabschluss ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- ediabschlussAnfrage ------------------------------------------------------------------------------- --><br />
<br />
== Frachtführer DFÜ erzeugen ==<br />
<!--<br />
Text anpassen<br />
<br><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 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br><br />
Wenn leer, werden alle Auftraggeber abgeschlossen, welche am betreffenden Packplatz freigegeben sind.<br><br />
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiAGTagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt 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 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".<br><br />
Wenn leer, werden alle Frachtführer abgeschlossen.<br><br />
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiFFTagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt sein.<br />
|-<br />
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.<br />
|-<br />
| versandartID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.<br><br />
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiVATagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt 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 aktualisieren ==<br />
<!--<br />
Text anpassen<br />
<br><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]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1<br />
|-<br />
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || 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, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)<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 />
"fehlertext1": "",<br />
"fehlertext2": ""<br />
}<br />
</source><br />
</div></div><br />
<!-- ------------------------------------------------------------------------------- ENDE versanddatenPruefAnfrage ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- updateVersanddaten ------------------------------------------------------------------------------- --><br />
<br />
== Packstückdaten aktualisieren ==<br />
<!--<br />
Text anpassen<br />
<br><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]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1<br />
|-<br />
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || 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 />
| 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, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)<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, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)<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 />
"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 />
"nachnahme": 0,<br />
"nettoGewicht": 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 />
"versicherungswert": 0,<br />
"vorpackdatum": "",<br />
"vwWaehrung": "",<br />
"warenwert": 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 />
== Packstückdaten anonymisieren ==<br />
<!--<br />
Text anpassen<br />
<br><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 ==<br />
<!--<br />
Text anpassen<br />
<br><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]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1<br />
|-<br />
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || 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 />
<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, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)<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, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)<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 />
"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 />
= Zusätzliche Datentypen =<br />
Je nach Frachtführer und Einsatzzweck kann es notwendig werden weitere Informationen zur Sendung zu übergeben. <br />
HVS verarbeitet spezielle Kennungen für Daten von im Packstück enthaltenen Artikel oder Gefahrgütern. In beiden Fällen ist es möglich mehrere Zusatzdaten pro Packstück zu übergeben, zum Beispiel wenn mehrere Artikel in einem Packstück enthalten sind.<br />
<br />
== ArtikelDaten ==<br />
<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 />
! Nr !! Feldname !! Von !! Bis !! Typ !! Länge !! Dezimalstellen !! Pflicht !! HVS-Feld !! Belegung !! Feldname<br />
|-<br />
| 1 || Satz-Kennung || 1 || 3 || A || 3 || || M || || Festeintrag "ART" || Satz-Kennung<br />
|-<br />
| 2 || Lieferschein-Nr || 4 || 13 || A || 10 || || M || || || Lieferschein-Nr<br />
|-<br />
| 3 || Packstück-Nr || 14 || 16 || N || 3 || || C || || Pflicht bei AutomatikPolling || Packstück-Nr<br />
|-<br />
| 4 || Positions-Nr || 17 || 26 || N || 10 || 0 || M || || || Positions-Nr<br />
|-<br />
| 5 || Artikel-Nr || 27 || 76 || A || 50 || || O || || || Artikel-Nr<br />
|-<br />
| 6 || Artikel-Bezeichnung1 || 77 || 176 || A || 100 || || M || || || Artikel-Bezeichnung1<br />
|-<br />
| 7 || Artikel-Bezeichnung2 || 177 || 276 || A || 100 || || O || || || Artikel-Bezeichnung2<br />
|-<br />
| 8 || Artikel-Netto-Gewicht (je Maßeinheit) || 277 || 285 || N || 9 || 3 || M || || || Artikel-Netto-Gewicht (je Maßeinheit)<br />
|-<br />
| 9 || BTN-Nummer || 286 || 310 || A || 25 || || O || || || BTN-Nummer<br />
|-<br />
| 10 || Artikel-Anzahl (je Maßeinheit) || 311 || 319 || N || 9 || 0 || M || || || Artikel-Anzahl (je Maßeinheit)<br />
|-<br />
| 11 || Ursprungsland || 320 || 321 || A || 2 || || O || || || Ursprungsland<br />
|-<br />
| 12 || Artikel-Wert (je Maßeinheit) || 322 || 330 || N || 9 || 2 || O || || || Artikel-Wert (je Maßeinheit)<br />
|-<br />
| 13 || Artikelwert-Währung || 331 || 333 || A || 3 || || O || || ISO-Währung z.B. 'EUR' || Artikelwert-Währung<br />
|-<br />
| 14 || Artikel-Maßeinheit || 334 || 343 || A || 10 || || O || || || Artikel-Maßeinheit<br />
|-<br />
| 15 || Artikel-BestellNr || 344 || 393 || A || 50 || || M || || || Artikel-BestellNr<br />
|-<br />
| 16 || Artikel-Volumen || 394 || 402 || N || 9 || 3 || M || || || Artikel-Volumen<br />
|-<br />
| 17 || Artikel-Services || 403 || 452 || A || 50 || || O || || || Artikel-Services<br />
|-<br />
| 18 || Artikel-Gruppe || 453 || 502 || A || 50 || || O || || || Artikel-Gruppe<br />
|-<br />
|}<br />
M = Muss eingetragen werden, O = Optimal einzutragen, C = Conditional abhängig von anderen Feldern<br />
<br />
</div></div><br />
<br />
Bitte klären Sie die übergebenen Parameter unbedingt im Vorfeld mit Ihrem Ansprechpartner bei Heidler Strichcode GmbH da diese stark von den verwendeten Frachtführern abhängen.<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 />
! Nr !! Name !! Feldname !! Von !! Bis !! Länge !! Dezimalstellen !! Typ !! Belegung !! Wichtig bei LQ<br />
|-<br />
| 1 || Satzkennung || || 1 || 3 || 3 || || A || Fest 'GEF' ||<br />
|-<br />
| 2 || Gefahrgut-UNNR || GefahrgutUNNr || 4 || 7 || 4 || || A || || X<br />
|-<br />
| 3 || Gefahrgut-Klasse || GefahrgutKlasse || 8 || 11 || 4 || || A || || X<br />
|-<br />
| 4 || GG-Verpackungsgruppe || GefahrgutVPG || 12 || 14 || 3 || || A || I,II,III bzw. leer ||<br />
|-<br />
| 5 || GG-Klassifizierungscode || GefahrgutKCODE || 15 || 18 || 4 || || A || Pflicht bei Klasse 2 ||<br />
|-<br />
| 6 || Gefahrgut-Bezeichnung || GefahrgutBezeichnung || 19 || 128 || 110 || || A || Stoffbezeichnung It. ADR-Tabelle || X<br />
|-<br />
| 7 || Gefahrgut-Stoffmenge || GefahrgutMenge || 129 || 139 || 11 || 3 || N || || X<br />
|-<br />
| 8 || Kennung 'Begrenze Menge' || GefahrgutBegrenzteMenge || 140 || 140 || 1 || || A || '*' oder 'T': Status 'Begrenzte Menge' || X<br />
|-<br />
| 9 || Anzahl Versandstücke GG || GefahrgutVerpAnzahl || 141 || 143 || 3 || || N || || X<br />
|-<br />
| 10 || Versandstück-Art || GefahrgutVerpackungsart || 144 || 151 || 8 || || A || GG-konform, z.B. '4G', '6HG2' usw. || X<br />
|-<br />
| 11 || GG-ID || GefahrgutID || 152 || 159 || 8 || || A || Eindeutige Suchnummer für Gefahrgut-Stammdaten ||<br />
|-<br />
| 12 || GG-Nebengefahrklasse(n) || GefahrgutNebengefahr || 160 || 171 || 12 || || A || GG-Nebengefahrklasse(n) ||<br />
|-<br />
| 13 || Buchst. Bei Sondervorschr. 640 || GefahrgutBuchst640 || 172 || 172 || 1 || || A || Buchst. Bei Sondervorschr. 640 (A-L) ||<br />
|-<br />
| 14 || Maßeinheit GG-Stoffmenge || GefahrgutMengeneinheit || 173 || 173 || 1 || || A || 0' bzw. Blank: Kilogramm; "1": Liter || X<br />
|-<br />
| 15 || Beförderungskategorie || GefahrgutBefoerdKat || 174 || 174 || 1 || || N || 0-4 It. ADR 1.1.3.6 || X<br />
|-<br />
| 16 || GG-Faktor || GefahrgutFaktor || 175 || 178 || 4 || || N || Gewichtungsfaktor It. ADR 1.1.3.6 ||<br />
|-<br />
| 17 || Netto-Explosivmasse in kg || GefahrgutNettoExpiMasse || 179 || 189 || 11 || 3 || N || Nur bei Klasse 1, dann aber Pflicht ||<br />
|-<br />
| 18 || Tunnel-Beschränkungscode || GefahrgutTunnelBCode || 190 || 199 || 10 || || A || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E) ||<br />
|-<br />
| 19 || Kennung 'Freigestellte Menge' || GefahrgutFreigestMenge || 200 || 200 || 1 || || A || '*' oder 'T': Status 'Freigestellte Menge' (überstimmt Feld 8) ||<br />
|-<br />
| 20 || Kennung 'Umweltgefährdend' || GefahrgutUmweltgef || 201 || 201 || 1 || || A || '*' oder 'T': Status 'Umweltgefährdend' ||<br />
|-<br />
| 21 || Gefahrgut-Techn. Benennung || GefahrgutTechBenennung || 202 || 301 || 100 || || A || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut ||<br />
|-<br />
|}<br />
</div></div><br />
Bitte klären Sie die übergebenen Parameter unbedingt im Vorfeld mit Ihrem Ansprechpartner bei Heidler Strichcode GmbH da diese stark von den verwendeten Frachtführern abhängen.<br />
<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- --><br />
<!-- ------------------------------------------------------------------------------- edistatus ------------------------------------------------------------------------------- --><br />
<br />
= Beispiele =</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Export/import-settings&diff=5927Export/import-settings2024-09-25T07:48:25Z<p>Ddang: </p>
<hr />
<div>[[de:Export/Import_Settings]]<br />
<br />
In the export/import-settings you can see and configurate all interfaces from the HVS32 and every interface which is connected to the HVS32<br />
<br />
<br />
[[File:Setup datenexport import.PNG|right|Setup datenexport import.PNG]]<br />
<br />
= Import =<br />
<br />
:in Import you can define the interfaces that are connected to the HVS32.<br />
<br />
=== dataname ===<br />
<br />
:you can edit the dataname in the configurator.<br />
<br />
=== comment sign ===<br />
<br />
:with the comment sign you can define the seperator, for example by using the datatype CSV you can use the comment sign ";" (semicolon).<br />
<br />
=== dateitype ===<br />
<br />
:you can choose between the different data types of the importfile.<br />
<br />
=== font ===<br />
<br />
:here you can determine the font.<br />
<br />
=== field edit ===<br />
<br />
:with "field edit" you can define the mapping of the HVS32 connected to your interface. <br />
<br />
= Export =<br />
<br />
:in "export" you can define the interfaces from the HVS32. [[File:Setup datenexport export.PNG|right|Setup dataexport export.PNG]]<br />
<br />
=== dataname ===<br />
<br />
:you can determine the path and the dataname for the exportfile.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Export/Import_Settings&diff=5926Export/Import Settings2024-09-25T07:48:02Z<p>Ddang: </p>
<hr />
<div>[[en:Export/import-settings]]<br />
In diesem Menüpunkt können alle Schnittstellen von und zum HVS32 eingesehen und konfiguriert werden.<br />
<br />
[[File:Setup datenexport import.PNG|right|Setup datenexport import.PNG]]<br />
<br />
= Import =<br />
<br />
Im Import können Sie die Schnittstelle zum HVS32 definieren.<br />
<br />
=== Dateiname ===<br />
<br />
:Den Dateinamen können Sie im [[Setup:_Konfigurator#Verarbeitung|Konfigurator]] anpassen. <br />
<br />
=== Kommentarzeichen ===<br />
<br />
:Mit dem Kommentarzeichen können Sie das Trennzeichen definieren, z.B. mit dem Dateityp CSV können Sie das Kommentarzeichen ";" (Semicolon) verwenden. <br />
<br />
=== Dateityp ===<br />
<br />
:Hier haben Sie Möglichkeit zwischen den Datentypen der Importdatei zu wählen. <br />
<br />
=== Zeichensatz ===<br />
<br />
:Hier können Sie den Zeichensatz festlegen. <br />
<br />
=== Felder editieren ===<br />
<br />
:Unter Felder editieren können Sie die Zuordnung der HVS32 zu Ihrer Schnittstelle definieren. Das HVS32 Feld steht hier auf der linken Seite. <br />
<br />
= Export =<br />
<br />
Im Export können Sie die Schnittstelle vom HVS32 definieren.[[File:Setup datenexport export.PNG|right|Setup datenexport export.PNG]]<br />
<br />
=== Dateiname ===<br />
<br />
:Hier können Sie den Pfad und den Dateinamen für die Exportdatei festlegen.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Export/Import_Settings&diff=5925Export/Import Settings2024-09-25T07:47:51Z<p>Ddang: </p>
<hr />
<div>[[en:Export/import-settings]]<br />
<br />
In diesem Menüpunkt können alle Schnittstellen von und zum HVS32 eingesehen und konfiguriert werden.<br />
<br />
[[File:Setup datenexport import.PNG|right|Setup datenexport import.PNG]]<br />
<br />
= Import =<br />
<br />
Im Import können Sie die Schnittstelle zum HVS32 definieren.<br />
<br />
=== Dateiname ===<br />
<br />
:Den Dateinamen können Sie im [[Setup:_Konfigurator#Verarbeitung|Konfigurator]] anpassen. <br />
<br />
=== Kommentarzeichen ===<br />
<br />
:Mit dem Kommentarzeichen können Sie das Trennzeichen definieren, z.B. mit dem Dateityp CSV können Sie das Kommentarzeichen ";" (Semicolon) verwenden. <br />
<br />
=== Dateityp ===<br />
<br />
:Hier haben Sie Möglichkeit zwischen den Datentypen der Importdatei zu wählen. <br />
<br />
=== Zeichensatz ===<br />
<br />
:Hier können Sie den Zeichensatz festlegen. <br />
<br />
=== Felder editieren ===<br />
<br />
:Unter Felder editieren können Sie die Zuordnung der HVS32 zu Ihrer Schnittstelle definieren. Das HVS32 Feld steht hier auf der linken Seite. <br />
<br />
= Export =<br />
<br />
Im Export können Sie die Schnittstelle vom HVS32 definieren.[[File:Setup datenexport export.PNG|right|Setup datenexport export.PNG]]<br />
<br />
=== Dateiname ===<br />
<br />
:Hier können Sie den Pfad und den Dateinamen für die Exportdatei festlegen.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Versanddaten:_Adress-Stamm(extern)&diff=5913Versanddaten: Adress-Stamm(extern)2024-09-06T13:29:06Z<p>Ddang: </p>
<hr />
<div>[[en:Dispatch_data:_adress_data(extern)]]<br />
<br />
In dieser Maske können Sie die Datensätze, welche im Verarbeitungsmodus [[Verarbeitung:_Adress-Stamm(extern)|Adress-Stamm]] verwendet werden bearbeiten, bzw. ergänzen.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Dispatch_data:_adress_data(extern)&diff=5912Dispatch data: adress data(extern)2024-09-06T13:28:47Z<p>Ddang: </p>
<hr />
<div>[[de:Versanddaten:_Adress-Stamm(extern)]]<br />
<br />
In this mask you can edit the records, which are used for [[processing:_adress_data(extern)|adress data(extern)]] processing.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Dispatch_conclusion:_monthly_list_print&diff=5911Dispatch conclusion: monthly list print2024-09-06T13:24:07Z<p>Ddang: </p>
<hr />
<div>[[de:Versand-Abschluß:_Monatsliste_drucken]]<br />
<br />
The monthly list shows you all list´s from the selected carrier in a period selected by the user. It also shows you the number of packages, weight and charges.<br />
<br />
= approach: =<br />
<br />
== 1. carrier select ==<br />
<br />
Select the carrier, for which you wanna print the monthly list. [[File:carrierselect.PNG|none|sub|200px|carrierselect.PNG]]<br />
<br />
== 2. period ==<br />
<br />
It only affects the list´s that were created/printed in the period selected by the user.[[File:period.PNG|none|sub|200px|period.PNG]]<br />
<br />
== 3. selection ==<br />
<br />
[[File:selection.PNG|right|400px|selection.PNG]]In selection you can see for which dispatch-type there are monthly list´s available. If you dont need the monthly list for a specific dispatch-type, you can deactivate it by pressing twice on the mark for the affected dispatch-type. By doing that there will be no monthly list printed for the selected dispatch-type<br />
=== print ===<br />
<br />
:The monthly list will be printed on the printer which is set in the configurator (setup -> configurator -> general -> output channels).<br />
<br />
=== preview ===<br />
<br />
:you will get a preview of the actual list. If you close the window, you will land on the main menu of HVS32<br />
:To print the list, you have to repeat the steps and press on the print button instead on preview.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Versand-Abschlu%C3%9F:_Monatsliste_drucken&diff=5910Versand-Abschluß: Monatsliste drucken2024-09-06T13:23:51Z<p>Ddang: </p>
<hr />
<div>[[en:Dispatch_conclusion:_monthly_list_print]]<br />
<br />
Auf einer Monatsliste stehen alle Listen des ausgewählten Frachtführers und deren Paketanzahl/Gewicht/Gebühr, welche für den vom Benutzer angegebenen Zeitraum gedruckt werden.<br />
<br />
= Vorgehensweise: =<br />
<br />
== 1. Frachtführer-Auswahl ==<br />
<br />
Wählen Sie den Frachtführer, für den die Monatsliste gedruckt werden soll.[[File:FF-Auswahl.PNG|none|sub|200px|FF-Auswahl.PNG]]<br />
<br />
== 2. Zeitraum ==<br />
<br />
Es werden nur die Listen aufgelistet, welche innerhalb des&nbsp;angegebenen Zeitraums erzeugt/gedruckt wurden. [[File:Zeitraum Sammelliste.PNG|none|sub|200px|Datum Sammelliste.PNG]]<br />
<br />
== 3. Auswahl ==<br />
<br />
[[File:VersandartWahl Sammelliste.PNG|right|400px|VersandartWahl Sammelliste.PNG]]Hier wird Ihnen angezeigt, für welche Versandart Monatslisten verfügbar sind. Um für eine Versandart keine Monatsliste zu drucken, machen Sie einen Doppelklick auf den Haken der gewünschten Versandart. Dadurch wird die Versandart nicht mit in den Druck aufgenommen.<br />
<br />
=== Drucken ===<br />
<br />
:Die Monatsliste wird an dem im [[Konfigurator:_Allgemein|Konfigurator]] eingestellten Drucker gedruckt. <br />
<br />
=== Vorschau ===<br />
<br />
:Ihnen wird eine Vorschau angezeigt, wie die Liste aussehen würde. Schließen Sie das Fenster, landen Sie wieder auf dem Startbildschirm des HVS32. <br />
:Um die Liste zu drucken, müssen Sie den Vorgang wiederholen und auf Drucken, anstatt auf Vorschau, drücken.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Sendungen:_Archiv-Auskunft&diff=5909Sendungen: Archiv-Auskunft2024-09-06T13:05:25Z<p>Ddang: </p>
<hr />
<div>[[en:Deliveries:_archive_info_access]]<br />
<br />
Wenn Sie das&nbsp;Zusatzmodul [[HVS32_Datenbank_Archivierungs_Dienst|HVS32 Datenbank Archivierungs Dienst]]&nbsp;zur Archivierung und Verkleinerung der HVS32-Datenbank einsetzen, können Sie Datensätze&nbsp;welche archiviert wurden, nicht mehr über die normale Auskunft untersuchen. Um auf die Daten bereits archivierter Sendungen zugreifen zu können, dient der Punkt "Archiv-Auskunft".<br />
<br />
Zunächst öffnet sich eine Auswahlmaske in der sie die gewünschte Archiv-Datenbank auswählen können.<br />
<br />
[[File:ArchivAuswahl.png|Auswahl einer archivierten Datenbank]]<br />
<br />
Nun öffnet sich die selbe Maske wie bei [[Sendungen:_Auskunft_/_Verwaltung|Auskunft / Verwaltung]].<br />
<br />
[[File:Auskunft sendungen.png|RTENOTITLE]]<br />
<br />
Bitte beachten Sie dass Sie auf eine inaktive Datenbank zugreifen und darum Änderungen in der Regel keine Auswirkung auf die Hauptdatenbank haben. Funktionen die einen aktiven Datenbestand erfordern sind deaktiviert.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Deliveries:_archive_info_access&diff=5908Deliveries: archive info access2024-09-06T13:04:54Z<p>Ddang: </p>
<hr />
<div>[[de:Sendungen:_Archiv-Auskunft]]<br />
<br />
You will not be able to look up archived data in the info panel if you use the additional module “HVS32 Database archiving service” to archive your data. You can access the data of archived deliveries via “archive info access”. <br />
Zunächst öffnet sich eine Auswahlmaske in der sie die gewünschte Archiv-Datenbank auswählen können.<br />
<br />
[[File:ArchivAuswahl.png|Auswahl einer archivierten Datenbank]]<br />
<br />
This will open a selection window, where you select an archive database. <br />
<br />
[[File:Auskunft sendungen.png|RTENOTITLE]]<br />
<br />
Please keep in mind that you are accessing an inactive database and changes will not have any impact on the main database. Functions which require an active database are disabled.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Datenbank:_Index-Statistics_erneuern&diff=5907Datenbank: Index-Statistics erneuern2024-09-06T12:34:45Z<p>Ddang: </p>
<hr />
<div>[[en:Database:_index-Statistic_refresh]]<br />
<br />
Der Menüpunkt "Index-Statistics erneuern" ist eine Verwaltungsfunktion die verwendet werden kann wenn HVS nach längerem Einsatz langsamer arbeitet.<br />
<br />
Der Datenbankserver führt intern Statistiken mit auf welche Art und Weise die Zugriffe auf die Datenbank erfolgen und versucht die Datenbank mit diesen Informationen zu optimieren. Nach längerem Gebrauch von HVS oder nach größeren Einfügeoperationen können diese Optimierungen veraltet oder fehlerhaft sein und die Zugriff tatsächlich verlangsamen. Der Neuaufbau dieser Statistiken kann in einem solchen Fall die Geschwindigkeit von HVS verbessern. Sie sollten diesen Punkt jedoch nur auf Aufforderung durch den Heidler-Support aufrufen!<br />
<br />
&nbsp;<br />
<br />
[[File:Gefahr.jpg|left|50x50px]]'''Vorsicht!'''<br />
<br />
Rufen Sie diesen Punkt nur auf wenn gerade keine Verarbeitung stattfindet! <br />
<br />
Wird das nicht beachtet kann es zu Problemen mit den Nummernkreisen kommen!<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Database:_index-Statistic_refresh&diff=5906Database: index-Statistic refresh2024-09-06T12:34:26Z<p>Ddang: </p>
<hr />
<div>[[de:Datenbank:_Index-Statistics_erneuern]]<br />
<br />
'''menu: database > index-statistic refresh'''<br><br />
With this option you can optimize the performance of the HVS32 on the basis of a refresh of the HVS32 database index statistics, in case HVS32 is running slow after a long period without any database archiving/optimization processes.<br />
<br />
You should run this option only after instructions of the Heidler Support Team.<br />
<br />
&nbsp;<br />
<br />
[[File:Gefahr.jpg|left|50x50px]]'''Attention!'''<br />
<br />
Only run this action when nobody is qorking with the HVS32, if you run it during working hours you could damage the HVS32 database.<br />
<br />
&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Datenbank:_Daten_zur%C3%BCcksetzen_(f%C3%BCr_Echtbetriebsstart)&diff=5905Datenbank: Daten zurücksetzen (für Echtbetriebsstart)2024-09-06T12:33:17Z<p>Ddang: </p>
<hr />
<div>[[en:Database:_data_reset_(for_system_start)]]<br />
<br />
'''<span style="font-size:xx-large;">[[File:Gefahr.jpg|left|Gefahr.jpg]]Achtung</span>'''<br />
<br />
----<br />
<br />
:Dieser Menüpunkt sollte nur nach Absprache und mit ausdrücklicher Genehmigung durch das Heidler Support-Team benutzt werden. <br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
<br />
Hier haben Sie die Möglichkeit bestimmte Punkte der HVS32&nbsp;Datenbank zu löschen und somit z.B. für den Echtbetrieb zurückzusetzen. [[File:Datenbank zurücksetzen.PNG|thumb|right|Datenbank zurücksetzen.PNG]]<br />
<br />
'''Bitte beachten Sie, dass gelöschte Einträge nicht wiederherstellbar sind.'''<br />
<br />
= Aktionen =<br />
<br />
=== Versanddaten löschen ===<br />
<br />
:Durch diese Auswahl wird die [[Sendungen:_Auskunft_/_Verwaltung|Auskunft]] bereinigt. <br />
<br />
=== Kundendaten löschen ===<br />
<br />
:Durch diese Auswahl werden die [[Versanddaten:_Adress-Stamm|Kundendaten]] gelöscht. <br />
<br />
=== Vormerkdaten löschen ===<br />
<br />
:Durch diese Auswahl werden die [[Bereinigung_Vormerktabelle|Vormerkdaten]] gelöscht. <br />
<br />
=== Nummernkreise zurücksetzen ===<br />
<br />
:Durch diese Auswahl werden alle Nummernkreise zurückgesetzt. <br />
<br />
=== Routen löschen ===<br />
<br />
:Durch diese Auswahl werden alle [[Routen_Update_(generell)|Routen]] gelöscht. <br />
:&nbsp; <br />
:&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Database:_data_reset_(for_system_start)&diff=5904Database: data reset (for system start)2024-09-06T12:32:12Z<p>Ddang: </p>
<hr />
<div>[[de:Datenbank:_Daten_zurücksetzen_(für_Echtbetriebsstart)]]<br />
<br />
'''menu: database > data reset (for system start)'''<br><br><br />
'''<span style="font-size:xx-large;">[[File:Gefahr.jpg|left|Gefahr.jpg]]Attention</span>'''<br />
<br />
----<br />
<br />
:You should run this action only after consulting the Heidler Support-Team.<br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
<br />
With this option you can reset the whole HVS32 database prior a productive start with the system, so you can delete all data which you generated in your testing-period. [[File:Datenbank zurücksetzen.PNG|thumb|right|Datenbank zurücksetzen.PNG]]<br />
<br />
'''Please pay attention: It' not possible to restore data when you make a reset with this functions.'''<br />
<br />
= Aktionen =<br />
<br />
=== Versanddaten löschen ===<br />
<br />
:With this choice the [[Sendungen:_Auskunft_/_Verwaltung|Auskunft]] will be cleared. <br />
<br />
=== Kundendaten löschen ===<br />
<br />
:With this choice the [[Versanddaten:_Adress-Stamm|Kundendaten]] will be deleted. <br />
<br />
=== Vormerkdaten löschen ===<br />
<br />
:With this choice the [[Bereinigung_Vormerktabelle|Vormerkdaten]] will be cleared. <br />
<br />
=== Nummernkreise zurücksetzen ===<br />
<br />
:This will reset all numberranges of all carriers and mandators/clients. <br />
<br />
=== Routen löschen ===<br />
<br />
:With this choice the imported [[Routen_Update_(generell)|Routen]] will be deleted. <br />
:&nbsp; <br />
:&nbsp;</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Configurator:_delivery_data_(2)&diff=5901Configurator: delivery data (2)2024-09-05T12:11:28Z<p>Ddang: </p>
<hr />
<div>[[de:Konfigurator:_Lieferschein-Daten_(2)]]<br />
<br />
[[File:Configurator_delivery_data_(2).PNG|right|700px|Configurator_delivery_data_(2).PNG]]This is the second page for the settings of delivery data.<br />
<br />
= Deviation weight comparison =<br />
<br />
In this option the weight of the delivery data (target) is compared to the total weight of the processing (current). If the value is beyond the tolerance, an error message is printed out.<br />
<br />
=== Vergleich (ON/OFF) ===<br />
<br />
:Schalten Sie den Soll-Ist-Gewichtsvergleich ein. <br />
<br />
<br />
=== Soll-Ist-Gewichtstoleranz ===<br />
<br />
:Stellen Sie die Toleranz, bei der eine Abweichung vertretbar ist in Prozent ein. Ist das Sollgewicht also 5 kg und das Istgewicht 5,2 kg wird bei einer Toleranz von 2%&nbsp;eine Warnmeldung angezeigt.<br />
<br />
= Adressprüfung =<br />
<br />
Schalten Sie die Adressprüfung ein, um mit der Versandabwicklung Deutsche Post und eingeschalteten Leitcodierung, die Adressen zu prüfen.<br />
<br />
= Lieferschein Beipack immer aktiviert =<br />
<br />
Nach der Aktivierung ist auf der Maske [[Verarbeitung:_Lieferschein-Daten(normal)|Lieferschein-Daten]] der Haken für Beipack-Lieferschiene standardmäßig gesetzt und muss nicht erst gesetzt werden.<br />
<br />
<br />
= FTP-Server Lieferscheindaten =<br />
<br />
=== FTP-Server ===<br />
<br />
:Geben Sie die IP-Adresse des FTP-Servers an. <br />
<br />
=== Port ===<br />
<br />
:An dieser Stelle müssen Sie den Port des FTP-Servers eingeben. Standardmäßig ist dieser 21. <br />
<br />
=== Benutzername ===<br />
<br />
:Damit Sie sich anmelden können, müssen Sie hier den Benutzernamen, mit welchem Sie sich anmelden möchten, eingeben. <br />
<br />
=== Passwort ===<br />
<br />
:Geben Sie das Passwort welches zu dem Benutzername gehört ein. <br />
<br />
=== FTP-Verzeichnis ===<br />
<br />
:Geben Sie das Verzeichnis auf dem FTP-Server an, in welches die Datein gespeichert werden sollen. <br />
<br />
=== Lieferschein-Position-Daten ===<br />
<br />
:Sollen Positions- bzw. Artikeldaten gelesen werden? <br />
<br />
=== Lieferschein-Charge-Daten ===<br />
<br />
:Sollen Chargeinformationen gelesen werden? <br />
<br />
=== Datei auf dem Server löschen ===<br />
<br />
:Die Datei auf dem Server wird gelöscht, nachdem Sie die Lieferscheindaten eingelesen haben.<br />
<br />
= Importschnitstelle automatisch ermitteln =<br />
<br />
Def.</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Anonymization&diff=5885Anonymization2024-08-22T12:43:22Z<p>Ddang: </p>
<hr />
<div>[[de:Anonymisierung]]<br />
<br />
= Anonymization of reciver data =<br />
<br />
The anonymization of customer data in accordance with the DSQVO is available in HVS32 from version 7.105.16.<br />
If you use a older version you have to use the database archiving.<br />
<br />
= Anonymization =<br />
[https://www.heidler-strichcode.de/wikiextern/images/1/18/Anonymization_.JPG [[File:Anonymization .JPG|right|500px]]]<br />
You can search and mark the desired data records in the investigation/information. Then, by selecting the "Anonymization" button, all personal data will be made irrecognizable. The data sets will not be deleted because some carriers still require them to generate lists or EDI files repercussive.<br />
<br />
The following fields will be made irrecognizable:<br />
<br />
* names<br />
* streets<br />
* contact<br />
* telephone-,fax-, mobile number<br />
* delivery advice<br />
More fields can be included, please contact our support for this.<br />
<br />
=Anonymization through database archiving=<br />
The process of database archiving moves all data records to an archive database with selectable storage location. <br />
<br />
Archived databases are not linked in the HVS32, but can be opened under “deliveries” > “archive info access”. That means you have the possibility to restrict the access to your archive data in accordance with your privacy laws by yourself.<br />
You can also completely delete the generated archive database.<br />
After the archiving process, the records are no longer in the productive HVS32 database.<br><br />
Anonymization can also take place within archive databases.<br><br />
To do this, the archive database must be integrated into the HVS through the Shipments:_archive info access.<br />
For database archiving, we provide two tools:<br><br><br />
1) '''Expansion module Automatic database archiving'''<br><br />
Data records are automatically removed from the production database and archived at defined intervals and after a preset period of time. <br />
The automatic database archiving also offers an option to directly discard / delete the data instead of creating an archive. <br />
See more details here: HVS32 database archiving service.<br />
<br />
2) '''Manual database archiving'''<br><br />
Using a command-line tool manually, the database can be archived / cleaned up.<br />
More details: Database clearing</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Carrier_API_error_codes&diff=5878Carrier API error codes2024-08-07T14:09:49Z<p>Ddang: /* Group 04 - Configuration error */</p>
<hr />
<div>[[de:Carrier_API_Fehlercodes]]<br />
<br />
== General ==<br />
Error codes in the Carrier API appear in the following form <code>AAA-SSS-GG-L[Code]</code>, where<br />
* AAA = Application, in this case only CAP for CarrierAPI<br />
* SSS = Sub group, in this case the plugin. A list of plugins can be found further down.<br />
* GG = Error group, this divides the errors in categories, where the cause normally originates from<br />
* L = Error-level, the severeness of the error: W = Warning, E = Error, C = Critical, F = Fatal<br />
* [Code] = A numerical Code that clearly assigns the error in this group.<br />
<br />
<br />
<br />
Example: <code>CAP-HEH-02-E00005</code><br />
<br />
Means there is an error in the Hermes HSI module in group 02 (content-related error) with code 5 (authentification failed).<br />
<br />
<br />
<br />
To search for an error, search on this site <code>(Strg+F)</code> with the acutal code.<br />
<br />
If you can not find the code directly, replace the sub group, e.g. "HEH" with <code>XXX</code>. From the top example: <code>CAP-XXX-02-E00005</code>. This code is available in group 02.<br />
<br />
<br />
== Group 00 - Fundamental errors ==<br />
These errors appear if the error cause is unknown (e.g. 00000 - undefined error) or when a fundamental problem lies within the functionalities of the Carrier API.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-00-E00000 || Error in webservice request: [Error message] || Error cause unknown. Examine exact error message, if necessary check logs.<br />
|-<br />
| CAP-XXX-00-E00001 || Unable to create plugin || Problem when calling the webservice plugin. Please contact support<br />
|-<br />
| CAP-XXX-00-E00002 || The selected Carrier API plugin has been deprecated. Please contact Heidler Support || The selected Carrier API plugin is deprecated and the webservice is discontinued by the carrier. Please contact support<br />
|}<br />
<br />
== Group 01 - Technical errors in the request ==<br />
These errors appear if the request was not successful due to a technical error. They can be temporary problems, e.g. the server is not accessible (00001 - connection error) or overloaded (00002 - Read timeout). Or fundamental problems which require interference (00004 - certificate error).<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-01-C00001 || [Connection error / Connection timeout] Unable to connect to webservice. Please check your internet connection, url, firewall, or proxy settings. || Connection error: No connection possible. Maybe the request was blocked.<br />
Connect timeout: The Carrier API could not determine that the connection was blocked. Maybe the connection quality is insufficient.<br />
|-<br />
| CAP-XXX-01-E00002 || Read timeout: The webservice did not respond in a timely manner. || Normally, the server of the carrier is overloaded. You can try to increase the Read timeout in the general settings or for this specific endpoint.<br />
|-<br />
|-<br />
| CAP-XXX-01-C00003 || DNS error: The url [URL] is unknown || Your DNS-Server blocks the request of the Carrier API or the URL set is not correct.<br />
|-<br />
|-<br />
| CAP-XXX-01-C00004 || Unable to verify webservice certificate. Please check your firewall or url. || If your firewall contains a deep packet inspection, it provides a certificate in between, which is unknown to the Carrier API. The Carrier API interprets it as a [https://de.wikipedia.org/wiki/Man-in-the-Middle-Angriff Man-in-the-Middle-Angriff].<br />
If you trust the certificate, you can save it X.509 coded under [CarrierAPI]\config\certs.<br />
|-<br />
|-<br />
| CAP-XXX-01-F00005 || Deserialization error: The webservice returned an invalid document || Please contact support.<br />
|-<br />
|-<br />
| CAP-XXX-01-E00006 || Label conversion error || Please contact support.<br />
|}<br />
<br />
<br />
== Group 02 - Content-related errors in the request ==<br />
The communication with the webservice was successful, but the response does not math the expectation. Normally, the webservice has found an error in the request (shipment data set) and returns it.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-02-E00001 || General response error || The Carrier API can not assign the error. Please check the exact error message to this error code.<br />
|-<br />
| CAP-XXX-02-E00002 || Webservice returned error: [Error message] || The webservice has responded with an exact error code and/or error message. Please check it and correct the data set if necessary.<br />
|-<br />
| CAP-XXX-02-E00003 || Webservice returned an invalid response: [Error detail] || The response from the webservice does not match the conventions known by the Carrier API. Possibly some mandatory fields are missing in the response (e.g. tracking number or label data). Please check the eroor details and contact the support if necessary.<br />
|-<br />
| CAP-XXX-02-E00004 || Webservice returned HTTP [HTTP-Code] || No detailed error details are known except for the webservice respoding with a "not OK".<br />
In the logs of the Carrier API you can normally findthe whole response from the webservice wich may contain more details.<br />
|-<br />
| CAP-XXX-02-E00005 || Authentication with the webservice failed. Please check your login details. || Normally the access data set in the Carrier API is wrong or the carrier has not unlocked your account yet.<br />
|-<br />
| CAP-XXX-02-E00006 || The webservice did not change the shipment status within a reasonable amount of time (asynchronous webservice operation). <br />
| With asynchronous webservices (e.g. Inpost24 or FedEx Stratus), the Carrier API waits until the webservice responds with a Completed or Error status. If this does not occur in time, the Carrier API throws this error.<br />
|}<br />
<br />
== Group 03 - Validation error ==<br />
For some carriers, the Carrier API executes a limited validation and returns an error even before the request to the webservice, when it is predictable that the request is not accepted by the carrier.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-03-E00001 || Validation error: [Error details] || Validation error which does not fit the following categories. Please check the error details.<br />
|-<br />
| CAP-XXX-03-E00002 || Invalid reference number || The webservice needs a clear reference number (e.g. delivery note number)<br />
|-<br />
|-<br />
| CAP-XXX-03-E00003 || Receiver address is invalid || e.g. missing PLZ, street, house no. etc.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00004 || Street and house number needs to be separated <br />
| Street and house no. need to be separated in the shipment. The separation was not configured in the HVS32 (contact support) or the separation was not successful (check data set: house no. at the end or start of the street?)<br />
|-<br />
|-<br />
| CAP-XXX-03-E00005 || Unable to separate first and last name for: [Name] || For the separation of first and last name, you need two words.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00006 || Invalid incoterm id || A completely missing incoterm or the carrier ony accepts specific incoterms.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00007 || Target date is invalid || A service was selected that expects a target date. It is not filled or is in the past.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00008 || Customer / account number is invalid || The customer number in the HVS32 configurator or the user in the Carrier API configurator does not match the conditions of the carrier (e.g. numerical).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00009 || Shipment number is invalid || The HVS32 should create a shipment number (contact support) or expects it from the host system (check data set).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00010 || Tracking number is invalid || The HVS32 should create a tracking number (contact support) or expects it from the host system (check data set).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00011 || Service type id is invalid || The configured service is invalid for this carrier.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00012 || Invalid e-mail address || This shipment needs an email address with the selected service. It has not been delivered. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00013 || Invalid phone number || This shipment needs a phone number with the selected service. It has not been delivered. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00014 || Invalid value of goods || This shipment needs the value of goods with the selected service. It has not been delivered or it s an invalid number. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00015 || Invalid insurance value || This shipment needs an insurance value with the selected service. It has not been delivered or it s an invalid number. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00016 || Invalid id for parcel shop || A parcel shop shipment has been selected for this shiment. But the corresponding parcel shop id is missing or invalid (e.g. numerical).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00017 || The requested service requires additional data. || A specific service has been selected for this shipment. But additional information for this service is missing that is necessary.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00030 || Weight is invalid || The chosen package weight does not match the conditions of the carrier (e.g. 0kg or more than the carrier accepts). Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00031 || Package dimensions are invalid. || The carrier expects package dimensions that are missing in the data set. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00032 || Package type id is invalid || The package type is completely missing or the carrier only accepts specifc package types.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00033 || Package contents are invalid || This shipment needs the package content with the selected service. It has not been delivered. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00038 || No article data available in package || Shipments outside of the EU normally require additional article data to correctly transfer the customs information.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00039 || No hazardous goods data available in package || The selceted service is a dangerous goods service. But the dangerous goods data is missing in the data set.<br />
|}<br />
<br />
== Group 04 - Configuration error ==<br />
Errors in group 04 mostly have their cause due to a not fully configurated module in the HVS32 or in the Carrier API. It is also possible that the data set is incorrect and refers to a false configuration (e.g. when an invalid dispatch type ID is sent).<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-000-04-C00001 || No dispatch type found for id: [Dispatch type ID] || The Carrier API can not find a configuration entry with the chosen dispatch type ID.The configuration is incomplete or the transferred dispatch type ID is wrong.<br />
|-<br />
| CAP-000-04-C00002 || No client found for id: [Client ID] || The Carrier API can not find a configuration entry with the chosen client ID.The configuration is incomplete or the transferred client ID is wrong.<br />
|-<br />
|-<br />
| CAP-000-04-C00003 || Plugin [Plugin] is not licensed || The dispatch type or rather the endpoint refers to a carrier plugin has not been licensed yet or is not anymore. Please contact the support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00004 || No endpoint defined for dispatch type: [Dispatch type ID] || The selected dispatch type has been found in the Carrier API but not the endpoint, which the dispatch type refers to. Please contact the support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00005 || Endpoint url is invalid: [URL] || The configured URL in the endpoint is invalid. Please contact the support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00006 || Invalid configuration for: [Configuration details] || A carrier specific configuration is incomplete. Please check the detailed error message for more details.<br />
|}<br />
<br />
<br />
== Carrier-specific errors ==<br />
Some carriers have special error codes that can not be be generally assigned. In most cases, it is an extended validation error from group 03.<br />
<br />
<br />
=== GLS Ship IT ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-GLS-03-E00050 || Invalid GLS contact id || Die im HVS32 konfigurierte Contact ID fehlt oder ist ungültig<br />
|}<br />
<br />
<br />
=== Hermes Shipping Interface (HSI) ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-HEH-03-E00050 || Invalid package type and dimensions. At least one is required. || Hermes hat Verpackungen im Format XS, S, M, L, XL<br />
|-<br />
|-<br />
| CAP-HEH-03-E00051 || Invalid birthday for ident service || Für diese Sendung wurde ein Ident-Service gewählt. Das Geburtsdatum fehlt allerdings oder handelt sich nicht um ein gültiges Datum.<br />
|}<br />
<br />
<br />
=== Schenker AT ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-SHA-03-E00050 || Error in hazardous goods dataset. Invalid UN number. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die UN-Nummer<br />
|-<br />
|-<br />
| CAP-SHA-03-E00051 || Error in hazardous goods dataset. Invalid DG class. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Klasse.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00052 || Error in hazardous goods dataset. Invalid dg weight. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie das GG-Gewicht.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00053 || Error in hazardous goods dataset. Invalid package type. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsart.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00054 || Error in hazardous goods dataset. Invalid dg package group. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsgruppe.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00055 || Error in hazardous goods dataset. Invalid shipping name. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Bezeichnung<br />
|-<br />
|-<br />
| CAP-SHA-03-E00056 || Error in hazardous goods dataset. No net explosive mass defined for dg class 1. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die Netto-Explosivmasse. Außerdem: Wurde mit Schenker AT abgesprochen, dass Sie Torpedos verschicken?<br />
|-<br />
|-<br />
| CAP-SHA-03-E00057 || Error in hazardous goods dataset. Invalid unit of measurement. <br />
| Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie den Mengen-Typ (kg oder l)<br />
|}<br />
<br />
<br />
== Plugin codes ==<br />
Each plugin has its own sub-group for an error code. All plugins are listed in the following.<br />
<br />
{| class="wikitable sortable"<br />
|-<br />
! Code !! Plugin<br />
|-<br />
| 000 || Unbekannt - Plugin konnte noch nicht ermittelt werden<br />
|-<br />
| ACO || Arco<br />
|-<br />
| AGX || AGX<br />
|-<br />
| AMZ || Amazon Merchant Fulfillment<br />
|-<br />
| ANL || ANGEL<br />
|-<br />
| ASE || Asendia<br />
|-<br />
| ASM || Amazon Selling Partner API - Merchant Fulfillment<br />
|-<br />
| ASV || Amazon Selling Partner API - Vendor Direct<br />
|-<br />
| ATL || Atlas<br />
|-<br />
| CAL || Canis Lupus<br />
|-<br />
| CEN || Centiro<br />
|-<br />
| CHR || Chronopost<br />
|-<br />
| CIP || Citipost<br />
|-<br />
| COU || Coureon<br />
|-<br />
| DBB || DHL ES B2B<br />
|-<br />
| DCS || DCS<br />
|-<br />
| DEC || DHL eConnect<br />
|-<br />
| DEL || DHL Express Routing Live<br />
|-<br />
| DET || DHL Express Routing Test<br />
|-<br />
| DFR || DPD FR (Frankreich)<br />
|-<br />
| DHA || DHL ELP (Abholung)<br />
|-<br />
| DHE || DHL ES B2C<br />
|-<br />
| DHH || DHL Global Web Service (Ungarn)<br />
|-<br />
| DHN || DHL NL<br />
|-<br />
| DHP || DHL 24 PL<br />
|-<br />
| DHS || DHL SK (Slowakei)<br />
|-<br />
| DIM || Internetmarke (Deutsche Post)<br />
|-<br />
| DPA || DPD AT (Österreich)<br />
|-<br />
| DPL || DPD PL (Polen)<br />
|-<br />
| DPC || DPD HR (Kroatien)<br />
|-<br />
| DPH || DPD HU (Ungarn)<br />
|-<br />
| DPP || DPD DE Parcelshop Suche<br />
|-<br />
| DPR || DPD RO (Rumänien)<br />
|-<br />
| DRI || DHL Retoure International<br />
|-<br />
| DRL || DHL Retoure International (Legacy - veraltet)<br />
|-<br />
| DSK || Danske<br />
|-<br />
| DVF || AM.Exchange (DV-Freimachung)<br />
|-<br />
| EPK || Europaket<br />
|-<br />
| FED || Fedex<br />
|-<br />
| FAC || Fiege Amazon Carma<br />
|-<br />
| FTD || Fedex Trade Documents<br />
|-<br />
| FXA || Fedex (Abholung)<br />
|-<br />
| FXP || Fedex PL (Polen)<br />
|-<br />
| FXS || Fedex Stratus REST API<br />
|-<br />
| GEO || Geodis<br />
|-<br />
| GLD || GLS DK (Dänemark)<br />
|-<br />
| GLE || GLS ES (Spanien)<br />
|-<br />
| GLF || GLS FR (Frankreich)<br />
|-<br />
| GLH || GLS HU (Ungarn)<br />
|-<br />
| GLI || GLS IT (Italien)<br />
|-<br />
| GLK || GLS SK (Slowakei)<br />
|-<br />
| GLL || GLS CZ (Tschechien)<br />
|-<br />
| GLN || GLS NL (Niederlande)<br />
|-<br />
| GLO || Glovo<br />
|-<br />
| GLP || GLS PL (Polen)<br />
|-<br />
| GLS || GLS DE / Ship IT (Deutschland)<br />
|-<br />
| GPP || General Purpose (konfigurierbar), auch G00 - G99<br />
|-<br />
| GPS || GLS Parcel Shop (GLS DE Parcelshop Suche)<br />
|-<br />
| GSA || GLS AT / Ship IT (Österreich)<br />
|-<br />
| GSF || GLS FR / Ship IT (Frankreich)<br />
|-<br />
| GTT || GLS DE Track & Trace<br />
|-<br />
| HBG || Hermes Border Guru<br />
|-<br />
| HEH || Hermes Shipping Interface (HSI)<br />
|-<br />
| HES || Hermes Einrichtungs Service (HES)<br />
|-<br />
| HRB || Hornbach<br />
|-<br />
| HMP || Hellmann PL (Polen)<br />
|-<br />
|ICS || ICS<br />
|-<br />
| INP || Inpost24<br />
|-<br />
| IZP || Infens Zustellprofi<br />
|-<br />
|KOV || Kommt Overnight<br />
|-<br />
| KUR || Der Kurier<br />
|-<br />
| LFG || Liefergrün<br />
|-<br />
| LGX || Log X Star<br />
|-<br />
| MON || Mondial Relay<br />
|-<br />
| NCX || Nacex<br />
|-<br />
| OMS || Omest<br />
|-<br />
| ONT || Ontime<br />
|-<br />
| PAT || Post AT (Österreich)<br />
|-<br />
| PFI || Posti FI (Finnland)<br />
|-<br />
| PHR || Posti HR (Kroatien)<br />
|-<br />
| PIL || Pilot<br />
|-<br />
| PPL || PPL<br />
|-<br />
| PSI || Post SI (Slovenien)<br />
|-<br />
| PSK || Post SK (Slovakei)<br />
|-<br />
| SES || Seven Senders (7senders)<br />
|-<br />
| SHA || Schenker AT (Österreich)<br />
|-<br />
| SHD || Schenker<br />
|-<br />
| SHS || Schenker SE (Schweden)<br />
|-<br />
| SND || Sending<br />
|-<br />
| TBN || TNT NL - Retoure Belgien<br />
|-<br />
| TMP || TMParcel<br />
|-<br />
| TNF || TNT FR (Frankreich)<br />
|-<br />
| TNI || TNT IT (Italien)<br />
|-<br />
| TNN || TNT Post NL (Niederlande)<br />
|-<br />
| TNT || TNT (Deutschland)<br />
|-<br />
| TOH || TOF HU (Ungarn)<br />
|-<br />
| TPN || TPN<br />
|-<br />
| TRA || Tradebyte<br />
|-<br />
| TRM || Tiramizoo<br />
|-<br />
| UPA || UPS Pickup (Abholung)<br />
|-<br />
| UPG || UPS GG (Gefahrgut PreAvis)<br />
|-<br />
| UPP || UPS Paperless Document<br />
|-<br />
| UPT || UPS Tarifierung <br />
|-<br />
| VNP || Venipak<br />
|-<br />
| WYF || Wayfair<br />
|}</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Carrier_API_error_codes&diff=5877Carrier API error codes2024-08-07T14:03:53Z<p>Ddang: </p>
<hr />
<div>[[de:Carrier_API_Fehlercodes]]<br />
<br />
== General ==<br />
Error codes in the Carrier API appear in the following form <code>AAA-SSS-GG-L[Code]</code>, where<br />
* AAA = Application, in this case only CAP for CarrierAPI<br />
* SSS = Sub group, in this case the plugin. A list of plugins can be found further down.<br />
* GG = Error group, this divides the errors in categories, where the cause normally originates from<br />
* L = Error-level, the severeness of the error: W = Warning, E = Error, C = Critical, F = Fatal<br />
* [Code] = A numerical Code that clearly assigns the error in this group.<br />
<br />
<br />
<br />
Example: <code>CAP-HEH-02-E00005</code><br />
<br />
Means there is an error in the Hermes HSI module in group 02 (content-related error) with code 5 (authentification failed).<br />
<br />
<br />
<br />
To search for an error, search on this site <code>(Strg+F)</code> with the acutal code.<br />
<br />
If you can not find the code directly, replace the sub group, e.g. "HEH" with <code>XXX</code>. From the top example: <code>CAP-XXX-02-E00005</code>. This code is available in group 02.<br />
<br />
<br />
== Group 00 - Fundamental errors ==<br />
These errors appear if the error cause is unknown (e.g. 00000 - undefined error) or when a fundamental problem lies within the functionalities of the Carrier API.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-00-E00000 || Error in webservice request: [Error message] || Error cause unknown. Examine exact error message, if necessary check logs.<br />
|-<br />
| CAP-XXX-00-E00001 || Unable to create plugin || Problem when calling the webservice plugin. Please contact support<br />
|-<br />
| CAP-XXX-00-E00002 || The selected Carrier API plugin has been deprecated. Please contact Heidler Support || The selected Carrier API plugin is deprecated and the webservice is discontinued by the carrier. Please contact support<br />
|}<br />
<br />
== Group 01 - Technical errors in the request ==<br />
These errors appear if the request was not successful due to a technical error. They can be temporary problems, e.g. the server is not accessible (00001 - connection error) or overloaded (00002 - Read timeout). Or fundamental problems which require interference (00004 - certificate error).<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-01-C00001 || [Connection error / Connection timeout] Unable to connect to webservice. Please check your internet connection, url, firewall, or proxy settings. || Connection error: No connection possible. Maybe the request was blocked.<br />
Connect timeout: The Carrier API could not determine that the connection was blocked. Maybe the connection quality is insufficient.<br />
|-<br />
| CAP-XXX-01-E00002 || Read timeout: The webservice did not respond in a timely manner. || Normally, the server of the carrier is overloaded. You can try to increase the Read timeout in the general settings or for this specific endpoint.<br />
|-<br />
|-<br />
| CAP-XXX-01-C00003 || DNS error: The url [URL] is unknown || Your DNS-Server blocks the request of the Carrier API or the URL set is not correct.<br />
|-<br />
|-<br />
| CAP-XXX-01-C00004 || Unable to verify webservice certificate. Please check your firewall or url. || If your firewall contains a deep packet inspection, it provides a certificate in between, which is unknown to the Carrier API. The Carrier API interprets it as a [https://de.wikipedia.org/wiki/Man-in-the-Middle-Angriff Man-in-the-Middle-Angriff].<br />
If you trust the certificate, you can save it X.509 coded under [CarrierAPI]\config\certs.<br />
|-<br />
|-<br />
| CAP-XXX-01-F00005 || Deserialization error: The webservice returned an invalid document || Please contact support.<br />
|-<br />
|-<br />
| CAP-XXX-01-E00006 || Label conversion error || Please contact support.<br />
|}<br />
<br />
<br />
== Group 02 - Content-related errors in the request ==<br />
The communication with the webservice was successful, but the response does not math the expectation. Normally, the webservice has found an error in the request (shipment data set) and returns it.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-02-E00001 || General response error || The Carrier API can not assign the error. Please check the exact error message to this error code.<br />
|-<br />
| CAP-XXX-02-E00002 || Webservice returned error: [Error message] || The webservice has responded with an exact error code and/or error message. Please check it and correct the data set if necessary.<br />
|-<br />
| CAP-XXX-02-E00003 || Webservice returned an invalid response: [Error detail] || The response from the webservice does not match the conventions known by the Carrier API. Possibly some mandatory fields are missing in the response (e.g. tracking number or label data). Please check the eroor details and contact the support if necessary.<br />
|-<br />
| CAP-XXX-02-E00004 || Webservice returned HTTP [HTTP-Code] || No detailed error details are known except for the webservice respoding with a "not OK".<br />
In the logs of the Carrier API you can normally findthe whole response from the webservice wich may contain more details.<br />
|-<br />
| CAP-XXX-02-E00005 || Authentication with the webservice failed. Please check your login details. || Normally the access data set in the Carrier API is wrong or the carrier has not unlocked your account yet.<br />
|-<br />
| CAP-XXX-02-E00006 || The webservice did not change the shipment status within a reasonable amount of time (asynchronous webservice operation). <br />
| With asynchronous webservices (e.g. Inpost24 or FedEx Stratus), the Carrier API waits until the webservice responds with a Completed or Error status. If this does not occur in time, the Carrier API throws this error.<br />
|}<br />
<br />
== Group 03 - Validation error ==<br />
For some carriers, the Carrier API executes a limited validation and returns an error even before the request to the webservice, when it is predictable that the request is not accepted by the carrier.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-03-E00001 || Validation error: [Error details] || Validation error which does not fit the following categories. Please check the error details.<br />
|-<br />
| CAP-XXX-03-E00002 || Invalid reference number || The webservice needs a clear reference number (e.g. delivery note number)<br />
|-<br />
|-<br />
| CAP-XXX-03-E00003 || Receiver address is invalid || e.g. missing PLZ, street, house no. etc.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00004 || Street and house number needs to be separated <br />
| Street and house no. need to be separated in the shipment. The separation was not configured in the HVS32 (contact support) or the separation was not successful (check data set: house no. at the end or start of the street?)<br />
|-<br />
|-<br />
| CAP-XXX-03-E00005 || Unable to separate first and last name for: [Name] || For the separation of first and last name, you need two words.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00006 || Invalid incoterm id || A completely missing incoterm or the carrier ony accepts specific incoterms.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00007 || Target date is invalid || A service was selected that expects a target date. It is not filled or is in the past.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00008 || Customer / account number is invalid || The customer number in the HVS32 configurator or the user in the Carrier API configurator does not match the conditions of the carrier (e.g. numerical).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00009 || Shipment number is invalid || The HVS32 should create a shipment number (contact support) or expects it from the host system (check data set).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00010 || Tracking number is invalid || The HVS32 should create a tracking number (contact support) or expects it from the host system (check data set).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00011 || Service type id is invalid || The configured service is invalid for this carrier.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00012 || Invalid e-mail address || This shipment needs an email address with the selected service. It has not been delivered. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00013 || Invalid phone number || This shipment needs a phone number with the selected service. It has not been delivered. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00014 || Invalid value of goods || This shipment needs the value of goods with the selected service. It has not been delivered or it s an invalid number. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00015 || Invalid insurance value || This shipment needs an insurance value with the selected service. It has not been delivered or it s an invalid number. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00016 || Invalid id for parcel shop || A parcel shop shipment has been selected for this shiment. But the corresponding parcel shop id is missing or invalid (e.g. numerical).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00017 || The requested service requires additional data. || A specific service has been selected for this shipment. But additional information for this service is missing that is necessary.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00030 || Weight is invalid || The chosen package weight does not match the conditions of the carrier (e.g. 0kg or more than the carrier accepts). Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00031 || Package dimensions are invalid. || The carrier expects package dimensions that are missing in the data set. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00032 || Package type id is invalid || The package type is completely missing or the carrier only accepts specifc package types.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00033 || Package contents are invalid || This shipment needs the package content with the selected service. It has not been delivered. Please check the data set.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00038 || No article data available in package || Shipments outside of the EU normally require additional article data to correctly transfer the customs information.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00039 || No hazardous goods data available in package || The selceted service is a dangerous goods service. But the dangerous goods data is missing in the data set.<br />
|}<br />
<br />
== Group 04 - Configuration error ==<br />
Errors in group 04 mostly have their cause due to a not fully configurated module in the HVS32 or in the Carrier API. It is also possible that the data set is incorrect and refers to a false configuration (e.g. when an invalid dispatch type ID is sent).<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-000-04-C00001 || No dispatch type found for id: [Dispatch type ID] || Die Carrier API kann keinen Konfigurationseintrag mit der gewählten Versandart-ID finden. Entweder ist die Konfiguration unvollständig oder die übergebene Versandart-ID ist falsch.<br />
|-<br />
| CAP-000-04-C00002 || No client found for id: [Client ID] || Die Carrier API kann keinen Konfigurationseintrag mit der gewählten Auftraggeber-ID finden. Entweder ist die Konfiguration unvollständig oder die übergebene Auftraggeber-ID ist falsch.<br />
|-<br />
|-<br />
| CAP-000-04-C00003 || Plugin [Plugin] is not licensed || Die Versandart bzw. der Endpoint verweist auf ein Frachtführer-Plugin welches noch nicht oder nicht mehr lizensiert ist. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00004 || No endpoint defined for dispatch type: [Dispatch type ID] || Die gewählte Versandart wurde in der Carrier API gefunden allerdings nicht den Endpoint, auf welche diese Versandart verweist. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00005 || Endpoint url is invalid: [URL] || Bei der im Endpoint konfigurierten URL handelt es sich nicht um eine gültige URL. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00006 || Invalid configuration for: [Configuration details] || Eine Frachtführer-spezifische Konfiguration ist unvollständig. Bitte prüfen Sie die Detaillierte Fehlermeldung für mehr Details<br />
|}<br />
<br />
<br />
== Carrier-specific errors ==<br />
Some carriers have special error codes that can not be be generally assigned. In most cases, it is an extended validation error from group 03.<br />
<br />
<br />
=== GLS Ship IT ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-GLS-03-E00050 || Invalid GLS contact id || Die im HVS32 konfigurierte Contact ID fehlt oder ist ungültig<br />
|}<br />
<br />
<br />
=== Hermes Shipping Interface (HSI) ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-HEH-03-E00050 || Invalid package type and dimensions. At least one is required. || Hermes hat Verpackungen im Format XS, S, M, L, XL<br />
|-<br />
|-<br />
| CAP-HEH-03-E00051 || Invalid birthday for ident service || Für diese Sendung wurde ein Ident-Service gewählt. Das Geburtsdatum fehlt allerdings oder handelt sich nicht um ein gültiges Datum.<br />
|}<br />
<br />
<br />
=== Schenker AT ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-SHA-03-E00050 || Error in hazardous goods dataset. Invalid UN number. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die UN-Nummer<br />
|-<br />
|-<br />
| CAP-SHA-03-E00051 || Error in hazardous goods dataset. Invalid DG class. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Klasse.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00052 || Error in hazardous goods dataset. Invalid dg weight. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie das GG-Gewicht.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00053 || Error in hazardous goods dataset. Invalid package type. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsart.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00054 || Error in hazardous goods dataset. Invalid dg package group. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsgruppe.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00055 || Error in hazardous goods dataset. Invalid shipping name. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Bezeichnung<br />
|-<br />
|-<br />
| CAP-SHA-03-E00056 || Error in hazardous goods dataset. No net explosive mass defined for dg class 1. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die Netto-Explosivmasse. Außerdem: Wurde mit Schenker AT abgesprochen, dass Sie Torpedos verschicken?<br />
|-<br />
|-<br />
| CAP-SHA-03-E00057 || Error in hazardous goods dataset. Invalid unit of measurement. <br />
| Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie den Mengen-Typ (kg oder l)<br />
|}<br />
<br />
<br />
== Plugin codes ==<br />
Each plugin has its own sub-group for an error code. All plugins are listed in the following.<br />
<br />
{| class="wikitable sortable"<br />
|-<br />
! Code !! Plugin<br />
|-<br />
| 000 || Unbekannt - Plugin konnte noch nicht ermittelt werden<br />
|-<br />
| ACO || Arco<br />
|-<br />
| AGX || AGX<br />
|-<br />
| AMZ || Amazon Merchant Fulfillment<br />
|-<br />
| ANL || ANGEL<br />
|-<br />
| ASE || Asendia<br />
|-<br />
| ASM || Amazon Selling Partner API - Merchant Fulfillment<br />
|-<br />
| ASV || Amazon Selling Partner API - Vendor Direct<br />
|-<br />
| ATL || Atlas<br />
|-<br />
| CAL || Canis Lupus<br />
|-<br />
| CEN || Centiro<br />
|-<br />
| CHR || Chronopost<br />
|-<br />
| CIP || Citipost<br />
|-<br />
| COU || Coureon<br />
|-<br />
| DBB || DHL ES B2B<br />
|-<br />
| DCS || DCS<br />
|-<br />
| DEC || DHL eConnect<br />
|-<br />
| DEL || DHL Express Routing Live<br />
|-<br />
| DET || DHL Express Routing Test<br />
|-<br />
| DFR || DPD FR (Frankreich)<br />
|-<br />
| DHA || DHL ELP (Abholung)<br />
|-<br />
| DHE || DHL ES B2C<br />
|-<br />
| DHH || DHL Global Web Service (Ungarn)<br />
|-<br />
| DHN || DHL NL<br />
|-<br />
| DHP || DHL 24 PL<br />
|-<br />
| DHS || DHL SK (Slowakei)<br />
|-<br />
| DIM || Internetmarke (Deutsche Post)<br />
|-<br />
| DPA || DPD AT (Österreich)<br />
|-<br />
| DPL || DPD PL (Polen)<br />
|-<br />
| DPC || DPD HR (Kroatien)<br />
|-<br />
| DPH || DPD HU (Ungarn)<br />
|-<br />
| DPP || DPD DE Parcelshop Suche<br />
|-<br />
| DPR || DPD RO (Rumänien)<br />
|-<br />
| DRI || DHL Retoure International<br />
|-<br />
| DRL || DHL Retoure International (Legacy - veraltet)<br />
|-<br />
| DSK || Danske<br />
|-<br />
| DVF || AM.Exchange (DV-Freimachung)<br />
|-<br />
| EPK || Europaket<br />
|-<br />
| FED || Fedex<br />
|-<br />
| FAC || Fiege Amazon Carma<br />
|-<br />
| FTD || Fedex Trade Documents<br />
|-<br />
| FXA || Fedex (Abholung)<br />
|-<br />
| FXP || Fedex PL (Polen)<br />
|-<br />
| FXS || Fedex Stratus REST API<br />
|-<br />
| GEO || Geodis<br />
|-<br />
| GLD || GLS DK (Dänemark)<br />
|-<br />
| GLE || GLS ES (Spanien)<br />
|-<br />
| GLF || GLS FR (Frankreich)<br />
|-<br />
| GLH || GLS HU (Ungarn)<br />
|-<br />
| GLI || GLS IT (Italien)<br />
|-<br />
| GLK || GLS SK (Slowakei)<br />
|-<br />
| GLL || GLS CZ (Tschechien)<br />
|-<br />
| GLN || GLS NL (Niederlande)<br />
|-<br />
| GLO || Glovo<br />
|-<br />
| GLP || GLS PL (Polen)<br />
|-<br />
| GLS || GLS DE / Ship IT (Deutschland)<br />
|-<br />
| GPP || General Purpose (konfigurierbar), auch G00 - G99<br />
|-<br />
| GPS || GLS Parcel Shop (GLS DE Parcelshop Suche)<br />
|-<br />
| GSA || GLS AT / Ship IT (Österreich)<br />
|-<br />
| GSF || GLS FR / Ship IT (Frankreich)<br />
|-<br />
| GTT || GLS DE Track & Trace<br />
|-<br />
| HBG || Hermes Border Guru<br />
|-<br />
| HEH || Hermes Shipping Interface (HSI)<br />
|-<br />
| HES || Hermes Einrichtungs Service (HES)<br />
|-<br />
| HRB || Hornbach<br />
|-<br />
| HMP || Hellmann PL (Polen)<br />
|-<br />
|ICS || ICS<br />
|-<br />
| INP || Inpost24<br />
|-<br />
| IZP || Infens Zustellprofi<br />
|-<br />
|KOV || Kommt Overnight<br />
|-<br />
| KUR || Der Kurier<br />
|-<br />
| LFG || Liefergrün<br />
|-<br />
| LGX || Log X Star<br />
|-<br />
| MON || Mondial Relay<br />
|-<br />
| NCX || Nacex<br />
|-<br />
| OMS || Omest<br />
|-<br />
| ONT || Ontime<br />
|-<br />
| PAT || Post AT (Österreich)<br />
|-<br />
| PFI || Posti FI (Finnland)<br />
|-<br />
| PHR || Posti HR (Kroatien)<br />
|-<br />
| PIL || Pilot<br />
|-<br />
| PPL || PPL<br />
|-<br />
| PSI || Post SI (Slovenien)<br />
|-<br />
| PSK || Post SK (Slovakei)<br />
|-<br />
| SES || Seven Senders (7senders)<br />
|-<br />
| SHA || Schenker AT (Österreich)<br />
|-<br />
| SHD || Schenker<br />
|-<br />
| SHS || Schenker SE (Schweden)<br />
|-<br />
| SND || Sending<br />
|-<br />
| TBN || TNT NL - Retoure Belgien<br />
|-<br />
| TMP || TMParcel<br />
|-<br />
| TNF || TNT FR (Frankreich)<br />
|-<br />
| TNI || TNT IT (Italien)<br />
|-<br />
| TNN || TNT Post NL (Niederlande)<br />
|-<br />
| TNT || TNT (Deutschland)<br />
|-<br />
| TOH || TOF HU (Ungarn)<br />
|-<br />
| TPN || TPN<br />
|-<br />
| TRA || Tradebyte<br />
|-<br />
| TRM || Tiramizoo<br />
|-<br />
| UPA || UPS Pickup (Abholung)<br />
|-<br />
| UPG || UPS GG (Gefahrgut PreAvis)<br />
|-<br />
| UPP || UPS Paperless Document<br />
|-<br />
| UPT || UPS Tarifierung <br />
|-<br />
| VNP || Venipak<br />
|-<br />
| WYF || Wayfair<br />
|}</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Carrier_API_error_codes&diff=5876Carrier API error codes2024-08-07T13:38:28Z<p>Ddang: </p>
<hr />
<div>[[de:Carrier_API_Fehlercodes]]<br />
<br />
== General ==<br />
Error codes in the Carrier API appear in the following form <code>AAA-SSS-GG-L[Code]</code>, where<br />
* AAA = Application, in this case only CAP for CarrierAPI<br />
* SSS = Sub group, in this case the plugin. A list of plugins can be found further down.<br />
* GG = Error group, this divides the errors in categories, where the cause normally originates from<br />
* L = Error-level, the severeness of the error: W = Warning, E = Error, C = Critical, F = Fatal<br />
* [Code] = A numerical Code that clearly assigns the error in this group.<br />
<br />
<br />
<br />
Example: <code>CAP-HEH-02-E00005</code><br />
<br />
Means there is an error in the Hermes HSI module in group 02 (content-related error) with code 5 (authentification failed).<br />
<br />
<br />
<br />
To search for an error, search on this site <code>(Strg+F)</code> with the acutal code.<br />
<br />
If you can not find the code directly, replace the sub group, e.g. "HEH" with <code>XXX</code>. From the top example: <code>CAP-XXX-02-E00005</code>. This code is available in group 02.<br />
<br />
<br />
== Group 00 - Fundamental errors ==<br />
These errors appear if the error cause is unknown (e.g. 00000 - undefined error) or when a fundamental problem lies within the functionalities of the Carrier API.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-00-E00000 || Error in webservice request: [Error message] || Error cause unknown. Examine exact error message, if necessary check logs.<br />
|-<br />
| CAP-XXX-00-E00001 || Unable to create plugin || Problem when calling the webservice plugin. Please contact support<br />
|-<br />
| CAP-XXX-00-E00002 || The selected Carrier API plugin has been deprecated. Please contact Heidler Support || The selected Carrier API plugin is deprecated and the webservice is discontinued by the carrier. Please contact support<br />
|}<br />
<br />
== Group 01 - Technical errors in the request ==<br />
These errors appear if the request was not successful due to a technical error. They can be temporary problems, e.g. the server is not accessible (00001 - connection error) or overloaded (00002 - Read timeout). Or fundamental problems which require interference (00004 - certificate error).<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-01-C00001 || [Connection error / Connection timeout] Unable to connect to webservice. Please check your internet connection, url, firewall, or proxy settings. || Connection error: No connection possible. Maybe the request was blocked.<br />
Connect timeout: The Carrier API could not determine that the connection was blocked. Maybe the connection quality is insufficient.<br />
|-<br />
| CAP-XXX-01-E00002 || Read timeout: The webservice did not respond in a timely manner. || Normally, the server of the carrier is overloaded. You can try to increase the Read timeout in the general settings or for this specific endpoint.<br />
|-<br />
|-<br />
| CAP-XXX-01-C00003 || DNS error: The url [URL] is unknown || Your DNS-Server blocks the request of the Carrier API or the URL set is not correct.<br />
|-<br />
|-<br />
| CAP-XXX-01-C00004 || Unable to verify webservice certificate. Please check your firewall or url. || If your firewall contains a deep packet inspection, it provides a certificate in between, which is unknown to the Carrier API. The Carrier API interprets it as a [https://de.wikipedia.org/wiki/Man-in-the-Middle-Angriff Man-in-the-Middle-Angriff].<br />
If you trust the certificate, you can save it X.509 coded under [CarrierAPI]\config\certs.<br />
|-<br />
|-<br />
| CAP-XXX-01-F00005 || Deserialization error: The webservice returned an invalid document || Please contact support.<br />
|-<br />
|-<br />
| CAP-XXX-01-E00006 || Label conversion error || Please contact support.<br />
|}<br />
<br />
<br />
== Group 02 - Content-related errors in the request ==<br />
The communication with the webservice was successful, but the response does not math the expectation. Normally, the webservice has found an error in the request (shipment data set) and returns it.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-02-E00001 || General response error || The Carrier API can not assign the error. Please check the exact error message to this error code.<br />
|-<br />
| CAP-XXX-02-E00002 || Webservice returned error: [Error message] || The webservice has responded with an exact error code and/or error message. Please check it and correct the data set if necessary.<br />
|-<br />
| CAP-XXX-02-E00003 || Webservice returned an invalid response: [Error detail] || The response from the webservice does not match the conventions known by the Carrier API. Possibly some mandatory fields are missing in the response (e.g. tracking number or label data). Please check the eroor details and contact the support if necessary.<br />
|-<br />
| CAP-XXX-02-E00004 || Webservice returned HTTP [HTTP-Code] || No detailed error details are known except for the webservice respoding with a "not OK".<br />
In the logs of the Carrier API you can normally findthe whole response from the webservice wich may contain more details.<br />
|-<br />
| CAP-XXX-02-E00005 || Authentication with the webservice failed. Please check your login details. || Normally the access data set in the Carrier API is wrong or the carrier has not unlocked your account yet.<br />
|-<br />
| CAP-XXX-02-E00006 || The webservice did not change the shipment status within a reasonable amount of time (asynchronous webservice operation). <br />
| With asynchronous webservices (e.g. Inpost24 or FedEx Stratus), the Carrier API waits until the webservice responds with a Completed or Error status. If this does not occur in time, the Carrier API throws this error.<br />
|}<br />
<br />
== Group 03 - Validation error ==<br />
For some carriers, the Carrier API executes a limited validation and returns an error even before the request to the webservice, when it is predictable that the request is not accepted by the carrier.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-03-E00001 || Validation error: [Error details] || Validierungsfehler, welcher nicht unter einer der folgenden Kategorien zutrifft. Bitte die Fehler-Details prüfen.<br />
|-<br />
| CAP-XXX-03-E00002 || Invalid reference number || Der Webservice benötigt eine eindeutige Referenz-Nummer (z.B. Lieferschein-Nr.)<br />
|-<br />
|-<br />
| CAP-XXX-03-E00003 || Receiver address is invalid || z.B. fehlende PLZ, Straße, Haus-Nr. usw.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00004 || Street and house number needs to be separated <br />
| In der Sendung müssen Straße und Hausnummer separiert werden. Entweder wurde die Trennung im HVS32 nicht konfiguriert (Support kontaktieren) oder die Trennung war nicht erfolgreich (Datensatz kontrollieren: Hausnummer ganz am Ende oder Anfang der Straße?)<br />
|-<br />
|-<br />
| CAP-XXX-03-E00005 || Unable to separate first and last name for: [Name] || Für die Trennung von Vor- und Nachnamen sind immer zwei Wörter erforderlich.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00006 || Invalid incoterm id || Entweder fehlt eine Frankatur komplett oder der Frachtführer akzeptiert nur ganz bestimmte Frankaturen.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00007 || Target date is invalid || Es wurde ein Dienst ausgewählt welcher ein Termin-Datum erwartet. Dieses ist entweder nicht belegt oder liegt in der Vergangenheit.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00008 || Customer / account number is invalid || Die Kunden-Nr. im HVS32-Konfigurator oder der Benutzer im Carrier API Konfigurator entspricht nicht den Vorgaben des Frachtführers (z.B. numerisch).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00009 || Shipment number is invalid || Das HVS32 sollte eigentlich eine (Versand-)Sendungs-Nummer erzeugen (Support kontaktieren) oder erwartet diese aus dem Vorsystem (Datensatz prüfen).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00010 || Tracking number is invalid || Das HVS32 sollte eigentlich eine Trackingnummer erzeugen (Support kontaktieren) oder erwartet diese aus dem Vorsystem (Datensatz prüfen).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00011 || Service type id is invalid || Der konfigurierte Dienst ist für diesen Frachtführer nicht gültig.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00012 || Invalid e-mail address || Diese Sendung benötigt mit dem gewählten Dienst eine E-Mail Adresse. Diese wurde nicht übergeben. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00013 || Invalid phone number || Diese Sendung benötigt mit dem gewählten Dienst eine Telefon-Nummer. Diese wurde nicht übergeben. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00014 || Invalid value of goods || Diese Sendung benötigt mit dem gewählten Dienst einen Warenwert. Diese wurde nicht übergeben oder ist keine gültige Zahl. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00015 || Invalid insurance value || Diese Sendung benötigt mit dem gewählten Dienst einen Versicherungswert. Diese wurde nicht übergeben oder ist keine gültige Zahl. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00016 || Invalid id for parcel shop || Für diese Sendung wurde eine Paketshop-Lieferung gewählt. Allerdings fehlt die dazugehörige Paketshop-ID oder sie ist nicht gültig (z.B. numerisch).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00017 || The requested service requires additional data. || Für diese Sendung wurde ein spezifischer Dienst gewählt. Allerdings fehlen für diesen Dienst zusätzliche Informationen, welche nun notwendig sind.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00030 || Weight is invalid || Das angegebene Packstück-Gewicht entspricht nicht den Vorgaben des Frachtführers (z.B. 0 kg oder mehr als der Frachtführer akzeptiert). Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00031 || Package dimensions are invalid. || Der Frachtführer erwartet Paketabmessungen welche im Datensatz fehlen. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00032 || Package type id is invalid || Entweder fehlt die Verpackungsart komplett oder der Frachtführer akzeptiert nur ganz bestimmte Verpackungsarten.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00033 || Package contents are invalid || Diese Sendung benötigt mit dem gewählten Dienst den Paketinhalt. Dieser wurde nicht übergeben. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00038 || No article data available in package || Sendungen ins EU-Ausland benötigen in der Regel zusätzlich Artikeldaten um die Zollinformationen korrekt zu übergeben.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00039 || No hazardous goods data available in package || Beim gewählten Dienst handelt es sich um einen Gefahrgut-Dienst. Allerdings fehlen im Datensatz die Gefahrgutdaten.<br />
|}<br />
<br />
== Group 04 - Configuration error ==<br />
Errors in group 04 mostly have their cause due to a not fully configurated module in the HVS32 or in the Carrier API. It is also possible that the data set is incorrect and refers to a false configuration (e.g. when an invalid dispatch type ID is sent).<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-000-04-C00001 || No dispatch type found for id: [Dispatch type ID] || Die Carrier API kann keinen Konfigurationseintrag mit der gewählten Versandart-ID finden. Entweder ist die Konfiguration unvollständig oder die übergebene Versandart-ID ist falsch.<br />
|-<br />
| CAP-000-04-C00002 || No client found for id: [Client ID] || Die Carrier API kann keinen Konfigurationseintrag mit der gewählten Auftraggeber-ID finden. Entweder ist die Konfiguration unvollständig oder die übergebene Auftraggeber-ID ist falsch.<br />
|-<br />
|-<br />
| CAP-000-04-C00003 || Plugin [Plugin] is not licensed || Die Versandart bzw. der Endpoint verweist auf ein Frachtführer-Plugin welches noch nicht oder nicht mehr lizensiert ist. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00004 || No endpoint defined for dispatch type: [Dispatch type ID] || Die gewählte Versandart wurde in der Carrier API gefunden allerdings nicht den Endpoint, auf welche diese Versandart verweist. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00005 || Endpoint url is invalid: [URL] || Bei der im Endpoint konfigurierten URL handelt es sich nicht um eine gültige URL. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00006 || Invalid configuration for: [Configuration details] || Eine Frachtführer-spezifische Konfiguration ist unvollständig. Bitte prüfen Sie die Detaillierte Fehlermeldung für mehr Details<br />
|}<br />
<br />
<br />
== Carrier-specific errors ==<br />
Some carriers have special error codes that can not be be generally assigned. In most cases, it is an extended validation error from group 03.<br />
<br />
<br />
=== GLS Ship IT ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-GLS-03-E00050 || Invalid GLS contact id || Die im HVS32 konfigurierte Contact ID fehlt oder ist ungültig<br />
|}<br />
<br />
<br />
=== Hermes Shipping Interface (HSI) ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-HEH-03-E00050 || Invalid package type and dimensions. At least one is required. || Hermes hat Verpackungen im Format XS, S, M, L, XL<br />
|-<br />
|-<br />
| CAP-HEH-03-E00051 || Invalid birthday for ident service || Für diese Sendung wurde ein Ident-Service gewählt. Das Geburtsdatum fehlt allerdings oder handelt sich nicht um ein gültiges Datum.<br />
|}<br />
<br />
<br />
=== Schenker AT ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-SHA-03-E00050 || Error in hazardous goods dataset. Invalid UN number. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die UN-Nummer<br />
|-<br />
|-<br />
| CAP-SHA-03-E00051 || Error in hazardous goods dataset. Invalid DG class. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Klasse.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00052 || Error in hazardous goods dataset. Invalid dg weight. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie das GG-Gewicht.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00053 || Error in hazardous goods dataset. Invalid package type. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsart.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00054 || Error in hazardous goods dataset. Invalid dg package group. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsgruppe.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00055 || Error in hazardous goods dataset. Invalid shipping name. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Bezeichnung<br />
|-<br />
|-<br />
| CAP-SHA-03-E00056 || Error in hazardous goods dataset. No net explosive mass defined for dg class 1. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die Netto-Explosivmasse. Außerdem: Wurde mit Schenker AT abgesprochen, dass Sie Torpedos verschicken?<br />
|-<br />
|-<br />
| CAP-SHA-03-E00057 || Error in hazardous goods dataset. Invalid unit of measurement. <br />
| Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie den Mengen-Typ (kg oder l)<br />
|}<br />
<br />
<br />
== Plugin codes ==<br />
Each plugin has its own sub-group for an error code. All plugins are listed in the following.<br />
<br />
{| class="wikitable sortable"<br />
|-<br />
! Code !! Plugin<br />
|-<br />
| 000 || Unbekannt - Plugin konnte noch nicht ermittelt werden<br />
|-<br />
| ACO || Arco<br />
|-<br />
| AGX || AGX<br />
|-<br />
| AMZ || Amazon Merchant Fulfillment<br />
|-<br />
| ANL || ANGEL<br />
|-<br />
| ASE || Asendia<br />
|-<br />
| ASM || Amazon Selling Partner API - Merchant Fulfillment<br />
|-<br />
| ASV || Amazon Selling Partner API - Vendor Direct<br />
|-<br />
| ATL || Atlas<br />
|-<br />
| CAL || Canis Lupus<br />
|-<br />
| CEN || Centiro<br />
|-<br />
| CHR || Chronopost<br />
|-<br />
| CIP || Citipost<br />
|-<br />
| COU || Coureon<br />
|-<br />
| DBB || DHL ES B2B<br />
|-<br />
| DCS || DCS<br />
|-<br />
| DEC || DHL eConnect<br />
|-<br />
| DEL || DHL Express Routing Live<br />
|-<br />
| DET || DHL Express Routing Test<br />
|-<br />
| DFR || DPD FR (Frankreich)<br />
|-<br />
| DHA || DHL ELP (Abholung)<br />
|-<br />
| DHE || DHL ES B2C<br />
|-<br />
| DHH || DHL Global Web Service (Ungarn)<br />
|-<br />
| DHN || DHL NL<br />
|-<br />
| DHP || DHL 24 PL<br />
|-<br />
| DHS || DHL SK (Slowakei)<br />
|-<br />
| DIM || Internetmarke (Deutsche Post)<br />
|-<br />
| DPA || DPD AT (Österreich)<br />
|-<br />
| DPL || DPD PL (Polen)<br />
|-<br />
| DPC || DPD HR (Kroatien)<br />
|-<br />
| DPH || DPD HU (Ungarn)<br />
|-<br />
| DPP || DPD DE Parcelshop Suche<br />
|-<br />
| DPR || DPD RO (Rumänien)<br />
|-<br />
| DRI || DHL Retoure International<br />
|-<br />
| DRL || DHL Retoure International (Legacy - veraltet)<br />
|-<br />
| DSK || Danske<br />
|-<br />
| DVF || AM.Exchange (DV-Freimachung)<br />
|-<br />
| EPK || Europaket<br />
|-<br />
| FED || Fedex<br />
|-<br />
| FAC || Fiege Amazon Carma<br />
|-<br />
| FTD || Fedex Trade Documents<br />
|-<br />
| FXA || Fedex (Abholung)<br />
|-<br />
| FXP || Fedex PL (Polen)<br />
|-<br />
| FXS || Fedex Stratus REST API<br />
|-<br />
| GEO || Geodis<br />
|-<br />
| GLD || GLS DK (Dänemark)<br />
|-<br />
| GLE || GLS ES (Spanien)<br />
|-<br />
| GLF || GLS FR (Frankreich)<br />
|-<br />
| GLH || GLS HU (Ungarn)<br />
|-<br />
| GLI || GLS IT (Italien)<br />
|-<br />
| GLK || GLS SK (Slowakei)<br />
|-<br />
| GLL || GLS CZ (Tschechien)<br />
|-<br />
| GLN || GLS NL (Niederlande)<br />
|-<br />
| GLO || Glovo<br />
|-<br />
| GLP || GLS PL (Polen)<br />
|-<br />
| GLS || GLS DE / Ship IT (Deutschland)<br />
|-<br />
| GPP || General Purpose (konfigurierbar), auch G00 - G99<br />
|-<br />
| GPS || GLS Parcel Shop (GLS DE Parcelshop Suche)<br />
|-<br />
| GSA || GLS AT / Ship IT (Österreich)<br />
|-<br />
| GSF || GLS FR / Ship IT (Frankreich)<br />
|-<br />
| GTT || GLS DE Track & Trace<br />
|-<br />
| HBG || Hermes Border Guru<br />
|-<br />
| HEH || Hermes Shipping Interface (HSI)<br />
|-<br />
| HES || Hermes Einrichtungs Service (HES)<br />
|-<br />
| HRB || Hornbach<br />
|-<br />
| HMP || Hellmann PL (Polen)<br />
|-<br />
|ICS || ICS<br />
|-<br />
| INP || Inpost24<br />
|-<br />
| IZP || Infens Zustellprofi<br />
|-<br />
|KOV || Kommt Overnight<br />
|-<br />
| KUR || Der Kurier<br />
|-<br />
| LFG || Liefergrün<br />
|-<br />
| LGX || Log X Star<br />
|-<br />
| MON || Mondial Relay<br />
|-<br />
| NCX || Nacex<br />
|-<br />
| OMS || Omest<br />
|-<br />
| ONT || Ontime<br />
|-<br />
| PAT || Post AT (Österreich)<br />
|-<br />
| PFI || Posti FI (Finnland)<br />
|-<br />
| PHR || Posti HR (Kroatien)<br />
|-<br />
| PIL || Pilot<br />
|-<br />
| PPL || PPL<br />
|-<br />
| PSI || Post SI (Slovenien)<br />
|-<br />
| PSK || Post SK (Slovakei)<br />
|-<br />
| SES || Seven Senders (7senders)<br />
|-<br />
| SHA || Schenker AT (Österreich)<br />
|-<br />
| SHD || Schenker<br />
|-<br />
| SHS || Schenker SE (Schweden)<br />
|-<br />
| SND || Sending<br />
|-<br />
| TBN || TNT NL - Retoure Belgien<br />
|-<br />
| TMP || TMParcel<br />
|-<br />
| TNF || TNT FR (Frankreich)<br />
|-<br />
| TNI || TNT IT (Italien)<br />
|-<br />
| TNN || TNT Post NL (Niederlande)<br />
|-<br />
| TNT || TNT (Deutschland)<br />
|-<br />
| TOH || TOF HU (Ungarn)<br />
|-<br />
| TPN || TPN<br />
|-<br />
| TRA || Tradebyte<br />
|-<br />
| TRM || Tiramizoo<br />
|-<br />
| UPA || UPS Pickup (Abholung)<br />
|-<br />
| UPG || UPS GG (Gefahrgut PreAvis)<br />
|-<br />
| UPP || UPS Paperless Document<br />
|-<br />
| UPT || UPS Tarifierung <br />
|-<br />
| VNP || Venipak<br />
|-<br />
| WYF || Wayfair<br />
|}</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Carrier_API_error_codes&diff=5875Carrier API error codes2024-08-07T13:06:47Z<p>Ddang: </p>
<hr />
<div>[[de:Carrier_API_Fehlercodes]]<br />
<br />
== General ==<br />
Error codes in the Carrier API appear in the following form <code>AAA-SSS-GG-L[Code]</code>, where<br />
* AAA = Application, in this case only CAP for CarrierAPI<br />
* SSS = Sub group, in this case the plugin. A list of plugins can be found further down.<br />
* GG = Error group, this divides the errors in categories, where the cause normally originates from<br />
* L = Error-level, the severeness of the error: W = Warning, E = Error, C = Critical, F = Fatal<br />
* [Code] = A numerical Code that clearly assigns the error in this group.<br />
<br />
<br />
<br />
Example: <code>CAP-HEH-02-E00005</code><br />
<br />
Means there is an error in the Hermes HSI module in group 02 (content-related error) with code 5 (authentification failed).<br />
<br />
<br />
<br />
To search for an error, search on this site <code>(Strg+F)</code> with the acutal code.<br />
<br />
If you can not find the code directly, replace the sub group, e.g. "HEH" with <code>XXX</code>. From the top example: <code>CAP-XXX-02-E00005</code>. This code is available in group 02.<br />
<br />
<br />
== Group 00 - Fundamental errors ==<br />
These errors appear if the error cause is unknown (e.g. 00000 - undefined error) or when a fundamental problem lies within the functionalities of the Carrier API.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-00-E00000 || Error in webservice request: [Error message] || Fehlerursache nicht bekannt. Genaue Fehlermeldung untersuchen, ggf. Logs einsehen.<br />
|-<br />
| CAP-XXX-00-E00001 || Unable to create plugin || Problem beim aufrufen des jeweiligen Webservice-Plugins. Bitte Support kontaktieren<br />
|-<br />
| CAP-XXX-00-E00002 || The selected Carrier API plugin has been deprecated. Please contact Heidler Support || Das gewählte Carrier API Plugin ist veraltet und der Webservice wurde vom Frachtführer abgekündigt. Bitte Support kontaktieren<br />
|}<br />
<br />
== Group 01 - Technical errors in the request ==<br />
These errors appear if the request was not successful due to a technical error. They can be temporary problems, e.g. the server is not accessible (00001 - connection error) or overloaded (00002 - Read timeout). Or fundamental problems which require interference (00004 - certificate error).<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-01-C00001 || [Connection error / Connection timeout] Unable to connect to webservice. Please check your internet connection, url, firewall, or proxy settings. || Connection error: Verbindung nicht möglich. Eventuell wurde die Anfrage blockiert.<br />
Connect timeout: Die Carrier API konnte nicht feststellen, dass die Verbindung blockiert wurde. Eventuell ist die Verbindungsqualität nicht ausreichend.<br />
|-<br />
| CAP-XXX-01-E00002 || Read timeout: The webservice did not respond in a timely manner. || In der Regel ist der Server vom Frachtführer überlastet. Sie können in den allgemeinen Einstellungen oder für diesen Endpoint versuchen, den Read timeout auf einen höheren Wert zu stellen.<br />
|-<br />
|-<br />
| CAP-XXX-01-C00003 || DNS error: The url [URL] is unknown || Entweder blockiert Ihr DNS-Server die Anfrage der Carrier API oder die hinterlegte URL ist nicht korrekt.<br />
|-<br />
|-<br />
| CAP-XXX-01-C00004 || Unable to verify webservice certificate. Please check your firewall or url. || Falls Ihre Firewall eine deep packet inspection enthält, stellt Sie ein Zwischen-Zertifikat bereit, welches der Carrier API nicht bekannt ist. Das wird von der Carrier-API als [https://de.wikipedia.org/wiki/Man-in-the-Middle-Angriff Man-in-the-Middle-Angriff] interpretiert.<br />
Wenn Sie dem Zertifikat vertrauen, können Sie es X.509 kodiert unter [CarrierAPI]\config\certs hinterlegen.<br />
|-<br />
|-<br />
| CAP-XXX-01-F00005 || Deserialization error: The webservice returned an invalid document || Bitte Support kontaktieren.<br />
|-<br />
|-<br />
| CAP-XXX-01-E00006 || Label conversion error || Bitte Support kontaktieren.<br />
|}<br />
<br />
<br />
== Group 02 - Content-related errors in the request ==<br />
The communication with the webservice was successful, but the response does not math the expectation. Normally, the webservice has found an error in the request (shipment data set) and returns it.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-02-E00001 || General response error || Die Carrier API kann den Fehler nicht genau zuordnen. Bitte prüfen Sie die genaue Fehlermeldung zu diesem Fehlercode.<br />
|-<br />
| CAP-XXX-02-E00002 || Webservice returned error: [Error message] || Der Webservice hat einen genauen Fehlercode und/oder Fehlertext zurückgemeldet. Bitte diesen genau prüfen und ggf. den Datensatz korrigieren.<br />
|-<br />
| CAP-XXX-02-E00003 || Webservice returned an invalid response: [Error detail] || Die Antwort vom Webservice entspricht nicht den Konventionen, welche der Carrier API bekannt sind. Es fehlen u.U. Pflichtfelder in der Antwort (z.B. Tracking-Nummer oder Label-Daten). Bitte prüfen Sie die Fehler-Details und kontaktieren Sie ggf. den Support.<br />
|-<br />
| CAP-XXX-02-E00004 || Webservice returned HTTP [HTTP-Code] || Es sind keine genauen Fehler-Details bekannt, außer dass der Webservice generell ein "Nicht-OK" zurückgegeben hat.<br />
In den Logs der Carrier API finden Sie in der Regel die gesamte Antwort des Webservice, welche eventuell weitere Details enthalten.<br />
|-<br />
| CAP-XXX-02-E00005 || Authentication with the webservice failed. Please check your login details. || In der Regel sind die in der Carrier API hinterlegten Zugangsdaten falsch, oder der Frachtführer hat Ihren Account noch nicht freigeschaltet.<br />
|-<br />
| CAP-XXX-02-E00006 || The webservice did not change the shipment status within a reasonable amount of time (asynchronous webservice operation). <br />
| Bei asynchronen Webservices (z.B: Inpost24 oder FedEx Stratus) wartet die Carrier API bis vom Webservice ein Abgeschlossen- oder Fehler-Status zurück kommt. Sollte dies nicht rechtzeitig erfolgen, dann wirft die Carrier API diesen Fehler.<br />
|}<br />
<br />
== Group 03 - Validation error ==<br />
For some carriers, the Carrier API executes a limited validation and returns an error even before the request to the webservice, when it is predictable that the request is not accepted by the carrier.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-03-E00001 || Validation error: [Error details] || Validierungsfehler, welcher nicht unter einer der folgenden Kategorien zutrifft. Bitte die Fehler-Details prüfen.<br />
|-<br />
| CAP-XXX-03-E00002 || Invalid reference number || Der Webservice benötigt eine eindeutige Referenz-Nummer (z.B. Lieferschein-Nr.)<br />
|-<br />
|-<br />
| CAP-XXX-03-E00003 || Receiver address is invalid || z.B. fehlende PLZ, Straße, Haus-Nr. usw.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00004 || Street and house number needs to be separated <br />
| In der Sendung müssen Straße und Hausnummer separiert werden. Entweder wurde die Trennung im HVS32 nicht konfiguriert (Support kontaktieren) oder die Trennung war nicht erfolgreich (Datensatz kontrollieren: Hausnummer ganz am Ende oder Anfang der Straße?)<br />
|-<br />
|-<br />
| CAP-XXX-03-E00005 || Unable to separate first and last name for: [Name] || Für die Trennung von Vor- und Nachnamen sind immer zwei Wörter erforderlich.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00006 || Invalid incoterm id || Entweder fehlt eine Frankatur komplett oder der Frachtführer akzeptiert nur ganz bestimmte Frankaturen.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00007 || Target date is invalid || Es wurde ein Dienst ausgewählt welcher ein Termin-Datum erwartet. Dieses ist entweder nicht belegt oder liegt in der Vergangenheit.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00008 || Customer / account number is invalid || Die Kunden-Nr. im HVS32-Konfigurator oder der Benutzer im Carrier API Konfigurator entspricht nicht den Vorgaben des Frachtführers (z.B. numerisch).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00009 || Shipment number is invalid || Das HVS32 sollte eigentlich eine (Versand-)Sendungs-Nummer erzeugen (Support kontaktieren) oder erwartet diese aus dem Vorsystem (Datensatz prüfen).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00010 || Tracking number is invalid || Das HVS32 sollte eigentlich eine Trackingnummer erzeugen (Support kontaktieren) oder erwartet diese aus dem Vorsystem (Datensatz prüfen).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00011 || Service type id is invalid || Der konfigurierte Dienst ist für diesen Frachtführer nicht gültig.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00012 || Invalid e-mail address || Diese Sendung benötigt mit dem gewählten Dienst eine E-Mail Adresse. Diese wurde nicht übergeben. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00013 || Invalid phone number || Diese Sendung benötigt mit dem gewählten Dienst eine Telefon-Nummer. Diese wurde nicht übergeben. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00014 || Invalid value of goods || Diese Sendung benötigt mit dem gewählten Dienst einen Warenwert. Diese wurde nicht übergeben oder ist keine gültige Zahl. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00015 || Invalid insurance value || Diese Sendung benötigt mit dem gewählten Dienst einen Versicherungswert. Diese wurde nicht übergeben oder ist keine gültige Zahl. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00016 || Invalid id for parcel shop || Für diese Sendung wurde eine Paketshop-Lieferung gewählt. Allerdings fehlt die dazugehörige Paketshop-ID oder sie ist nicht gültig (z.B. numerisch).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00017 || The requested service requires additional data. || Für diese Sendung wurde ein spezifischer Dienst gewählt. Allerdings fehlen für diesen Dienst zusätzliche Informationen, welche nun notwendig sind.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00030 || Weight is invalid || Das angegebene Packstück-Gewicht entspricht nicht den Vorgaben des Frachtführers (z.B. 0 kg oder mehr als der Frachtführer akzeptiert). Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00031 || Package dimensions are invalid. || Der Frachtführer erwartet Paketabmessungen welche im Datensatz fehlen. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00032 || Package type id is invalid || Entweder fehlt die Verpackungsart komplett oder der Frachtführer akzeptiert nur ganz bestimmte Verpackungsarten.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00033 || Package contents are invalid || Diese Sendung benötigt mit dem gewählten Dienst den Paketinhalt. Dieser wurde nicht übergeben. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00038 || No article data available in package || Sendungen ins EU-Ausland benötigen in der Regel zusätzlich Artikeldaten um die Zollinformationen korrekt zu übergeben.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00039 || No hazardous goods data available in package || Beim gewählten Dienst handelt es sich um einen Gefahrgut-Dienst. Allerdings fehlen im Datensatz die Gefahrgutdaten.<br />
|}<br />
<br />
== Group 04 - Configuration error ==<br />
Errors in group 04 mostly have their cause due to a not fully configurated module in the HVS32 or in the Carrier API. It is also possible that the data set is incorrect and refers to a false configuration (e.g. when an invalid dispatch type ID is sent).<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-000-04-C00001 || No dispatch type found for id: [Dispatch type ID] || Die Carrier API kann keinen Konfigurationseintrag mit der gewählten Versandart-ID finden. Entweder ist die Konfiguration unvollständig oder die übergebene Versandart-ID ist falsch.<br />
|-<br />
| CAP-000-04-C00002 || No client found for id: [Client ID] || Die Carrier API kann keinen Konfigurationseintrag mit der gewählten Auftraggeber-ID finden. Entweder ist die Konfiguration unvollständig oder die übergebene Auftraggeber-ID ist falsch.<br />
|-<br />
|-<br />
| CAP-000-04-C00003 || Plugin [Plugin] is not licensed || Die Versandart bzw. der Endpoint verweist auf ein Frachtführer-Plugin welches noch nicht oder nicht mehr lizensiert ist. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00004 || No endpoint defined for dispatch type: [Dispatch type ID] || Die gewählte Versandart wurde in der Carrier API gefunden allerdings nicht den Endpoint, auf welche diese Versandart verweist. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00005 || Endpoint url is invalid: [URL] || Bei der im Endpoint konfigurierten URL handelt es sich nicht um eine gültige URL. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00006 || Invalid configuration for: [Configuration details] || Eine Frachtführer-spezifische Konfiguration ist unvollständig. Bitte prüfen Sie die Detaillierte Fehlermeldung für mehr Details<br />
|}<br />
<br />
<br />
== Carrier-specific errors ==<br />
Some carriers have special error codes that can not be be generally assigned. In most cases, it is an extended validation error from group 03.<br />
<br />
<br />
=== GLS Ship IT ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-GLS-03-E00050 || Invalid GLS contact id || Die im HVS32 konfigurierte Contact ID fehlt oder ist ungültig<br />
|}<br />
<br />
<br />
=== Hermes Shipping Interface (HSI) ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-HEH-03-E00050 || Invalid package type and dimensions. At least one is required. || Hermes hat Verpackungen im Format XS, S, M, L, XL<br />
|-<br />
|-<br />
| CAP-HEH-03-E00051 || Invalid birthday for ident service || Für diese Sendung wurde ein Ident-Service gewählt. Das Geburtsdatum fehlt allerdings oder handelt sich nicht um ein gültiges Datum.<br />
|}<br />
<br />
<br />
=== Schenker AT ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-SHA-03-E00050 || Error in hazardous goods dataset. Invalid UN number. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die UN-Nummer<br />
|-<br />
|-<br />
| CAP-SHA-03-E00051 || Error in hazardous goods dataset. Invalid DG class. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Klasse.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00052 || Error in hazardous goods dataset. Invalid dg weight. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie das GG-Gewicht.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00053 || Error in hazardous goods dataset. Invalid package type. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsart.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00054 || Error in hazardous goods dataset. Invalid dg package group. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsgruppe.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00055 || Error in hazardous goods dataset. Invalid shipping name. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Bezeichnung<br />
|-<br />
|-<br />
| CAP-SHA-03-E00056 || Error in hazardous goods dataset. No net explosive mass defined for dg class 1. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die Netto-Explosivmasse. Außerdem: Wurde mit Schenker AT abgesprochen, dass Sie Torpedos verschicken?<br />
|-<br />
|-<br />
| CAP-SHA-03-E00057 || Error in hazardous goods dataset. Invalid unit of measurement. <br />
| Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie den Mengen-Typ (kg oder l)<br />
|}<br />
<br />
<br />
== Plugin codes ==<br />
Each plugin has its own sub-group for an error code. All plugins are listed in the following.<br />
<br />
{| class="wikitable sortable"<br />
|-<br />
! Code !! Plugin<br />
|-<br />
| 000 || Unbekannt - Plugin konnte noch nicht ermittelt werden<br />
|-<br />
| ACO || Arco<br />
|-<br />
| AGX || AGX<br />
|-<br />
| AMZ || Amazon Merchant Fulfillment<br />
|-<br />
| ANL || ANGEL<br />
|-<br />
| ASE || Asendia<br />
|-<br />
| ASM || Amazon Selling Partner API - Merchant Fulfillment<br />
|-<br />
| ASV || Amazon Selling Partner API - Vendor Direct<br />
|-<br />
| ATL || Atlas<br />
|-<br />
| CAL || Canis Lupus<br />
|-<br />
| CEN || Centiro<br />
|-<br />
| CHR || Chronopost<br />
|-<br />
| CIP || Citipost<br />
|-<br />
| COU || Coureon<br />
|-<br />
| DBB || DHL ES B2B<br />
|-<br />
| DCS || DCS<br />
|-<br />
| DEC || DHL eConnect<br />
|-<br />
| DEL || DHL Express Routing Live<br />
|-<br />
| DET || DHL Express Routing Test<br />
|-<br />
| DFR || DPD FR (Frankreich)<br />
|-<br />
| DHA || DHL ELP (Abholung)<br />
|-<br />
| DHE || DHL ES B2C<br />
|-<br />
| DHH || DHL Global Web Service (Ungarn)<br />
|-<br />
| DHN || DHL NL<br />
|-<br />
| DHP || DHL 24 PL<br />
|-<br />
| DHS || DHL SK (Slowakei)<br />
|-<br />
| DIM || Internetmarke (Deutsche Post)<br />
|-<br />
| DPA || DPD AT (Österreich)<br />
|-<br />
| DPL || DPD PL (Polen)<br />
|-<br />
| DPC || DPD HR (Kroatien)<br />
|-<br />
| DPH || DPD HU (Ungarn)<br />
|-<br />
| DPP || DPD DE Parcelshop Suche<br />
|-<br />
| DPR || DPD RO (Rumänien)<br />
|-<br />
| DRI || DHL Retoure International<br />
|-<br />
| DRL || DHL Retoure International (Legacy - veraltet)<br />
|-<br />
| DSK || Danske<br />
|-<br />
| DVF || AM.Exchange (DV-Freimachung)<br />
|-<br />
| EPK || Europaket<br />
|-<br />
| FED || Fedex<br />
|-<br />
| FAC || Fiege Amazon Carma<br />
|-<br />
| FTD || Fedex Trade Documents<br />
|-<br />
| FXA || Fedex (Abholung)<br />
|-<br />
| FXP || Fedex PL (Polen)<br />
|-<br />
| FXS || Fedex Stratus REST API<br />
|-<br />
| GEO || Geodis<br />
|-<br />
| GLD || GLS DK (Dänemark)<br />
|-<br />
| GLE || GLS ES (Spanien)<br />
|-<br />
| GLF || GLS FR (Frankreich)<br />
|-<br />
| GLH || GLS HU (Ungarn)<br />
|-<br />
| GLI || GLS IT (Italien)<br />
|-<br />
| GLK || GLS SK (Slowakei)<br />
|-<br />
| GLL || GLS CZ (Tschechien)<br />
|-<br />
| GLN || GLS NL (Niederlande)<br />
|-<br />
| GLO || Glovo<br />
|-<br />
| GLP || GLS PL (Polen)<br />
|-<br />
| GLS || GLS DE / Ship IT (Deutschland)<br />
|-<br />
| GPP || General Purpose (konfigurierbar), auch G00 - G99<br />
|-<br />
| GPS || GLS Parcel Shop (GLS DE Parcelshop Suche)<br />
|-<br />
| GSA || GLS AT / Ship IT (Österreich)<br />
|-<br />
| GSF || GLS FR / Ship IT (Frankreich)<br />
|-<br />
| GTT || GLS DE Track & Trace<br />
|-<br />
| HBG || Hermes Border Guru<br />
|-<br />
| HEH || Hermes Shipping Interface (HSI)<br />
|-<br />
| HES || Hermes Einrichtungs Service (HES)<br />
|-<br />
| HRB || Hornbach<br />
|-<br />
| HMP || Hellmann PL (Polen)<br />
|-<br />
|ICS || ICS<br />
|-<br />
| INP || Inpost24<br />
|-<br />
| IZP || Infens Zustellprofi<br />
|-<br />
|KOV || Kommt Overnight<br />
|-<br />
| KUR || Der Kurier<br />
|-<br />
| LFG || Liefergrün<br />
|-<br />
| LGX || Log X Star<br />
|-<br />
| MON || Mondial Relay<br />
|-<br />
| NCX || Nacex<br />
|-<br />
| OMS || Omest<br />
|-<br />
| ONT || Ontime<br />
|-<br />
| PAT || Post AT (Österreich)<br />
|-<br />
| PFI || Posti FI (Finnland)<br />
|-<br />
| PHR || Posti HR (Kroatien)<br />
|-<br />
| PIL || Pilot<br />
|-<br />
| PPL || PPL<br />
|-<br />
| PSI || Post SI (Slovenien)<br />
|-<br />
| PSK || Post SK (Slovakei)<br />
|-<br />
| SES || Seven Senders (7senders)<br />
|-<br />
| SHA || Schenker AT (Österreich)<br />
|-<br />
| SHD || Schenker<br />
|-<br />
| SHS || Schenker SE (Schweden)<br />
|-<br />
| SND || Sending<br />
|-<br />
| TBN || TNT NL - Retoure Belgien<br />
|-<br />
| TMP || TMParcel<br />
|-<br />
| TNF || TNT FR (Frankreich)<br />
|-<br />
| TNI || TNT IT (Italien)<br />
|-<br />
| TNN || TNT Post NL (Niederlande)<br />
|-<br />
| TNT || TNT (Deutschland)<br />
|-<br />
| TOH || TOF HU (Ungarn)<br />
|-<br />
| TPN || TPN<br />
|-<br />
| TRA || Tradebyte<br />
|-<br />
| TRM || Tiramizoo<br />
|-<br />
| UPA || UPS Pickup (Abholung)<br />
|-<br />
| UPG || UPS GG (Gefahrgut PreAvis)<br />
|-<br />
| UPP || UPS Paperless Document<br />
|-<br />
| UPT || UPS Tarifierung <br />
|-<br />
| VNP || Venipak<br />
|-<br />
| WYF || Wayfair<br />
|}</div>Ddanghttps://wiki.heidler-strichcode.de/w/index.php?title=Carrier_API_error_codes&diff=5874Carrier API error codes2024-08-07T13:01:14Z<p>Ddang: </p>
<hr />
<div>[[de:Carrier_API_Fehlercodes]]<br />
<br />
== General ==<br />
Error codes in the Carrier API appear in the following form <code>AAA-SSS-GG-L[Code]</code>, where<br />
* AAA = Application, in this case only CAP for CarrierAPI<br />
* SSS = Sub group, in this case the plugin. A list of plugins can be found further down.<br />
* GG = Error group, this divides the errors in categories, where the cause normally originates from<br />
* L = Error-level, the severeness of the error: W = Warning, E = Error, C = Critical, F = Fatal<br />
* [Code] = A numerical Code that clearly assigns the error in this group.<br />
<br />
<br />
<br />
Example: <code>CAP-HEH-02-E00005</code><br />
<br />
Means there is an error in the Hermes HSI module in group 02 (content-related error) with code 5 (authentification failed).<br />
<br />
<br />
<br />
To search for an error, search on this site <code>(Strg+F)</code> with the acutal code.<br />
<br />
If you can not find the code directly, replace the sub group, e.g. "HEH" with <code>XXX</code>. From the top example: <code>CAP-XXX-02-E00005</code>. This code is available in group 02.<br />
<br />
<br />
== Group 00 - Fundamental errors ==<br />
These errors appear if the error cause is unknown (e.g. 00000 - undefined error) or when a fundamental problem lies within the functionalities of the Carrier API.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-00-E00000 || Error in webservice request: [Error message] || Fehlerursache nicht bekannt. Genaue Fehlermeldung untersuchen, ggf. Logs einsehen.<br />
|-<br />
| CAP-XXX-00-E00001 || Unable to create plugin || Problem beim aufrufen des jeweiligen Webservice-Plugins. Bitte Support kontaktieren<br />
|-<br />
| CAP-XXX-00-E00002 || The selected Carrier API plugin has been deprecated. Please contact Heidler Support || Das gewählte Carrier API Plugin ist veraltet und der Webservice wurde vom Frachtführer abgekündigt. Bitte Support kontaktieren<br />
|}<br />
<br />
== Group 01 - Technical errors in the request ==<br />
These errors appear if the request was not successful due to a technical error. They can be temporary problems, e.g. the server is not accessible (00001 - connection error) or overloaded (00002 - Read timeout). Or fundamental problems which require interference (00004 - certificate error).<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-01-C00001 || [Connection error / Connection timeout] Unable to connect to webservice. Please check your internet connection, url, firewall, or proxy settings. || Connection error: Verbindung nicht möglich. Eventuell wurde die Anfrage blockiert.<br />
Connect timeout: Die Carrier API konnte nicht feststellen, dass die Verbindung blockiert wurde. Eventuell ist die Verbindungsqualität nicht ausreichend.<br />
|-<br />
| CAP-XXX-01-E00002 || Read timeout: The webservice did not respond in a timely manner. || In der Regel ist der Server vom Frachtführer überlastet. Sie können in den allgemeinen Einstellungen oder für diesen Endpoint versuchen, den Read timeout auf einen höheren Wert zu stellen.<br />
|-<br />
|-<br />
| CAP-XXX-01-C00003 || DNS error: The url [URL] is unknown || Entweder blockiert Ihr DNS-Server die Anfrage der Carrier API oder die hinterlegte URL ist nicht korrekt.<br />
|-<br />
|-<br />
| CAP-XXX-01-C00004 || Unable to verify webservice certificate. Please check your firewall or url. || Falls Ihre Firewall eine deep packet inspection enthält, stellt Sie ein Zwischen-Zertifikat bereit, welches der Carrier API nicht bekannt ist. Das wird von der Carrier-API als [https://de.wikipedia.org/wiki/Man-in-the-Middle-Angriff Man-in-the-Middle-Angriff] interpretiert.<br />
Wenn Sie dem Zertifikat vertrauen, können Sie es X.509 kodiert unter [CarrierAPI]\config\certs hinterlegen.<br />
|-<br />
|-<br />
| CAP-XXX-01-F00005 || Deserialization error: The webservice returned an invalid document || Bitte Support kontaktieren.<br />
|-<br />
|-<br />
| CAP-XXX-01-E00006 || Label conversion error || Bitte Support kontaktieren.<br />
|}<br />
<br />
<br />
== Group 02 - Content-related errors in the request ==<br />
The communication with the webservice was successful, but the response does not math the expectation. Normally, the webservice has found an error in the request (shipment data set) and returns it.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-02-E00001 || General response error || Die Carrier API kann den Fehler nicht genau zuordnen. Bitte prüfen Sie die genaue Fehlermeldung zu diesem Fehlercode.<br />
|-<br />
| CAP-XXX-02-E00002 || Webservice returned error: [Error message] || Der Webservice hat einen genauen Fehlercode und/oder Fehlertext zurückgemeldet. Bitte diesen genau prüfen und ggf. den Datensatz korrigieren.<br />
|-<br />
| CAP-XXX-02-E00003 || Webservice returned an invalid response: [Error detail] || Die Antwort vom Webservice entspricht nicht den Konventionen, welche der Carrier API bekannt sind. Es fehlen u.U. Pflichtfelder in der Antwort (z.B. Tracking-Nummer oder Label-Daten). Bitte prüfen Sie die Fehler-Details und kontaktieren Sie ggf. den Support.<br />
|-<br />
| CAP-XXX-02-E00004 || Webservice returned HTTP [HTTP-Code] || Es sind keine genauen Fehler-Details bekannt, außer dass der Webservice generell ein "Nicht-OK" zurückgegeben hat.<br />
In den Logs der Carrier API finden Sie in der Regel die gesamte Antwort des Webservice, welche eventuell weitere Details enthalten.<br />
|-<br />
| CAP-XXX-02-E00005 || Authentication with the webservice failed. Please check your login details. || In der Regel sind die in der Carrier API hinterlegten Zugangsdaten falsch, oder der Frachtführer hat Ihren Account noch nicht freigeschaltet.<br />
|-<br />
| CAP-XXX-02-E00006 || The webservice did not change the shipment status within a reasonable amount of time (asynchronous webservice operation). <br />
| Bei asynchronen Webservices (z.B: Inpost24 oder FedEx Stratus) wartet die Carrier API bis vom Webservice ein Abgeschlossen- oder Fehler-Status zurück kommt. Sollte dies nicht rechtzeitig erfolgen, dann wirft die Carrier API diesen Fehler.<br />
|}<br />
<br />
== Group 03 - Validation error ==<br />
For some carriers, the Carrier API executes a limited validation and returns an error even before the request to the webservice, when it is predictable that the request is not accepted by the carrier.<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-XXX-03-E00001 || Validation error: [Error details] || Validierungsfehler, welcher nicht unter einer der folgenden Kategorien zutrifft. Bitte die Fehler-Details prüfen.<br />
|-<br />
| CAP-XXX-03-E00002 || Invalid reference number || Der Webservice benötigt eine eindeutige Referenz-Nummer (z.B. Lieferschein-Nr.)<br />
|-<br />
|-<br />
| CAP-XXX-03-E00003 || Receiver address is invalid || z.B. fehlende PLZ, Straße, Haus-Nr. usw.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00004 || Street and house number needs to be separated <br />
| In der Sendung müssen Straße und Hausnummer separiert werden. Entweder wurde die Trennung im HVS32 nicht konfiguriert (Support kontaktieren) oder die Trennung war nicht erfolgreich (Datensatz kontrollieren: Hausnummer ganz am Ende oder Anfang der Straße?)<br />
|-<br />
|-<br />
| CAP-XXX-03-E00005 || Unable to separate first and last name for: [Name] || Für die Trennung von Vor- und Nachnamen sind immer zwei Wörter erforderlich.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00006 || Invalid incoterm id || Entweder fehlt eine Frankatur komplett oder der Frachtführer akzeptiert nur ganz bestimmte Frankaturen.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00007 || Target date is invalid || Es wurde ein Dienst ausgewählt welcher ein Termin-Datum erwartet. Dieses ist entweder nicht belegt oder liegt in der Vergangenheit.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00008 || Customer / account number is invalid || Die Kunden-Nr. im HVS32-Konfigurator oder der Benutzer im Carrier API Konfigurator entspricht nicht den Vorgaben des Frachtführers (z.B. numerisch).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00009 || Shipment number is invalid || Das HVS32 sollte eigentlich eine (Versand-)Sendungs-Nummer erzeugen (Support kontaktieren) oder erwartet diese aus dem Vorsystem (Datensatz prüfen).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00010 || Tracking number is invalid || Das HVS32 sollte eigentlich eine Trackingnummer erzeugen (Support kontaktieren) oder erwartet diese aus dem Vorsystem (Datensatz prüfen).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00011 || Service type id is invalid || Der konfigurierte Dienst ist für diesen Frachtführer nicht gültig.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00012 || Invalid e-mail address || Diese Sendung benötigt mit dem gewählten Dienst eine E-Mail Adresse. Diese wurde nicht übergeben. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00013 || Invalid phone number || Diese Sendung benötigt mit dem gewählten Dienst eine Telefon-Nummer. Diese wurde nicht übergeben. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00014 || Invalid value of goods || Diese Sendung benötigt mit dem gewählten Dienst einen Warenwert. Diese wurde nicht übergeben oder ist keine gültige Zahl. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00015 || Invalid insurance value || Diese Sendung benötigt mit dem gewählten Dienst einen Versicherungswert. Diese wurde nicht übergeben oder ist keine gültige Zahl. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00016 || Invalid id for parcel shop || Für diese Sendung wurde eine Paketshop-Lieferung gewählt. Allerdings fehlt die dazugehörige Paketshop-ID oder sie ist nicht gültig (z.B. numerisch).<br />
|-<br />
|-<br />
| CAP-XXX-03-E00017 || The requested service requires additional data. || Für diese Sendung wurde ein spezifischer Dienst gewählt. Allerdings fehlen für diesen Dienst zusätzliche Informationen, welche nun notwendig sind.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00030 || Weight is invalid || Das angegebene Packstück-Gewicht entspricht nicht den Vorgaben des Frachtführers (z.B. 0 kg oder mehr als der Frachtführer akzeptiert). Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00031 || Package dimensions are invalid. || Der Frachtführer erwartet Paketabmessungen welche im Datensatz fehlen. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00032 || Package type id is invalid || Entweder fehlt die Verpackungsart komplett oder der Frachtführer akzeptiert nur ganz bestimmte Verpackungsarten.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00033 || Package contents are invalid || Diese Sendung benötigt mit dem gewählten Dienst den Paketinhalt. Dieser wurde nicht übergeben. Bitte prüfen Sie den Datensatz.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00038 || No article data available in package || Sendungen ins EU-Ausland benötigen in der Regel zusätzlich Artikeldaten um die Zollinformationen korrekt zu übergeben.<br />
|-<br />
|-<br />
| CAP-XXX-03-E00039 || No hazardous goods data available in package || Beim gewählten Dienst handelt es sich um einen Gefahrgut-Dienst. Allerdings fehlen im Datensatz die Gefahrgutdaten.<br />
|}<br />
<br />
== Group 04 - Configuration error ==<br />
Errors in group 04 mostly have their cause due to a not fully configurated module in the HVS32 or in the Carrier API. It is also possible that the data set is incorrect and refers to a false configuration (e.g. when an invalid dispatch type ID is sent).<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-000-04-C00001 || No dispatch type found for id: [Dispatch type ID] || Die Carrier API kann keinen Konfigurationseintrag mit der gewählten Versandart-ID finden. Entweder ist die Konfiguration unvollständig oder die übergebene Versandart-ID ist falsch.<br />
|-<br />
| CAP-000-04-C00002 || No client found for id: [Client ID] || Die Carrier API kann keinen Konfigurationseintrag mit der gewählten Auftraggeber-ID finden. Entweder ist die Konfiguration unvollständig oder die übergebene Auftraggeber-ID ist falsch.<br />
|-<br />
|-<br />
| CAP-000-04-C00003 || Plugin [Plugin] is not licensed || Die Versandart bzw. der Endpoint verweist auf ein Frachtführer-Plugin welches noch nicht oder nicht mehr lizensiert ist. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00004 || Kein Endpoint definiert für Versandart: [Versandart-ID] || Die gewählte Versandart wurde in der Carrier API gefunden allerdings nicht den Endpoint, auf welche diese Versandart verweist. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00005 || Endpoint URL ist ungültig: [URL] || Bei der im Endpoint konfigurierten URL handelt es sich nicht um eine gültige URL. Bitte kontaktieren Sie den Support.<br />
|-<br />
|-<br />
| CAP-XXX-04-C00006 || Ungültige Konfiguration für: [Konfigurations-Details] || Eine Frachtführer-spezifische Konfiguration ist unvollständig. Bitte prüfen Sie die Detaillierte Fehlermeldung für mehr Details<br />
|}<br />
<br />
<br />
== Carrier-specific errors ==<br />
Some carriers have special error codes that can not be be generally assigned. In most cases, it is an extended validation error from group 03.<br />
<br />
<br />
=== GLS Ship IT ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-GLS-03-E00050 || Ungültige GLS Contact ID || Die im HVS32 konfigurierte Contact ID fehlt oder ist ungültig<br />
|}<br />
<br />
<br />
=== Hermes Shipping Interface (HSI) ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-HEH-03-E00050 || Ungültige Verpackungsart und Abmessungen. Mindestens eine Angabe ist erforderlich. || Hermes hat Verpackungen im Format XS, S, M, L, XL<br />
|-<br />
|-<br />
| CAP-HEH-03-E00051 || Ungültiges Geburtsdatum für Ident-Service || Für diese Sendung wurde ein Ident-Service gewählt. Das Geburtsdatum fehlt allerdings oder handelt sich nicht um ein gültiges Datum.<br />
|}<br />
<br />
<br />
=== Schenker AT ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! style="width:140px" | Code !! style="width:300px" | Text !! Description<br />
|-<br />
| CAP-SHA-03-E00050 || Fehler in Gefahrgutsatz. Ungültige UN Nummer. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die UN-Nummer<br />
|-<br />
|-<br />
| CAP-SHA-03-E00051 || Fehler in Gefahrgutsatz. Ungültige GG-Klasse. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Klasse.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00052 || Fehler in Gefahrgutsatz. Ungültiges GG-Gewicht. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie das GG-Gewicht.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00053 || Fehler in Gefahrgutsatz. Ungültige GG-Verpackung. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsart.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00054 || Fehler in Gefahrgutsatz. Ungültige GG-Verpackungsgruppe. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Verpackungsgruppe.<br />
|-<br />
|-<br />
| CAP-SHA-03-E00055 || Fehler in Gefahrgutsatz. Ungültige Bezeichnung. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die GG-Bezeichnung<br />
|-<br />
|-<br />
| CAP-SHA-03-E00056 || Fehler in Gefahrgutsatz. Keine Netto-Explosivmasse definiert für GG-Klasse 1. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie die Netto-Explosivmasse. Außerdem: Wurde mit Schenker AT abgesprochen, dass Sie Torpedos verschicken?<br />
|-<br />
|-<br />
| CAP-SHA-03-E00057 || Fehler in Gefahrgutsatz. Ungültiger Mengen-Typ. || Der Gefahrgutsatz ist unvollständig. Bitte prüfen Sie den Mengen-Typ (kg oder l)<br />
|}<br />
<br />
<br />
== Plugin codes ==<br />
Each plugin has its own sub-group for an error code. All plugins are listed in the following.<br />
<br />
{| class="wikitable sortable"<br />
|-<br />
! Code !! Plugin<br />
|-<br />
| 000 || Unbekannt - Plugin konnte noch nicht ermittelt werden<br />
|-<br />
| ACO || Arco<br />
|-<br />
| AGX || AGX<br />
|-<br />
| AMZ || Amazon Merchant Fulfillment<br />
|-<br />
| ANL || ANGEL<br />
|-<br />
| ASE || Asendia<br />
|-<br />
| ASM || Amazon Selling Partner API - Merchant Fulfillment<br />
|-<br />
| ASV || Amazon Selling Partner API - Vendor Direct<br />
|-<br />
| ATL || Atlas<br />
|-<br />
| CAL || Canis Lupus<br />
|-<br />
| CEN || Centiro<br />
|-<br />
| CHR || Chronopost<br />
|-<br />
| CIP || Citipost<br />
|-<br />
| COU || Coureon<br />
|-<br />
| DBB || DHL ES B2B<br />
|-<br />
| DCS || DCS<br />
|-<br />
| DEC || DHL eConnect<br />
|-<br />
| DEL || DHL Express Routing Live<br />
|-<br />
| DET || DHL Express Routing Test<br />
|-<br />
| DFR || DPD FR (Frankreich)<br />
|-<br />
| DHA || DHL ELP (Abholung)<br />
|-<br />
| DHE || DHL ES B2C<br />
|-<br />
| DHH || DHL Global Web Service (Ungarn)<br />
|-<br />
| DHN || DHL NL<br />
|-<br />
| DHP || DHL 24 PL<br />
|-<br />
| DHS || DHL SK (Slowakei)<br />
|-<br />
| DIM || Internetmarke (Deutsche Post)<br />
|-<br />
| DPA || DPD AT (Österreich)<br />
|-<br />
| DPL || DPD PL (Polen)<br />
|-<br />
| DPC || DPD HR (Kroatien)<br />
|-<br />
| DPH || DPD HU (Ungarn)<br />
|-<br />
| DPP || DPD DE Parcelshop Suche<br />
|-<br />
| DPR || DPD RO (Rumänien)<br />
|-<br />
| DRI || DHL Retoure International<br />
|-<br />
| DRL || DHL Retoure International (Legacy - veraltet)<br />
|-<br />
| DSK || Danske<br />
|-<br />
| DVF || AM.Exchange (DV-Freimachung)<br />
|-<br />
| EPK || Europaket<br />
|-<br />
| FED || Fedex<br />
|-<br />
| FAC || Fiege Amazon Carma<br />
|-<br />
| FTD || Fedex Trade Documents<br />
|-<br />
| FXA || Fedex (Abholung)<br />
|-<br />
| FXP || Fedex PL (Polen)<br />
|-<br />
| FXS || Fedex Stratus REST API<br />
|-<br />
| GEO || Geodis<br />
|-<br />
| GLD || GLS DK (Dänemark)<br />
|-<br />
| GLE || GLS ES (Spanien)<br />
|-<br />
| GLF || GLS FR (Frankreich)<br />
|-<br />
| GLH || GLS HU (Ungarn)<br />
|-<br />
| GLI || GLS IT (Italien)<br />
|-<br />
| GLK || GLS SK (Slowakei)<br />
|-<br />
| GLL || GLS CZ (Tschechien)<br />
|-<br />
| GLN || GLS NL (Niederlande)<br />
|-<br />
| GLO || Glovo<br />
|-<br />
| GLP || GLS PL (Polen)<br />
|-<br />
| GLS || GLS DE / Ship IT (Deutschland)<br />
|-<br />
| GPP || General Purpose (konfigurierbar), auch G00 - G99<br />
|-<br />
| GPS || GLS Parcel Shop (GLS DE Parcelshop Suche)<br />
|-<br />
| GSA || GLS AT / Ship IT (Österreich)<br />
|-<br />
| GSF || GLS FR / Ship IT (Frankreich)<br />
|-<br />
| GTT || GLS DE Track & Trace<br />
|-<br />
| HBG || Hermes Border Guru<br />
|-<br />
| HEH || Hermes Shipping Interface (HSI)<br />
|-<br />
| HES || Hermes Einrichtungs Service (HES)<br />
|-<br />
| HRB || Hornbach<br />
|-<br />
| HMP || Hellmann PL (Polen)<br />
|-<br />
|ICS || ICS<br />
|-<br />
| INP || Inpost24<br />
|-<br />
| IZP || Infens Zustellprofi<br />
|-<br />
|KOV || Kommt Overnight<br />
|-<br />
| KUR || Der Kurier<br />
|-<br />
| LFG || Liefergrün<br />
|-<br />
| LGX || Log X Star<br />
|-<br />
| MON || Mondial Relay<br />
|-<br />
| NCX || Nacex<br />
|-<br />
| OMS || Omest<br />
|-<br />
| ONT || Ontime<br />
|-<br />
| PAT || Post AT (Österreich)<br />
|-<br />
| PFI || Posti FI (Finnland)<br />
|-<br />
| PHR || Posti HR (Kroatien)<br />
|-<br />
| PIL || Pilot<br />
|-<br />
| PPL || PPL<br />
|-<br />
| PSI || Post SI (Slovenien)<br />
|-<br />
| PSK || Post SK (Slovakei)<br />
|-<br />
| SES || Seven Senders (7senders)<br />
|-<br />
| SHA || Schenker AT (Österreich)<br />
|-<br />
| SHD || Schenker<br />
|-<br />
| SHS || Schenker SE (Schweden)<br />
|-<br />
| SND || Sending<br />
|-<br />
| TBN || TNT NL - Retoure Belgien<br />
|-<br />
| TMP || TMParcel<br />
|-<br />
| TNF || TNT FR (Frankreich)<br />
|-<br />
| TNI || TNT IT (Italien)<br />
|-<br />
| TNN || TNT Post NL (Niederlande)<br />
|-<br />
| TNT || TNT (Deutschland)<br />
|-<br />
| TOH || TOF HU (Ungarn)<br />
|-<br />
| TPN || TPN<br />
|-<br />
| TRA || Tradebyte<br />
|-<br />
| TRM || Tiramizoo<br />
|-<br />
| UPA || UPS Pickup (Abholung)<br />
|-<br />
| UPG || UPS GG (Gefahrgut PreAvis)<br />
|-<br />
| UPP || UPS Paperless Document<br />
|-<br />
| UPT || UPS Tarifierung <br />
|-<br />
| VNP || Venipak<br />
|-<br />
| WYF || Wayfair<br />
|}</div>Ddang