Direct delivery to pick-up points

ShopDeliveryService

With this service, you can send a parcel directly to a drop-off point anywhere in the Czech Republic and in some foreign countries.

For implementation, it is necessary to know the unique ID of the selected pick-up point. This ID is then sent as a parameter of the service in the way you normally communicate with us. There are several ways to obtain such an ID. If you use your own system for printing labels, you must provide the address of the pick-up point instead of the actual address of the recipient. The name of the recipient is given only as a contact person. As the information on the label and in the data must always be the same, the address of the pick-up point is given in the data and on the label.

How to properly present GLS in the e-shop basket? Comparison of pick-up points

Instructions for implementing the ShopDeliveryService

Take advantage of easy integration into most e-commerce platforms using the downloadable PDF manual or the online guide below.

Download the manual

Implementation of ShopDeliveryService

Information about all dispensing points can be downloaded in an XML file and a custom solution can be created using this. The link below can be used to update the list of dispensing points on a daily basis (these files are updated once a day at night).

  • https://maps.gls-czech.cz/getDropoffPoints.php?ctrcode=CZ

The list of dispensing points is available for the following countries:

  • Czech Republic - CZ
  • Slovakia - SK
  • Slovenia - SL
  • Hungary - HU
  • Croatia - HR
  • Romania - RO

The list of dispensing points in the above countries can be obtained by entering the country abbreviation in the variable "ctrcode".

Use of pick-up points map

The map can be found at the following link: https://maps.gls-czech.cz/

Additional variables can be added to the URL that affect the map's appearance or behavior. Below is a list including a detailed description.

Starting position on the map

• Variable: p

• Sample URL: maps.gls-czech.cz/?p=průmyslová,jihlava

• Default value: position passed by browser / variable ctrcode / Czech Republic

When initializing the map, the variable "p" searches for the specified address and zooms in to show at least the four nearest outlets on the map. This is also how the search via text box works directly on the page. If the user gives additional permissions to the page and the browser manages to detect the user's position, it will automatically set it as the default value. If the variable "p" is set, the automatic position detection is ignored and the specified position in the variable "p" will be displayed.

Choice of country for pick-up points

• Variable: ctrcode

• Sample URL: https://maps.gls-czech.cz/?ctrcode=SK

• Default: CZ

This is how to display the dispensing points of a given country on the map. It is not possible to display multiple countries at the same time. Available values are: CZ, SK, SI, HU, HR, RO.

Choice of language

• Variable: lng

• Sample URL: https://maps.gls-czech.cz/?lng=en

• Default value: default language of the country selected in the ctrcode variable

The language on the map can be modified with this variable. The default is the language of the selected country. Recall that the default country is CZ.

Available values are: en, en, en, sk

View of pick-up points

• Variable: sid

• Sample URL: https://maps.gls-czech.cz/?sid=58601-HERKLOVAHE

• Default: null

You can use the "sid" variable to display the detail of the selected outlet directly when initializing the map. The value of this variable is the ID of the outlet to be displayed on the map immediately after initialization.

If the "sid" variable is set, other location determinations (position from the browser or via the "p" variable) are ignored.

Button for pick-up point selection

• Variable: find

• Sample URL: https://maps.gls-czech.cz/?find=1

• Default value: 0

If you assign a value of 1 to the "find" variable, a selection button will be displayed in the dispensary detail window. This is necessary if you are using the method of selecting a dispensary via a link (see below).

Return address of pick-up point

• Variable: returnUrl

• Sample URL: https://maps.gls-czech.cz?returnUrl=https://google.com

• Default value: null

If you are using the dispensing point selection via a link (see below). You can specify the address where the data should be returned. If this variable is not set, the data is returned to the page you came from. If you are using data forwarding by link, it is recommended to always have this value set.

Return of transmitted values

• Variable: encodeVar

• Sample URL: https://maps.gls-czech.cz/?encodeVar%20=vaSeDaTa

• Default value: null

In this variable you can put the data you want to return along with information about the selected dispensing point. It is strongly recommended to use some sort of encoding for your data.

Activation/deaction of pick-up point groups

• Variable: nogroup

• Sample URL: https://maps.gls-czech.cz?nogroup[]=1&nogroup[]=5

• Default value: null

This allows you to disable groups of outlets on the map that you do not want to display, based on their main business. All groups are functional only in the case of the Czech Republic (ctrcode=CZ). For other countries, only groups 17 and 18 are functional (switching off AlzaBoxes and other boxes).

See the list of groups in the following list:

1. Auto-moto

2. Garden equipment

3. Construction / Workshop / Ironmongery

4. Household goods / Haberdashery

5. Toys / Paper

6. Books

7. Fashion / Footwear

8. Sports / Outdoor

9. Children's Goods / Strollers

10. Pet Supplies

11. Food / Snacks

12. Electronics

13. Gas stations

14. Pharmacy

15. Drugstore / Perfumery

16. Consumer Services

17. AlzaBox

18. GLS Parcel Box

If you want to offer customers a map of GLS outlets in your e-shop, you can use a ready-to-use implementation using iFrame.

  • Sample implementation: https://maps.gls-czech.cz/widget/

After clicking on the "Select GLS outlet" button, the map will be displayed in iFrame over the entire e-shop page. After selecting a dispensing point, the window will automatically close.

Input variables

  • ctrcodeGls: available values are: CZ, SK, SL, HU, HR, RO
  • lngGls: available values are: en, cs, sk
  • nogroupGls: available values see. EXCLUSION OF GROUPS, example: 1,3,5
  • closeBtn (available value 1) - ensures that the cross is displayed when the widget is closed
picture

Output field

  • <input type="hidden" id="psGlsId" /> (pick-up point ID, required for ordering the service)

Object pick-up point

Consists of an object that contains information about the dispensing point and an array of objects that contain the opening hours on each day of the week.

  • detail - The object contains details about the dispensing point.
  • opentime - An array containing seven objects that represent the opening hours on each day of the week.
  • psPhoto - If a photo of the selected outlet is available, it will be base64 encoded here.

Opentime field

Contains seven objects representing the days of the week and the table below shows the contents of the objects.

  • day - The English name of the day of the week.
  • open - Opening hours.
  • midbreak - A break in the opening hours.

Object detail

  • address - The address of the outlet, including the description number.
  • city - City
  • contact - Contact person of the dispensing point
  • ctrcode - Country in ISO code
  • email - Contact email of the dispensing point
  • geolat - Latitude
  • geolng - Longitude
  • info - Additional information about the dispatch location
  • iscodhandler - Tells if the package can be sent to the drop-off point on COD
  • isparcellocker - Tells if it is a Parcel Shop (value "f") or Parcel Box (value "t")
  • name - The name of the drop-off point
  • paybybankcard - Tells if card payment is possible
  • pclshopid - The identification number of the outlet
  • phone - The contact phone number for the outlet
  • vendor_url - Internet address of the dispensary operator
  • wheelchairAccess - Indicates whether the outlet is wheelchair accessible
  • zipcode - Postal code
  • holiday - Holiday

Recommended ifame width is > 690px. Here is a link you can use for your iframe:

https://maps.gls-czech.cz/?find=1

When you click on the "Select Dispensing Point" button, the iframe will send a message to the parent window. You can see how to capture and process the message in the sample in the following section. A "parcelshop" object will be returned, which consists of a "detail" object and an "opentime" object.

  • Note that the variable "find" must have the value 1!

Place a button/link on your site to our interface for selecting a dispensing point and have this site return information about the dispensing point chosen directly by your customer on a clear map. You can also submit your data to this interface (e.g. a completed form) and the interface will return it together with the information about the selected dispensing point.

It is necessary to have the button to confirm the selection of the dispensing point enabled. You will then put your completed forms into the encodeVar variable, which will be returned to the page from which you came to our map. It is highly recommended to have the URL to return the data to filled in as well - this will achieve better stability of your application.

We recommend to have at least this link prepared:

  • https://maps.gls-czech.cz/?find=1&returnUrl=https://seznam.cz&encodeVar=vaseData

After pressing the button to select the dispensing location, you will be returned to the address in the returnUrl variable (if you don't fill it in, you will be returned to the url from which you came to the map). The values in the encodeVar variable will be returned via the GET method, as well as the following values of the selected outlet:

  • id - identification number of the ParcelShop, necessary for ordering the service
  • name - name of the ParcelShop
  • address - address (street no.)
  • city - city
  • zipcode - postal code

To order the service you only need to know the ParcelShop ID. Other information can be provided to the customer, for example, in an email, SMS message or any other way you deem appropriate.

Transfer to GLS systems

You always need to know the ID of the pick-up point where you want to send the parcel. If you are unsure, please contact it@gls-czech.com.

Import via XML file

<Services>
<Service Code="PSD">
<Info>
<ServiceInfo InfoType="INFO" InfoData="26711-GLSCZ_DEPO47" />
</Info>
</Service>
</Services>

Import via CMS file

In the column where you are importing services, enter the following text:

• PSD(26711-GLSCZ_DEPO47)

Where "26711-GLSCZ_DEPO47" is the ID of the selected ParcelShop. The link to download the sample csv file can be found here .

The PSD service cannot be combined with other services such as FDS (FlexDeliveryService) or FSS (FlexDeliveryService - SMS). These services are not compatible with each other and the application would display the following when importingan error message.

Use for API

For APIs, always follow the latest documentation available to you. But also here, the service parameter is the ID of the selected ParcelShop. You can download the latest documentation for the MyGLS API here .

Import to e-Balík

In case you use our B2B portal e-Package, you can import parcels directed to Pick up points by entering the ID of the selected Pick up point into column number eighteen (ParcelShopDeliver service).

• 26711-GLSCZ_DEPO47

Examples of implementation

Comparison of pick-up point types

Comparison of GLS Parcel Shop, GLS Parcel Box and AlzaBox
Information about ShopDeliveryServiceGLS Parcel ShopGLS Parcel BoxAlzaBox
DescriptionExternal pick-up pointOwn GLS self-service boxExternal self-service box
Current number1.5006002.000
Planned number (3/2025)1.905860850
Storage time (days)533
Extension optionYesYesYes
Maximum parcel weight (kg)101010
Longest parcel side (cm)1005050
COD payment - cashYesNoNo
COD payment - cardYesYes for "Blue line"
No for "Solar Green line"
No
COD payment - GoPayYesYesYes
Procedure in case the parcel cannot be delivered to the pick-up point.The driver will make individual arrangements with the recipient and deliver the parcel to the address or other pick-up point approved by the recipient.
Notification after accepting the parcel into the systemE-mail only
Notification after delivering the parcel into the pick-up pointE-mail and SMS
Notification in case of not pick-uping up the parcel by the recipientE-mail and SMS
Accepting the parcel for transport without labelNoNoNo
Accepting the parcel for transport with labelYesYesNo
PriceSame for all pick-up points
Option to display parcel boxes and parcel shops separately in the shopping cartYes, via multiple client accounts, each account individual settings, groups of pick-up points can be disabled within the account
Pick-up points map https://maps.gls-czech.cz/
Instructions for adding a pick-up point to the e-shop shopping cart See above