> ## 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 verbinden
> Verbinde Posti in Zippendo mit Client-ID, Client-Secret und Logistikvertragsnummer, dazu optional Benutzername für die Tracking API und Passwort für die Tracking API.
**Posti** versendet Pakete aus Finnland: an Paketautomaten und Paketshops von Posti, per Hauszustellung, als Express am nächsten Tag, als Kleinpakete an die Haustür, als Kundenretouren sowie als Priority- und EMS-Pakete weltweit. Die Felder, die alle Versanddienstleister gemeinsam haben, stehen unter [Zugangsdaten der Versanddienstleister](/docs/de/how-to/carrier-credentials).
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). Posti versendet von einer Adresse in Finnland oder auf Åland, und Retouren kommen an eine Adresse in Finnland zurück.
## Bevor du startest
* Ein Geschäftskundenkonto bei Posti mit einer **Logistikvertragsnummer**, meist sechs Ziffern.
* Einen Benutzer in [OmaPosti Pro](https://pro.posti.fi/) mit der Rolle **API Manager**, um dich im [Developer Portal von Posti](https://developer.posti.com/) anzumelden. Wenn du die Rolle nicht hast, bitte den Hauptbenutzer deiner Organisation in OmaPosti Pro, **Users management → Users** zu öffnen, bei deinem Benutzer auf **Edit** zu klicken und unter **Other services** **API Manager** anzukreuzen.
* Ein Anwendungskonto im Developer Portal für **Client-ID** und **Client-Secret**. Die Schritte stehen unten.
* Optional für die Sendungsverfolgung: ein Dienstkonto für die **Tracking API** vom Kundenservice von Posti. Du kannst auch ohne es Sendungen versenden.
Du kannst Posti mehrmals verbinden, zum Beispiel eine Verbindung pro Logistikvertrag. Gib jeder einen eigenen **Name des Versanddienstleisters**. **Mehr erfahren** auf der Karte öffnet die Seite von Posti zu seinen Diensten für den Onlinehandel.
## Zugangsdaten von Posti besorgen
Öffne [developer.posti.com](https://developer.posti.com/) und melde dich mit deinem Benutzer für OmaPosti Pro an.
Öffne **Configure application accounts → Application account list** und klicke auf **Add new application account user**. Schalte **Enabled** ein und gib ihm einen Namen, zum Beispiel `Zippendo`.
Wähle **shippingapi** und **2026-04** aus. Ohne **2026-04** kannst du Sendungen versenden, aber die Paketshopsuche und etikettenlose Retouren funktionieren nicht.
Füge die Logistikvertragsnummer hinzu, die du in Zippendo eingeben wirst, und klicke dann auf **Save**.
Das Portal zeigt sie nur einmal an. Kopiere beide. Wenn du das Secret verlierst, erstelle im Portal neue Zugangsdaten und aktualisiere den Versanddienstleister in Zippendo.
Für die Sendungsverfolgung bitte den Kundenservice von Posti um ein Dienstkonto für die **Tracking API** für deinen Vertrag. Posti schickt dir einen Benutzernamen und ein Passwort.
## Posti verbinden
Klicke in der Seitenleiste auf **Versanddienstleister** und öffne dann den Tab **Alle Versanddienstleister**.
Klicke auf der Karte **Posti** auf **Verbinden**.
Das Fenster **Versanddienstleister verbinden** öffnet sich. **Name des Versanddienstleisters** ist bereits mit „Posti“ ausgefüllt. Gib deine **Client-ID**, dein **Client-Secret** und deine **Logistikvertragsnummer** ein. **Benutzername für die Tracking API** und **Passwort für die Tracking API** findest du unter **Optionale Felder**.
Klicke auf **Verbinden**. Du siehst „Versanddienstleister verbunden“, und der Versanddienstleister erscheint im Tab **Meine Versanddienstleister**.
## Felder im Formular
**Client-Secret** und **Passwort für die Tracking API** verbergen, was du eingibst.
| 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 **Posti**. |
| **Marke** | Nein | Wird nur angezeigt, wenn deine Organisation [Marken](/docs/de/how-to/create-a-brand) hat. Im Formular steht: „Nur diese Marke kann diesen Versanddienstleister nutzen.“ Lass das Feld leer, damit jede Marke ihn nutzen kann. |
| **Client-ID** | Ja | Im Formular steht: „Aus dem Developer Portal von Posti (developer.posti.com): die Client ID des Anwendungskonto-Benutzers, den du für Zippendo anlegst. Wähle beide API-Rollen aus, shippingapi und 2026-04.“ |
| **Client-Secret** | Ja | Im Formular steht: „Das Client Secret, das das Developer Portal einmalig zusammen mit der Client ID anzeigt.“ |
| **Logistikvertragsnummer** | Ja | Nur Ziffern. Im Formular steht: „Deine Logistikvertragsnummer bei Posti, meist sechs Ziffern, beginnend mit 6. Füge sie im Developer Portal demselben Anwendungskonto-Benutzer hinzu, sonst lehnt Posti deine Sendungen ab.“ |
| **Benutzername für die Tracking API** | Nein | Fülle beide Felder für die Sendungsverfolgung aus oder keines. Im Formular steht: „Der Benutzername für die Tracking API, den dir der Kundenservice von Posti für deinen Vertrag gibt. Nur für die Sendungsverfolgung nötig.“ |
| **Passwort für die Tracking API** | Nein | Im Formular steht: „Das Passwort, das Posti mit dem Benutzernamen für die Tracking API schickt. Posti sperrt das Konto nach fünf fehlgeschlagenen Anmeldeversuchen für eine Stunde.“ |
**Verbinden** tut nichts, solange **Name des Versanddienstleisters**, **Client-ID**, **Client-Secret** und **Logistikvertragsnummer** leer sind.
## Die Verbindung testen
Posti hat kein Testsystem, daher gibt es kein Kontrollkästchen **Testmodus**. Jede Sendung, die du versendest, ist eine echte Sendung bei Posti auf deinem Logistikvertrag. Laut Posti wird eine Sendung nur berechnet, wenn sie tatsächlich versendet wird. Ein Test-Versandetikett, das du nie übergibst, kostet also nichts.
Um die Verbindung auszuprobieren, versende eine Sendung an deine eigene Adresse und prüfe ihr Versandetikett. Posti benachrichtigt den Empfänger, gib bei einer Testsendung also deine eigene E-Mail-Adresse und Telefonnummer an. Zippendo kann eine Sendung bei Posti nicht stornieren, wende dich also an Posti, wenn eine storniert werden soll. 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). Ein Versandprodukt, das nicht in deinem Vertrag mit Posti steht, wird beim Versenden mit der Begründung von Posti abgelehnt.
| Versandprodukt | Liefert an | Höchstgewicht |
| - | - | - |
| **Postal Parcel (Postipaketti)** | Einen Paketautomaten oder Paketshop von Posti in Finnland, auf Åland, in Estland, Lettland oder Litauen. | 25 kg |
| **Home Parcel (Kotipaketti)** | Die Haustür des Empfängers, zu einer Zeit, die Posti mit ihm vereinbart. Finnland, Åland und das Baltikum. | 25 kg, 35 kg als Sperrgut |
| **Express Parcel (Express-paketti)** | Zustellung am nächsten Tag gegen Unterschrift. Finnland, Åland und das Baltikum. | 25 kg, 35 kg als Sperrgut |
| **Small Parcel to Door (Pikkupaketti ovelle)** | Den Briefkasten oder die Haustür des Empfängers in Finnland und auf Åland, bis 38 x 38 x 28 cm. | 4 kg |
| **Return (Palautus)** (Retourensendung) | Dein Kunde gibt ein Paket in einem beliebigen Paketshop oder Paketautomaten von Posti ab, an deine Adresse in Finnland. | 25 kg, 35 kg als Sperrgut |
| **Priority Parcel** | Über 200 Länder, je nach Land an die Haustür oder einen Paketshop. | 25 kg, 30 kg als Sperrgut |
| **EMS** | Über 200 Länder, an die Haustür gegen Unterschrift. | 25 kg, 30 kg als Sperrgut |
Jedes Versandprodukt außer **Return (Palautus)** braucht die Telefonnummer des Empfängers für die Benachrichtigungen von Posti. **Home Parcel (Kotipaketti)** und **Express Parcel (Express-paketti)** können mehrere Pakete in einer Sendung befördern. Die anderen Versandprodukte nehmen ein Paket pro Sendung.
### Zusatzleistungen und weitere Angaben
Jedes Versandprodukt hat zwei Optionen unter **Weitere Angaben für den Versanddienstleister**:
* **Etikettenformat**: PDF (Standard) oder ZPL für Thermodrucker.
* **Zustellhinweise**: bis zu 120 Zeichen, die auf das Versandetikett gedruckt werden, zum Beispiel ein Türcode.
Versandetiketten sind 10 x 15 cm groß. Internationale Versandprodukte, für die es kein Versandetikett in dieser Größe gibt, werden auf eine A5-Seite gedruckt.
Zusatzleistungen wählst du bei der Sendung oder in einer Versandregel. Jedes Versandprodukt listet die Zusatzleistungen, die Posti dafür anbietet: **Ankunftsbenachrichtigung per SMS oder E-Mail**, **Vorabbenachrichtigung vor der Zustellung**, **Zerbrechlich**, **Sperrgut (übergroßes Paket)**, **Kein Paketautomat im Freien**, **Samstagszustellung**, **Persönliche Übergabe (Ausweisprüfung)**, **Einschreiben (Übergabe gegen Unterschrift)**, **Zustellung ohne Unterschrift**, **Telefonisch vereinbarte Zustellzeit**, **Anruf vor der Zustellung**, **Fossilfreier Transport (zugewiesener Anteil)** und nur bei **Return (Palautus)** **Etikettenlose Retoure (Versandcode)**. Wähle **Sperrgut (übergroßes Paket)** für ein Paket über 25 kg oder eines, das größer als die Standardgröße des Versandprodukts ist.
### Postipaketti-Paketshops
**Postal Parcel (Postipaketti)** liefert an einen Paketshop. Wähle den Paketshop vor dem Versenden im Bereich **Paketshop** der Sendung. Die Suche braucht die Rolle **2026-04** in deinem Anwendungskonto. Siehe [Paketshop auswählen](/docs/de/how-to/pick-a-service-point) und [Paketshops](/docs/de/how-to/drop-point-and-service-points).
### Retouren
**Return (Palautus)** bringt ein Paket von deinem Kunden an deine Adresse. Dafür ist kein Paketshop nötig, und dein Vertrag mit Posti muss Kundenretouren umfassen.
Mit **Etikettenlose Retoure (Versandcode)** schreibt dein Kunde einen Code auf das Paket, statt ein Versandetikett zu drucken. Die Sendung zeigt den Code als **Code statt Versandetikett** unter **Sendungsverfolgung**. Schick ihn an deinen Kunden. Wenn Posti die Retoure ohne Code erstellt, zeigt die Sendung eine Warnung. Schick deinem Kunden dann stattdessen das Versandetikett.
### Zoll
Sendungen in ein Land außerhalb der EU sowie nach oder von Åland, den Kanarischen Inseln, Ceuta oder Melilla enthalten Zolldaten aus den Bestellpositionen: Beschreibung, Zolltarifnummer (HS-Code), Menge, Wert und Ursprungsland. Posti gibt die Zollinhaltserklärung und die Handelsrechnung mit dem Versandetikett zurück, und sie erscheinen bei den Dokumenten der Sendung.
Füge deine EORI-Nummer unter [Organisationseinstellungen](/docs/de/how-to/organization-settings) hinzu. Wenn der Empfänger eine EORI-Nummer hat, gib sie beim Empfänger unter **EORI-Nummer des Empfängers** ein. Siehe [Zoll und Dokumente](/docs/de/how-to/customs-and-documents).
### Abholungen und Sendungsverfolgung
* Posti ist unter **Abholungen** nicht verfügbar. Vereinbare Abholungen direkt mit Posti. Bei einer Sendung mit Posti kannst du kein Abholzeitfenster festlegen. Unter [Eine Abholung planen](/docs/de/how-to/schedule-a-pickup) findest du die Versanddienstleister, bei denen das geht.
* Wenn **Benutzername für die Tracking API** und **Passwort für die Tracking API** ausgefüllt sind, holt Zippendo die Updates zur Sendungsverfolgung etwa einmal pro Stunde bei Posti ab. Ohne sie erscheinen keine Ereignisse der Sendungsverfolgung. Jede Sendung hat trotzdem ihre Sendungsnummer und einen **Link zur Sendungsverfolgung** zu posti.fi. Wenn die Anmeldung für die Sendungsverfolgung falsch ist, korrigiere sie unter **Versanddienstleister bearbeiten** und klicke auf **Speichern**. Siehe [Webhooks zur Sendungsverfolgung der Versanddienstleister](/docs/de/how-to/tracking-webhooks).
## Verbindung ändern oder entfernen
Um sie zu ä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**: **Client-ID**, **Client-Secret**, **Logistikvertragsnummer**, **Benutzername für die Tracking API** und **Passwort für die Tracking API**.
Klicke auf **Speichern**. Du siehst „Versanddienstleister aktualisiert“.
Um sie zu 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 versuch 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 | **Client-ID** oder **Client-Secret** ist falsch, oder das Anwendungskonto hat nicht beide API-Rollen. Korrigiere das im Developer Portal oder unter **Versanddienstleister bearbeiten**. |
| „Die Einstellungen des Versanddienstleisters sind unvollständig oder ungültig. Prüfe sie unter „Versanddienstleister“.“ | **Logistikvertragsnummer** enthält etwas anderes als Ziffern. Korrigiere das unter **Versanddienstleister bearbeiten**. |
| „Posti konnte die Sendung nicht erstellen.“ | Posti hat die Sendung abgelehnt, zum Beispiel weil die Logistikvertragsnummer dem Anwendungskonto nicht zugewiesen ist. Die Sendung zeigt die Begründung von Posti. Behebe das 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.“ | Die Telefonnummer des Empfängers fehlt, die Sendung hat zu viele Pakete für das Versandprodukt, ein Paket ist zu schwer oder zu groß, oder Posti bietet eine gewählte Zusatzleistung dort nicht an. Die Sendung zeigt, was falsch ist. |
| „Dieses Versandprodukt liefert an einen Paketshop. Wähle vor dem Versenden einen Paketshop aus.“ | Wähle bei der Sendung einen Paketshop für **Postal Parcel (Postipaketti)**. |
| „Das gewählte Versandprodukt versendet nicht zwischen diesen Ländern. Wähle ein anderes Versandprodukt.“ | Wähle ein Versandprodukt von Posti, das das Land des Empfängers abdeckt. |
| „Die Zollinhaltserklärung ist unvollständig. Jede Position braucht eine Beschreibung, eine Menge und einen angegebenen Wert über null.“ | Bei einer Bestellposition fehlt die Beschreibung, die Zolltarifnummer, die Menge oder der Wert. Ergänze sie und versende erneut. |
| „Der Versanddienstleister hat die Sendung angenommen, aber weder ein Versandetikett noch einen QR-Code zurückgegeben, und Zippendo kann beides nicht erneut anfordern. Frag beim Versanddienstleister danach und versende die Sendung nicht erneut.“ | Bitte Posti um das Versandetikett. Versende die Sendung nicht erneut. |
| „Die Verbindung zum Versanddienstleister ist abgebrochen, bevor er geantwortet hat. Zippendo hat keine Bestätigung, dass die Sendung erstellt wurde. Frag beim Versanddienstleister nach, bevor du sie erneut versendest.“ | Frag bei Posti nach, ob die Sendung existiert, bevor du sie erneut versendest. |
| Es erscheinen keine Ereignisse der Sendungsverfolgung | Prüfe, ob beide Felder für die Sendungsverfolgung ausgefüllt und korrekt sind. |
| „Wir erreichen die Versanddienstleister gerade nicht. Versuch es gleich noch einmal.“ oder „Der Versanddienstleister hat die Anfrage abgelehnt. Prüfe seine Begründung, korrigiere die Angaben und versuch es noch einmal.“ | Warte einen Moment und versende erneut, oder behebe, was die Begründung von Posti nennt. |
Weitere Hilfe: [Anmeldefehler bei Versanddienstleistern](/docs/de/knowledge-base/carrier-authentication-failures).
## Verwandte Themen
* [Versanddienstleister oder Integration verbinden](/docs/de/how-to/connect-index)
* [Zugangsdaten der 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)
* [Paketshop auswählen](/docs/de/how-to/pick-a-service-point)
* [Zoll und Dokumente](/docs/de/how-to/customs-and-documents)
* [Integration 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.