Internetmarke
Eine Implementierung mehrerer APIs der Deutschen Post zum Erzeugen von digitalen Briefmarken in Node.js Anwendungen.
Zeitraum: 02.2018 - 11.2021
Projektart: PrivatPrivat
- Node.js
- TypeScript
- API
Worum es geht
Internetmarke ist ein Produkt der Deutschen Post, die Privat- wie auch Geschäftskunden die Möglichkeit bietet, Porto für Briefe digital zu erstellen.
Eine Internetmarke kann im Adressformat für den Briefkopf oder als Frankierversion auf ein Kuvert generiert werden. Beide Varianten gibt es dann sowohl als PNG als auch als PDF für Etikettendrucker.
Ziel des Projekts
Ausgangsproblem war, dass die Internetmarke auf der Homepage der Deutschen Post zwar gekauft werden kann, mir das alles aber zu umständlich war, da ich die Marken direkt auf meine generierten Briefe und Rechnungen drucken wollte. Also musste die API genutzt werden und die Internetmarken möglichst einfach gekauft und genutzt werden können.
Angefangen habe ich 2018 mit den ersten Features und dem Kauf von Marken als PNG. Später wurde das Projekt dann komplett auf TypeScript umgeschrieben und generiert nun alle vorhandenen Marken mit Zusatzoptionen wie Einschreiben, Prio etc. und auch in PDF-Versionen, um mehrere Marken auf Labels drucken zu können.
Mir war wichtig, ein möglichst generisches Projekt zu erstellen, das von vielen genutzt werden kann und dann auf npm veröffentlicht werden kann.
Auch wenn wir langsam im digitalen Zeitalter angekommen sind, sind Briefe nach wie vor ein Teil des Geschäftsalltags. Die Internetmarke war ein Bestandteil meines Exkurses in die Briefwelt, nachdem ich bereits DIN 5008 Briefe mit Node generiert hatte und nun immer noch zur Post laufen musste um mir das nötige Porto zu kaufen. Mittlerweile ist zwar auch das neue Produkt #PORTO vorhanden, ich finde es aber immer noch gewöhnungsbedürftig, auf einen Geschäftsbrief handschriftlich das Porto zu hinterlegen.
Features
Marken können als Vorschau generiert, dem Warenkorb hinzugefügt und gekauft werden. Die einzelnen Variationen beim Kauf der Marken wird in vollem Umfang ermöglicht.
Die verfügbaren Wertmarken der Deutschen Post können über den Produktservice angefragt werden.
Um sich nicht mit IDs und Spezifikationen der einzelnen Marken herumschlagen zu müssen, gibt es nun ein Feature, das anhand von Eckdaten des Briefs (Verwendetes Papier und Kuvert) sowie Angaben zur Nutzung (Empfängerland, Zusatzleistungen wie Einschreiben) die benötigte Marke aus der Liste findet und es dem Nutzer anbietet.
Links
Den Code zum Projekt findest du auf GitHub.
Du kannst das Package mit npm in dein Projekt einbinden.