> ## 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. # PostNL koppelen > Koppel PostNL onder Vervoerders met je API-sleutel, Klantcode en Klantnummer, plus de optionele Aanleverlocatie en Testmodus. **PostNL** verzendt pakketten in Nederland en België: aan de deur, naar PostNL-locaties en pakketautomaten, met bezorgvensters en retouren. Ook verzendt PostNL binnen de EU en wereldwijd met douaneaangiftes. De velden die elke vervoerder heeft, staan onder [Inloggegevens van vervoerders](/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). Elke PostNL-zending wordt verzonden met je eigen PostNL-API-sleutel en contractgegevens. ## Voordat je begint * Een zakelijk PostNL-contract (PostNL Pakketten) met de producten die je wilt gebruiken ingeschakeld. * Een PostNL-**API-sleutel** uit [Mijn PostNL](https://mijn.postnl.nl/). PostNL geeft je één sleutel voor het testsysteem en een andere voor echte zendingen. Een testsleutel werkt alleen als **Testmodus** aanstaat. * Je PostNL-**Klantcode** (1 tot 6 tekens, bijvoorbeeld `DEVC`) en **Klantnummer** (maximaal 8 cijfers). Je vindt beide op je PostNL-contract en in Mijn PostNL. * Optioneel: de code van 6 cijfers van de **Aanleverlocatie**, als PostNL je die heeft gegeven. Je kunt PostNL meer dan eens koppelen, bijvoorbeeld één koppeling per contract. Geef elke koppeling een eigen **Naam van de vervoerder**. **Meer informatie** op de kaart opent de pagina van PostNL voor zakelijke klanten. ## PostNL koppelen Klik in de zijbalk op **Vervoerders** en open dan het tabblad **Alle vervoerders**. Klik op de kaart **PostNL** op **Koppelen**. Het venster **Vervoerder koppelen** gaat open. Vul een **Naam van de vervoerder**, je **API-sleutel**, **Klantcode** en **Klantnummer** in. **Aanleverlocatie** en **Testmodus** staan onder **Optionele velden**. Klik op **Koppelen**. Je ziet “Vervoerder gekoppeld” en de vervoerder verschijnt op het tabblad **Mijn vervoerders**. ## Velden op het formulier | 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 **PostNL**. | | **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 de vervoerder kan gebruiken. | | **API-sleutel** | Ja | Je sleutel uit Mijn PostNL. Het formulier zegt: “Je API-sleutel van PostNL uit Mijn PostNL (testsleutels werken alleen in testmodus).” | | **Klantcode** | Ja | Het formulier zegt: “Klantcode zoals bekend bij PostNL Pakketten (1–6 tekens, bijv. DEVC).” | | **Klantnummer** | Ja | Het formulier zegt: “Klantnummer zoals bekend bij PostNL Pakketten (maximaal 8 cijfers).” | | **Aanleverlocatie** | Nee | Precies 6 cijfers. Het formulier zegt: “Code van 6 cijfers van de PostNL-aanleverlocatie op je contract, als je die hebt.” | | **Testmodus** | Nee | Een selectievakje, standaard uit. Het formulier zegt: “Gebruik het testsysteem van PostNL met een test-API-sleutel. Laat uit voor echte zendingen.” | **Koppelen** doet niets zolang **Naam van de vervoerder**, **API-sleutel**, **Klantcode** en **Klantnummer** geen waarde hebben. Is **Klantcode** langer dan 6 tekens, **Klantnummer** langer dan 8 of **Aanleverlocatie** niet precies 6 tekens, dan zie je “Kan de vervoerder niet koppelen. Probeer het opnieuw.” Met **Testmodus** gaan je zendingen naar het testsysteem van PostNL, zodat er geen echte zendingen worden aangemaakt. Gebruik je test-API-sleutel als de modus aanstaat en je live sleutel als de modus uitstaat. Zie [Testmodus](/docs/nl/how-to/sandbox-mode). ## Na het koppelen De vervoerder verschijnt onder **Mijn vervoerders** met een 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). De beschrijving van elk product toont de PostNL-productcode, zodat je het kunt vergelijken met je contract. Je kunt alleen verzenden met producten die PostNL voor je heeft ingeschakeld. Andere producten worden bij het verzenden geweigerd, met “PostNL kon de zending niet aanmaken.” Productgroepen: * Binnen Nederland (afzender in Nederland): **Standaardzending**, alleen bezorging op het opgegeven adres, handtekening voor ontvangst, Extra Cover, Age Check, brievenbuspakjes en **Afhalen**-producten. * Nederland naar België, binnen België en België naar Nederland, elk met eigen producten. * **Parcel EU**, voor consumenten (2C) en bedrijven (2B), in de varianten Track & Trace, Insured en Insured Plus. * **Parcel Non EU** en internationale postproducten (zoals **Packet Track & Trace**) voor de rest van de wereld. Deze krijgen een douaneaangifte die is opgebouwd uit de bestelregels. * **Retouren**: retour naar een antwoordnummer of naar een huisadres, retouren binnen en naar België, en **Easy Return Service** vanuit het buitenland. ### Bezorgvensters en extra keuzes Producten binnen Nederland bieden deze extra diensten: **Avondbezorging (17:30–22:00)**, **Bezorging vandaag (aanbieden vóór 11:00)** en **Gegarandeerde bezorging vóór 10:00**, **12:00** of **17:00**. Zet je er een aan, vul dan ook **Bezorgdatum** in onder **Extra gegevens voor de vervoerder**. Sommige producten hebben meer gegevens bij de zending nodig: * Extra Cover-producten hebben een **Verzekerd bedrag (EUR)** nodig, tot 5000. * Age Check-producten hebben de **Geboortedatum ontvanger** nodig. * Brievenbuspakjes hebben een **Bezorgdatum** nodig. * Met **Labelformaat** kies je **PDF** (de standaard) of **ZPL (thermisch)** voor een Zebra-labelprinter. ### PostNL-locaties (afhaalpunten) Producten waarvan de naam begint met **Afhalen** bezorgen bij een PostNL-locatie, zoals een winkel of een pakketautomaat. Locaties zijn beschikbaar voor adressen in Nederland en België. Kies de locatie bij de zending voordat je verzendt. Zie [Een afhaalpunt kiezen](/docs/nl/how-to/pick-a-service-point) en [Afhaalpunten](/docs/nl/how-to/drop-point-and-service-points). ### Meerdere pakketten in één zending Je kunt tot vier pakketten in één zending verzenden. Brievenbuspakjes zijn altijd één pakket per zending. Binnen Nederland behandelt PostNL de pakketten als één zending met een verzendlabel voor elk pakket. Op andere routes wordt elk pakket een eigen PostNL-zending. ### Ophaalopdrachten, track & trace en douane * PostNL is niet beschikbaar onder **Ophaalopdrachten**. Ophaalopdrachten regel je via je PostNL-contract. * Zippendo haalt elk uur track-&-traceupdates op bij PostNL. Je hoeft niets in te stellen. Zie [Tracking-webhooks van vervoerders](/docs/nl/how-to/tracking-webhooks). * Voor zendingen buiten de EU levert PostNL de douaneaangiftes (CN23/CP71) en de handelsfactuur mee met het verzendlabel, dus Zippendo voegt er zelf geen toe. Zie [Douane en documenten](/docs/nl/how-to/customs-and-documents). ## 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 secties: * **Algemeen**: **Naam van de vervoerder** en **Merk**, als je organisatie merken heeft. * **Vervoerderinstellingen**: **API-sleutel**, **Klantcode**, **Klantnummer**, **Aanleverlocatie** en **Testmodus**. 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 mee verwijderd. Zendingen die je al hebt verzonden, houden hun verzendlabels en trackingnummers. ## Veelvoorkomende problemen | Wat je ziet | Wat je doet | | - | - | | “Kan de vervoerder niet koppelen. Probeer het opnieuw.” | Controleer de verplichte velden en de hierboven beschreven lengtes en probeer het opnieuw. | | “Je hebt de limiet van je abonnement bereikt. Upgrade je abonnement of verwijder iets wat je niet meer gebruikt.” | De vervoerderlimiet 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.” bij het verzenden | De API-sleutel is onjuist of past niet bij **Testmodus** (een testsleutel terwijl **Testmodus** uitstaat, of andersom). Corrigeer dit bij **Vervoerder bewerken**. | | “PostNL kon de zending niet aanmaken.” of de eigen foutmelding van PostNL | PostNL heeft de zending geweigerd, bijvoorbeeld omdat het product niet in je contract zit of het adres onjuist is. Los op wat de melding noemt 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.” | Er ontbreekt een verplicht gegeven, zoals **Verzekerd bedrag (EUR)**, **Bezorgdatum** of **Geboortedatum ontvanger**. Vul het in onder **Extra gegevens voor de vervoerder**. | | “Dit verzendproduct bezorgt bij een afhaalpunt. Kies een afhaalpunt voordat je verzendt.” | Kies een PostNL-locatie bij de zending. | | “Het gekozen verzendproduct verzendt niet tussen deze landen. Kies een ander verzendproduct.” | Kies een product voor deze route, bijvoorbeeld een **Parcel EU**-product voor een ander EU-land. | ## Gerelateerd * [Een vervoerder of integratie koppelen](/docs/nl/how-to/connect-index) * [Inloggegevens van vervoerders](/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) * [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.