Direct delivery to pick-up points

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

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.

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

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.

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.