Umstellung von SOAP auf REST-API

Ab dem 31.12.2025 schaltet die Deutsche Post die bisherige SOAP-Schnittstelle der Internetmarke ab. Damit Internetmarke in tricoma weiterläuft, stellst du auf die neue REST-API um. Die Umstellung ist schnell erledigt.

Voraussetzungen

• tricoma ist aktuell und es wurde ein Komplettupdate gebucht (sofern REST-API in den Einstellungen nicht verfügbar ist).
• Du hast Zugriff auf deine Portokasse.

Schritt 1 – Komplettupdate durchführen

Buche das Komplettupdate und lasse es durchführen. Erst danach erscheint in der App Internetmarke die Option für die REST-API.

Schritt 2 – REST-API in tricoma aktivieren

1. Öffne die App Internetmarke.
2. Wechsle zu Einstellungen → Zugangsdaten.
3. Aktiviere die Checkbox REST-API aktiv.
4. Speichere.
5. Führe einen Verbindungstest durch.

Schritt 3 – Geschäftsanwendung in der Portokasse freigeben

1. Melde dich in der Portokasse an: Meine Daten → Geschäftsanwendungen.
2. Suche die Anwendung tricoma_live (und ggf. weitere verwendete Anwendungen).
3. Setze den Status auf freigegeben. Ohne Freigabe sind API-Aufrufe nicht möglich.

Wichtiger Hinweis der Deutschen Post

Schritt 4 – Ersten REST-Aufruf auslösen

Damit die Portokasse den Tokenprozess anstößt, muss mindestens ein REST-Aufruf stattfinden. Das machst du am einfachsten direkt in tricoma:

1. In Einstellungen → Zugangsdaten auf Verbindung testen klicken.
2. Falls die Anwendung noch nicht freigegeben war, kann jetzt eine E-Mail der Portokasse eintreffen. Gib der Freigabe kurz Zeit und teste erneut.

Schritt 5 – Verbindung testen und Nutzung prüfen

1. Klicke erneut auf Verbindung testen, bis der Test erfolgreich ist.
2. Erstelle danach wie gewohnt deine Internetmarken. Der Ablauf in tricoma bleibt gleich.

Typische Fehlermeldungen und Lösungen

FAQ

Ändert sich der Prozess für den Druck?
Nein. Nach der Aktivierung der REST-API nutzt du Internetmarke in tricoma wie bisher.

Muss ich etwas in Shopify, WooCommerce etc. anpassen?
Nein. Die Umstellung betrifft nur die Schnittstelle zwischen tricoma und der Internetmarke/Portokasse.

Warum sehe ich weiterhin eine 401-Meldung?
Prüfe die Freigabe in der Portokasse, löse dann über Verbindung testen einen erneuten REST-Aufruf aus. Erst danach wird der Token bereitgestellt.

Fazit: Mit Komplettupdate, aktivierter Option REST-API aktiv und der Freigabe deiner Geschäftsanwendung in der Portokasse ist die Umstellung in wenigen Minuten erledigt. Danach läuft Internetmarke in tricoma stabil über die neue REST-API.