
Bulgarian Posts Shipping for WooCommerce — Български пощи: delivery to a post office or an address, parcels and waybills from the order
Bulgarian Posts for WooCommerce (Bulgaria): delivery to a post office picked at the checkout or to an address, a parcel and a waybill from the order; Pro adds the live price, cash on delivery, automatic parcels, tracking, international.
- Compatibility
- WordPress 6.4+ · WooCommerce 8.6+ · PHP 7.4+ · HPOS, block checkout · parcels need a contract with Bulgarian Posts · interface language: English (Pro also български)
- Licence
- a site + a staging copy, annual
- Trial
- 7 days, no card, one per site
- Updated
- 16.11.2026
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.
What it looks like
Key points
What the buyer gets
At the checkout with an address in Bulgaria the methods “Български пощи — до пощенска станция” and “— до адрес” appear.
What the admin gets
WooCommerce → Bulgarian Posts: paste the portalUserGUID (and, if needed, the contractGUID) from the Bulgarian Posts e-mail, press “Check the connection” and “Download the post offices”, and fill in the sender: name, phone, e-mail, post code and city of the hand-in office or the collection address.

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
WordPress 6.4+, WooCommerce 8.6+ (HPOS and the block checkout are supported), PHP 7.4+.
For parcels and the live price, a contract with Bulgarian Posts (contractGUID and portalUserGUID). The office list and the international price need no GUID.
The “to an office” and “to an address” methods are shown for addresses in Bulgaria; the office picker appears at the checkout once the office list is downloaded.
Background parcels (Pro) run through the Action Scheduler that ships with WooCommerce, hourly tracking through WP-Cron.
Interface language: English; Bulgarian is part of the Pro build.
Version history
Bulgarian Posts delivery to an office chosen at the checkout and to an address, fixed prices, a parcel with a PDF waybill from the order, an e-mail to the buyer with the number, HPOS…
Frequently bought with Bulgarian Posts Shipping


Bulgaria Couriers for WooCommerce — Econt and Speedy: delivery to the address, an office or a locker

Abandoned Cart Recovery for WooCommerce

eMAG Marketplace Connector for WooCommerce — eMAG prices, stock and orders in your store
Full module description
Bulgarian Posts Shipping for WooCommerce connects the shop to Български пощи (bgpost.bg), the national postal operator of Bulgaria. At the checkout a buyer in Bulgaria picks delivery to a post office, searched by city, street, name or post code, or to their own address; from the order you create the parcel, print the PDF waybill and give the buyer the number for tracking.
What you need. For parcels and the live price, a contract with Bulgarian Posts for online shops (bgpost.bg → Business → E-shop integration): after it the company sends the contractGUID and the portalUserGUID. The office choice at the checkout and the office list need no GUID: the list is public.
What the buyer gets
At the checkout with an address in Bulgaria the methods “Български пощи — до пощенска станция” and “— до адрес” appear. For an office the buyer opens the picker, types a city, street, name or post code (Cyrillic or Latin: “Sofia”, “софия” and “1000” all work), picks an office and can change the choice. Without an office the order does not go through; this is also checked on the server, on the classic and the block checkout. The search runs over the shop’s own copy of the list, so the checkout does not wait for Bulgarian Posts.
The buyer’s address fields are never changed: the chosen office is written into the order’s shipping address on the server, and the buyer’s account keeps their own address. After the parcel is created the buyer gets an e-mail with the number and a link to the Bulgarian Posts tracking page, and sees the number in the order summary.
What the admin gets
WooCommerce → Bulgarian Posts: paste the portalUserGUID (and, if needed, the contractGUID) from the Bulgarian Posts e-mail, press “Check the connection” and “Download the post offices”, and fill in the sender: name, phone, e-mail, post code and city of the hand-in office or the collection address. The GUID is stored encrypted and is never printed back into the form.
Then in WooCommerce → Settings → Shipping add “Bulgarian Posts — to a post office” and “— to your address” to the Bulgaria zone: title, fixed price, “Free from”, weight limit, tax status. In Pro the same form sets the live tariff with a markup and rounding.
In an order the “Bulgarian Posts” box shows the office or the address, the weight and the “Create the parcel” button. There is one parcel per order and a second one is blocked; there are a PDF waybill, a link to the tracking page and deletion before hand-in. The office can also be set by hand with its code.
What Pro adds
- The live price from the Bulgarian Posts tariff for every cart (office or post code, weight, cash on delivery, declared value) with a percentage and a fixed markup and rounding. If the tariff does not answer or returns 0, the checkout uses your fixed price.
- Cash on delivery (наложен платеж) on the parcel for the payment methods you choose; the amount can be edited in the order box.
- Automatic by status. When an order reaches the status you choose, the parcel is made in the background through Action Scheduler, and the buyer at the checkout waits for nothing.
- Bulk actions in the orders list: create parcels (queued), print waybills as one ZIP (up to 30) and refresh tracking.
- Tracking. Every hour the open parcels are checked in batches of 15 orders, and new Bulgarian Posts events reach the order notes once.
- International Interconnect parcels to the countries Bulgarian Posts serves, with the live price; a parcel with cash on delivery abroad is not possible.
- A Bulgarian interface next to English, and updates from catcode.com.ua.
Limitations
- Creating parcels and the live price need your own contract with Bulgarian Posts (contractGUID and portalUserGUID). Without it the office choice at the checkout and the methods with a fixed price still work.
- In the free version a parcel is not created for an order with cash on delivery: the module says so in the order, so that the money is not left uncollected. Cash on delivery on the parcel is Pro.
- Prices, cash on delivery and the declared value are in the postal currency: euro by default (Bulgaria uses the euro since 01.01.2026), lev only for a contract still set up in leva. If the shop sells in another currency an exchange rate is needed in the settings, otherwise the admin warns.
- A call to Bulgarian Posts is time-limited: 6 seconds at the checkout, 8 seconds in an admin action. If the tariff does not answer, the checkout uses the fixed price for the next two minutes. If there is no answer to a parcel creation, the parcel is marked “unknown” and looked up by the order number the next time the order opens; a second parcel is not created.
- The “to an office” method with the live tariff prices by the buyer’s post code before an office is chosen; after the choice the price may change.
- The bgpost.bg tracking page does not take the number in the link, so the buyer gets the number and the link separately.
- Bulk creation, printing and tracking are queued; up to 30 waybills in one ZIP within 25 seconds.
- The e-mail to the buyer is written in the site language.
How it works, step by step
- Sign the Bulgarian Posts contract for online shops: the company sends the contractGUID and the portalUserGUID.
- Install the plugin, paste the GUID in WooCommerce → Bulgarian Posts, press “Check the connection”, then “Download the post offices”.
- Fill in the sender: name, phone, e-mail, post code and city of the hand-in office.
- In WooCommerce → Settings → Shipping add the to-an-office and to-an-address methods to the Bulgaria zone and set the prices.
- A buyer in Bulgaria picks an office or an address at the checkout and places the order.
- In the order press “Create the parcel”: the parcel appears at Bulgarian Posts and the buyer gets the number by e-mail.
- Print the PDF waybill and hand the parcel in at a post office (or switch on collection from the sender’s address). In Pro parcels, waybills and tracking can run in bulk or automatically.
Under the hood
- The Bulgarian Posts API (api.bgpost.bg): the office nomenclature, the portal session, the order number, creating and deleting a parcel, the waybill, price calculation, tracking, international Interconnect parcels.
- The GUIDs are stored encrypted and never shown in the settings or the log; every call goes from your server over HTTPS, the buyer’s browser does not see them.
- Only the data a parcel needs goes to Bulgarian Posts: the buyer’s name, phone, e-mail and address or the office, the weight, the contents, the order number, the sender details. For the live price: the office or post code and city, the weight and the cart value, no names or phones.
- The office list lives in its own database table and is refreshed daily by WP-Cron; search by city, street, name and post code in Cyrillic and Latin.
- Parcel data is kept in the order meta through the WooCommerce API, so the module works with HPOS and with the classic posts table.
- Empty fields are not sent to Bulgarian Posts; the call log in WooCommerce → Status → Logs is switched on in the settings, errors are always written.
Installation
- Plugins → Add New → Upload Plugin: choose the zip and activate it (WooCommerce must be active).
- WooCommerce → Bulgarian Posts: paste the GUID, press “Check the connection” and “Download the post offices”, fill in the sender, save.
- Add the Bulgarian Posts methods to the Bulgaria shipping zone.
- For Pro: paste the licence key or start the trial in the “Licence” block on the same page.
Questions
about the module
Didn't find the answer? Message us on Telegram and we'll reply within a business day.
Is this the official Bulgarian Posts plugin?
No, it is an independent integration by CatCode. The name and logo of Български пощи belong to their owner; the plugin is not affiliated with the company and not endorsed by it.
What is needed from Bulgarian Posts?
A contract for online shops (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 choice and the office list do not depend on the contract.
Does the plugin change the buyer’s address?
No. The chosen office is written into the order’s shipping address on the server, and the address in the buyer’s account stays their own.
Does it work on the block checkout?
Yes, on the classic and the block checkout, and with HPOS.
Does cash on delivery work?
Yes, in Pro: the amount goes into the parcel as наложен платеж. In the free version a parcel is not created for an order with cash on delivery, with an explanation in the order.
Can it deliver abroad?
Yes, in Pro: the method “Bulgarian Posts — international parcel” creates Interconnect parcels with the live price. Cash on delivery abroad is not possible.
What happens after the trial?
Pro switches off and the free part keeps working: the to-an-office and to-an-address methods with a fixed price, one parcel per order, the waybill, the e-mail to the buyer. Queued automatic parcels are not created, and the reason is written into the order.
How many sites does the key cover?
One key works on two sites: the shop and a development copy.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
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
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.

















