> ## 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 verbinden

> Verbinde PostNL unter Versanddienstleister mit deinem API-Schlüssel, Kundencode und deiner Kundennummer, plus optional Einlieferungsort und Testmodus.

**PostNL** versendet Pakete in den Niederlanden und in Belgien: an die Haustür, an PostNL-Standorte und Paketautomaten, mit Zustellfenstern und Retouren. Außerdem versendet es mit Zollinhaltserklärungen in die EU und weltweit. Die Felder, die jeder Versanddienstleister hat, stehen unter [Zugangsdaten für Versanddienstleister](/docs/de/how-to/carrier-credentials).

<Info>
  In diesem Formular wählst du keine Absenderadresse. Füge deine Adressen über das Organisationsmenü → **Verwalten** → **Adressen** hinzu. Die Absenderadresse wählst du bei jeder Sendung oder in einer [Versandregel](/docs/de/how-to/shipping-rule-fields).
</Info>

Jede PostNL-Sendung wird mit deinem eigenen PostNL-API-Schlüssel und deinen eigenen Vertragsdaten versendet.

## Bevor du beginnst

* Ein PostNL-Geschäftskundenvertrag (PostNL Pakketten), bei dem die Produkte, die du nutzen möchtest, freigeschaltet sind.
* Ein PostNL-**API-Schlüssel** aus [Mijn PostNL](https://mijn.postnl.nl/). PostNL gibt dir einen Schlüssel für sein Testsystem und einen weiteren für echte Sendungen. Ein Testschlüssel funktioniert nur bei eingeschaltetem **Testmodus**.
* Dein PostNL-**Kundencode** (1 bis 6 Zeichen, zum Beispiel `DEVC`) und deine **Kundennummer** (bis zu 8 Ziffern). Beides findest du in deinem PostNL-Vertrag und in Mijn PostNL.
* Optional: der 6-stellige Code für den **Einlieferungsort**, falls PostNL dir einen gegeben hat.

Du kannst PostNL mehr als einmal verbinden, zum Beispiel eine Verbindung pro Vertrag. Gib jeder einen eigenen **Name des Versanddienstleisters**. **Mehr erfahren** auf der Karte öffnet die Seite von PostNL für Geschäftskunden.

## PostNL verbinden

<Steps>
  <Step title="Alle Versanddienstleister öffnen">
    Klicke in der Seitenleiste auf **Versanddienstleister** und öffne dann den Tab **Alle Versanddienstleister**.
  </Step>

  <Step title="PostNL finden">
    Klicke auf der Karte **PostNL** auf **Verbinden**.
  </Step>

  <Step title="Das Formular ausfüllen">
    Das Fenster **Versanddienstleister verbinden** öffnet sich. Gib einen **Name des Versanddienstleisters**, deinen **API-Schlüssel**, **Kundencode** und **Kundennummer** ein. **Einlieferungsort** und **Testmodus** stehen unter **Optionale Felder**.
  </Step>

  <Step title="Den Versanddienstleister verbinden">
    Klicke auf **Verbinden**. Du siehst „Versanddienstleister verbunden“, und der Versanddienstleister erscheint im Tab **Meine Versanddienstleister**.
  </Step>
</Steps>

## Felder im Formular

| Feld | Erforderlich | Was du eingibst |
| - | - | - |
| **Name des Versanddienstleisters** | Ja | Der Name, den du unter **Meine Versanddienstleister** siehst und wenn du bei einer Sendung einen Versanddienstleister wählst. Er lautet zunächst **PostNL**. |
| **Marke** | Nein | Wird nur angezeigt, wenn deine Organisation [Marken](/docs/de/how-to/create-a-brand) hat. Das Formular sagt: „Nur diese Marke kann diesen Versanddienstleister nutzen.“ Lass es leer, damit jede Marke ihn nutzen kann. |
| **API-Schlüssel** | Ja | Dein Schlüssel aus Mijn PostNL. Das Formular sagt: „Dein PostNL-API-Schlüssel aus Mijn PostNL (Sandbox-Schlüssel funktionieren nur im Testmodus).“ |
| **Kundencode** | Ja | Das Formular sagt: „Kundencode bei PostNL Pakketten (1–6 Zeichen, z. B. DEVC).“ |
| **Kundennummer** | Ja | Das Formular sagt: „Kundennummer bei PostNL Pakketten (bis zu 8 Ziffern).“ |
| **Einlieferungsort** | Nein | Genau 6 Ziffern. Das Formular sagt: „6-stelliger Code des PostNL-Einlieferungsorts aus deinem Vertrag, falls vorhanden.“ |
| **Testmodus** | Nein | Ein Kontrollkästchen, standardmäßig aus. Das Formular sagt: „Nutzt das Testsystem von PostNL mit einem Test-API-Schlüssel. Für echte Sendungen ausgeschaltet lassen.“ |

**Verbinden** tut nichts, bis **Name des Versanddienstleisters**, **API-Schlüssel**, **Kundencode** und **Kundennummer** einen Wert haben. Ist der **Kundencode** länger als 6 Zeichen, die **Kundennummer** länger als 8 oder der **Einlieferungsort** nicht genau 6 Zeichen lang, siehst du „Der Versanddienstleister konnte nicht verbunden werden. Versuch es noch einmal.“

Der **Testmodus** sendet deine Sendungen an das Testsystem von PostNL, sodass keine echten Sendungen entstehen. Nutze deinen Test-API-Schlüssel, solange er eingeschaltet ist, und deinen Live-Schlüssel, wenn er ausgeschaltet ist. Siehe [Testmodus](/docs/de/how-to/sandbox-mode).

## Nach dem Verbinden

Der Versanddienstleister erscheint unter **Meine Versanddienstleister** mit dem Badge **Verbunden**. Das Versandprodukt wählst du bei jeder Sendung oder in einer Versandregel, nicht in diesem Formular. Siehe [Versandprodukte und Zusatzleistungen](/docs/de/how-to/carrier-products-and-services).

Die Beschreibung jedes Versandprodukts zeigt seinen PostNL-Produktcode, damit du es mit deinem Vertrag abgleichen kannst. Du kannst nur mit Versandprodukten versenden, die PostNL für dich freigeschaltet hat. Andere Versandprodukte werden beim Versenden abgelehnt, mit „PostNL konnte die Sendung nicht erstellen.“

Produktgruppen:

* Innerhalb der Niederlande (Absender in den Niederlanden): **Standardsendung**, Zustellung nur an die angegebene Adresse, Unterschrift bei Zustellung, Zusatzversicherung, Altersprüfung, Briefkastenpakete und Versandprodukte für den **Paketshop**.
* Niederlande nach Belgien, innerhalb Belgiens und Belgien in die Niederlande, jeweils mit eigenen Versandprodukten.
* **Parcel EU** für Verbraucher (2C) und Unternehmen (2B), in den Versionen Track & Trace, Insured und Insured Plus.
* **Parcel Non EU** und internationale Postprodukte (wie **Packet Track & Trace**) für den Rest der Welt. Sie tragen eine Zollinhaltserklärung, die aus den Bestellpositionen erstellt wird.
* **Retouren**: Rücksendung an eine Antwortnummer eines Unternehmens oder an eine Privatadresse, Retouren innerhalb von und nach Belgien sowie **Easy Return Service** aus dem Ausland.

### Zustellfenster und weitere Auswahlmöglichkeiten

Versandprodukte innerhalb der Niederlande bieten diese Zusatzleistungen: **Abendzustellung (17:30–22:00 Uhr)**, **Zustellung am selben Tag (Übergabe vor 11:00 Uhr)** und **Garantierte Zustellung vor 10:00 Uhr**, **12:00 Uhr** oder **17:00 Uhr**. Wenn du eine einschaltest, fülle zusätzlich **Zustelldatum** unter **Weitere Angaben für den Versanddienstleister** aus.

Manche Versandprodukte brauchen weitere Angaben bei der Sendung:

* Versandprodukte mit Zusatzversicherung brauchen **Versicherter Betrag (EUR)**, bis zu 5000.
* Versandprodukte mit Altersprüfung brauchen **Geburtsdatum des Empfängers**.
* Briefkastenpakete brauchen **Zustelldatum**.
* Mit **Etikettenformat** wählst du **PDF** (Standard) oder **ZPL (Thermodruck)** für einen Zebra-Etikettendrucker.

### PostNL-Standorte (Paketshops)

Versandprodukte, deren Namen mit **Paketshop** beginnen, liefern an einen PostNL-Standort, etwa ein Geschäft oder einen Paketautomaten. Standorte gibt es für Adressen in den Niederlanden und in Belgien. Wähle den Standort vor dem Versenden bei der Sendung. Siehe [Einen Paketshop wählen](/docs/de/how-to/pick-a-service-point) und [Paketshops](/docs/de/how-to/drop-point-and-service-points).

### Mehrere Pakete in einer Sendung

Du kannst bis zu vier Pakete in einer Sendung versenden. Briefkastenpakete sind immer ein Paket pro Sendung. Innerhalb der Niederlande behandelt PostNL die Pakete als eine Sendung mit einem Versandetikett pro Paket. Auf anderen Strecken wird jedes Paket zu einer eigenen PostNL-Sendung.

### Abholungen, Sendungsverfolgung und Zoll

* PostNL ist unter **Abholungen** nicht verfügbar. Abholungen werden über deinen PostNL-Vertrag organisiert.
* Zippendo ruft die Sendungsverfolgung von PostNL jede Stunde ab. Du musst nichts einrichten. Siehe [Webhooks zur Sendungsverfolgung der Versanddienstleister](/docs/de/how-to/tracking-webhooks).
* Bei Sendungen außerhalb der EU liefert PostNL die Zollinhaltserklärungen (CN23/CP71) und die Handelsrechnung mit dem Versandetikett mit, sodass Zippendo keine eigenen hinzufügt. Siehe [Zoll und Dokumente](/docs/de/how-to/customs-and-documents).

## Die Verbindung ändern oder entfernen

Zum Ändern öffne **Versanddienstleister** → **Meine Versanddienstleister** und klicke auf der Karte auf **Versanddienstleister bearbeiten**. Die Seite **Versanddienstleister bearbeiten** hat zwei Bereiche:

* **Allgemein**: **Name des Versanddienstleisters** und **Marke**, wenn deine Organisation Marken hat.
* **Einstellungen des Versanddienstleisters**: **API-Schlüssel**, **Kundencode**, **Kundennummer**, **Einlieferungsort** und **Testmodus**.

Klicke auf **Speichern**. Du siehst „Versanddienstleister aktualisiert“.

Zum Entfernen klicke auf derselben Seite auf **Löschen**, gib den Namen des Versanddienstleisters in Großbuchstaben ein und klicke auf **Löschen**. Versandregeln, die diesen Versanddienstleister nutzen, werden mit ihm gelöscht. Sendungen, die du bereits versendet hast, behalten ihre Versandetiketten und Sendungsnummern.

## Häufige Probleme

| Was du siehst | Was du tun kannst |
| - | - |
| „Der Versanddienstleister konnte nicht verbunden werden. Versuch es noch einmal.“ | Prüfe die Pflichtfelder und die oben beschriebenen Längen und versuche es dann noch einmal. |
| „Du hast das Limit deines Tarifs erreicht. Upgrade deinen Tarif oder entferne etwas, das du nicht mehr brauchst.“ | Das Limit für Versanddienstleister in deinem Tarif ist erreicht. Siehe [Abrechnung und Nutzung](/docs/de/how-to/billing-and-usage). |
| „Der Versanddienstleister hat deine Anmeldedaten abgelehnt. Aktualisiere die Zugangsdaten unter ‚Versanddienstleister‘.“ beim Versenden | Der API-Schlüssel ist falsch oder passt nicht zum **Testmodus** (ein Testschlüssel bei ausgeschaltetem **Testmodus** oder umgekehrt). Korrigiere ihn unter **Versanddienstleister bearbeiten**. |
| „PostNL konnte die Sendung nicht erstellen.“ oder ein eigener Fehlertext von PostNL | PostNL hat die Sendung abgelehnt, zum Beispiel weil das Versandprodukt nicht in deinem Vertrag ist oder die Adresse falsch ist. Behebe, was die Meldung nennt, und versende erneut. |
| „Einige Optionen für dieses Versandprodukt fehlen oder sind ungültig. Prüfe die Zusatzleistungen und Optionen der Sendung und versuch es dann noch einmal.“ | Eine erforderliche Angabe fehlt, etwa **Versicherter Betrag (EUR)**, **Zustelldatum** oder **Geburtsdatum des Empfängers**. Trage sie unter **Weitere Angaben für den Versanddienstleister** ein. |
| „Dieses Versandprodukt liefert an einen Paketshop. Wähle vor dem Versenden einen Paketshop aus.“ | Wähle bei der Sendung einen PostNL-Standort. |
| „Das gewählte Versandprodukt versendet nicht zwischen diesen Ländern. Wähle ein anderes Versandprodukt.“ | Wähle ein Versandprodukt für diese Strecke, zum Beispiel ein **Parcel EU**-Produkt für ein anderes EU-Land. |

## Verwandte Themen

* [Versanddienstleister oder Integration verbinden](/docs/de/how-to/connect-index)
* [Zugangsdaten für Versanddienstleister](/docs/de/how-to/carrier-credentials)
* [Testmodus](/docs/de/how-to/sandbox-mode)
* [Versandprodukte und Zusatzleistungen](/docs/de/how-to/carrier-products-and-services)
* [Einen Paketshop wählen](/docs/de/how-to/pick-a-service-point)
* [Anbindung eines Versanddienstleisters anfragen](/docs/de/how-to/request-carrier-integration)
* [Versanddienstleister](/docs/de/tutorials/carriers)


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