> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Yhdistä PostNL

> Yhdistä PostNL kohdassa Kuljetusyhtiöt API-avaimellasi, Customer codella ja Customer numberilla sekä valinnaisella Collection locationilla ja Testitilalla.

**PostNL** lähettää paketteja Alankomaissa ja Belgiassa: ovelle, PostNL:n toimipisteisiin ja pakettiautomaatteihin, toimitusikkunoilla ja palautuksilla. Se kuljettaa myös EU:n sisällä ja maailmanlaajuisesti tulli-ilmoitusten kanssa. Kentät, jotka ovat yhteisiä kaikille kuljetusyhtiöille, ovat sivulla [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials).

<Info>
  Et valitse lähettäjän osoitetta tässä lomakkeessa. Lisää osoitteesi organisaatiovalikon → **Hallitse** → **Osoitteet** kautta. Valitset lähettäjän osoitteen jokaisella lähetyksellä tai [toimitussäännössä](/docs/fi/how-to/shipping-rule-fields).
</Info>

Jokainen PostNL-lähetys lähetetään omalla PostNL:n API-avaimellasi ja sopimustiedoillasi.

## Ennen kuin aloitat

* PostNL:n yrityssopimus (PostNL Pakketten), jossa haluamasi kuljetuspalvelut on otettu käyttöön.
* PostNL:n **API-avain** palvelusta [Mijn PostNL](https://mijn.postnl.nl/). PostNL antaa yhden avaimen testijärjestelmälleen ja toisen oikeille lähetyksille. Testiavain toimii vain, kun **Testitila** on päällä.
* PostNL:n **Asiakaskoodi** (1-6 merkkiä, esimerkiksi `DEVC`) ja **Asiakasnumero** (enintään 8 numeroa). Löydät molemmat PostNL-sopimuksestasi ja Mijn PostNL -palvelusta.
* Valinnainen: 6-numeroinen **Noutosijainti** -koodi, jos PostNL antoi sinulle sellaisen.

Voit yhdistää PostNL:n useammin kuin kerran, esimerkiksi yhden yhteyden jokaista sopimusta kohden. Anna jokaiselle oma **Kuljetusyhtiön nimi**. **Lue lisää** kortissa avaa PostNL:n sivun yritysasiakkaille.

## Yhdistä PostNL

<Steps>
  <Step title="Avaa Kaikki kuljetusyhtiöt">
    Napsauta sivupalkissa **Kuljetusyhtiöt** ja avaa sitten **Kaikki kuljetusyhtiöt** -välilehti.
  </Step>

  <Step title="Etsi PostNL">
    Napsauta **PostNL**-kortissa **Yhdistä**.
  </Step>

  <Step title="Täytä lomake">
    **Yhdistä kuljetusyhtiö** -ikkuna aukeaa. Kirjoita **Kuljetusyhtiön nimi**, **API-avain**, **Asiakaskoodi** ja **Asiakasnumero**. **Noutosijainti** ja **Testitila** ovat kohdassa **Valinnaiset kentät**.
  </Step>

  <Step title="Yhdistä kuljetusyhtiö">
    Napsauta **Yhdistä**. Näet viestin ”Kuljetusyhtiö yhdistetty”, ja kuljetusyhtiö ilmestyy **Omat kuljetusyhtiöt** -välilehdelle.
  </Step>
</Steps>

## Lomakkeen kentät

| Kenttä | Pakollinen | Mitä annetaan |
| - | - | - |
| **Kuljetusyhtiön nimi** | Kyllä | Nimi, jonka näet kohdassa **Omat kuljetusyhtiöt** ja kun valitset kuljetusyhtiön lähetykselle. Se on aluksi **PostNL**. |
| **Brändi** | Ei | Näkyy vain, jos organisaatiollasi on [brändejä](/docs/fi/how-to/create-a-brand). Lomake kertoo: ”Vain tämä brändi voi käyttää tätä kuljetusyhtiötä.” Jätä tyhjäksi, jos haluat jokaisen brändin voivan käyttää sitä. |
| **API-avain** | Kyllä | Avaimesi Mijn PostNL -palvelusta. Lomake kertoo: ”Your PostNL API key from Mijn PostNL (sandbox keys only work in Test mode).” |
| **Asiakaskoodi** | Kyllä | Lomake kertoo: ”Asiakaskoodi PostNL Pakketten -palvelussa (1–6 merkkiä, esim. DEVC).” |
| **Asiakasnumero** | Kyllä | Lomake kertoo: ”Asiakasnumero PostNL Pakketten -palvelussa (enintään 8 numeroa).” |
| **Noutosijainti** | Ei | Täsmälleen 6 numeroa. Lomake kertoo: ”Sopimukseesi kuuluvan PostNL-noutosijainnin 6-numeroinen koodi, jos sinulla on sellainen.” |
| **Testitila** | Ei | Valintaruutu, oletuksena pois päältä. Lomake kertoo: ”Käytä PostNL:n testijärjestelmää testiympäristön API-avaimella. Jätä pois päältä oikeita lähetyksiä varten.” |

**Yhdistä** ei tee mitään, ennen kuin kentillä **Kuljetusyhtiön nimi**, **API-avain**, **Asiakaskoodi** ja **Asiakasnumero** on arvo. Jos **Asiakaskoodi** on pidempi kuin 6 merkkiä, **Asiakasnumero** on pidempi kuin 8 tai **Noutosijainti** ei ole täsmälleen 6 merkkiä, näet viestin ”Kuljetusyhtiön yhdistäminen epäonnistui. Yritä uudelleen.”

**Testitila** lähettää lähetyksesi PostNL:n testijärjestelmään, joten oikeita lähetyksiä ei luoda. Käytä testi-API-avaintasi, kun se on päällä, ja tuotantoavaintasi, kun se on pois päältä. Katso [Testitila](/docs/fi/how-to/sandbox-mode).

## Yhdistämisen jälkeen

Kuljetusyhtiö ilmestyy kohtaan **Omat kuljetusyhtiöt** **Yhdistetty**-merkin kanssa. Valitset kuljetuspalvelun jokaisella lähetyksellä tai toimitussäännössä, et tässä lomakkeessa. Katso [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services).

Jokaisen kuljetuspalvelun kuvauksessa näkyy sen PostNL-tuotekoodi, jotta voit yhdistää sen sopimukseesi. Voit lähettää vain kuljetuspalveluilla, jotka PostNL on ottanut sinulle käyttöön. Muut kuljetuspalvelut hylätään lähetettäessä viestillä ”PostNL ei pystynyt luomaan lähetystä.”

Kuljetuspalveluryhmät:

* Alankomaiden sisällä (lähettäjä Alankomaissa): **Vakiolähetys**, toimitus vain ilmoitettuun osoitteeseen, allekirjoitus toimituksessa, Extra Cover, Age Check, kirjelaatikkopaketit ja **Nouto**-kuljetuspalvelut.
* Alankomaista Belgiaan, Belgian sisällä ja Belgiasta Alankomaihin, kullakin omat kuljetuspalvelunsa.
* **Parcel EU** kuluttajille (2C) ja yrityksille (2B), Track & Trace-, Insured- ja Insured Plus -versioina.
* **Parcel Non EU** ja kansainväliset postikuljetuspalvelut (kuten **Packet Track & Trace**) muualle maailmaan. Näihin kuuluu tilausriveistä muodostettu tulli-ilmoitus.
* **Palautukset**: palautus yrityksen vastauslähetysnumeroon tai kotiosoitteeseen, palautukset Belgian sisällä ja Belgiaan sekä **Easy Return Service** ulkomailta.

### Toimitusikkunat ja lisävalinnat

Alankomaiden sisäiset kuljetuspalvelut tarjoavat nämä lisäpalvelut: **Iltajakelu (klo 17.30–22.00)**, **Toimitus samana päivänä (luovutus ennen klo 11.00)** ja **Taattu toimitus ennen klo 10.00**, **12:00** tai **17:00**. Kun otat jonkin käyttöön, täytä myös **Toimituspäivä** kohdassa **Lisätiedot kuljetusyhtiölle**.

Jotkin kuljetuspalvelut tarvitsevat lähetykseltä lisätietoja:

* Extra Cover -kuljetuspalvelut tarvitsevat kentän **Vakuutusmäärä (EUR)**, enintään 5000.
* Age Check -kuljetuspalvelut tarvitsevat kentän **Vastaanottajan syntymäaika**.
* Kirjelaatikkopaketit tarvitsevat kentän **Toimituspäivä**.
* **Osoitekortin muoto** antaa valita **PDF** (oletus) tai **ZPL (lämpötulostin)** Zebra-tarratulostinta varten.

### PostNL:n toimipisteet (noutopisteet)

Kuljetuspalvelut, joiden nimi alkaa sanalla **Nouto** tai **Pick up**, toimittavat PostNL:n toimipisteeseen, kuten kauppaan tai pakettiautomaattiin. Toimipisteitä on saatavilla Alankomaiden ja Belgian osoitteisiin. Valitse toimipiste lähetykselle ennen lähettämistä. Katso [Valitse noutopiste](/docs/fi/how-to/pick-a-service-point) ja [Noutopisteet](/docs/fi/how-to/drop-point-and-service-points).

### Useita paketteja yhdessä lähetyksessä

Voit lähettää enintään neljä pakettia yhdessä lähetyksessä. Kirjelaatikkopaketteja on aina yksi paketti lähetystä kohden. Alankomaiden sisällä PostNL käsittelee paketit yhtenä lähetyksenä, jossa on osoitekortti jokaiselle paketille. Muilla reiteillä jokaisesta paketista tulee oma PostNL-lähetyksensä.

### Noutotilaukset, seuranta ja tulli

* PostNL ei ole käytettävissä kohdassa **Noutotilaukset**. Noudot sovitaan PostNL-sopimuksesi kautta.
* Zippendo hakee seurantapäivitykset PostNL:ltä tunnin välein. Mitään ei tarvitse määrittää. Katso [Kuljetusyhtiöiden seurannan webhookit](/docs/fi/how-to/tracking-webhooks).
* EU:n ulkopuolisille lähetyksille PostNL palauttaa tulli-ilmoitukset (CN23/CP71) ja kauppalaskun osoitekortin mukana, joten Zippendo ei lisää omia. Katso [Tulli ja asiakirjat](/docs/fi/how-to/customs-and-documents).

## Muuta tai poista yhteys

Muuttaaksesi sitä avaa **Kuljetusyhtiöt** → **Omat kuljetusyhtiöt** ja napsauta kortissa **Muokkaa kuljetusyhtiötä**. **Muokkaa kuljetusyhtiötä** -sivulla on kaksi osiota:

* **Yleiset**: **Kuljetusyhtiön nimi** ja **Brändi**, jos organisaatiollasi on brändejä.
* **Kuljetusyhtiön asetukset**: **API-avain**, **Asiakaskoodi**, **Asiakasnumero**, **Noutosijainti** ja **Testitila**.

Napsauta **Tallenna**. Näet viestin ”Kuljetusyhtiö päivitetty”.

Poistaaksesi sen napsauta samalla sivulla **Poista**, kirjoita kuljetusyhtiön nimi isoilla kirjaimilla ja napsauta **Poista**. Tätä kuljetusyhtiötä käyttävät toimitussäännöt poistetaan sen mukana. Jo lähettämiesi lähetysten osoitekortit ja seurantakoodit säilyvät.

## Yleisiä ongelmia

| Mitä näet | Mitä tehdä |
| - | - |
| ”Kuljetusyhtiön yhdistäminen epäonnistui. Yritä uudelleen.” | Tarkista pakolliset kentät ja yllä kuvatut pituudet ja yritä uudelleen. |
| ”Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä.” | Pakettisi kuljetusyhtiöiden raja on täynnä. Katso [Laskutus ja käyttö](/docs/fi/how-to/billing-and-usage). |
| ”Kuljetusyhtiö hylkäsi kirjautumistietosi. Päivitä kuljetusyhtiön tunnukset Kuljetusyhtiöt-sivulla.” lähettäessäsi | API-avain on väärä tai se ei vastaa **Testitila**-asetusta (testiavain kun **Testitila** on pois päältä tai päinvastoin). Korjaa se kohdassa **Muokkaa kuljetusyhtiötä**. |
| ”PostNL ei pystynyt luomaan lähetystä.” tai PostNL:n oma virheteksti | PostNL hylkäsi lähetyksen, esimerkiksi koska kuljetuspalvelu ei kuulu sopimukseesi tai osoite on väärä. Korjaa viestissä mainittu asia ja lähetä uudelleen. |
| ”Osa tämän kuljetuspalvelun valinnoista puuttuu tai on virheellisiä. Tarkista lähetyksen lisäpalvelut ja valinnat ja yritä sitten uudelleen.” | Pakollinen tieto puuttuu, kuten **Vakuutusmäärä (EUR)**, **Toimituspäivä** tai **Vastaanottajan syntymäaika**. Täytä se kohdassa **Lisätiedot kuljetusyhtiölle**. |
| ”Tämä kuljetuspalvelu toimittaa noutopisteeseen. Valitse noutopiste ennen lähettämistä.” | Valitse PostNL:n toimipiste lähetykselle. |
| ”Valittu kuljetuspalvelu ei kulje näiden maiden välillä. Valitse toinen kuljetuspalvelu.” | Valitse tälle reitille sopiva kuljetuspalvelu, esimerkiksi **Parcel EU** -kuljetuspalvelu toiseen EU-maahan. |

## Liittyvää

* [Yhdistä kuljetusyhtiö tai integraatio](/docs/fi/how-to/connect-index)
* [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials)
* [Testitila](/docs/fi/how-to/sandbox-mode)
* [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services)
* [Valitse noutopiste](/docs/fi/how-to/pick-a-service-point)
* [Pyydä kuljetusyhtiöintegraatiota](/docs/fi/how-to/request-carrier-integration)
* [Kuljetusyhtiöt](/docs/fi/tutorials/carriers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.