=== CatCode Greece Couriers for WooCommerce ===
Contributors: catcodestudio
Tags: acs courier, geniki taxydromiki, speedex, elta courier, greece
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

ACS Courier, ELTA Courier, Geniki Taxydromiki and Speedex in one plugin: vouchers, labels, tracking, ACS points at checkout, cash on delivery.

== Description ==

Four Greek couriers in one WooCommerce plugin, with your own contract and API access at each of them.

* Six shipping methods for your shipping zones: ACS Courier to the address, ACS point (store, SmartPoint or parcel locker), ELTA Courier to the address (beta), ELTA Courier held at the store of the area for collection (beta), Geniki Taxydromiki to the address, Speedex to the address. Per method you choose the countries (Greece; ACS also Cyprus).
* Fixed price, free from an order amount (counted the way the cart shows it), free-shipping coupons, weight limit per method.
* ACS point picker on the classic and on the block checkout: the list starts with the points nearest to the buyer's post code; a post code, a street, an area or a name can be typed, in Greek or in Latin letters. Choose whether the checkout offers every kind of ACS point or only stores, only SmartPoints or only lockers. SmartPoints and lockers take parcels of up to 6 kg, and heavier carts are refused there.
* The picker appears only while the ACS point method is chosen. The buyer's address fields are never rewritten in the browser, so switching to delivery to the address keeps the buyer's own address, and the address saved in the buyer's account stays theirs.
* The order is refused on the server when the ACS point method has no point, or a point ACS never listed — for any checkout. Other shipping methods are never blocked, and a point picked earlier never lands in an order shipped otherwise.
* The point is stored on the order (HPOS compatible), optionally written into the shipping address, and shown on the thank-you page, in the account and in e-mails, with tracking links.
* Voucher from the order screen: weight, cash on delivery (αντικαταβολή) for the payment methods you choose, insurance, Saturday delivery, PDF label (label printer or A4), status refresh, cancel. Orders shipped with another method can be sent too — pick the courier in the box.
* Closing of the day: ACS pickup list and Geniki Taxydromiki closing with one button (both couriers ask for it before they collect the parcels).
* Test systems of ELTA Courier, Geniki Taxydromiki and Speedex supported, with the test users the couriers issue to you.
* Passwords and keys stored encrypted. English and Greek.

**Pro version**

A live ACS tariff at checkout, automatic and bulk vouchers, bulk labels, several parcels per voucher, an hourly status sync with automatic order statuses and an automatic closing of the day are part of a separate Pro version on catcode.com.ua. This plugin works fully on its own, without a time limit.

You need a business contract with API access with each courier you use: ACS Courier (API key, company and user credentials, billing code), ELTA Courier (web-services user code, password and customer code), Geniki Taxydromiki (user name, password and application key) and Speedex (user name, password, customer ID and agreement ID).

== External services ==

This plugin connects to the couriers you configure, only with the credentials you enter:

* ACS Courier web services (webservices.acscourier.net) — ACS stores, SmartPoints and lockers, areas of a post code, create / print / track / delete vouchers, pickup list.
* ELTA Courier web services (wsprod.elta-courier.gr, or the test system wsstage.elta-courier.gr) — create / print / track vouchers.
* Geniki Taxydromiki web services (voucher.taxydromiki.gr, or the test system testvoucher.taxydromiki.gr) — sign-in, create / print / track / cancel vouchers, closing of the day.
* Speedex web services (spdxws.gr, or the test system devspdxws.gr) — sign-in, create / print / track / cancel vouchers.

Sent when you create a voucher: the order number, weight, number of parcels, cash on delivery amount, insured value if you enabled it, parcel contents, the sender name from the settings, and the buyer's name, phone, e-mail and address or chosen ACS point. Tracking links open the couriers' public tracking pages.

Terms and privacy of each courier:

* ACS Courier — terms of use: https://www.acscourier.net/el/plirofories/xrisimes-plirofories/oroi-khreses-tou-site/ , privacy statement: https://www.acscourier.net/el/plirofories/xrisimes-plirofories/delose-aporretou-acs-gdpr/
* ELTA Courier — terms (Consumer Obligations Charter, PDF): https://media.elta.gr/uploads/media/etairia/politikes_kanonismoi/xyk.updated_041024.pdf , privacy policy: https://www.elta-courier.gr/privacy_policy
* Geniki Taxydromiki — terms and conditions: https://taxydromiki.com/oroi-kai-proypotheseis-tis-istoselidas-tis-genikis-tahydromikis/ , privacy policy: https://taxydromiki.com/prosopika-dedomena/
* Speedex — terms of carriage (Speedex publishes no separate website terms of use): https://www.speedex.gr/content.asp?id=41 , privacy policy: https://www.speedex.gr/content.asp?id=477

== Installation ==

1. Install and activate the plugin.
2. WooCommerce → Greece Couriers: fill in the sender and the account of each courier you use and save.
3. Click "Check the connection" (and, for ACS, "Find pickup points") to see that the courier answers.
4. WooCommerce → Settings → Shipping → your Greece zone → Add shipping method → the methods marked "(Greece Couriers)".

== Frequently Asked Questions ==

= The ACS point method does not appear at checkout =

It appears once the ACS account is saved, for the countries chosen in the method. Check also the weight limit of the method: with only SmartPoints or lockers offered, carts over 6 kg do not see it.

= Do I have to close the day? =

ACS recognises the day's vouchers only after the pickup list is issued, and Geniki Taxydromiki asks to close the day's vouchers before the courier collects them. Print the labels first, then press "Close today's vouchers" in the settings. ELTA Courier and Speedex need no closing.

= Why is ELTA Courier marked beta? =

ELTA gives its web-services manual only to contract customers. The ELTA Courier connection is built from published copies of that manual and has not yet been checked on a live ELTA account. Create your first vouchers on the ELTA test system (wsstage) and tell us if ELTA refuses one.

= Can I cancel an ELTA Courier voucher? =

ELTA Courier has no cancel call in its API. "Cancel" marks the voucher cancelled in the shop and adds an order note; if the parcel was already handed over, call ELTA Courier.

== Changelog ==

= 1.0.0 =
* First release: ACS Courier (address, store, SmartPoint, locker), ELTA Courier (address, collection at the store), Geniki Taxydromiki and Speedex (address); ACS point picker on the classic and the block checkout; vouchers, labels, tracking, cash on delivery, closing of the day.
