← Înapoi la ghiduri
Integrări

Obține tokenul Openapi (somație prin scrisoare recomandată)

Creează un cont Openapi, încarcă credit și generează un token cu scope-urile pentru scrisori recomandate: somația către cine nu ridică coletul pleacă prin recomandată direct din comandă.

Actualizat pe 3 noiembrie 2026

Cu tokenul Openapi, RoyLead trimite somația către cine nu a ridicat coletul prin scrisoare recomandată italiană, cu serviciul Ufficio Postale de la Openapi: o tipăresc, o pun în plic și o predau la Poste Italiane. Totul merge pe contul tău Openapi: scrisorile le plătești acolo, din creditul tău (de la aproximativ 4 € bucata, plus confirmarea de primire dacă o vrei).

Tokenul este al echipei: îl adaugă proprietarul sau un admin.

Pași

  1. Intră pe console.openapi.com și creează un cont (sau autentifică-te).

  2. Deschide API Library → Postal Service → State. Completează cele două cerințe, Two factor verification și Data processor agreement (contractul de confidențialitate pentru datele pe care le trimiți, de acceptat), apoi apasă Activate.

  3. Încarcă credit în cont: fiecare scrisoare se scade de acolo.

  4. Deschide Authentication din meniul din stânga și, în caseta Production Token List, apasă + New token. Dă-i un nume (ex. „RoyLead”) și o dată de expirare îndepărtată (Openapi permite cel mult 1 an: pune-l și notează-ți data, pentru că atunci când tokenul expiră scrisorile nu mai pleacă și trebuie unul nou). Bifează Postal Service, sau doar aceste scope-uri:

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

    Copiază tokenul (24 de caractere) cu iconița de copiere. Nu API Key de sus: aceea e doar pentru Openapi, RoyLead o respinge.

  5. În RoyLead deschide echipa → Clienți → Scrisori recomandate (Openapi), lipește tokenul și apasă Salvează. RoyLead îl testează pe Openapi înainte să-l salveze.

Cum se trimite

  1. În comandă, generează somația ca de obicei.
  2. Apasă Trimite cu scrisoare recomandată: expeditorul și destinatarul sunt deja completate, corectează-le dacă e nevoie.
  3. Pregătește și arată prețul: Openapi verifică PDF-ul și îți spune cât costă.
  4. Trimite scrisoarea: pleacă. În aceeași fereastră vezi apoi numărul recomandatei și ultimul status de la Poștă.

💡 Tokenul e salvat criptat și nu mai e afișat (doar ultimele cifre). Dacă îl elimini, scrisorile nu mai pot fi trimise din RoyLead.

⚠️ Expeditorul și destinatarul ajung pe plic: fiecare rând are o limită de caractere. Dacă un câmp e prea lung, fereastra îl marchează cu roșu: scurtează-l (ex. „Via Giuseppe Garibaldi” → „Via G. Garibaldi”).

Gata să pui asta în practică?

Creează-ți contul RoyLead și începe în câteva minute.

Începe gratis ↗