Digital Commerce API
Obtain our services via an interface

E-commerce is your business. We ensure it runs smoothly: let’s simplify the ordering process for customers. From identification and determining the place of receipt to the delivery time slot, we have the right service to make a simple purchase an enjoyable experience.

What is API technology?

API (application programming interface) refers to programming interfaces through which two computer programs can interact without any further intervention. Imagine API as a universal plug that fits every socket.

API technology facilitates automatic data exchange between two completely independent IT systems. This means that customer-specific information, such as addresses and e-mail addresses, or our delivery services with the desired location and delivery time, are directly available to you.

Rich Content Section

“Digital Commerce API: one technology — many applications” process graphic The graphic shows the four process steps: 1. Step: optimize checkout process: this includes the applications under the Address verification API Address verification and Autocomplete. Go to PickPost / My Post 24 API for applications, alternative delivery addresses, customer number and customer registration. Finally, the shipping options API, time slot and other options applications, including current area coverage are listed. 2. Step: Consignment preparation: This includes the applications under API barcode, parcel label and data exchange as well as international shipping documents under the title “Waybill API”. 3. Step: Track and manage shipments: Track consignments API with the “Current consignment infor-mation” application. 4. Step: Simplify returns: pick@home/collection API includes the application “Collection of returns in your customer environment”. A selection of other services is listed below. Maintain addresses, Define time slots, SameDay delivery, Barcode for business customers, DataTransfer, Domes-tic parcel labels, Collection, Track consignments API, Up-to-date consignment information, Track and manage shipments, Track consignments URL, "Notification service", "My consignments", Track consignments Business, Status reports with interface, White label integration, Prefranked return labels (GAS, 99.01), Collect parcels for return.

Open overview with linked services

Rich Content Section

To increase your benefits, we are constantly expanding the features built into the Digital Commerce API. The following functions are currently available:

API Address verification

Convenient autocomplete function for your customers in the web shop
Fewer returns thanks to comparison of addresses with Switzerland’s address directory

Price

The module is free of charge. You only invest in connecting it to your system.

API technical specifications

API Barcode

Create compliant parcel labels for large consignment volumes
Convenient to use directly from your system

Price

The module is free of charge. You only invest in connecting it to your system.

API technical specifications

API Shipping options

More convenience for your customers thanks to time slot delivery or or on the same day
Easy integration into your web shop

Price

The module is free of charge. You only invest in connecting it to your system.

API technical specifications

API PickPost / My Post 24

Alternative delivery locations can be selected directly from your web shop
We have 2,700 service points using the PickPost service and over 150 My Post 24 terminals.

Price

The module is free of charge. You only invest in connecting it to your system.

API technical specifications

API pick@home

Returns can't be avoided
Be remembered for the best service. We pick up the consignment from your customer

Price

The module is free of charge. You only invest in connecting it to your system.

API technical specifications

API Alternative delivery address / Login Post Connector

Integrated identification system for online shops, similar to those you may be familiar with from social media platforms
Your customers can select alternative delivery locations that they have stored with us

Price

The module is free of charge. You only invest in connecting it to your system.

API technical specifications

API Waybill

Creating the necessary documents for international parcel and express consignments
Convenient to use directly from your system

Price

The module is free of charge. You only invest in connecting it to your system.

API technical specifications

API Track consignments

Up-to-date information on consignment tracking in your system, e.g. for your cus-tomer service
Consignment tracking for your customers on your own digital channels

Price

The module is free of charge. You only invest in connecting it to your system.

API technical specifications

FAQs

If you would like a consultation about the following APIs or web services, contact your salesperson or e-mail e-commerce@swisspost.ch

You can find technical documentation for our APIs here.

You can find further information on each individual interface here:

“Barcode” web service based on SOAP technology, the technical successor of the “Barcode” web service is the Barcode API (REST technology). We recommend using the APIs, as the APIs enable a modular structure of additional services and the “Barcode” web service is no longer being developed.

Please check with your service provider / developer whether a REST or SOAP-based connection is planned.

Our sales teams will be happy to assist you in providing the access data for our web services. For French language queries, please contact our team at pme.ouest@swisspost.ch, and for all other languages, at kmu.mitte@swisspost.ch.

Information on error messages can be found in chapters 8.14.1 and 9.3 of the technical documentation or in the swagger documentation of the relevant API.

You can find the swagger documentation in the developer portal. Search for the relevant API and click on “OpenAPI” on the left-hand side.

If you continue to receive error messages, contact us using the below form and send the request and response along with your message as an attachment.

We cannot provide any product recommendations.

If you pass the labels on directly to a continuous-feed label printer, this can be done using printer language ZPL2. For this, the printer model used must support the printer language ZPL2, as otherwise the quality requirements on the labels will not be met.

It also depends on the format in which you would like to generate the label.

Information on the formats and printers can be found in chapters 8.2 – 8.6 and 8.9 of the technical documentation.

If you registered via our developer portal, you can track the status of your registra-tion in Your Subscriptions.

If you registered via our sales team or web form, we will usually send you your access details within three working days.

We send the access details in encrypted form. The following link will take you to a detailed set of instructions on how to open the encrypted IncaMail.

Instructions on opening encrypted IncaMail

Please also check your spam folder.

If this doesn’t answer your question, you can contact us using the form below.

Since the start of 2023, we no longer provide test access details.

Testing can also be done with working access data, e.g. if you set the “printpreview” status on the barcode to true in the request.

If, for example, you change the value of the “Printpreview” field to “true”, you will receive “SPECIMEN labels”.

Digital Commerce API
Help and support for business customers

We’re happy to help with any questions, problems or interest in our interfaces. Please use our contact form to allow us to advise you as best we can.

Form