HVS32 automatic polling functions

From Wiki - Heidler Strichcode GmbH
Revision as of 12:05, 30 September 2021 by Jschaile (talk | contribs)
Jump to navigation Jump to search

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"

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
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"

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)).
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
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.

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)
EMAIL 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
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
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).
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 - -
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
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

USTIDNR String 20 - VAT number of the recipient
VERSANDARTID String 10 - Dispatch type identifier from the HVS32
VERSICHERUNGSWERT Decimal 18 2 Amount of insured value
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