Neu Automatisiertes Kaufen und Drucken von Deutsche Post Internetmarken via API / CSV-Import

[dc-nico]

Hallo,

hier ein kleines Programm, welches den Versand per Internetmarke von jedem Programm mit CSV-Export ermöglicht.

Internetmarken-Center​

Automatisiertes Kaufen und Drucken von Deutsche Post Internetmarken via CSV-Import

Das Internetmarken-Center ist eine leistungsstarke Windows-Desktop-Anwendung zur effizienten Abwicklung Ihres Postversands. Die Software liest Empfängerdaten direkt aus CSV-Dateien (z. B. aus Shop-Systemen, JTL-Wawi oder Excel) ein, kauft vollautomatisch die benötigten Portomarken über die offizielle REST-API der Deutschen Post und druckt diese passgenau auf Ihren Etikettendrucker.

1. Funktionsübersicht & Key Features​

• Automatischer CSV-Import: Flexible Zuordnung von Empfängerfeldern (Name, Straße, PLZ, Ort, Land) aus beliebig strukturierten CSV-Dateien.
• Batch-Verarbeitung (Massenkauf): Hunderte Sendungen gleichzeitig auswählen, Porto berechnen und in einem einzigen Durchgang kaufen.
• Direktes Drucken auf Etikettendrucker: Nahtlose Ansteuerung von Labeldruckern (z. B. Brother QL, Dymo, Zebra) für Einzeletiketten oder DIN-A4-Bögen.
• Porto-Vorauswahl & Automatische Erkennung: Schnelle Auswahl gängiger Brief- und Paketprodukte der Deutschen Post (Standardbrief, Kompaktbrief, Großbrief, Maxibrief, Priorität, Einschreiben, Warenpost) oder automatische Zuweisung direkt aus der CSV-Datei.
• Historie & Nachdruck: Lokale Speicherung gekaufter Marken mit Möglichkeit zum erneuten Ausdrucken im Fehlerfall (z. B. bei Papierstau) sowie Export der generierten Sendungsnummern.
• Lokale Datenhaltung: Keine monatlichen Lizenzgebühren oder Abhängigkeiten von Drittservern – die Kommunikation erfolgt direkt zwischen Ihrem PC und der API der Deutschen Post.

2. Einrichtungsanleitung: API & Portokasse freischalten​

Um die automatische Schnittstelle nutzen zu können, benötigen Sie offizielle Entwickler-Zugangsdaten der Deutschen Post sowie eine aktivierte Portokasse.

Teil A: API-Zugangsdaten der Deutschen Post anfordern​

1. Registrierung im Entwicklerportal: Öffnen Sie das Entwicklerportal der Deutschen Post unter developer.deutschepost.de und erstellen Sie ein kostenloses Entwickler-Konto (Developer Account).
2. API-Anwendung anlegen: Loggen Sie sich ein, navigieren Sie zu App-Verwaltung / Meine Apps, erstellen Sie eine neue App (z. B. Name: Internetmarken-Center) und wählen Sie die Schnittstelle "Internetmarke API" bzw. "Portokasse API" aus.
3. API-Keys notieren: Nach dem Erstellen erhalten Sie im Entwickler-Dashboard Ihre Client ID (App-Schlüssel) und Ihr Client Secret (Geheimschlüssel).

Teil B: Portokasse einrichten, aufladen & Drittanbieter-App freischalten​

1. Portokasse-Konto erstellen: Rufen Sie portokasse.deutschepost.de auf und registrieren Sie sich (oder nutzen Sie Ihre bestehenden Login-Daten der Deutschen Post / DHL).
2. Erste Aufladung durchführen (Voraussetzung für Freischaltung): Loggen Sie sich in Ihre Portokasse ein und führen Sie eine erste Aufladung/Bestellung durch (z. B. 10 € oder 20 € per SEPA-Lastschrift, PayPal, Kreditkarte oder Überweisung). Erst durch diese erste Transaktion wird der Versand der Freischalt-E-Mail für die API-Anwendung angestoßen.
3. App in der Portokasse aktivieren (Finaler Schlüssel): Sobald Sie die Bestätigungs-E-Mail zur App-Freischaltung von der Deutschen Post erhalten haben, loggen Sie sich erneut in Ihre Portokasse ein. Navigieren Sie zu Einstellungen ➔ Drittanbieter-Anwendungen / Berechtigungen (bzw. App-Verwaltung), suchen Sie die Anwendung Internetmarken-Center und aktivieren/bestätigen Sie diese explizit.

Teil C: Einmalige Konfiguration im Internetmarken-Center​

1. Öffnen Sie das Internetmarken-Center auf Ihrem PC.
2. Gehen Sie zu Einstellungen ➔ API / Post-Zugangsdaten.
3. Tragen Sie Ihre Client ID, Ihr Client Secret sowie Ihre Portokasse-Zugangsdaten (E-Mail & Passwort) ein und speichern Sie die Eingabe.
4. Die Software ist nun vollständig einsatzbereit!

Teil C: Option für Entwickler & Tests (Sandbox-Testkonto)​

1. Wenn Sie das System vorab risikofrei in einer reinen Testumgebung testen möchten, registrieren Sie ein neues, separates Portokassen-Konto (ohne echtes Geld aufzuladen).
2. Senden Sie anschließend eine E-Mail mit Ihrer Portokassen-ID und der registrierten E-Mail-Adresse an den Entwickler-Support (Internetmarke-Technik@deutschepost.de)
   und bitten darum, dieses als Testkonto einzurichten.
3. Der Support stellt dieses Konto anschließend als kostenloses Entwickler-/Sandbox-Konto mit virtuellem Testguthaben für API-Tests um.

3. Wie das Programm funktioniert (Workflow)​

[ CSV-Datei / Export ] ➔ [ Daten-Import & Vorschau ] ➔ [ Produkt wählen / Automatisch aus CSV erkennen ] ➔ [ API-Kauf via Portokasse ] ➔ [ Etikettendruck ] ➔ [ Sendungsnummer für Import ]

1. CSV-Datei laden: Sie wählen Ihre Exportdatei aus dem Shop- oder Warenwirtschaftssystem aus.
2. Adressen prüfen: Die Anwendung zeigt eine übersichtliche Tabelle mit den eingelesenen Empfängern.
3. Porto festlegen: Wählen Sie das gewünschte Porto-Produkt (z. B. Großbrief) manuell aus oder lassen Sie es automatisch über ein Feld in der CSV-Datei erkennen.
4. Portokasse belasten & Generieren: Die Software sendet die Kaufanfrage verschlüsselt an die API der Deutschen Post. Das Guthaben wird automatisch von Ihrer Portokasse abgebucht, und das fertige Druckbild wird zurückgeliefert.
5. Drucken & Sendungsnummern verarbeiten: Die Etiketten werden direkt an Ihren angeschlossenen Etikettendrucker gesendet. Die erzeugten Sendungsnummern stehen für den Rückimport in Ihr System zur Verfügung.

4. Systemvoraussetzungen​

• Betriebssystem: Windows 10 / Windows 11 (64-Bit)
• Hardware: Standard-PC / Laptop, angeschlossener Etikettendrucker (Brother QL, Dymo, Zebra etc.) oder Standard-A4-Drucker
• Internetverbindung: Erforderlich zur Kommunikation mit der Schnittstelle der Deutschen Post
• Voraussetzung: Aktive Portokasse mit ausreichendem Guthaben, API-Zugangsdaten & erfolgte App-Aktivierung

Betriebssystem: Windows 10 / Windows 11 (64-Bit)

• Hardware: Standard-PC / Laptop, angeschlossener Etikettendrucker (Brother QL, Dymo, Zebra etc.) oder Standard-A4-Drucker
• Internetverbindung: Erforderlich zur Kommunikation mit der Schnittstelle der Deutschen Post
• Voraussetzung: Aktive Portokasse mit ausreichendem Guthaben & API-Zugangsdaten
  
  
  Download

Sollten noch Fragen offen sein, könnt ihr mich einfach anschreiben.

Gruß, Nico