bpost shipping


Bpost Shipping Manager is a service offered by bpost, allowing your customer to choose their preferred delivery method when ordering in your Woocommerce webshop.

The following delivery methods are currently supported:

  • Delivery at home or at the office.
  • Delivery in a pick-up point or postal office.
  • Delivery in a parcel locker.
  • Delivery in one of the shop points.

The plugin offers following advantages:

  • Provide access to a wide choice of delivery methods
  • Offer value added services (insurance, notification)
  • No manual input/input document (csv/xml/…) required
  • Configurable delivery costs, based on promotion rules of Woocommerce
  • Labels generated by bpack in different formats compliant to industry standards
  • Electronic data exchange for 100% data quality
  • No validation requirements. Print & ship!

Real time interfacing with your bpost shipping manager account means that your shop orders are automatically added to the bpost portal.

No more hassle and 100% transparent!

Get more informations on bpost Shipping Manager


You need a bpost Shipping Manager active account.
More info to suscribe this service here: http://www.bpost.be/site/fr/business/send_post/parcels/shippingmanager.html

Please be sure you defined a valid default sender address in the Shipping Manager backend; as well as prices for each weight range, for each shipping method.
Check also the other Shipping Manager backend prerequisites detailed in https://bpost.freshdesk.com/support/solutions/articles/4000070401-prerequisites-configuration-default-sender-address-and-price-range-configuration

For any other question, do not hesitate to access bpost online support pages at https://bpost.freshdesk.com/solution/folders/4000015009


Based on the bpost Shipping Manager account settings :

  • display allowed delivery methods
  • enables bpost only for countries allowed in bpost Shipping Manager backend
  • takes into account shipping costs, per country, per weight
  • takes into account error, confirm and cancel pages
  • creates orders in bpost Shipping Manager backend once orders are finalized in the shop
  • adds custom fields “phone” and “email” address fields to be filled in within the bpost Shipping Manager if delivery address chosen in the shop is different than the billing address
  • plugin is trilingual: fr_FR, nl_Nl and en_EN

Usage notice

bpost shipping is not allowed and will display an error message:

  • if total weight of the order is above 30 kgs or the equivalent in OZ
  • if cash on delivery payment mode is selected

bpost shipping supports:

  • free shipping coupons from standard Woocommerce feature – NOT requiring that “Free delivery” method is active!
  • free shipping for some shopping cart amount AND/OR some countries (to be defined in bpost shipping settings in Woocommerce) – in this case, shipping costs defined in bpost Shipping Manager backend are overriden

bpost shipping does NOT take into account the Woocommerce “shipping classes”, nor the VAT/taxes configured to apply on the shipping costs.
Indeed: shipping costs are always “VAT 21% inclusive” in bpost Shipping Manager backend.

bpost shipping costs depending on the parcels weight are managed through the values defined in bpost Shipping Manager backend, and all prices are (belgian) taxes included.


bpost shipping plugin is compatible with Woocommerce as from 2.4.8

bpost shipping plugin requires PHP 7.2 or higher

bpost shipping plugin has been tested and is compatible with the following extensions:

  • Ogone Payment Gateway for WooCommerce – http://www.woothemes.com/products/ogone/
  • WooCommerce PostNL Parcelware – https://wordpress.org/plugins/woocommerce-postnl-parcelware/
  • UPS WooCommerce Shipping Method Plugin – https://wordpress.org/plugins/ups-woocommerce-shipping-method/
  • WPML Multilingual CMS – https://wpml.org/
  • WPML String Translation – https://wpml.org/
  • WPML Translation Management – https://wpml.org/
  • WPML Media – https://wpml.org/


  • bpost shipping manager Woocommerce plugin configuration
  • bpost delivery method on end user side
  • bpost shipping manager loaded
  • Woocommerce order list
  • Woocommerce order details


  1. Create and configure a bpost shipping manager account (https://www.bpost.be/site/fr/applications/portal/discover.html)
  2. Upload the plugin folder to the /wp-content/plugins/ directory
  3. Activate the plugin through the ‘Plugins’ menu in WordPress
  4. Define your shipping methods under the Woocommerce settings tab
  5. Configure your bpost shipping settings under the Woocommerce shipping > bpost shipping tab


நவம்பர் 21, 2022
Plugin not working and will break your webshop when installing with newer versions than 5.7.5 (WordPress) and 5.2.3 (woocommerce), no feedback from developer for over months when different people already logged these issues
நவம்பர் 20, 2020
The plugin works as intended and is a great opportunity for belgian e-shops to go with local logistic services as Bpost. Although the plugin offers a lot of functionalities already, there is room for improvement (e.g. house number “situation” on checkout page, better compatibility between shm countries and woocommerce countries). At this point, I also recognize that this plugin is limited by the shm itself, which needs a strong upgrade in my opinion. Thank you for this great plugin.
செப்டம்பர் 3, 2016
Works really well. Support is very good. Very happy about it!
Read all 5 reviews

பங்களிப்பாளர்கள் & உருவாக்குனர்கள்

“bpost shipping” is open source software. The following people have contributed to this plugin.


“bpost shipping” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “bpost shipping” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



Release date: 2024-07-19

  • bpost API URL is now https://shm-rest.bpost.cloud/services/shm


Release date: 2024-07-16

  • international pickup points could generate an error


Release date: 2024-07-10

  • The refreshing of the shipping status failed


Release date: 2024-07-10

  • Checkout page failed if there was no chosen shipping methods


Release date: 2024-06-06

  • Improve compatibility with WP Overnight plugin


Release date: 2024-06-05

  • Improve compatibility with WP Overnight plugin


Release date: 2024-05-13

  • Declare compatibility with HPOS
  • Declare incompatibility with block-based checkout (yet!)


Release date: 2024-04-30

  • Logs failed with PHP 8.0+


Release date: 2024-04-10

  • Add compatibility with HPOS
  • Confirm compatibility with WP 6.5
  • Logs are now WC logs compliant


Release date: 2024-02-29

  • Shipping country was in some cases not updated


Release date: 2023-02-14

  • Avoid a PHP warnings on checkout page


Release date: 2024-01-31

  • The popup button was not displayed in some cases


Release date: 2024-01-19

  • Hide button if there is no label to print
  • Confirm compatibility with WordPress 6.4 and WooCommerce 8.*
  • Avoid PHP error during printing of labels


Release date: 2023-11-08

  • Update bpost button translation
  • Avoid a PHP warning in some cases


Release date: 2023-10-20

  • Improve visibility of the button
  • Improve validation of bpost delivery method
  • Confirm tested up to WP 6.3


Release date: 2023-10-17

  • Add virtual products compatibility


Release date: 2023-10-11

  • The popup appears during the checkout process, not after; the customer has to choose delivery method before to pay


Release date: 2023-06-22

  • Change way to retrieve details on pick-up point


Release date: 2023-06-15

  • Fix pick-up point map on page order review


Release date: 2023-04-05

  • Add compatibility with theme Divi


Release date: 2023-04-03

  • Check WP guidelines


Release date: 2023-03-30

  • Check WP guidelines
  • Author is now bpost
  • Plugin tested up to WP 6.2


Release date: 2023-03-28

  • Update plugin compatibility


Release date: 2023-03-16

  • Invalidate packages cache to force re-calculation of shipping prices
  • Update compilation stack


Release date: 2022-07-15

  • Confirm compatibility with WordPress 6.0


Release date: 2022-04-06

  • Update package monolog/monolog to ^2.0
  • Require PHP 7.2 or newer


Release date: 2021-11-05

  • Avoid fatal error if a hook is called with WP_Comment instead of WP_Post


Release date: 2021-10-11

  • Confirm compatibility with WordPress 5.8 and WooCommerce 5.7


Release date: 2021-08-31

  • Improve management of errors from bpost API


Release date: 2021-06-17

  • Improve compatibility with PHP 8.0


Release date: 2021-05-28

  • Mandatory fields was not checked when SHM popup appeared


Release date: 2021-04-29

  • Suppress spaces in API URL to avoid plugin fatal error


Release date: 2021-04-19

  • Restore limitation cart of 30kg for free shipping


Release date: 2021-02-26

  • Avoid failure because of a too old version of curl
  • Confirm compatibility with Woocommerce 4.9


Release date: 2021-02-11

  • Confirm compatibility with WordPress 5.6
  • Add a specific message for ssl issues


Release date: 2020-12-21

  • Add logs
  • Improve error displaying by adding info for bpost support


Release date: 2020-12-15

  • Avoid “Edit order” crashed when bpost order was missing


Release date: 2020-11-26

  • Fix tracking URL
  • Force HTTPS for GoogleApis calls


Release date: 2020-11-06

  • Remove debug logs


Release date: 2020-11-02

  • Update tracking URL
  • Add debug logs to improve support


Release date: 2020-04-22

  • Update PUGO endpoint


Release date: 2020-04-14

  • Free shipping works with or without VAT


Release date: 2020-01-13

  • Plugin is again compatible with PHP 5.6


Release date: 2019-11-20

  • Set plugin has been tested up to WordPress 5.3


Release date: 2019-11-20

  • Set plugin has been tested up to WordPress 5.3
  • Label printing is now WP 5.3 compliant


Release date: 2019-10-30

  • Errors were encountered in not-order posts edition


Release date: 2019-10-29

  • Block “print labels” appeared even for non-bpost orders


Release date: 2019-10-16

  • Add button “Tracking” in order view (thanks to bgstudio.be for the draft)
  • Update package antidot-be/bpost-api-library (geo6 endpoint changed)
  • Add bulk pdf labels export
  • Add folder choice to store labels
  • Add an API to get labels from your webshop instance


Release date: 2019-03-28

  • Add link “Configure” in plugins list
  • Clean hooks and duplicated code
  • Discounts are included in free shipping calculation


Release date: 2019-01-30

  • Reduce plugin size
  • Update dependencies
  • Be compatible with composer (composer require antidot/woocommerce-bpost-shipping)


Release date: 2019-01-29

  • Confirm compatibility with WordPress 5.0
  • Display printing labels in orders list
  • Free shipping now triggered by net amount due (total basket with tax minus vouchers)
  • Some code fixes and refactoring


Release date: 2018-02-20

  • Confirm compatibility with WordPress 4.9
  • Fix deprecated message from WooCommerce 3.0


Release date: 2017-07-06

  • Add compatibility with plugin WooCommerce PDF Invoices & Packing Slips Professional
  • Cache calls to API
  • Some delivery methods displayed during free shipping
  • Improve compatibility with WooCommerce 3.x


Release date: 2017-04-27

  • Update readme file


Release date: 2017-03-06

  • Update readme file


Release date: 2017-02-27

  • Update readme file


Release date: 2016-12-27

  • Up compatibility to WP 4.7
  • Don’t show button “print bpost label” for non-bpost orders
  • Update API library to solve a error 500


Release date: 2016-11-07

  • Up compatibility to WP 4.6


Release date: 2016-11-07

  • Use “Shipping zones” feature of WooCommerce 2.6
  • Many labels are printable on a page
  • Display “free shipping available” when it’s available


Release date: 2016-08-09

  • Use Geo6 map for bpost points
  • Add bpost logo in transporters list
  • Save the state/county/province
  • bpost status are displayed in admin (and refreshable)


Release date: 2016-08-08

  • Update bpost API library


Release date: 2016-08-05

  • Translations were not loaded


Release date: 2016-08-04

  • Show under the free shipping table if amounts include, or not, VAT
  • The bpost cost estimation was sometimes based on prices without VAT


Release date: 2016-07-25

  • Complete some translations
  • Remove empty shipping info on order confirmation page
  • Remove a “strict standard issue”


Release date: 2016-06-21

  • Labels management
    • Printing from orders view, or from order page
    • Configuration (return label, format, cache, …)
  • Map location of the shipping address (using Google map)
  • HTML design on the admin page
  • Stability:
    • Improvement of code coverage
    • Functional tests
  • Review of translations EN/FR/NL


Release date: 2016-06-09

  • Avoid a second loading of plugins.php file


Release date: 2016-06-06

  • Enable plugin to work on multi-site WooCommerce installation
  • Change bpost label used on Cart & Checkout forms


Release date: 2016-05-03

  • Prefixing of all functions to avoid conflicts with others plugins


Release date: 2016-04-27

  • SHM pop-in is now compatible with plugins and themes which integrate their own jQuery library


Release date: 2016-04-21

  • Add dutch and french translations
  • Perform readability in the admin (country names, debug mode)


Release date: 2016-04-18

  • SHM pop-in is now compatible with several loads of jQuery versions


Release date: 2016-04-01

  • Force the SHM popup on mobile devices
  • Checkbox Ship to a different address? was automatically selected on the checkout page when getting back from SHM


Release date: 2016-03-25

  • Perform the free shipping calculation
  • Invalid JS cache between releases
  • Send a weight to the SHM, even if the total weight is null


Release date: 2016-03-23

  • Add compatibility with WooCommerce older than 2.4.0


Release date: 2016-03-21

  • Add compatibility of zip codes with all countries
  • Better relation for the status of plugin with WordPress


Release date: 2016-03-18

  • Perform the coupon calculation


Release date: 2016-03-15

  • Fix: The final shipping price was not always overridden in payment page


Release date: 2016-03-09

  • Feat: Adapt totals calculation updated in WooCommerce 2.5.2


Release date: 2016-03-03

  • Feat: Update error messages in admin
  • Doc: Clean up and rationalize changelog


Release date: 2016-02-25

  • Fix: When bpost was the single delivery method, the SHM did not open
  • Feat: Add compatibility with Notio theme


Release date: 2016-02-24

  • Feat: No more virtual pages to load the SHM popup to limit interferences with other plugins and actions happening at the end of the ordering process


Release date: 2016-02-19

  • Feat: Use the total cost value sent back by SHM to include options extra costs (like Saturday delivery) to the total delivery cost


Release date: 2016-02-08

  • Fix: Catch API exceptions
  • Fix: On the SHM, an error 1211 was generated because of float precision
  • Feat: Adapt to WooCommerce 2.5.2 because the VAT calculation changed
  • Feat: Update README with new free shipping improvements (1.1.0)


Release date: 2016-02-03

  • Feature: Improved Free Shipping settings options. Define easily cart amounts per country to offer free shipping.


Release date: 2015-11-27

  • Initial release