Deutsche Post Internetmarke einrichten
Mit der Internetmarke bzw. der Portokasse der Deutschen Post kannst du in Billbee Frankierungen mit Empfängeradresse vornehmen und deine Bestellungen so versenden. Billbee kann mit der Internetmarke kommunizieren, aber nicht mit dem Shop der Deutsche Post (ehemals eFiliale), denn der Shop der Deutschen Post hat keine Schnittstelle für Drittanbieter. Wie du die Internetmarke der Deutschen Post an Billbee anbindest, kannst du in diesem Artikel nachlesen.
In diesem Artikel
Schritt-für-Schritt Anleitung zur Einrichtung
Voreinstellungen bei der Deutschen Post
Damit du die Schnittstelle der Internetmarke der Deutschen Post nutzen kannst, benötigst du Zugangsdaten für die Portokasse. Eine Registrierung für ein Konto für die Portokasse kannst du hier vornehmen. Das bedeutet, dass du für die Nutzung von der Internetmarke zwingend eine Portokasse bei der Deutschen Post benötigst, da die Zugangsdaten für den Onlineshop der Deutschen Post hier nicht funktionieren.
Anbindung von der Deutschen Post Internetmarke an Billbee
Um eine neue Versandanbindung bei Billbee einzurichten, klicke unter Einstellungen / Versand & Fulfillment auf den Button "Neu".
Jetzt öffnet sich ein Dropdown-Menü, in dem dir alle Versandanbindungen angezeigt werden, die an Billbee angebunden werden können. Wähle nun "Deutsche Post Internetmarke" aus und klicke darauf. Im Reiter "Allgemeine Eigenschaften" musst du erstmal nur einen Namen für deine Versandanbindung hinterlegen, alle anderen Informationen sind optional und du kannst sie im späteren Verlauf ergänzen.
Im Reiter "API Anbindung" kannst du anschließend alle api-spezifischen Einstellungen vornehmen:
- 1
- Benutzername: Trage hier den Benutzernamen für deinen Account bei der Deutschen Post Internetmarke ein. Haben deine Portokasse und deine Internetmarke unterschiedliche Nutzernamen, dann trage hier unbedingt den Nutzernamen der Portokasse ein, da die Verbindung von Billbee zur Internetmarke sonst nicht hergestellt werden kann.
- 2
- Passwort: Trage hier das Passwort für deinen Account bei der Deutschen Post Internetmarke ein. Haben deine Portokasse und deine Internetmarke unterschiedliche Passwörter, dann trage hier unbedingt das Passwort der Portokasse ein, da die Verbindung von Billbee zur Internetmarke sonst nicht hergestellt werden kann.
- 3
- Adressdaten: Fülle in den Adressdaten deine Absenderadresse ein. In das Feld "Adressname" musst du deinen Absendernamen einfügen und in die Felder "Straße", "Hausnummer", "PLZ", "Stadt" und "Land" schreibst du deine Absenderadresse. Alternativ kannst du auch einfach oben auf den Button "Adresse aus Benutzerkonto" übernehmen klicken, dann wird automatisch die Adresse deines Billbee Nutzerkonto eingefügt.
- 4
- Layout: Hier kannst du das Layout deiner Etiketten festlegen. Du hast hier die Wahl zwischen "WithAddress" (mit Empfängeradresse) und "WithoutAddress" (ohne Empfängeradresse). Wählst du "WithoutAddress", dann wird nur die eigentliche Marke gedruckt, aber sie enthält keine Empfängeradresse.
- 5
- Etikettengröße: Wähle hier mithilfe des Dropdown-Menüs deine gewünschte Etikettengröße aus. Im Dropdown-Menü stehen die alle gängigen Größen zur Verfügung. Es gibt einige Größeneinschränkungen, die du beachten solltest. Möchtest du Etiketten ohne Empfängeradresse ("WithoutAddress") drucken, dann benötigen diese Etiketten eine Mindestgröße von ca. 40mm x 30mm. Sollen diese Etiketten dann noch Zusatzleistungen wie z.B. Einschreiben beinhalten, dann benötigst du mindestens ein Etikettenformat von ca. 60mm x 30mm. Möchtest du Etiketten mit Empfängeradresse ("WithAddress") drucken, benötigst du ein Etikettenformat mit mindestens ca. 75mm x 35mm.
- 6
-
Neue Seite: Billbee beginnt mit dem Etikettendruck auf dem ersten Etikett oben links und merkt sich für weitere Versandaufträge die aktuelle Position des letzten Etiketts. Aktivierst du diese Option, dann wird für jeden Druck eine neue Seite begonnen, unabhängig davon, wo sich das letzte Etikett des letzten Auftrags sich auf der Seite befunden hat.
- 7
- Bestellnummer drucken: Aktivierst du diese Option, dann wird die Bestellnummer mit auf das Etikett gedruckt. Diese Option muss immer dann aktiviert werden, wenn du eine Referenzen (siehe Schritt 8) festlegen möchtest.
- 8
- Referenz: Hier kannst du optional einen Text festlegen, der auf dem Label ausgeben werden soll. Dieser Text kann mehrzeilig sein und du kannst Platzhalter verwenden. Damit du allerdings eine Referenz festlegen kannst, musst du unbedingt die Option "Bestellnummer drucken" aus Schritt 7 aktivieren.
Hast du alle Informationen eingegeben, dann klicke unten auf den Button "API Konfiguration testen". Ist die Konfiguration erfolgreich, erhältst du eine Benachrichtigung darüber und ein neuer Reiter "Produkte" erscheint in der Versandanbindung. Jetzt kannst du dort deine Versandprodukte anlegen. Das geht am einfachsten, wenn du im Reiter "Produkte" auf den Button "Produkte abrufen" klickst, denn so werden die mit der Internetmarke der Deutschen Post angebotenen Versandprodukte automatisch abgerufen und deiner Versandanbindung hinzugefügt. Über den Button "Neu" kannst du auch manuell über ein Dropdown-Menü ein Versandprodukt anlegen. Der Anzeigename kann dabei frei vergeben werden, der Produktname muss aber ein gültiger Produktcode sein. Bei der Deutschen Post habe alle Produkte eine Nummer (z.B. Standardbrief = 1, Kompaktbrief = 11, ...). Die Zusatzservices "Nachnahme" oder "Kundenbenachrichtigung" haben bei der Internetmarke keine Bedeutung.
Versandprodukte
-
Klicke hier, um eine Liste mit allen Versandprodukten aufzuklappen, die du über die Deutsche Post Internetmarke abrufen kannst.
* Standarbrief
* Kompaktbrief
* Großbrief
* Maxibrief
* Maxibrief bis 2000g + Zusatzentgeld MBf
* Postkarte
* Standardbrief + Prio
* Kompaktbiref + Prio
* Großbrief + Prio
* Maxibrief + Prio
* Maxibrief bis 2000g + Zusatzentgeld MBf + Prio
* Postkarte + Prio
* Warensendung
* Warensendung 2.000 + Gewichtszuschlag
* Streifbandzeitung bis 50g
* Streifbandzeitung 51 g bis 500 g
* Streifbandzeitung 501 g bis 1000 g
* Standardbrief Integral + EINSCHREIBEN EINWURF
* Standardbrief Integral + EINSCHREIBEN
* Standardbrief Integral + EINSCHREIBEN + RÜCKSCHEIN
* Standardbrief Integral + EINSCHREIBEN + EIGENHÄNDIG
* Standardbrief Integral + EINSCHREIBEN + EIGENHÄNDIG + RÜCKSCHEIN
* Kompaktbrief Integral + EINSCHREIBEN EINWURF
* Kompaktbrief Integral + EINSCHREIBEN
* Kompaktbrief Integral + EINSCHREIBEN + RÜCKSCHEIN
* Kompaktbrief Integral + EINSCHREIBEN + EIGENHÄNDIG
* Kompaktbrief Integral + EINSCHREIBEN + EIGENHÄNDIG + RÜCKSCHEIN
* Großbrief Integral + EINSCHREIBEN EINWURF
* Großbrief Integral + EINSCHREIBEN
* Großbrief Integral + EINSCHREIBEN + RÜCKSCHEIN
* Großbrief Integral + EINSCHREIBEN + EIGENHÄNDIG
* Großbrief Integral + EINSCHREIBEN + EIGENHÄNDIG + RÜCKSCHEIN
* Maxibrief Integral + EINSCHREIBEN EINWURF
* Maxibrief Integral + EINSCHREIBEN
* Maxibrief Integral + EINSCHREIBEN + RÜCKSCHEIN
* Maxibrief Integral + EINSCHREIBEN + EIGENHÄNDIG
* Maxibrief Integral + EINSCHREIBEN + EIGENHÄNDIG + RÜCKSCHEIN
* Maxibrief Integral + Zusatzentgeld MBf + EINSCHREIBEN EINWURF
* Maxibrief Integral + Zusatzentgeld MBf + EINSCHREIBEN
* Maxibrief Integral + Zusatzentgeld MBf + EINSCHREIBEN + RÜCKSCHEIN
* Maxibrief Integral + Zusatzentgeld MBf + EINSCHREIBEN + EIGENHÄNDIG
* Maxibrief Integral + Zusatzentgeld MBf + EINSCHREIBEN + EIGENHÄNDIG + RÜCKSCHEIN
* Postkarte Integral + EINSCHREIBEN EINWURF
* Postkarte Integral + EINSCHREIBEN
* Postkarte Integral + EINSCHREIBEN + RÜCKSCHEIN
* Postkarte Integral + EINSCHREIBEN + EIGENHÄNDIG
* Postkarte Integral + EINSCHREIBEN + EIGENHÄNDIG + RÜCKSCHEIN
* Standardbrief Intern. GK
* Kompaktbrief Intern. GK
* Großbrief Intern. GK
* Maxibrief Intern. bis 1.000g GK
* Maxibrief Intern. bis 2.000g GK
* Brief Kilotarif international ohne USt. + EINSCHREIBEN
* Brief Kilotarif international ohne USt.
* Postkarte Intern. GK
* Standardbrief Intern. GK Integral + EINSCHREIBEN
* Kompaktbrief Intern. GK Integral + EINSCHREIBEN
* Großbrief Intern. GK Integral + EINSCHREIBEN
* Maxibrief Intern. bis 1.000g GK Integral + EINSCHREIBEN
* Maxibrief Intern. bis 2.000g GK Integral + EINSCHREIBEN
* Postkarte Intern. GK Integral + EINSCHREIBEN
wichtig / zu beachten
Best Practice Tipp: Möchtest du verschiedene Absenderadressen nutzen, dann kannst du die Versandanbindung einfach ein zweites Mal angelegen und dort die abweichende Absenderadresse hinterlegen.
Zugangsdaten für die Internetmarke / Portokasse
Haben deine Portokasse und deine Internetmarke unterschiedliche Nutzernamen und/oder unterschiedliche Passwörter, dann trage in der Anbindung bei Billbee unbedingt den Nutzernamen und das Passwort der Portokasse ein, da die Verbindung von Billbee zur Internetmarke sonst nicht hergestellt werden kann.
"Warenpost national" & "Warenpost international"
Die "Warenpost international" ist seit 01.Juli 2022 nicht mehr über die Schnittstelle der Deutschen Post Internetmarke abrufbar. Beide Produkte sind nur noch über die Anbindung des DHL Geschäftskundenversands verfügbar.
Labelerzeugung
Früher wurden die Marken der Internetmarke immer im Batch auf einmal erzeugt. Das führte dazu, dass bei einem Fehler (z.B. Portokasse nicht ausreichend aufgeladen) nur teilweise Labels erzeugt wurde, die dann aber nicht geladen werden konnten. Somit wurden dann auch keine Sendungsnummern übernommen. So wurden teilweise die Portokasse belastet, ohne dass Versandmarken zum Download bereitstanden. Um das zu vermeiden, werden die Labels jetzt einzeln erzeugt.
Das führt aber jetzt auch dazu, dass es bei vielen Marken eine Flut an E-Mails von der Internetmarke gibt, da ja jede Marke einzeln erzeugt wird. Damit dein E-Mail-Postfach nicht aus allen Nähten platzt, kannst du entweder über eine Regel in deinem Mailprogramm die Bestätigungsmails direkt automatisch in einen speziellen Ordner schieben lassen oder du schaust in die Einstellungen bei deiner Portokasse. Dort kannst du unter „Meine Daten“ und dort bei „Kaufbestätigung“ die Häufigkeit der Bestätigungsmails auf einmal täglich umstellen.
Labels erneut herunterladen
Hast du Labels mithilfe der Internetmarke bei Billbee erstellt und konntest sie nicht herunterladen, dann prüfe deine Bestellbestätigung in deinem E-Mail Posteingang. Das Label befindet sich als Anhang an der Bestellbestätigung und kann von dir dort erneut heruntergeladen werden.
Außerdem kannst du das Label auch in Billbee erneut herunterladen. Wie und wo genau das geht erklären wir Hier.
Stornierung einer Internetmarke
Internetmarken kannst du direkt in Billbee stornieren, indem du die Sendung löschst. Der Storno erfolgt immer um Mitternacht und ist in der Portokasse ersichtlich.
Gehe zum Löschen einer Sendung in deiner Bestellübersicht über das Stiftsymbol in der Zeile deiner gewünschten Bestellung in das "Bearbeiten"-Fenster deiner Bestellung. Jetzt wechselst du in den Reiter "Versand". Dort findest du alle Sendungen, die zu dieser Bestellung gehören. Auf der rechten Seite findest du Aktionsbuttons. Der Button mit dem "X" ist zum Löschen der Sendung.
Mögliche Fehlercodes & ihre Bedeutung
Nachfolgend findest du einige Fehlerbenachrichtigungen, die im Zusammenhang mit der Einbindung der Internetmarke oder mit dem Versenden mit der Internetmarke aufgetaucht sind.
Fehlercode/-meldung | mögliche Bedeutung | Lösung |
Sendungen konnten nicht über die Internetmarke API erzeugt werden: There was no endpoint listening at https://internetmarke.deutschepost.de/OneClickForAppV3 that could accept the message. This is often caused by an incorrect address or SOAP action. See InnerException, if present, for more details. |
Häufig liegt hier eine Störung auf Seiten der Deutschen Post vor | Warte ein bisschen ab, bis die Störung von der Deutschen Post wieder behoben ist. |
Sendungen konnten nicht über die Internetmarke API erzeugt werden: An error occurred while receiving the HTTP response to https://internetmarke.deutschepost.de/OneClickForAppV3. This could be due to the service endpoint binding not using the HTTP protocol. This could also be due to an HTTP request context being aborted by the server (possibly due to the service shutting down). See server logs for more details. | Häufig liegt hier eine Störung auf Seiten der Deutschen Post vor | Warte ein bisschen ab, bis die Störung von der Deutschen Post wieder behoben ist. |
Sendungen konnten nicht über die Internetmarke API erzeugt werden: Es wurde ein ungültiger Produktcode ausgewählt |
Wenn dieser Fehler beim Versand von Warenpost-Produkten auftritt, ist möglicherweise die EKP des Warenpost-Vertrags nicht im Account der Portokasse eingetragen. | Trage die EKP deines Warenpost-Vertrages in deinen Portokassen Account ein. Mehr dazu findest du hier. |
Error 0: Sendungen konnten nicht über die Internetmarke API erzeugt werden: A task was canceled | temporäres Problem der Internetmarke, wo der Vorgang abgebrochen wird, aber auch u.U. die Portokasse belastet wird. | Versuche es zu einem späteren Zeitpunkt noch einmal. Behalte aber deine Portokasse im Blick. |
Es ist ein Fehler aufgetreten.Unknown user or invalid password | Die Zugangsdaten sind nicht korrekt bei Billbee hinterlegt. | Stelle sicher, dass du die korrekten Zugangsdaten bei Billbee hinterlegt hast. Haben deine Portokasse und deine Internetmarke unterschiedliche Nutzernamen, dann trage in der Anbindung bei Billbee unbedingt den Nutzernamen und das Passwort der Portokasse ein, da die Verbindung von Billbee zur Internetmarke sonst nicht hergestellt werden kann. |