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
Film: Digital commerce products
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 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 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 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 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 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 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 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.
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:
Please use our developer portal to receive credentials for our APIs or con-tact your salesperson.
Please note that a billing relationship with Swiss Post is required in order for you to use the APIs.
“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.
Please check the status under “printPreview” in your request:
- false = label printed without SPECIMEN
- true = label printed with SPECIMEN
If the problem persists, contact us via the contact form below.
Please use our developer portal to receive more scopes for our APIs.
Alternatively, you can also contact us using the form below.
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.
Please contact us using the form below, specify the number to which we should change the meter, and barcode labels will then be generated starting from that number.
Please use track and trace or contact customer service at +41 848 888 888.
Contact us using the form below.
In most cases, this is a decoding issue.
Please ensure that the Base64 code which you receive from us as a response is decoded with CP437 or CP850 and not with UTF-8.
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.
You can obtain the same reports that you get from DataTransfer.
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”.
All test access details were deactivated at the beginning of 2023 and are no longer valid.
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.
Multiple labels may not be created in the same request. Please create one request per label.
Since the start of 2023, we no longer provide test access details.
Please register your company for the API so that we can provide you with access details for your company.
Alternatively, we would recommend that you ask for your (pilot) customers’ access details.
You can find the technical documents for the API here.
You can find the swagger documentation in the developer portal. Search for the relevant API and click on “OpenAPI” on the left-hand side.