← Retour aux guides
Intégrations

Obtenir le jeton Openapi (mise en demeure en recommandé)

Créez un compte Openapi, rechargez le crédit et générez un jeton avec les scopes des recommandés : la mise en demeure à qui ne retire pas le colis part en recommandé directement depuis la commande.

Mis à jour le 3 novembre 2026

Avec le jeton Openapi, RoyLead envoie la mise en demeure à qui n'a pas retiré le colis en recommandé italien, via le service Ufficio Postale d'Openapi : ils l'impriment, la mettent sous pli et la remettent à Poste Italiane. Tout passe par votre compte Openapi : vous y payez les recommandés, avec votre crédit (à partir d'environ 4 € chacun, plus l'accusé de réception si vous le voulez).

Le jeton appartient à l'équipe : le propriétaire ou un admin l'ajoute.

Étapes

  1. Allez sur console.openapi.com et créez un compte (ou connectez-vous).

  2. Ouvrez API Library → Postal Service → State. Remplissez les deux conditions, Two factor verification et Data processor agreement (le contrat de confidentialité sur les données envoyées, à accepter), puis appuyez sur Activate.

  3. Rechargez le crédit du compte : chaque recommandé est débité de là.

  4. Ouvrez Authentication dans le menu de gauche et, dans le cadre Production Token List, appuyez sur + New token. Donnez-lui un nom (ex. « RoyLead ») et une échéance lointaine (Openapi permet 1 an au maximum : mettez-le et notez la date, car quand le jeton expire les recommandés ne partent plus et il en faut un nouveau). Cochez Postal Service, ou seulement ces scopes :

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

    Copiez le jeton (24 caractères) avec l'icône de copie. Pas l'API Key en haut : elle sert seulement à Openapi, RoyLead la refuse.

  5. Dans RoyLead ouvrez votre équipe → Clients → Recommandés (Openapi), collez le jeton et appuyez sur Enregistrer. RoyLead le teste sur Openapi avant de l'enregistrer.

Comment l'envoyer

  1. Sur la commande, générez la mise en demeure comme d'habitude.
  2. Appuyez sur Envoyer en recommandé : expéditeur et destinataire sont déjà remplis, corrigez-les si besoin.
  3. Préparer et voir le prix : Openapi vérifie le PDF et vous indique le coût.
  4. Envoyer le recommandé : il part. Dans la même fenêtre, vous voyez ensuite le numéro du recommandé et le dernier statut de la Poste.

💡 Le jeton est enregistré chiffré et n'est plus affiché (seulement les derniers chiffres). Si vous le supprimez, les recommandés ne peuvent plus partir de RoyLead.

⚠️ Expéditeur et destinataire figurent sur l'enveloppe : chaque ligne a une limite de caractères. Si un champ est trop long, la fenêtre le marque en rouge : raccourcissez-le (ex. « Via Giuseppe Garibaldi » → « Via G. Garibaldi »).

Prêt à passer à la pratique ?

Crée ton compte RoyLead et démarre en quelques minutes.

Commencer gratuitement ↗