Swiss Post: documentation EN


↑ Back to top

First of all, thank you for purchasing this plugin.

This documentation is to help you with each step of the configuration. Please go through the documentation carefully to understand how the plugin works and how to configure it properly.


↑ Back to top

You will need a contract with Swiss Post to use the Digital Commerce API.

If you already have credentials, you may skip these steps.

  1. First, you must obtain a billing relationship with Swiss Post, which can be accessed here.
  2. You will then receive a franking license from your direct manager at Swiss Post.
  3. The credentials for the API can be retrieved here.

If you are planning to use the Swiss Post Barcode service, you must also register with Swiss Post for the Barcode service.

 This step is mandatory for the plugin to work.

Supported type of shippment

↑ Back to top

Letters :
– Post A+ (up to 25 x 17.6 cm, 1–250 g, max. 2 cm thick)

Parcels :
– PostPac Priority
– PostPac Economy
– Bulky goods Priority
– Bulky goods Economy
– PostPac Priority GAS
– PostPac Economy GAS
– Swiss-Express Moon

How to install

↑ Back to top

Upload via WordPress Admin

↑ Back to top

The easiest way to install the plugin is through the WordPress Admin.

Go to your WordPress admin and visit Plugins » Add New.

Click Upload Plugin at the top of the page.

This will open the plugin upload form. Click Choose File and select the plugin ZIP file.

After you have selected the file, click Install Now.

WordPress will now upload the plugin file from your computer and install it for you. You will see a success message like this after the installation is finished.

Once installed, you need to click on the Activate Plugin link to start using the plugin.

WordPress documentation

Upload via FTP Server

↑ Back to top

In some rare cases, your WordPress hosting provider may have file restrictions that could limit your ability to install a plugin from the admin area.

In this situation, you need to install the plugin manually with FTP using these steps (not recommended for beginners).

  1. First, you will need to extract the plugin ZIP file on your computer.
  2. Open the FTP client on your computer and connect to your website
  3. Navigate to the /wp-content/plugins/ folder
  4. upload the folder you extracted from the zip file to the /wp-content/plugins/ folder on your web server.
  5. Visit the WordPress admin area and click on the Plugins link in the admin menu. You’ll see your plugin successfully installed on the plugins page.
  6. You need to click on the Activate link below the plugin to start using it.

If you do not have any technical experience, we recommend contacting support for help.

Connect to Swiss Post API

↑ Back to top

To access the Swiss Post page, please go to your WordPress admin area.

On the left pannel, you will notice a new tab Swiss Post, click here.

To setup the plugin, please complete the fields Client Identifier and Client Secret. These credentials were provided by Swiss Post during registration and are mandatory for the plugin to work.

If you do not have credentials yet, see requirements.

Once you have successfully configured your credentials, you will have access to the dashboard and you will be able to choose which services you would like to use


↑ Back to top

Since June 2023, the default endpoint has changed from WEDEC to DCAPI. You can change your preferred endpoint here if you have access to both endpoints.


↑ Back to top

The barcodes service allows you to generate shipping labels for your packages, containing the address of the sender, the recipient, the delivery method, its options and the tracking barcode

Barcodes service setup

↑ Back to top

Franking licence(s)

↑ Back to top

In order to configure the plugin to use the Barcodes service, you must setup your franking license(s).

If you add multiple franking licenses, a dropdown selection will be available when generating barcodes to choose which license to use for every label.

Type : Based on the information you received from Swiss Post, please choose if this licence is for parcels or letters.
License : the licence number is a sequence of 6 to 8 numbers.
Nickname : Optionnaly give a nickname to this licence, the module will then display the nickname instead of the licence number in the backoffice.

Please note that letters and parcels have different franking licences

Delivery methods, options and handling

↑ Back to top

All the delivery methods, delivery options and handling options available with the plugin are listed. You can check the ones best suited for your activity to simplify the interface on the admin order page.

Please note that the delivery methods & handling options you enable here don’t determine how each label will be generated, but what options are actually available when generating a barcode. It simply removes options you will never use.

Delivery methods determine the type of shipment, delivery time, and rates.

Delivery options determine ways of processing a mailling

Handling options provide instructions to the delivery man for delivery or returns

Printing options

↑ Back to top

Paper format : This is the actual paper size you print your labels on. For example, if you use an A4 sheet with 4 A6 labels, you would choose A4 here. If you use a thermal label printer or print on the final format paper, please choose the final format here and in “Label format”.

Label format : This is the final label format you use. For example, if you use an A4 sheet with 4 A6 labels, you would choose A6 here. If you use a thermal label printer or print on the final format paper, please choose the final printed format here and in “Paper format”.

Status after label generation

↑ Back to top

The plugin will automatically change the status of your order upon a successfully generated barcode label, the most common use would be to set this to a Completed status. This is particularly useful when using the bulk order functionality as it prevents you from having to change every order’s status individually.

Sender address

↑ Back to top

Use other address for return labels (GAS) : Only if you use PostPac GAS (returns from your customers). If you don’t select this option, the same sender address will be used for GAS returns.

Hide sender address and/or use logo instead : If you select this option without uploading a logo, no sender address will be printed on the label. If you upload a logo, it will replace the sender address.


↑ Back to top

By default, the plugin will display your shop address as the sender on the barcode labels.

You may choose to display a logo instead of your address by uploading a logo.

The placement of your logo can be adjusted to your preferences using the rotationaspect ratiohorizontal alignment and vertical alignment options.


↑ Back to top

After ordering, Swiss Post can keep your customer informed of the shipment status through several channels (SMS or email). This has nothing to do with email notifications sent from your CMS, it’s a paid service from Swiss Post.

This is a paid service.

Find ou more

You may choose a logo to be displayed in notifications; this field is not required.

In order to set up the notifications you wish to use, you may use the notification builder. This tool allows you to add as many notification services as you want.

  • Communication method: Choose between SMS or e-mail communication
  • Service: The notification service you wish to use.
  • Free texts (optional): For most e-mail notifications, you can provide texts which will be included, the content is up to you.

 If your shop offers customer side language support, be sure to provide the texts in all languages using the language switcher.

The plugin attempts to recognize your customer’s preferred language. As customer side languages are not natively integrated with WordPress, we currently offer compatibility for WPML and any language plugin that uses native user locales.

Single order usage

↑ Back to top

You can generate a barcode for a single order from the order details page in the WordPress admin area.

To do so, you will find a new order section named SwissPost barcodes, here you can configure your label options.

Position : You configured a printing paper format that has multiple labels on it. Please choose on which position the first label should be printed. The next labels (in bulk mode) will be printed in the following positions..

Once you are satisfied with your barcode configuration, please click Generate barcode to generate the barcode labels.

 If the download does not start automatically, simply click on the displayed download link.

Bulk order usage

↑ Back to top

You can also generate barcodes for multiple orders in one go. Visit Woocommerce » Orders and check the wanted orders in the list.

You will find a new action named Generate barcodes available in the “Bulk actions” dropdown, please select it, then click Apply.

A pop-up modal will appear showing the different options available.

Position : You configured a printing paper format that has multiple labels on it. Please choose on which position the first label should be printed. The next labels (in bulk mode) will be printed in the following positions..

 In bulk generation mode, the same options will be used for each generated barcode label.

Shipment tracking

↑ Back to top

Natively, Woocommerce does not offer a functionality to save an order’s tracking number and send it to the customer. For this, the purchase of this additional plugin is advised. If it is installed, our plugin will automatically update the tracking number for the generated barcode.

If you do not want to install this module, you can find tracking numbers and tracking links in the order barcode generation modal

Address validator

↑ Back to top

The address validation module adds, below the address form in the Woocommerce checkout, a button allowing your customers to check whether their address is recognized as valid by the Swiss Post. If not, corrections will be proposed. There is no obligation to use it, your customers can still use an unvalidated address for their order.


↑ Back to top

To allow your customers to validate their addresses with Swiss Post, please ensure you have activated the service in the plugin configuration.


↑ Back to top

Users can validate their Billing and Shipping addresses during checkout by using the Validate my address with Swiss Post button at the bottom of the form.

The button will become red or green depending on the status returned by Swiss Post.

Address autocomplete

↑ Back to top

The Address autocomplete module activates an “autosuggest” feature on the address fields of the Woocommerce order form. For example, when your customer starts typing a street name, they will automatically be offered autocompletion suggestions.


↑ Back to top

To allow your customers to autocomplete their addresses with Swiss Post, please ensure you have activated the service in the plugin configuration.


↑ Back to top

Auto-completion will occur whilst completing the Billing and Shipping address forms.