> ## 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.
# Posti koppelen
> Koppel Posti in Zippendo met je Client-ID, Clientgeheim en Nummer van het logistiekcontract, plus de optionele Gebruikersnaam voor de Tracking API en Wachtwoord voor de Tracking API.
**Posti** verzendt pakketten vanuit Finland: naar pakketautomaten en afhaalpunten van Posti, thuisbezorging, Express met bezorging de volgende dag, kleine pakketten aan de deur, klantretouren, en Priority- en EMS-pakketten wereldwijd. De velden die elke vervoerder heeft, staan bij [Inloggegevens van de vervoerder](/docs/nl/how-to/carrier-credentials).
Op dit formulier kies je geen afzenderadres. Voeg je adressen toe via het organisatiemenu → **Beheren** → **Adressen**. Het afzenderadres kies je bij elke zending of in een [verzendregel](/docs/nl/how-to/shipping-rule-fields). Posti verzendt vanaf een adres in Finland of Åland, en retouren komen terug naar een adres in Finland.
## Voordat je begint
* Een zakelijk klantaccount bij Posti met een **logistiekcontractnummer**, meestal zes cijfers.
* Een gebruiker in [OmaPosti Pro](https://pro.posti.fi/) met de rol **API Manager**, om in te loggen bij het [Posti Developer Portal](https://developer.posti.com/). Heb je die rol niet, vraag dan de hoofdgebruiker van OmaPosti Pro in je organisatie om **Users management → Users** te openen, bij jouw gebruiker op **Edit** te klikken en onder **Other services** het vakje **API Manager** aan te vinken.
* Een applicatieaccount in het Developer Portal, voor de **Client-ID** en het **Clientgeheim**. De stappen staan hieronder.
* Optioneel, voor track & trace: een serviceaccount voor de **Tracking API** van de klantenservice van Posti. Je kunt zonder dit account zendingen verzenden.
Je kunt Posti meer dan één keer koppelen, bijvoorbeeld één koppeling per logistiekcontract. Geef elke koppeling een eigen **Naam van de vervoerder**. **Meer informatie** op de kaart opent de pagina van Posti over zijn diensten voor e-commerce.
## Je inloggegevens van Posti ophalen
Open [developer.posti.com](https://developer.posti.com/) en log in met je gebruiker van OmaPosti Pro.
Open **Configure application accounts → Application account list** en klik op **Add new application account user**. Zet **Enabled** aan en geef de gebruiker een naam, bijvoorbeeld `Zippendo`.
Selecteer **shippingapi** en **2026-04**. Zonder **2026-04** kun je zendingen verzenden, maar werken het zoeken naar afhaalpunten en retouren zonder label niet.
Voeg het logistiekcontractnummer toe dat je in Zippendo invult en klik op **Save**.
Het portal toont ze één keer. Kopieer ze allebei. Ben je het geheim kwijt, maak dan nieuwe inloggegevens aan in het portal en werk de vervoerder bij in Zippendo.
Vraag voor track & trace de klantenservice van Posti om een serviceaccount voor de **Tracking API** voor je contract. Posti stuurt je een gebruikersnaam en een wachtwoord.
## Posti koppelen
Klik in de zijbalk op **Vervoerders** en open dan het tabblad **Alle vervoerders**.
Klik op de kaart **Posti** op **Koppelen**.
Het venster **Vervoerder koppelen** gaat open. **Naam van de vervoerder** is al ingevuld met "Posti". Vul je **Client-ID**, **Clientgeheim** en **Nummer van het logistiekcontract** in. **Gebruikersnaam voor de Tracking API** en **Wachtwoord voor de Tracking API** staan onder **Optionele velden**.
Klik op **Koppelen**. Je ziet "Vervoerder gekoppeld" en de vervoerder staat op het tabblad **Mijn vervoerders**.
## Velden op het formulier
**Clientgeheim** en **Wachtwoord voor de Tracking API** verbergen wat je typt.
| Veld | Verplicht | Wat je invult |
| - | - | - |
| **Naam van de vervoerder** | Ja | De naam die je ziet bij **Mijn vervoerders** en wanneer je een vervoerder kiest bij een zending. Begint als **Posti**. |
| **Merk** | Nee | Alleen zichtbaar als je organisatie [merken](/docs/nl/how-to/create-a-brand) heeft. Het formulier zegt: "Alleen dit merk kan deze vervoerder gebruiken." Laat leeg zodat elk merk hem kan gebruiken. |
| **Client-ID** | Ja | Het formulier zegt: "Uit het Developer Portal van Posti (developer.posti.com): de Client-ID van de gebruiker van het applicatieaccount die je voor Zippendo toevoegt. Selecteer beide API-rollen, shippingapi en 2026-04." |
| **Clientgeheim** | Ja | Het formulier zegt: "Het clientgeheim dat het Developer Portal één keer toont, samen met de Client-ID." |
| **Nummer van het logistiekcontract** | Ja | Alleen cijfers. Het formulier zegt: "Je logistiekcontractnummer bij Posti, meestal zes cijfers die beginnen met 6. Voeg het toe aan dezelfde gebruiker van het applicatieaccount in het Developer Portal, anders weigert Posti je zendingen." |
| **Gebruikersnaam voor de Tracking API** | Nee | Vul beide velden voor track & trace in of geen van beide. Het formulier zegt: "De gebruikersnaam voor de Tracking API die de klantenservice van Posti je voor je contract geeft. Alleen nodig voor track & trace van je zendingen." |
| **Wachtwoord voor de Tracking API** | Nee | Het formulier zegt: "Het wachtwoord dat Posti met de gebruikersnaam voor de Tracking API meestuurt. Posti blokkeert het account een uur na vijf mislukte inlogpogingen." |
**Koppelen** doet niets zolang **Naam van de vervoerder**, **Client-ID**, **Clientgeheim** en **Nummer van het logistiekcontract** geen waarde hebben.
## De koppeling testen
Posti heeft geen testsysteem, dus er is geen selectievakje **Testmodus**. Elke zending die je verzendt, is een echte Posti-zending op je logistiekcontract. Volgens Posti wordt een zending niet gefactureerd zolang die niet fysiek is verzonden, dus een testlabel dat je nooit afgeeft, kost niets.
Wil je de koppeling uitproberen, verzend dan één zending naar je eigen adres en controleer het verzendlabel. Posti stuurt de ontvanger meldingen, dus zet je eigen e-mailadres en telefoonnummer op een testzending. Zippendo kan een Posti-zending niet annuleren, dus neem contact op met Posti als je er een wilt laten annuleren. Zie [Testmodus](/docs/nl/how-to/sandbox-mode).
## Na het koppelen
De vervoerder staat bij **Mijn vervoerders** met de badge **Gekoppeld**. Het verzendproduct kies je bij elke zending of in een verzendregel, niet op dit formulier. Zie [Verzendproducten en extra diensten](/docs/nl/how-to/carrier-products-and-services). Een verzendproduct dat niet in je contract met Posti zit, wordt bij het verzenden geweigerd, met de reden van Posti.
| Verzendproduct | Bezorgt bij | Max. gewicht |
| - | - | - |
| **Postal Parcel (Postipaketti)** | Een pakketautomaat of afhaalpunt van Posti in Finland, Åland, Estland, Letland of Litouwen. | 25 kg |
| **Home Parcel (Kotipaketti)** | De deur van de ontvanger, op een tijdstip dat Posti met de ontvanger afspreekt. Finland, Åland en de Baltische staten. | 25 kg, 35 kg als Bulky |
| **Express Parcel (Express-paketti)** | Bezorging de volgende dag tegen handtekening. Finland, Åland en de Baltische staten. | 25 kg, 35 kg als Bulky |
| **Small Parcel to Door (Pikkupaketti ovelle)** | De brievenbus of deur van de ontvanger in Finland en Åland, tot 38 x 38 x 28 cm. | 4 kg |
| **Return (Palautus)** (retourzending) | Je klant geeft een pakket af bij een willekeurig afhaalpunt of pakketautomaat van Posti, voor jouw adres in Finland. | 25 kg, 35 kg als Bulky |
| **Priority Parcel** | Meer dan 200 landen, aan de deur of bij een afhaalpunt, afhankelijk van het land. | 25 kg, 30 kg als Bulky |
| **EMS** | Meer dan 200 landen, aan de deur tegen handtekening. | 25 kg, 30 kg als Bulky |
Elk verzendproduct behalve **Return (Palautus)** heeft het telefoonnummer van de ontvanger nodig, voor de meldingen van Posti. **Home Parcel (Kotipaketti)** en **Express Parcel (Express-paketti)** kunnen meerdere pakketten in één zending vervoeren. De andere verzendproducten nemen één pakket per zending.
### Extra diensten en extra gegevens
Elk verzendproduct heeft twee keuzes onder **Extra gegevens voor de vervoerder**:
* **Labelformaat**: PDF (de standaard) of ZPL voor thermische printers.
* **Bezorginstructies**: maximaal 120 tekens die op het verzendlabel worden gedrukt, bijvoorbeeld een deurcode.
Verzendlabels zijn 10 x 15 cm. Internationale verzendproducten die geen verzendlabel in dat formaat hebben, worden op een A5-pagina geprint.
Extra diensten kies je bij de zending of in een verzendregel. Elk verzendproduct toont de extra diensten die Posti erbij aanbiedt: **Aankomstmelding per sms of e-mail**, **Vooraankondiging vóór bezorging**, **Breekbaar**, **Bulky (pakket met overmaat)**, **Geen pakketautomaat buiten**, **Zaterdagbezorging**, **Persoonlijk overhandigd (ID-controle)**, **Aangetekend (overhandigd tegen handtekening)**, **Bezorging zonder handtekening**, **Bezorgtijd telefonisch afgesproken**, **Bellen vóór bezorging**, **Fossielvrij transport (toegewezen aandeel)** en, alleen bij **Return (Palautus)**, **Retour zonder label (verzendcode)**. Kies **Bulky (pakket met overmaat)** voor een pakket van meer dan 25 kg of groter dan het standaardformaat van het verzendproduct.
### Afhaalpunten voor Postipaketti
**Postal Parcel (Postipaketti)** bezorgt bij een afhaalpunt. Kies het afhaalpunt in de sectie **Afhaalpunt** van de zending voordat je verzendt. Het zoeken vereist de rol **2026-04** op je applicatieaccount. Zie [Een afhaalpunt kiezen](/docs/nl/how-to/pick-a-service-point) en [Afhaalpunten](/docs/nl/how-to/drop-point-and-service-points).
### Retouren
**Return (Palautus)** brengt een pakket van je klant naar jouw adres. Er is geen afhaalpunt nodig, en je contract met Posti moet klantretouren omvatten.
Met **Retour zonder label (verzendcode)** schrijft je klant een code op het pakket in plaats van een verzendlabel te printen. De zending toont de code als **Code voor verzenden zonder label** onder **Track & trace**. Stuur de code naar je klant. Maakt Posti de retour aan zonder code, dan toont de zending een waarschuwing. Stuur je klant dan het verzendlabel.
### Douane
Zendingen naar een land buiten de EU, en naar of vanuit Åland, de Canarische Eilanden, Ceuta of Melilla, krijgen douanegegevens uit de bestelregels mee: omschrijving, goederencode (HS-code), aantal, waarde en land van oorsprong. Posti stuurt de douaneaangifte en de handelsfactuur samen met het verzendlabel terug, en ze verschijnen bij de documenten van de zending.
Voeg je EORI-nummer toe onder [Organisatie-instellingen](/docs/nl/how-to/organization-settings). Heeft de ontvanger een EORI-nummer, vul het dan in bij **EORI-nummer van de ontvanger** bij de ontvanger. Zie [Douane en documenten](/docs/nl/how-to/customs-and-documents).
### Ophaalopdrachten en track & trace
* Posti is niet beschikbaar onder **Ophaalopdrachten**. Regel het ophalen rechtstreeks met Posti. Je kunt geen ophaalvenster instellen op een Posti-zending. Zie [Een ophaalopdracht plannen](/docs/nl/how-to/schedule-a-pickup) voor de vervoerders die dat wel zijn.
* Als **Gebruikersnaam voor de Tracking API** en **Wachtwoord voor de Tracking API** zijn ingevuld, haalt Zippendo ongeveer eens per uur track & trace-updates op bij Posti. Zonder deze gegevens verschijnen er geen track & trace-gebeurtenissen. Elke zending heeft wel een trackingnummer en een **Track & trace-link** naar posti.fi. Klopt de inlog voor track & trace niet, corrigeer die dan bij **Vervoerder bewerken** en klik op **Opslaan**. Zie [Trackingwebhooks van vervoerders](/docs/nl/how-to/tracking-webhooks).
## De koppeling wijzigen of verwijderen
Om te wijzigen, open je **Vervoerders** → **Mijn vervoerders** en klik je op de kaart op **Vervoerder bewerken**. De pagina **Vervoerder bewerken** heeft twee onderdelen:
* **Algemeen**: **Naam van de vervoerder**, en **Merk** als je organisatie merken heeft.
* **Vervoerderinstellingen**: **Client-ID**, **Clientgeheim**, **Nummer van het logistiekcontract**, **Gebruikersnaam voor de Tracking API** en **Wachtwoord voor de Tracking API**.
Klik op **Opslaan**. Je ziet "Vervoerder bijgewerkt".
Om te verwijderen, klik je op dezelfde pagina op **Verwijderen**, typ je de naam van de vervoerder in hoofdletters en klik je op **Verwijderen**. Verzendregels die deze vervoerder gebruiken, worden samen met hem verwijderd. Zendingen die je al hebt verzonden, houden hun verzendlabels en trackingnummers.
## Veelvoorkomende problemen
| Wat je ziet | Wat je moet doen |
| - | - |
| "Kan de vervoerder niet koppelen. Probeer het opnieuw." | Controleer de verplichte velden en probeer het opnieuw. |
| "Je hebt de limiet van je abonnement bereikt. Upgrade je abonnement of verwijder iets wat je niet meer gebruikt." | De vervoerderslimiet van je abonnement is bereikt. Zie [Facturatie en gebruik](/docs/nl/how-to/billing-and-usage). |
| "De vervoerder heeft je inloggegevens geweigerd. Werk de inloggegevens bij onder Vervoerders." wanneer je verzendt | De **Client-ID** of het **Clientgeheim** klopt niet, of het applicatieaccount heeft niet beide API-rollen. Los het op in het Developer Portal of bij **Vervoerder bewerken**. |
| "De instellingen van de vervoerder zijn onvolledig of ongeldig. Controleer ze onder Vervoerders." | **Nummer van het logistiekcontract** bevat iets anders dan cijfers. Corrigeer het bij **Vervoerder bewerken**. |
| "Posti kon de zending niet aanmaken." | Posti heeft de zending geweigerd, bijvoorbeeld omdat het logistiekcontractnummer niet aan het applicatieaccount is toegewezen. De zending toont de reden van Posti. Los het op en verzend opnieuw. |
| "Sommige opties voor dit verzendproduct ontbreken of zijn ongeldig. Controleer de extra diensten en opties van de zending en probeer het opnieuw." | Het telefoonnummer van de ontvanger ontbreekt, de zending heeft te veel pakketten voor het verzendproduct, een pakket is te zwaar of te groot, of Posti biedt een gekozen extra dienst daar niet aan. De zending toont wat er mis is. |
| "Dit verzendproduct bezorgt bij een afhaalpunt. Kies een afhaalpunt voordat je verzendt." | Kies bij de zending een afhaalpunt voor **Postal Parcel (Postipaketti)**. |
| "Het gekozen verzendproduct verzendt niet tussen deze landen. Kies een ander verzendproduct." | Kies een Posti-product dat het land van de ontvanger dekt. |
| "De douaneaangifte is onvolledig. Elk artikel heeft een omschrijving, een aantal en een aangegeven waarde groter dan nul nodig." | Bij een bestelregel ontbreekt een omschrijving, goederencode, aantal of waarde. Vul het aan en verzend opnieuw. |
| "De vervoerder heeft de zending geaccepteerd, maar geen verzendlabel of QR-code teruggestuurd, en Zippendo kan die niet opnieuw opvragen. Vraag de vervoerder erom en verzend de zending niet opnieuw." | Neem contact op met Posti voor het verzendlabel. Verzend de zending niet opnieuw. |
| "De verbinding met de vervoerder werd verbroken voordat er antwoord kwam. Zippendo heeft geen bevestiging dat de zending is aangemaakt. Controleer dit bij de vervoerder voordat je opnieuw verzendt." | Controleer bij Posti of de zending bestaat voordat je hem opnieuw verzendt. |
| Er verschijnen geen track & trace-gebeurtenissen | Controleer of beide velden voor track & trace zijn ingevuld en kloppen. |
| "We kunnen de vervoerders nu niet bereiken. Probeer het zo opnieuw." of "De vervoerder heeft dit geweigerd. Bekijk de reden van de vervoerder, corrigeer de gegevens en probeer het opnieuw." | Wacht even en verzend opnieuw, of los op wat de reden van Posti noemt. |
Meer hulp: [Authenticatiefouten bij vervoerders](/docs/nl/knowledge-base/carrier-authentication-failures).
## Gerelateerd
* [Een vervoerder of integratie koppelen](/docs/nl/how-to/connect-index)
* [Inloggegevens van de vervoerder](/docs/nl/how-to/carrier-credentials)
* [Testmodus](/docs/nl/how-to/sandbox-mode)
* [Verzendproducten en extra diensten](/docs/nl/how-to/carrier-products-and-services)
* [Een afhaalpunt kiezen](/docs/nl/how-to/pick-a-service-point)
* [Douane en documenten](/docs/nl/how-to/customs-and-documents)
* [Een vervoerdersintegratie aanvragen](/docs/nl/how-to/request-carrier-integration)
* [Vervoerders](/docs/nl/tutorials/carriers)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.