# PostNord International

[PostNord International](https://www.postnord.com/) offers international shipping solutions for shipments originating in GB, DE, NL, PL, FR, US, CA, BE, CZ.

This guide provides developers with the details needed to build PostNord International shipping capabilities into your ShipStation API workflows.

## Requirements

| Property | Type | Required? |
|  --- | --- | --- |
| `api_key` | *string* | **required**  Provided by PostNord International (via developer portal); used to identify API customer. |
| `customer_number` | *string* | **required**  Consignor Customer Number for party identification (DK typically 9 digits). |
| `issuer_code` | *string* | Optional  Issuer code associated with the customer number country agreement. |
| `generate_standard_label_size` | *boolean* | Optional  Return longer, standard PostNord label instead of 4x6. |


### Connection Requirements

Pickup/Consignor party details: name, address, postal code, city, country, email, phone, state.

| Field | Description | Type |
|  --- | --- | --- |
| api_key | API Key | string |
| customer_number | Customer Number | string |
| generate_standard_label_size | Generate labels in standard PostNord International size | boolean |
| issuer_code | API Key | string |
| api_key | Issuer Code | string |
| pickup_party_name | Pickup Party Name | string |
| pickup_party_address | Pickup Party Address | string |
| pickup_party_postal_code | Pickup Party Postcode | string |
| pickup_party_city | Pickup Party City | string |
| pickup_party_country | Pickup Party Country ISO Alpha-2 Code | string |
| consignor_name | Consignor Name | string |
| consignor_address | Consignor Address | string |
| consignor_postal_code | Consignor Postcode | string |
| consignor_city | Consignor  City | string |
| consignor_country | Consignor  Country ISO Alpha-2 Code | string |
| consignor_state | Consignor State | string |
| consignor_email | Consignor Email | string |
| consignor_phone | Consignor Phone | string |


## Connect Account

You can connect a PostNord International account using the POST method to the `/v1/connections/carriers/` endpoint, or via the ShipStation API Dashboard.

For instructions on connecting PostNord International via the ShipStation API dashboard, go to our [PostNord International help article](https://help.shipengine.com/hc/en-us/articles/9586347109019).

### Connect via Endpoint

`carrier_name`: `postnord_international`

**POST /v1/connections/carriers/:carrier_name**


```http
POST /v1/connections/carriers/postnord_international HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json

{
  "nickname": "my PostNord International account nickname",
  "accountCode": "123456789",
  "username": "your_username",
  "password": "pa55word"
}
```

A successful connection will return a response with the `carrier_id`, which you'll use for any requests for this account going forward.

## Rates

PostNord International does not send estimated rates to ShipStation API. Your PostNord International account contact can provide you with the details about your contracted rates.

## Service Details

Available PostNord International services are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the [list carrier services](/apis/shipengine/docs/reference/list-carrier-services) endpoint at any time.

### International Services

PostNord International International shipping 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` |


### Return Services

| Service | API Code |
|  --- | --- |
| PostNord Returns International | `postnord_international_my_pack_return_intl` |
| Merchandise Mail Return | `postnord_international_merchandise_mail_return` |


### Packages

The following [carrier package types](/apis/shipengine/docs/shipping/carrier-packaging) are available for PostNord International services:

| Name | API Code | Package Attributes |
|  --- | --- | --- |
| Parcel | `postnord_international_pc` | International |


### Adding Shipment Insurance

PostNord International does not support adding carrier insurance to your shipments.

## Label Support

* Label sizes: 4" x 6"
* Label formats: PDF


By default carrier returns 4x6 label. Other label sizes can be enabled generate_standard_label_size in the carrier settings. If selected then the label will be generated in the standard PostNord size which is longer than 4x6 and may vary depending on the service (set to false as default).

### Label Reference Fields

PostNord International supports adding [custom label messages](/apis/shipengine/docs/labels/messages). Use `label_message_1` to add custom label messages to the label reference fields.

### Multi-Package Labels

PostNord International supports creating [multi-package shipments](/apis/shipengine/docs/shipping/multi-package) with all available services.

### Voiding Labels

PostNord International does not support [voiding labels](/apis/shipengine/docs/labels/voiding) with ShipStation API. There is an internal voiding method implemented.

### Paperless Labels

PostNord International does not currently support [paperless labels](/apis/shipengine/docs/labels/paperless).

## Delivery Confirmation

PostNord International does not support Shipping Delivery Confirmation.

## Advanced Options

PostNord International supports [advanced options](/apis/shipengine/docs/carriers/advanced-options). Supported Advanced Options:

* Limited Quantities of Dangerous Goods - Shipping Limited Quantities of DG is supported but for Denmark and Norway it is require to provide additional details in the products dangerous goods section:


`dangerous_goods.id_number`

`dangerous_goods.technical_name`

`dangerous_amount.amount`

## Manifests

PostNord International does not require [manifesting](/apis/shipengine/docs/shipping/manifests) your shipments.

## Scheduling Pickups

PostNord International does not support [scheduling a pickup](/apis/shipengine/docs/shipping/pickups) with ShipStation API.

## Service Points (PUDO)

PostNord International supports shipping to [service points](/apis/shipengine/docs/pick-up-drop-off/pudo-intro). Carrier supports delivery to PUDO points and Service Point finder methods.

## Tracking

ShipStation API's integration with PostNord International supports receiving tracking updates. Review our ​[Track a Package guides​](/apis/shipengine/docs/tracking/tracking)​ for details on tracking with the ShipStation API.

## Troubleshooting Tips

| Issue | Resolution |
|  --- | --- |
| HTTP 403 from PostNord API usually indicates missing/invalid api_key. Reconfirm API key in connection settings and regenerate if needed via Developer Portal. | Carrier Info (801) |
| For UK/US → Nordics on services 17/19/24 ensure issuer_code applies ZDL so customs data is accepted and CN22/CN23 print correctly. |  |
| If labels exceed 4×6 layout, either enable standard PostNord size or apply trimming logic per integration guidance. | label trimming note |
| 403 Forbidden (PostNord API) - means Authentication failed; api_key missing or invalid. | Verify carrier connection credentials; generate/replace API key in PostNord Developer Portal; retry request |


## Disconnecting Your PostNord International Account

See the Disconnect section in our [Delete a Carrier page](/apis/shipengine/docs/reference/carriers/delete-carrier) for the process of deleting or disconnecting a carrier from ShipStation API.

> **NOTE:**
If you disconnect a carrier account and reconnect it, the account will have a new `carrier_id` in ShipStation API.