PostNord International

Connect your PostNord International account to manage and print fully tracked global shipping labels. They help you handle your global e-commerce shipping, tracked parcel delivery, and international returns.

For detailed developer guides and instructions to programmatically connect via API Endpoint, see our PostNord International dev docs page.

PostNord International Integration Requirements

Connection Requirements:

  • An active account with PostNord International.

The following tables outline the required and optional configuration fields, along with their expected data types, necessary to establish a connection with the PostNord International carrier endpoint.

Field

Description

Type

Required

api_key

API Key

string

Green checkmark. Supported feature. Yes.

customer_number

Customer Number

string

Green checkmark. Supported feature. Yes.

application_version

Application Version: This 3-letter code is a Customer ID provided by the carrier.

string

Green checkmark. Supported feature. Yes.

Optional: To successfully integrate your account, provide the specific pickup, consignor, and authentication credentials detailed in the parameters table below.

Field

Description

Type

Required

issuer_code

Issuer code associated with the customer number country agreement.

string

ICON_greyminus.png Optional

generate_standard_label_size

Return longer, standard PostNord labels instead of 4x6.

boolean

ICON_greyminus.png Optional

issuer_code

Issuer Code

string

ICON_greyminus.png Optional

pickup_party_name

Pickup Party Name

string

ICON_greyminus.png Optional

pickup_party_address

Pickup Party Address

string

ICON_greyminus.png Optional

pickup_party_postal_code

Pickup Party Postcode

string

ICON_greyminus.png Optional

pickup_party_city

Pickup Party City

string

ICON_greyminus.png Optional

pickup_party_country

Pickup Party Country ISO Alpha-2 Code

string

ICON_greyminus.png Optional

consignor_name

Consignor Name

string

ICON_greyminus.png Optional

consignor_address

Consignor Address

string

ICON_greyminus.png Optional

consignor_postal_code

Consignor Postcode

string

ICON_greyminus.png Optional

consignor_city

Consignor City

string

ICON_greyminus.png Optional

consignor_country

Consignor Country ISO Alpha-2 Code

string

ICON_greyminus.png Optional

consignor_state

Consignor State

string

ICON_greyminus.png Optional

consignor_email

Consignor Email

string

ICON_greyminus.png Optional

consignor_phone

Consignor Phone

string

ICON_greyminus.png Optional

Connect PostNord International to ShipStation API

To connect your PostNord International account in the ShipStation API dashboard:

  1. Select the PostNord International tile from the Available Carriers pop-up window.

    PostNord International logo on the Connection tile.
  2. Enter your PostNord International API Key, Customer Number, and Application Version into the corresponding fields.

    Optional: provide the specific pickup, consignor, and authentication credentials detailed in the Requirements section of this article.

  3. Click the Connect button.

Available Features for PostNord International

The ShipStation API integration with PostNord International supports the following standard features:

Additional Features for PostNord International

The ShipStation API integration with PostNord International allows for the following additional features:

Feature

Description

Label Reference Fields

PostNord International lets you add custom label messages. Use label_message_1 to add custom label messages to the label reference fields.

Label Size Variance

Label Sizes: 4" x 6"

Label formats: PDF

By default, PostNord International returns 4" x 6" label.

Other label sizes can be enabled via the generate_standard_label_size in the carrier settings. (It is set to false as default).

If selected, then the label will be generated in the standard PostNord size that is longer than 4x6 and may vary depending on the service.

Service Points (PUDO)

PostNord International supports shipping to service points. Carrier supports delivery to PUDO points and Service Point finder methods.

Tracking

ShipStation API's integration with PostNord International supports receiving tracking updates.

Electronic Customs Submission

PostNord International supports electronic customs declarations through standard CN22 and CN23 data mappings.

  • Customs Forms Supported: The carrier API automatically returns and supports required customs forms.

  • UK/US to Nordics Routing: For shipments originating in the UK or US heading to the Nordic countries, users must ensure their Issuer Code is set to ZDL in the connection settings. This ensures customs data is accepted properly and CN22/CN23 forms print correctly.

  • DDP Support: The integration supports Delivered Duty Paid (DDP), allowing merchants to bill duties and taxes back to the payor of the shipping charges.

Available Services, Packages, & Confirmation Types

PostNord International Services

Service

API Code

PostNord Home International

postnord_international_my_pack_home_international

PostNord Service Point International

postnord_international_my_pack_collect_international

PostNord Service Point PUDO International

postnord_international_my_pack_collect_service_point_international

Merchandise Mail Level 2

postnord_international_merchandise_mail_level_2

Merchandise Mail Level 3

postnord_international_merchandise_mail_level_3

Merchandise Mail Plus Parcel Level 3

postnord_international_merchandise_mail_plus_parcel_level_3

PostNord International Return Services

Service

API Code

PostNord Returns International

postnord_international_my_pack_return_intl

Merchandise Mail Return

postnord_international_merchandise_mail_return

PostNord International Package Types

Name

API Code

Attributes

Parcel

postnord_international_pc

International

The carrier can be used to create domestic shipping labels.

The carrier can be used to create international shipping labels.

ShipStation API will submit international customs declarations electronically to the carrier.

The carrier can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Shipment insurance, provided by the shipment's selected carrier, can be added to the shipment in ShipStation API. This insurance would be in addition to any default coverage already provided by that carrier.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

This carrier can be used to create multi-package shipments, where multiple labels are created for a single shipment and the individual packages are linked together in a single shipment record with a master tracking number.

You can connect this carrier to ShipStation API multiple times using different accounts and choose which account will be used to create each shipment.

PostNord International Integration Notes

  • The ShipStation API integration with PostNord International does not support third-party billing.

  • Shipment Insurance: PostNord International does not support adding carrier insurance to your shipments.

  • Confirmation Types: PostNord International does not require or support any confirmation types.

  • Manifest / End-of-Day: PostNord International doesn’t have or require an end- of-day process.

  • Paperless Labels: PostNord International does not currently support paperless labels.

  • Delivery Confirmation: PostNord International does not support Shipping Delivery Confirmation.

  • Void Labels: PostNord International does not support voiding labels with ShipStation API. There is an internal voiding method implemented.

Troubleshooting Tips for the PostNord International Integration

Here are some common issues, potential causes, and troubleshooting tips.

Issue

How to Troubleshoot or Resolve

403 Forbidden (PostNord API)

What it means: Authentication failed: api_key is missing or invalid.

What to do: Verify the carrier connection credentials. Generate or replace the API key in the PostNord Developer Portal, then retry the request.

The carrier can be used to create domestic shipping labels.

The carrier can be used to create international shipping labels.

ShipStation API will submit international customs declarations electronically to the carrier.

The carrier can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Shipment insurance, provided by the shipment's selected carrier, can be added to the shipment in ShipStation API. This insurance would be in addition to any default coverage already provided by that carrier.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

This carrier can be used to create multi-package shipments, where multiple labels are created for a single shipment and the individual packages are linked together in a single shipment record with a master tracking number.

You can connect this carrier to ShipStation API multiple times using different accounts and choose which account will be used to create each shipment.