HVS32 automatic polling functions: Unterschied zwischen den Versionen
K |
|||
Zeile 1: | Zeile 1: | ||
− | [[de:HVS32_Automatik-Polling_Funktionen]] | + | |
+ | = Load/release package (VerladeVersandDaten) = | ||
+ | The gateway function VerladeVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to release packages for outgoing. | ||
+ | Only packages that have been released for exit are taken into account for the daily closing. | ||
+ | No package/shipment data is available for the feedback. After successful release, only the field Fehler with value 0 is reported back - or in case of an error, Fehler with value 1 and the error Fehlertext1 are reported back. | ||
+ | <br><br><big>'''Parameters'''</big><br> | ||
+ | <small>'''Bold''' fields must ALWAYS be filled</small> | ||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | ! Field name !! Type !! Max Length !! Decimal places !! Assignment | ||
+ | |- | ||
+ | | '''PACKSTUECKID''' || [[#Datentypen|String]] || 20 || - || '''Unique''' number for the parcel in the pre-system. | ||
+ | |- | ||
+ | | PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32 packing station that will process the job. | ||
+ | |- | ||
+ | | SPERRKENNZEICHEN || [[#Datentypen|String]] || 1 || - || "J" if the package is to be blocked | ||
+ | |- | ||
+ | | WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Swap body on which the package is to be booked | ||
+ | |- | ||
+ | | SAMMELFREIGABE || [[#Datentypen|String]] || 1 || - || "T" for a collective release (release all packages with identical VE-ReferenzNr) | ||
+ | |- | ||
+ | | VEREFERENZNR || [[#Datentypen|String]] || 20 || - || must be filled for a collective release | ||
+ | |} | ||
+ | <br><big>'''Return parameters'''</big><br> | ||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | ! Field name !! Type !! Max Length !! Decimal places !! Assignment | ||
+ | |- | ||
+ | | FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Successful, 1 = Error | ||
+ | |- | ||
+ | | FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error | ||
+ | |- | ||
+ | | FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error | ||
+ | |}[[de:HVS32_Automatik-Polling_Funktionen]] | ||
= Data types = | = Data types = | ||
'''Integer''' - Number with only numeric characters (0-9).<br> | '''Integer''' - Number with only numeric characters (0-9).<br> | ||
Zeile 415: | Zeile 448: | ||
No package/shipment data is available for the feedback. After a successful cancellation, only the field Error with value 0 is reported back - or in case of an error, Error with value 1 and the error Fehlertext1 are reported back. | No package/shipment data is available for the feedback. After a successful cancellation, only the field Error with value 0 is reported back - or in case of an error, Error with value 1 and the error Fehlertext1 are reported back. | ||
<br><br><big>'''Parameters'''</big><br> | <br><br><big>'''Parameters'''</big><br> | ||
− | <small>''' | + | <small>'''Bold''' fields must ALWAYS be filled</small> |
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
|- | |- | ||
Zeile 434: | Zeile 467: | ||
|- | |- | ||
| FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error | | FEHLERTEXT2 || [[#Data types|String]] || 200 || - || Is filled in the event of an error | ||
+ | |} | ||
+ | |||
+ | = Load/release package (VerladeVersandDaten) = | ||
+ | The gateway function VerladeVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to release packages for outgoing. | ||
+ | Only packages that have been released for exit are taken into account for the daily closing. | ||
+ | No package/shipment data is available for the feedback. After successful release, only the field Fehler with value 0 is reported back - or in case of an error, Fehler with value 1 and the error Fehlertext1 are reported back. | ||
+ | <br><br><big>'''Parameters'''</big><br> | ||
+ | <small>'''Bold''' fields must ALWAYS be filled</small> | ||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | ! Field name !! Type !! Max Length !! Decimal places !! Assignment | ||
+ | |- | ||
+ | | '''PACKSTUECKID''' || [[#Datentypen|String]] || 20 || - || '''Unique''' number for the parcel in the pre-system. | ||
+ | |- | ||
+ | | PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32 packing station that will process the job. | ||
+ | |- | ||
+ | | SPERRKENNZEICHEN || [[#Datentypen|String]] || 1 || - || "J" if the package is to be blocked | ||
+ | |- | ||
+ | | WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Swap body on which the package is to be booked | ||
+ | |- | ||
+ | | SAMMELFREIGABE || [[#Datentypen|String]] || 1 || - || "T" for a collective release (release all packages with identical VE-ReferenzNr) | ||
+ | |- | ||
+ | | VEREFERENZNR || [[#Datentypen|String]] || 20 || - || must be filled for a collective release | ||
+ | |} | ||
+ | <br><big>'''Return parameters'''</big><br> | ||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | ! Field name !! Type !! Max Length !! Decimal places !! Assignment | ||
+ | |- | ||
+ | | FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Successful, 1 = Error | ||
+ | |- | ||
+ | | FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error | ||
+ | |- | ||
+ | | FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error | ||
+ | |} | ||
+ | |||
+ | = Load/release package (VerladeVersandDaten) = | ||
+ | The gateway function VerladeVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to release packages for outgoing. | ||
+ | Only packages that have been released for exit are taken into account for the daily closing. | ||
+ | No package/shipment data is available for the feedback. After successful release, only the field Fehler with value 0 is reported back - or in case of an error, Fehler with value 1 and the error Fehlertext1 are reported back. | ||
+ | <br><br><big>'''Parameters'''</big><br> | ||
+ | <small>'''Bold''' fields must ALWAYS be filled</small> | ||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | ! Field name !! Type !! Max Length !! Decimal places !! Assignment | ||
+ | |- | ||
+ | | '''PACKSTUECKID''' || [[#Datentypen|String]] || 20 || - || '''Unique''' number for the parcel in the pre-system. | ||
+ | |- | ||
+ | | PACKPLATZ || [[#Datentypen|String]] || 10 || - || HVS32 packing station that will process the job. | ||
+ | |- | ||
+ | | SPERRKENNZEICHEN || [[#Datentypen|String]] || 1 || - || "J" if the package is to be blocked | ||
+ | |- | ||
+ | | WECHSELBRUECKE || [[#Datentypen|String]] || 20 || - || Swap body on which the package is to be booked | ||
+ | |- | ||
+ | | SAMMELFREIGABE || [[#Datentypen|String]] || 1 || - || "T" for a collective release (release all packages with identical VE-ReferenzNr) | ||
+ | |- | ||
+ | | VEREFERENZNR || [[#Datentypen|String]] || 20 || - || must be filled for a collective release | ||
+ | |} | ||
+ | <br><big>'''Return parameters'''</big><br> | ||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | ! Field name !! Type !! Max Length !! Decimal places !! Assignment | ||
+ | |- | ||
+ | | FEHLER || [[#Datentypen|Integer]] || - || - || 0 = Successful, 1 = Error | ||
+ | |- | ||
+ | | FEHLERTEXT1 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error | ||
+ | |- | ||
+ | | FEHLERTEXT2 || [[#Datentypen|String]] || 200 || - || Is filled in the event of an error | ||
|} | |} |
Version vom 30. September 2021, 16:17 Uhr
Load/release package (VerladeVersandDaten)
The gateway function VerladeVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to release packages for outgoing.
Only packages that have been released for exit are taken into account for the daily closing.
No package/shipment data is available for the feedback. After successful release, only the field Fehler with value 0 is reported back - or in case of an error, Fehler with value 1 and the error Fehlertext1 are reported back.
Parameters
Bold fields must ALWAYS be filled
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
PACKSTUECKID | String | 20 | - | Unique number for the parcel in the pre-system. |
PACKPLATZ | String | 10 | - | HVS32 packing station that will process the job. |
SPERRKENNZEICHEN | String | 1 | - | "J" if the package is to be blocked |
WECHSELBRUECKE | String | 20 | - | Swap body on which the package is to be booked |
SAMMELFREIGABE | String | 1 | - | "T" for a collective release (release all packages with identical VE-ReferenzNr) |
VEREFERENZNR | String | 20 | - | must be filled for a collective release |
Return parameters
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
FEHLER | Integer | - | - | 0 = Successful, 1 = Error |
FEHLERTEXT1 | String | 200 | - | Is filled in the event of an error |
FEHLERTEXT2 | String | 200 | - | Is filled in the event of an error |
Data types
Integer - Number with only numeric characters (0-9).
Decimal - Number with decimal places
String - Any character from the ISO-8859-1 character set. Maximum length not to be exceeded.
Additional data types
Additional data types, which occur in the description, are in a 1:n relation to the packages. Please refer to the respective interface documentation of the corresponding plug-in (file, JDBC, SAP, etc.) to find out how this relation must be realised.
Article data
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
Satz-Kennung | String | 3 | - | Only required for file processing
"Satzkennung" in the polling file: "ART" |
--- ARTICLE DATA SECTION --- | ||||
ANZAHLBUEGEL | Integer | - | - | Only for hanging shipment: Number of hangers on which the article group is divided up |
ANZAHLPOSETIKETTEN | Integer | - | - | Number of article labels to be printed |
ARTIKELBTNNR | String | 25 | - | BTN number / customs tariff number |
ARTIKELEAN | String | 20 | - | EAN number |
ARTIKELEINHEIT | String | 10 | - | Unit of the article quantity |
ARTIKELGEWICHT | Decimal | 9 | 3 | Article weight |
ARTIKELGRUPPE | String | 50 | - | Article group |
ARTIKELMENGE | Decimal | 9 | 3 | Article quantity |
ARTIKELSERVICES | String | 100 | - | Pipe separate services for this article |
ARTIKELSOLLMENGE | Decimal | 9 | 3 | Article target quantity |
ARTIKELTEXT1 | String | 100 | - | Article description |
ARTIKELTEXT2 | String | 100 | - | Article description |
ARTIKELTEXT3 | String | 100 | - | Article description |
ARTIKELTEXT4 | String | 100 | - | Article description |
ARTIKELVOLUMEN | Decimal | 9 | 3 | Article volume |
ARTIKELWAEHRUNG | String | 3 | - | Currency in which the value of the article is indicated |
ARTIKELWERT | Decimal | 18 | 2 | Value of the article |
CHARGEFLAG | String | 1 | - | |
KUNDENARTIKELNR | String | 50 | - | Article number |
KUNDENBESTELLNR | String | 50 | - | Purchase order number |
POSAUFTRAGNR | String | 50 | - | Order number |
POSLIEFERNR | String | 40 | - | Delivery note number |
POSITIONNR | String | 50 | - | Sequence number within the package |
SERIENNR | String | 30 | - | Serial number |
URSPRUNGLAND | String | 2 | - | Country of origin of the article |
Dangerous goods
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
Satz-Kennung | String | 3 | - | Only required for file processing
"Satzkennung" in the polling file: "GEF" |
--- DANGEROUS GOODS DATA SECTION --- | ||||
GEFAHRGUTBEFOERDKAT | Integer | 1 | - | Transport category, mandatory (see ADR table column (15)), can be 0-4. Attention! Must be correct. |
GEFAHRGUTBEGRENZTEMENGE | String | 1 | - | T if the substance is shipped with status LQ / Limited Quantity according to ADR 3.4, otherwise F, mandatory |
GEFAHRGUTBEZEICHNUNG | String | 110 | - | Mandatory (see ADR table column (2)) |
GEFAHRGUTBUCHST640 | String | 1 | - | Letter for special provision 640, conditionally mandatory for substances to which special provision 640 applies (see ADR table column (6)). |
GEFAHRGUTFFCODE | String | |||
GEFAHRGUTFAKTOR | Integer | 3 | - | Assessment factor for point summation on the transport document, (can be 0, 1, 3, 50 or 999), technically mandatory, but can be clearly concluded from the transport category, therefore it does not necessarily have to be documented |
GEFAHRGUTFREIGESTMENGE | String | 1 | - | T if the substance is shipped with status EQ / Excepted Quantities according to ADR 3.5, otherwise F, mandatory |
GEFAHRGUTID | String | 20 | - | Unique search number for dangerous goods master data |
GEFAHRGUTKCODE | String | 10 | - | Classification code, mandatory (see ADR table column (3b)) |
GEFAHRGUTKLASSE | String | 100 | - | Mandatory (see ADR table column (3a)) |
GEFAHRGUTMENGE | Decimal | 8 | 3 | Substance quantity of dangerous goods to be declared according to ADR (in litres for liquids and compressed gases, otherwise in kg, for LQ dangerous goods always kg). |
GEFAHRGUTMENGENEINHEIT | String | 2 | - | Unit of measurement for the substance quantity. 1' or 'l': litre ; '0' or 'kg' or empty: kg |
GEFAHRGUTNEBENGEFAHR | String | 10 | - | Conditionally mandatory for substances where subsidiary risk label numbers exist in addition to the main hazard class/label number (see ADR table column (5), if e.g. 3+6.1+8 is entered there, 6.1 and 8 are the subsidiary risk label numbers and are to be transmitted as (6.1)(8) in the subsidiary risk field). |
GEFAHRGUTNETTOEXPLMASSE | Decimal | 8 | 3 | Net explosive mass in kg, only for dangerous goods of class 1 |
GEFAHRGUTPOSITIONNR | Integer | - | - | |
GEFAHRGUTTECHBENENNUNG | String | 150 | - | Conditionally mandatory for N.A.G. dangerous goods (i.e. if the designation ends with N.A.G.) |
GEFAHRGUTTUNNELBCODE | String | 10 | - | Tunnel restriction code, mandatory (see ADR table column (15)) |
GEFAHRGUTUNNR | String | 10 | - | Mandatory (see ADR table column (1)) |
GEFAHRGUTUMWELTGEF | String | 1 | - | T if substance is environmentally hazardous, otherwise F, mandatory for environmentally hazardous substances. |
GEFAHRGUTVPG | String | 3 | - | Packing group, conditionally mandatory for those substances for which it is assigned in the ADR table, may be I,II or III or not assigned at all (the latter e.g. for Class 2)) (see ADR table column (4)). |
GEFAHRGUTVERPANZAHL | Integer | 4 | - | Number of units in which the dangerous goods are packed (in connection with the next field GefahrgutVerpackungsart) |
GEFAHRGUTVERPACKUNGSART | String | 5 | - | ADR code of the type of packaging, e.g. 4G for box (cardboard), mandatory, see separate documentation for packaging codes. |
Package processing (VersandDatenAnfrage)
The gateway function VersandDatenAnfrage is sent from the data gateway server in automatic polling mode to the HVS32 in order to generate and post a label for a package. A label is identified for all further functions such as cancellation, loading release, etc. by means of the host-side package ID. This is transferred in the Package ID field and must therefore be unique within the shipping system.
By means of an additional configuration in the HVS32, the VersandDatenAnfrage can also be used to initiate a reprint. In this case, the same PackstueckID must be used for the new request.
Parameters
Bold fields must ALWAYS be filled
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
ANSPRECHPARTNER | String | 50 | - | Recipient Contact person |
ANZAHLARTIKEL | Integer | 6 | - | Number of articles (print on label) |
ARTIKELDATEN | Sequence <ArtikelDaten> | - | - | A list of the package articles of the type ArtikelDaten (1:n) |
AUFTRAGNR | String | 20 | - | - |
AUFTRAGGEBERID | String | 10 | - | Mandantenkennung aus dem HVS32 |
AVISHINWEIS1 | String | 30 | - | - |
AVISHINWEIS2 | String | 30 | - | - |
AVISZUSATZ1 | String | 20 | - | Addition to fixed AVIS key 1 |
AVISZUSATZ2 | String | 20 | - | Addition to fixed AVIS key 2 |
BARCODEID | String | - | - | Additional field for possible extensions |
BARCODETEXT | String | - | - | Additional field for possible extensions |
BARCODETYP | String | - | - | Additional field for possible extensions |
BESTELLNR | String | 20 | - | Metro order no. (Metro shipping) |
DRUCKERNAME | String | 30 | - | Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module) |
String | 100 | - | E-mail address of the recipient (e.g.: for automatic e-mail notification) | |
EMPFMOBILFUNKNR | String | 20 | - | Mobile phone number of the recipient |
FAXNR | String | 20 | - | Fax number of the recipient |
FLEXZUSTELLUNGEMAILADRESSE | String | 80 | - | Flex delivery email address |
FRACHTBRIEF | String | 20 | - | Consignment note number if the consignment note is to be printed by the pre-system |
FRACHTFUEHRERKDNR | String | 10 | - | Customer number of the freight payer with the carrier |
FRANKATURKENNUNG | String | 10 | - | - |
GEFAHRGUT | Sequence <Gefahrgut> | - | - | A list of Dangerous goods of type Gefahrgut (1:n) |
GEWICHT | Decimal | 8 | 3 | Gross weight in KG |
HOSTTRACKINGNR | String | 35 | - | Package number from the host system |
ILNNR | String | 20 | - | ILN of the recipient (mandatory for Metro shipping) |
KOSTENSTELLE | String | 30 | - | - |
KUNDENNR | String | 20 | - | Customer number of the recipient with the sender |
LAGERKENNZEICHEN | Integer | - | - | - |
LETZTESPACKSTUECK | String | 1 | - | T/F: T=last packing piece of the consignment (required for printing the consignment hanging card in the case of hanging consignments). |
LIEFERANTENID | Integer | - | - | - |
LIEFERSCHEINNR | String | 40 | - | Used in the HVS32 as a search number |
NACHNAHME | Decimal | 18 | 2 | - |
NETTOGEWICHT | Decimal | 8 | 3 | Net weight in KG |
NEUTBIC | String | 11 | - | Only used with neutral senders |
NEUTBANKBEZEICHNUNG | String | 40 | - | Only used with neutral senders |
NEUTIBAN | String | 31 | - | Only used with neutral senders |
NEUTKONTOINHABER | String | 40 | - | Only used with neutral senders |
NEUTABSENDERLKZ | String | 3 | - | Only used with neutral senders |
NEUTABSENDERNAME1 | String | 50 | - | Only used with neutral senders |
NEUTABSENDERNAME2 | String | 50 | - | Only used with neutral senders |
NEUTABSENDERNAME3 | String | 50 | - | Only used with neutral senders |
NEUTABSENDERORT | String | 50 | - | Only used with neutral senders |
NEUTABSENDERPLZ | String | 10 | - | Only used with neutral senders |
NEUTABSENDERSTRASSE | String | 50 | - | Only used with neutral senders |
NNVERMERK | String | 1 | - | 'B': Cash / 'V': Crossed cheque |
NNVERWENDUNG | String | 30 | - | Cash on delivery - Intended use |
NNWAEHRUNG | String | 3 | - | Cash on delivery - ISO currency code |
PACKSTKGES | Integer | - | - | Total number of colli of the consignment |
PACKSTKNR | Integer | - | - | Sequence number per consignment |
PACKPLATZ | String | 10 | - | HVS32 packing station that will process the job. |
PACKSTUECKBREITE | Integer | - | - | Width in cm |
PACKSTUECKHOEHE | Integer | - | - | Height in cm |
PACKSTUECKID | String | 20 | - | Unique number for the parcel in the pre-system. Needed as a unique parcel reference to cancel or load the label later. |
PACKSTUECKLAENGE | Integer | - | - | Length in cm |
PAPERLESSINVOICE | String | 1 | - | Only in UPS PaperlessInvoice case (T=PaperlessInvoice / F=not PaperlessInvoice) |
POSTLEITCODE | String | 15 | - | - |
POSTZIELFRACHTZENT | String | 5 | - | - |
RECHNUNGSEMPFLKZ | String | 5 | - | Invoice address |
RECHNUNGSEMPFNAME1 | String | 50 | - | Invoice recipient |
RECHNUNGSEMPFNAME2 | String | 50 | - | Invoice recipient |
RECHNUNGSEMPFNAME3 | String | 50 | - | Invoice recipient |
RECHNUNGSEMPFORT | String | 50 | - | Invoice address |
RECHNUNGSEMPFPLZ | String | 10 | - | Invoice address |
RECHNUNGSEMPFSTRASSE | String | 50 | - | Invoice address |
RECHNUNGSNR | String | 20 | - | Invoice number |
SENDUNGSINHALT | String | 30 | - | - |
SONDERDIENSTE | String | 30 | - | SPECIAL SERVICES - depending on the shipping method used |
SPERRFLAG | String | 1 | - | T/F: T=lock, otherwise do not lock |
TELEFONNR | String | 20 | - | Recipient's phone number |
TERMINART | String | 1 | - | 'A' = deliver from this day on
'B' = deliver until this day 'F' = deliver on this day |
TERMINDATUM | String | 10 | - | DD.MM.YYYY |
TERMINZEIT | Calendar | 5 | - | HH:MM |
USTIDNR | String | 20 | - | VAT number of the recipient |
VERPACKUNGSART | String | 6 | - | - |
VERSANDARTID | String | 10 | - | Dispatch type identifier from the HVS32 |
VERSICHERUNGSWERT | Decimal | 18 | 2 | Amount of insured value |
VORPACKDATUM | String | 10 | - | DD.MM.YYYY |
VWWAEHRUNG | String | 3 | - | Insured value - ISO currency code |
WARENWERT | Decimal | 18 | 2 | Value of goods |
WECHSELBRUECKE | String | 20 | - | Swap body assigned to this package |
WWWAEHRUNG | String | 3 | - | Value of goods - ISO currency code |
ZAHLUNGSBEDINGUNG | String | 10 | - | 'S' = sender, 'R' = receiver |
ZBZOLL | String | 1 | - | Payment condition for customs taxes 'S' = Sender, 'R' = Receiver |
ZIELADRBAHNHOF | String | 30 | - | Postcode and city |
ZIELADRLKZ | String | 5 | - | Delivery address |
ZIELADRNAME1 | String | 50 | - | Delivery address |
ZIELADRNAME2 | String | 50 | - | Delivery address |
ZIELADRNAME3 | String | 50 | - | Delivery address |
ZIELADRNAME4 | String | 50 | - | Delivery address |
ZIELADRORT | String | 50 | - | Delivery address |
ZIELADRPLZ | String | 10 | - | Delivery address |
ZIELADRREGION | String | 20 | - | State/province (e.g.: important for shipments to the USA) |
ZIELADRSTRASSE | String | 50 | - | Delivery address |
Return parameters
Field name | Type | Max Length | Decimal places | |
---|---|---|---|---|
AUSGANGDATETIME | String | 10 | - | Date when the label was transmitted to the carrier (DD.MM.YYYY) |
DRUCKDATETIME | String | 19 | - | Date when the label was printed in the HVS32 (DD.MM.YYYY HH:mm:SS) |
FEHLER | Integer | - | - | 0 if successful |
FEHLERTEXT1 | String | 200 | - | Is filled in the event of an error |
FEHLERTEXT2 | String | 200 | - | Is filled in the event of an error |
GEBUEHR | Decimal | 18 | 2 | Freight costs |
GEBUEHRWAEHRUNG | String | 3 | - | Freight costs - ISO currency code |
PACKSTUECKID | String | 20 | - | PackstueckID from the request |
RETOURTRACKINGNR | String | 50 | - | Package number for the return |
TRACKINGNR | String | 35 | - | Package number |
TRACKINGURL | String | 255 | - | URL of the tracking link |
VERSANDSENDUNGSNR | String | - | - | - |
Reprint label (VersandDatenWdhDruck)
The gateway function VersandDatenWdhDruck is sent from the data gateway server in automatic polling mode to the HVS32 to reprint a label for a package.
A label is reprinted using the host-side package ID. This is transferred in the PackstueckID field.
Some carriers (e.g. DPD) assign new tracking numbers when reprinting. This means that the old tracking number is no longer valid and the old shipping label must be destroyed.
The new tracking number can be reported back in the response.
Parameters
Bold fields must ALWAYS be filled
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
PACKSTUECKID | String | 20 | - | Unique number for the parcel in the pre-system. |
PACKPLATZ | String | 10 | - | HVS32 packing station that will process the job. |
DRUCKERNAME | String | 30 | - | Name of an output channel (printer) in the HVS32 via which the label is printed. (Requires printer spooler extension module) |
Return parameters
Feldname | Typ | Max Länge | Dezimalstellen | Belegung |
---|---|---|---|---|
FEHLER | Integer | - | - | 0 = Successful, 1 = Error |
FEHLERTEXT1 | String | 200 | - | Is filled in the event of an error |
FEHLERTEXT2 | String | 200 | - | Is filled in the event of an error |
TRACKINGNR | String | 35 | - | (New) tracking number of the package |
Cancel package (StornoVersandDaten)
The gateway function StornoVersandDaten is sent from the data gateway server (DGS) in automatic polling mode to the HVS32 to cancel existing packages there that are not yet on an outgoing list.
As a rule, a package is cancelled on the basis of the package ID on the host side. This is transferred in the PackstueckID field.
In addition to the host-side package ID, the tracking number can also contribute to the identification of the package, in case the host-side package ID cannot guarantee uniqueness.
No package/shipment data is available for the feedback. After a successful cancellation, only the field Error with value 0 is reported back - or in case of an error, Error with value 1 and the error Fehlertext1 are reported back.
Parameters
Bold fields must ALWAYS be filled
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
PACKSTUECKID | String | 20 | - | Unique number for the parcel in the pre-system. |
PACKPLATZ | String | 10 | - | HVS32 packing station that will process the job. |
Return parameters
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
FEHLER | Integer | - | - | 0 = Successful, 1 = Error |
FEHLERTEXT1 | String | 200 | - | Is filled in the event of an error |
FEHLERTEXT2 | String | 200 | - | Is filled in the event of an error |
Load/release package (VerladeVersandDaten)
The gateway function VerladeVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to release packages for outgoing.
Only packages that have been released for exit are taken into account for the daily closing.
No package/shipment data is available for the feedback. After successful release, only the field Fehler with value 0 is reported back - or in case of an error, Fehler with value 1 and the error Fehlertext1 are reported back.
Parameters
Bold fields must ALWAYS be filled
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
PACKSTUECKID | String | 20 | - | Unique number for the parcel in the pre-system. |
PACKPLATZ | String | 10 | - | HVS32 packing station that will process the job. |
SPERRKENNZEICHEN | String | 1 | - | "J" if the package is to be blocked |
WECHSELBRUECKE | String | 20 | - | Swap body on which the package is to be booked |
SAMMELFREIGABE | String | 1 | - | "T" for a collective release (release all packages with identical VE-ReferenzNr) |
VEREFERENZNR | String | 20 | - | must be filled for a collective release |
Return parameters
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
FEHLER | Integer | - | - | 0 = Successful, 1 = Error |
FEHLERTEXT1 | String | 200 | - | Is filled in the event of an error |
FEHLERTEXT2 | String | 200 | - | Is filled in the event of an error |
Load/release package (VerladeVersandDaten)
The gateway function VerladeVersandDaten is sent from the data gateway server in automatic polling mode to the HVS32 in order to release packages for outgoing.
Only packages that have been released for exit are taken into account for the daily closing.
No package/shipment data is available for the feedback. After successful release, only the field Fehler with value 0 is reported back - or in case of an error, Fehler with value 1 and the error Fehlertext1 are reported back.
Parameters
Bold fields must ALWAYS be filled
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
PACKSTUECKID | String | 20 | - | Unique number for the parcel in the pre-system. |
PACKPLATZ | String | 10 | - | HVS32 packing station that will process the job. |
SPERRKENNZEICHEN | String | 1 | - | "J" if the package is to be blocked |
WECHSELBRUECKE | String | 20 | - | Swap body on which the package is to be booked |
SAMMELFREIGABE | String | 1 | - | "T" for a collective release (release all packages with identical VE-ReferenzNr) |
VEREFERENZNR | String | 20 | - | must be filled for a collective release |
Return parameters
Field name | Type | Max Length | Decimal places | Assignment |
---|---|---|---|---|
FEHLER | Integer | - | - | 0 = Successful, 1 = Error |
FEHLERTEXT1 | String | 200 | - | Is filled in the event of an error |
FEHLERTEXT2 | String | 200 | - | Is filled in the event of an error |