Integrations & API
PostNord
Connect your own PostNord contract: fields, service points in the checkout, booking and labels, tracking limits, errors, disconnecting and rate limits.
With your own PostNord contract, BunStack books parcels and prints labels through PostNord's API.
Where: Stack › PostNord.
You can use Sendify and PostNord at the same time. Each shipping method points at its provider. You build the shipping methods under Shipping.
Connect PostNord
- Create an API key in PostNord's Developer portal.
- Open Stack › PostNord and the Settings tab.
- Fill in the fields in the table below.
- Press Connect PostNord.
- Add shipping methods with provider PostNord under Settings › Shipping.
- Fill in the sender address in the Sender address & default parcel card on the same page.
PostNord now shows as a shipping method in the checkout of every storefront in the workspace.
| Field | What you enter | Default |
|---|---|---|
| Customer number (8 digits) | Your customer number at PostNord. Required. | – |
| Label format | The label format sent to PostNord. | label |
| Issuer code | The issuer code at PostNord. | Z12 |
| Application id | The application id at PostNord. | 1438 |
| API key (from PostNord Developer portal) | The key. One key covers labels, service points and tracking. | – |
- The integration counts as connected once you save a key. BunStack tries the key against PostNord, but the answer only sets a verified mark on the key.
- The button reads Update connection when a key already exists.
- Test connection runs a service point lookup with the key and shows PostNord's answer.
- The Service points tab looks up service points for a Swedish postcode (5 digits) with Find points. It is the same lookup the checkout makes.
Services
| Service | Service point required |
|---|---|
| PostNord Varubrev | No |
| PostNord Paket (hemleverans) | No |
| PostNord Ombud / utlämningsställe | Yes |
What happens when
| Moment | What BunStack does |
|---|---|
| The customer chooses a service point method | Shows PostNord's service points near the customer's postcode. |
| You ship the order | Books the parcel with PostNord and saves the label PDF on the shipment. The order gets the tracking number and the customer gets the shipped email. |
| Print shipping label on the shipment, or ⋯ Actions › Shipping labels | Fetches the saved label. BunStack creates no new one. |
| ⋯ Actions › Refresh tracking on the order | Asks PostNord for a tracking number that was missing at booking. |
The booking uses this data:
- Recipient: the customer from the order, or the service point for PostNord Ombud.
- Sender: the address under Settings › Shipping.
- Weight: the line's saved weight, else the variant's, the product's or the default parcel's. At least 0.1 kg.
Tracking
PostNord normally gives the tracking number at booking. The tracking link on the order and in the email goes to PostNord.
- When PostNord accepts the booking without a tracking number, the shipment stays pending. Press Refresh tracking on the order.
- BunStack fetches no tracking events from PostNord. No scheduled job asks PostNord.
- The order gets no delivery time and the customer gets no delivered email.
Errors and where they show
| Message | Cause | What to do |
|---|---|---|
| The fulfilment dialog says PostNord is not connected | The integration is not connected or the key is missing. | Connect PostNord under Stack › PostNord. |
| The fulfilment dialog says the customer number is wrong | The customer number is not 8 digits. | Correct Customer number (8 digits). |
| The fulfilment dialog says the sender address is missing | The Sender address & default parcel card is empty. | Fill in the sender address under Settings › Shipping. |
| PostNord's error text in the fulfilment dialog and on the shipment | PostNord rejected the booking. Nothing was booked. | Correct what the error text names and ship again. |
| Test connection shows an error | The key is wrong or lacks access. | Check the key in PostNord's Developer portal. |
Disconnect
Disconnect deletes the API key and turns the integration off. Booking, labels and service points stop. The customer number and other settings stay. To reconnect, enter the key again.
Rate limits
- Service points: 30 per minute per IP address and 300 per hour per storefront. At a limit, the checkout shows no service points until the time has passed.
- You book parcels and print labels in the admin. BunStack does not limit them.