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.