GLS ShipIT  3.1.9
GLS ShipIT - SOAP services
Custom Label Generation

Table of Contents

General Label Overview

The label format, used in FPCS is called "Integrated Router Label". This label format is assembled by several general parts:

Allgemeiner Label Aufbau.png
Routing Information
Describes the way of the parcel through the GLS system (from the pickup location to the delivery tour of the GLS driver).
Barcodes
All necessary routing, product, service, shipper and consignee address information is stored within the 2D codes for supporting GLS operational processes
General Information
Creation date & time, weight, routing data date, version etc.
Service Information
Contains service relevant information, e.g. handling instructions etc.
Consignee Address
Contains the address of the consignee.
Shipper Address
Contains the address of the shipper as well as the Customer and Contact’s ID
B2C Area
Contains additional information, e.g. shippers own parcel reference, consignee’s contact data, etc.

The source for data printed in these areas is either the request or the response of a WebService API call:

General Label Part Source
Routing Information Response
Barcodes Response (textual representation)
General Information Request (partly) and Response (partly)
Service Information Request or Response (both are valid)
Consignee Address Request
Shipper Address Request (address) and Response (ID's)
B2C Area Request

Detailed Label Mapping

Routing Information

The "Routing Information" part describes the way of the parcel through the GLS system (from the pickup location to the delivery tour of the GLS driver).

Routing Informations (labeled).png


#NameSourceXPathExample
1 Outbound Sorting Flag
RESPONSE
/soap:Body
 /CreateParcelsResponse
  /CreatedShipment
   /ParcelData[1]
    /RoutingInfo
     /HubLocation
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<ParcelData>
<RoutingInfo>
<HubLocation>R33</HubLocation>
...
</RoutingInfo>
...
</ParcelData>
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>
2 Tour-Number/GeoTour-Number
(for cellbased routing the GeoTourNumber replaces the TourNumber)
RESPONSE
/soap:Body>
 /CreateParcelsResponse
  /CreatedShipment
   /ParcelData[1]
    /RoutingInfo
     /Tour|GeoTour
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<ParcelData>
<RoutingInfo>
<Tour>1829</Tour>
<GeoTour>1829</GeoTour>
...
</RoutingInfo>
...
</ParcelData>
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>
3 Destination Country +
Final Destination
RESPONSE
/soap:Body>
 /CreateParcelsResponse
  /CreatedShipment
   /ParcelData[1]
    /RoutingInfo
     /FinalLocationCode
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<ParcelData>
<RoutingInfo>
<FinalLocationCode>
DE 440
</FinalLocationCode>
...
</RoutingInfo>
...
</ParcelData>
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>
4 Track-ID
RESPONSE
/soap:Body>
 /CreateParcelsResponse
  /CreatedShipment
   /ParcelData[1]
    /TrackID
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<ParcelData>
<TrackID>
Z5K6JLFV
</TrackID>
...
</ParcelData>
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>
5 Handling Information
RESPONSE
/soap:Body>
 /CreateParcelsResponse
  /CreatedShipment
   /ParcelData[1]
    /HandlingInformation
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<ParcelData>
<HandlingInformation>
Z5K6JLFV
</HandlingInformation>
...
</ParcelData>
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>
6 ZipCode
REQUEST
/soapenv:Body>
 /typ:ShipmentRequestData
  /typ:Shipment[1]
   /typ:Consignee
    /com:Address
     /com:ZIPCode
<soapenv:Body>
<typ:ShipmentRequestData>
<typ:Shipment>
<typ:Consignee>
<com:Address>
<com:ZIPCode>18055</com:ZIPCode>
...
</com:Address>
</typ:Consignee>
</typ:Shipment>
</typ:ShipmentRequestData>
</soapenv:Body>
7 Inbound Sorting Flag
RESPONSE
/soap:Body>
 /CreateParcelsResponse
  /CreatedShipment
   /ParcelData[1]
    /RoutingInfo
     /InboundSortingFlag
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<ParcelData>
<RoutingInfo>
<InboundSortingFlag>0</InboundSortingFlag>
...
</RoutingInfo>
...
</ParcelData>
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>
8 Loading Area + Disposition Flag
(only used for cellbased routing)
RESPONSE
/soap:Body>
 /CreateParcelsResponse
  /CreatedShipment
   /ParcelData[1]
    /RoutingInfo
     /LoadingArea|DispositionFlag
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<ParcelData>
<RoutingInfo>
<LoadingArea>7</LoadingArea>
<DispositionFlag>c</DispositionFlag>
...
</RoutingInfo>
...
</ParcelData>
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>

Barcodes

The barcode part contains all necessary routing, product, service, shipper and consignee address information is stored within the 2D codes for supporting GLS operational processes.

The 2D-Codes used within all GLS systems (a.k.a. Uni-Code/ Uni-Ship) are Data Matrix Codes in version ECC 200.

definitionData Matrix ECC 200
standardISO/IEC 16022
symbol size36x36 oder 40x40
capacity (chars)127 (max.)
recoverable errors21 (max.)
physical measurementmin. 18x18 mm
EncodingISO 8859-1 (LATIN1)

The integrated router label contains two data matrix codes.

The left barcode (1) is called "Primary 2D code" and is used to identify the transport unit. The Primary 2D code is built of all the routing information that is used to process the shipment.

All the address data of the consignee are coded within the right barcode (2). This data matrix is called "Secondary 2D code".

Barcodes (labeled).png


#NameSourceXPathExample
1 Primary Code
RESPONSE
/soap:Body
 /CreateParcelsResponse
  /CreatedShipment
   /ParcelData[1]
    /Barcodes
     /Primary2D
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<ParcelData>
<Barcodes>
<Primary2D>
ADE 500DE 44027602208452769995N0EZDDGPE24AAGe 0NST182918055 0120000100153237
</Primary2D>
...
</Barcodes>
...
</ParcelData>
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>
2 Secondary Code
RESPONSE
/soap:Body
 /CreateParcelsResponse
  /CreatedShipment
   /ParcelData[1]
    /Barcodes
     /Secondary2D
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<ParcelData>
<Barcodes>
<Secondary2D>
A|Hr. Test|Teststraße 42|Rostock-Brinckmansdorf|| 987654321| 1234567|
</Secondary2D>
...
</Barcodes>
...
</ParcelData>
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>
3 Primary 1D Code
(occasionally)
RESPONSE
/soap:Body
 /CreateParcelsResponse
  /CreatedShipment
   /ParcelData[1]
    /Barcodes
     /Primary1D
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<ParcelData>
<Barcodes>
...
<Primary1D>603021522903</Primary1D>
<Primary1DPrint>true</Primary1DPrint>
</Barcodes>
...
</ParcelData>
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>

General Information

The General Information part contains the creation date & time, the weight of the shipment, the quantity, the routing data date and version and other information.

General Informations (labeled).png


#NameSourceXPathExample
1 Pickup Location
RESPONSE
/soap:Body>
 /CreateParcelsResponse
  /CreatedShipment
   /PickupLocation
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<PickupLocation>DE 330</PickupLocation>
...
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>
2 Shipment Date
and Time
REQUEST
/soapenv:Body>
 /typ:ShipmentRequestData
  /typ:Shipment[1]
   /typ:ShippingDate
<soapenv:Body>
<typ:ShipmentRequestData>
<typ:Shipment>
<typ:ShippingDate>
2017-10-02
</typ:ShippingDate>
...
</typ:Shipment>
</typ:ShipmentRequestData>
</soapenv:Body>
3 Weight
and Time
REQUEST
/soapenv:Body>
 /typ:ShipmentRequestData
  /typ:Shipment[1]
   /typ:ShipmentUnit[1]
    /typ:Weight
<soapenv:Body>
<typ:ShipmentRequestData>
<typ:Shipment>
<typ:ShipmentUnit>
<typ:Weight>12.0</typ:Weight>
...
</typ:ShipmentUnit>
...
</typ:Shipment>
</typ:ShipmentRequestData>
</soapenv:Body>
4Quantity
CALCULATED
count(/soapenv:Body/type:ShipmentRequestData/typ:Shipment/typ:ShipmentUnit) calculated from the position of the element <typ:ShipmentUnit> and the
count of all <typ:ShipmentUnit> elements inside the element
<typ:Shipment>.
5 Routing Date
RESPONSE
/soap:Body>
 /CreateParcelsResponse
  /CreatedShipment
   /ParcelData[1]
    /RoutingInfo
     /LastRoutingDate
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<ParcelData>
<RoutingInfo>
<LastRoutingDate>
2017-07-03
</LastRoutingDate>
...
</RoutingInfo>
...
</ParcelData>
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>
6Label Version
STATIC TEXT
static text containing the version of the format used for this label.

Service Information

Contains service relevant information, e.g. handling instructions a.s.o. Each service may have it's own representation and format.

Service Informations.png

The header to be printed as well as all of the information data with label text and values are given as elements in the response.

Shipper Address

This part contains the address of the shipper as well as the Customer and Contact’s ID.

While the shipper's address data may be freely defined by the WebService caller, the customer's IDs is returned within the WebService response appropriate to the requested contact ID of the shipper used for this shipment.

Shipper Address Information (labeled).png

(rotated by 90°)

#NameSourceXPathExample
1 Customer ID
RESPONSE
/soap:Body>
 /CreateParcelsResponse
  /CreatedShipment
   /CustomerID
<soap:Body>
<CreateParcelsResponse>
<CreatedShipment>
<CustomerID>2760230433</CustomerID>
...
</CreatedShipment>
</CreateParcelsResponse>
</soap:Body>
1 Contact ID
REQUEST
/typ:ShipmentRequestData
 /typ:Shipment[1]
  /typ:Shipper
   /com:ContactID
<soapenv:Body>
<typ:ShipmentRequestData>
<typ:Shipment>
<typ:Shipper>
<com:ContactID>2769995N0E</com:ContactID>
</typ:Shipper>
...
</typ:Shipment>
</typ:ShipmentRequestData>
</soapenv:Body>

Consignee Address and B2C Area

The source for the consignee address is all the subsequent elements from element <com:Address> in <typ:Consignee> element of the WebService request.

Consignee Address Informations.png

Label Measurements

Outline Measurement

The Integrated Router Label measures 100mm vertical by 150mm horizontal:

Label Measuring.png

Measurements of the Label Parts and structural elements

#XYWidthHeightThickness
Label Parts Measuring.png
10.70mm1.76mm97.71mm0.35mm1
20.70mm14.81mm97.71mm0.35mm0.5
30.70mm27.16mm97.71mm0.35mm0.5
40.70mm55.73mm97.71mm0.35mm0.5
50.70mm62.44mm97.71mm71.61mm0.25
682.19mm62.44mm0.35mm71.61mm0.25
70.70mm89.95mm81.49mm0.35mm0.25
80.70mm117.12mm81.49mm0.35mm0.25

Fonts and Position of the Label Elements

ElementAnchorXYWidthHeightFontFont sizeFormattingExample
Outbound Sorting Flag
bottom-left.png
4mm 10mm Swiss721 Cn BT 25pt bold
Outbound Sorting Flag.png
Inbound Sorting Flag
bottom-center.png
33.5mm 10mm Swiss721 Cn BT 25pt inverse, bold
Inbound Sorting Flag.png
top-left.png
30mm 0mm 7mm 11.5mm
Tour-Number/GeoTour-Number
bottom-left.png
4mm 21mm Swiss721 Cn BT 20pt bold
Tour Number.png
LoadingArea
bottom-right.png
16.22mm 17.99mm 2.46mm 8.81mm Swiss721 Cn BT 12pt inverse
Loading_Area.png
DispositionFlag
bottom-left.png
18.69mmm 17.99mm 2.46mm 8.81mm Swiss721 Cn BT 12pt inverse
Disposition_Flag.png
Destination Country
bottom-left.png
60mm 10mm Swiss721 Cn BT 25pt bold
Destination Country.png
Final Location
bottom-center.png
83.5mm 10mm Swiss721 Cn BT 25pt inverse, bold, centered
Final Location.png
top-left.png
71mm 0mm 25mm 11.5mm
Track-ID
bottom-center.png
50mm 21mm Courier 12pt bold, centered
Track ID.png
bottom-center.png
50mm 15mm Swiss721 Cn BT 6pt centered Your GLS Track ID
Handling Information
bottom-right.png
96mm 21mm Swiss721 Cn BT 15pt bold, right-justified
Handling Informations.png
ZIP-Code
bottom-center.png
30.5mm 21mm Swiss721 Cn BT 12pt bold
ZIP-Code.png
bottom-center.png
30.5mm 15mm Swiss721 Cn BT 6pt centered Zip Code
Primary 2D Code
bottom-left.png
4mm 46mm 18mm 18mm
Primary 2D.png
Secondary 2D Code
bottom-right.png
96mm 46mm 18mm 18mm
Secondary 2D.png
Primary 1D Code
bottom-center.png
50mm 46mm 20mm 35mm
Primary 1D.png
Primary 1D Code (plain writing)
bottom-center.png
50mm 49mm 35.27mm Courier 10pt bold, centered
Primary 1D printout.png
Pickup Location
bottom-left.png
4mm 56mm Swiss721 Cn BT 10pt
Pickup Location.png
(Station ID)
bottom-left.png
15mm 56mm Swiss721 Cn BT 6pt aab
Shipment Date
bottom-right.png
33mm 56mm Swiss721 Cn BT 8pt
Shipping Date.png
Shipment Time
bottom-left.png
34mm 56mm Swiss721 Cn BT 8pt
Shipping Time.png
Weight
bottom-center.png
50mm 56mm Swiss721 Cn BT 14pt bold, centered
Weight.png
Quantity
bottom-center.png
65mm 56mm Swiss721 Cn BT 8pt centered
Quantity.png
Routing Date
bottom-center.png
80mm 56mm Swiss721 Cn BT 8pt centered
Routing Date.png
Label Version
bottom-right.png
96mm 56mm Swiss721 Cn BT 6pt right-justified
Label Version.png
Service Name
bottom-left.png
2mm 63mm Swiss721 Cn BT 10pt bold
Service Name.png
Service Info
bottom-left.png
2mm 66mm Swiss721 Cn BT 8pt
Service Information.png
Contact ID
bottom-right-90.png
97mm 94mm Swiss721 Cn BT 8pt
Contact ID.png
Customer ID
bottom-right-90.png
97mm 119mm Swiss721 Cn BT 6pt 90° rotated right
Customer ID.png
Reference Barcode/Image Right
Vertical
82.90mm 98.42mm 12.34mm 35.27mm
Reference Barcode/Image
Bottom Horizontal
0.70mm 134.05mm 97.36mm 13.75mm