ShopShine GLS ParcelPoint Pro Documentation for OpenCart 3 and 4

System Requirements

- OpenCart 3.x - 4.x (separate modules)
- Valid ShopShine GLS ParcelPoint Pro license key
- HTTPS is recommended
- The "https://map.gls-hungary.com" service must be accessible from the browser

Installation - OpenCart 4

1. Create a backup of your store files and database.
2. In the admin panel, open **Extensions → Installer**.
3. Upload the "glspspfinder.ocmod.zip" file.
4. Find the "glspspfinder" package among the installed extensions and install it.
5. Open **Extensions → Extensions → Shipping**.
6. Install and then edit the ShopShine GLS ParcelPoint Pro module.

Installation - OpenCart 3

1. Create a backup of your store files and database.
2. In the admin panel, open **Extensions → Installer**.
3. Upload the "shopshine_gls_csomagpont_pro_oc3_v1.0.1.ocmod.zip" file.
4. Open **Extensions → Modifications**, then click the Refresh icon.
5. On the **Extensions → Extensions** page, select Shipping as the extension type.
6. Install ShopShine GLS ParcelPoint Pro, then open its settings.

Initial Setup

1. Select the store you want to configure.
2. Configure the tax class, geo zone, sort order, and pricing.
3. If necessary, select excluded categories and products by name.
4. Enter your license key.
5. **First save the module**, then click the license verification button.
6. Enable the module and save it again.

Supported Checkouts - OpenCart 4

- OpenCart 4 default checkout

Supported Checkouts - OpenCart 3

- OpenCart default checkout
- Journal 3 / 3.2 One Page Checkout
- Xtensions Best Checkout

The module uses its own "glspspfinder" namespace, so it can also work alongside the ShopShine MPL PostaPont Pro module.

Pricing and Multi-Store

You can set a general weight-based shipping fee, four general cart value ranges, as well as a separate weight-based fee and up to four cart value ranges for each customer group. An upper limit of "0" means that the range is unlimited. Using the store selector in the admin panel, each store can have its own license, pricing, and exclusions.

Exclusions and Test Mode

Categories and products can be searched by name. If the cart contains an excluded item, the GLS shipping method will not be displayed. When a developer email address is specified, the shipping method is visible only to the customer logged in with that email address.

Customer Process

1. The customer selects the GLS ParcelPoint shipping method.
2. Clicks the **Select GLS ParcelPoint** button.
3. Selects a ParcelShop or parcel locker on the GLS map.
4. The selected location's name and address are displayed at checkout and then saved with the order.

Troubleshooting

- Check that the module is enabled and the license is active.
- Clear the OpenCart and browser caches.
- Check that the GLS widget domain is not blocked by CSP, a firewall, or an ad blocker.
- The "glspspfinder.js?v=1.0.0" file should be present in the HTML source.
- Custom checkout solutions may require additional compatibility work.

Updating and Uninstalling

Create a backup before updating. Remove the previous extension package, then install the new one. When uninstalling, first disable and uninstall the shipping method, then remove the installed extension.