Skip to content

Configuration

Part of the PostNord Shipping documentation. Previous: Installation. Next: Usage.

Connection (Orders > PostNord shipments > Connection)

Section titled “Connection (Orders > PostNord shipments > Connection)”
Field Meaning
Agreement country Sweden, Denmark, Norway or Finland: the PostNord organisation that holds your customer number (issuer code Z12, Z11, Z13, Z14).
Environment Sandbox (atapi2.postnord.com, test data) or Production (api2.postnord.com).
API key (sandbox / production) Your own keys from atdeveloper.postnord.com and developer.postnord.com. Stored encrypted (AES-256-GCM); the form shows only the last four characters; an empty field keeps the stored key.
Customer number (sandbox / production) Digits only. Sent as the consignor of every booking (party id type 160).
Sender Name, street (two lines), postal code, city, phone, e-mail: the consignor address on labels.
Application id Optional, only if PostNord assigned one to your integration.
Return address Optional. Return labels send parcels here; empty = the sender address.

A refused key (403) pauses all automatic calls of the connection until you save or test again, so cron and the checkout never keep sending a wrong key.

Setting Default Meaning
Enable on Off = no new bookings or checkout lists; running jobs finish.
Marketplace owner mode (Multi-Vendor) on On: every order uses the owner’s connection and vendors cannot book. Off: each vendor connects their own PostNord account.
Book the parcel when the order status becomes empty Empty = only by hand. Otherwise the booking is queued when an order reaches this status.
Create a CS-Cart shipment on Records the item number with the PostNord tracking link on the order. No shipment e-mail is sent by this step.
Label format PDF PDF or ZPL.
PDF page size A4 A4, A5, A6 or Label.
Label type Standard Standard 190 x 105 mm, or small 75 x 105 mm where PostNord offers it.
Parcel weight when products have none 1 kg
Order reference prefix empty Use when several stores share one customer number.
Send the customer notes as delivery instruction off Order notes go to PostNord as free text DEL (200 characters).
Return service code 24 Basic service code of return labels (24 = Return Drop Off).
Return additional service codes empty As in your agreement.
Debug log, log retention off, 90 days
Field Meaning
Price, price by weight Your price for the customer: flat, or “up to kg = price” pairs (2=59, 5=79, 20=139). The public PostNord APIs have no price call.
Free shipping from Subtotal from which the price is 0.
Maximum weight Optional limit (use the limit of the service in your agreement).
Destination countries ISO codes, default SE, DK, NO, FI.
PostNord service code Empty = 19 (MyPack Collect), 17 (MyPack Home) or 18 (Parcel) by service; another basic service code of your agreement can be entered.
Additional service codes Comma separated, as in your agreement.
Delivery time text Returned as the delivery time of the method (themes show it under the method name).
Show the PostNord delivery estimate Asks the Transit Time API for the arrival from your sender postal code to the customer’s (cached per route and day, 4 second limit).