Greece Couriers — a shipping module for ACS, ELTA, Geniki and Speedex in OpenCart: to the address, to an ACS store / SmartPoint / locker

Greece Couriers is an independent shipping module by the CatCode studio for stores in Greece and Cyprus on OpenCart 4, 3 and 2.3. It connects four Greek couriers — ACS Courier, ELTA Courier, Geniki Taxydromiki and Speedex. The buyer chooses delivery to the address or an ACS point — a store, SmartPoint or SmartPoint locker — right at checkout, and the manager creates the voucher, prints the label and sees the parcel status on the order page without opening the couriers’ portals.

What you need. A contract and web service access with the couriers you use. Honest note about testing: we have no courier test accounts — ACS and ELTA have no public test systems, Geniki and Speedex give them only to customers with a contract. The module is written from the official ACS Rest API and Geniki JobServicesV2 documentation and the ELTA Courier and Speedex WSDL, and tested on mocks of these services built from their documentation. We have not created real vouchers at the couriers. ELTA Courier is beta: ELTA has no public documentation, and “collect at an ELTA store” has not been checked on a real account yet. Try the module on your own accounts in the 7-day Pro trial — if a courier answers differently from the documentation, we will fix it quickly.

About trademarks. ACS, ELTA Courier, Geniki Taxydromiki and Speedex are trademarks of their owners. Greece Couriers is an independent module by CatCode, not an official product of these companies: they do not publish or support it. The module works with your own accounts through their web services.

Running WooCommerce? There is a separate Greece Couriers for WooCommerce plugin: the same four couriers — ACS, ELTA Courier (beta), Geniki Taxydromiki and Speedex, the ACS point picker at the classic and block checkout, vouchers and labels from the order screen, tracking and cash on delivery.

What the buyer sees

• Courier methods in the shipping list: ACS to the address and to a point, ELTA to the address and to an ELTA store, Geniki and Speedex to the address. Only the ones you set up are turned on.
• ACS point search in Greek or Latin letters, by city, area, street or postcode. The points of the buyer’s city come first.
• The list shows name, address, region and point type: store, SmartPoint or locker. For a cart over 6 kg SmartPoints and lockers are not shown.
• No point, no next step: the server rejects the step, and the confirm block on the page is held with a hint that the point is missing.
• ELTA “collect at a store” — without point selection: ELTA holds the parcel at the store that serves the buyer’s postcode.

What the admin gets

• Settings in eight tabs: shipping methods, ACS, ELTA, Geniki, Speedex, shipments, automation, licence. Each courier has a connection check that shows the courier’s answer in its own words.
• Voucher panel on the order page: courier and point, weight, cash on delivery in EUR, voucher creation, PDF label, status refresh, cancel. The point can be changed by hand while there is no voucher.
• Vouchers for orders with another shipping method too — with a courier choice, to the buyer’s address.
• ACS pickup list and Geniki day close — buttons on the courier tabs and in the vouchers list.
• Email to the buyer with the voucher number and a tracking link, and a line in the order history.
• Vouchers list in the Sales menu, with bulk actions in Pro.

How it works — step by step

1. You enter the courier details, check the connection and download the ACS points — they go into the module’s table and are updated daily.
2. The buyer chooses a method. For ACS to a point — picks the point in the panel under the method; the point goes into the session on the server, the buyer’s address fields do not change.
3. When the order is placed, its shipping address becomes the point’s address and the region becomes the region of the point’s postcode. For delivery to the address the buyer’s address stays.
4. The manager creates the voucher on the order page: the module sends the data to the courier, stores the number and shows the PDF label.
5. The buyer gets an email with tracking. At the end of the day — the ACS pickup list and the Geniki day close. The status is refreshed with a button, and in Pro hourly, and a delivered order moves to a chosen status.

Under the hood

• ACS Rest API (JSON) from the official documentation: points, station lookup by postcode, rate, voucher, label, tracking, cancel, pickup list. Geniki JobServicesV2, ELTA Courier and Speedex — SOAP through our own XML parsing, the PHP SOAP extension is not needed.
• The point lives on the server only. The picker JavaScript does not read or write the buyer’s address fields. Only the point code goes into the session, the data comes from the module’s table, and a point that does not fit the weight is not accepted.
• The no-point check in OpenCart 4 sits on saving the payment method and on confirm; in OpenCart 3 — on the events of the shipping, payment and confirm steps; in OpenCart 2.3 — the same steps through a modification the module registers itself.
• One library for three builds, the code is PHP 7.0 compatible; it also works with the pdo database driver in OpenCart 4.1.
• Courier passwords and keys — AES-256-CBC with HMAC, not shown again after saving.
• Pro gate without “bricking”: when the trial is over, only the Pro features stop; shipping and vouchers keep working.
• Uninstall removes the events and cron tasks; the module tables and a copy of the settings stay for a reinstall.

How to install

1. OpenCart 4: Extensions → Installer → upload cc_grcourier.ocmod.zip (do not rename the archive) and press “Install”. OpenCart 3: Extensions → Installer → cc_grcourier-oc3.ocmod.zip, then Extensions → Modifications → “Refresh”. OpenCart 2.3: upload the contents of the upload/ folder from cc_grcourier-oc23.ocmod.zip to the store root (FTP or the hosting file manager).
2. Extensions → Extensions → Shipping → Greece Couriers (ACS, ELTA, Geniki, Speedex) → “Install”, then “Edit”.
3. OpenCart 2.3: Extensions → Modifications → “Refresh”. The module registers its modification itself, and the settings page reminds you until “Refresh” is pressed.
4. On the ACS, ELTA, Geniki and Speedex tabs enter the details of the couriers you use and press “Save and check the connection”. For ACS — also “Download points”.
5. On the “Delivery methods” tab turn the methods on, set prices, the free shipping threshold and the weight limit; on the “Shipments” tab — the sender’s phone and postcode, the payment methods with cash on delivery.
6. Place a test order to an ACS point and create a voucher from the order page.
7. For Pro: paste the licence key from the email after payment or turn on the trial on the “Licence” tab. For OpenCart 3 and 2.3 add the cron URL from the “Automation” tab to the hosting cron, once an hour.