Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
OpenCart

Bulgarian Posts Shipping for OpenCart — Български пощи: delivery to a post office or an address, parcels and waybills from the order

Bulgarian Posts for OpenCart 4.x, 3.x, 2.3 (Bulgaria): delivery to a post office picked at checkout and to an address, a parcel and an A4 waybill from the order; Pro adds the live price, cash on delivery, automatic parcels, tracking and international parcels. Licence for life.

Pro · lifetime licence Staging copies are included. The more sites, the cheaper each one
Compatibility
OpenCart 4.0.2.0–4.1.x, 3.0.x, 2.3.0.2 · module language: English, Български
PHP
7.0 or newer
Version
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3)
Licence
a site + a staging copy, lifetime
Trial
7 days, no card, one per site
Updated
15.11.2026
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

What Free has,
and what Pro adds

The free version works with no time limit. Pro adds the rest of the features in the table.

Feature Free Pro
Bulgarian Posts "to a post office" method with the choice at checkout: search by city, street, name and post code in Cyrillic and Latin ✔ ✔
"To your address" method in Bulgaria ✔ ✔
Fixed price, "free from" a subtotal, weight limit, tax class, geo zone ✔ ✔
A parcel from the order in one click and the A4 waybill, deleting the parcel before hand-in ✔ ✔
E-mail to the buyer with the parcel number and a note in the order history ✔ ✔
Parcel list with filters in the admin ✔ ✔
Live price from the Bulgarian Posts tariff with markup and rounding — ✔
Cash on delivery (наложен платеж) on the parcel — ✔
Parcel created automatically at an order status — ✔
Bulk parcels and waybills in one ZIP — ✔
Hourly tracking: new events in the order history — ✔
International Interconnect parcels with the live price — ✔

What it looks like

Choosing the post office at checkout
The buyer picked a Bulgarian Posts office from the list: name, post code, address and the “Change” button.
Bulgarian Posts delivery methods
The “Delivery methods” tab: post office, address and international (Pro) methods, titles at checkout, prices, “Free from”, weight limit, markup and rounding.

Key points

What the buyer and the seller get

At checkout with a Bulgarian address a “Bulgarian Posts” group appears with two methods: “to a post office” and “to your address”.

What is in the admin

Extensions → Extensions → Shipping → Bulgarian Posts Shipping. Tabs: “Delivery methods”, “Connection and sender”, “Parcels”, “Automation”, “Licence”.

The trial starts when you ask

A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy

Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.

Technical requirements

  • OpenCart 4.0.2.0–4.1.x, 3.0.x or 2.3.0.2; PHP 7.0+ for 2.3, the cURL and OpenSSL extensions; the zip extension to pack several waybills together.
  • Creating parcels and the live price need a contract with Bulgarian Posts (the contractGUID and the portalUserGUID that the company sends after the e-shop contract). The offices list and the international price need no GUID.
  • Prices, cash on delivery and the declared value are in the postal currency: the euro by default (Bulgaria uses the euro since 01.01.2026), leva only for a contract still set up in leva. The currency must be in System → Localisation → Currencies with a current rate, otherwise the admin warns and the live price and the cash on delivery amount are not worked out.
  • The post office and address methods are shown for addresses in Bulgaria only. The post office method appears at checkout once the offices are downloaded.
  • The automatic parcel (Pro) is created in the background right after the order gets the status you chose, so the buyer at checkout does not wait. Background work runs on PHP-FPM or LiteSpeed; on Apache mod_php the cron or the button on the order does it.
  • Cron: OpenCart 4 runs the hourly jobs itself when its scheduler is set up; on OpenCart 3 and 2.3 (and on OpenCart 4 without the scheduler) open the cron URL from the settings every hour: it refreshes the offices once a day and, in Pro, the tracking.
  • Every call to Bulgarian Posts has a time limit: a parcel 20 seconds, the order page and tracking 8 seconds, the live price on one checkout step 6 seconds. With no answer the parcel is marked “no answer yet”, and the next time the order is opened the module looks it up by the order number and creates no second parcel before that.
  • On OpenCart 3.0 and 2.3 press Extensions → Modifications → Refresh after installing: the checkout check of the office choice works through a modification.
  • The module interface is in English and Bulgarian. Interconnect international parcels carry no cash on delivery; Bulgarian Posts may charge extra for options (fragile, check the contents, SMS or e-mail to the buyer, declared value).

Version history

v1.0.0 Current 15.11.2026

For OpenCart 4.x, 3.x and 2.3: Bulgarian Posts delivery to a post office picked at checkout and to an address, fixed prices, a parcel with an A4 waybill from the order, the buyer’s e-mail…

Frequently bought with Bulgarian Posts Shipping

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

Full module description

Bulgarian Posts Shipping for OpenCart 4.x, 3.x and 2.3 connects your shop to Bulgarian Posts (Български пощи, bgpost.bg). At checkout a buyer in Bulgaria picks delivery to a post office with a handy search, or to their own address; from the order page you create the parcel, print the A4 waybill and give the buyer a number to track it.

What the buyer and the seller get

At checkout with a Bulgarian address a “Bulgarian Posts” group appears with two methods: “to a post office” and “to your address”. For the post office the buyer types a city, a street, an office name or a post code, in Cyrillic or Latin, picks from the list and can change the choice. Without an office the order does not go through: the buyer sees “Please choose the Bulgarian Posts office”. The search runs on the module’s own copy of the offices list (about 2,800 offices), refreshed every day, so checkout never waits for Bulgarian Posts. It works on the stock checkout and on CatCode One Page Checkout.

The delivery price is fixed per method, with a “Free from” subtotal and a weight limit in kg; a free-shipping coupon works as usual. In Pro the price can come live from the Bulgarian Posts tariff, with a percent or fixed markup and rounding. If Bulgarian Posts gives no price within a few seconds, checkout uses the fixed price and does not ask the tariff again for the next two minutes, so the buyer does not wait.

On the order, the chosen office becomes the shipping address; the buyer’s payment address stays as it is. The order page in the admin gets a “Bulgarian Posts” panel: weight, the buyer’s phone (when the order has none) and a “Create the parcel” button. The module creates the parcel, stores its number, gives the A4 PDF waybill and lets you delete the parcel before hand-in. The buyer gets an e-mail with the parcel number and sees it in the order history of the account. In the free version a parcel for an order paid by cash on delivery is not created, with an explanation and a link to Pro, so the money is never left uncollected.

What is in the admin

Extensions → Extensions → Shipping → Bulgarian Posts Shipping. Tabs: “Delivery methods”, “Connection and sender”, “Parcels”, “Automation”, “Licence”. On “Delivery methods” you switch on the post office, address and international (Pro) methods and set the titles at checkout, the fixed price, “Free from”, “Max kg”, markup and rounding, the tax class and the geo zone. On “Connection and sender” paste the portalUserGUID and, if needed, the contractGUID from the Bulgarian Posts e-mail (stored encrypted and never returned to the form), press “Save and check the connection” and “Download the post offices”, then enter the sender, e-mail or courier collection and the postal currency.

The parcel list with the filters “All”, “Without parcel” and “On the way” opens from the “Parcel list” button in the settings and from the Sales menu. The Pro bulk actions live there too: create parcels, print the waybills as one ZIP, refresh tracking.

How it works, step by step

  1. Sign the e-shop contract with Bulgarian Posts (bgpost.bg → Business → E-shop integration): the company e-mails you the contractGUID and the portalUserGUID.
  2. Install the module, open its settings, paste the GUIDs, press “Save and check the connection”, then “Download the post offices”.
  3. On “Delivery methods” switch on the methods you need and set the prices; on “Connection and sender” enter the sender and the currency.
  4. A buyer in Bulgaria picks an office or an address at checkout and places the order.
  5. Open the order in the admin, check the weight and press “Create the parcel”: the parcel appears at Bulgarian Posts and the buyer gets the number by e-mail.
  6. Print the A4 waybill and hand the parcel in at a post office (or switch on collection from the sender address).
  7. In Pro choose the order status after which the parcel is created by itself and switch on the hourly tracking: new Bulgarian Posts events land in the order history.

Under the hood

  • Bulgarian Posts API (api.bgpost.bg): the offices nomenclature, the portal session, the order number, creating and deleting a parcel, the waybill, the price calculation, tracking, international Interconnect parcels.
  • The portalUserGUID and the contractGUID are stored encrypted (AES-256-CBC with HMAC-SHA256), never shown in the settings or the log; every request goes over HTTPS.
  • A copy of the offices list in a database table, refreshed daily; search by city, street, name and post code in Cyrillic and Latin.
  • Parcels, the offices of orders and service values live in the module’s own database tables.
  • One parcel per order; creating another is refused until the first is deleted. If the Bulgarian Posts answer is lost, the parcel is found by the order number instead of being created twice.
  • The automatic parcel is queued and made right after the answer to the buyer (fastcgi_finish_request or LiteSpeed), otherwise by the cron. Without Pro a queued parcel is not created, and the reason is written on the order and in the log.
  • Tracking writes every event to the history once, from the oldest to the newest, and stops asking about a finished order.
  • In the free version all Pro settings are locked, and a forged request changes no stored value of the licence, markup, automation status or other Pro fields.
  • The log cc_bgpost.log in system/storage/logs: errors are always written, every call once “Debug log” is on.

Installation

  1. OpenCart 4: Extensions → Installer, upload cc_bgpost.ocmod.zip, keeping the file name.
  2. OpenCart 3.x: Extensions → Installer, upload cc_bgpost-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
  3. OpenCart 2.3: Extensions → Installer, upload cc_bgpost-oc23.ocmod.zip (needs the FTP settings in System → Settings → FTP; otherwise unpack the archive and copy the contents of upload/ to the shop root by hand), then Extensions → Modifications → Refresh.
  4. Extensions → Extensions → Shipping → Bulgarian Posts Shipping: install it and open the settings.
  5. Paste the GUIDs from the contract, press “Save and check the connection” and “Download the post offices”, switch on the methods and save.
  6. For Pro: paste the licence key or start the trial on the “Licence” tab.

Questions
about the module

Didn't find the answer? Message us on Telegram and we'll reply within a business day.

@catcode_support Setup, compatibility, activation
Is this the official Bulgarian Posts module?

No, it is an independent integration through the Bulgarian Posts API. The name and logo of Bulgarian Posts belong to their owners.

What do I need from Bulgarian Posts?

The e-shop contract (bgpost.bg → Business → E-shop integration). After it the company sends the contractGUID and the portalUserGUID: without the portalUserGUID parcels are not created and the live price does not work. The office picker at checkout and the offices list do not depend on the contract.

When is the parcel created?

By hand with the "Create the parcel" button on the order page. In Pro it is created by itself in the background right after the order gets the status you chose, and the buyer at checkout waits for nothing.

Does cash on delivery work?

Yes, in Pro: the order total goes into the parcel as наложен платеж. In the free version a parcel for a cash on delivery order is not created, with an explanation, so the money is never left uncollected.

How does the buyer learn the parcel number?

By an e-mail with the number and a link to the Bulgarian Posts tracking page, and by a note in the order history of the account. The number is typed on the tracking page by hand.

Can I deliver abroad?

Yes, in Pro: the "international parcel" method creates Interconnect parcels to the countries Bulgarian Posts serves, with the live price. A parcel abroad with cash on delivery is not possible.

Does the free version work without Pro?

Yes: the post office and address methods with your prices, the office picker, one parcel from an order with the A4 waybill, deleting the parcel, the buyer's e-mail with the number and a parcel list.

Which OpenCart versions are supported?

OpenCart 4.0.2.0–4.1.x, 3.0.x and 2.3.0.2: three separate archives in one product.

Is the licence for life?

Yes, for OpenCart it is one payment and a licence for life, for two sites.

What happens after the trial?

Pro switches off, queued automatic parcels are not created (the reason is written on the order), and the free part keeps working.

Not quite what you are looking for?

We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.

Order a custom module