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

Get in touch
WooCommerce

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.

Download Free
Pro · one-year licence Staging copies are included. The more sites, the cheaper each one
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
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
The “to a post office” method with an office picker at the checkout: search by city, street, name and post code in Cyrillic and Latin ✔ ✔
The “to your address” method in Bulgaria ✔ ✔
Fixed price, free from an amount, a free-shipping coupon, a weight limit, the tax status ✔ ✔
A list of about 2,800 offices, refreshed daily ✔ ✔
A parcel from the order in one click, a PDF waybill, deletion before hand-in ✔ ✔
An e-mail to the buyer with the parcel number and the number in the order summary ✔ ✔
Classic and block checkout, HPOS ✔ ✔
The live price from the Bulgarian Posts tariff with markup and rounding — ✔
Cash on delivery (наложен платеж) on the parcel — ✔
An automatic parcel by order status — ✔
Bulk parcels, waybills as one ZIP, tracking — ✔
Hourly tracking in the order notes — ✔
International Interconnect parcels with the live price — ✔
Bulgarian interface — ✔
Updates from catcode.com.ua — ✔

What it looks like

Office choice at the checkout
The WooCommerce block checkout in Bulgarian: the method “Български пощи — до пощенска станция” is selected, the chosen office with its address and a “Промяна” button are shown under it.
Connection and sender
WooCommerce → Bulgarian Posts: the portal GUID (stored encrypted), “Check the connection”, “Download the post offices” and the sender details.
The Bulgarian Posts method in a shipping zone
WooCommerce → Settings → Shipping → the Bulgaria zone: title, tax status, fixed price, free from an amount, weight limit; the Pro fields are the live tariff, markup and rounding.

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

v1.0.0 Current 16.11.2026

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

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 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

  1. Sign the Bulgarian Posts contract for online shops: the company sends the contractGUID and the portalUserGUID.
  2. Install the plugin, paste the GUID in WooCommerce → Bulgarian Posts, press “Check the connection”, then “Download the post offices”.
  3. Fill in the sender: name, phone, e-mail, post code and city of the hand-in office.
  4. In WooCommerce → Settings → Shipping add the to-an-office and to-an-address methods to the Bulgaria zone and set the prices.
  5. A buyer in Bulgaria picks an office or an address at the checkout and places the order.
  6. In the order press “Create the parcel”: the parcel appears at Bulgarian Posts and the buyer gets the number by e-mail.
  7. 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

  1. Plugins → Add New → Upload Plugin: choose the zip and activate it (WooCommerce must be active).
  2. WooCommerce → Bulgarian Posts: paste the GUID, press “Check the connection” and “Download the post offices”, fill in the sender, save.
  3. Add the Bulgarian Posts methods to the Bulgaria shipping zone.
  4. 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.

@catcode_support Setup, compatibility, activation
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.

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