← Zurück zu den Anleitungen
Integrationen

Openapi-Token holen (Mahnung per Einschreiben)

Erstelle ein Openapi-Konto, lade Guthaben auf und erzeuge ein Token mit den Scopes für Einschreiben: Die Mahnung an Kunden, die das Paket nicht annehmen, geht direkt aus der Bestellung per Einschreiben raus.

Aktualisiert am 3. November 2026

Mit dem Openapi-Token schickt RoyLead die Mahnung an Kunden, die das Paket nicht abgeholt haben, als italienisches Einschreiben über den Dienst Ufficio Postale von Openapi: Sie wird gedruckt, kuvertiert und an Poste Italiane übergeben. Alles läuft über dein Openapi-Konto: Die Einschreiben zahlst du dort mit deinem Guthaben (ab etwa 4 € pro Stück, plus Rückschein, wenn du ihn willst).

Das Token gehört dem Team: Der Inhaber oder ein Admin fügt es hinzu.

Schritte

  1. Geh auf console.openapi.com und erstelle ein Konto (oder melde dich an).

  2. Öffne API Library → Postal Service → State. Erfülle die zwei Voraussetzungen, Two factor verification und Data processor agreement (der Datenschutzvertrag zu den Daten, die du sendest, zu akzeptieren), und klicke auf Activate.

  3. Lade Guthaben auf das Konto: Jedes Einschreiben wird davon abgebucht.

  4. Öffne Authentication im linken Menü und klicke im Feld Production Token List auf + New token. Gib einen Namen (z. B. „RoyLead“) und ein fernes Ablaufdatum an (Openapi erlaubt höchstens 1 Jahr: stell das ein und notier dir das Datum, denn läuft das Token ab, gehen keine Einschreiben mehr raus und du brauchst ein neues). Hake Postal Service an, oder nur diese Scopes:

    • POST:ws.ufficiopostale.com/raccomandate
    • GET:ws.ufficiopostale.com/raccomandate
    • PATCH:ws.ufficiopostale.com/raccomandate
    • GET:ws.ufficiopostale.com/dug

    Kopiere das Token (24 Zeichen) mit dem Kopier-Symbol. Nicht den API Key oben: der ist nur für Openapi, RoyLead lehnt ihn ab.

  5. Öffne in RoyLead dein Team → Kunden → Einschreiben (Openapi), füge das Token ein und klicke auf Speichern. RoyLead prüft es bei Openapi, bevor es gespeichert wird.

So wird es verschickt

  1. Erstelle in der Bestellung die Mahnung wie gewohnt.
  2. Klicke auf Per Einschreiben senden: Absender und Empfänger sind schon ausgefüllt, korrigiere sie bei Bedarf.
  3. Vorbereiten und Preis zeigen: Openapi prüft das PDF und nennt dir die Kosten.
  4. Einschreiben senden: Es geht raus. Im selben Fenster siehst du danach die Einschreibennummer und den letzten Status der Post.

💡 Das Token wird verschlüsselt gespeichert und nicht mehr angezeigt (nur die letzten Ziffern). Wenn du es entfernst, können aus RoyLead keine Einschreiben mehr verschickt werden.

⚠️ Absender und Empfänger stehen auf dem Umschlag: Jede Zeile hat eine Zeichengrenze. Ist ein Feld zu lang, markiert das Fenster es rot: kürze es (z. B. „Via Giuseppe Garibaldi“ → „Via G. Garibaldi“).

Bereit, das umzusetzen?

Erstell dein RoyLead-Konto und leg in wenigen Minuten los.

Kostenlos starten ↗