Skip to content

Conformance with the PostNord documents

Part of the PostNord Shipping documentation. Previous: Developer notes.

Document rule Add-on
apikey query parameter on every API; 403 for a missing or wrong key (Guides) Key per environment, encrypted; a 403 / 401 refusal pauses the connection.
Sandbox atapi2.postnord.com, production api2.postnord.com (Guides) Environment switch per connection.
context=optionalservicepoint recommended for checkouts; postal code without spaces (Service Points V5) Used for the checkout list; postal codes normalised.
agreementCountry for points in another country than the agreement (Service Points V5) Sent only then.
ediInstruction field rules and maxLength (Booking APIs) Built and cut by characters (UTF-8) to the documented limits; validated against the definition in unit tests.
Service point delivery: deliveryParty with partyIdType 156 (Booking APIs, MyPack Collect example) Used for MyPack Collect.
Consignor customer number partyIdType 160 and issuerCode Z11-Z14 From the connection.
Labels in the booking answer, base64 PDF or ZPL (encoding) Stored from the same answer; re-download via labels/ids with printId or item id.
Deletion only after an Original and not for Z11, Z13, Z14 (updateIndicator) Deletion only for Z12 bookings not yet on their way; FAIL answers are reported; other countries void in the store.
Return Drop Off example (24) Return labels follow it.
Track and Trace v7 ItemStatus values Mapped to booked, in transit, ready, delivered, returned, needs attention; never backwards.
Transit time startTime is local date time Sent in the sender country’s zone without offset.
429 rate limit Treated as a refusal; the job retries after Retry-After.

Not used: Book Pickups, customs declarations, dangerous goods, cash on delivery (it needs bank account details in the instruction), the Delivery Options API (warehouse based) and EDI updates.