Ottieni il token Openapi (diffida per raccomandata)
Crea un account Openapi, ricarica il credito e genera un token con gli scope delle raccomandate: la diffida a chi non ritira parte per raccomandata direttamente dall'ordine.
Aggiornata il 3 novembre 2026
Con il token Openapi, RoyLead spedisce la diffida a chi non ha ritirato il pacco per raccomandata, con il servizio Ufficio Postale di Openapi: la stampano, la imbustano e la consegnano a Poste. Tutto gira sul tuo account Openapi: le raccomandate le paghi lì, col tuo credito (da circa 4 € l'una, più la ricevuta di ritorno se la vuoi).
Il token è del team: lo mette il proprietario o un admin.
Passi
-
Vai su console.openapi.com e crea un account (o accedi).
-
Apri API Library → Postal Service → State. Completa i due requisiti, Two factor verification e Data processor agreement (il contratto privacy sui dati che mandi, da accettare), poi premi Activate.
-
Ricarica il credito dell'account: ogni raccomandata viene scalata da lì.
-
Apri Authentication nel menu a sinistra e, nel riquadro Production Token List, premi + New token. Metti un nome (es. «RoyLead») e una scadenza lontana (Openapi arriva al massimo a 1 anno: mettila, e segnati la data, perché quando il token scade le raccomandate smettono di partire e ne va creato uno nuovo). Spunta Postal Service, o solo questi scope:
POST:ws.ufficiopostale.com/raccomandateGET:ws.ufficiopostale.com/raccomandatePATCH:ws.ufficiopostale.com/raccomandateGET:ws.ufficiopostale.com/dug
Copia il token (24 caratteri) con l'icona di copia. Non la API Key in alto: quella serve solo a Openapi, RoyLead la rifiuta.
-
In RoyLead apri il tuo team → Clienti → Raccomandate (Openapi), incolla il token e premi Salva. RoyLead lo prova su Openapi prima di salvarlo.
Come si spedisce
- Sull'ordine, genera la diffida come sempre.
- Premi Invia per raccomandata: mittente e destinatario sono già compilati, correggili se serve.
- Prepara e mostra il prezzo: Openapi controlla il PDF e ti dice quanto costa.
- Invia la raccomandata: parte. Nella stessa finestra vedi poi il numero di raccomandata e l'ultimo stato di Poste.
💡 Il token è salvato cifrato e non viene più mostrato (solo le ultime cifre). Se lo togli, le raccomandate non si possono più spedire da RoyLead.
⚠️ Mittente e destinatario finiscono sulla busta: ogni riga ha un limite di caratteri. Se un campo è troppo lungo il dialog lo segna in rosso: accorcialo (es. «Via Giuseppe Garibaldi» → «Via G. Garibaldi»).
Pronto a metterlo in pratica?
Crea il tuo account RoyLead e parti in pochi minuti.