=== Bulgaria Couriers: Econt & Speedy for WooCommerce ===
Contributors: catcodestudio
Tags: econt, speedy, bulgaria, courier, cash on delivery
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

Econt and Speedy in one plugin: delivery to the address, to an office or to a parcel locker at checkout, waybills, labels, tracking, cash on delivery.

== Description ==

The two largest Bulgarian couriers in one WooCommerce plugin, each with delivery to the buyer's address and delivery to its own offices and parcel lockers (Econtomat, Speedy APT).

**Free**

* Four shipping methods for your shipping zones: Econt to the address, Econt office or Econtomat, Speedy to the address, Speedy office or locker. Shown for Bulgarian addresses only.
* Fixed price, free from an order amount (counted the way the cart shows it), free-shipping coupons, weight limit per method.
* Office and locker picker on the classic and on the block checkout: search by city, street or office name, in Cyrillic or Latin ("Sofia" finds "София"); the list starts in the buyer's city. Choose whether the checkout offers offices, lockers or both.
* The picker appears only while an office 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 an office method has no office, or the office closed since — for any checkout. Other shipping methods are never blocked, and an office picked earlier never lands in an order shipped otherwise.
* The office 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.
* Waybill from the order screen: weight, cash on delivery (наложен платеж) for the payment methods you choose, review before paying, declared value, PDF label, status refresh, cancel. Orders shipped with another method can be sent too — pick the courier in the box.
* Offices and lockers downloaded from each courier into your database and refreshed daily: the checkout never waits for a courier while the buyer types.
* Econt test system supported (demo.econt.com), so you can try everything before going live.
* Passwords stored encrypted. English and Bulgarian.

**Pro** (7-day free trial from the settings page)

* Live delivery price from the courier tariff at checkout (Econt label calculation, Speedy calculation), with a markup in % and a fixed amount, rounding, and the fixed price as a fallback when the courier is slow.
* Waybills created automatically when an order reaches the status you choose.
* Bulk actions in the orders list: create waybills, print all labels at once.
* Several parcels per waybill.
* Hourly waybill status sync with order notes, and "Completed" once the courier reports the delivery.

You need a business account with each courier you use (e-Econt; Speedy Web API user).

== External services ==

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

* Econt Delivery API (ee.econt.com, or the test system demo.econt.com) — your profile, list of offices and Econtomats, price calculation, create / print / track / delete waybills.
* Speedy Web API (api.speedy.bg) — contract objects and services, list of offices and lockers, city lookup, price calculation, create / print / track / cancel shipments.

Sent when you create a waybill (or Pro automation does it for you): the order number, weight, parcel size, cash on delivery amount, declared value if you enabled it, parcel contents, the sender data from the settings, and the buyer's name, phone, e-mail and address or chosen office. With the Pro live tariff on, the destination city and post code (or the chosen office), the weight and the cart value are sent while the buyer is at checkout. Tracking links open the couriers' public tracking pages.

Terms and privacy: https://www.econt.com/ and https://www.speedy.bg/

The Pro licence check connects to catcode.com.ua (licence key and site address), only after you enter a key or start the trial.

== Installation ==

1. Install and activate the plugin.
2. WooCommerce → Bulgaria Couriers: fill in the account of each courier you use and save.
3. Click "Check the connection" (Econt fills the sender from your profile; Speedy offers your contract objects and services) and "Download … offices and lockers".
4. WooCommerce → Settings → Shipping → your Bulgaria zone → Add shipping method → the methods marked "(Bulgaria Couriers)".

== Frequently Asked Questions ==

= The office method does not appear at checkout =

It appears once the courier's offices are downloaded (settings page) and for Bulgarian addresses only. Check also the weight limit of the method.

= Which currency? =

The shop currency is sent with cash on delivery and declared value (EUR in Bulgaria since 2026). With the Pro live tariff, a courier price in another currency is not used — the fixed price is shown instead.

= Econt refuses a waybill: "an authorised person is required" =

Econt needs a contact person when the sender is a company. Fill in "Contact person" in the Econt settings (otherwise the sender name is used).

= The live tariff shows the fixed price =

The courier did not answer within a few seconds, refused the request, or Speedy does not know the city and post code. Turn on the debug log (source bulgaria-couriers) to see why.

== Changelog ==

= 1.0.0 =
* First release: Econt (address, office, Econtomat) and Speedy (address, office, APT locker); office picker on the classic and the block checkout; waybills, labels, tracking, cash on delivery; Pro live tariff, automatic and bulk waybills, bulk labels, several parcels, hourly status sync.
